Files

T

creatixchu 9186824e87 feat(session): refuse session logs a build cannot faithfully read

Old runtimes meeting a newer session format now fail loud instead of
misreading: version refusal names the direction (newer: upgrade the
harness; older: no upgrade path) and points at the raw JSONL log, and an
event type outside the generated known vocabulary refuses resume unless
its envelope carries the new ignorable: true marker (default: required,
so a forgotten marker over-refuses instead of silently resuming a gutted
session). gen-persistence-catalog now also emits
KNOWN_SESSION_EVENT_TYPES; SQLite stores the marker in a dedicated
column (SCHEMA_VERSION 15). The versioning design (monotonic integer,
n->n+1 upgrader chain, migrate-on-continue) is recorded in the
session-log-version-mechanism Agent Note.

2026-08-11 11:23:48 +08:00

18 KiB

Raw Blame History

事件生产方与消费方矩阵

English | 中文

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

事件	模式	声明位置	派发方	监听方
`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:75`	`llm` (`events.dispatch`)	`apiproxy`, `llm`
`llm/stream`	`waterfall`	`packages/llm/llm/src/index.ts:64`	`llm` (`waterfall`)	`agent-loop`, `llm`, `llm-replay`, `session-checkpoint-policy`, `session-title`
`session/created`	`emit`	`packages/core/session/src/index.ts:75`	`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:85`	`session` (`events.dispatch`)	`agent-loop`, `apiproxy`, `session-persistence`, `session-projection-cache`, `session-telemetry`, `session-title`
`session/event`	`emit`	`packages/core/session/src/index.ts:97`	`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:106`	`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:165`	`subagent` (`events.dispatch`)	`hooks-claude`, `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`, `subagent`
`system-prompt/assemble`	`waterfall`	`packages/core/system-prompt/src/index.ts:31`	`system-prompt` (`waterfall`)	`agent`, `system-prompt`
`system-prompt/change`	`emit`	`packages/core/system-prompt/src/index.ts:37`	`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:193`	`tools` (`emit`)	-
`tools/code-dispatch-log`	`waterfall`	`packages/core/tools/src/index.ts:175`	`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:183`	`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`)	`runtime`, `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`)	`runtime`, `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.

18 KiB Raw Blame History

事件生产方与消费方矩阵

Non-harness or undeclared event strings seen in package source

18 KiB

Raw Blame History