Skip to content

v0.18.0: Schema 1.32.0 and frozen Agent/Client methods

Latest

Choose a tag to compare

@ThomasK33 ThomasK33 released this 18 Nov 04:35
Immutable release. Only release title and notes can be modified.
020bcaf

Added

  • Target ACP schema 1.32.0 (acp.SchemaVersion = "1.32.0"), walking 1.25.0 → 1.26.0 → 1.27.0 → 1.28.0 → 1.29.0 → 1.29.1 → 1.30.0 → 1.31.0 → 1.32.0 (#108).
  • acp.Agent and acp.Client methods are frozen at the stable methods of schema 1.25.0; every other method now has its own single-method optional interface (e.g. AgentUnstableForkSession, ClientUnstableMessageMcp). Missing optional interfaces answer -32601, just like AgentLoader always has (#107).
  • Stable client system prompt (schema 1.30.0): SessionCapabilities.SystemPrompt / SessionSystemPromptCapabilities (with Mode.Override), SystemPrompt with SystemPromptMode (append, override, open Other) and Content, and SystemPrompt fields on NewSessionRequest, LoadSessionRequest, ResumeSessionRequest (#108).
  • Unstable methods with optional interfaces and outbound wrappers: auth/status (AgentUnstableAuthStatus), session/archive, session/unarchive, session/status, session/set_title, session/options, plus the auth/status_update notification (ClientUnstableAuthStatusUpdate) (#108).
  • Unstable: prompt suggestions (ClientSessionCapabilities.PromptSuggestions, SessionUpdate.PromptSuggestionsUpdate), speed config option category, initial config option values on session/new/load/resume/fork, auth account Description, markdown plan Path, subagent working directories, session tool-call content (ToolCallContent.Session / ToolCallContentSession), and archive filter for session/list (ListSessionsRequest.Archived, SessionInfo.Archived) (#108).
  • example/agent advertises sessionCapabilities.systemPrompt (append only), echoes the system prompt each turn, and refuses other modes, empty content or non-text blocks with -32602 (#108).

Changed

  • null now decodes as an empty list for the 14 list fields marked x-deserialize-default-on-null in schema 1.27.0 — e.g. mcpServers / additionalDirectories on NewSessionRequest / LoadSessionRequest / ResumeSessionRequest, args / env on CreateTerminalRequest, McpServerStdio, AuthMethodTerminal, and HTTP/SSE MCP server headers. v0.17.0 would reply -32602; v0.18.0 accepts and treats the field as empty (#108).
  • Cost.Currency may hold a non-ISO unit such as credits (schema 1.28.0); the type is still string (#108).

Removed

  • AgentExperimental and ClientExperimental umbrella interfaces — use one assertion per optional interface you implement (#107).
  • Next edit suggestions (unstable, schema 1.26.0): all nes/* and document/* methods, their constants, wrappers and types, AgentCapabilities.Nes / PositionEncoding, ClientCapabilities.Nes / PositionEncodings (#108).
  • PlanUpdateContent.File, PlanFile, PlanUpdateContentFile, NewPlanUpdateContentFile (unstable, schema 1.32.0) — use a markdown plan with Markdown.Path (#108).
  • SenderSessionId and RecipientSessionId on SessionMessageChunk / SessionUpdateSessionMessageChunk (unstable, schema 1.27.0) — read them from the session_message update via MessageId (#108).

Fixed

  • Generator: load.MergeStableAndUnstable now compares definitions by shape, ignoring description text. From schema 1.27.0 on, the unstable schema links to draft docs, which previously duplicated ~30 types (e.g. UnstableSessionId, UnstableContentBlock) and added 10 spurious API breaks (#108).