mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
fb9636db44
Implements the RFC 010 MVP: a new `@deepseek-ai/dsh-acp` package bridges the harness agent to the Agent Client Protocol (JSON-RPC 2.0 over newline-delimited stdio), so Zed and other ACP editors can drive the coding agent — streaming render, tool-call display, and resumable sessions via `session/load`. - packages/acp: AgentSideConnection wiring; initialize/newSession/loadSession/ prompt/cancel; a total TurnEndReason→StopReason codec; settle-once with a fallback chain (agent/turn-end → logged turn/end → idle); single-session guard; cwd-must-equal-launch-dir validation; load replays from the persisted event log (assistant/chunk→agent_message_chunk, tool/call/result→tool_call*). - agent: add Agent.whenIdle() quiescence signal to the interface; LoopAgent implements it (resolves on the first running→idle/disposed transition). The bridge awaits it on disposal so teardown reaches quiescence, not just abort. - examples: extract the shared provider/tool core into examples/base.yml; coding-agent nest-includes it; new examples/acp-agent serves the agent over ACP with JSONL persistence and no stdout logger (stdout is the protocol). - Permission gate deferred (TODO(rfc010-permission-gate)): tools run with the executor's full authority; only the Agent→sessionId ownership seam is laid down. Cancel is best-effort for a not-yet-started queued turn (TODO(rfc010-cancel-prestep)). RFC 010 stays `proposed`. - Docs: package README + Zed snippet; client-driver cookbook section; root and packages layout/commands; RFC 010 implementation-status note. 48 bridge tests + whenIdle coverage; 100% per-file coverage; e2e boots the example as a subprocess and verifies a written file on disk (key-gated, with a no-key stdout-purity check).
50 lines
1.9 KiB
YAML
50 lines
1.9 KiB
YAML
# The acp-agent plugin tree, loaded via @cordisjs/plugin-include.
|
|
#
|
|
# CRITICAL: this example loads NO stdout logger (no @cordisjs/plugin-logger-
|
|
# console, no stdio-chat). stdout is reserved for the ACP JSON-RPC protocol —
|
|
# anything else written there corrupts the frames (see packages/acp, RFC 010 §
|
|
# Risks). Use a stderr exporter if you need logging. The timer plugin is loaded
|
|
# (no stdout writes); hmr is omitted (an editor manages the subprocess).
|
|
#
|
|
# Requires DEEPSEEK_API_KEY (and optionally DEEPSEEK_BASE_URL) in the
|
|
# environment — start.ts loads the gitignored repo-root .env first.
|
|
|
|
- id: timer
|
|
name: '@cordisjs/plugin-timer'
|
|
|
|
# Shared provider/tool core (llm, sessions, system-prompt, tools, agents,
|
|
# invariants, llm-deepseek, bash-local, tool-bash). Nested include resolved
|
|
# relative to THIS file's directory.
|
|
- id: base
|
|
name: '@cordisjs/plugin-include'
|
|
config:
|
|
path: '../base.yml'
|
|
|
|
# agent-loop with NO pre-created agents: ACP `session/new` creates them on
|
|
# demand (unlike coding-agent, which pre-creates `main`).
|
|
- id: agent-loop
|
|
name: '@deepseek-ai/dsh-agent-loop'
|
|
config:
|
|
agents: []
|
|
|
|
# Durable session persistence — required by the ACP bridge for `session/load`.
|
|
- id: session-persistence
|
|
name: '@deepseek-ai/dsh-session-persistence-jsonl'
|
|
config:
|
|
root: './.sessions'
|
|
|
|
# The ACP bridge: wires AgentSideConnection to stdin/stdout.
|
|
- id: acp
|
|
name: '@deepseek-ai/dsh-acp'
|
|
config:
|
|
model: deepseek-v4-flash
|
|
systemPrompt: |
|
|
You are a coding assistant driven over the Agent Client Protocol.
|
|
|
|
Your only tools are bash (plus bash_output/bash_kill for background
|
|
tasks). Do ALL file operations through bash: read with cat/sed/head,
|
|
search with grep, write with heredocs (cat <<'EOF' > file), edit with
|
|
sed or a rewrite. Each bash call runs in a fresh shell — pass workdir
|
|
instead of cd. Check the [exit code: N] marker; verify your work. Keep
|
|
answers brief and factual.
|