mirror of https://github.com/deepseek-ai/deepseek-harness synced 2026-08-15 21:04:50 +00:00

Files

Tianyi Cui 8819c71b81 docs: teach the graph generator the CHAINED fused-dispatch spelling

ds-review-bot round-3 finding: agentEvents(ctx, agent).emit(...) has a
call-expression receiver the generator's identifier check missed, silently
dropping agent-loop as agent/session-start's producer. The generator now
recognizes a call receiver whose callee is agentEvents; graph regenerated
with the producer edge restored.

2026-07-09 06:06:17 +08:00

7.0 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:286`	`agent` (`emit`)	`stdio-agent`
`agent/disposed`	`emit`	`packages/core/agent/src/types.ts:298`	`agent` (`emit`)	`stdio-agent`
`agent/error`	`emit`	`packages/core/agent/src/types.ts:492`	`agent-loop` (`emit`)	-
`agent/pre-step`	`serial`	`packages/core/agent/src/types.ts:396`	`agent-loop` (`serial`)	`compact-basic`
`agent/prompt-submit`	`waterfall`	`packages/core/agent/src/types.ts:414`	`agent-loop` (`waterfall`)	`hooks-claude`, `hooks-codex`
`agent/queued`	`emit`	`packages/core/agent/src/types.ts:326`	`agent-loop` (`emit`)	-
`agent/request`	`waterfall`	`packages/core/agent/src/types.ts:442`	`agent-loop` (`waterfall`)	-
`agent/session-start`	`emit`	`packages/core/agent/src/types.ts:346`	`agent-loop` (`emit`)	`hooks-claude`, `hooks-codex`, `invariants`
`agent/status`	`emit`	`packages/core/agent/src/types.ts:312`	`agent-loop` (`emit`)	`acp`, `invariants`, `stdio-agent`
`agent/step-result`	`waterfall`	`packages/core/agent/src/types.ts:457`	`agent-loop` (`waterfall`)	-
`agent/turn-continuation`	`waterfall`	`packages/core/agent/src/types.ts:475`	`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:39`	`llm` (`waterfall`)	`invariants`, `llm-replay`
`session/created`	`emit`	`packages/core/session/src/index.ts:47`	`session` (`emit`)	`invariants`, `session-persistence`
`session/event`	`emit`	`packages/core/session/src/index.ts:61`	`session` (`emit`)	`acp`, `invariants`, `session-persistence`, `stdio-agent`
`session/flush`	`parallel`	`packages/core/session/src/index.ts:79`	`session` (`parallel`)	`session-persistence`
`subagent/end`	`emit`	`packages/subagent/subagent/src/index.ts:107`	`subagent` (`events.dispatch`)	`hooks-claude`
`subagent/provider-added`	`emit`	`packages/subagent/subagent/src/index.ts:73`	`subagent` (`emit`)	`tool-subagent`
`subagent/provider-removed`	`emit`	`packages/subagent/subagent/src/index.ts:84`	-	`tool-subagent`
`subagent/start`	`emit`	`packages/subagent/subagent/src/index.ts:96`	`subagent` (`events.dispatch`)	`hooks-claude`
`system-prompt/assemble`	`waterfall`	`packages/core/system-prompt/src/index.ts:44`	`system-prompt` (`waterfall`)	-
`system-prompt/change`	`emit`	`packages/core/system-prompt/src/index.ts:54`	`system-prompt` (`emit`)	-
`tools/change`	`emit`	`packages/core/tools/src/index.ts:112`	`tools` (`emit`)	-
`tools/post-execute`	`waterfall`	`packages/core/tools/src/index.ts:102`	`tools` (`waterfall`)	`hooks-claude`, `hooks-codex`
`tools/pre-execute`	`waterfall`	`packages/core/tools/src/index.ts:82`	`tools` (`waterfall`)	`hooks-claude`, `hooks-codex`

Non-harness or undeclared event strings seen in package source

Event string	Dispatchers	Listeners
`internal/dispatch`	-	`invariants`

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.

7.0 KiB Raw Blame History

Event Producer And Consumer Matrix

Non-harness or undeclared event strings seen in package source

7.0 KiB

Raw Blame History