Skip to main content

dsh-acp-demo/packages/examples/acp-demoOfficial

175.3kStars19.0kForks0Issues752Watchers

ACP automation server app: agent spine + JSONL persistence + ACP transport, with a JSON-RPC stdio bin

Evidence3/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki

ⓘ This plugin is a sub-package of the deepseek-ai/deepseek-harness monorepo — stars and activity count the whole repository.

Language
TypeScript
License
MIT
Branch
master
ai-agentscordisdshdsh-plugin

Install

cmdweb profile
$ dsh plugin --profile web add npm:@deepseek-ai/dsh-acp-demo

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin deepseek-ai/deepseek-harness/packages/examples/acp-demo for me: review the repository at https://github.com/deepseek-ai/deepseek-harness first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

English | 中文

ACP automation server app: the default agent spine, client-created agents through @deepseek-ai/dsh-acp, JSONL persistence, and semantic checkpointing behind one JSON-RPC stdio bin. Programmatic clients create fresh sessions; this package mounts no human UI.

Composition

PluginRole
@deepseek-ai/dsh-agent-spine-demoProviderless agent spine with no pre-created agents; session/new creates each agent.
@deepseek-ai/dsh-session-persistence-jsonlDurable session logs used by checkpointing, observability, and snapshot replay.
@deepseek-ai/dsh-session-checkpoint-policyDurability barriers before model calls and top-level tool effects, plus completed-step checkpoints.
@deepseek-ai/dsh-session-query-sqliteDerived exact/FTS session-query service, opened before the ACP transport so leaf consumers are ready for the first model request.
@deepseek-ai/dsh-acpAutomation-only ACP transport over stdin/stdout.

The app does not install commands, user interaction, session navigation, configuration pickers, or a stdout logger. It owns these plugins through one ordered effect so the query service is ready before ACP accepts work and ACP sessions quiesce before checkpointing and persistence detach. Leaf configurations supply LLM, executor, sandbox, approval, filesystem, and model-facing tool plugins.

Config

KeyDefaultRouted to
providerrequiredProvider route for each ACP-created agent.
modelrequiredModel for each ACP-created agent.
maxParallelToolCallsagent-loop defaultPositive-integer tool-call concurrency cap; 1 is serial.
persona—Deployment persona template for dsh-system-prompt.
toolOrderlexicographicExplicit model-facing tool order for dsh-system-prompt.
tools{ mode: 'native' }Native, Code Mode, or combined model tool transport.
dshHome$DSH_HOME or ~/.dshHarness home shared by bash and local skill discovery.
sessionTitlespine example limitsDurable fallback-title limits; titles remain off the ACP wire.
persistenceRoot./.sessionsJSONL backend root and parent directory of the derived session-query.db index.
packChunkstruePack consecutive delta-chunk events in storage.
persistenceCompressionzstdChecksummed Zstandard frames or raw none.
workspaceContextrequiredWorkspace-instruction byte budget/config, or false.
skillsowner defaultsSkill registry, local provider, and model-facing skill tool.
toolBashowner defaultsModel-facing bash tool config.
jobs{ maxConcurrentJobsPerOwner: 10 }Process-local per-owner active-task admission.
toolJobsowner defaultsGeneric background-job control config, or false.
goalsowner defaultsPersisted same-session goal domain and model tools, or false.

The shipped examples/acp-agent/cordis.yml adds the DeepSeek adapter, sandboxed bash and filesystem providers, one-shot approval policy, compaction, subagents, workflows, hooks, and model-facing tools. The app supplies the derived session-query index, while the model-facing query consumer remains an explicit leaf opt-in. Snapshot overlays replace only nondeterministic providers or policy values.

Bin

dsh-acp-demo [--config path-to-cordis.yml] (short form -c; default ./cordis.yml) loads the gitignored .env, except in replay mode; DSH_SNAPSHOT=replay selects the sibling cordis.snapshot.yml; stdin EOF disposes the context and flushes sessions before exit. Loader's installed optional node-addon-require-builtin peer resolves bare plugin specifiers for the built bin under plain Node. Diagnostics use stderr because stdout is the ACP wire.

Model Experience

Indirectly, through dsh-agent-spine-demo and the leaf's model-facing plugins. ACP prompt text becomes the ordinary logged user message; protocol metadata and permission choices do not enter the model request.

KV Cache effect

Append-only per session; the app adds no request-prefix content itself.

Known Limitations and Deferred Work

  • JSONL persistence is fixed — a different backend requires another composition.
  • Sibling plugins can corrupt stdout — the app cannot prevent another entry from writing non-protocol bytes.
  • Fresh automation sessions only — resume and human interaction belong to other entry points.

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/deepseek-ai/deepseek-harness/packages/examples/acp-demo)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory