packages/core/README.md

# core/ — product API spine

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

The session log, system-prompt assembly, tool registry, agent vocabulary, 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-loop/`](agent-loop/README.md) | Default concrete agent driver | `ctx.agentLoop` |

`scope` supplies the shared scoping primitive. `agent` owns the public seam, while `agent-loop` is its default implementation; extension plugins depend on the seam so the driver remains swappable.

Runnable compositions belong to [`examples/agent-spine-demo`](../examples/agent-spine-demo/README.md); this group owns only the swappable spine pieces.
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)`

feat(skill): move catalogs into session prefixes 2026-07-10 14:19:06 +08:00			`The session log, system-prompt assembly, tool registry, agent vocabulary, 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` \|
			\| [`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: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`scope` supplies the shared scoping primitive. `agent` owns the public seam, while `agent-loop` is its default implementation; extension plugins depend on the seam so the driver remains swappable.
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.