deepseek-harness/packages/llm
Yichen Jiang d03d3ab70b Merge remote-tracking branch 'origin/master' into worktree/default-model-persistence
Carries two edits beyond conflict resolution, both forced by what master
brought in:

- `CustomProviderCard`: master added front-end key validation and a
  component-level `keyValue` (already trimmed) while still writing
  `apiKeyEnv` unconditionally. Kept this branch's blank-key rule and its
  committed-profile retry gate, and adopted master's single `keyValue` so
  the component has one spelling of the key rather than two.
- `docs/user/guide/providers`: master merged #1810, whose default-model
  section still taught overriding the `api-gateway` row in
  `$DSH_HOME/config.yaml` — the behavior this branch replaced. Rewritten
  for the settings section the picker now writes, plus the review fix from
  #1810 replacing the colloquial 挂着 in the opener.
2026-08-07 15:44:57 +08:00
..
llm Merge remote-tracking branch 'origin/master' into worktree/default-model-persistence 2026-08-07 15:44:57 +08:00
llm-deepseek Merge remote-tracking branch 'origin/master' into worktree/charming-swartz-83bf33 2026-08-07 14:12:17 +08:00
llm-pi-ai Merge remote-tracking branch 'origin/master' into worktree/default-model-persistence 2026-08-07 15:44:57 +08:00
llm-retry refactor(agent): unify agent-scoped event signatures as payload objects 2026-08-06 12:13:14 +08:00
token-meter fix: projection error 2026-08-06 19:36:15 +08:00
README.i18n.yaml docs: rescan rebased documentation hierarchy 2026-08-05 16:16:57 +08:00
README.md docs: apply hierarchy across the corpus 2026-08-05 16:13:28 +08:00
README.zh.md docs: rescan rebased documentation hierarchy 2026-08-05 16:16:57 +08:00

llm/ — LLM capability family

English | 中文

The LLM seam and its provider adapters. The interface package (llm) owns the abstract service, the content-block vocabulary, and the stream-chunk assembler; the adapters are concrete implementations that register on ctx.llm. All product packages.

Package Role ctx key
llm/ LLM service and shared streaming vocabulary ctx.llm
token-meter/ Replay-aware token measurement ctx.tokenMeter
llm-retry/ Provider-scoped retry policy listens to agent/request-error
llm-deepseek/ Direct DeepSeek adapter registers on ctx.llm
llm-pi-ai/ Multi-provider pi-ai adapter registers on ctx.llm

Adapters register provider routes on the seam; retry and token measurement remain separate consumers. The child READMEs own routing, metadata, replay, and provider-wire details; the LLM architecture decisions own the rationale.