mirror of https://github.com/deepseek-ai/deepseek-harness synced 2026-08-15 21:04:50 +00:00

Files

Tianyi Cui c0808d5126 docs: the governing principle — every LLM request is reconstructable from the session log

The reconstructability RFC is the principle's home: model-visible ⟺
logged in both forms, the mechanism (boundary derivation + header
fold), the enforcement (write-time round-trip guard, the dev
invariant), the corollaries ranked (prefix-cache stability first), the
MiniCode lineage with the provenance arrow inverted, and the
alternatives it beat — including the stateful transmission client
whose three-design archaeology lives in PR #162.

Placements per the one-home-per-fact taxonomy: a standing-order line in
root AGENTS.md (with displacement trims to stay inside the 1,575-word
ceiling), the principle statement in architecture.md § Session Log and
its Turn Flow lines (condensed to the ratcheted 1,630 ceiling), the
request-envelope section in core-data-structures/core.md with the
LlmCallConfig paste, both review-requested FIXMEs
(FIXME(call-config-shape) beside the type, FIXME(catalog-verbs) at the
catalog's drift-gate note), cookbook rows redirected off agent/request
(tool filtering → system-prompt/assemble, plan-mode prompt → sections/
inject()), and the llm/stream JSDoc stating the frozen-request
contract. RFC index and all generated catalogs regenerated.

2026-07-06 03:49:35 +08:00

llm

docs: the governing principle — every LLM request is reconstructable from the session log

2026-07-06 03:49:35 +08:00

llm-deepseek

Merge master into app attribution RFC

2026-07-05 00:45:39 +08:00

llm-pi-ai

Merge master into app attribution RFC

2026-07-05 00:45:39 +08:00

README.md

Document the package hierarchy and finalize the RFC

2026-06-20 23:25:33 +08:00

README.md

llm/ — LLM capability family

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/`	Abstract LLM service + content-block vocabulary + chunk assembler	`ctx.llm`
`llm-deepseek/`	DeepSeek API adapter (hand-rolled fetch/SSE)	(registers on `ctx.llm`)
`llm-pi-ai/`	DeepSeek adapter via `@earendil-works/pi-ai` (design twin)	(registers on `ctx.llm`)

The interface lives at llm/llm/; adapters are flat siblings under the group. A new provider adapter joins here and registers on ctx.llm without touching the interface. See twin LLM adapters for why two adapters exist.