Pine/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases 1 Wiki Activity
Files
e01be02dab0c24fd6180ba9bbd226b783dd8a284
deepseek-harness/docs/event-producer-consumer.md
T
Yichen Jiang 259d998455 fix(web): follow a blank session's preset switch in the slash catalog 
Presets own the rows that decide what a session's `/` menu contains, but
both browser catalogs cache per session and had no invalidation edge for a
recompose: `commands/changed` is registry-wide and recomposing registers
nothing, so the menu kept serving the composition the session no longer ran.

The host stream now frames the logged `agent-preset/selected` commit as
`host/session-preset-changed`; the runtime bridges it to the typed
`session/preset-changed` event, `ui-command` soft-refreshes that session's
directory key and `ui-skill` invalidates its catalog entry.

Reaching the host on a second switch was a separate defect: the list-row
identity guard compared every summary field except `agentPreset`, and the
merge keeps the row's `updatedAt`, so a switched row looked unchanged and
served its cached instance forever. The hero chip compares the pick against
that row, so switching back to the creation-time preset sent no RPC at all.
2026-08-10 14:35:13 +08:00

18 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. 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:182 agent-loop (events.dispatch) -
agent/created emit packages/core/agent/src/runtime-types.ts:159 agent (events.dispatch) goal-session
agent/disposed emit packages/core/agent/src/runtime-types.ts:168 agent (events.dispatch) agent-loop, goal-session, subagent
agent/error emit packages/core/agent/src/runtime-types.ts:290 agent-loop (emit) acp, apiproxy, goal-session, session-telemetry
agent/inbox/claimed emit packages/core/agent/src/runtime-types.ts:197 agent-loop (emit) acp, goal-session, subagent
agent/inbox/discarded emit packages/core/agent/src/runtime-types.ts:205 agent-loop (emit) goal-session, subagent
agent/inbox/inserted emit packages/core/agent/src/runtime-types.ts:186 agent-loop (emit) goal-session
agent/pre-step waterfall packages/core/agent/src/runtime-types.ts:231 agent-loop (waterfall) compact-basic, goal-session, hooks-claude, hooks-codex, plan-mode, repeat-tool-guard, session-checkpoint-policy, subagent-inprocess, time-context, tmux-context, tool-skill, workspace-context
agent/request waterfall packages/core/agent/src/runtime-types.ts:244 agent-loop (waterfall) agent
agent/request-error waterfall packages/core/agent/src/runtime-types.ts:260 agent-loop (waterfall) compact-basic, llm-retry
agent/session-start emit packages/core/agent/src/runtime-types.ts:217 agent-loop (emitAgentEvent) goal, goal-session, hooks-claude, hooks-codex
agent/status emit packages/core/agent/src/runtime-types.ts:178 agent-loop (emit) agent, apiproxy, compact-basic, goal-session, server
agent/turn-stopping serial packages/core/agent/src/runtime-types.ts:278 agent-loop (serial) hooks-claude, hooks-codex
approval/request waterfall packages/interaction/user-approval/src/index.ts:30 user-approval (waterfall) acp, apiproxy
commands/change emit packages/interaction/commands/src/index.ts:134 commands (events.dispatch) apiproxy
credentials/updated emit packages/credentials/credentials/src/index.ts:67 credentials (events.dispatch) apiproxy, credentials
domain/changed emit packages/storage/storage-domain/src/events.ts:46 storage-domain (emit) apiproxy, storage-domain, workspace
fs/edit-intent waterfall packages/fs/fs/src/index.ts:66 tool-fs (waterfall), tool-str-replace-editor (waterfall) fs-policy
fs/observed emit packages/fs/fs/src/index.ts:76 tool-fs (emit), tool-str-replace-editor (emit) fs-policy, skill-local
fs/write-intent waterfall packages/fs/fs/src/index.ts:58 tool-fs (waterfall), tool-str-replace-editor (waterfall) fs-policy
goal/changed emit packages/goal/goal/src/domain.ts:114 goal (emit) goal-session
llm/adapters-updated emit packages/llm/llm/src/index.ts:73 llm (events.dispatch) apiproxy, llm
llm/stream waterfall packages/llm/llm/src/index.ts:62 llm (waterfall) agent-loop, llm, llm-replay, session-checkpoint-policy, session-title
session/created emit packages/core/session/src/index.ts:74 session (events.dispatch) apiproxy, compact, goal, hook-protocol, llm-retry, permission, plan-mode, server, session, session-persistence, session-telemetry, tools, user-approval
session/disposed emit packages/core/session/src/index.ts:84 session (events.dispatch) agent-loop, apiproxy, session-persistence, session-projection-cache, session-telemetry, session-title
session/event emit packages/core/session/src/index.ts:96 session (events.dispatch) acp, agent-loop, apiproxy, compact, compact-basic, goal, goal-session, hook-protocol, loader-smoke, server, session, session-persistence, session-projection, session-projection-cache, session-telemetry, session-telemetry-otel, session-title, token-meter, tools, user-approval, workspace-context
session/flush parallel packages/core/session/src/index.ts:105 session (events.dispatch) session-persistence, session-telemetry
settings/document-updated emit packages/settings/settings/src/index.ts:170 settings (events.dispatch) apiproxy
settings/updated emit packages/settings/settings/src/index.ts:157 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:162 subagent (events.dispatch) hooks-claude, server, subagent
subagent/provider-added emit packages/subagent/subagent/src/index.ts:136 subagent (emit) subagent, tool-subagent
subagent/provider-removed emit packages/subagent/subagent/src/index.ts:142 subagent (events.dispatch) subagent, tool-subagent
subagent/start emit packages/subagent/subagent/src/index.ts:153 subagent (events.dispatch) hooks-claude, subagent
system-prompt/assemble waterfall packages/core/system-prompt/src/index.ts:29 system-prompt (waterfall) agent, system-prompt
system-prompt/change emit packages/core/system-prompt/src/index.ts:35 system-prompt (emit) -
telemetry/record waterfall packages/session/session-telemetry/src/index.ts:43 session-telemetry (waterfall) -
tools/change emit packages/core/tools/src/index.ts:192 tools (emit) -
tools/code-dispatch-log waterfall packages/core/tools/src/index.ts:174 tools (waterfall) spill-policy
tools/execute waterfall packages/core/tools/src/index.ts:149 tools (waterfall) session-checkpoint-policy, timeout-policy
tools/post-execute waterfall packages/core/tools/src/index.ts:161 tools (waterfall) hooks-claude, hooks-codex, repeat-tool-guard, spill-policy, tool-fs-search
tools/pre-execute waterfall packages/core/tools/src/index.ts:138 tools (waterfall) hooks-claude, hooks-codex, tool-tasks
tools/result emit packages/core/tools/src/index.ts:182 tools (events.dispatch) subagent-inprocess, workspace-context
workflow/agent-end emit packages/workflow/workflow/src/index.ts:81 workflow (events.dispatch) workflow
workflow/agent-start emit packages/workflow/workflow/src/index.ts:70 workflow (events.dispatch) workflow
workflow/end emit packages/workflow/workflow/src/index.ts:91 workflow (events.dispatch) workflow
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) workflow

Non-harness or undeclared event strings seen in package source

Event string Dispatchers Listeners
commands/changed runtime (emit) ui-command
connection/reset runtime (emit) ui-command, ui-models, ui-permission, ui-settings-general
credentials/changed runtime (emit) ui-models
internal/dispatch - commands, compact, fs, goal, goal-session, hook-protocol, llm-retry, permission, plan-mode, pty-local, runtime, sandbox-policy, scope, session, session-title, subagent, time-context, tool-todo, tools, user-approval, workflow
internal/plugin - hmr, loader, lsp-local, modules, webserver
internal/service - agent-presets, gateway
internal/status - agent
locale/change locale (emit) locale
models/changed runtime (emit) ui-models
session/preset-changed runtime (emit) ui-command
settings/changed runtime (emit) ui-models, ui-permission, ui-settings-general
slash/input-begin-command - ui-conversation
slash/input-consume-token - ui-conversation
slash/input-insert-reference - ui-conversation
slash/input-insert-text - ui-conversation
slots/changed runtime (emit) -
theme/change ui-theme (emit) ui-layout, ui-theme

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

Reference in New Issue View Git Blame Copy Permalink