Repository navigation
Open
Description
Feature hasn't been suggested before.
- I have verified this feature I'm about to request hasn't been suggested before.
Describe the enhancement you want to request
The Agent Client Protocol v2 draft has been published with a migration guide for agents. This is ACP v2 draft (the protocol layer), not to be confused with OpenCode V2 (the session core).
Key changes in ACP v2 draft that we should support:
- Prompt lifecycle —
session/promptreturns{}on acceptance; foreground state flows asstate_updatenotifications (running/idlewithstopReason) - Mid-turn steering — a second
session/promptadmitted while a turn is running steers at the next safe boundary - Initialize restructure —
capabilities/infofields, session-scoped capability groups,protocolVersion: 2negotiation - Cancel confirmation — confirmation is
state_update: idlewithstopReason: cancelled, not the prompt response - Message IDs —
messageIdon all chunks; whole-message upserts (user_message) with acknowledgment - Tool calls —
tool_call_updatefor create+patch (stop emittingtool_callcreate) - Agent-owned terminal display —
terminal_updateupserts with base64-encodedoutput.dataandexitStatus - Structured diffs —
changesarray +git_patchformat instead ofoldText/newText - Permission requests — required
title, optionaldescription, extensiblesubjectunion - Plans —
plan_updatewithplanIdkeyed tagged union - Session lifecycle —
session/resumewithreplayFrom - Session modes removed — express as config options with
category: mode - Auth renames —
authenticate→auth/login,logout→auth/logout - MCP config —
typediscriminator (http/sse/acp/stdio) - Slash commands —
input: { type: "text", hint }discriminator - JSON-RPC batch — accept and process batch arrays on stdio
- Extensibility — open enums,
_metapassthrough, unknown content block types
This should be gated behind OPENCODE_EXPERIMENTAL_ACP_V2 with v1/v2 side-by-side support so existing clients are unaffected. The SDK needs upgrading from 0.21.0 to 1.3.0.
Implementation: #44524
Metadata
Metadata
Assignees
Labels
No labels
Activity
mountaintopsolutions commentedon Sep 4, 2026
Anyone interested? Steering support would be amazing right now :)
opencodejr commentedon Oct 28, 2026
Thanks for the detailed write-up and the links to the spec and migration guide! You're asking for support for the Agent Client Protocol v2 draft (the new prompt lifecycle with
state_update, mid-turn steering, the restructuredinitialize, message-ID upserts, structured diffs,session/resumeand so on), kept behindOPENCODE_EXPERIMENTAL_ACP_V2so existing ACP v1 clients aren't affected. Maintainers will consider it.Related work:
OPENCODE_EXPERIMENTAL_ACP_V2=1flag (it uses SDK 1.8.0 and refers to this issue)_session/steeringon ACP v1