Files

T

Dudu-0223 463b72ce96 feat(spill): add tool-output spill seam, local backend, and policy

Oversized plain-text tool results now spill to a session-scoped file and
return a bounded preview plus the spill path, so a verbose result stays
readable via `read` without consuming the next model request in full.

- dsh-spill: minimal SpillFiles seam (saveText → session-scoped SpillPath)
- dsh-spill-local: private 0700 session dirs, traversal-safe names, exclusive
  owner-only writes
- dsh-spill-policy: tools/post-execute transformer; no-op unless maxInlineBytes
  is set; skips read; best-effort on save failure (never turns a success into
  an isError)

web_fetch is the showcase — no tool-specific spill code. The coding-agent
example loads the stack so its keyless Loader smoke guards the namespace-plugin
export shape. Snapshot gap for a transcript-visible web_fetch spill is recorded
in the RFC's Consequences (ACP replay is keyless and cannot hit the web).

2026-07-08 20:41:55 +08:00

6.9 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. 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. Dynamic dispatch overrides cover sites that deliberately bypass ctx.emit, such as subagent lifecycle containment.

Event	Mode	Declared in	Dispatchers	Listeners
`agent/created`	`emit`	`packages/core/agent/src/types.ts:248`	`agent` (`emit`)	`stdio-agent`
`agent/disposed`	`emit`	`packages/core/agent/src/types.ts:255`	`agent` (`emit`)	`stdio-agent`
`agent/error`	`emit`	`packages/core/agent/src/types.ts:394`	`agent-loop` (`emit`)	-
`agent/pre-step`	`serial`	`packages/core/agent/src/types.ts:333`	`agent-loop` (`serial`)	`compact-basic`
`agent/prompt-submit`	`waterfall`	`packages/core/agent/src/types.ts:346`	`agent-loop` (`waterfall`)	`hooks-claude`, `hooks-codex`
`agent/queued`	`emit`	`packages/core/agent/src/types.ts:273`	`agent-loop` (`emit`)	-
`agent/request`	`waterfall`	`packages/core/agent/src/types.ts:359`	`agent-loop` (`waterfall`), `compact-basic` (`waterfall`)	-
`agent/session-start`	`emit`	`packages/core/agent/src/types.ts:288`	`agent-loop` (`emit`)	`hooks-claude`, `hooks-codex`
`agent/status`	`emit`	`packages/core/agent/src/types.ts:264`	`agent-loop` (`emit`)	`acp`, `invariants`, `stdio-agent`
`agent/step-result`	`waterfall`	`packages/core/agent/src/types.ts:369`	`agent-loop` (`waterfall`)	-
`agent/turn-continuation`	`waterfall`	`packages/core/agent/src/types.ts:382`	`agent-loop` (`waterfall`)	`hooks-claude`, `hooks-codex`
`fs/edit-intent`	`waterfall`	`packages/fs/fs/src/index.ts:123`	`tool-fs` (`waterfall`)	`fs-policy`
`fs/observed`	`emit`	`packages/fs/fs/src/index.ts:138`	`tool-fs` (`emit`)	`fs-policy`
`fs/write-intent`	`waterfall`	`packages/fs/fs/src/index.ts:109`	`tool-fs` (`waterfall`)	`fs-policy`
`llm/stream`	`waterfall`	`packages/llm/llm/src/index.ts:33`	`llm` (`waterfall`)	`llm-replay`
`session/created`	`emit`	`packages/core/session/src/index.ts:36`	`session` (`emit`)	`invariants`, `session-persistence`
`session/event`	`emit`	`packages/core/session/src/index.ts:44`	`session` (`emit`)	`acp`, `invariants`, `session-persistence`, `stdio-agent`
`session/flush`	`parallel`	`packages/core/session/src/index.ts:54`	`agent-loop` (`parallel`)	`session-persistence`
`subagent/end`	`emit`	`packages/subagent/subagent/src/index.ts:98`	`subagent` (`events.dispatch`)	`hooks-claude`
`subagent/provider-added`	`emit`	`packages/subagent/subagent/src/index.ts:72`	`subagent` (`emit`)	`tool-subagent`
`subagent/provider-removed`	`emit`	`packages/subagent/subagent/src/index.ts:83`	-	`tool-subagent`
`subagent/start`	`emit`	`packages/subagent/subagent/src/index.ts:91`	`subagent` (`events.dispatch`)	`hooks-claude`
`system-prompt/assemble`	`waterfall`	`packages/core/system-prompt/src/index.ts:38`	`system-prompt` (`waterfall`)	-
`system-prompt/change`	`emit`	`packages/core/system-prompt/src/index.ts:44`	`system-prompt` (`emit`)	-
`tools/change`	`emit`	`packages/core/tools/src/index.ts:87`	`tools` (`emit`)	-
`tools/post-execute`	`waterfall`	`packages/core/tools/src/index.ts:82`	`tools` (`waterfall`)	`hooks-claude`, `hooks-codex`, `spill-policy`
`tools/pre-execute`	`waterfall`	`packages/core/tools/src/index.ts:66`	`tools` (`waterfall`)	`hooks-claude`, `hooks-codex`

Maintenance mode: hybrid generated: Cordis event declarations and most producer/listener edges are AST-scanned; dynamic dispatch sites are classified in scripts/gen-doc-graphs.ts.

6.9 KiB Raw Blame History

Event Producer And Consumer Matrix

6.9 KiB

Raw Blame History