跳转到主要内容

事件生产方与消费方矩阵

English | 中文

本矩阵展示哪些包会派发各个 harness 自有事件,以及哪些包会监听这些事件。事件之间存在多对多关系,因此密集的关系数据以表格而非一张大型关系图呈现。接收方和事件名称类型还涵盖有意绕过 ctx.emit 的内含派发位置,例如 subagent 生命周期封装。

事件模式声明位置派发方监听方
agent-loop/config-start-failedemitpackages/core/agent-loop/src/index.ts:239agent-loop (events.dispatch)-
agent-preset/selectedemitpackages/preset/agent-presets/src/types.ts:80agent-presets (emit)remotes
agent/createdemitpackages/core/agent/src/runtime-types.ts:166agent (events.dispatch)agent-presets, file-reference-local, goal-round-driver, schedule, tool-agent-team, tool-subagent
agent/disposedemitpackages/core/agent/src/runtime-types.ts:175agent (events.dispatch)agent-loop, file-reference-local, goal-round-driver, subagent, tool-agent-team, tool-subagent
agent/erroremitpackages/core/agent/src/runtime-types.ts:297agent-loop (emit)acp, goal-round-driver, session-controller, session-telemetry
agent/inbox/claimedemitpackages/core/agent/src/runtime-types.ts:204agent-loop (emit)acp, goal-round-driver, subagent, tool-jobs
agent/inbox/discardedemitpackages/core/agent/src/runtime-types.ts:212agent-loop (emit)goal-round-driver, subagent
agent/inbox/insertedemitpackages/core/agent/src/runtime-types.ts:193agent-loop (emit)goal-round-driver
agent/pre-stepwaterfallpackages/core/agent/src/runtime-types.ts:238agent-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/requestwaterfallpackages/core/agent/src/runtime-types.ts:251agent-loop (waterfall)agent, webhook
agent/request-errorwaterfallpackages/core/agent/src/runtime-types.ts:267agent-loop (waterfall)compaction-basic, llm-retry
agent/session-startemitpackages/core/agent/src/runtime-types.ts:224agent-loop (emitAgentEvent)agent-team, goal, goal-round-driver, hooks-claude-code, hooks-codex
agent/statusemitpackages/core/agent/src/runtime-types.ts:185agent-loop (emit)agent, agent-team, compaction-basic, goal-round-driver, schedule, server, session-controller
agent/turn-stoppingserialpackages/core/agent/src/runtime-types.ts:285agent-loop (serial)hooks-claude-code, hooks-codex
api-session/activityemitpackages/api/session-controller/src/types.ts:542session-controller (emit)remotes
api-session/addedemitpackages/api/session-controller/src/types.ts:522session-controller (emit)remotes
api-session/erroremitpackages/api/session-controller/src/types.ts:549session-controller (emit)remotes
api-session/removedemitpackages/api/session-controller/src/types.ts:528session-controller (emit)remotes
api-session/statusemitpackages/api/session-controller/src/types.ts:535session-controller (emit)remotes
approval/requestwaterfallpackages/interaction/user-approval/src/types.ts:85user-approval (waterfall)acp, remotes
authorization/settledemitpackages/credentials/authorization/src/index.ts:57authorization (events.dispatch)authorization
commands/changeemitpackages/interaction/commands/src/types.ts:81commands (events.dispatch)remotes
cordis/dynamic-packageemitpackages/extensions/cordis-host-runner/src/types.ts:380cordis-host-runner (emit)remotes
cordis/dynamic-retractemitpackages/extensions/cordis-host-runner/src/types.ts:386cordis-host-runner (emit)remotes
cordis/inspect-queryemitpackages/extensions/cordis-host-runner/src/types.ts:392cordis-host-runner (emit)remotes
cordis/inspect-query-resolvedemitpackages/extensions/cordis-host-runner/src/types.ts:398cordis-host-runner (emit)remotes
cordis/request-runemitpackages/extensions/cordis-host-runner/src/types.ts:368cordis-host-runner (emit)remotes
cordis/request-run-resolvedemitpackages/extensions/cordis-host-runner/src/types.ts:374cordis-host-runner (emit)remotes
credentials/record-updatedemitpackages/credentials/credentials/src/types.ts:96credentials (events.dispatch)authorization
credentials/reference-updatedemitpackages/credentials/credentials/src/types.ts:84credentials (events.dispatch)credentials, remotes
domain/changedemitpackages/storage/storage-domain/src/events.ts:46storage-domain (emit)storage-domain, workspace, workspace-controller
fs/edit-intentwaterfallpackages/fs/fs/src/index.ts:66tool-fs (waterfall), tool-str-replace-editor (waterfall)fs-observation-policy
fs/observedemitpackages/fs/fs/src/index.ts:76tool-fs (emit), tool-str-replace-editor (emit)fs-observation-policy, skill-filesystem
fs/write-intentwaterfallpackages/fs/fs/src/index.ts:58tool-fs (waterfall), tool-str-replace-editor (waterfall)fs-observation-policy
goal/changedemitpackages/goal/goal/src/domain.ts:114goal (emit)goal-round-driver
llm/adapters-updatedemitpackages/llm/llm/src/types.ts:23llm (events.dispatch)acp, llm, remotes
llm/streamwaterfallpackages/llm/llm/src/index.ts:67llm (waterfall)agent-loop, llm, llm-replay, session-checkpoint-policy, session-title
session-telemetry/recordwaterfallpackages/session/session-telemetry/src/index.ts:43session-telemetry (waterfall)-
session/createdemitpackages/core/session/src/index.ts:52session (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, session-title, time-context, tool-todo, tool-workflow, tools, user-approval
session/disposedemitpackages/core/session/src/index.ts:62session (events.dispatch)agent-loop, agent-team, session-controller, session-persistence, session-projection-cache, session-telemetry, session-title
session/eventemitpackages/core/session/src/index.ts:74session (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/flushparallelpackages/core/session/src/index.ts:83session (events.dispatch)session-persistence, session-telemetry
settings/document-updatedemitpackages/settings/settings/src/types.ts:105settings (events.dispatch)remotes
settings/updatedemitpackages/settings/settings/src/types.ts:92settings (events.dispatch)settings
skills/changeemitpackages/skill/skill/src/index.ts:298skill (events.dispatch)-
subagent/endemitpackages/subagent/subagent/src/index.ts:173subagent (events.dispatch)hooks-claude-code, server, subagent
subagent/provider-addedemitpackages/subagent/subagent/src/index.ts:147subagent (emit)subagent, tool-subagent
subagent/provider-removedemitpackages/subagent/subagent/src/index.ts:153subagent (events.dispatch)subagent, tool-subagent
subagent/startemitpackages/subagent/subagent/src/index.ts:164subagent (events.dispatch)hooks-claude-code, subagent
system-prompt/assemblewaterfallpackages/core/system-prompt/src/index.ts:31system-prompt (waterfall)agent, agent-presets, system-prompt
system-prompt/changeemitpackages/core/system-prompt/src/index.ts:37system-prompt (emit)-
tools/changeemitpackages/core/tools/src/index.ts:199agent-presets (emit), tools (emit)tool-subagent
tools/executewaterfallpackages/core/tools/src/index.ts:155tools (waterfall)session-checkpoint-policy, timeout-policy
tools/post-executewaterfallpackages/core/tools/src/index.ts:167tools (waterfall)hooks-claude-code, hooks-codex, repeat-tool-reminder, spill-policy, tool-fs-search
tools/pre-executewaterfallpackages/core/tools/src/index.ts:144tools (waterfall)hooks-claude-code, hooks-codex, tool-jobs
tools/ptc-dispatch-logwaterfallpackages/core/tools/src/index.ts:181tools (waterfall)spill-policy
tools/resultemitpackages/core/tools/src/index.ts:189tools (events.dispatch)agent-instructions, subagent-in-process-driver
user-questions/requestwaterfallpackages/interaction/user-questions/src/types.ts:85user-questions (waterfall)remotes
webserver/index-injectemitpackages/host/webserver/src/index.ts:34webserver (emit)inspector, modules
workflow/agent-endemitpackages/workflow/workflow/src/index.ts:79workflow (events.dispatch)tool-workflow, workflow
workflow/agent-startemitpackages/workflow/workflow/src/index.ts:68workflow (events.dispatch)tool-workflow, workflow
workflow/endemitpackages/workflow/workflow/src/index.ts:89workflow (events.dispatch)workflow
workflow/logemitpackages/workflow/workflow/src/index.ts:58workflow (events.dispatch)-
workflow/phaseemitpackages/workflow/workflow/src/index.ts:51workflow (events.dispatch)-
workflow/startemitpackages/workflow/workflow/src/index.ts:43workflow (events.dispatch)workflow

包源码中出现的非 harness 或未声明事件字符串

事件字符串派发方监听方
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-inspector, loader, lsp-stdio, modules
internal/service-agent-presets, gateway
internal/status-agent, inspector

维护模式:生成内容。Cordis 事件声明及生产方/监听方的关系边由仓库的 TypeScript Program 解析。