github coder/acp-go-sdk v0.14.0
v0.14.0: Stable session/delete, ordered cancels, honest JSON decoding

latest release: v0.15.0
45 minutes ago

Added

  • Stable session/delete: Agent.DeleteSession is now required, (*ClientSideConnection).DeleteSession is exported, and advertised via AgentCapabilities.SessionCapabilities.Delete (#98).
  • New acp.SchemaVersion constant ("1.13.7") and acp.ProtocolMethodCancelRequest ("$/cancel_request"); SDK semver is now decoupled from the schema pin (#90).
  • Stable MessageId type on message chunks; stable usage_update doc comments; Meta map[string]any added to Cost, Usage, UnstableElicitationSchema, and unstable NES/provider/document types (#98).
  • Scoped elicitation constructors: NewUnstableCreateElicitationRequestFormSession/Request and …UrlSession/Request (#95).

Fixed

  • Data race on Connection.logger: field is now an atomic.Pointer[slog.Logger] (#59 by @dimetron).
  • Inbound requests now wait for notifications that arrived earlier on the same wire (#56 by @abietic).
  • Notification handlers can now make requests on their own connection without deadlocking — pass the handler's context (#68).
  • Closed the cancel-lost and nested-request deadlock gaps opened by the barrier work, with bounded cancel-marker state (#71).
  • session/cancel now only cancels prompts sent before it, the newer of two overlapping prompts wins, and both the notification and request forms of session/cancel are ordered on one clock (#86, #88, #89).
  • Generated UnmarshalJSON honors x-deserialize-default-on-error, -skip-invalid-items, and -default-on-null hints; required arrays encode as [] instead of null (#94).
  • Structs with defaults decode in place, and type errors now name the struct and JSON path (e.g. InitializeResponse.agentCapabilities.loadSession) (#93).
  • Unions keep _meta, annotations, and their own properties across a JSON round trip; decoding starts from an empty wrapper (#95).
  • Unions dispatch on their discriminator value: unknown discriminators are errors (not a silent first-variant match), ToolKind reads unknown kinds as other, and catch-all structs preserve unknown keys in AdditionalProperties (#97).
  • ErrorCode decodes to the variant matching its numeric code (-32601 → MethodNotFound); unknown codes → Other. Previously every code set ParseError (#100).
  • example/agent: prompt turn ends when the request is cancelled (#67); example/client, example/claude-code, and example/gemini print tool-call status instead of a pointer and cancel permission prompts on EOF (#66); examples share one stdin reader so piped input no longer loses permission answers (#77).

Changed

  • Tracks ACP schema 1.13.7 (was 0.13.5) (#98).
  • Build tooling: make version is replaced by make generate; make release VERSION=<sdk> [SCHEMA=<schema>] prepares a release PR; schema assets for 1.x are fetched from schema-v<version> tags (#90).
  • example/claude-code now starts @agentclientprotocol/claude-agent-acp (#90).

Removed

  • UnstableDeleteSessionRequest, UnstableDeleteSessionResponse, AgentExperimental.UnstableDeleteSession, and (*ClientSideConnection).UnstableDeleteSession — superseded by the stable session/delete API (#98).
  • Unstable ClientCapabilities.PlanCapabilities (renamed to Plan), PromptRequest.MessageId, and PromptResponse.UserMessageId (#98).
  • NewUnstableCreateElicitationRequestForm and NewUnstableCreateElicitationRequestUrl — replaced by scoped constructors (#95).

Don't miss a new acp-go-sdk release

NewReleases is sending notifications on new releases.