FFFF GitHub - OffloopHQ/dsh-acp: Client-neutral ACP adapter for DeepSeek Harness · GitHub
[go: up one dir, main page]

Skip to content
OffloopHQPublic

About

Client-neutral ACP adapter for DeepSeek Harness

Topics

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

dsh-acp

dsh-acp is an independent, client-neutral Agent Client Protocol (ACP) adapter for a user-installed DeepSeek Harness (DSH).

Any ACP client that supports the negotiated protocol version and advertised capabilities can connect over stdio.

What it does

  • Discovers an existing DSH source installation without installing, updating, or modifying it.
  • Rejects unknown DSH versions, unknown layouts, basename collisions, and runtime drift.
  • Loads the selected, versioned DSH driver only after discovery and fingerprint validation.
  • Translates DSH sessions, streaming events, cancellation, steering, and permissions to ACP.
  • Advertises only capabilities implemented by the selected driver.

The current driver supports the DSH 0.0.1 source layout. See compatibility for the exact surface and limitations.

Its current session surface is new, load, resume, fork, workspace-scoped list, and close. It also supports text/resource-link prompts, steering, one-shot permission requests, and stdio/Streamable HTTP MCP servers. Features without a safe DSH 0.0.1 seam—including delete, auth/provider management, images, embedded context, elicitation, and SSE MCP—remain unadvertised. DSH's credential-backed built-in web search/fetch surface and repository plugin loader are disabled; an ACP-explicit MCP server remains a separate, client-configured tool boundary.

Commands

dsh-acp [serve] [--dsh-path <path>] [--dsh-home <path>]
dsh-acp inspect --json [--dsh-path <path>] [--dsh-home <path>]
dsh-acp doctor --json [--dsh-path <path>] [--dsh-home <path>]
dsh-acp --version

serve is the default. Its stdout is reserved exclusively for newline-delimited ACP JSON-RPC frames. Diagnostics go to stderr and are bounded and credential-redacted.

inspect --json performs read-only discovery and prints one JSON result. doctor --json additionally checks that the discovered installation remains unchanged. Neither command proves a live ACP connection; the ACP client's bounded initialize handshake is the final readiness check.

The successful initialize response includes the exact inspected DSH compatibility-seam fingerprint in _meta.runtimeFingerprint. A host that persists runtime identity can bind that value to its Endpoint generation and reject drift before admitting a later prompt.

For a runtime fingerprint fence:

dsh-acp serve \
  --dsh-path /absolute/path/to/dsh \
  --node /absolute/path/to/node \
  --expected-runtime-fingerprint sha256:...

Legacy --candidate and --dsh-root spellings are accepted as aliases for --dsh-path. They still go through full discovery and cannot bind an unchecked checkout.

See the complete CLI contract.

Installation

Install from a GitHub Release: download dsh-acp-<version>-node.tar.gz and SHA256SUMS, verify the checksum, and put the archive's dsh-acp executable on your PATH:

gh release download v0.1.2 --repo OffloopHQ/dsh-acp \
  --pattern 'dsh-acp-0.1.2-node.tar.gz' --pattern SHA256SUMS
grep node.tar.gz SHA256SUMS | shasum -a 256 -c
tar xzf dsh-acp-0.1.2-node.tar.gz
install -m 0755 dsh-acp-0.1.2-node/dsh-acp ~/.local/bin/dsh-acp

Do not install dsh-acp from npm. This project no longer controls that npm name (see npm publishing), and the @offloophq/dsh-acp mirror does not exist.

Distribution and runtime boundary

The source repository and its published GitHub Releases are public:

  • GitHub Release assets can be downloaded anonymously and checked against the release SHA256SUMS file.
  • A downstream distributor can fetch a fixed public release artifact, verify its checksum, and ship the adapter in its own package.

The default release artifact is an esbuild-produced, portable JavaScript bundle for Node.js ^22.19.0 or >=24.0.0. This adapter is not shipped or executed as TypeScript, and it does not invoke npm, pnpm, npx, the tsx CLI, or network downloads at runtime. The versioned driver does import DSH's already-installed TypeScript sources through DSH's own validated tsx loader; that loader and source tree remain DSH-owned prerequisites.

Experimental Bun standalone compilation exists for six desktop targets, but the CI job retains only its manifest and not the binaries. The current in-process DSH driver is not Bun-compatible, and Bun embeds LGPL-licensed JavaScriptCore/WebKit, so every binary distribution remains gated on runtime compatibility plus separate relinking and license reviews. See distribution.

Development

Requirements are Node.js ^22.19.0 or >=24.0.0 and npm 11.

npm ci
npm run check
node scripts/package-release.mjs
node scripts/verify-release.mjs

Build outputs are written to dist/; release assets are written to release/. See npm publishing for the blocked npm channel and the dual-package, Trusted Publisher, release-tag, trust-boundary, and recovery contracts that apply if it is restored.

Security properties

  • Discovery never downloads or mutates DSH.
  • PATH basename matches are treated as candidates, not identity proof.
  • The logical install anchor, physical checkout, critical file contents, Node version, and tsx version are fenced before construction and again before DSH boot.
  • serve keeps non-protocol output off stdout.
  • Diagnostic serialization is bounded and redacts credential-shaped keys, headers, URLs, and values.
  • Tool inputs are projected the same way, except live calls to MCP servers the client configured, which report the exact bounded arguments DSH sends to them (see compatibility).
  • The DSH composition used by the driver disables DSH telemetry and owns cleanup of sessions and the root fiber.
  • Every boot uses an adapter-owned private temporary configuration, forces the reviewed workspace-write/ask baseline, and leaves the installed DSH source configuration unchanged.
  • Persisted, fork-seeded, and newly returned DSH event logs are rejected if their permission preset, sandbox mode, or approval policy is dangerous, unknown, or outside the exact reviewed event shape. Only absent facts or read-only/workspace-write plus ask can be adopted.
  • The final boot layer disables DSH's built-in repository, web search/fetch, and telemetry rows, then verifies that no global web service or web_search/web_fetch tool survived composition.

This is not process-wide network isolation. DSH workspace-write constrains file writes; a bash/execute command may still use host networking, and an ordinary tool call does not necessarily raise an ACP permission request. The selected model transport and ACP-explicit MCP servers are intentional separate network paths. Standalone clients must apply policy appropriate to their trust model. A client that requires protected admission must fail closed until its outer network/provider interception conformance has passed; a successful ACP initialize alone is not protected-readiness proof. The vendor capability metadata reports this explicitly as offloop.dsh-acp.security.

Report vulnerabilities through the repository's private vulnerability reporting channel. Do not include API keys, credentials, prompts, or customer data in a public issue.

License

Original project code is licensed under the MIT License. Bundled dependencies and optional runtimes retain their own licenses; see THIRD_PARTY_NOTICES.md. DSH is an external prerequisite and is not included or redistributed by this project.

About

Client-neutral ACP adapter for DeepSeek Harness

Topics

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

0