docs/event-producer-consumer.md

<!-- Generated by scripts/gen-doc-graphs.ts - do not edit by hand.
     Run `pnpm run gen-doc-graphs` to regenerate. -->

# 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. 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:353`](../packages/core/agent-loop/src/index.ts) | [`agent-loop`](../packages/core/agent-loop) (`events.dispatch`) | [`tui`](../packages/ui/tui) |
| `agent/cancel-requested` | `emit` | [`packages/core/agent/src/types.ts:191`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`emit`) | [`goal-session`](../packages/goal/goal-session) |
| `agent/created` | `emit` | [`packages/core/agent/src/types.ts:153`](../packages/core/agent/src/types.ts) | [`agent`](../packages/core/agent) (`events.dispatch`) | [`goal-session`](../packages/goal/goal-session), [`tui`](../packages/ui/tui) |
| `agent/disposed` | `emit` | [`packages/core/agent/src/types.ts:162`](../packages/core/agent/src/types.ts) | [`agent`](../packages/core/agent) (`events.dispatch`) | [`agent-loop`](../packages/core/agent-loop), [`goal-session`](../packages/goal/goal-session), [`tui`](../packages/ui/tui) |
| `agent/error` | `emit` | [`packages/core/agent/src/types.ts:328`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`emit`) | [`goal-session`](../packages/goal/goal-session), [`tui`](../packages/ui/tui) |
| `agent/post-step` | `serial` | [`packages/core/agent/src/types.ts:280`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`serial`) | [`compact-basic`](../packages/compact/compact-basic) |
| `agent/pre-step` | `serial` | [`packages/core/agent/src/types.ts:220`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`serial`) | [`time-context`](../packages/context/time-context), [`user-approval`](../packages/ui/user-approval) |
| `agent/prompt-submit` | `waterfall` | [`packages/core/agent/src/types.ts:230`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`waterfall`) | [`acp`](../packages/ui/acp), [`goal-session`](../packages/goal/goal-session), [`hooks-claude`](../packages/hooks/hooks-claude), [`hooks-codex`](../packages/hooks/hooks-codex), [`repeat-tool-guard`](../packages/guard/repeat-tool-guard) |
| `agent/queued` | `emit` | [`packages/core/agent/src/types.ts:181`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`emit`) | [`goal-session`](../packages/goal/goal-session) |
| `agent/request` | `waterfall` | [`packages/core/agent/src/types.ts:242`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`waterfall`) | [`agent`](../packages/core/agent) |
| `agent/request-error` | `waterfall` | [`packages/core/agent/src/types.ts:295`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`waterfall`) | [`compact-basic`](../packages/compact/compact-basic), [`llm-retry`](../packages/llm/llm-retry) |
| `agent/session-prefix` | `waterfall` | [`packages/core/agent/src/types.ts:257`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`waterfall`) | [`tool-skill`](../packages/skill/tool-skill), [`workspace-context`](../packages/context/workspace-context) |
| `agent/session-start` | `emit` | [`packages/core/agent/src/types.ts:204`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`emit`) | [`goal`](../packages/goal/goal), [`goal-session`](../packages/goal/goal-session), [`hooks-claude`](../packages/hooks/hooks-claude), [`hooks-codex`](../packages/hooks/hooks-codex) |
| `agent/status` | `emit` | [`packages/core/agent/src/types.ts:171`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`emit`) | [`agent`](../packages/core/agent), [`goal-session`](../packages/goal/goal-session), [`tui`](../packages/ui/tui) |
| `agent/step-result` | `waterfall` | [`packages/core/agent/src/types.ts:268`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`waterfall`) | - |
| `agent/turn-continuation` | `waterfall` | [`packages/core/agent/src/types.ts:305`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`waterfall`) | [`hooks-claude`](../packages/hooks/hooks-claude), [`hooks-codex`](../packages/hooks/hooks-codex) |
| `agent/turn-stop` | `serial` | [`packages/core/agent/src/types.ts:315`](../packages/core/agent/src/types.ts) | [`agent-loop`](../packages/core/agent-loop) (`serial`) | [`subagent-inprocess`](../packages/subagent/subagent-inprocess), [`tool-goal`](../packages/goal/tool-goal) |
| `approval/request` | `waterfall` | [`packages/ui/user-approval/src/index.ts:31`](../packages/ui/user-approval/src/index.ts) | [`user-approval`](../packages/ui/user-approval) (`waterfall`) | [`acp`](../packages/ui/acp) |
| `commands/change` | `emit` | [`packages/ui/commands/src/index.ts:83`](../packages/ui/commands/src/index.ts) | [`commands`](../packages/ui/commands) (`events.dispatch`) | [`acp`](../packages/ui/acp), [`tui`](../packages/ui/tui) |
| `fs/edit-intent` | `waterfall` | [`packages/fs/fs/src/index.ts:62`](../packages/fs/fs/src/index.ts) | [`tool-fs`](../packages/fs/tool-fs) (`waterfall`) | [`fs-policy`](../packages/fs/fs-policy) |
| `fs/observed` | `emit` | [`packages/fs/fs/src/index.ts:71`](../packages/fs/fs/src/index.ts) | [`tool-fs`](../packages/fs/tool-fs) (`emit`) | [`fs-policy`](../packages/fs/fs-policy) |
| `fs/write-intent` | `waterfall` | [`packages/fs/fs/src/index.ts:54`](../packages/fs/fs/src/index.ts) | [`tool-fs`](../packages/fs/tool-fs) (`waterfall`) | [`fs-policy`](../packages/fs/fs-policy) |
| `goal/changed` | `emit` | [`packages/goal/goal/src/types.ts:167`](../packages/goal/goal/src/types.ts) | [`goal`](../packages/goal/goal) (`emit`) | [`goal-session`](../packages/goal/goal-session) |
| `llm/stream` | `waterfall` | [`packages/llm/llm/src/index.ts:52`](../packages/llm/llm/src/index.ts) | [`llm`](../packages/llm/llm) (`waterfall`) | [`agent-loop`](../packages/core/agent-loop), [`llm`](../packages/llm/llm), [`llm-replay`](../packages/support/llm-replay) |
| `session/created` | `emit` | [`packages/core/session/src/index.ts:47`](../packages/core/session/src/index.ts) | [`session`](../packages/core/session) (`events.dispatch`) | [`compact`](../packages/compact/compact), [`goal`](../packages/goal/goal), [`hook-protocol`](../packages/hooks/hook-protocol), [`jsonrpc`](../packages/ui/jsonrpc), [`llm-retry`](../packages/llm/llm-retry), [`session`](../packages/core/session), [`session-persistence`](../packages/session-persistence/session-persistence), [`user-approval`](../packages/ui/user-approval) |
| `session/disposed` | `emit` | [`packages/core/session/src/index.ts:57`](../packages/core/session/src/index.ts) | [`session`](../packages/core/session) (`events.dispatch`) | [`agent-loop`](../packages/core/agent-loop), [`session-persistence`](../packages/session-persistence/session-persistence) |
| `session/event` | `emit` | [`packages/core/session/src/index.ts:69`](../packages/core/session/src/index.ts) | [`session`](../packages/core/session) (`events.dispatch`) | [`acp`](../packages/ui/acp), [`cli-demo`](../packages/examples/cli-demo), [`compact`](../packages/compact/compact), [`goal`](../packages/goal/goal), [`goal-session`](../packages/goal/goal-session), [`hook-protocol`](../packages/hooks/hook-protocol), [`jsonrpc`](../packages/ui/jsonrpc), [`session`](../packages/core/session), [`session-persistence`](../packages/session-persistence/session-persistence), [`token-meter`](../packages/llm/token-meter), [`tui`](../packages/ui/tui), [`user-approval`](../packages/ui/user-approval), [`workspace-context`](../packages/context/workspace-context) |
| `session/flush` | `parallel` | [`packages/core/session/src/index.ts:79`](../packages/core/session/src/index.ts) | [`session`](../packages/core/session) (`events.dispatch`) | [`session-persistence`](../packages/session-persistence/session-persistence) |
| `subagent/end` | `emit` | [`packages/subagent/subagent/src/index.ts:139`](../packages/subagent/subagent/src/index.ts) | [`subagent`](../packages/subagent/subagent) (`events.dispatch`) | [`hooks-claude`](../packages/hooks/hooks-claude), [`jsonrpc`](../packages/ui/jsonrpc), [`subagent`](../packages/subagent/subagent) |
| `subagent/provider-added` | `emit` | [`packages/subagent/subagent/src/index.ts:113`](../packages/subagent/subagent/src/index.ts) | [`subagent`](../packages/subagent/subagent) (`emit`) | [`subagent`](../packages/subagent/subagent), [`tool-subagent`](../packages/subagent/tool-subagent) |
| `subagent/provider-removed` | `emit` | [`packages/subagent/subagent/src/index.ts:119`](../packages/subagent/subagent/src/index.ts) | [`subagent`](../packages/subagent/subagent) (`events.dispatch`) | [`subagent`](../packages/subagent/subagent), [`tool-subagent`](../packages/subagent/tool-subagent) |
| `subagent/start` | `emit` | [`packages/subagent/subagent/src/index.ts:130`](../packages/subagent/subagent/src/index.ts) | [`subagent`](../packages/subagent/subagent) (`events.dispatch`) | [`hooks-claude`](../packages/hooks/hooks-claude), [`subagent`](../packages/subagent/subagent) |
| `system-prompt/assemble` | `waterfall` | [`packages/core/system-prompt/src/index.ts:27`](../packages/core/system-prompt/src/index.ts) | [`system-prompt`](../packages/core/system-prompt) (`waterfall`) | [`agent`](../packages/core/agent), [`system-prompt`](../packages/core/system-prompt) |
| `system-prompt/change` | `emit` | [`packages/core/system-prompt/src/index.ts:33`](../packages/core/system-prompt/src/index.ts) | [`system-prompt`](../packages/core/system-prompt) (`emit`) | - |
| `tools/change` | `emit` | [`packages/core/tools/src/index.ts:136`](../packages/core/tools/src/index.ts) | [`tools`](../packages/core/tools) (`emit`) | - |
| `tools/execute` | `waterfall` | [`packages/core/tools/src/index.ts:109`](../packages/core/tools/src/index.ts) | [`tools`](../packages/core/tools) (`waterfall`) | [`timeout-policy`](../packages/timeout/timeout-policy) |
| `tools/post-execute` | `waterfall` | [`packages/core/tools/src/index.ts:118`](../packages/core/tools/src/index.ts) | [`tools`](../packages/core/tools) (`waterfall`) | [`hooks-claude`](../packages/hooks/hooks-claude), [`hooks-codex`](../packages/hooks/hooks-codex), [`repeat-tool-guard`](../packages/guard/repeat-tool-guard), [`spill-policy`](../packages/spill/spill-policy), [`tool-fs-search`](../packages/fs/tool-fs-search), [`workspace-context`](../packages/context/workspace-context) |
| `tools/pre-execute` | `waterfall` | [`packages/core/tools/src/index.ts:100`](../packages/core/tools/src/index.ts) | [`tools`](../packages/core/tools) (`waterfall`) | [`hooks-claude`](../packages/hooks/hooks-claude), [`hooks-codex`](../packages/hooks/hooks-codex) |
| `tools/result` | `emit` | [`packages/core/tools/src/index.ts:126`](../packages/core/tools/src/index.ts) | [`tools`](../packages/core/tools) (`events.dispatch`) | [`subagent-inprocess`](../packages/subagent/subagent-inprocess), [`workspace-context`](../packages/context/workspace-context) |
| `workflow/agent-end` | `emit` | [`packages/workflow/workflow/src/index.ts:81`](../packages/workflow/workflow/src/index.ts) | [`workflow`](../packages/workflow/workflow) (`events.dispatch`) | [`workflow`](../packages/workflow/workflow) |
| `workflow/agent-start` | `emit` | [`packages/workflow/workflow/src/index.ts:70`](../packages/workflow/workflow/src/index.ts) | [`workflow`](../packages/workflow/workflow) (`events.dispatch`) | [`workflow`](../packages/workflow/workflow) |
| `workflow/end` | `emit` | [`packages/workflow/workflow/src/index.ts:91`](../packages/workflow/workflow/src/index.ts) | [`workflow`](../packages/workflow/workflow) (`events.dispatch`) | [`workflow`](../packages/workflow/workflow) |
| `workflow/log` | `emit` | [`packages/workflow/workflow/src/index.ts:60`](../packages/workflow/workflow/src/index.ts) | [`workflow`](../packages/workflow/workflow) (`events.dispatch`) | - |
| `workflow/phase` | `emit` | [`packages/workflow/workflow/src/index.ts:53`](../packages/workflow/workflow/src/index.ts) | [`workflow`](../packages/workflow/workflow) (`events.dispatch`) | - |
| `workflow/start` | `emit` | [`packages/workflow/workflow/src/index.ts:45`](../packages/workflow/workflow/src/index.ts) | [`workflow`](../packages/workflow/workflow) (`events.dispatch`) | [`workflow`](../packages/workflow/workflow) |

## Non-harness or undeclared event strings seen in package source

| Event string | Dispatchers | Listeners |
| --- | --- | --- |
| `internal/dispatch` | - | [`compact`](../packages/compact/compact), [`fs`](../packages/fs/fs), [`goal`](../packages/goal/goal), [`goal-session`](../packages/goal/goal-session), [`hook-protocol`](../packages/hooks/hook-protocol), [`llm-retry`](../packages/llm/llm-retry), [`permission`](../packages/ui/permission), [`sandbox-policy`](../packages/sandbox/sandbox-policy), [`scope`](../packages/core/scope), [`session`](../packages/core/session), [`subagent`](../packages/subagent/subagent), [`time-context`](../packages/context/time-context), [`tool-todo`](../packages/todo/tool-todo), [`tools`](../packages/core/tools), [`user-approval`](../packages/ui/user-approval), [`workflow`](../packages/workflow/workflow) |
| `internal/status` | - | [`agent`](../packages/core/agent) |

Maintenance mode: generated: Cordis event declarations and producer/listener edges are resolved from the repository TypeScript Program.
docs: revise graph docs from review 2026-07-05 01:25:58 +08:00			`<!-- Generated by scripts/gen-doc-graphs.ts - do not edit by hand.`
			Run `pnpm run gen-doc-graphs` to regenerate. -->

			`# Event Producer And Consumer Matrix`

refactor: derive event graphs and scope invariants from TypeScript 2026-07-14 23:14:51 +08:00			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. Receiver and event-name types also cover contained dispatch sites that deliberately bypass `ctx.emit`, such as subagent lifecycle containment.
docs: revise graph docs from review 2026-07-05 01:25:58 +08:00
			`\| Event \| Mode \| Declared in \| Dispatchers \| Listeners \|`
			`\| --- \| --- \| --- \| --- \| --- \|`
Merge remote-tracking branch 'origin/master' into codex/remove-stdio-agent 2026-07-20 20:29:08 +08:00			\| `agent-loop/config-start-failed` \| `emit` \| [`packages/core/agent-loop/src/index.ts:353`](../packages/core/agent-loop/src/index.ts) \| [`agent-loop`](../packages/core/agent-loop) (`events.dispatch`) \| [`tui`](../packages/ui/tui) \|
Merge branch 'codex/goal-tools' into codex/goal-session 2026-07-20 20:35:15 +08:00			\| `agent/cancel-requested` \| `emit` \| [`packages/core/agent/src/types.ts:191`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`emit`) \| [`goal-session`](../packages/goal/goal-session) \|
Merge branch 'codex/goal-tools' into codex/goal-session 2026-07-20 21:55:13 +08:00			\| `agent/created` \| `emit` \| [`packages/core/agent/src/types.ts:153`](../packages/core/agent/src/types.ts) \| [`agent`](../packages/core/agent) (`events.dispatch`) \| [`goal-session`](../packages/goal/goal-session), [`tui`](../packages/ui/tui) \|
			\| `agent/disposed` \| `emit` \| [`packages/core/agent/src/types.ts:162`](../packages/core/agent/src/types.ts) \| [`agent`](../packages/core/agent) (`events.dispatch`) \| [`agent-loop`](../packages/core/agent-loop), [`goal-session`](../packages/goal/goal-session), [`tui`](../packages/ui/tui) \|
Merge branch 'codex/goal-tools' into codex/goal-session 2026-07-20 22:57:14 +08:00			\| `agent/error` \| `emit` \| [`packages/core/agent/src/types.ts:328`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`emit`) \| [`goal-session`](../packages/goal/goal-session), [`tui`](../packages/ui/tui) \|
Merge branch 'codex/goal-tools' into codex/goal-session 2026-07-20 20:35:15 +08:00			\| `agent/post-step` \| `serial` \| [`packages/core/agent/src/types.ts:280`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`serial`) \| [`compact-basic`](../packages/compact/compact-basic) \|
			\| `agent/pre-step` \| `serial` \| [`packages/core/agent/src/types.ts:220`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`serial`) \| [`time-context`](../packages/context/time-context), [`user-approval`](../packages/ui/user-approval) \|
			\| `agent/prompt-submit` \| `waterfall` \| [`packages/core/agent/src/types.ts:230`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`waterfall`) \| [`acp`](../packages/ui/acp), [`goal-session`](../packages/goal/goal-session), [`hooks-claude`](../packages/hooks/hooks-claude), [`hooks-codex`](../packages/hooks/hooks-codex), [`repeat-tool-guard`](../packages/guard/repeat-tool-guard) \|
			\| `agent/queued` \| `emit` \| [`packages/core/agent/src/types.ts:181`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`emit`) \| [`goal-session`](../packages/goal/goal-session) \|
Merge remote-tracking branch 'origin/master' into worktree/tui-session-controls 2026-07-21 10:15:49 +08:00			\| `agent/request` \| `waterfall` \| [`packages/core/agent/src/types.ts:242`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`waterfall`) \| [`agent`](../packages/core/agent) \|
Merge branch 'codex/goal-tools' into codex/goal-session 2026-07-20 22:57:14 +08:00			\| `agent/request-error` \| `waterfall` \| [`packages/core/agent/src/types.ts:295`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`waterfall`) \| [`compact-basic`](../packages/compact/compact-basic), [`llm-retry`](../packages/llm/llm-retry) \|
Merge branch 'codex/goal-tools' into codex/goal-session 2026-07-20 20:35:15 +08:00			\| `agent/session-prefix` \| `waterfall` \| [`packages/core/agent/src/types.ts:257`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`waterfall`) \| [`tool-skill`](../packages/skill/tool-skill), [`workspace-context`](../packages/context/workspace-context) \|
Merge branch 'codex/goal-tools' into codex/goal-session 2026-07-20 21:55:13 +08:00			\| `agent/session-start` \| `emit` \| [`packages/core/agent/src/types.ts:204`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`emit`) \| [`goal`](../packages/goal/goal), [`goal-session`](../packages/goal/goal-session), [`hooks-claude`](../packages/hooks/hooks-claude), [`hooks-codex`](../packages/hooks/hooks-codex) \|
Merge origin/master into codex/invariant-service-seam 2026-07-21 01:13:28 +08:00			\| `agent/status` \| `emit` \| [`packages/core/agent/src/types.ts:171`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`emit`) \| [`agent`](../packages/core/agent), [`goal-session`](../packages/goal/goal-session), [`tui`](../packages/ui/tui) \|
Merge branch 'codex/goal-tools' into codex/goal-session 2026-07-20 20:35:15 +08:00			\| `agent/step-result` \| `waterfall` \| [`packages/core/agent/src/types.ts:268`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`waterfall`) \| - \|
Merge branch 'codex/goal-tools' into codex/goal-session 2026-07-20 22:57:14 +08:00			\| `agent/turn-continuation` \| `waterfall` \| [`packages/core/agent/src/types.ts:305`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`waterfall`) \| [`hooks-claude`](../packages/hooks/hooks-claude), [`hooks-codex`](../packages/hooks/hooks-codex) \|
			\| `agent/turn-stop` \| `serial` \| [`packages/core/agent/src/types.ts:315`](../packages/core/agent/src/types.ts) \| [`agent-loop`](../packages/core/agent-loop) (`serial`) \| [`subagent-inprocess`](../packages/subagent/subagent-inprocess), [`tool-goal`](../packages/goal/tool-goal) \|
docs: tighten prose audit after master retarget 2026-07-13 16:24:32 +08:00			\| `approval/request` \| `waterfall` \| [`packages/ui/user-approval/src/index.ts:31`](../packages/ui/user-approval/src/index.ts) \| [`user-approval`](../packages/ui/user-approval) (`waterfall`) \| [`acp`](../packages/ui/acp) \|
fix(commands): remove adapter surface filtering 2026-07-20 17:41:22 +08:00			\| `commands/change` \| `emit` \| [`packages/ui/commands/src/index.ts:83`](../packages/ui/commands/src/index.ts) \| [`commands`](../packages/ui/commands) (`events.dispatch`) \| [`acp`](../packages/ui/acp), [`tui`](../packages/ui/tui) \|
Merge remote-tracking branch 'origin/master' into cross-family-fs-sandbox 2026-07-20 11:40:29 +08:00			\| `fs/edit-intent` \| `waterfall` \| [`packages/fs/fs/src/index.ts:62`](../packages/fs/fs/src/index.ts) \| [`tool-fs`](../packages/fs/tool-fs) (`waterfall`) \| [`fs-policy`](../packages/fs/fs-policy) \|
			\| `fs/observed` \| `emit` \| [`packages/fs/fs/src/index.ts:71`](../packages/fs/fs/src/index.ts) \| [`tool-fs`](../packages/fs/tool-fs) (`emit`) \| [`fs-policy`](../packages/fs/fs-policy) \|
			\| `fs/write-intent` \| `waterfall` \| [`packages/fs/fs/src/index.ts:54`](../packages/fs/fs/src/index.ts) \| [`tool-fs`](../packages/fs/tool-fs) (`waterfall`) \| [`fs-policy`](../packages/fs/fs-policy) \|
Merge goal tool fixes and align same-session blockers 2026-07-20 17:23:55 +08:00			\| `goal/changed` \| `emit` \| [`packages/goal/goal/src/types.ts:167`](../packages/goal/goal/src/types.ts) \| [`goal`](../packages/goal/goal) (`emit`) \| [`goal-session`](../packages/goal/goal-session) \|
Merge branch 'master' into worktree/routed-model-compaction-policy 2026-07-21 19:23:54 +08:00			\| `llm/stream` \| `waterfall` \| [`packages/llm/llm/src/index.ts:52`](../packages/llm/llm/src/index.ts) \| [`llm`](../packages/llm/llm) (`waterfall`) \| [`agent-loop`](../packages/core/agent-loop), [`llm`](../packages/llm/llm), [`llm-replay`](../packages/support/llm-replay) \|
Merge origin/master into codex/invariant-service-seam 2026-07-21 00:44:39 +08:00			\| `session/created` \| `emit` \| [`packages/core/session/src/index.ts:47`](../packages/core/session/src/index.ts) \| [`session`](../packages/core/session) (`events.dispatch`) \| [`compact`](../packages/compact/compact), [`goal`](../packages/goal/goal), [`hook-protocol`](../packages/hooks/hook-protocol), [`jsonrpc`](../packages/ui/jsonrpc), [`llm-retry`](../packages/llm/llm-retry), [`session`](../packages/core/session), [`session-persistence`](../packages/session-persistence/session-persistence), [`user-approval`](../packages/ui/user-approval) \|
refactor(session): use one surface manager 2026-07-19 11:36:07 +08:00			\| `session/disposed` \| `emit` \| [`packages/core/session/src/index.ts:57`](../packages/core/session/src/index.ts) \| [`session`](../packages/core/session) (`events.dispatch`) \| [`agent-loop`](../packages/core/agent-loop), [`session-persistence`](../packages/session-persistence/session-persistence) \|
Merge origin/master into codex/invariant-service-seam 2026-07-21 01:13:28 +08:00			\| `session/event` \| `emit` \| [`packages/core/session/src/index.ts:69`](../packages/core/session/src/index.ts) \| [`session`](../packages/core/session) (`events.dispatch`) \| [`acp`](../packages/ui/acp), [`cli-demo`](../packages/examples/cli-demo), [`compact`](../packages/compact/compact), [`goal`](../packages/goal/goal), [`goal-session`](../packages/goal/goal-session), [`hook-protocol`](../packages/hooks/hook-protocol), [`jsonrpc`](../packages/ui/jsonrpc), [`session`](../packages/core/session), [`session-persistence`](../packages/session-persistence/session-persistence), [`token-meter`](../packages/llm/token-meter), [`tui`](../packages/ui/tui), [`user-approval`](../packages/ui/user-approval), [`workspace-context`](../packages/context/workspace-context) \|
refactor(session): use one surface manager 2026-07-19 11:36:07 +08:00			\| `session/flush` \| `parallel` \| [`packages/core/session/src/index.ts:79`](../packages/core/session/src/index.ts) \| [`session`](../packages/core/session) (`events.dispatch`) \| [`session-persistence`](../packages/session-persistence/session-persistence) \|
Merge latest invariant registration gate 2026-07-20 20:20:10 +08:00			\| `subagent/end` \| `emit` \| [`packages/subagent/subagent/src/index.ts:139`](../packages/subagent/subagent/src/index.ts) \| [`subagent`](../packages/subagent/subagent) (`events.dispatch`) \| [`hooks-claude`](../packages/hooks/hooks-claude), [`jsonrpc`](../packages/ui/jsonrpc), [`subagent`](../packages/subagent/subagent) \|
			\| `subagent/provider-added` \| `emit` \| [`packages/subagent/subagent/src/index.ts:113`](../packages/subagent/subagent/src/index.ts) \| [`subagent`](../packages/subagent/subagent) (`emit`) \| [`subagent`](../packages/subagent/subagent), [`tool-subagent`](../packages/subagent/tool-subagent) \|
			\| `subagent/provider-removed` \| `emit` \| [`packages/subagent/subagent/src/index.ts:119`](../packages/subagent/subagent/src/index.ts) \| [`subagent`](../packages/subagent/subagent) (`events.dispatch`) \| [`subagent`](../packages/subagent/subagent), [`tool-subagent`](../packages/subagent/tool-subagent) \|
			\| `subagent/start` \| `emit` \| [`packages/subagent/subagent/src/index.ts:130`](../packages/subagent/subagent/src/index.ts) \| [`subagent`](../packages/subagent/subagent) (`events.dispatch`) \| [`hooks-claude`](../packages/hooks/hooks-claude), [`subagent`](../packages/subagent/subagent) \|
Merge current master into invariant service seam 2026-07-21 18:35:24 +08:00			\| `system-prompt/assemble` \| `waterfall` \| [`packages/core/system-prompt/src/index.ts:27`](../packages/core/system-prompt/src/index.ts) \| [`system-prompt`](../packages/core/system-prompt) (`waterfall`) \| [`agent`](../packages/core/agent), [`system-prompt`](../packages/core/system-prompt) \|
docs: tighten prose audit after master retarget 2026-07-13 16:24:32 +08:00			\| `system-prompt/change` \| `emit` \| [`packages/core/system-prompt/src/index.ts:33`](../packages/core/system-prompt/src/index.ts) \| [`system-prompt`](../packages/core/system-prompt) (`emit`) \| - \|
feat: return typed values from Code Mode 2026-07-21 04:34:14 +08:00			\| `tools/change` \| `emit` \| [`packages/core/tools/src/index.ts:136`](../packages/core/tools/src/index.ts) \| [`tools`](../packages/core/tools) (`emit`) \| - \|
			\| `tools/execute` \| `waterfall` \| [`packages/core/tools/src/index.ts:109`](../packages/core/tools/src/index.ts) \| [`tools`](../packages/core/tools) (`waterfall`) \| [`timeout-policy`](../packages/timeout/timeout-policy) \|
			\| `tools/post-execute` \| `waterfall` \| [`packages/core/tools/src/index.ts:118`](../packages/core/tools/src/index.ts) \| [`tools`](../packages/core/tools) (`waterfall`) \| [`hooks-claude`](../packages/hooks/hooks-claude), [`hooks-codex`](../packages/hooks/hooks-codex), [`repeat-tool-guard`](../packages/guard/repeat-tool-guard), [`spill-policy`](../packages/spill/spill-policy), [`tool-fs-search`](../packages/fs/tool-fs-search), [`workspace-context`](../packages/context/workspace-context) \|
			\| `tools/pre-execute` \| `waterfall` \| [`packages/core/tools/src/index.ts:100`](../packages/core/tools/src/index.ts) \| [`tools`](../packages/core/tools) (`waterfall`) \| [`hooks-claude`](../packages/hooks/hooks-claude), [`hooks-codex`](../packages/hooks/hooks-codex) \|
			\| `tools/result` \| `emit` \| [`packages/core/tools/src/index.ts:126`](../packages/core/tools/src/index.ts) \| [`tools`](../packages/core/tools) (`events.dispatch`) \| [`subagent-inprocess`](../packages/subagent/subagent-inprocess), [`workspace-context`](../packages/context/workspace-context) \|
Merge branch 'codex/invariant-package-registration-gate' into codex/package-invariant-checks 2026-07-20 19:55:46 +08:00			\| `workflow/agent-end` \| `emit` \| [`packages/workflow/workflow/src/index.ts:81`](../packages/workflow/workflow/src/index.ts) \| [`workflow`](../packages/workflow/workflow) (`events.dispatch`) \| [`workflow`](../packages/workflow/workflow) \|
			\| `workflow/agent-start` \| `emit` \| [`packages/workflow/workflow/src/index.ts:70`](../packages/workflow/workflow/src/index.ts) \| [`workflow`](../packages/workflow/workflow) (`events.dispatch`) \| [`workflow`](../packages/workflow/workflow) \|
			\| `workflow/end` \| `emit` \| [`packages/workflow/workflow/src/index.ts:91`](../packages/workflow/workflow/src/index.ts) \| [`workflow`](../packages/workflow/workflow) (`events.dispatch`) \| [`workflow`](../packages/workflow/workflow) \|
docs: tighten prose audit after master retarget 2026-07-13 16:24:32 +08:00			\| `workflow/log` \| `emit` \| [`packages/workflow/workflow/src/index.ts:60`](../packages/workflow/workflow/src/index.ts) \| [`workflow`](../packages/workflow/workflow) (`events.dispatch`) \| - \|
			\| `workflow/phase` \| `emit` \| [`packages/workflow/workflow/src/index.ts:53`](../packages/workflow/workflow/src/index.ts) \| [`workflow`](../packages/workflow/workflow) (`events.dispatch`) \| - \|
Merge branch 'codex/invariant-package-registration-gate' into codex/package-invariant-checks 2026-07-20 19:55:46 +08:00			\| `workflow/start` \| `emit` \| [`packages/workflow/workflow/src/index.ts:45`](../packages/workflow/workflow/src/index.ts) \| [`workflow`](../packages/workflow/workflow) (`events.dispatch`) \| [`workflow`](../packages/workflow/workflow) \|
docs: address graph review placement 2026-07-05 02:54:01 +08:00
docs: regenerate catalogs and sync subagent type-equiv blocks for persona/toolFilter 2026-07-09 02:18:39 +08:00			`## Non-harness or undeclared event strings seen in package source`

			`\| Event string \| Dispatchers \| Listeners \|`
			`\| --- \| --- \| --- \|`
Merge origin/master into codex/invariant-service-seam 2026-07-21 01:13:28 +08:00			\| `internal/dispatch` \| - \| [`compact`](../packages/compact/compact), [`fs`](../packages/fs/fs), [`goal`](../packages/goal/goal), [`goal-session`](../packages/goal/goal-session), [`hook-protocol`](../packages/hooks/hook-protocol), [`llm-retry`](../packages/llm/llm-retry), [`permission`](../packages/ui/permission), [`sandbox-policy`](../packages/sandbox/sandbox-policy), [`scope`](../packages/core/scope), [`session`](../packages/core/session), [`subagent`](../packages/subagent/subagent), [`time-context`](../packages/context/time-context), [`tool-todo`](../packages/todo/tool-todo), [`tools`](../packages/core/tools), [`user-approval`](../packages/ui/user-approval), [`workflow`](../packages/workflow/workflow) \|
fix(core): make initiator teardown reentrant-safe 2026-07-19 15:12:18 +08:00			\| `internal/status` \| - \| [`agent`](../packages/core/agent) \|
docs: regenerate catalogs and sync subagent type-equiv blocks for persona/toolFilter 2026-07-09 02:18:39 +08:00
refactor: derive event graphs and scope invariants from TypeScript 2026-07-14 23:14:51 +08:00			`Maintenance mode: generated: Cordis event declarations and producer/listener edges are resolved from the repository TypeScript Program.`