deepseek-harness/packages/core
_Kerman f364d6ba37 fix: address ds-review-bot findings on the projection migration
- llm-retry: validate config before registering the projection unit;
  document the branded-retry-id zod cast; start stateVersion at 1.
- agent-loop: register turnBoundary only after every config validation,
  so a rejected constructor leaves no unit behind; the defensive-cap
  test no longer needs fiber cleanup.
- agent-instructions: keep newest-first per-scope change history so the
  latest visible change survives a surface replacement shadowing the
  newest one (restores the previous scan-visible semantics); add a
  regression test for the delete-after-shadow sequence.
- tool-skill: keep catalog-message history so a shadowed newest catalog
  message still falls back to the latest visible digest.
- session-query-sqlite: drop the unused required sessionProjections
  injection.
- plan-mode: restore the command/done error-drop regression test and the
  cold-replay command/done fold; drop the inaccurate state-reference
  comment.
- tool-todo: remove a stray blank line; document the turnBoundary
  reader contract on the projection type.
2026-08-19 16:58:47 +08:00
..
agent fix: address ds-review-bot findings on the projection migration 2026-08-19 16:58:47 +08:00
agent-default-model release(dsh): 0.1.0-rc.7 2026-08-17 18:47:02 +08:00
agent-loop fix: address ds-review-bot findings on the projection migration 2026-08-19 16:58:47 +08:00
agent-tool-presentation release(dsh): 0.1.0-rc.7 2026-08-17 18:47:02 +08:00
scope release(dsh): 0.1.0-rc.7 2026-08-17 18:47:02 +08:00
session feat(team): add durable Agent Teams runtime 2026-08-18 11:58:11 +08:00
system-prompt release(dsh): 0.1.0-rc.7 2026-08-17 18:47:02 +08:00
tools refactor(session): migrate host state reads to projections 2026-08-19 13:57:58 +08:00
README.i18n.yaml docs(i18n): include complete proofreading corpus 2026-08-12 12:30:19 +08:00
README.md docs: replace front door terminology 2026-08-10 13:07:46 +08:00
README.zh.md docs(i18n): include complete proofreading corpus 2026-08-12 12:30:19 +08:00

core/ — product API spine

English | 中文

The session log, system-prompt assembly, tool registry, agent vocabulary, deployment-default model selection, and concrete loop that form the harness's default control spine. These are product packages — the stable surface plugins and consumers build against.

Package Role ctx key
scope/ Scoped-context registration primitive library — no ctx key
session/ Event-sourced session log and in-memory store ctx.sessions
system-prompt/ Prompt and tool-schema assembly registry ctx.systemPrompt
tools/ Scoped tool registry and execution pipeline ctx.tools
agent/ Agent interface, registry, and event vocabulary ctx.agents
agent-default-model/ Default model selection shared by Agent entry points ctx.agentDefaultModel
agent-loop/ Default concrete agent driver ctx.agentLoop

scope supplies the shared scoping primitive. agent owns the public contract, while agent-loop is its default implementation; extension plugins depend on the seam so the driver remains swappable. agent-default-model owns the deployment selection an Agent entry point uses only when a session has no selection of its own.

Runnable compositions belong to examples/agent-spine-demo; this group owns only the swappable spine pieces.

The subsystem reference — the package-by-package loop map, the Agent handle and its delivery/interception contracts — is docs/subsystems/core.md; the default runnable composition is examples/agent-spine-demo.