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

Files

Dudu-0223 50f0d3a299 Merge remote-tracking branch 'origin/master' into parallel-tool-call

# Conflicts:
#	docs/architecture.md
#	docs/config-catalog.md
#	docs/cordis-catalog/services.md
#	docs/rfc/INDEX.md
#	packages/cordis/tool-cordis/src/api-catalog.ts
#	packages/core/agent-loop/README.md
#	packages/core/agent-loop/src/index.ts
#	packages/core/agent-loop/src/loop.ts
#	packages/core/tools/README.md
#	packages/core/tools/src/index.ts
#	packages/subagent/subagent/src/types.ts
#	packages/subagent/tool-subagent/README.md
#	scripts/gen-cordis-catalog.ts
#	scripts/type-equiv.manifest.json

2026-07-13 14:28:32 +08:00

2.5 KiB

Raw Blame History

Agent Turn And Step Lifecycle

This sequence is the visual companion to architecture.md. It keeps durable replay facts on session/event and live control/status on agent/*.

sequenceDiagram
  participant User
  participant Agent
  participant Driver
  participant Hooks as hook listeners
  participant Prompt as ctx.systemPrompt
  participant LLM as ctx.llm
  participant Tools as ctx.tools
  participant Session
  participant Persistence
  participant SDK as UI or SDK listener
  User->>Agent: send(content)
  Agent-->>SDK: <code>agent/queued</code>
  Agent->>Driver: queued work wakes driver
  Driver-->>SDK: <code>agent/status</code> running
  Driver->>Session: <code>turn/start</code>
  Driver->>Hooks: <code>agent/prompt-submit</code> waterfall
  Hooks-->>Driver: allow, block, or add context
  Driver->>Session: <code>user/message</code> or rejected <code>turn/end</code>
  Driver->>Prompt: <code>system-prompt/assemble</code> waterfall
  Driver-->>Driver: <code>agent/pre-step</code> serial checkpoint
  Driver->>Session: <code>step/start</code>
  Driver->>LLM: <code>agent/request</code> waterfall, then <code>llm/stream</code> waterfall
  LLM-->>Driver: StreamChunk*
  Driver->>Session: <code>assistant/chunk</code>*
  Session-->>SDK: <code>session/event</code> <code>assistant/chunk</code>*
  Driver->>Hooks: <code>agent/step-result</code> waterfall
  Driver->>Session: <code>assistant/message</code>
  Driver->>Tools: group calls by executionMode
  loop started tool calls (bounded pool)
    Driver->>Session: <code>tool/call</code> pending audit
    Driver->>Tools: ordered pre / pooled dispatch / ordered post
    Tools-->>Session: tool-owned events when applicable
  end
  Driver->>Session: <code>tool/result</code> in model order
  Driver->>Session: <code>step/end</code>
  Driver->>Hooks: <code>agent/turn-continuation</code> waterfall
  Driver->>Hooks: <code>agent/turn-stop</code> serial terminal checkpoint
  Driver->>Session: <code>turn/end</code>
  Driver->>Persistence: <code>session/flush</code> parallel checkpoint
  Driver-->>SDK: <code>agent/status</code> idle

SDK users that need replayable transcript data should consume session/event; agent/* is the live coordination surface for queue/status, prompt interception, request shaping, steering, continuation, and errors.

Maintenance mode: curated Mermaid sequence; exact event signatures live in the generated Cordis catalog.

2.5 KiB Raw Blame History

Agent Turn And Step Lifecycle

2.5 KiB

Raw Blame History