Files
deepseek-harness/docs/event-producer-consumer.md
Tianyi Cui e7bcbb8bc6 feat(dx): scopeHost, agent-aware ACP presentation, and the scoped-dispatch drift gate
scopeHost(ctx, services) is the sanctioned way to mint scopes in tests: it
names absent services loudly instead of the cryptic cordis without-inject
dead end, and catches the silent-no-op host (cordis resolves a
dependency-pending fiber's await without running the inject callback).

The ACP ToolPresenter resolves presentations through the session agent's
view (tools.get(name, agent)) so a scoped/shadowed tool renders with the
same definition that executed.

verify-scoped-dispatch (doc-sync + pre-push) pins the dev-invariants
carrier table against the declaration JSDoc set: an event enforced but
undocumented, documented but unenforced, or a registry-subject notification
leaking into the table fails the build. subagent/start|end docs gain their
scoped-dispatch sentence (a real gap the gate caught on first run).
2026-07-09 02:38:54 +08:00

7.0 KiB

Event Producer And Consumer Matrix

This matrix shows which packages dispatch each harness-owned event and which packages listen to it. It is intentionally a table rather than one large graph: events are many-to-many, and dense relation data is easier to review in rows. Dynamic dispatch overrides cover sites that deliberately bypass ctx.emit, such as subagent lifecycle containment.

Event Mode Declared in Dispatchers Listeners
agent/created emit packages/core/agent/src/types.ts:286 agent (emit) stdio-agent
agent/disposed emit packages/core/agent/src/types.ts:298 agent (emit) stdio-agent
agent/error emit packages/core/agent/src/types.ts:492 agent-loop (emit) -
agent/pre-step serial packages/core/agent/src/types.ts:396 agent-loop (serial) compact-basic
agent/prompt-submit waterfall packages/core/agent/src/types.ts:414 agent-loop (waterfall) hooks-claude, hooks-codex
agent/queued emit packages/core/agent/src/types.ts:326 agent-loop (emit) -
agent/request waterfall packages/core/agent/src/types.ts:442 agent-loop (waterfall) -
agent/session-start emit packages/core/agent/src/types.ts:346 - hooks-claude, hooks-codex, invariants
agent/status emit packages/core/agent/src/types.ts:312 agent-loop (emit) acp, invariants, stdio-agent
agent/step-result waterfall packages/core/agent/src/types.ts:457 agent-loop (waterfall) -
agent/turn-continuation waterfall packages/core/agent/src/types.ts:475 agent-loop (waterfall) hooks-claude, hooks-codex
fs/edit-intent waterfall packages/fs/fs/src/index.ts:123 tool-fs (waterfall) fs-policy
fs/observed emit packages/fs/fs/src/index.ts:138 tool-fs (emit) fs-policy
fs/write-intent waterfall packages/fs/fs/src/index.ts:109 tool-fs (waterfall) fs-policy
llm/stream waterfall packages/llm/llm/src/index.ts:39 llm (waterfall) invariants, llm-replay
session/created emit packages/core/session/src/index.ts:47 session (emit) invariants, session-persistence
session/event emit packages/core/session/src/index.ts:61 session (emit) acp, invariants, session-persistence, stdio-agent
session/flush parallel packages/core/session/src/index.ts:79 session (parallel) session-persistence
subagent/end emit packages/subagent/subagent/src/index.ts:107 subagent (events.dispatch) hooks-claude
subagent/provider-added emit packages/subagent/subagent/src/index.ts:73 subagent (emit) tool-subagent
subagent/provider-removed emit packages/subagent/subagent/src/index.ts:84 - tool-subagent
subagent/start emit packages/subagent/subagent/src/index.ts:96 subagent (events.dispatch) hooks-claude
system-prompt/assemble waterfall packages/core/system-prompt/src/index.ts:44 system-prompt (waterfall) -
system-prompt/change emit packages/core/system-prompt/src/index.ts:54 system-prompt (emit) -
tools/change emit packages/core/tools/src/index.ts:112 tools (emit) -
tools/post-execute waterfall packages/core/tools/src/index.ts:102 tools (waterfall) hooks-claude, hooks-codex
tools/pre-execute waterfall packages/core/tools/src/index.ts:82 tools (waterfall) hooks-claude, hooks-codex

Non-harness or undeclared event strings seen in package source

Event string Dispatchers Listeners
internal/dispatch - invariants

Maintenance mode: hybrid generated: Cordis event declarations and most producer/listener edges are AST-scanned; dynamic dispatch sites are classified in scripts/gen-doc-graphs.ts.