@ai-zen/agents-sdk 1.0.0-alpha.19 → 1.0.0-alpha.20

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [1.0.0-alpha.20] - 2026-10-27
+
+### ✨ 新增
+
+- **`createAgent(scope, agentId, options?)` 新增第三参，把中断相关策略透传出来** —— 此前 SDK 完全没有暴露 core 的 `abortedToolRoundStrategy` / `abortedToolRoundReason`，调用方只能吃默认值。本轮一并接出三个字段（新增导出类型 `CreateAgentOptions`，`SdkAgent` 构造参数同步支持）：
+  - `abortedToolRoundStrategy?: "drop" | "fill"` —— 工具轮次被中断（或结果不完整）时的归一策略（core 默认 `fill`）；
+  - `abortedToolRoundReason?: string` —— `fill` 策略下未完成工具结果的填充原因；
+  - `abortedMessageStrategy?: "drop" | "keep"` —— **新增能力**：被中断的 assistant 已输出的内容 / 思考是否保留（core 默认 `drop`）。传 `keep` 后，用户中断时那半句话仍会进入下一轮上下文，模型能接着往下说，而不是「失忆重来」；带工具调用的轮次仍由 `abortedToolRoundStrategy` 决定，不受影响。
+
+### 🔧 依赖
+
+- 升级 `@ai-zen/agents-core` 至 `4.5.3`（新增 `abortedMessageStrategy` 与 `reconcileAbortedMessages()`）。
+
+### ✅ 测试
+
+- 全量 **57 文件 / 602 例通过**（6 skipped）。
+
 ## [1.0.0-alpha.19] - 2026-10-27
 
 ### 🐛 修复

package/dist/index.d.ts

@@ -30,6 +30,7 @@ export { createModel } from "./runtime/createModel.js";
 export { SdkAgent } from "./runtime/SdkAgent.js";
 export type { AgentPlugin, SendContext } from "./runtime/SdkAgent.js";
 export { createAgent } from "./runtime/createAgent.js";
+export type { CreateAgentOptions } from "./runtime/createAgent.js";
 export { McpConnectionManager } from "./scope/plugins/mcp/McpConnectionManager.js";
 export type { McpConnectOptions } from "./scope/plugins/mcp/McpConnectionManager.js";
 export { SdkCallbackTool } from "./scope/plugins/builtin/SdkCallbackTool.js";

package/dist/runtime/SdkAgent.d.ts

@@ -1,6 +1,6 @@
 import type OpenAI from "openai";
 import { Agent } from "@ai-zen/agents-core";
-import type { AgentNS, Tool } from "@ai-zen/agents-core";
+import type { AbortedMessageStrategy, AbortedToolRoundStrategy, AgentNS, Tool } from "@ai-zen/agents-core";
 import type { AgentDefinition } from "../types/index.js";
 import type { Scope } from "../scope/Scope.js";
 export type { AgentPlugin, SendContext } from "@ai-zen/agents-core";
@@ -30,5 +30,11 @@ export declare class SdkAgent extends Agent {
         messages?: AgentNS.Message[];
         tools?: Tool[];
         allowJsonParseError?: boolean;
+        /** 工具轮次被中断时的归一策略（core 默认 `fill`） */
+        abortedToolRoundStrategy?: AbortedToolRoundStrategy;
+        /** `fill` 策略下未完成工具结果的填充原因 */
+        abortedToolRoundReason?: string;
+        /** 被中断的 assistant（内容/思考）是否保留（core 默认 `drop`） */
+        abortedMessageStrategy?: AbortedMessageStrategy;
     });
 }

package/dist/runtime/SdkAgent.js

@@ -24,6 +24,9 @@ export class SdkAgent extends Agent {
             messages: params.messages,
             tools: params.tools,
             allowJsonParseError: params.allowJsonParseError,
+            abortedToolRoundStrategy: params.abortedToolRoundStrategy,
+            abortedToolRoundReason: params.abortedToolRoundReason,
+            abortedMessageStrategy: params.abortedMessageStrategy,
         });
         this.scope = params.scope;
         this.definition = params.definition;

package/dist/runtime/createAgent.d.ts

@@ -1,5 +1,20 @@
 import { SdkAgent } from "./SdkAgent.js";
 import type { Scope } from "../scope/Scope.js";
+import type { AbortedMessageStrategy, AbortedToolRoundStrategy } from "@ai-zen/agents-core";
+/**
+ * `createAgent` 的可选行为开关（不传则全部沿用 core 默认值）。
+ */
+export interface CreateAgentOptions {
+    /** 工具轮次被中断（或结果不完整）时的归一策略（core 默认 `fill`） */
+    abortedToolRoundStrategy?: AbortedToolRoundStrategy;
+    /** `fill` 策略下，未完成工具结果的填充原因 */
+    abortedToolRoundReason?: string;
+    /**
+     * 被中断的 assistant 消息（已输出的内容 / 思考）如何处置（core 默认 `drop`）。
+     * 传 `keep` 可让模型在下一轮接着半截往下说，而不是忘掉自己说过什么。
+     */
+    abortedMessageStrategy?: AbortedMessageStrategy;
+}
 /**
  * 从磁盘创建 Agent。
  *
@@ -10,4 +25,4 @@ import type { Scope } from "../scope/Scope.js";
  * // agent 是 SdkAgent，可直接注册插件、发送消息
  * ```
  */
-export declare function createAgent(scope: Scope, agentId: string): Promise<SdkAgent>;
+export declare function createAgent(scope: Scope, agentId: string, options?: CreateAgentOptions): Promise<SdkAgent>;

package/dist/runtime/createAgent.js

@@ -11,7 +11,7 @@ import { createModel } from "./createModel.js";
  * // agent 是 SdkAgent，可直接注册插件、发送消息
  * ```
  */
-export async function createAgent(scope, agentId) {
+export async function createAgent(scope, agentId, options = {}) {
     const definition = await new AgentRepository(scope.agentsDir).read(agentId);
     if (!definition)
         throw new Error(`Agent "${agentId}" 不存在`);
@@ -40,6 +40,10 @@ export async function createAgent(scope, agentId) {
         // 快照后，运行时改动只作用于会话副本，模板保持纯净。
         messages: [...(definition.messages ?? [])],
         tools,
+        // 中断相关策略：不传则由 core 取默认值（工具轮次 fill / 消息保留 drop）
+        abortedToolRoundStrategy: options.abortedToolRoundStrategy,
+        abortedToolRoundReason: options.abortedToolRoundReason,
+        abortedMessageStrategy: options.abortedMessageStrategy,
     });
     return agent;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-zen/agents-sdk",
-  "version": "1.0.0-alpha.19",
+  "version": "1.0.0-alpha.20",
   "description": "AI-Zen Agents SDK — shared business logic for CLI and Desktop",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,7 +16,7 @@
   "author": "LZQCN",
   "license": "MIT",
   "dependencies": {
-    "@ai-zen/agents-core": "^4.5.2",
+    "@ai-zen/agents-core": "^4.5.3",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dayjs": "^1.11.21",
     "openai": "^7.5.0"