Pine/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases 1 Wiki Activity
Files
9745a0d43a979d34c44c2a42d8a485d03a25de71
deepseek-harness/docs/event-producer-consumer.md
T
Tianyi Cui 83271191d1 Merge branch 'codex/simp-agent-entry-state' into codex/simp-unify-agent-session-id 
# Conflicts:
#	docs/config-catalog.md
#	docs/cordis-catalog/services.md
#	docs/event-producer-consumer.md
#	docs/rfc/implemented/architecture/2026-06-18-agent-lifecycle-and-ownership-seams.md
#	docs/rfc/implemented/architecture/2026-06-20-branded-ids.md
#	docs/rfc/implemented/simplification/2026-06-20-remove-agent-boundary-mirror-events.md
#	docs/rfc/proposed/feature/2026-07-07-claude-code-and-codex-subagent-backends.md
#	docs/rfc/proposed/simplification/2026-06-20-unify-agent-and-session-id.md
#	packages/bash/tool-bash/README.md
#	packages/bash/tool-bash/src/index.ts
#	packages/bash/tool-bash/tests/tools.spec.ts
#	packages/core/agent-loop/README.md
#	packages/core/agent-loop/tests/properties.spec.ts
#	packages/core/agent/README.md
#	packages/core/agent/src/index.ts
#	packages/guard/repeat-tool-guard/src/index.ts
#	packages/hooks/hooks-claude/tests/bridge.spec.ts
#	packages/subagent/subagent-acp/tests/mock-acp-server.ts
#	packages/ui/acp/tests/dispose.spec.ts
#	packages/ui/stdio-agent/src/index.ts
#	packages/ui/stdio-agent/src/stdio-chat.ts
#	packages/ui/stdio-agent/tests/stdio-chat.spec.ts
#	packages/util/brand/src/index.ts
2026-07-14 18:51:24 +08:00

10 KiB
Raw Blame History

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-loop/config-start-failed emit packages/core/agent-loop/src/index.ts:353 agent-loop (events.dispatch) stdio-agent
agent/created emit packages/core/agent/src/types.ts:304 agent (events.dispatch) jsonrpc, stdio-agent
agent/disposed emit packages/core/agent/src/types.ts:319 agent (events.dispatch) stdio-agent
agent/error emit packages/core/agent/src/types.ts:593 agent-loop (emit) -
agent/pre-step serial packages/core/agent/src/types.ts:426 agent-loop (serial) compact-basic, user-approval
agent/prompt-submit waterfall packages/core/agent/src/types.ts:444 agent-loop (waterfall) acp, hooks-claude, hooks-codex, repeat-tool-guard
agent/queued emit packages/core/agent/src/types.ts:348 agent-loop (emit) -
agent/request waterfall packages/core/agent/src/types.ts:473 agent-loop (waterfall) -
agent/session-prefix waterfall packages/core/agent/src/types.ts:525 agent-loop (waterfall) tool-skill
agent/session-start emit packages/core/agent/src/types.ts:369 agent-loop (emit) hooks-claude, hooks-codex, invariants, stdio-agent
agent/status emit packages/core/agent/src/types.ts:333 agent-loop (emit) invariants, stdio-agent
agent/step-result waterfall packages/core/agent/src/types.ts:540 agent-loop (waterfall) -
agent/turn-continuation waterfall packages/core/agent/src/types.ts:558 agent-loop (waterfall) hooks-claude, hooks-codex
agent/turn-stop serial packages/core/agent/src/types.ts:576 agent-loop (serial) subagent-inprocess
approval/request waterfall packages/ui/user-approval/src/index.ts:31 user-approval (waterfall) acp
fs/edit-intent waterfall packages/fs/fs/src/index.ts:59 tool-fs (waterfall) fs-policy
fs/observed emit packages/fs/fs/src/index.ts:68 tool-fs (emit) fs-policy
fs/write-intent waterfall packages/fs/fs/src/index.ts:51 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:46 session (events.dispatch) invariants, jsonrpc, session-persistence
session/disposed emit packages/core/session/src/index.ts:55 session (events.dispatch) -
session/event emit packages/core/session/src/index.ts:66 session (events.dispatch) acp, invariants, jsonrpc, session-persistence, stdio-agent
session/flush parallel packages/core/session/src/index.ts:75 session (events.dispatch) session-persistence
skill/provider-added emit packages/skill/skill/src/index.ts:131 skill (emit) -
skill/provider-removed emit packages/skill/skill/src/index.ts:137 skill (emit) -
subagent/end emit packages/subagent/subagent/src/index.ts:91 subagent (events.dispatch) hooks-claude, jsonrpc
subagent/provider-added emit packages/subagent/subagent/src/index.ts:67 subagent (emit) tool-subagent
subagent/provider-removed emit packages/subagent/subagent/src/index.ts:73 subagent (events.dispatch) tool-subagent
subagent/start emit packages/subagent/subagent/src/index.ts:83 subagent (events.dispatch) hooks-claude
system-prompt/assemble waterfall packages/core/system-prompt/src/index.ts:27 system-prompt (waterfall) -
system-prompt/change emit packages/core/system-prompt/src/index.ts:33 system-prompt (emit) -
tools/change emit packages/core/tools/src/index.ts:116 tools (emit) -
tools/execute waterfall packages/core/tools/src/index.ts:89 tools (waterfall) timeout-policy
tools/post-execute waterfall packages/core/tools/src/index.ts:98 tools (waterfall) hooks-claude, hooks-codex, repeat-tool-guard
tools/pre-execute waterfall packages/core/tools/src/index.ts:80 tools (waterfall) hooks-claude, hooks-codex
tools/result emit packages/core/tools/src/index.ts:106 tools (events.dispatch) subagent-inprocess
workflow/agent-end emit packages/workflow/workflow/src/index.ts:81 workflow (events.dispatch) -
workflow/agent-start emit packages/workflow/workflow/src/index.ts:70 workflow (events.dispatch) -
workflow/end emit packages/workflow/workflow/src/index.ts:91 workflow (events.dispatch) -
workflow/log emit packages/workflow/workflow/src/index.ts:60 workflow (events.dispatch) -
workflow/phase emit packages/workflow/workflow/src/index.ts:53 workflow (events.dispatch) -
workflow/start emit packages/workflow/workflow/src/index.ts:45 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.

Reference in New Issue View Git Blame Copy Permalink