@downcity/agent 1.1.25 → 1.1.35

package/bin/executor/core-engine/CoreEngineSignals.d.ts

@@ -0,0 +1,72 @@
+/**
+ * SessionLoopSignals：tool-loop 执行循环的信号判断与调试摘要工具。
+ *
+ * 关键点（中文）
+ * - 这里只放“如何判断继续执行 / 如何输出调试摘要”的纯函数。
+ * - 不放 tool-loop 主流程，避免执行内核被大量辅助细节淹没。
+ * - 目标是让 tool-loop 保持“只看主链路就能理解”的结构。
+ */
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+import type { JsonObject } from "../../types/common/Json.js";
+/**
+ * 单次 tool-loop 允许的最大 step 数。
+ */
+export declare const MAX_TOOL_LOOP_STEPS = 64;
+/**
+ * text-only 提醒续跑的最大次数。
+ *
+ * 关键点（中文）
+ * - 仅用于“模型明显承诺下一步、但没有实际调用工具”的兜底。
+ * - 设置较小上限，避免进入无界自催促循环。
+ */
+export declare const MAX_TEXT_ONLY_CONTINUATIONS = 3;
+/**
+ * 不完整响应自动恢复的最大次数。
+ *
+ * 关键点（中文）
+ * - 仅针对 provider 流异常结束这类“本该继续、但响应被截断”的情况。
+ * - 只补一次，避免在 provider 异常持续时进入长时间空转。
+ */
+export declare const MAX_INCOMPLETE_RESPONSE_RECOVERIES = 1;
+/**
+ * 生成日志友好的单行预览文本。
+ */
+export declare function toInlinePreview(value: unknown): string;
+/**
+ * 汇总单个 step 的关键信号，便于定位“为什么没有继续下一轮”。
+ */
+export declare function summarizeStepForDebug(stepResult: unknown): JsonObject;
+/**
+ * 汇总最终 assistant UI 消息的调试摘要。
+ */
+export declare function summarizeUiMessageForDebug(message: SessionMessageV1 | null | undefined): JsonObject;
+/**
+ * 合并多轮 assistant UI 消息。
+ *
+ * 关键点（中文）
+ * - 多 step 场景下，最终 assistant message 需要把各 step 的 UI part 串起来。
+ */
+export declare function mergeAssistantUiMessages(base: SessionMessageV1 | null, incoming: SessionMessageV1): SessionMessageV1;
+/**
+ * 构造“不完整响应恢复”提示。
+ */
+export declare function buildIncompleteResponseRecoveryNudge(recoveryIndex: number): string;
+/**
+ * 检测“响应被中断但模型没有正常完成”的情况。
+ */
+export declare function detectIncompleteResponse(params: {
+    stepResult: unknown;
+    assistantMessage: SessionMessageV1 | null | undefined;
+}): {
+    reason: string;
+    details: JsonObject;
+} | null;
+/**
+ * 检测“只有口头计划，没有真正执行”的续跑信号。
+ */
+export declare function detectTextOnlyContinuationReason(stepResult: unknown): string | null;
+/**
+ * 构造“text-only 续跑”提示。
+ */
+export declare function buildTextOnlyContinuationNudge(continuationIndex: number): string;
+//# sourceMappingURL=CoreEngineSignals.d.ts.map

package/bin/executor/core-engine/CoreEngineSignals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreEngineSignals.d.ts","sourceRoot":"","sources":["../../../src/executor/core-engine/CoreEngineSignals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,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/executor/core-engine/CoreEngineSignals.js.map

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

package/bin/executor/core-engine/CoreEngineUiStreamCollector.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 "../../executor/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=CoreEngineUiStreamCollector.d.ts.map

package/bin/executor/core-engine/CoreEngineUiStreamCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreEngineUiStreamCollector.d.ts","sourceRoot":"","sources":["../../../src/executor/core-engine/CoreEngineUiStreamCollector.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,qCAAqC,CAAC;AAO5E;;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/executor/core-engine/CoreEngineUiStreamCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreEngineUiStreamCollector.js","sourceRoot":"","sources":["../../../src/executor/core-engine/CoreEngineUiStreamCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EACL,0BAA0B,EAC1B,eAAe,GAChB,MAAM,4CAA4C,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAAC,MAiB9D;IACC,IAAI,wBAAwB,GAA4B,IAAI,CAAC;IAC7D,IAAI,eAAe,GAAsB,IAAI,CAAC;IAE9C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAmB;QACjE,wEAAwE;QACxE,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,wBAAwB,GAAG,KAAK,CAAC,eAAe,IAAI,IAAI,CAAC;YACzD,eAAe,GAAG;gBAChB,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,YAAY,EACV,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI;gBACpE,GAAG,0BAA0B,CAAC,KAAK,CAAC,eAAe,CAAC;aACrD,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,wBAAwB,GAC5B,kBAAkB,EAAE,EAAE,wBAAwB,CAAC;IACjD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QACnC,IAAI,OAAO,wBAAwB,KAAK,UAAU;YAAE,SAAS;QAC7D,IAAI,CAAC;YACH,MAAM,wBAAwB,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC;IAED,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,EAAE;QACnD,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,CAAC,eAAe,IAAI;YACrB,sBAAsB,EAAE,IAAI;SAC7B,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,wBAAwB;QAAE,OAAO,wBAAwB,CAAC;IAE9D,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,IAAI,CAAC;QACH,aAAa,GAAG,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,gCAAgC,EAAE;QAChE,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,mBAAmB,EAAE,aAAa,CAAC,MAAM;QACzC,oBAAoB,EAAE,eAAe,CAAC,aAAa,CAAC;KACrD,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,6BAA6B,CACzC,aAAa,IAAI,qBAAqB,CACvC,CAAC;AACJ,CAAC"}

package/bin/executor/ids/resolveSessionId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSessionId.d.ts","sourceRoot":"","sources":["../../../src/executor/ids/resolveSessionId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,GAAG,SAAS,CAQrB"}

package/bin/executor/ids/resolveSessionId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSessionId.js","sourceRoot":"","sources":["../../../src/executor/ids/resolveSessionId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAEhC;IACC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/bin/executor/messages/AssistantResultPersistence.d.ts

@@ -0,0 +1,66 @@
+/**
+ * AssistantResultPersistence：统一处理一次 run 结束后的 assistant 落盘决策。
+ *
+ * 关键点（中文）
+ * - 负责收敛“写完整 assistant message / 写 fallback 文本 / 完全跳过”三种分支。
+ * - 避免 SDK、HTTP execute、control execute、chat queue 各自复制一套判断。
+ * - 一旦 step 消息已经单独持久化，最终 merged assistant 必须跳过，不能再补一条 fallback。
+ */
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+/**
+ * assistant 写入端口。
+ */
+export interface AssistantResultPersistenceWriter {
+    /**
+     * 追加 assistant 消息。
+     */
+    appendAssistantMessage(params: {
+        /**
+         * 已构造好的完整 assistant 消息。
+         */
+        message?: SessionMessageV1 | null;
+        /**
+         * 在没有完整 message 可写时的兜底文本。
+         */
+        fallbackText?: string;
+    }): Promise<void>;
+}
+/**
+ * 一次 run 结束后的 assistant 落盘参数。
+ */
+export interface PersistAssistantResultParams {
+    /**
+     * assistant 写入端口。
+     */
+    writer: AssistantResultPersistenceWriter;
+    /**
+     * 本轮执行得到的 assistant message。
+     */
+    assistantMessage: SessionMessageV1 | null | undefined;
+    /**
+     * 可选兜底文本。
+     *
+     * 关键点（中文）
+     * - 仅在没有完整 assistant message 且未发生 step 持久化时才允许写入。
+     * - 若 step 已单独落盘，这里必须被忽略，避免重复 assistant。
+     */
+    fallbackText?: string;
+}
+/**
+ * 解析本轮 run 最终应该如何持久化 assistant。
+ */
+export declare function buildAssistantResultPersistencePayload(params: Omit<PersistAssistantResultParams, "writer">): {
+    /**
+     * 已构造好的完整 assistant message。
+     */
+    message?: SessionMessageV1 | null;
+    /**
+     * 允许写入的兜底文本。
+     */
+    fallbackText?: string;
+} | null;
+/**
+ * 按统一规则持久化一次 run 的 assistant 结果。
+ */
+export declare function persistAssistantResult(params: PersistAssistantResultParams): Promise<boolean>;
+//# sourceMappingURL=AssistantResultPersistence.d.ts.map

package/bin/executor/messages/AssistantResultPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantResultPersistence.d.ts","sourceRoot":"","sources":["../../../src/executor/messages/AssistantResultPersistence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAM5E;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE;QAC7B;;WAEG;QACH,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAClC;;WAEG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,MAAM,EAAE,gCAAgC,CAAC;IACzC;;OAEG;IACH,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAOD;;GAEG;AACH,wBAAgB,sCAAsC,CACpD,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,QAAQ,CAAC,GACnD;IACD;;OAEG;IACH,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CAoBP;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/bin/executor/messages/AssistantResultPersistence.js

@@ -0,0 +1,48 @@
+/**
+ * AssistantResultPersistence：统一处理一次 run 结束后的 assistant 落盘决策。
+ *
+ * 关键点（中文）
+ * - 负责收敛“写完整 assistant message / 写 fallback 文本 / 完全跳过”三种分支。
+ * - 避免 SDK、HTTP execute、control execute、chat queue 各自复制一套判断。
+ * - 一旦 step 消息已经单独持久化，最终 merged assistant 必须跳过，不能再补一条 fallback。
+ */
+import { hasPersistedAssistantSteps, resolveAssistantMessageForPersistence, } from "../../plugin/builtins/chat/runtime/UserVisibleText.js";
+function normalizeFallbackText(input) {
+    const text = String(input || "").trim();
+    return text || undefined;
+}
+/**
+ * 解析本轮 run 最终应该如何持久化 assistant。
+ */
+export function buildAssistantResultPersistencePayload(params) {
+    const persistedMessage = resolveAssistantMessageForPersistence(params.assistantMessage);
+    if (persistedMessage) {
+        return {
+            message: persistedMessage,
+        };
+    }
+    // 关键点（中文）：step 已经单独落盘时，最终 merged assistant 必须完全跳过。
+    if (hasPersistedAssistantSteps(params.assistantMessage)) {
+        return null;
+    }
+    const fallbackText = normalizeFallbackText(params.fallbackText);
+    if (!fallbackText)
+        return null;
+    return {
+        fallbackText,
+    };
+}
+/**
+ * 按统一规则持久化一次 run 的 assistant 结果。
+ */
+export async function persistAssistantResult(params) {
+    const payload = buildAssistantResultPersistencePayload({
+        assistantMessage: params.assistantMessage,
+        fallbackText: params.fallbackText,
+    });
+    if (!payload)
+        return false;
+    await params.writer.appendAssistantMessage(payload);
+    return true;
+}
+//# sourceMappingURL=AssistantResultPersistence.js.map

package/bin/executor/messages/AssistantResultPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantResultPersistence.js","sourceRoot":"","sources":["../../../src/executor/messages/AssistantResultPersistence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,0BAA0B,EAC1B,qCAAqC,GACtC,MAAM,mDAAmD,CAAC;AA2C3D,SAAS,qBAAqB,CAAC,KAAyB;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,IAAI,IAAI,SAAS,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sCAAsC,CACpD,MAAoD;IAWpD,MAAM,gBAAgB,GAAG,qCAAqC,CAC5D,MAAM,CAAC,gBAAgB,CACxB,CAAC;IACF,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO;YACL,OAAO,EAAE,gBAAgB;SAC1B,CAAC;IACJ,CAAC;IAED,mDAAmD;IACnD,IAAI,0BAA0B,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,qBAAqB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAChE,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO;QACL,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAoC;IAEpC,MAAM,OAAO,GAAG,sCAAsC,CAAC;QACrD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,YAAY,EAAE,MAAM,CAAC,YAAY;KAClC,CAAC,CAAC;IACH,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,MAAM,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/bin/executor/messages/SessionAttachmentMapper.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SessionAttachmentMapper：把 `<file>` 附件描述映射为模型可消费的 file parts。
+ *
+ * 关键点（中文）
+ * - 兼容 Telegram / Feishu / TUI 等统一的 `<file>` 协议入口。
+ * - 仅在本轮执行的内存消息上追加 file parts，不修改持久化历史。
+ * - 当前只为图片与 PDF 注入 file part，保持多模态模型可直接消费。
+ */
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+/**
+ * 在 user 消息上注入 FileUIPart，以便多模态模型直接消费本地附件。
+ */
+export declare function injectFilePartsFromAttachments(messages: SessionMessageV1[]): Promise<SessionMessageV1[]>;
+//# sourceMappingURL=SessionAttachmentMapper.d.ts.map

package/bin/executor/messages/SessionAttachmentMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionAttachmentMapper.d.ts","sourceRoot":"","sources":["../../../src/executor/messages/SessionAttachmentMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AA+C5E;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsF7B"}

package/bin/executor/messages/SessionAttachmentMapper.js

@@ -0,0 +1,145 @@
+/**
+ * SessionAttachmentMapper：把 `<file>` 附件描述映射为模型可消费的 file parts。
+ *
+ * 关键点（中文）
+ * - 兼容 Telegram / Feishu / TUI 等统一的 `<file>` 协议入口。
+ * - 仅在本轮执行的内存消息上追加 file parts，不修改持久化历史。
+ * - 当前只为图片与 PDF 注入 file part，保持多模态模型可直接消费。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { isFileUIPart, isTextUIPart, } from "ai";
+import { parseChatMessageMarkup } from "../../plugin/builtins/chat/runtime/ChatMessageMarkup.js";
+/**
+ * 从 `<file>` 标签中解析附件描述。
+ */
+function parseAttachmentLinesFromText(text) {
+    const raw = String(text || "");
+    if (!raw.trim())
+        return [];
+    return parseChatMessageMarkup(raw).files.map((file) => ({
+        type: file.type,
+        path: file.path,
+        ...(typeof file.caption === "string" && file.caption.trim()
+            ? { caption: file.caption.trim() }
+            : {}),
+    }));
+}
+function guessAttachmentMediaTypeFromPath(filePath) {
+    const ext = (path.extname(filePath) || "").toLowerCase();
+    if (ext === ".png")
+        return "image/png";
+    if (ext === ".jpg" || ext === ".jpeg")
+        return "image/jpeg";
+    if (ext === ".webp")
+        return "image/webp";
+    if (ext === ".gif")
+        return "image/gif";
+    if (ext === ".pdf")
+        return "application/pdf";
+    if (ext === ".zip")
+        return "application/zip";
+    if (ext === ".mp3")
+        return "audio/mpeg";
+    if (ext === ".m4a")
+        return "audio/mp4";
+    if (ext === ".ogg")
+        return "audio/ogg";
+    if (ext === ".opus")
+        return "audio/opus";
+    if (ext === ".mp4")
+        return "video/mp4";
+    if (ext === ".mov")
+        return "video/quicktime";
+    if (ext === ".webm")
+        return "video/webm";
+    if (ext === ".m4v")
+        return "video/x-m4v";
+    return undefined;
+}
+function buildDataUrl(mediaType, buffer) {
+    const base64 = buffer.toString("base64");
+    const safeType = mediaType || "application/octet-stream";
+    return `data:${safeType};base64,${base64}`;
+}
+/**
+ * 在 user 消息上注入 FileUIPart，以便多模态模型直接消费本地附件。
+ */
+export async function injectFilePartsFromAttachments(messages) {
+    if (!Array.isArray(messages) || messages.length === 0)
+        return messages;
+    const cwd = process.cwd();
+    const out = [];
+    for (const message of messages) {
+        if (!message || typeof message !== "object" || message.role !== "user") {
+            out.push(message);
+            continue;
+        }
+        const parts = Array.isArray(message.parts) ? message.parts : [];
+        if (parts.length === 0) {
+            out.push(message);
+            continue;
+        }
+        if (parts.some((part) => isFileUIPart(part))) {
+            out.push(message);
+            continue;
+        }
+        const fullText = parts
+            .map((part) => {
+            const candidate = part;
+            if (!isTextUIPart(candidate))
+                return "";
+            const value = candidate.text;
+            return typeof value === "string" ? value : "";
+        })
+            .filter((text) => text)
+            .join("\n");
+        if (!fullText.trim()) {
+            out.push(message);
+            continue;
+        }
+        const attachments = parseAttachmentLinesFromText(fullText);
+        if (attachments.length === 0) {
+            out.push(message);
+            continue;
+        }
+        const fileParts = [];
+        for (const attachment of attachments) {
+            const mediaTypeGuess = guessAttachmentMediaTypeFromPath(attachment.path);
+            if (!mediaTypeGuess ||
+                (!mediaTypeGuess.startsWith("image/") && mediaTypeGuess !== "application/pdf")) {
+                continue;
+            }
+            const absPath = path.isAbsolute(attachment.path)
+                ? attachment.path
+                : path.resolve(cwd, attachment.path);
+            try {
+                const exists = await fs.pathExists(absPath);
+                if (!exists)
+                    continue;
+                const buffer = await fs.readFile(absPath);
+                const dataUrl = buildDataUrl(mediaTypeGuess, buffer);
+                const filename = path.basename(absPath) || "image";
+                fileParts.push({
+                    type: "file",
+                    mediaType: mediaTypeGuess,
+                    filename,
+                    url: dataUrl,
+                });
+            }
+            catch {
+                continue;
+            }
+        }
+        if (fileParts.length === 0) {
+            out.push(message);
+            continue;
+        }
+        out.push({
+            ...message,
+            parts: [...parts, ...fileParts],
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=SessionAttachmentMapper.js.map

package/bin/executor/messages/SessionAttachmentMapper.js.map

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

package/bin/executor/messages/SessionMessageCodec.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SessionMessageCodec：session message 与模型 message 的转换模块。
+ *
+ * 关键点（中文）
+ * - 只负责消息筛选与模型消息转换。
+ * - 附件注入下沉到 `SessionAttachmentMapper`。
+ * - 日志提取与输出下沉到 `SessionMessageLog`。
+ */
+import { type ModelMessage, type Tool } from "ai";
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+/**
+ * 过滤回调返回值中的 user 文本消息。
+ *
+ * 关键点（中文）
+ * - 用途：从 onStepCallback 返回的消息里挑出可并入推理上下文的 user 文本。
+ * - 输入：任意 SessionMessageV1[]（可能混有 assistant/tool/空消息）。
+ * - 输出：只包含“非空 user 文本”的消息数组。
+ */
+export declare function pickMergedUserMessages(messages: SessionMessageV1[]): SessionMessageV1[];
+/**
+ * 将 context 消息转换为模型消息。
+ *
+ * 关键点（中文）
+ * - 用途：把 UIMessage 语义层数据转成模型可消费的 ModelMessage[]。
+ * - 输入：context 消息数组 + 可用工具集合。
+ * - 输出：可直接喂给 streamText 的 messages。
+ */
+export declare function toModelMessages(messages: SessionMessageV1[], tools: Record<string, Tool>): Promise<ModelMessage[]>;
+/**
+ * 构建 OpenAI Responses providerOptions。
+ *
+ * 关键点（中文）
+ * - 用途：集中声明 provider 级运行选项，避免在主流程内硬编码。
+ * - 当前策略：`store=false`，不在 provider 侧持久化响应。
+ */
+export declare function buildOpenAIResponsesProviderOptions(): {
+    openai: {
+        store: boolean;
+    };
+};
+//# sourceMappingURL=SessionMessageCodec.d.ts.map

package/bin/executor/messages/SessionMessageCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMessageCodec.d.ts","sourceRoot":"","sources":["../../../src/executor/messages/SessionMessageCodec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,IAAI,EAEV,MAAM,IAAI,CAAC;AACZ,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAG5E;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,gBAAgB,EAAE,CA6BpB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC,CAuBzB;AAED;;;;;;GAMG;AACH,wBAAgB,mCAAmC,IAAI;IACrD,MAAM,EAAE;QACN,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;CACH,CAQA"}

package/bin/executor/messages/SessionMessageCodec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMessageCodec.js","sourceRoot":"","sources":["../../../src/executor/messages/SessionMessageCodec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,YAAY,GAIb,MAAM,IAAI,CAAC;AAEZ,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAC;AAE/F;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA4B;IAE5B,iCAAiC;IACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAExC,UAAU;IACV,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QACjC,gBAAgB;QAChB,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE1D,oBAAoB;QACpB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QAE1C,oBAAoB;QACpB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAEhD,8BAA8B;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK;YACxB,oBAAoB;aACnB,MAAM,CAAC,YAAY,CAAC;YACrB,qBAAqB;aACpB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACvC,aAAa;aACZ,IAAI,CAAC,IAAI,CAAC;YACX,UAAU;aACT,IAAI,EAAE,CAAC;QAEV,iBAAiB;QACjB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAA4B,EAC5B,KAA2B;IAE3B,wBAAwB;IACxB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjE,0CAA0C;IAC1C,MAAM,gBAAgB,GAAG,MAAM,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IAExE,0CAA0C;IAC1C,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7C,WAAW;QACX,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QAErC,UAAU;QACV,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,mBAAmB;IACnB,OAAO,MAAM,sBAAsB,CAAC,KAAK,EAAE;QACzC,uBAAuB;QACvB,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,uBAAuB;QACvB,yBAAyB,EAAE,IAAI;KAChC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mCAAmC;IAKjD,sBAAsB;IACtB,OAAO;QACL,MAAM,EAAE;YACN,mBAAmB;YACnB,KAAK,EAAE,KAAK;SACb;KACF,CAAC;AACJ,CAAC"}

package/bin/executor/messages/SessionMessageLog.d.ts

@@ -0,0 +1,19 @@
+/**
+ * SessionMessageLog：assistant 消息日志提取与输出辅助模块。
+ *
+ * 关键点（中文）
+ * - 只负责从 session message 中提取可读文本。
+ * - 只负责把最终 assistant 文本稳定写入统一 logger。
+ * - 不参与模型消息转换，也不感知附件注入逻辑。
+ */
+import type { Logger } from "../../utils/logger/Logger.js";
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+/**
+ * 从 UI message 中提取 assistant 文本部分。
+ */
+export declare function extractAssistantTextForLog(message: SessionMessageV1): string;
+/**
+ * 立即输出 assistant 文本日志。
+ */
+export declare function logAssistantMessageNow(logger: Logger, message: SessionMessageV1): Promise<void>;
+//# sourceMappingURL=SessionMessageLog.d.ts.map

package/bin/executor/messages/SessionMessageLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMessageLog.d.ts","sourceRoot":"","sources":["../../../src/executor/messages/SessionMessageLog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAO5E;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/bin/executor/messages/SessionMessageLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMessageLog.js","sourceRoot":"","sources":["../../../src/executor/messages/SessionMessageLog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAIlC;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAyB;IAClE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7C,OAAO,OAAO,CAAC,KAAK;SACjB,MAAM,CAAC,YAAY,CAAC;SACpB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;SACtC,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAc,EACd,OAAyB;IAEzB,MAAM,IAAI,GAAG,0BAA0B,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,CAAC,eAAe,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/bin/executor/messages/SessionStepEventMapper.d.ts

@@ -0,0 +1,20 @@
+/**
+ * SessionStepEventMapper：把单个 step 结果转成按顺序可持久化的 session 消息。
+ *
+ * 关键点（中文）
+ * - 工具结果使用 AI SDK v6 UI tool part 格式，避免历史重放时丢失 tool result。
+ * - 只做 best-effort 提取，不依赖 provider 私有结构。
+ * - 输出仍然是标准 SessionMessageV1，供 SessionHistoryWriter 直接落盘。
+ */
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+/**
+ * 从 stepResult 提取按顺序落盘的 session assistant 消息。
+ */
+export declare function buildSessionStepEventMessages(params: {
+    sessionId: string;
+    stepIndex: number;
+    stepResult?: unknown;
+    text: string;
+    visibility?: "visible" | "internal";
+}): SessionMessageV1[];
+//# sourceMappingURL=SessionStepEventMapper.d.ts.map

package/bin/executor/messages/SessionStepEventMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStepEventMapper.d.ts","sourceRoot":"","sources":["../../../src/executor/messages/SessionStepEventMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAmH5E;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;CACrC,GAAG,gBAAgB,EAAE,CAiGrB"}

package/bin/executor/messages/SessionStepEventMapper.js.map

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