Skip to content

v0.19.0: Stricter hint decoding and elicitation passthrough

Latest

Choose a tag to compare

@ThomasK33 ThomasK33 released this 18 Nov 09:11
· 1 commit to main since this release
Immutable release. Only release title and notes can be modified.
6270cb0

Still targets ACP schema 1.32.0 (acp.SchemaVersion = "1.32.0"). No API break: one new exported field (CreateElicitationOther.AdditionalProperties), plus two behavior fixes that align decoding with the Rust SDK, a quieter log level for unhandled notifications, and a reference session/load implementation in example/agent.

Added

  • CreateElicitationOther.AdditionalProperties map[string]json.RawMessage preserves members that the schema of the other mode of elicitation/create does not name, and writes them back on encode. Previously a proxy or logger that round-tripped an unknown elicitation mode dropped extras like {"extra":{"k":1}} (#114, fixes #102).

Fixed

  • Decoding at properties marked x-deserialize-default-on-error or x-deserialize-skip-invalid-items now checks each hinted value against its schema shape. A value that misses a required member, holds an unknown closed-enum value, or holds null where the schema rejects it now reads as the default or is dropped, matching agent-client-protocol-schema 1.18.0. Before, such values were kept with zero fields — e.g. {"sessions":[{"sessionId":"s"}]} kept a SessionInfo with an empty cwd, and plan entries with unknown priority were kept (#113, fixes #96).

Changed

  • Unhandled notifications (an unknown method, or an optional interface such as ClientUnstableAuthStatusUpdate that you do not implement) are now logged at DEBUG as ignored unhandled notification, not ERROR. Decode failures (-32602) and handler errors still log at ERROR, and requests still answer -32601. This silences one ERROR per Claude Code session for clients that don't implement auth/status_update (#110).
  • example/agent now advertises loadSession: true and implements session/load as a reference: it replays the session's prompts and prior session/update notifications before responding, accepts a new systemPrompt (applied only after a successful replay), refuses an unknown session with -32002 (with sessionId in data), and refuses a mismatched cwd with -32602. Notices are not replayed, and tool call IDs stay unique across turns. The README documents the new lock order (#112).

Performance

  • The new shape check parses each hinted value a second time. With -cpu 1, decoding messages heavy in hinted values takes 15–34% longer (geomean +18%); text chunks are unchanged. See BenchmarkUnmarshalJSON_HintedValues (#113).

Full Changelog: v0.18.0...v0.19.0