deepseek-harness/packages/core
Yichen Jiang 2be0e6c522 Merge branch 'stack/agent-profiles-5-web-ui' into stack/agent-profiles-8-authoring
# Conflicts:
#	packages/preset/agent-presets/src/index.ts
#	packages/preset/agent-presets/tests/mount.spec.ts
2026-08-10 11:25:14 +08:00
..
agent Merge branch 'stack/agent-profiles-1-seam' into stack/agent-profiles-3-wire 2026-08-09 21:35:37 +08:00
agent-default-model fix(headless): dsh run is a direct core front door 2026-08-09 13:44:44 +08:00
agent-loop docs: reserve seam for complete capabilities 2026-08-09 17:26:57 +08:00
agent-tool-mode fix(scripts): point the plane-separation gate at the bundle patches 2026-08-07 00:44:49 +08:00
scope refactor(scope): bind the parent link once and gate re-linking behind the binding 2026-08-10 11:17:04 +08:00
session Merge branch 'stack/agent-profiles-1-seam' into stack/agent-profiles-3-wire 2026-08-09 22:56:44 +08:00
system-prompt Merge remote-tracking branch 'origin/stack/agent-profiles-1-seam' into stack/agent-profiles-3-wire 2026-08-09 20:33:55 +08:00
tools Merge branch 'stack/agent-profiles-5-web-ui' into stack/agent-profiles-8-authoring 2026-08-10 11:25:14 +08:00
README.i18n.yaml docs: reserve seam for complete capabilities 2026-08-09 17:26:57 +08:00
README.md docs: reserve seam for complete capabilities 2026-08-09 17:26:57 +08:00
README.zh.md docs: reserve seam for complete capabilities 2026-08-09 17:26:57 +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 front doors 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 front door 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.