Files
deepseek-harness/docs/event-producer-consumer.md
Tianyi Cui 56e34619d7 Merge remote-tracking branch 'origin/master' into codex/pr224-rfc-rewrite
# Conflicts:
#	docs/architecture.md
#	docs/capability-seams.md
#	docs/config-catalog.md
#	docs/cookbook/extension-cookbook.md
#	docs/cordis-catalog/events.md
#	docs/cordis-catalog/services.md
#	docs/event-producer-consumer.md
#	docs/module-graph.md
#	docs/rfc/implemented/feature/2026-06-30-interception-seams.md
#	docs/rfc/proposed/feature/2026-06-14-acp-agent-client-protocol.md
#	docs/tool-execution-pipeline.md
#	packages/cordis/tool-cordis/src/api-catalog.ts
#	packages/core/agent-core/README.md
#	packages/core/agent-loop/README.md
#	packages/core/tools/README.md
#	packages/core/tools/src/index.ts
#	packages/core/tools/tests/tools.spec.ts
#	packages/core/tools/tsconfig.json
#	packages/ui/acp/src/index.ts
#	scripts/doc-budgets.manifest.json
#	scripts/gen-cordis-catalog.ts
#	scripts/gen-doc-graphs.ts
2026-07-11 23:14:09 +08:00

10 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:298 agent (emit) stdio-agent
agent/disposed emit packages/core/agent/src/types.ts:312 agent (emit) stdio-agent
agent/error emit packages/core/agent/src/types.ts:585 agent-loop (emit) -
agent/pre-step serial packages/core/agent/src/types.ts:417 agent-loop (serial) compact-basic, user-approval
agent/prompt-submit waterfall packages/core/agent/src/types.ts:435 agent-loop (waterfall) acp, hooks-claude, hooks-codex, repeat-tool-guard
agent/queued emit packages/core/agent/src/types.ts:340 agent-loop (emit) -
agent/request waterfall packages/core/agent/src/types.ts:464 agent-loop (waterfall) -
agent/session-prefix waterfall packages/core/agent/src/types.ts:516 agent-loop (waterfall) tool-skill
agent/session-start emit packages/core/agent/src/types.ts:360 agent-loop (emit) hooks-claude, hooks-codex, invariants
agent/status emit packages/core/agent/src/types.ts:326 agent-loop (emit) acp, invariants, repeat-tool-guard, stdio-agent
agent/step-result waterfall packages/core/agent/src/types.ts:531 agent-loop (waterfall) -
agent/turn-continuation waterfall packages/core/agent/src/types.ts:549 agent-loop (waterfall) hooks-claude, hooks-codex
agent/turn-stop serial packages/core/agent/src/types.ts:568 agent-loop (strictSerial (serial)) subagent-inprocess
approval/request waterfall packages/ui/user-approval/src/index.ts:69 user-approval (waterfall) acp
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
skill/provider-added emit packages/skill/skill/src/index.ts:130 skill (emit) -
skill/provider-removed emit packages/skill/skill/src/index.ts:136 skill (emit) -
subagent/end emit packages/subagent/subagent/src/index.ts:109 subagent (events.dispatch) hooks-claude
subagent/provider-added emit packages/subagent/subagent/src/index.ts:75 subagent (emit) tool-subagent
subagent/provider-removed emit packages/subagent/subagent/src/index.ts:86 subagent (events.dispatch) tool-subagent
subagent/start emit packages/subagent/subagent/src/index.ts:98 subagent (events.dispatch) hooks-claude
system-prompt/assemble waterfall packages/core/system-prompt/src/index.ts:45 system-prompt (waterfall) -
system-prompt/change emit packages/core/system-prompt/src/index.ts:55 system-prompt (emit) -
tools/change emit packages/core/tools/src/index.ts:173 tools (emit) -
tools/execute waterfall packages/core/tools/src/index.ts:128 tools (waterfall) timeout-policy
tools/post-execute waterfall packages/core/tools/src/index.ts:148 tools (waterfall) hooks-claude, hooks-codex, repeat-tool-guard
tools/pre-execute waterfall packages/core/tools/src/index.ts:101 tools (waterfall) hooks-claude, hooks-codex
tools/result parallel packages/core/tools/src/index.ts:163 tools (events.dispatch) subagent-inprocess
workflow/agent-end emit packages/workflow/workflow/src/index.ts:96 workflow (events.dispatch) -
workflow/agent-start emit packages/workflow/workflow/src/index.ts:85 workflow (events.dispatch) -
workflow/end emit packages/workflow/workflow/src/index.ts:106 workflow (events.dispatch) -
workflow/log emit packages/workflow/workflow/src/index.ts:77 workflow (events.dispatch) -
workflow/phase emit packages/workflow/workflow/src/index.ts:70 workflow (events.dispatch) -
workflow/start emit packages/workflow/workflow/src/index.ts:62 workflow (events.dispatch) -

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.