deepseek-harness/docs/event-producer-consumer.md

Event Producer And Consumer Matrix

This matrix shows which packages dispatch each harness-owned event and which packages listen to it. Events are many-to-many, so the dense relation data is presented as a table rather than one large graph. Receiver and event-name types also cover contained dispatch 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:183	agent-loop (events.dispatch)	-
agent-preset/selected	emit	packages/preset/agent-presets/src/types.ts:23	agent-presets (emit)	remotes
agent/created	emit	packages/core/agent/src/runtime-types.ts:166	agent (events.dispatch)	agent-presets, file-reference-local, goal-round-driver, schedule, tool-agent-team, tool-subagent
agent/disposed	emit	packages/core/agent/src/runtime-types.ts:175	agent (events.dispatch)	agent-loop, file-reference-local, goal-round-driver, subagent, tool-agent-team, tool-subagent
agent/error	emit	packages/core/agent/src/runtime-types.ts:297	agent-loop (emit)	acp, goal-round-driver, session-controller, session-telemetry
agent/inbox/claimed	emit	packages/core/agent/src/runtime-types.ts:204	agent-loop (emit)	acp, goal-round-driver, subagent, tool-jobs
agent/inbox/discarded	emit	packages/core/agent/src/runtime-types.ts:212	agent-loop (emit)	goal-round-driver, subagent
agent/inbox/inserted	emit	packages/core/agent/src/runtime-types.ts:193	agent-loop (emit)	goal-round-driver
agent/pre-step	waterfall	packages/core/agent/src/runtime-types.ts:238	agent-loop (waterfall)	agent-instructions, compaction-basic, goal-round-driver, hooks-claude-code, hooks-codex, plan-mode, repeat-tool-reminder, session-checkpoint-policy, session-reference, subagent-in-process-driver, time-context, tmux-context, tool-cordis, tool-skill, tool-subagent
agent/request	waterfall	packages/core/agent/src/runtime-types.ts:251	agent-loop (waterfall)	agent, webhook
agent/request-error	waterfall	packages/core/agent/src/runtime-types.ts:267	agent-loop (waterfall)	compaction-basic, llm-retry
agent/session-start	emit	packages/core/agent/src/runtime-types.ts:224	agent-loop (emitAgentEvent)	agent-team, goal, goal-round-driver, hooks-claude-code, hooks-codex
agent/status	emit	packages/core/agent/src/runtime-types.ts:185	agent-loop (emit)	agent, agent-team, compaction-basic, goal-round-driver, schedule, server, session-controller
agent/turn-stopping	serial	packages/core/agent/src/runtime-types.ts:285	agent-loop (serial)	hooks-claude-code, hooks-codex
api-session/activity	emit	packages/api/session-controller/src/types.ts:502	session-controller (emit)	remotes
api-session/added	emit	packages/api/session-controller/src/types.ts:482	session-controller (emit)	remotes
api-session/error	emit	packages/api/session-controller/src/types.ts:509	session-controller (emit)	remotes
api-session/removed	emit	packages/api/session-controller/src/types.ts:488	session-controller (emit)	remotes
api-session/status	emit	packages/api/session-controller/src/types.ts:495	session-controller (emit)	remotes
approval/request	waterfall	packages/interaction/user-approval/src/types.ts:85	user-approval (waterfall)	acp, remotes
authorization/settled	emit	packages/credentials/authorization/src/index.ts:57	authorization (events.dispatch)	authorization
commands/change	emit	packages/interaction/commands/src/types.ts:80	commands (events.dispatch)	remotes
cordis/dynamic-package	emit	packages/extensions/cordis-host-runner/src/types.ts:379	cordis-host-runner (emit)	remotes
cordis/dynamic-retract	emit	packages/extensions/cordis-host-runner/src/types.ts:385	cordis-host-runner (emit)	remotes
cordis/inspect-query	emit	packages/extensions/cordis-host-runner/src/types.ts:391	cordis-host-runner (emit)	remotes
cordis/inspect-query-resolved	emit	packages/extensions/cordis-host-runner/src/types.ts:397	cordis-host-runner (emit)	remotes
cordis/request-run	emit	packages/extensions/cordis-host-runner/src/types.ts:367	cordis-host-runner (emit)	remotes
cordis/request-run-resolved	emit	packages/extensions/cordis-host-runner/src/types.ts:373	cordis-host-runner (emit)	remotes
credentials/record-updated	emit	packages/credentials/credentials/src/types.ts:87	credentials (events.dispatch)	authorization
credentials/reference-updated	emit	packages/credentials/credentials/src/types.ts:75	credentials (events.dispatch)	credentials, remotes
domain/changed	emit	packages/storage/storage-domain/src/events.ts:46	storage-domain (emit)	storage-domain, workspace, workspace-controller
fs/edit-intent	waterfall	packages/fs/fs/src/index.ts:66	tool-fs (waterfall), tool-str-replace-editor (waterfall)	fs-observation-policy
fs/observed	emit	packages/fs/fs/src/index.ts:76	tool-fs (emit), tool-str-replace-editor (emit)	fs-observation-policy, skill-filesystem
fs/write-intent	waterfall	packages/fs/fs/src/index.ts:58	tool-fs (waterfall), tool-str-replace-editor (waterfall)	fs-observation-policy
goal/changed	emit	packages/goal/goal/src/domain.ts:114	goal (emit)	goal-round-driver
llm/adapters-updated	emit	packages/llm/llm/src/types.ts:23	llm (events.dispatch)	acp, llm, remotes
llm/stream	waterfall	packages/llm/llm/src/index.ts:66	llm (waterfall)	agent-loop, llm, llm-replay, session-checkpoint-policy, session-title
session-telemetry/record	waterfall	packages/session/session-telemetry/src/index.ts:43	session-telemetry (waterfall)	-
session/created	emit	packages/core/session/src/index.ts:54	session (events.dispatch)	compaction, goal, hook-protocol, llm-retry, permission-presets, plan-mode, schedule, server, session, session-controller, session-log-deepseek, session-persistence, session-projection, session-projection-cache, session-telemetry, time-context, tool-todo, tool-workflow, tools, user-approval
session/disposed	emit	packages/core/session/src/index.ts:64	session (events.dispatch)	agent-loop, agent-team, session-controller, session-persistence, session-projection-cache, session-telemetry, session-title
session/event	emit	packages/core/session/src/index.ts:76	session (events.dispatch)	acp, agent-instructions, agent-loop, agent-presets, agent-team, compaction, compaction-basic, file-reference-local, goal, goal-round-driver, headless, hook-protocol, loader-smoke, server, session, session-controller, session-persistence, session-projection, session-projection-cache, session-telemetry, session-telemetry-otel, session-title, token-meter, tool-todo, tool-workflow, tools, user-approval
session/flush	parallel	packages/core/session/src/index.ts:85	session (events.dispatch)	session-persistence, session-telemetry
settings/document-updated	emit	packages/settings/settings/src/types.ts:48	settings (events.dispatch)	remotes
settings/updated	emit	packages/settings/settings/src/types.ts:35	settings (events.dispatch)	settings
skills/change	emit	packages/skill/skill/src/index.ts:297	skill (events.dispatch)	-
subagent/end	emit	packages/subagent/subagent/src/index.ts:165	subagent (events.dispatch)	hooks-claude-code, server, subagent
subagent/provider-added	emit	packages/subagent/subagent/src/index.ts:139	subagent (emit)	subagent, tool-subagent
subagent/provider-removed	emit	packages/subagent/subagent/src/index.ts:145	subagent (events.dispatch)	subagent, tool-subagent
subagent/start	emit	packages/subagent/subagent/src/index.ts:156	subagent (events.dispatch)	hooks-claude-code, subagent
system-prompt/assemble	waterfall	packages/core/system-prompt/src/index.ts:31	system-prompt (waterfall)	agent, agent-presets, system-prompt
system-prompt/change	emit	packages/core/system-prompt/src/index.ts:37	system-prompt (emit)	-
tools/change	emit	packages/core/tools/src/index.ts:207	agent-presets (emit), tools (emit)	tool-subagent
tools/code-dispatch-log	waterfall	packages/core/tools/src/index.ts:189	tools (waterfall)	spill-policy
tools/execute	waterfall	packages/core/tools/src/index.ts:163	tools (waterfall)	session-checkpoint-policy, timeout-policy
tools/post-execute	waterfall	packages/core/tools/src/index.ts:175	tools (waterfall)	hooks-claude-code, hooks-codex, repeat-tool-reminder, spill-policy, tool-fs-search
tools/pre-execute	waterfall	packages/core/tools/src/index.ts:152	tools (waterfall)	hooks-claude-code, hooks-codex, tool-jobs
tools/result	emit	packages/core/tools/src/index.ts:197	tools (events.dispatch)	agent-instructions, subagent-in-process-driver
user-questions/request	waterfall	packages/interaction/user-questions/src/types.ts:85	user-questions (waterfall)	remotes
webserver/index-inject	emit	packages/host/webserver/src/index.ts:34	webserver (emit)	modules
workflow/agent-end	emit	packages/workflow/workflow/src/index.ts:79	workflow (events.dispatch)	tool-workflow, workflow
workflow/agent-start	emit	packages/workflow/workflow/src/index.ts:68	workflow (events.dispatch)	tool-workflow, workflow
workflow/end	emit	packages/workflow/workflow/src/index.ts:89	workflow (events.dispatch)	workflow
workflow/log	emit	packages/workflow/workflow/src/index.ts:58	workflow (events.dispatch)	-
workflow/phase	emit	packages/workflow/workflow/src/index.ts:51	workflow (events.dispatch)	-
workflow/start	emit	packages/workflow/workflow/src/index.ts:43	workflow (events.dispatch)	workflow

Non-harness or undeclared event strings seen in package source

Event string	Dispatchers	Listeners
internal/dispatch	-	agent-team, commands, compaction, fs, goal, goal-round-driver, hook-protocol, llm-retry, permission-presets, plan-mode, sandbox-policy, schedule, scope, session, session-log-deepseek, session-title, subagent, terminal-bash, time-context, tool-todo, tool-workflow, tools, user-approval, webhook, workflow
internal/plugin	-	loader, lsp-stdio, modules, webserver
internal/service	-	agent-presets, gateway
internal/status	-	agent

Maintenance mode: generated: Cordis event declarations and producer/listener edges are resolved from the repository TypeScript Program.