github ag-ui-protocol/ag-ui release/2026-11-05
Release 2026-11-05

4 hours ago

Packages Published

Maven Central - published at 08:13:26 UTC

Package Version Install
kotlin-core 0.5.0 com.ag-ui.community:kotlin-core:0.5.0
kotlin-client 0.5.0 com.ag-ui.community:kotlin-client:0.5.0
kotlin-tools 0.5.0 com.ag-ui.community:kotlin-tools:0.5.0

kotlin-core@0.5.0

  • Aligned the SDK with AG-UI 1.0, including strict event/input decoding and state patch structural checks.
  • Added REASONING_* events; THINKING_* events and ThinkingTelemetryState are deprecated with ReplaceWith hints.
  • Added interrupt protocol support (Interrupt, ResumeStatus, ResumeEntry) on RUN_FINISHED outcomes.
  • Added ACTIVITY_SNAPSHOT/ACTIVITY_DELTA events, ActivityMessage, Role.ACTIVITY, ToolMessage.error, and multimodal UserMessage support.
  • Added wasmJs (browser) and macosArm64 targets across core, client, and tools.
  • Fixed JSON Pointer validation to avoid stack overflow on long pointers across JVM, Wasm, and Native.
  • RunFinishedSuccessOutcome now serializes to exactly {"type":"success"}.
  • Tool-result content arrays serialize without string fallback.
Breaking changes
  • Targets AG-UI 1.0; strict event/input decoding and tightened validation may reject previously accepted payloads.
  • Usage counts validated as exact safe JSON integers; decimal/exponent spellings normalized.
  • Explicit-null checks tightened across nested typed models and message/outcome names.
  • THINKING_* events, ThinkingTelemetryState, and AgentState.thinking deprecated; migrate to REASONING_*/ReasoningTelemetryState.
  • kotlin-json-patch dependency dropped; StateManager uses the internal RFC 6902 implementation.
  • Group ID changed to com.ag-ui.community; com.contextable/com.agui references removed.
  • minSdk lowered to 24; Kotlin pinned to 2.1.20.
  • RunFinishedSuccessOutcome serialization now emits only the type key; verify consumers tolerant of extra fields.

kotlin-client@0.5.0

  • Aligned the client with AG-UI 1.0, including run-input handling and state application.
  • Activity messages are now stripped from the run input sent to the agent.
  • Added REASONING_* event support; THINKING_* deprecated with ReplaceWith hints.
  • Added wasmJs (browser) and macosArm64 targets.
  • State patches applied without recursion to avoid stack overflow on deeply nested state.
  • Preserve multimodal tool contents, metadata, and subagent attribution across history paths.
  • Documented that a malformed STATE_DELTA is fatal to the flow, while an inapplicable delta is reported via onStateError.
Breaking changes
  • StateManager now rejects deltas it previously accepted: replace/remove of a missing member, add under a missing parent, move into its own child, and add without a value.
  • Rejected deltas report com.agui.client.state.JsonPatchApplicationException instead of kotlin-json-patch exception types.
  • MAX_JSON_DEPTH reduced from 512 to 128; deeply nested SSE payloads are refused.
  • catch (e: Error) removed from commonMain; over-nested SSE payloads are refused rather than swallowed.
  • Activity messages are no longer echoed back in run inputs.
  • Numeric delta comparison is now by value (1 equals 1.0).
  • Group ID changed to com.ag-ui.community; minSdk lowered to 24; Kotlin pinned to 2.1.20.

kotlin-tools@0.5.0

  • Added wasmJs (browser) and macosArm64 targets.
  • CircuitBreaker now accepts an injected kotlinx.datetime Clock; the existing single-argument constructor remains and defaults to Clock.System.
Breaking changes
  • Group ID changed to com.ag-ui.community; com.contextable references removed.
  • minSdk lowered to 24; Kotlin pinned to 2.1.20.

Don't miss a new ag-ui release

NewReleases is sending notifications on new releases.