packages/core/README.md

# core/ — product API spine

English | [中文](README.zh.md)

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/`](scope/README.md) | Scoped-context registration primitive | library — no ctx key |
| [`session/`](session/README.md) | Event-sourced session log and in-memory store | `ctx.sessions` |
| [`system-prompt/`](system-prompt/README.md) | Prompt and tool-schema assembly registry | `ctx.systemPrompt` |
| [`tools/`](tools/README.md) | Scoped tool registry and execution pipeline | `ctx.tools` |
| [`agent/`](agent/README.md) | Agent interface, registry, and event vocabulary | `ctx.agents` |
| [`agent-default-model/`](agent-default-model/README.md) | Default model selection shared by Agent entry points | `ctx.agentDefaultModel` |
| [`agent-loop/`](agent-loop/README.md) | 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`](../examples/agent-spine-demo/README.md); 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](../../docs/subsystems/core.md); the default runnable composition is [`examples/agent-spine-demo`](../examples/agent-spine-demo/README.md).
Document the package hierarchy and finalize the RFC 2026-06-20 23:25:33 +08:00			`# core/ — product API spine`

docs: translate remaining READMEs 2026-07-26 05:03:53 +08:00			`English \| [中文](README.zh.md)`

fix(headless): dsh run is a direct core front door 2026-08-09 12:13:58 +08:00			`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.`
Document the package hierarchy and finalize the RFC 2026-06-20 23:25:33 +08:00
			`\| Package \| Role \| ctx key \|`
			`\|---\|---\|---\|`
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			\| [`scope/`](scope/README.md) \| Scoped-context registration primitive \| library — no ctx key \|
			\| [`session/`](session/README.md) \| Event-sourced session log and in-memory store \| `ctx.sessions` \|
			\| [`system-prompt/`](system-prompt/README.md) \| Prompt and tool-schema assembly registry \| `ctx.systemPrompt` \|
			\| [`tools/`](tools/README.md) \| Scoped tool registry and execution pipeline \| `ctx.tools` \|
			\| [`agent/`](agent/README.md) \| Agent interface, registry, and event vocabulary \| `ctx.agents` \|
docs: replace front door terminology 2026-07-22 15:13:12 +08:00			\| [`agent-default-model/`](agent-default-model/README.md) \| Default model selection shared by Agent entry points \| `ctx.agentDefaultModel` \|
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			\| [`agent-loop/`](agent-loop/README.md) \| Default concrete agent driver \| `ctx.agentLoop` \|
Document the package hierarchy and finalize the RFC 2026-06-20 23:25:33 +08:00
docs: replace front door terminology 2026-07-22 15:13:12 +08:00			`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.
docs: agent-scope RFC, CONTEXT.md glossary, architecture scope section, README sync 2026-07-09 03:01:11 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			Runnable compositions belong to [`examples/agent-spine-demo`](../examples/agent-spine-demo/README.md); this group owns only the swappable spine pieces.
docs: anchor each subsystem page to its package group; make group READMEs thin tables 2026-08-02 05:54:15 +08:00
			The subsystem reference — the package-by-package loop map, the `Agent` handle and its delivery/interception contracts — is [docs/subsystems/core.md](../../docs/subsystems/core.md); the default runnable composition is [`examples/agent-spine-demo`](../examples/agent-spine-demo/README.md).