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.Agentandacp.Clientmethods 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 likeAgentLoaderalways has (#107).- Stable client system prompt (schema 1.30.0):
SessionCapabilities.SystemPrompt/SessionSystemPromptCapabilities(withMode.Override),SystemPromptwithSystemPromptMode(append,override, openOther) andContent, andSystemPromptfields onNewSessionRequest,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 theauth/status_updatenotification (ClientUnstableAuthStatusUpdate) (#108). - Unstable: prompt suggestions (
ClientSessionCapabilities.PromptSuggestions,SessionUpdate.PromptSuggestionsUpdate),speedconfig option category, initial config option values onsession/new/load/resume/fork, auth accountDescription, markdown planPath, subagent working directories, session tool-call content (ToolCallContent.Session/ToolCallContentSession), and archive filter forsession/list(ListSessionsRequest.Archived,SessionInfo.Archived) (#108). example/agentadvertisessessionCapabilities.systemPrompt(appendonly), echoes the system prompt each turn, and refuses other modes, empty content or non-text blocks with-32602(#108).
Changed
nullnow decodes as an empty list for the 14 list fields markedx-deserialize-default-on-nullin schema 1.27.0 — e.g.mcpServers/additionalDirectoriesonNewSessionRequest/LoadSessionRequest/ResumeSessionRequest,args/envonCreateTerminalRequest,McpServerStdio,AuthMethodTerminal, and HTTP/SSE MCP serverheaders. v0.17.0 would reply-32602; v0.18.0 accepts and treats the field as empty (#108).Cost.Currencymay hold a non-ISO unit such as credits (schema 1.28.0); the type is stillstring(#108).
Removed
AgentExperimentalandClientExperimentalumbrella interfaces — use one assertion per optional interface you implement (#107).- Next edit suggestions (unstable, schema 1.26.0): all
nes/*anddocument/*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 withMarkdown.Path(#108).SenderSessionIdandRecipientSessionIdonSessionMessageChunk/SessionUpdateSessionMessageChunk(unstable, schema 1.27.0) — read them from thesession_messageupdate viaMessageId(#108).
Fixed
- Generator:
load.MergeStableAndUnstablenow compares definitions by shape, ignoringdescriptiontext. 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).