@ynhcj/xiaoyi-channel 0.0.159-beta → 0.0.159-next

package/dist/src/tools/get-device-file-tool-schema.js

@@ -2,14 +2,13 @@ import { createSchemaTool } from "./schema-tool-factory.js";
 import { createSearchFileTool } from "./search-file-tool.js";
 import { createUploadFileTool } from "./upload-file-tool.js";
 import { createSaveFileToPhoneTool } from "./save-file-to-phone-tool.js";
-import { createFindPcDevicesTool } from "./find-pc-devices-tool.js";
 export function createGetDeviceFileToolSchemaTool(ctx) {
     const searchFileTool = createSearchFileTool(ctx);
     const saveFileToPhoneTool = createSaveFileToPhoneTool(ctx);
     return createSchemaTool({
         name: "get_device_file_tool_schema",
         label: "Get Device File Tool Schema",
-        description: "获取可在用户设备上搜索文件系统的文件、将用户设备本地文件上传到公网并获取链接、保存文件到文件管理器、查找PC设备的相关端工具列表。",
-        tools: [searchFileTool, createUploadFileTool(ctx), saveFileToPhoneTool, createFindPcDevicesTool(ctx)],
+        description: "获取可在用户设备上搜索文件系统的文件、将用户设备本地文件上传到公网并获取链接、保存文件到文件管理器的相关端工具列表。",
+        tools: [searchFileTool, createUploadFileTool(ctx), saveFileToPhoneTool],
     });
 }

package/dist/src/tools/location-tool.js

@@ -75,7 +75,7 @@ export function createLocationTool(ctx) {
                             });
                         }
                         else {
-                            reject(new Error(`获取位置失败: ${event.status}`));
+                            reject(new Error(`获取位置失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/modify-alarm-tool.js

@@ -256,7 +256,7 @@ export function createModifyAlarmTool(ctx) {
                             });
                         }
                         else {
-                            reject(new Error(`修改闹钟失败: ${event.status}`));
+                            reject(new Error(`修改闹钟失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/modify-note-tool.js

@@ -97,7 +97,7 @@ export function createModifyNoteTool(ctx) {
                             });
                         }
                         else {
-                            reject(new Error(`修改备忘录失败: ${event.status}`));
+                            reject(new Error(`修改备忘录失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/note-tool.js

@@ -114,7 +114,7 @@ export function createNoteTool(ctx) {
                             });
                         }
                         else {
-                            reject(new Error(`创建备忘录失败: ${event.status}`));
+                            reject(new Error(`创建备忘录失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/query-app-message-tool.js

@@ -114,7 +114,7 @@ c. 调用工具前需认真检查调用参数是否满足工具要求
                             });
                         }
                         else {
-                            reject(new Error(`查询通知消息失败: ${event.status}`));
+                            reject(new Error(`查询通知消息失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/query-memory-data-tool.js

@@ -130,7 +130,7 @@ c. 调用工具前需认真检查调用参数是否满足工具要求
                             });
                         }
                         else {
-                            reject(new Error(`查询记忆数据失败: ${event.status}`));
+                            reject(new Error(`查询记忆数据失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/query-todo-task-tool.js

@@ -109,7 +109,7 @@ d. 当只传入 startTime 时，返回该时间点之后的所有任务；当只
                             });
                         }
                         else {
-                            reject(new Error(`查询待办任务失败: ${event.status}`));
+                            reject(new Error(`查询待办任务失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/save-file-to-phone-tool.js

@@ -138,7 +138,7 @@ export function createSaveFileToPhoneTool(ctx) {
                             });
                         }
                         else {
-                            reject(new Error(`保存文件到手机失败: ${event.status}`));
+                            reject(new Error(`保存文件到手机失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/save-media-to-gallery-tool.js

@@ -146,7 +146,7 @@ export function createSaveMediaToGalleryTool(ctx) {
                             });
                         }
                         else {
-                            reject(new Error(`保存媒体到图库失败: ${event.status}`));
+                            reject(new Error(`保存媒体到图库失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/schema-tool-factory.js

@@ -23,7 +23,7 @@ export function createSchemaTool(options) {
                 content: [
                     {
                         type: "text",
-                        text: JSON.stringify(schemas, null, 2),
+                        text: "以下为工具列表。请仔细阅读，使用call_device_tool进行调用：\n" + JSON.stringify(schemas, null, 2),
                     },
                 ],
             };

package/dist/src/tools/search-alarm-tool.js

@@ -188,7 +188,7 @@ b. 使用该工具之前需获取当前真实时间
                             });
                         }
                         else {
-                            reject(new Error(`检索闹钟失败: ${event.status}`));
+                            reject(new Error(`检索闹钟失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/search-calendar-tool.js

@@ -159,7 +159,7 @@ d. 如果查询结果返回-303，代表查询结果为空
                             });
                         }
                         else {
-                            reject(new Error(`检索日程失败: ${event.status}`));
+                            reject(new Error(`检索日程失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/search-contact-tool.js

@@ -87,7 +87,7 @@ export function createSearchContactTool(ctx) {
                             });
                         }
                         else {
-                            reject(new Error(`搜索联系人失败: ${event.status}`));
+                            reject(new Error(`搜索联系人失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/search-email-tool.js

@@ -110,7 +110,7 @@ b. 使用该工具之前需获取当前真实时间
                             });
                         }
                         else {
-                            reject(new Error(`检索邮件失败: ${event.status}`));
+                            reject(new Error(`检索邮件失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/search-file-tool.js

@@ -11,13 +11,12 @@ export function createSearchFileTool(ctx) {
     return {
         name: "search_file",
         label: "Search File",
-        description: `搜索手机或PC/电脑文件系统的文件。
+        description: `搜索用户设备的文件系统的文件，用户设备可以是手机或者鸿蒙PC等。
 
-【重要】使用场景与调用流程：
-1. 搜索手机文件：当用户明确说明要从手机搜索时（如"从手机里面搜索xxxx"、"在手机上查找文件xxxx"），直接调用此工具，无需传入 udid。
-2. 搜索PC/电脑文件：当用户要求搜索PC/电脑上的文件时（如"帮我找一下PC上的xxx文件"、"搜索电脑上的xxx"），必须先调用 find_pc_devices 工具获取设备ID（udid），然后将 udid 传入此工具进行搜索。
+使用场景与调用流程：
+当用户明确说明要从设备搜索时（如"从手机里面搜索xxxx"、"在手机上查找文件xxxx"，"查找我电脑上的xxxx文件"，"查找我鸿蒙PC上的xxx文件"），直接调用此工具。
 
-如果用户没有明确说明从手机或PC搜索（如仅说"搜索文件"、"找一下xxxx"），应默认从当前runtime运行环境的本地文件系统查询，不要调用此工具。
+如果用户没有明确说明从设备搜索（如仅说"搜索文件"、"找一下xxxx"），应默认从当前runtime运行环境的本地文件系统查询，不要调用此工具。
 
 功能说明：根据关键词搜索文件名称或内容，返回匹配的文件列表（包括文件名、路径、大小、修改时间等信息）。
 
@@ -28,11 +27,7 @@ export function createSearchFileTool(ctx) {
                 query: {
                     type: "string",
                     description: "搜索关键词，用于匹配文件名称、后缀名或文件内容",
-                },
-                udid: {
-                    type: "string",
-                    description: "PC/电脑设备ID。当搜索PC/电脑上的文件时，需要先通过 find_pc_devices 工具获取设备ID后传入。搜索手机文件时不需要传入此参数。",
-                },
+                }
             },
             required: ["query"],
         },

package/dist/src/tools/search-note-tool.js

@@ -86,7 +86,7 @@ export function createSearchNoteTool(ctx) {
                             });
                         }
                         else {
-                            reject(new Error(`搜索备忘录失败: ${event.status}`));
+                            reject(new Error(`搜索备忘录失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/search-photo-gallery-tool.js

@@ -140,7 +140,7 @@ async function searchPhotos(wsManager, config, sessionId, taskId, messageId, too
                     resolve(event.outputs);
                 }
                 else {
-                    reject(new Error(`搜索照片失败: ${event.status}`));
+                    reject(new Error(`搜索照片失败: ${JSON.stringify(event.outputs)}`));
                 }
             }
         };

package/dist/src/tools/send-cross-device-task-tool.js

@@ -18,9 +18,9 @@ function buildResultText(result) {
     };
 }
 function buildModelToolResult(result) {
-    const fileUrls = result.fileUrls;
+    const sentFiles = result.sentFiles;
     const resultStatus = result.success
-        ? fileUrls.length > 0
+        ? sentFiles.length > 0
             ? "对端设备执行任务成功且返回有文件"
             : "对端设备执行任务成功且返回无文件"
         : "对端设备任务失败";
@@ -46,35 +46,31 @@ function buildModelToolResult(result) {
         resultStatus,
     };
 }
-function extractFileUrl(message) {
-    const matches = message.match(/https?:\/\/[^\s<>"']+/g);
-    const firstUrl = matches?.[0] ?? "";
-    return firstUrl.replace(/[，。；、！？,.!?;:)\]}]+$/u, "");
-}
 function buildCrossDeviceResult(params) {
-    const payloadFileUrls = params.success ? params.fileUrls.filter((url) => typeof url === "string" && url.length > 0) : [];
-    const messageFileUrl = params.success ? extractFileUrl(params.message) : "";
-    const fileUrls = Array.from(new Set([...payloadFileUrls, ...(messageFileUrl ? [messageFileUrl] : [])]));
     const result = {
         success: params.success,
         code: params.code,
         message: params.message,
-        fileUrls,
+        sentFiles: params.sentFiles,
         rawEvent: params.rawEvent,
     };
     return result;
 }
 async function autoSendFileToUserIfNeeded(result, ctx) {
-    const fileUrls = result.fileUrls;
-    if (fileUrls.length === 0) {
+    const sentFiles = Array.isArray(result.sentFiles) ? result.sentFiles : [];
+    if (sentFiles.length === 0) {
         return result;
     }
-    logger.log(`${SEND_CROSS_RESULT_LOG_TAG} auto sending ${fileUrls.length} cross-device file(s) to user`);
+    logger.log(`${SEND_CROSS_RESULT_LOG_TAG} auto sending ${sentFiles.length} cross-device file(s) to user`);
     try {
         const sendFileTool = createSendFileToUserTool(ctx);
-        const sendFileResult = await sendFileTool.execute("auto_send_cross_device_file", {
-            fileRemoteUrls: fileUrls,
-        });
+        const sendFileResult = await (async () => {
+            const results = [];
+            for (const sentFileParams of sentFiles) {
+                results.push(await sendFileTool.execute("auto_send_cross_device_file", sentFileParams));
+            }
+            return results;
+        })();
         logger.log(`${SEND_CROSS_RESULT_LOG_TAG} auto send_file_to_user completed`);
         return {
             ...result,
@@ -222,7 +218,7 @@ export function createSendCrossDeviceTaskTool(ctx) {
                     }
                     settled = true;
                     const modelResult = buildModelToolResult(result);
-                    logger.log(`${LOG_TAG} completed, success=${result.success}, code=${result.code}, fileUrlCount=${result.fileUrls.length}`);
+                    logger.log(`${LOG_TAG} completed, success=${result.success}, code=${result.code}, sentFileCount=${result.sentFiles.length}`);
                     cleanup();
                     resolve(buildResultText(modelResult));
                 };
@@ -230,7 +226,7 @@ export function createSendCrossDeviceTaskTool(ctx) {
                     if (event.sessionId && event.sessionId !== sessionId && event.sessionId !== distributionSessionId) {
                         return;
                     }
-                    logger.log(`${SEND_CROSS_RESULT_LOG_TAG} received result, status=${event.status}, code=${event.code}, fileUrlCount=${event.fileUrls.length}`);
+                    logger.log(`${SEND_CROSS_RESULT_LOG_TAG} received result, status=${event.status}, code=${event.code}, sentFileCount=${event.sentFiles.length}`);
                     void (async () => {
                         if (resultHandlingStarted) {
                             return;
@@ -254,7 +250,7 @@ export function createSendCrossDeviceTaskTool(ctx) {
                             success: event.status === "success",
                             code: event.code,
                             message: event.message,
-                            fileUrls: event.fileUrls,
+                            sentFiles: event.sentFiles,
                             rawEvent: event.rawEvent,
                         });
                         const resultWithFileSend = await autoSendFileToUserIfNeeded(result, ctx);
@@ -267,7 +263,7 @@ export function createSendCrossDeviceTaskTool(ctx) {
                         success: false,
                         code: "",
                         message: `Cross-device task timed out after ${CROSS_DEVICE_TASK_TIMEOUT_MS / 1000} seconds.`,
-                        fileUrls: [],
+                        sentFiles: [],
                         rawEvent: null,
                     });
                 }, CROSS_DEVICE_TASK_TIMEOUT_MS);
@@ -293,7 +289,7 @@ export function createSendCrossDeviceTaskTool(ctx) {
                         success: false,
                         code: "",
                         message: `Failed to send cross-device task command: ${error instanceof Error ? error.message : String(error)}`,
-                        fileUrls: [],
+                        sentFiles: [],
                         rawEvent: null,
                     });
                 });

package/dist/src/tools/send-email-tool.js

@@ -110,7 +110,7 @@ c. 调用工具前需认真检查调用参数是否满足工具要求
                             });
                         }
                         else {
-                            reject(new Error(`发送邮件失败: ${event.status}`));
+                            reject(new Error(`发送邮件失败: ${JSON.stringify(event.outputs)}`));
                         }
                     }
                 };

package/dist/src/tools/send-file-to-user-tool.d.ts

@@ -1,4 +1,4 @@
-import type { SessionContext } from "./session-manager.js";
+import { type SessionContext } from "./session-manager.js";
 /**
  * XY send file to user tool - sends local files or remote files to user's device.
  * Supports both local file paths and remote URLs.

package/dist/src/tools/send-file-to-user-tool.js

@@ -1,5 +1,6 @@
 import { getXYWebSocketManager } from "../client.js";
 import { XYFileUploadService } from "../file-upload.js";
+import { appendRunCrossTaskSentFiles } from "./session-manager.js";
 import { logger } from "../utils/logger.js";
 import { getCurrentTaskId, getCurrentMessageId } from "../task-manager.js";
 import fetch from "node-fetch";
@@ -64,16 +65,22 @@ function normalizeToArray(param) {
 /**
  * Download remote file to local temp directory
  */
-async function downloadRemoteFile(url) {
+async function downloadRemoteFile(url, desiredFilename) {
     try {
         const response = await fetch(url);
         if (!response.ok) {
             throw new Error(`HTTP ${response.status}: ${response.statusText}`);
         }
-        // Get filename from URL or use default
-        let filename = url.split("/").pop() || "downloaded_file";
-        // Remove query parameters if present
-        filename = filename.split("?")[0];
+        // Use desired filename if provided, otherwise extract from URL
+        let filename;
+        if (desiredFilename) {
+            filename = desiredFilename;
+        }
+        else {
+            filename = url.split("/").pop() || "downloaded_file";
+            // Remove query parameters if present
+            filename = filename.split("?")[0];
+        }
         // Ensure temp directory exists
         const tempDir = "/tmp/xy_channel";
         await fs.mkdir(tempDir, { recursive: true });
@@ -119,6 +126,9 @@ b. 操作超时时间为2分钟（120秒），请勿重复调用此工具，如
                 fileRemoteUrls: {
                     description: "公网地址数组，包含用户需要回传的文件的公网地址（会先下载到本地再发送），注意不要对原始url做任何截断（例如裁减掉链接后面的鉴权信息或者修改域名后缀），必须使用上下文中完整的文件地址",
                 },
+                fileNames: {
+                    description: "文件名数组，与 fileRemoteUrls 一一对应，用于指定下载后的文件名。必须从 search_file 工具返回结果中提取每个文件的原始文件名，根据uoploadfile工具的顺序传入。",
+                },
             },
         },
         async execute(toolCallId, params) {
@@ -156,6 +166,24 @@ b. 操作超时时间为2分钟（120秒），请勿重复调用此工具，如
                         throw new Error("fileRemoteUrls array cannot be empty");
                     }
                 }
+                // Normalize fileNames parameter
+                let fileNames = [];
+                if (params.fileNames) {
+                    fileNames = normalizeToArray(params.fileNames);
+                    if (fileNames.length > 0 && fileNames.length !== fileRemoteUrls.length) {
+                        throw new Error(`fileNames length (${fileNames.length}) must match fileRemoteUrls length (${fileRemoteUrls.length})`);
+                    }
+                }
+                if (ctx.runCrossTaskContext && (fileLocalUrls.length > 0 || fileRemoteUrls.length > 0)) {
+                    const cachedSentFiles = appendRunCrossTaskSentFiles([
+                        {
+                            ...(fileLocalUrls.length > 0 ? { fileLocalUrls } : {}),
+                            ...(fileRemoteUrls.length > 0 ? { fileRemoteUrls } : {}),
+                            ...(fileNames.length > 0 ? { fileNames } : {}),
+                        },
+                    ], ctx.runCrossTaskContext);
+                    logger.log(`[RunCrossTask] cached ${cachedSentFiles.length} send_file_to_user input(s) for cross-task result`);
+                }
                 // Get WebSocket manager
                 const wsManager = getXYWebSocketManager(config);
                 // Create upload service
@@ -168,7 +196,8 @@ b. 操作超时时间为2分钟（120秒），请勿重复调用此工具，如
                     for (let i = 0; i < fileRemoteUrls.length; i++) {
                         const remoteUrl = fileRemoteUrls[i];
                         try {
-                            const localPath = await downloadRemoteFile(remoteUrl);
+                            const desiredName = fileNames[i] || undefined;
+                            const localPath = await downloadRemoteFile(remoteUrl, desiredName);
                             allLocalPaths.push(localPath);
                             downloadedFiles.push(localPath);
                         }

package/dist/src/tools/send-html-card-tool.d.ts

@@ -0,0 +1,7 @@
+import type { SessionContext } from "./session-manager.js";
+/**
+ * XY send HTML card tool - sends HTML content as an H5 card to user's device.
+ * Prefer this tool over send_file_to_user when sending HTML files to users.
+ * Only use send_file_to_user for HTML files when the user explicitly requests the raw file.
+ */
+export declare function createSendHtmlCardTool(ctx: SessionContext): any;

package/dist/src/tools/send-html-card-tool.js

@@ -0,0 +1,113 @@
+import { XYFileUploadService } from "../file-upload.js";
+import { sendCard } from "../formatter.js";
+import { getCurrentTaskId } from "../task-manager.js";
+import { logger } from "../utils/logger.js";
+/**
+ * XY send HTML card tool - sends HTML content as an H5 card to user's device.
+ * Prefer this tool over send_file_to_user when sending HTML files to users.
+ * Only use send_file_to_user for HTML files when the user explicitly requests the raw file.
+ */
+export function createSendHtmlCardTool(ctx) {
+    const { config, sessionId, taskId, messageId } = ctx;
+    return {
+        name: "send_html_card",
+        label: "Send HTML Card",
+        description: `工具能力描述：支持以H5卡片的形式展示HTML页面内容，用户可以直接在卡片中查看。
+
+工具参数说明：
+a. htmlUrl 和 htmlLocal 至少填写一个
+b. htmlUrl 是在线链接，可以直接公网访问的HTML页面地址
+c. htmlLocal 是本地HTML文件路径，会先上传获取预览链接再以卡片形式发送
+
+注意事项：
+a. 操作超时时间为2分钟（120秒），请勿重复调用此工具，如果超时或失败，最多重试一次
+b. 最后要把最终的html的公网地址作为工具执行结果返回回去，要以markdown超链接的形式返回给用户，必须严格保留完整的url，包含url的鉴权鉴权信息，返回给用户的url必须是完整的
+c. 仅当用户或者skill中显示说明使用send_html_card工具时才调用此工具`,
+        parameters: {
+            type: "object",
+            properties: {
+                htmlUrl: {
+                    type: "string",
+                    description: "在线HTML页面链接，可直接公网访问的URL地址",
+                },
+                htmlLocal: {
+                    type: "string",
+                    description: "本地HTML文件路径",
+                },
+            },
+            required: [],
+        },
+        async execute(toolCallId, params) {
+            // Validate at least one parameter is provided
+            if (!params.htmlUrl && !params.htmlLocal) {
+                throw new Error("htmlUrl 和 htmlLocal 至少需要填写一个");
+            }
+            const currentTaskId = getCurrentTaskId(sessionId) ?? taskId;
+            // Set timeout for the entire operation (2 minutes)
+            const TOOL_TIMEOUT = 120000;
+            let timeoutHandle = null;
+            const timeoutPromise = new Promise((_, reject) => {
+                timeoutHandle = setTimeout(() => {
+                    reject(new Error("操作超时（2分钟）"));
+                }, TOOL_TIMEOUT);
+            });
+            const executionPromise = (async () => {
+                let url = params.htmlUrl;
+                // If htmlLocal is provided, upload it to get a preview URL
+                if (params.htmlLocal) {
+                    const uploadService = new XYFileUploadService(config.fileUploadUrl, config.apiKey, config.uid);
+                    logger.log(`[SEND-HTML-CARD] Uploading local HTML file: ${params.htmlLocal}`);
+                    const previewUrl = await uploadService.uploadFileAndGetPreviewUrl(params.htmlLocal);
+                    logger.log(`[SEND-HTML-CARD] Upload complete, preview URL obtained`);
+                    url = previewUrl;
+                }
+                if (!url) {
+                    throw new Error("未能获取HTML页面的URL");
+                }
+                // Build card data
+                const cardsInfo = [
+                    {
+                        cardName: "clawH5",
+                        cardData: {
+                            url,
+                        },
+                        displayType: "DisplayFaCard",
+                    },
+                ];
+                // Send card via sendCard
+                await sendCard({
+                    config,
+                    sessionId,
+                    taskId: currentTaskId,
+                    messageId,
+                    toolCallId,
+                    cardsInfo,
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: true,
+                                message: `HTML卡片发送成功，html的在线链接如下，生成markdown超链接时与此url需保持完整一致 ${url}`,
+                            }),
+                        },
+                    ],
+                };
+            })();
+            try {
+                const result = await Promise.race([executionPromise, timeoutPromise]);
+                if (timeoutHandle) {
+                    clearTimeout(timeoutHandle);
+                }
+                return result;
+            }
+            catch (error) {
+                if (timeoutHandle) {
+                    clearTimeout(timeoutHandle);
+                }
+                throw error;
+            }
+        },
+    };
+}

package/dist/src/tools/session-manager.d.ts

@@ -1,5 +1,5 @@
 import { AsyncLocalStorage } from "async_hooks";
-import type { RunCrossTaskContext, XYChannelConfig } from "../types.js";
+import type { RunCrossTaskContext, SentFileParams, XYChannelConfig } from "../types.js";
 export interface SessionContext {
     config: XYChannelConfig;
     sessionId: string;
@@ -8,6 +8,9 @@ export interface SessionContext {
     messageId: string;
     agentId: string;
     deviceType?: string;
+    /** Model name extracted from A2A user variables (variables.clientVariables.modelName).
+     *  When set, provider.ts replaces model.id in the OpenAI request body. */
+    modelName?: string;
     runCrossTaskContext?: RunCrossTaskContext;
     /** When true, this context was created for a cron/scheduled task execution.
      *  Tools should use the push channel instead of WebSocket sendCommand. */
@@ -76,5 +79,6 @@ export declare function cleanupStaleSessions(): number;
  * Get the current number of active sessions (for diagnostics).
  */
 export declare function getActiveSessionCount(): number;
-export declare function appendRunCrossTaskFileUrls(fileUrls: string[], explicitRunCrossTaskContext?: RunCrossTaskContext): string[];
+export declare function appendRunCrossTaskSentFiles(sentFiles: SentFileParams[], explicitRunCrossTaskContext?: RunCrossTaskContext): SentFileParams[];
+export declare function clearRunCrossTaskSentFiles(explicitRunCrossTaskContext?: RunCrossTaskContext): void;
 export {};

package/dist/src/tools/session-manager.js

@@ -237,21 +237,56 @@ export function cleanupStaleSessions() {
 export function getActiveSessionCount() {
     return activeSessions.size;
 }
-export function appendRunCrossTaskFileUrls(fileUrls, explicitRunCrossTaskContext) {
+function normalizeSentFileParams(params) {
+    const fileLocalUrls = Array.isArray(params.fileLocalUrls)
+        ? params.fileLocalUrls.filter((url) => typeof url === "string" && url.length > 0)
+        : [];
+    const fileRemoteUrls = Array.isArray(params.fileRemoteUrls)
+        ? params.fileRemoteUrls.filter((url) => typeof url === "string" && url.length > 0)
+        : [];
+    const fileNames = Array.isArray(params.fileNames)
+        ? params.fileNames.filter((name) => typeof name === "string" && name.length > 0)
+        : [];
+    if (fileLocalUrls.length === 0 && fileRemoteUrls.length === 0) {
+        return null;
+    }
+    return {
+        ...(fileLocalUrls.length > 0 ? { fileLocalUrls } : {}),
+        ...(fileRemoteUrls.length > 0 ? { fileRemoteUrls } : {}),
+        ...(fileNames.length > 0 && fileNames.length === fileRemoteUrls.length ? { fileNames } : {}),
+    };
+}
+export function appendRunCrossTaskSentFiles(sentFiles, explicitRunCrossTaskContext) {
     const context = asyncLocalStorage.getStore() ?? null;
     const runCrossTaskContext = explicitRunCrossTaskContext ?? context?.runCrossTaskContext;
-    if (!runCrossTaskContext || fileUrls.length === 0) {
-        return runCrossTaskContext?.fileUrls ?? [];
+    const normalizedSentFiles = sentFiles
+        .map((params) => normalizeSentFileParams(params))
+        .filter((params) => params !== null);
+    if (!runCrossTaskContext || normalizedSentFiles.length === 0) {
+        return runCrossTaskContext?.sentFiles ?? [];
     }
-    const existing = Array.isArray(runCrossTaskContext.fileUrls) ? runCrossTaskContext.fileUrls : [];
-    const merged = Array.from(new Set([...existing, ...fileUrls.filter((url) => typeof url === "string" && url.length > 0)]));
-    runCrossTaskContext.fileUrls = merged;
+    const existing = Array.isArray(runCrossTaskContext.sentFiles) ? runCrossTaskContext.sentFiles : [];
+    const merged = [...existing, ...normalizedSentFiles];
+    runCrossTaskContext.sentFiles = merged;
     const sessionWithRef = Array.from(activeSessions.values()).find((session) => session.runCrossTaskContext === runCrossTaskContext);
     if (sessionWithRef?.runCrossTaskContext) {
-        sessionWithRef.runCrossTaskContext.fileUrls = merged;
+        sessionWithRef.runCrossTaskContext.sentFiles = merged;
     }
     return merged;
 }
+export function clearRunCrossTaskSentFiles(explicitRunCrossTaskContext) {
+    const context = asyncLocalStorage.getStore() ?? null;
+    const runCrossTaskContext = explicitRunCrossTaskContext ?? context?.runCrossTaskContext;
+    if (!runCrossTaskContext) {
+        return;
+    }
+    runCrossTaskContext.sentFiles = [];
+    for (const sessionWithRef of activeSessions.values()) {
+        if (sessionWithRef.runCrossTaskContext === runCrossTaskContext) {
+            sessionWithRef.runCrossTaskContext.sentFiles = [];
+        }
+    }
+}
 /**
  * Enrich a base session context with the latest taskId/messageId
  * from task-manager (supports interruption scenarios).

package/dist/src/tools/upload-file-tool.d.ts

@@ -1,4 +1,4 @@
-import { type SessionContext } from "./session-manager.js";
+import type { SessionContext } from "./session-manager.js";
 /**
  * XY upload file tool - uploads local files to get publicly accessible URLs.
  * Requires file URIs from search_file tool as prerequisite.