Skip to content

v0.17.0: Stable notices, compaction, and tool names (ACP schema 1.25.0)

Latest

Choose a tag to compare

@ThomasK33 ThomasK33 released this 18 Nov 03:33
Immutable release. Only release title and notes can be modified.
f7ab161

Added

  • Target ACP schema 1.25.0 (acp.SchemaVersion = "1.25.0"), walking 1.21.0 → 1.22.0 → 1.23.0 → 1.24.0 → 1.24.1 → 1.25.0 (#105).
  • Stable session notices (schema 1.25.0): SessionUpdate.Notice / SessionUpdateNotice, Notice, NoticeSeverity (info, warning, error, Other), and client opt-in via ClientSessionCapabilities.Notices (#105).
  • Stable session compaction (schema 1.25.0): ClientSessionCapabilities.Compaction, SessionUpdate.CompactionUpdate / CompactionSummaryChunk, CompactionId, CompactionStatus (API matches the prior unstable types) (#105).
  • Stable tool call Name (schema 1.22.0) on ToolCall, ToolCallUpdate, SessionUpdateToolCall, SessionToolCallUpdate, plus new WithStartName / WithUpdateName helpers (#105).
  • Request-scoped MCP-over-ACP (mcp/message, unstable, schema 1.24.0): AgentExperimental.UnstableMessageMcp and ClientExperimental.UnstableMessageMcp are now dispatched on both sides; previously inbound mcp/message returned -32601 (#105).
  • Unstable: subagents (ClientCapabilities.Subagents, SessionUpdate.SubagentUpdate, SessionMessage / SessionMessageChunk updates, StateUpdate, SessionCancelCapabilities) and ErrorStopReason (#105).
  • example/agent names its tool calls (read_file, write_file), sends a disclaimer as an info notice when the client advertises session.notices, and answers /compact with compaction updates when the client advertises session.compaction; example/client advertises both and prints notices and tool names (#105).

Changed

  • Stricter decoding (schema 1.25.0): malformed values at receiver-acted sites now fail to decode instead of silently defaulting. Affects args / cwd / env / outputByteLimit on CreateTerminalRequest, line / limit on ReadTextFileRequest, mcpServers / additionalDirectories on NewSessionRequest / LoadSessionRequest / ResumeSessionRequest (and unstable UnstableForkSessionRequest), args / env on AuthMethodTerminal, and unstable document/didChange.contentChanges and mcp/message params. Requests fail with -32602; notifications are dropped with an ERROR log line (#105).

Removed

  • MCP-over-ACP connection methods: (*AgentSideConnection).UnstableConnectMcp / UnstableDisconnectMcp, ClientExperimental.UnstableConnectMcp / UnstableDisconnectMcp, ClientMethodMcpConnect / ClientMethodMcpDisconnect, UnstableConnectMcpRequest / Response, UnstableDisconnectMcpRequest / Response, UnstableMcpConnectionId, and the ConnectionId field on UnstableMessageMcpRequest / Notification. Use request-scoped UnstableMessageMcp with ServerId instead (#105).

Breaking Changes

  • AgentExperimental requires UnstableMessageMcp(ctx, UnstableMessageMcpNotification) error (#105).
  • ClientExperimental requires UnstableMessageMcp(ctx, UnstableMessageMcpRequest) (UnstableMessageMcpResponse, error) (#105).
  • UnstableMessageMcpResponse is now a struct with Result *UnstableMessageMcpResult and Error *UnstableMessageMcpError, not any (#105).