@1agents/acp-service

dsh plugin --profile web add @1agents/acp-service

@1agents/acp-service

Run persistent Codex, Claude Code, Grok Build and other supported native Agent sessions in DeepSeek Harness (DSH), or use the same package as a standalone CLI and ACP service. DSH exposes the Agent's native models, settings, commands and permission requests; each session keeps its Agent and workspace when reconnected.

Install in DSH

Requires Node.js 22.13+, DSH, and the selected native Agent's CLI and credentials on the DSH host. Adapter-backed Agents also require their ACP adapter; the native Codex CLI alone does not provide codex-acp.

dsh plugin --profile web add @1agents/acp-service@^0.7.0

Restart DSH and check that @1agents/acp-service is enabled on the Plugins page. Create a session with a discovered ACP · Agent preset, choose an existing workspace, then send a text prompt. The plugin starts or reuses its local service automatically. Use your own profile name in place of web; from a DSH source checkout, replace dsh with pnpm dsh.

If pnpm reports an ignored transitive esbuild build script, follow the package manager's prompt or set that individual package's approval in the profile, then repeat the install. Approve or deny the script according to your policy, and check the bundle's enabled state after a partial install.

The pinned GitHub Release tarball contains the same published npm artifact:

dsh plugin --profile web add https://github.com/scottzx/1acp/releases/download/acp-service-v0.6.0/1agents-acp-service-0.6.0.tgz

@1agents/session-reader is optional: install it separately to browse and continue existing Claude, Codex and Grok histories. For presets, native controls, configuration and migration, see the DSH user guide.

The CI baseline is DSH 0.1.7-rc.2, commit 21638c56315ae6a2b552d6091945d3144c9af32e. Additional isolated-profile verification used a locally modified DSH tree labeled 0.2.0-rc.1. The verification record describes the installed-package, Loader, browser and lifecycle checks and their limits.

Screenshots

These unmodified screenshots show discovery and native capability loading in that fresh isolated local profile. No model prompt was sent for the UI check. Controls depend on the selected Agent, adapter and account.

Standalone CLI and service

npm install -g @1agents/acp-service@^0.7.0
acp-service --help
acp-service serve --host 127.0.0.1 --port 36812 --no-report

The service uses ACP v1 JSON-RPC 2.0 over WebSocket. DSH is unnecessary for the standalone entry points. A2A delegation is opt-in and disabled by default; its configuration is documented below. Waking a calling system's main Agent after task completion requires that system's receiving host adapter.

Bundled usage skill

[ACP Service skill](skills/acp-service/SKILL.md) is distributed in this npm package and maintained with the source. It covers entry-point selection, ACP CLI/WebSocket sessions, DSH presets and native model controls, A2A delegation, task queries and the durable completion inbox. Detailed examples are included in its references/ directory.

acp-service --skill list
acp-service --skill show acp-service
acp-service --skill export acp-service > acp-service-skill.tar
# Install the complete skill in the current project when wanted:
acp-service --skill install acp-service --agent codex --scope repo

The existing embedded acpx runtime skill remains available. The skill and its references can also be read directly from skills/acp-service/ after installing version 0.6.0 or later.

Service development and API

Version 0.6.0 includes the 1ACP runtime, CLI, service, DSH plugin, browser controls, skills and licenses. The runtime and service retain their respective ACP SDK versions.

The runtime's per-session launch argv and transient credentials APIs support Provider Profiles. Public runtime APIs and flow authoring are available as @1agents/acp-service/runtime and @1agents/acp-service/flows. The acp-service command forwards runtime commands alongside its serve command.

Run from the monorepo root:

pnpm install --frozen-lockfile
pnpm --filter @scottzx/1acp build
pnpm --filter @1agents/acp-service build
pnpm start:service serve --host 127.0.0.1 --port 36812 --no-report

The default port is 36812. Without --no-report, the service reports to the local DreamMate node. Agent executables and their authentication must be available to the service process. ACP_STATE_DIR overrides the default ~/.1agents/acpx-state directory for runtime records, turn journals and ACP replay data.

Automatic launches now share a device capacity ledger and FIFO queue. Admission checks current available memory immediately before startup, keeps a configurable reserve, and also enforces estimated soft/hard concurrency limits. A2A work stays SUBMITTED (Pending) while resources are unavailable, then starts in queue order; queued work can be canceled. ACP launches, probes and pre-warming use the same memory protection. Native user sessions outside this service continue independently. See [device capacity and queue policy](../../docs/device-capacity-queue-20261023.md) for defaults, environment variables, scope and restart behavior.

For npm-backed agents, the service first uses an adapter package installed in its package search roots, then the runtime's adapter executable on PATH or in user-local binary directories. JavaScript adapters run with the service's Node interpreter. Only when

…(truncated)