berry-agent-sdk 0.1.0-alpha.2

package/dist/src/agent/queue.d.ts

@@ -0,0 +1,105 @@
+/**
+ * agent 件 — PendingMessageQueue 待发队列（04 篇 §4：三通道的暂存与合批机制）。
+ *
+ * 两轴分立（本仓 vs berry 蓝本差异④——蓝本只有取件单轴）：
+ *  - QueueMode 取件策略轴：one-at-a-time（缺省，一次取一件）/ all（合批——后台
+ *    唤醒合批收窄工具面即此）；
+ *  - overflowPolicy 容量溢出策略轴：drop-oldest（缺省，丢弃即回执可见不静默
+ *    堆积）/ bounded（排到帽拒新并回执拒收）。
+ * 队列是内存态：崩溃即丢——durable 真相只有已进 timeline 的消息（05 篇）。
+ */
+import type { AgentMessage } from '../contracts/index.js';
+import type { DeliverChannel } from './events.js';
+/** 取件策略轴（04 §4：一次取一件为缺省，合批多件是显式策略） */
+export type QueueMode = 'one-at-a-time' | 'all';
+/** 容量溢出策略轴（04 §4 定值：capacity 缺省 100、缺省策略 drop-oldest） */
+export type OverflowPolicy = 'drop-oldest' | 'bounded';
+/** 队列条目（消息 + 通道判定结果 + 入列时间戳——回执与诊断面用） */
+export interface PendingItem {
+    message: AgentMessage;
+    channel: DeliverChannel;
+    /** Unix 毫秒时间戳（入列时刻） */
+    enqueuedAt: number;
+    /**
+     * 后台唤醒标记（04 §4：发送方声明的 backgroundWake 位随条目入列——
+     * 消费侧（驱动）据此合批与记唤醒预算；队列只承载不判定）。
+     */
+    backgroundWake?: boolean;
+    /**
+     * 撤回关联键（e-4 操控腿 withdraw——03 §2.2 第十一面）：铸造位单归操控
+     * 受理器（栈级自增序列），随 enqueue 入列透传；队列只承载不铸造。
+     * 普通件（submit/steer）无此位——withdraw 只对操控件有意义。
+     */
+    id?: string;
+}
+/** enqueue 回执：accepted=false 时 dropped 载被拒/被丢项（回执面可见，不静默） */
+export interface EnqueueReceipt {
+    accepted: boolean;
+    /** 被丢（drop-oldest）或被拒（bounded）的项 */
+    dropped?: PendingItem;
+}
+/** 队列缺省容量帽（04 §4 定值——码面缺省参数非契约常数，channels 件可再裁） */
+export declare const DEFAULT_QUEUE_CAPACITY = 100;
+/**
+ * 待发队列（机制件——通道判定在驱动侧 conversation，本件只司暂存与取件）。
+ * mode 可运行期调整（合批窗口的开关）；capacity/overflowPolicy 构造期钉死
+ * （溢出语义漂移属配置面变更，不开放热改）。
+ */
+export declare class PendingMessageQueue {
+    /** 待发条目（FIFO；队首最旧） */
+    private readonly items;
+    /** 取件策略（可运行期调整） */
+    private modeValue;
+    /** 容量帽（构造期钉死） */
+    private readonly capacityValue;
+    /** 溢出策略（构造期钉死） */
+    private readonly overflowValue;
+    /**
+     * @param options.mode 取件策略（缺省 one-at-a-time）
+     * @param options.capacity 容量帽（缺省 100；<1 拒构造——空队列是死配置）
+     * @param options.overflowPolicy 溢出策略（缺省 drop-oldest）
+     */
+    constructor(options?: {
+        mode?: QueueMode;
+        capacity?: number;
+        overflowPolicy?: OverflowPolicy;
+    });
+    /** 取件策略（读） */
+    get mode(): QueueMode;
+    /** 取件策略（写——运行期调整面：合批窗口开关） */
+    set mode(mode: QueueMode);
+    /** 当前条目数 */
+    get size(): number;
+    /** 是否有待发条目 */
+    hasItems(): boolean;
+    /**
+     * 入列（溢出按策略执法、回执不静默）。
+     * @param message 待发消息 @param channel 通道判定结果（驱动侧已裁）
+     * @param options.backgroundWake 后台唤醒标记位（随条目透传——消费侧合批/预算面）
+     * @param options.id 撤回关联键（随条目透传——withdraw 消费面；e-4）
+     * @returns 回执：accepted=true 正常入列；false 时 dropped 载被丢/被拒项
+     */
+    enqueue(message: AgentMessage, channel: DeliverChannel, options?: {
+        backgroundWake?: boolean;
+        id?: string;
+    }): EnqueueReceipt;
+    /**
+     * 取件（按 mode：one-at-a-time 取队首一件；all 全取清空）。
+     * @returns 取出的条目（空队列返回空数组）
+     */
+    drain(): PendingItem[];
+    /** 清空（run 收场/会话拆解用；返回被清条目供回执） */
+    clear(): PendingItem[];
+    /**
+     * 在队快照（e-5 操控收口——interrupt 回执 still_queued 数据源）：只读呈报
+     * 不取件不 mutate（与 drain/clear 分立——快照零副作用）。返回浅拷贝数组，
+     * 调用方改写不影响队内真身。
+     */
+    snapshot(): readonly PendingItem[];
+    /**
+     * 在队撤回（e-4 withdraw——03 §2.2 第十一面）：按撤回关联键移除在队件。
+     * @returns 命中返回被移除条目；不在队（已出队被消费/从未入列/已被溢出
+     * 丢弃）返回 undefined——调用方以「已投递」语义诚实呈报。
+     */
+    withdraw(id: string): PendingItem | undefined;
+}

package/dist/src/agent/queue.js

@@ -0,0 +1,120 @@
+/**
+ * agent 件 — PendingMessageQueue 待发队列（04 篇 §4：三通道的暂存与合批机制）。
+ *
+ * 两轴分立（本仓 vs berry 蓝本差异④——蓝本只有取件单轴）：
+ *  - QueueMode 取件策略轴：one-at-a-time（缺省，一次取一件）/ all（合批——后台
+ *    唤醒合批收窄工具面即此）；
+ *  - overflowPolicy 容量溢出策略轴：drop-oldest（缺省，丢弃即回执可见不静默
+ *    堆积）/ bounded（排到帽拒新并回执拒收）。
+ * 队列是内存态：崩溃即丢——durable 真相只有已进 timeline 的消息（05 篇）。
+ */
+/** 队列缺省容量帽（04 §4 定值——码面缺省参数非契约常数，channels 件可再裁） */
+export const DEFAULT_QUEUE_CAPACITY = 100;
+/**
+ * 待发队列（机制件——通道判定在驱动侧 conversation，本件只司暂存与取件）。
+ * mode 可运行期调整（合批窗口的开关）；capacity/overflowPolicy 构造期钉死
+ * （溢出语义漂移属配置面变更，不开放热改）。
+ */
+export class PendingMessageQueue {
+    /** 待发条目（FIFO；队首最旧） */
+    items = [];
+    /** 取件策略（可运行期调整） */
+    modeValue;
+    /** 容量帽（构造期钉死） */
+    capacityValue;
+    /** 溢出策略（构造期钉死） */
+    overflowValue;
+    /**
+     * @param options.mode 取件策略（缺省 one-at-a-time）
+     * @param options.capacity 容量帽（缺省 100；<1 拒构造——空队列是死配置）
+     * @param options.overflowPolicy 溢出策略（缺省 drop-oldest）
+     */
+    constructor(options) {
+        this.modeValue = options?.mode ?? 'one-at-a-time';
+        this.capacityValue = options?.capacity ?? DEFAULT_QUEUE_CAPACITY;
+        this.overflowValue = options?.overflowPolicy ?? 'drop-oldest';
+        if (!Number.isInteger(this.capacityValue) || this.capacityValue < 1) {
+            throw new RangeError(`capacity 须为正整数，收到 ${this.capacityValue}——空队列是死配置`);
+        }
+    }
+    /** 取件策略（读） */
+    get mode() {
+        return this.modeValue;
+    }
+    /** 取件策略（写——运行期调整面：合批窗口开关） */
+    set mode(mode) {
+        this.modeValue = mode;
+    }
+    /** 当前条目数 */
+    get size() {
+        return this.items.length;
+    }
+    /** 是否有待发条目 */
+    hasItems() {
+        return this.items.length > 0;
+    }
+    /**
+     * 入列（溢出按策略执法、回执不静默）。
+     * @param message 待发消息 @param channel 通道判定结果（驱动侧已裁）
+     * @param options.backgroundWake 后台唤醒标记位（随条目透传——消费侧合批/预算面）
+     * @param options.id 撤回关联键（随条目透传——withdraw 消费面；e-4）
+     * @returns 回执：accepted=true 正常入列；false 时 dropped 载被丢/被拒项
+     */
+    enqueue(message, channel, options) {
+        const item = {
+            message,
+            channel,
+            enqueuedAt: Date.now(),
+            ...(options?.backgroundWake !== undefined ? { backgroundWake: options.backgroundWake } : {}),
+            ...(options?.id !== undefined ? { id: options.id } : {}),
+        };
+        if (this.items.length < this.capacityValue) {
+            this.items.push(item);
+            return { accepted: true };
+        }
+        if (this.overflowValue === 'bounded') {
+            // 有界排队腿：排到帽拒新——拒收项原样回执（调用方告知用户）
+            return { accepted: false, dropped: item };
+        }
+        // drop-oldest 腿：丢队首腾位（丢弃可见——被丢项回执给调用方）
+        const dropped = this.items.shift();
+        this.items.push(item);
+        return { accepted: true, dropped };
+    }
+    /**
+     * 取件（按 mode：one-at-a-time 取队首一件；all 全取清空）。
+     * @returns 取出的条目（空队列返回空数组）
+     */
+    drain() {
+        if (this.items.length === 0)
+            return [];
+        if (this.modeValue === 'all') {
+            return this.items.splice(0, this.items.length);
+        }
+        return [this.items.shift()];
+    }
+    /** 清空（run 收场/会话拆解用；返回被清条目供回执） */
+    clear() {
+        return this.items.splice(0, this.items.length);
+    }
+    /**
+     * 在队快照（e-5 操控收口——interrupt 回执 still_queued 数据源）：只读呈报
+     * 不取件不 mutate（与 drain/clear 分立——快照零副作用）。返回浅拷贝数组，
+     * 调用方改写不影响队内真身。
+     */
+    snapshot() {
+        return [...this.items];
+    }
+    /**
+     * 在队撤回（e-4 withdraw——03 §2.2 第十一面）：按撤回关联键移除在队件。
+     * @returns 命中返回被移除条目；不在队（已出队被消费/从未入列/已被溢出
+     * 丢弃）返回 undefined——调用方以「已投递」语义诚实呈报。
+     */
+    withdraw(id) {
+        const index = this.items.findIndex((item) => item.id === id);
+        if (index === -1)
+            return undefined;
+        return this.items.splice(index, 1)[0];
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/src/agent/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../../../src/agent/queue.ts"],"names":[],"mappings":"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"}

package/dist/src/agent/stream.d.ts

@@ -0,0 +1,21 @@
+/**
+ * agent 件 — 流消费辅助（loop 骨架的内层腿；04 §2 双 while 的内层本体）。
+ *
+ * 组装序（承蓝本）：convertToLlm 全量转写 → transformContext 最后关口 →
+ * getApiKey → streamFn（永不抛——错误编码为流终值）→ 迭代（start 占位入列、
+ * delta 就地替换、终值 result() 落位）。partial 就地替换：流中每事件的
+ * partial 即累计快照，尾元素直接替换即活体更新——不重建数组。
+ * 终值落位判占位在场（04 §3 定形）：error 终值可无 start 前导（provider 前置
+ * 失败形），未见 start 时终值走 append——无条件尾替换会覆写上一条活消息。
+ */
+import type { AssistantMessage } from '../contracts/index.js';
+import type { AgentContext, AgentLoopConfig, EmitFn } from './types.js';
+/**
+ * 单轮流式请求：从 context 组装 LlmContext、消费流、终值落位并回推。
+ *
+ * @param config loop 配置（convertToLlm/transformContext/getApiKey/streamFn 消费面）
+ * @param context 运行上下文（messages 活数组——assistant 占位与终值都入列）
+ * @param emit 活体事件发射器
+ * @returns 终值消息（stopReason=error/aborted 时错误即数据——loop 按终态短路）
+ */
+export declare function streamAssistantResponse(config: AgentLoopConfig, context: AgentContext, emit: EmitFn): Promise<AssistantMessage>;

package/dist/src/agent/stream.js

@@ -0,0 +1,80 @@
+/**
+ * agent 件 — 流消费辅助（loop 骨架的内层腿；04 §2 双 while 的内层本体）。
+ *
+ * 组装序（承蓝本）：convertToLlm 全量转写 → transformContext 最后关口 →
+ * getApiKey → streamFn（永不抛——错误编码为流终值）→ 迭代（start 占位入列、
+ * delta 就地替换、终值 result() 落位）。partial 就地替换：流中每事件的
+ * partial 即累计快照，尾元素直接替换即活体更新——不重建数组。
+ * 终值落位判占位在场（04 §3 定形）：error 终值可无 start 前导（provider 前置
+ * 失败形），未见 start 时终值走 append——无条件尾替换会覆写上一条活消息。
+ */
+/**
+ * 单轮流式请求：从 context 组装 LlmContext、消费流、终值落位并回推。
+ *
+ * @param config loop 配置（convertToLlm/transformContext/getApiKey/streamFn 消费面）
+ * @param context 运行上下文（messages 活数组——assistant 占位与终值都入列）
+ * @param emit 活体事件发射器
+ * @returns 终值消息（stopReason=error/aborted 时错误即数据——loop 按终态短路）
+ */
+export async function streamAssistantResponse(config, context, emit) {
+    // ① convertToLlm 全量转写（null = 剥离不进上下文；数组 = 一拆多）
+    const messages = [];
+    for (const message of context.messages) {
+        const converted = config.convertToLlm(message);
+        if (converted === null)
+            continue;
+        if (Array.isArray(converted))
+            messages.push(...converted);
+        else
+            messages.push(converted);
+    }
+    let llmContext = {
+        systemPrompt: context.systemPrompt,
+        messages,
+        tools: context.tools?.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+        })),
+    };
+    // ② transformContext 最后关口（记忆检索瞬态注入位）
+    if (config.transformContext)
+        llmContext = await config.transformContext(llmContext);
+    // ③ 凭证取用 + ④ 流式调用（永不抛契约——一切失败在流终值里）
+    const stream = await config.streamFn(llmContext, { model: config.model, thinkingLevel: config.thinkingLevel, apiKey: config.getApiKey?.(config.model) }, config.signal);
+    // ⑤ 消费流：start 占位入列 → 带 partial 事件就地替换尾 → 终值 result() 落位。
+    // sawStart 追踪（04 §3 定形）：error 终值可无 start 前导——provider 前置失败形
+    // （pi-ai 请求创建失败 catch 路径只发 error 不发 start），「start 先行」非流的
+    // 隐含序约束；终值落位据此判占位在场。
+    let sawStart = false;
+    for await (const event of stream) {
+        if (event.type === 'start') {
+            sawStart = true;
+            context.messages.push(event.partial);
+            emit({ type: 'message_start', role: 'assistant' });
+        }
+        else if (event.type === 'done' || event.type === 'error') {
+            break; // 终值统一走 result()（流协议：done/error 后迭代自然收尾）
+        }
+        else {
+            // 各内容块事件的 partial 均为累计快照——就地替换尾元素即活体更新
+            context.messages[context.messages.length - 1] = event.partial;
+            emit({ type: 'message_update', role: 'assistant', partial: event.partial });
+        }
+    }
+    const final = await stream.result();
+    if (sawStart) {
+        // 正常形：占位在场——终值就地替换占位
+        context.messages[context.messages.length - 1] = final;
+    }
+    else {
+        // 无 start 前导形：无占位可替换——终值走 append（无条件尾替换会覆写上一条
+        // 活消息：种子 user 消息被 error assistant 顶替即此形），并补发配对
+        // message_start（否则 message_end 裸奔——活体事件序违例与覆写同源）
+        context.messages.push(final);
+        emit({ type: 'message_start', role: 'assistant' });
+    }
+    emit({ type: 'message_end', message: final });
+    return final;
+}
+//# sourceMappingURL=stream.js.map

package/dist/src/agent/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../../../src/agent/stream.ts"],"names":[],"mappings":"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"}

package/dist/src/agent/tools-batch.d.ts

@@ -0,0 +1,49 @@
+/**
+ * agent 件 — 工具批执行器（loop 骨架的工具腿；04 §2 批语义的执法位）。
+ *
+ * 本件是 loop 零 try/catch 形态铁律的配套执法位：插件工具 execute 可抛错，
+ * 包装在此（错误 → isError 结果数据面），loop 骨架只见结果不见异常。
+ * 批语义六条：①单响应护栏两闸（04 §2——消费序前插 limiter，零改 loop
+ * 骨架）：call_id 幂等（同 id 重放不重执行——批内/跨轮/重试续入三域同律，
+ * 账本挂 context）+ 批调用数上限（超帽丢尾配对 isError + 计数暴露）；
+ * ②读写批调度（03 §2.3 尾注——effect 一位两用）：read（含缺省）段内并发、
+ * write 批边界串行（写前清空在飞只读——段序天然执法：write 前的 read 段已
+ * Promise.all 排干、write 后的 read 段待其结算才起跑）；③beforeToolCall
+ * block → immediate isError 结果；④terminate 批内一致裁决（批内全
+ * terminate 才 terminate——单件否决不放大；回执腿/中止配对腿/丢尾腿非执行
+ * 腿不否决——空真通过与批内任何真实执行腿的 false 一票即续跑，纯非执行
+ * 批恒 terminate 停跑——重放循环卡死的兜底）；⑤abort 余量配对（落批中
+ * 间时未执行 calls 逐个配对 isError toolResult，防下一轮孤儿 toolUse）。
+ */
+import type { ToolResultMessage } from '../contracts/index.js';
+import type { AgentToolCall } from '../contracts/index.js';
+import type { AgentContext, AgentLoopConfig, EmitFn } from './types.js';
+/** 单响应工具批调用数上限缺省值（04 §2 闸②——帽常量可配置：AgentLoopConfig.maxToolCallsPerResponse） */
+export declare const DEFAULT_MAX_TOOL_CALLS_PER_RESPONSE = 32;
+/** 批执行结算：结果消息（与 calls 恒配对——含 block/isError/中止配对/回执/丢尾腿）+ 批内一致 terminate */
+export interface ToolBatchOutcome {
+    results: ToolResultMessage[];
+    /** 批内全 terminate 才 true（04 §2 批内一致裁决；非执行腿〔回执/中止配对/丢尾〕不否决——空真通过：纯非执行批恒 true 停跑〔重放循环兜底〕、批内任一真实执行腿 false 即续跑） */
+    terminate: boolean;
+    /** 闸②丢尾计数（04 §2——被超帽丢弃的条数，非静默暴露；被丢 legs 已在 results 内逐条 isError 配对） */
+    droppedCount: number;
+}
+/**
+ * 执行一批工具调用（单响应护栏两闸 + 读写批调度 + abort 余量配对 + 批内一致 terminate）。
+ *
+ * 护栏两闸（04 §2，消费序前插——零改 loop 骨架）：闸②批调用数上限——超帽
+ * 丢尾（被丢 calls 逐个 isError 配对 + 计数暴露；丢尾腿不进账本——未执行
+ * 条目无「既有结果」，模型重发该 id 时按新调用执行）；闸①call_id 幂等——
+ * 账本（context.toolResultLedger，driver 终身单实例）与批内首现双命中均走
+ * 回执腿（直接回既有结果，不重执行、不发执行活体事件、不参与 terminate
+ * 表决——strix wait→check 轮询防回归锁）。
+ *
+ * 调度（03 §2.3 尾注——effect 一位两用的消费执法）：按原序切段——连续 read
+ * 调用成一段（段内并发 Promise.all）、write 调用独立成段（单件串行屏障：
+ * 写前清空在飞只读、写后 read 待其结算）。工具不在场（lookup 失败）视同
+ * read 入段——executeOne 自会回配置漂移 isError，不影响调度归类。
+ *
+ * @param config loop 配置 @param context 运行上下文 @param calls assistant 批内全部调用
+ * @param emit 活体事件发射器
+ */
+export declare function executeToolBatch(config: AgentLoopConfig, context: AgentContext, calls: AgentToolCall[], emit: EmitFn): Promise<ToolBatchOutcome>;

package/dist/src/agent/tools-batch.js

@@ -0,0 +1,222 @@
+/**
+ * agent 件 — 工具批执行器（loop 骨架的工具腿；04 §2 批语义的执法位）。
+ *
+ * 本件是 loop 零 try/catch 形态铁律的配套执法位：插件工具 execute 可抛错，
+ * 包装在此（错误 → isError 结果数据面），loop 骨架只见结果不见异常。
+ * 批语义六条：①单响应护栏两闸（04 §2——消费序前插 limiter，零改 loop
+ * 骨架）：call_id 幂等（同 id 重放不重执行——批内/跨轮/重试续入三域同律，
+ * 账本挂 context）+ 批调用数上限（超帽丢尾配对 isError + 计数暴露）；
+ * ②读写批调度（03 §2.3 尾注——effect 一位两用）：read（含缺省）段内并发、
+ * write 批边界串行（写前清空在飞只读——段序天然执法：write 前的 read 段已
+ * Promise.all 排干、write 后的 read 段待其结算才起跑）；③beforeToolCall
+ * block → immediate isError 结果；④terminate 批内一致裁决（批内全
+ * terminate 才 terminate——单件否决不放大；回执腿/中止配对腿/丢尾腿非执行
+ * 腿不否决——空真通过与批内任何真实执行腿的 false 一票即续跑，纯非执行
+ * 批恒 terminate 停跑——重放循环卡死的兜底）；⑤abort 余量配对（落批中
+ * 间时未执行 calls 逐个配对 isError toolResult，防下一轮孤儿 toolUse）。
+ */
+import { BaseError, redactSensitiveText } from '../contracts/index.js';
+/** 单响应工具批调用数上限缺省值（04 §2 闸②——帽常量可配置：AgentLoopConfig.maxToolCallsPerResponse） */
+export const DEFAULT_MAX_TOOL_CALLS_PER_RESPONSE = 32;
+/**
+ * 组装一条工具结果消息（block/错误/中止配对/正常四腿共用的组装面）。
+ *
+ * 出口治理③ 定形③（04 §7）：错误/拒绝腿文本在此单一扼点同过模式消毒
+ * （正常腿由管道链尾消毒——本位幂等不重复）。agent 侧无活值 provider
+ * （值基腿只在管道），纯模式腿覆盖具名形。
+ *
+ * @param call 配对的 toolCall 块 @param content 文本腿 @param isError 错误标记
+ * @param details 结构化明细（可选）
+ */
+function buildResult(call, content, isError, details) {
+    return {
+        role: 'toolResult',
+        toolCallId: call.id,
+        toolName: call.name,
+        content: [{ type: 'text', text: redactSensitiveText(content) }],
+        isError,
+        timestamp: Date.now(),
+        ...(details !== undefined ? { details } : {}),
+    };
+}
+/**
+ * 执行单条工具调用（含 beforeToolCall 守门、执行体替换、迟到进度丢弃、
+ * execute 抛错包装、afterToolCall 字段级整体替换）。
+ */
+async function executeOne(config, context, tool, call, emit) {
+    emit({ type: 'tool_execution_start', toolCallId: call.id, name: call.name, arguments: call.arguments });
+    // 工具不在场：结果数据面直接回错（工具清单在 run 内静态——不可达名即配置漂移）
+    if (!tool) {
+        const message = buildResult(call, `工具 ${call.name} 不在本 run 工具集（配置漂移——清单与调用不同源）`, true);
+        emit({ type: 'tool_execution_end', toolCallId: call.id, result: { content: message.content, isError: true } });
+        return { message, terminate: false };
+    }
+    // 守门行安装点：block 拒因 → immediate isError 结果（不执行）
+    const decision = (await config.beforeToolCall?.(call, context)) ?? {};
+    if (decision.block !== undefined) {
+        const message = buildResult(call, decision.block, true);
+        emit({ type: 'tool_execution_end', toolCallId: call.id, result: { content: message.content, isError: true } });
+        return { message, terminate: decision.terminate === true };
+    }
+    // 参数预处理（执行前最后一改参数的机会）
+    const args = tool.prepareArguments ? await tool.prepareArguments(call.arguments) : call.arguments;
+    // 迟到进度丢弃：promise 结算后 onUpdate 静默（accepting 旗——终值已落，迟到腿不重放）
+    let accepting = true;
+    const onUpdate = (update) => {
+        if (accepting)
+            emit({ type: 'tool_execution_update', toolCallId: call.id, update });
+    };
+    let result;
+    try {
+        // 执行体替换点（测试注金样 seam）；缺省走 tool.execute（signal 协作面透传）
+        result = config.toolExecution
+            ? await config.toolExecution(tool, call.id, args, config.signal, onUpdate)
+            : await tool.execute(call.id, args, config.signal, onUpdate);
+    }
+    catch (err) {
+        // 插件工具抛错包装位（loop 零 try/catch 的配套——错误转数据面）；错误
+        // 文本可能携出工具内部秘密（stderr env dump / 含 token 的 URL 报错）——
+        // 同过模式消毒（出口治理③ 定形③：与 buildResult 同一出口语义）
+        const text = err instanceof BaseError ? `${err.code}: ${err.message}` : String(err);
+        result = {
+            content: [{ type: 'text', text: redactSensitiveText(`工具 ${call.name} 执行异常：${text}`) }],
+            isError: true,
+        };
+    }
+    finally {
+        accepting = false;
+    }
+    // 结果组装（一次到位：正常腿与错误腿同形——错误是数据契约之一）
+    let message = {
+        role: 'toolResult',
+        toolCallId: call.id,
+        toolName: call.name,
+        content: result.content,
+        isError: result.isError === true,
+        timestamp: Date.now(),
+        ...(result.details !== undefined ? { details: result.details } : {}),
+        ...(result.usage !== undefined ? { usage: result.usage } : {}),
+        ...(result.addedToolNames !== undefined ? { addedToolNames: result.addedToolNames } : {}),
+    };
+    // 后置钩子：字段级整体替换（返回新消息替换默认组装形）
+    const replaced = await config.afterToolCall?.(call, result, message, context);
+    if (replaced !== undefined && replaced !== null)
+        message = replaced;
+    emit({ type: 'tool_execution_end', toolCallId: call.id, result });
+    return { message, terminate: result.terminate === true };
+}
+/**
+ * 执行一批工具调用（单响应护栏两闸 + 读写批调度 + abort 余量配对 + 批内一致 terminate）。
+ *
+ * 护栏两闸（04 §2，消费序前插——零改 loop 骨架）：闸②批调用数上限——超帽
+ * 丢尾（被丢 calls 逐个 isError 配对 + 计数暴露；丢尾腿不进账本——未执行
+ * 条目无「既有结果」，模型重发该 id 时按新调用执行）；闸①call_id 幂等——
+ * 账本（context.toolResultLedger，driver 终身单实例）与批内首现双命中均走
+ * 回执腿（直接回既有结果，不重执行、不发执行活体事件、不参与 terminate
+ * 表决——strix wait→check 轮询防回归锁）。
+ *
+ * 调度（03 §2.3 尾注——effect 一位两用的消费执法）：按原序切段——连续 read
+ * 调用成一段（段内并发 Promise.all）、write 调用独立成段（单件串行屏障：
+ * 写前清空在飞只读、写后 read 待其结算）。工具不在场（lookup 失败）视同
+ * read 入段——executeOne 自会回配置漂移 isError，不影响调度归类。
+ *
+ * @param config loop 配置 @param context 运行上下文 @param calls assistant 批内全部调用
+ * @param emit 活体事件发射器
+ */
+export async function executeToolBatch(config, context, calls, emit) {
+    // 闸②批调用数上限：单响应批超帽丢尾（缺省 32；负值归 0——0 即拒全批）
+    const cap = Math.max(0, config.maxToolCallsPerResponse ?? DEFAULT_MAX_TOOL_CALLS_PER_RESPONSE);
+    const droppedCount = Math.max(0, calls.length - cap);
+    const outcome = { results: [], terminate: false, droppedCount };
+    // 三分类预演（保序——结果按 calls 原序落位）：dropped = 超帽丢尾（不进调度
+    // 不进账本）；replay = 账本命中或批内首现之后的同 id 重现（回执腿）；
+    // dispatch = 首达执行腿
+    const ledger = (context.toolResultLedger ??= new Map()); // 闸①首达建账
+    const seenInBatch = new Set();
+    const kinds = calls.map((call, i) => {
+        if (i >= cap)
+            return 'dropped';
+        if (ledger.has(call.id) || seenInBatch.has(call.id))
+            return 'replay';
+        seenInBatch.add(call.id);
+        return 'dispatch';
+    });
+    let allTerminate = true;
+    let index = 0;
+    while (index < calls.length) {
+        // 段前中止检查：已中止 → 余量全部配对 isError 收口（无孤儿 toolUse；配对腿不参与 terminate 表决——与旧串行路径同律）
+        if (config.signal?.aborted) {
+            for (const call of calls.slice(index)) {
+                outcome.results.push(buildResult(call, '工具批已被打断（run 中止——余量配对收口）', true));
+            }
+            outcome.terminate = calls.length > 0 && allTerminate;
+            return outcome;
+        }
+        // 非执行腿排干（保序内联，切段）：回执腿 = 账本既有结果直接回执（拷贝重铸
+        // 配对键——同 id 多块 toolUse 各得一条）；丢尾腿 = 超帽 isError 配对
+        while (index < calls.length && kinds[index] !== 'dispatch') {
+            const call = calls[index];
+            if (kinds[index] === 'replay') {
+                outcome.results.push(replayOf(call, ledger.get(call.id)));
+            }
+            else {
+                outcome.results.push(buildResult(call, `单响应工具批超上限 ${cap} 条——丢尾收口（本条未执行；请减少单次响应内的工具调用量）`, true));
+            }
+            index++;
+        }
+        if (index >= calls.length)
+            break; // 排干到尾（余量全是非执行腿——收尾）
+        // 连续 read 段（effect=read 并行档——2026-09-11 审批分档批三值扩后唯一
+        // 并行档；write|exec 均串行屏障。工具不在场腿留在本段〔执行期报不在场
+        // 错——缺席非声明，与「在场未声明 = exec 最危」的注册面归一分立〕；
+        // 非执行腿切段）
+        const segment = [];
+        while (index < calls.length && kinds[index] === 'dispatch') {
+            const found = lookup(context, calls[index]);
+            // 并行仅限显式 read：write/exec（及在场未声明的最危归一形）一律出局走屏障腿
+            if (found !== undefined && found.effect !== 'read')
+                break;
+            segment.push(calls[index]);
+            index++;
+        }
+        if (segment.length > 0) {
+            // read 段内并发（03 §2.3「批内可并行调度」）；结果按 calls 原序落位（Promise.all 保序）
+            const settled = await Promise.all(segment.map((call) => executeOne(config, context, lookup(context, call), call, emit)));
+            for (let i = 0; i < settled.length; i++) {
+                const item = settled[i];
+                outcome.results.push(item.message);
+                ledger.set(segment[i].id, item.message); // 执行后入账（后续重放回执；段内 id 已去重）
+                allTerminate = allTerminate && item.terminate;
+            }
+            continue;
+        }
+        // write/exec 屏障腿：单件串行（写前清空在飞只读——前 read 段已排干；
+        // 屏障后 read 段待本腿结算。03 §2.3 尾注读写调度语义：write|exec 批边界
+        // 串行——审批分档批三值扩同律）
+        const writeCall = calls[index];
+        index++;
+        const settled = await executeOne(config, context, lookup(context, writeCall), writeCall, emit);
+        outcome.results.push(settled.message);
+        ledger.set(writeCall.id, settled.message); // 执行后入账（后续重放回执）
+        allTerminate = allTerminate && settled.terminate;
+    }
+    // 空批不终止；回执腿/丢尾腿不否决（空真通过与中止配对腿同律）——纯非执行
+    // 批（全回执/全丢尾）恒 terminate：停跑正是重放循环卡死的兜底（strix 病理
+    // 下继续跑 = 模型每轮空转重放烧 token；批内只要有一条真实执行腿投 false
+    // 即续跑）
+    outcome.terminate = calls.length > 0 && allTerminate;
+    return outcome;
+}
+/**
+ * 回执腿组装（04 §2 闸①）：既有结果的回执拷贝——内容/错误位与原结果一致，
+ * 配对键与工具名重铸为本次 call（回执也是配对——防孤儿 toolUse 同律）。
+ * @param call 本次重放的调用块 @param cached 账本内既有结果消息
+ */
+function replayOf(call, cached) {
+    return { ...cached, toolCallId: call.id, toolName: call.name, timestamp: Date.now() };
+}
+/** 按名查工具（批内 lookup 单源） */
+function lookup(context, call) {
+    return context.tools?.find((t) => t.name === call.name);
+}
+//# sourceMappingURL=tools-batch.js.map

package/dist/src/agent/tools-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-batch.js","sourceRoot":"","sources":["../../../../../src/agent/tools-batch.ts"],"names":[],"mappings":"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"}