@downcity/agent 1.1.10 → 1.1.12

package/bin/session/executors/local/SessionExecutionError.js

@@ -0,0 +1,34 @@
+/**
+ * Session 执行错误归一化工具。
+ *
+ * 关键点（中文）
+ * - AI SDK 的最终错误有时只是兜底包装，底层 provider 错误会先从 stream `onError` 暴露。
+ * - LocalSessionCore 只需要消费这里输出的日志字段与最终错误文本。
+ */
+/**
+ * 归一化 stream 错误日志字段。
+ */
+export function summarizeStreamError(error) {
+    const record = error && typeof error === "object" && !Array.isArray(error)
+        ? error
+        : {};
+    const cause = record.cause;
+    return {
+        error: String(error),
+        name: typeof record.name === "string" ? record.name : null,
+        message: typeof record.message === "string" ? record.message : null,
+        cause: cause === undefined ? null : String(cause),
+    };
+}
+/**
+ * 提取实际应返回给上层的错误文本。
+ */
+export function resolveEffectiveExecutionError(params) {
+    const outerError = String(params.error ?? "").trim();
+    const innerError = String(params.streamError ?? "").trim();
+    if (/AI_NoOutputGeneratedError|No output generated/i.test(outerError) && innerError) {
+        return innerError;
+    }
+    return outerError || innerError || "Unknown execution error";
+}
+//# sourceMappingURL=SessionExecutionError.js.map

package/bin/session/executors/local/SessionExecutionError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionExecutionError.js","sourceRoot":"","sources":["../../../../src/session/executors/local/SessionExecutionError.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,MAAM,GACV,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzD,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;QACpB,IAAI,EAAE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAC1D,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QACnE,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KAClD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAS9C;IACC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,gDAAgD,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,UAAU,EAAE,CAAC;QACpF,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,UAAU,IAAI,UAAU,IAAI,yBAAyB,CAAC;AAC/D,CAAC"}

package/bin/session/executors/local/SessionModelMessageState.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Session 模型消息运行态。
+ *
+ * 关键点（中文）
+ * - LocalSessionCore 同时维护 session 语义消息与模型消息。
+ * - 新增 user 消息可优先做增量转换，失败时再回退为全量重算。
+ * - assistant UI 消息只需要进入 session 语义基线；模型侧使用 SDK 返回的 response messages。
+ */
+import type { ModelMessage, Tool } from "ai";
+import type { SessionMessageV1 } from "../../../session/types/SessionMessages.js";
+/**
+ * LocalSessionCore 单轮执行期间的消息基线。
+ */
+export declare class SessionModelMessageState {
+    /**
+     * 当前运行时 session 语义消息。
+     */
+    private sessionMessages;
+    /**
+     * 当前模型侧消息基线。
+     */
+    private currentModelMessages;
+    /**
+     * 当前轮可用工具集合。
+     */
+    private readonly tools;
+    private constructor();
+    /**
+     * 基于初始 session 消息创建运行态。
+     */
+    static create(params: {
+        /**
+         * 初始 session 语义消息。
+         */
+        messages: SessionMessageV1[];
+        /**
+         * 当前轮可用工具集合。
+         */
+        tools: Record<string, Tool>;
+    }): Promise<SessionModelMessageState>;
+    /**
+     * 读取当前模型消息。
+     */
+    get modelMessages(): ModelMessage[];
+    /**
+     * 把 step 间新增的 user 消息并入两份基线。
+     */
+    appendMergedUserMessages(messages: SessionMessageV1[]): Promise<ModelMessage[]>;
+    /**
+     * 追加内部生成的 user nudge 消息。
+     */
+    appendUserTextMessage(message: SessionMessageV1): Promise<void>;
+    /**
+     * 追加 assistant UI 消息到 session 语义基线。
+     */
+    appendRuntimeSessionMessage(message: SessionMessageV1): void;
+    /**
+     * 追加 SDK 返回的模型 response messages。
+     */
+    appendModelMessages(messages: ModelMessage[]): void;
+    private appendSessionMessagesAsModelMessages;
+}
+//# sourceMappingURL=SessionModelMessageState.d.ts.map

package/bin/session/executors/local/SessionModelMessageState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionModelMessageState.d.ts","sourceRoot":"","sources":["../../../../src/session/executors/local/SessionModelMessageState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAM3E;;GAEG;AACH,qBAAa,wBAAwB;IACnC;;OAEG;IACH,OAAO,CAAC,eAAe,CAAqB;IAE5C;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAAiB;IAE7C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAE7C,OAAO;IAmBP;;OAEG;WACU,MAAM,CAAC,MAAM,EAAE;QAC1B;;WAEG;QACH,QAAQ,EAAE,gBAAgB,EAAE,CAAC;QAC7B;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;KAC7B,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAWrC;;OAEG;IACH,IAAI,aAAa,IAAI,YAAY,EAAE,CAElC;IAED;;OAEG;IACG,wBAAwB,CAC5B,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,YAAY,EAAE,CAAC;IAM1B;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;OAEG;IACH,2BAA2B,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAI5D;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;YAKrC,oCAAoC;CAenD"}

package/bin/session/executors/local/SessionModelMessageState.js

@@ -0,0 +1,90 @@
+/**
+ * Session 模型消息运行态。
+ *
+ * 关键点（中文）
+ * - LocalSessionCore 同时维护 session 语义消息与模型消息。
+ * - 新增 user 消息可优先做增量转换，失败时再回退为全量重算。
+ * - assistant UI 消息只需要进入 session 语义基线；模型侧使用 SDK 返回的 response messages。
+ */
+import { pickMergedUserMessages, toModelMessages, } from "../../messages/SessionMessageCodec.js";
+/**
+ * LocalSessionCore 单轮执行期间的消息基线。
+ */
+export class SessionModelMessageState {
+    /**
+     * 当前运行时 session 语义消息。
+     */
+    sessionMessages;
+    /**
+     * 当前模型侧消息基线。
+     */
+    currentModelMessages;
+    /**
+     * 当前轮可用工具集合。
+     */
+    tools;
+    constructor(params) {
+        this.sessionMessages = params.sessionMessages;
+        this.currentModelMessages = params.modelMessages;
+        this.tools = params.tools;
+    }
+    /**
+     * 基于初始 session 消息创建运行态。
+     */
+    static async create(params) {
+        const sessionMessages = Array.isArray(params.messages)
+            ? [...params.messages]
+            : [];
+        return new SessionModelMessageState({
+            sessionMessages,
+            modelMessages: await toModelMessages(sessionMessages, params.tools),
+            tools: params.tools,
+        });
+    }
+    /**
+     * 读取当前模型消息。
+     */
+    get modelMessages() {
+        return this.currentModelMessages;
+    }
+    /**
+     * 把 step 间新增的 user 消息并入两份基线。
+     */
+    async appendMergedUserMessages(messages) {
+        const mergedMessages = pickMergedUserMessages(messages);
+        if (mergedMessages.length === 0)
+            return [];
+        return await this.appendSessionMessagesAsModelMessages(mergedMessages);
+    }
+    /**
+     * 追加内部生成的 user nudge 消息。
+     */
+    async appendUserTextMessage(message) {
+        await this.appendSessionMessagesAsModelMessages([message]);
+    }
+    /**
+     * 追加 assistant UI 消息到 session 语义基线。
+     */
+    appendRuntimeSessionMessage(message) {
+        this.sessionMessages = [...this.sessionMessages, message];
+    }
+    /**
+     * 追加 SDK 返回的模型 response messages。
+     */
+    appendModelMessages(messages) {
+        if (!Array.isArray(messages) || messages.length === 0)
+            return;
+        this.currentModelMessages = [...this.currentModelMessages, ...messages];
+    }
+    async appendSessionMessagesAsModelMessages(messages) {
+        this.sessionMessages = [...this.sessionMessages, ...messages];
+        const modelMessages = await toModelMessages(messages, this.tools);
+        if (modelMessages.length > 0) {
+            this.currentModelMessages = [...this.currentModelMessages, ...modelMessages];
+            return modelMessages;
+        }
+        this.currentModelMessages = await toModelMessages(this.sessionMessages, this.tools);
+        return [];
+    }
+}
+//# sourceMappingURL=SessionModelMessageState.js.map

package/bin/session/executors/local/SessionModelMessageState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionModelMessageState.js","sourceRoot":"","sources":["../../../../src/session/executors/local/SessionModelMessageState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,sBAAsB,EACtB,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAElD;;GAEG;AACH,MAAM,OAAO,wBAAwB;IACnC;;OAEG;IACK,eAAe,CAAqB;IAE5C;;OAEG;IACK,oBAAoB,CAAiB;IAE7C;;OAEG;IACc,KAAK,CAAuB;IAE7C,YAAoB,MAanB;QACC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,aAAa,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MASnB;QACC,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;YACpD,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;YACtB,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,IAAI,wBAAwB,CAAC;YAClC,eAAe;YACf,aAAa,EAAE,MAAM,eAAe,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC;YACnE,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,wBAAwB,CAC5B,QAA4B;QAE5B,MAAM,cAAc,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC3C,OAAO,MAAM,IAAI,CAAC,oCAAoC,CAAC,cAAc,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,OAAyB;QACnD,MAAM,IAAI,CAAC,oCAAoC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,2BAA2B,CAAC,OAAyB;QACnD,IAAI,CAAC,eAAe,GAAG,CAAC,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,QAAwB;QAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC9D,IAAI,CAAC,oBAAoB,GAAG,CAAC,GAAG,IAAI,CAAC,oBAAoB,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,oCAAoC,CAChD,QAA4B;QAE5B,IAAI,CAAC,eAAe,GAAG,CAAC,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC9D,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAClE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,oBAAoB,GAAG,CAAC,GAAG,IAAI,CAAC,oBAAoB,EAAE,GAAG,aAAa,CAAC,CAAC;YAC7E,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,oBAAoB,GAAG,MAAM,eAAe,CAC/C,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,KAAK,CACX,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/bin/session/executors/local/SessionSignals.d.ts

@@ -7,7 +7,7 @@
  * - 目标是让 LocalSessionCore 保持“只看主链路就能理解”的结构。
  */
 import type { SessionMessageV1 } from "../../../session/types/SessionMessages.js";
-import type { JsonObject } from "../../../utils/types/Json.js";
+import type { JsonObject } from "../../../types/common/Json.js";
 /**
  * 单次 tool-loop 允许的最大 step 数。
  */

package/bin/session/executors/local/SessionSignals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionSignals.d.ts","sourceRoot":"","sources":["../../../../src/session/executors/local/SessionSignals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAqDpD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMtD;AAsDD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,CA+BrE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAC3C,UAAU,CA4BZ;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,gBAAgB,GAAG,IAAI,EAC7B,QAAQ,EAAE,gBAAgB,GACzB,gBAAgB,CAmBlB;AAiCD;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,aAAa,EAAE,MAAM,GACpB,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;CACvD,GAAG;IACF,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,CAAC;CACrB,GAAG,IAAI,CAmEP;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,OAAO,GAClB,MAAM,GAAG,IAAI,CAgBf;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAQR"}
+{"version":3,"file":"SessionSignals.d.ts","sourceRoot":"","sources":["../../../../src/session/executors/local/SessionSignals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAqDpD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMtD;AAsDD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,CA+BrE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAC3C,UAAU,CA4BZ;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,gBAAgB,GAAG,IAAI,EAC7B,QAAQ,EAAE,gBAAgB,GACzB,gBAAgB,CAmBlB;AAiCD;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,aAAa,EAAE,MAAM,GACpB,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;CACvD,GAAG;IACF,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,CAAC;CACrB,GAAG,IAAI,CAmEP;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,OAAO,GAClB,MAAM,GAAG,IAAI,CAgBf;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAQR"}

package/bin/session/executors/local/SessionToolLoopRunner.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Session tool-loop runner。
+ *
+ * 关键点（中文）
+ * - 这里只负责已准备好的 `SessionExecuteInput` 如何进入 `streamText` 循环。
+ * - LocalSessionCore 保留入口、重试与输入准备职责，本模块负责 step 循环、续写、恢复和最终日志。
+ * - 运行过程中同时维护 UI assistant 消息、模型消息基线和 step 统计。
+ */
+import { type LanguageModel } from "ai";
+import type { Logger } from "../../../utils/logger/Logger.js";
+import type { SessionExecuteInput, SessionRunResult } from "../../../session/types/SessionRun.js";
+import { SessionHistoryComposer } from "../../composer/history/SessionHistoryComposer.js";
+import { SessionExecutionComposer } from "../../composer/execution/SessionExecutionComposer.js";
+/**
+ * SessionToolLoopRunner 构造参数。
+ */
+export type SessionToolLoopRunnerOptions = {
+    /** 当前模型实例。 */
+    model: LanguageModel;
+    /** 统一日志器。 */
+    logger: Logger;
+    /** 当前会话历史存储。 */
+    historyComposer: SessionHistoryComposer;
+    /** 当前轮运行编排 Composer。 */
+    executionComposer: SessionExecutionComposer;
+    /** 判断错误是否应交给上层 compaction retry。 */
+    shouldCompactOnError: (error: unknown) => boolean;
+};
+/**
+ * 已准备输入的模型/tool-loop 执行器。
+ */
+export declare class SessionToolLoopRunner {
+    private readonly model;
+    private readonly logger;
+    private readonly historyComposer;
+    private readonly executionComposer;
+    private readonly shouldCompactOnError;
+    constructor(options: SessionToolLoopRunnerOptions);
+    /**
+     * 执行一次已装配完成的运行材料。
+     */
+    execute(input: SessionExecuteInput): Promise<SessionRunResult>;
+}
+//# sourceMappingURL=SessionToolLoopRunner.d.ts.map

package/bin/session/executors/local/SessionToolLoopRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionToolLoopRunner.d.ts","sourceRoot":"","sources":["../../../../src/session/executors/local/SessionToolLoopRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qDAAqD,CAAC;AAC7F,OAAO,EAAE,wBAAwB,EAAE,MAAM,yDAAyD,CAAC;AA6BnG;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,cAAc;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,eAAe,EAAE,sBAAsB,CAAC;IACxC,wBAAwB;IACxB,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,oCAAoC;IACpC,oBAAoB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA8B;gBAEvD,OAAO,EAAE,4BAA4B;IAQjD;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA0QrE"}

package/bin/session/executors/local/SessionToolLoopRunner.js

@@ -0,0 +1,261 @@
+/**
+ * Session tool-loop runner。
+ *
+ * 关键点（中文）
+ * - 这里只负责已准备好的 `SessionExecuteInput` 如何进入 `streamText` 循环。
+ * - LocalSessionCore 保留入口、重试与输入准备职责，本模块负责 step 循环、续写、恢复和最终日志。
+ * - 运行过程中同时维护 UI assistant 消息、模型消息基线和 step 统计。
+ */
+import { streamText } from "ai";
+import { buildOpenAIResponsesProviderOptions, } from "../../messages/SessionMessageCodec.js";
+import { logAssistantMessageNow } from "../../messages/SessionMessageLog.js";
+import { MAX_INCOMPLETE_RESPONSE_RECOVERIES, MAX_TEXT_ONLY_CONTINUATIONS, MAX_TOOL_LOOP_STEPS, buildIncompleteResponseRecoveryNudge, buildTextOnlyContinuationNudge, detectIncompleteResponse, detectTextOnlyContinuationReason, mergeAssistantUiMessages, summarizeStepForDebug, summarizeUiMessageForDebug, toInlinePreview, } from "../../executors/local/SessionSignals.js";
+import { evaluateSessionLoopDecision, shouldContinueForTailMergedUserMessages, } from "../../executors/local/SessionLoopDecision.js";
+import { resolveEffectiveExecutionError, summarizeStreamError, } from "../../executors/local/SessionExecutionError.js";
+import { collectFinalAssistantMessageFromUiStream } from "../../executors/local/SessionUiStreamCollector.js";
+import { SessionModelMessageState } from "../../executors/local/SessionModelMessageState.js";
+/**
+ * 已准备输入的模型/tool-loop 执行器。
+ */
+export class SessionToolLoopRunner {
+    model;
+    logger;
+    historyComposer;
+    executionComposer;
+    shouldCompactOnError;
+    constructor(options) {
+        this.model = options.model;
+        this.logger = options.logger;
+        this.historyComposer = options.historyComposer;
+        this.executionComposer = options.executionComposer;
+        this.shouldCompactOnError = options.shouldCompactOnError;
+    }
+    /**
+     * 执行一次已装配完成的运行材料。
+     */
+    async execute(input) {
+        const startTime = Date.now();
+        const sessionId = String(this.historyComposer.sessionId || "").trim();
+        const system = Array.isArray(input.system) ? input.system : [];
+        const tools = input.tools;
+        let lastObservedStreamError = undefined;
+        try {
+            const messageState = await SessionModelMessageState.create({
+                messages: input.messages,
+                tools,
+            });
+            const appendMergedUserMessages = (messages) => messageState.appendMergedUserMessages(messages);
+            const executionComposerOnStepFinish = this.executionComposer.createOnStepFinishHandler();
+            let stepCount = 0;
+            let totalToolCallCount = 0;
+            let totalToolResultCount = 0;
+            const onStepFinish = async (stepResult) => {
+                stepCount += 1;
+                const summary = summarizeStepForDebug(stepResult);
+                totalToolCallCount +=
+                    typeof summary.toolCallCount === "number" ? summary.toolCallCount : 0;
+                totalToolResultCount +=
+                    typeof summary.toolResultCount === "number"
+                        ? summary.toolResultCount
+                        : 0;
+                await this.logger.log("info", "[agent] step.finish", {
+                    sessionId,
+                    stepIndex: stepCount,
+                    ...summary,
+                });
+                await executionComposerOnStepFinish(stepResult);
+            };
+            const prepareStep = this.executionComposer.createPrepareStepHandler({
+                system,
+                appendMergedUserMessages,
+            });
+            let finalAssistantUiMessage = null;
+            let textOnlyContinuationCount = 0;
+            let incompleteResponseRecoveryCount = 0;
+            while (stepCount < MAX_TOOL_LOOP_STEPS) {
+                const result = streamText({
+                    model: this.model,
+                    system,
+                    onStepFinish,
+                    prepareStep,
+                    messages: messageState.modelMessages,
+                    tools,
+                    providerOptions: buildOpenAIResponsesProviderOptions(),
+                    onError: async ({ error }) => {
+                        lastObservedStreamError = error;
+                        await this.logger.log("error", "[agent] stream.error", {
+                            sessionId,
+                            ...summarizeStreamError(error),
+                        });
+                    },
+                });
+                const stepAssistantUiMessage = await collectFinalAssistantMessageFromUiStream({
+                    result,
+                    sessionId,
+                    logger: this.logger,
+                    buildFallbackAssistantMessage: (text) => this.executionComposer.buildFallbackAssistantMessage(text),
+                });
+                const executedSteps = await result.steps;
+                const lastStep = executedSteps[executedSteps.length - 1];
+                if (!lastStep)
+                    break;
+                const incompleteResponse = detectIncompleteResponse({
+                    stepResult: lastStep,
+                    assistantMessage: stepAssistantUiMessage,
+                });
+                const textOnlyContinuationReason = detectTextOnlyContinuationReason(lastStep);
+                const loopDecision = evaluateSessionLoopDecision({
+                    hasIncompleteResponse: incompleteResponse !== null,
+                    incompleteRecoveryCount: incompleteResponseRecoveryCount,
+                    maxIncompleteRecoveries: MAX_INCOMPLETE_RESPONSE_RECOVERIES,
+                    textOnlyContinuationReason,
+                    textOnlyContinuationCount,
+                    maxTextOnlyContinuations: MAX_TEXT_ONLY_CONTINUATIONS,
+                    hasTools: Object.keys(tools).length > 0,
+                    toolCallCount: lastStep.toolCalls.length,
+                });
+                await this.logger.log("info", "[agent] loop.decision", {
+                    sessionId,
+                    stepIndex: stepCount,
+                    continueForToolCalls: loopDecision.continueForToolCalls,
+                    continueForTextOnly: loopDecision.continueForTextOnly,
+                    continueForIncompleteRecovery: loopDecision.continueForIncompleteRecovery,
+                    decisionKind: loopDecision.kind,
+                    textOnlyContinuationReason,
+                    textOnlyContinuationCount,
+                    incompleteResponseReason: incompleteResponse?.reason ?? null,
+                    incompleteResponseRecoveryCount,
+                    toolCallCount: lastStep.toolCalls.length,
+                    toolResultCount: lastStep.toolResults.length,
+                    finishReason: lastStep.finishReason,
+                    textPreview: toInlinePreview(lastStep.text),
+                });
+                if (loopDecision.continueForIncompleteRecovery && incompleteResponse) {
+                    incompleteResponseRecoveryCount += 1;
+                    await this.logger.log("warn", "[agent] incomplete_response.recover", {
+                        sessionId,
+                        stepIndex: stepCount,
+                        recoveryCount: incompleteResponseRecoveryCount,
+                        reason: incompleteResponse.reason,
+                        ...incompleteResponse.details,
+                    });
+                    const recoveryMessage = this.historyComposer.userText({
+                        text: buildIncompleteResponseRecoveryNudge(incompleteResponseRecoveryCount),
+                        metadata: {
+                            sessionId,
+                            extra: {
+                                internal: "agent_incomplete_response_recover",
+                                reason: incompleteResponse.reason,
+                                stepIndex: stepCount,
+                            },
+                        },
+                    });
+                    await messageState.appendUserTextMessage(recoveryMessage);
+                    continue;
+                }
+                if (incompleteResponse) {
+                    await this.logger.log("error", "[agent] incomplete_response", {
+                        sessionId,
+                        stepIndex: stepCount,
+                        reason: incompleteResponse.reason,
+                        recoveryCount: incompleteResponseRecoveryCount,
+                        ...incompleteResponse.details,
+                    });
+                    throw new Error(`Agent received incomplete response (${incompleteResponse.reason})`);
+                }
+                const responseMessages = Array.isArray(lastStep.response?.messages)
+                    ? lastStep.response.messages
+                    : [];
+                messageState.appendModelMessages(responseMessages);
+                finalAssistantUiMessage = mergeAssistantUiMessages(finalAssistantUiMessage, stepAssistantUiMessage);
+                // 关键点（中文）：把本 step 的 assistant UI 消息并入运行时上下文，保证后续全量重算不丢历史。
+                messageState.appendRuntimeSessionMessage(stepAssistantUiMessage);
+                if (loopDecision.continueForToolCalls) {
+                    textOnlyContinuationCount = 0;
+                    incompleteResponseRecoveryCount = 0;
+                    continue;
+                }
+                if (loopDecision.continueForTextOnly) {
+                    textOnlyContinuationCount += 1;
+                    incompleteResponseRecoveryCount = 0;
+                    const continuationMessage = this.historyComposer.userText({
+                        text: buildTextOnlyContinuationNudge(textOnlyContinuationCount),
+                        metadata: {
+                            sessionId,
+                            extra: {
+                                internal: "agent_loop_auto_continue",
+                                reason: textOnlyContinuationReason,
+                                stepIndex: stepCount,
+                            },
+                        },
+                    });
+                    await messageState.appendUserTextMessage(continuationMessage);
+                    continue;
+                }
+                // 关键点（中文）：stop 前做 tail merge，覆盖最后一个 step 后才入队的新 user 消息。
+                const tailPrepared = await prepareStep({ messages: [] });
+                const tailMergedMessageCount = Array.isArray(tailPrepared.messages)
+                    ? tailPrepared.messages.length
+                    : 0;
+                if (shouldContinueForTailMergedUserMessages({
+                    mergedUserMessageCount: tailMergedMessageCount,
+                })) {
+                    textOnlyContinuationCount = 0;
+                    incompleteResponseRecoveryCount = 0;
+                    await this.logger.log("info", "[agent] loop.tail_merge_continue", {
+                        sessionId,
+                        stepIndex: stepCount,
+                        mergedUserMessageCount: tailMergedMessageCount,
+                    });
+                    continue;
+                }
+                break;
+            }
+            if (stepCount >= MAX_TOOL_LOOP_STEPS) {
+                await this.logger.log("warn", "[agent] loop.max_steps_reached", {
+                    sessionId,
+                    stepCount,
+                    totalToolCallCount,
+                    totalToolResultCount,
+                });
+            }
+            const finalMessage = finalAssistantUiMessage ||
+                this.executionComposer.buildFallbackAssistantMessage("Execution completed");
+            await this.logger.log("info", "[agent] final.message", {
+                sessionId,
+                ...summarizeUiMessageForDebug(finalMessage),
+            });
+            await logAssistantMessageNow(this.logger, finalMessage);
+            const duration = Date.now() - startTime;
+            await this.logger.log("info", "[agent] finish", {
+                sessionId,
+                duration,
+                stepCount,
+                totalToolCallCount,
+                totalToolResultCount,
+            });
+            return {
+                success: true,
+                assistantMessage: finalMessage,
+            };
+        }
+        catch (error) {
+            if (this.shouldCompactOnError(error)) {
+                throw error;
+            }
+            const errorMsg = resolveEffectiveExecutionError({
+                error,
+                streamError: lastObservedStreamError,
+            });
+            await this.logger.log("error", "LocalSessionCore execution failed", {
+                error: errorMsg,
+            });
+            return {
+                success: false,
+                error: errorMsg,
+                assistantMessage: this.executionComposer.buildFallbackAssistantMessage(`Execution failed: ${errorMsg}`),
+            };
+        }
+    }
+}
+//# sourceMappingURL=SessionToolLoopRunner.js.map

package/bin/session/executors/local/SessionToolLoopRunner.js.map

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

package/bin/session/executors/local/SessionUiStreamCollector.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Session UI stream 最终消息收敛器。
+ *
+ * 关键点（中文）
+ * - 必须完整消费 AI SDK UI stream，才能稳定触发 `onFinish`。
+ * - 优先使用结构化 `responseMessage`；缺失时才回退到纯文本。
+ * - UI chunk 回调是展示层副作用，失败不应阻断 session 执行。
+ */
+import type { streamText } from "ai";
+import type { Logger } from "../../../utils/logger/Logger.js";
+import type { SessionMessageV1 } from "../../../session/types/SessionMessages.js";
+/**
+ * 收敛 UI stream 中的最终 assistant 消息。
+ */
+export declare function collectFinalAssistantMessageFromUiStream(params: {
+    /**
+     * 当前 `streamText` 执行结果。
+     */
+    result: ReturnType<typeof streamText>;
+    /**
+     * 当前 sessionId，用于日志关联。
+     */
+    sessionId: string;
+    /**
+     * 当前日志器。
+     */
+    logger: Logger;
+    /**
+     * 构造 fallback assistant 消息的工厂函数。
+     */
+    buildFallbackAssistantMessage: (text: string) => SessionMessageV1;
+}): Promise<SessionMessageV1>;
+//# sourceMappingURL=SessionUiStreamCollector.d.ts.map

package/bin/session/executors/local/SessionUiStreamCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionUiStreamCollector.d.ts","sourceRoot":"","sources":["../../../../src/session/executors/local/SessionUiStreamCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAO3E;;GAEG;AACH,wBAAsB,wCAAwC,CAAC,MAAM,EAAE;IACrE;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACtC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,6BAA6B,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,CAAC;CACnE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwD5B"}

package/bin/session/executors/local/SessionUiStreamCollector.js

@@ -0,0 +1,64 @@
+/**
+ * Session UI stream 最终消息收敛器。
+ *
+ * 关键点（中文）
+ * - 必须完整消费 AI SDK UI stream，才能稳定触发 `onFinish`。
+ * - 优先使用结构化 `responseMessage`；缺失时才回退到纯文本。
+ * - UI chunk 回调是展示层副作用，失败不应阻断 session 执行。
+ */
+import { getSessionRunScope } from "../../SessionRunScope.js";
+import { summarizeUiMessageForDebug, toInlinePreview, } from "../../executors/local/SessionSignals.js";
+/**
+ * 收敛 UI stream 中的最终 assistant 消息。
+ */
+export async function collectFinalAssistantMessageFromUiStream(params) {
+    let streamedAssistantMessage = null;
+    let uiFinishSummary = null;
+    const uiStream = params.result.toUIMessageStream({
+        // 关键点（中文）：SDK stream 需要 reasoning 旁路事件时可直接消费；最终落盘仍由 responseMessage 收敛。
+        sendReasoning: true,
+        sendSources: false,
+        onFinish: (event) => {
+            streamedAssistantMessage = event.responseMessage ?? null;
+            uiFinishSummary = {
+                isContinuation: event.isContinuation,
+                isAborted: event.isAborted,
+                finishReason: typeof event.finishReason === "string" ? event.finishReason : null,
+                ...summarizeUiMessageForDebug(event.responseMessage),
+            };
+        },
+    });
+    const onUiMessageChunkCallback = getSessionRunScope()?.onUiMessageChunkCallback;
+    for await (const chunk of uiStream) {
+        if (typeof onUiMessageChunkCallback !== "function")
+            continue;
+        try {
+            await onUiMessageChunkCallback(chunk);
+        }
+        catch {
+            // ignore UI stream callback failures
+        }
+    }
+    await params.logger.log("info", "[agent] ui.finish", {
+        sessionId: params.sessionId,
+        ...(uiFinishSummary || {
+            responseMessageMissing: true,
+        }),
+    });
+    if (streamedAssistantMessage)
+        return streamedAssistantMessage;
+    let assistantText = "";
+    try {
+        assistantText = String((await params.result.text) ?? "").trim();
+    }
+    catch {
+        assistantText = "";
+    }
+    await params.logger.log("warn", "[agent] final.message.fallback", {
+        sessionId: params.sessionId,
+        assistantTextLength: assistantText.length,
+        assistantTextPreview: toInlinePreview(assistantText),
+    });
+    return params.buildFallbackAssistantMessage(assistantText || "Execution completed");
+}
+//# sourceMappingURL=SessionUiStreamCollector.js.map