Release 2026-11-132026-11-13
@ag-ui/langgraph 发布 0.0.46。这版主要修补 LangGraph 对接的几处兼容问题:优先读取 LangGraph 1.2.12 起新增的原生 Interrupt.responseschema 字段,旧字段作为回退;修复工具结束事件中 LangChain 序列化的 ToolMessage 输出未被正确解包,导致工具调用与结果无法正常发出;遇到没有 tool call id 的输出时直接跳过,不再抛异常或发出 id 为 undefined 的事件。RUNSTARTED 事件补上了 protocolVersion 声明,另更新了 Gemini 思维链示例。需要注意的是破坏性变更:@ag-ui/client 及相关 peer 依赖现在要求 >=1.0.0,utils.ts 用到的 contentToText/contentHasMedia 仅 1.0 提供,升级前请一并更新客户端依赖。
Release 2026-11-122026-11-12
Packages Published
TypeScript (npm) - published at 01:54:53 UTC
| Package | Version | Install |
|---------|---------|--------|
| @ag-ui/claude-agent-sdk | 0.0.9 | npm install @ag-ui/claude-agent-sdk@0.0.9 |
| @ag-ui/a2ui-middleware | 0.0.16 | npm install @ag-ui/a2ui-middleware@0.0.16 |
@ag-ui/claude-agent-sdk@0.0.9
- Fixed clone() of ClaudeAgentAdapter, which previously lacked state maps and threw "Cannot read properties of undefined (reading 'has')" in hosts that clone agents per request, such as CopilotKit runtime.
- Clones now share per-thread state (bindings, admitted, activeQueries, sessions) with the original.
- Frontend tool parameter schemas are now converted from JSON Schema recursively, preserving nested object properties, array item schemas, required fields, enums, const, nullable/union types and descriptions.
- Nested objects no longer strip undeclared keys during parsing.
- Preserved raw frontend outcomes during native recovery and replay saved tool results after executor failure.
- Preserved final assistant identity without streaming and reconciled superseded recovery deliveries.
- Accept public interrupt answers and saved-result retries.
- Recover child dependency graphs, internal state, parallel root and frontend results across restarts from canonical history.
- Clear completed diagnostics after child results and keep recovery guards across interrupted bridges.
- Recover native child approvals without event storage.
Breaking changes
- Frontend tool parameter schemas now carry nested structure instead of collapsing to any[] or open records; verify agents relying on the previous loose shapes.
<!-- ag-ui-published: @ag-ui/claude-agent-sdk@0.0.9 -->
@ag-ui/a2ui-middleware@0.0.16
- Maintenance release; no consumer-facing changes identified.
Breaking changes
None.
<!-- ag-ui-published: @ag-ui/a2ui-middleware@0.0.16 -->
Python (PyPI) - published at 01:54:55 UTC
| Package | Version | Install |
|---------|---------|--------|
| aguistrands | 1.0.4 | pip install aguistrands==1.0.4 |
| ag-ui-claude-sdk | 0.2.4 | pip install ag-ui-claude-sdk==0.2.4 |
aguistrands@1.0.4
- Fixed run handling so each run is driven from a single task, allowing OpenTelemetry spans to detach correctly.
- Prevents OTel context token reset errors caused by spanning multiple contextvars Contexts.
Breaking changes
None.
<!-- ag-ui-published: aguistrands@1.0.4 -->
ag-ui-claude-sdk@0.2.4
- Stopped sending threadId/runId on TEXTMESSAGE and TOOLCALL events, which the AG-UI 1.0 schema rejects; avoids [ag-ui][enforce] strip warnings.
- Task tool calls now open an ActivitySnapshotEvent/ActivityDeltaEvent activity so frontends can render dispatched subagents distinctly; activities close on teardown and matching tool results.
- Preserve raw frontend outcomes and replay saved tool results during native recovery after executor failure.
- Preserve final assistant identity when not streaming.
- Reconcile superseded recovery deliveries and accept public interrupt answers and saved-result retries.
- Recover child dependency graphs, internal state, parallel root results, and native child approvals across restarts.
- Clear completed diagnostics after child results; keep recovery guards across interrupted bridges.
Breaking changes
- TEXTMESSAGE and TOOLCALL events no longer include threadId/runId; consumers relying on those fields must read them from RUN_STARTED or other run-level events.
<!-- ag-ui-published: ag-ui-claude-sdk@0.2.4 -->
Python (PyPI) - published at 06:15:12 UTC
| Package | Version | Install |
|---------|---------|--------|
| aguiadk | 0.13.0 | pip install aguiadk==0.13.0 |
aguiadk@0.13.0
- Express update activities now include creation state.
- Native A2UI template data paths are validated.
- A2UI generation follows catalog protocol versions.
Breaking changes
- Native A2UI template data paths are now validated; previously accepted invalid paths may be rejected.
<!-- ag-ui-published: aguiadk@0.13.0 -->
Release 2026-11-102026-11-10
@ag-ui/a2ui-a2ui-middleware@0.0.15 发布,重点修复流式场景下的一致性问题:流结束后保留重试耗尽状态,旧版审批在继续执行前先行消费以避免重复处理,动作上下文在各适配器间保持同一标识,其可见性在序列化和事件表示中也保持稳定。畸形的生成请求在流终止时会正确落定。此外,UI 动作在带签名的模型历史中改记为用户输入,私有上下文不再泄漏进公开对话记录。
有三处破坏性变更需要留意:公开对话记录中不再包含动作上下文,依赖从该处读取的代码需重新检查;带签名历史的消费方、以及序列化输出的下游也要相应复核。
Release 2026-11-092026-11-09
TypeScript 与 Python 双端同步更新,无破坏性变更。
npm 端 @ag-ui/aws-strands 升至 1.0.2:配置为 null 时保留强制工具选择;新增可关闭强制 A2UI 工具选择的开关;追踪 baggage 现在能跨 SDK 版本传递。
PyPI 端 aguistrands 升至 1.0.3:新增 StrandsAgentConfig.subagentvisibility,可选 inline(默认)、attributed、hidden,用于控制"agent 作为工具"时的子代理事件。选 attributed 后,子代理会发出 SUBAGENTSTARTED/SUBAGENTFINISHED/SUBAGENTERROR,并在文本、推理与工具调用上携带 subagentRunId。同时修复了任意层级嵌套子代理及未关闭内部工具调用的问题;收紧子代理快照归属,兄弟代理互相中断时不再丢失已完成的历史。Python 示例中将 openai 固定在 3 以下,保证引用演示正常运行。
Release 2026-11-062026-11-06
ag-ui-openai-agents 0.1.0 已发布至 PyPI,可用 pip install ag-ui-openai-agents==0.1.0 安装;官方未提供本次更新的说明内容。
Release 2026-11-052026-11-05
AG-UI Kotlin SDK 0.5.0 与 @ag-ui/client、@ag-ui/core 1.0.4 同日发布。
Kotlin 三包对齐 AG-UI 1.0,事件与输入改为严格解码。新增 REASONING 事件(THINKING 及相关状态已废弃,带 ReplaceWith 迁移提示)、中断协议、ACTIVITYSNAPSHOT/ACTIVITYDELTA 活动消息与多模态 UserMessage;活动消息不再回传到发给智能体的 run input。core、client、tools 新增 wasmJs 与 macosArm64 目标;长 JSON Pointer 校验不再栈溢出,深嵌套状态补丁改为非递归应用,STATE_DELTA 格式错误为致命错误、不适用的 delta 则经 onStateError 上报。
升级需留意几处破坏性变更:groupId 换成 com.ag-ui.community,minSdk 降至 24,Kotlin 锁定 2.1.20;kotlin-json-patch 依赖移除,异常改为 JsonPatchApplicationException;SSE 嵌套深度上限由 512 降到 128;RunFinishedSuccessOutcome 现在只序列化 {"type":"success"}。严格校验会拒绝部分此前能通过的 payload,建议升级后回归测试。
Release 2026-11-032026-11-03
aguiadk 0.12.0 已发布至 PyPI,可用 pip install aguiadk==0.12.0 安装。
这版新增了可选的 A2UI Express 推理路径,与原有的 Direct JSON 并列,注入式和显式持有的渲染工具都能按次运行自由切换。Express 输出由 a2ui-agent-sdk 0.10.0 增量编译为通过校验的 A2UI activity 更新,surface/activity 标识保持稳定。
修复方面:取消运行时不再过早返回,会先等 A2UI 模型流回卷完毕、尝试任务结束后再传播取消;HTTP 断开时会取消并等待自有 producer(包括卡在发送背压上的),同时清理迭代器、保留 HITL 暂停;SSE 流现在在声明的下限版本 sse-starlette 2.1.0 上就能正确关闭,不再依赖最新版。
无破坏性变更。
Release 2026-11-022026-11-02
ag-ui-a2ui-toolkit 0.0.6 已发布至 PyPI。
新增 A2UIGenerationError:适配器可在子代理调用中抛出这类结构化错误,runa2uigenerationwithrecovery 会记录本次失败,并在既定重试次数内把错误回传给模型,供下一轮生成参考;传输失败、取消等其他异常仍照常抛出。另外为支持 A2UI Express 的适配器加入了可选参数 inferenceformat,可取 "directjson" 或 "express",默认 "direct_json",老调用方不受影响。无破坏性变更。
Release 2026-10-302026-10-30
本轮共发布 7 个包。.NET 的 AGUI.ClaudeManagedAgents 0.0.4 让子代理结果在首次运行和页面重载后都能持久保留,运行时上下文在各适配器间转发,审批后可恢复规范化子结果;文本附件改用 UTF-8 文本源发送,并支持前端空结果。
TypeScript 端,@ag-ui/mastra 2.0.2 原样透传 Mastra 的 finishReason,新增 subagentVisibility 选项,把子代理 token 计入运行用量,修复挂起后兄弟工具调用丢失、use() 中间件未带入克隆体等问题;AbstractAgent.middlewares 改为 protected,自建克隆的子类需注意。@ag-ui/watsonx 0.0.4 新增 WatsonxRunsAgent 接入 /v1/orchestrate/runs/stream,修复工具参数丢失与 1MB 限流误杀;中断流现以 RUN_ERROR 结束,工具响应排队时序也有调整,需检查半截运行的处理。a2ui-middleware 0.0.14 与 mcp-apps-middleware 0.1.3 补齐 SDK 中间件工具,处理期间保留恢复输入。
Python 的 aguiadk 0.11.1 修复 OpenAI、Anthropic、LiteLLM 适配器的函数调用参数流式传输,避免重复 TOOLCALLSTART 与拼接出非法 JSON。
Release 2026-10-212026-10-21
ag-ui 本轮同步发布多个包。@ag-ui/claude-agent-sdk@0.0.8 修复排队的恢复轮次未等上一轮结束就继续推进的问题:完成批次在后续失败前清空,延迟批次在流中断前落盘,不支持的待处理批次改为保留并报错而非静默丢弃,审批恢复时的历史错误与结果保留在 metadata 中。
@ag-ui/claude-managed-agents@0.0.4 让子代理结果跨运行与重载持久化;空补全现在序列化为 content: [],零长度文本片段被剔除,依赖旧的空文本块输出的下游需重新核对。
aguiadk@0.11.0 修复新线程上客户端历史无法送达模型的问题,并修补一处访问控制缺陷(#2927)——客户端状态曾可改动应用级共享状态,建议尽快升级。升级后 HTTP 端点会丢弃 app:、user: 前缀的键,可信的全局状态改由服务端 extractstatefromrequest 提供,并在 ADKAgent 上显式开启 allowscopedstatekeys=True;同时不再兼容旧版 A2UI SDK。
ag-ui-claude-sdk@0.2.3 与 adk 的批次清理修复一致。