Mastra 于 2026-10-01 在 npm 发布 @mastra/[email protected](约 2026-10-01T08:36Z;相对 @mastra/[email protected] ahead_by 124)。核心是把 ProviderHistoryCompat / PrefillErrorHandler / StreamErrorRetryProcessor 做成默认 errorProcessors(可用 errorProcessorDefaults: false 关闭);流式增加 tool-call-resumed chunk;出站请求预写 Anthropic 非法 tool-call ID;并导出 findGatewayForModel / getGatewayId,子代理可按调用方 requestContext 解析模型。

核心要点速览 (Key Takeaways)

  • ✓发版:npm @mastra/[email protected](2026-10-01T08:36:38Z);compare 1.72.0...1.73.0 ahead_by 124;CHANGELOG packages/core
  • ✓稳定性默认:#24473 默认挂载 ProviderHistoryCompat → PrefillErrorHandler → StreamErrorRetryProcessor;仅瞬态失败重试;errorProcessorDefaults: false 可关闭;默认每轮安全上限 3
  • ✓流式:#25491 新增 tool-call-resumed(挂起/审批恢复,位于 tool-result 之前,payload.kind 区分类型)
  • ✓Anthropic:#24505 出站预写非法 tool-call ID,避免先失败再修复;持久化历史保留原 ID
  • ✓升级:npm i @mastra/[email protected];文档 mastra.ai/docs;仓库 mastra-ai/mastra
🧭

阅读完核心要点?进一步了解模型实力与实际开销

7 大权威镜像天梯跑分与 29+ 款主流编程套餐横向比价测算

🔬

深度技术解析与实战评估

核心背景与行业痛点

生产 Agent 最怕三类故障:① 提供商历史不兼容 / assistant prefill 被拒导致整轮崩溃;② 挂起或审批恢复后 UI 分不清「工具已恢复」与「委托结果覆盖」;③ Anthropic 路径上非法 tool-call ID 要先打失败再靠响应修复,浪费一轮。此前团队需手写重试与历史修补。国内读者请直接读 [CHANGELOG @mastra/[email protected]](https://github.com/mastra-ai/mastra/blob/main/packages/core/CHANGELOG.md) 与 compare 1.72.0...1.73.0(ahead_by 124),勿依赖推文摘要。

架构亮点与底层机制

[@mastra/[email protected]](https://www.npmjs.com/package/@mastra/core/v/1.73.0)(npm 2026-10-01T08:36:38Z)把稳定性栈做成默认:[#24473](https://github.com/mastra-ai/mastra/pull/24473) 默认 errorProcessors 顺序为 ProviderHistoryCompat → PrefillErrorHandler → StreamErrorRetryProcessor;Compat 现在也会在出站前修补 prompt。重试仅覆盖瞬态失败(isRetryable / OpenAI stream matcher / connection-reset);确定性 400 立即上浮。同 id 实例可替换槽位;errorProcessorDefaults: false 完全关闭默认。流式:[#25491](https://github.com/mastra-ai/mastra/pull/25491) 新增 tool-call-resumed,在 tool-result 之前发出,payload.kind 区分挂起与审批。Anthropic:[#24505](https://github.com/mastra-ai/mastra/pull/24505) 出站预写非法 tool-call ID,持久化历史保留原 ID。另导出 findGatewayForModel / getGatewayId,并支持 resolveSubagentModel(modelId, { requestContext })。

权威 Benchmark 与实测跑分对比

本版为 框架稳定性 / 流式协议 升级,CHANGELOG 未公布 TTFT、SWE-bench 或成本对比数字——勿外推为模型能力跃迁。可核对锚点:npm 1.73.0 于 2026-10-01T08:36:38Z;GitHub compare ahead_by 124。建议自测:故意注入瞬态流错误是否自动恢复;挂起工具恢复是否先见 tool-call-resumed;Claude 路径非法 tool-call ID 是否不再先失败一轮。

开发者实战落地与开箱指南

  1. 升级:npm i @mastra/[email protected](或锁定工作区同等版本)。
  2. 默认栈:无需配置即可获得历史修补与瞬态重试;自定义重试次数时同时设 maxProcessorRetries;不需要默认栈则 errorProcessorDefaults: false。
  3. UI:在 fullStream 监听 tool-call-resumed 更新挂起/审批状态。
  4. 文档:mastra.ai/docs、CHANGELOG、仓库。