mirror of https://github.com/agentclientprotocol/claude-agent-acp.git synced 2026-10-27 04:30:59 +00:00

Go to file

Ben Brandt 7184fd3cfe fix: keep a long Agent call's heartbeat on the session that made the call

A heartbeat of a running Agent call reports under a synthetic id, so the
adapter falls back to parent_tool_use_id, which is the Agent call itself, and
also stamped that id as the beat's parentToolUseId. For a client on the
subagents RFD, which sees the Agent call, the beat and every later update of
the call then went to the child session. Found in a live run with a 40-second
subagent.

The same run showed that Claude Code's interrupt currently stops background
subagents too, so the README and comments no longer say they keep running.

2026-10-13 14:59:44 +02:00

.github

ci: poll for package availability after publish before triggering registry update (#1121 )

2026-09-11 11:46:03 +02:00

docs

Merge remote-tracking branch 'origin/main' into feat/subagent-update

2026-10-13 08:02:17 +02:00

examples

feat(steering): settle a steered turn at idle, not at the interrupt (#958 )

2026-08-05 18:41:00 +02:00

scripts

ci: set up preview publishing (#1084 )

2026-09-08 14:16:37 +02:00

src

fix: keep a long Agent call's heartbeat on the session that made the call

2026-10-13 14:59:44 +02:00

.gitattributes

feat: AIR tool call contract, exact git patches, plan file, and fixes for every client (#1153 )

2026-09-28 17:58:00 +04:00

.gitignore

Steering implementation (#885 )

2026-07-21 18:53:56 +02:00

.prettierignore

feat: AIR tool call contract, exact git patches, plan file, and fixes for every client (#1153 )

2026-09-28 17:58:00 +04:00

.prettierrc.json

Setup linter (#12 )

2025-09-02 19:06:32 -03:00

.release-please-manifest.json

chore(main): release 0.89.1 (#1294 )

2026-10-10 13:10:02 +04:00

AGENTS.md

fix: recreate live sessions on logout when it clears a provider or gateway override (#1278 )

2026-10-08 17:50:23 +04:00

CHANGELOG.md

chore(main): release 0.89.1 (#1294 )

2026-10-10 13:10:02 +04:00

CLAUDE.md

ci: simplify the release flow and make it agent-friendly (#965 )

2026-08-07 13:46:42 +02:00

eslint.config.js

fix: Infer 1M context from model descriptions (#799 )

2026-06-22 12:37:07 +02:00

LICENSE

Update for ACP Org (#471 )

2026-03-26 12:19:06 +01:00

package-lock.json

chore(main): release 0.89.1 (#1294 )

2026-10-10 13:10:02 +04:00

package.json

chore(main): release 0.89.1 (#1294 )

2026-10-10 13:10:02 +04:00

README.md

fix: keep a long Agent call's heartbeat on the session that made the call

2026-10-13 14:59:44 +02:00

release-please-config.json

ci: fix release flow (#971 )

2026-08-07 15:16:50 +02:00

tsconfig.json

feat(acp): Handle ACP request cancellation signals (#801 )

2026-06-22 14:48:42 +02:00

vitest.config.ts

test: keep the suite off the real Claude CLI (#1223 )

2026-10-02 15:15:00 +02:00

README.md

ACP adapter for the Claude Agent SDK

Use Claude Agent SDK from ACP-compatible clients!

This tool implements an ACP agent by using the official Claude Agent SDK, supporting:

Context @-mentions
Images
Tool calls (with permission requests)
Compact file changes through the negotiated AIR diff patch extension
Following
Edit review
TODO lists
Nested subagent transcripts
Interactive (and background) terminals
Custom Slash commands
Client MCP servers
/mcp in the chat: the MCP server status as a list. The adapter runs /mcp reconnect, /mcp enable, and /mcp disable through the SDK control API, because Claude Code refuses them in SDK mode. A reconnect of an ACP server that needs authentication starts MCP OAuth through URL elicitation
Session-scoped long-running goals for AIR through the goal extension under _meta.jetbrains.air.goal
Structured errors, recovery, and warnings through the opt-in session failure extension
Concrete model and effort defaults through the opt-in recommended config value extension
Tool permission presentation, editable choices, and durable effects through the permission extension
One fact per field in every tool call report, as the ACP tool call contract defines
All AIR extensions, capabilities, and _meta keys: AIR extensions

Learn more about the Agent Client Protocol.

To try changes that have landed on main but are not released yet, install from the preview channel — every push to main publishes one. See docs/RELEASES.md.

npm install @agentclientprotocol/claude-agent-acp@preview

Subagent sessions

A client that declares clientCapabilities.subagents, other than JetBrains AIR, gets each Agent or Task subagent as its own child session, following the subagents RFD:

subagent_update on the parent announces the child before any of its traffic, with the parent's title and description for it, and reports its work state: running, requires_action while one of its requests is open, and idle when its work ends, with end_turn or cancelled when the SDK gives the reason. A failure is idle with the error stop reason and the SDK's error text as its error. The child keeps its session for every delegation to it.
The prompt of the Agent or Task call that launches the child, and the message of each SendMessage call that resumes it, is a session_message in the child's transcript. The tool call stays a tool call of the session that made it.
session/cancel on the parent interrupts Claude Code, which stops the foreground children that the turn waits on and, currently, background children too. Each stopped child reports idle with cancelled from Claude Code's own events, and the open requests of the foreground ones are withdrawn. The adapter ends no child at a cancel itself, so a child that keeps running keeps its open requests. A child that still runs when Claude Code exits is idle with no stop reason.
A child whose parent is not yet known when it ends is not exposed, since the RFD forbids guessing its parent.
A client cannot prompt, cancel, or otherwise change a child yet, and a replay does not restore children yet.

JetBrains AIR keeps the earlier draft of the RFD (subagent_spawned, subagent_state_update), which it enables with nativeSubagentSessions in _meta.jetbrains.air.capabilities. See AIR extensions.

Without either signal, Agent and Task stay ordinary tool calls and child interactions stay on the root session. Clients that use the historical _meta["subagent-transcript"] capability or the forwardSubagentText session option retain the flattened child transcript.

Contribution Policy

This project does not require a Contributor License Agreement (CLA). Instead, contributions are accepted under the following terms:

By contributing to this project, you agree that your contributions will be licensed under the Apache License, Version 2.0. You affirm that you have the legal right to submit your work, that you are not including code you do not have rights to, and that you understand contributions are made without requiring a Contributor License Agreement (CLA).