History

Tianyi Cui ba3125234a docs: rename core-data-structures/ to subsystems/ The folder is becoming the home of one-doc-per-subsystem pages (intro + data structures + cordis services/events), so the name must describe the whole contract, not just the type-vocabulary third of it. Mechanical rename rebuilt on current master: every inbound Markdown link, generator constant, website route, type-equiv manifest path, and spec expectation moves together; the zh sides of the notes whose prose names the folder are aligned (子系统) in the same change; touched bilingual pairs re-recorded; translation-prompt snapshot re-recorded (its example embeds development.md). Historical Agent Note slugs keep their dated filenames.		2026-08-09 01:27:09 +08:00
..
agent	fix(agent-loop): latch wakes landing in the cancel-convergence window	2026-08-08 19:42:42 +08:00
agent-loop	refactor(session): fold the session family into packages/session/	2026-08-09 01:21:11 +08:00
scope	refactor(agent): unify agent-scoped event signatures as payload objects	2026-08-06 12:13:14 +08:00
session	docs: rename core-data-structures/ to subsystems/	2026-08-09 01:27:09 +08:00
system-prompt	Merge remote-tracking branch 'origin/worktree/context-source-cards' into worktree/context-forms-remaining	2026-08-06 11:49:03 +08:00
tools	docs: rename core-data-structures/ to subsystems/	2026-08-09 01:27:09 +08:00
README.i18n.yaml	docs: rescan rebased documentation hierarchy	2026-08-05 16:16:57 +08:00
README.md	docs: apply hierarchy across the corpus	2026-08-05 16:13:28 +08:00
README.zh.md	docs: rescan rebased documentation hierarchy	2026-08-05 16:16:57 +08:00

README.md

core/ — product API spine

English | 中文

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/`	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-loop/`	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; this group owns only the swappable spine pieces.