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

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

@@ -0,0 +1,154 @@
+// QueryMemoryData tool implementation
+import { getXYWebSocketManager } from "../client.js";
+import { sendCommand } from "../formatter.js";
+import { getCurrentSessionContext } from "./session-manager.js";
+class ToolInputError extends Error {
+    status = 400;
+    constructor(message) {
+        super(message);
+        this.name = "ToolInputError";
+    }
+}
+const VALID_CATEGORIES = ["ImportantDay", "Address", "Card", "ServiceOrder", "Event"];
+const VALID_SUB_CATEGORIES = {
+    ImportantDay: ["Birthday", "Anniversary", "RepaymentDate", "ExamDate", "SalaryDate", "BigDay"],
+    Card: [
+        "IDCard", "Passport", "DrivingLicense", "VehicleLicense", "EEPtoHKMO",
+        "EEPtoTW", "Invoice", "BusinessCard", "VehicleInspectionCertificate",
+        "SocialSecurityCard", "BankCard",
+    ],
+    ServiceOrder: ["FilmTicket", "HotelOrder", "TrainTicket", "AirTicket"],
+    Event: [
+        "Delicacy", "Work", "FamilyActivities", "Travel", "Training",
+        "Health", "Life", "Entertainment", "Calendar",
+    ],
+};
+/**
+ * 查询存储在设备本地的结构化记忆数据。
+ */
+export const queryMemoryDataTool = {
+    name: "query_memory_data",
+    label: "Query Memory Data",
+    description: `查询存储在设备本地的结构化记忆数据。适用于获取特定类别的个人信息，如重要日子、证件卡证、服务订单或日程事件。支持按分类、子分类进行过滤。
+注意：
+a. 操作超时时间为60秒，请勿重复调用此工具
+b. 如果遇到各类调用失败场景，最多只能重试一次，不可以重复调用多次。
+c. 调用工具前需认真检查调用参数是否满足工具要求
+
+回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，例如告诉用户如何授权，如何解决报错等都是不需要的，请严格遵守。`,
+    parameters: {
+        type: "object",
+        properties: {
+            category: {
+                type: "string",
+                description: '按数据大类进行过滤。可选值为 ""、"ImportantDay"、"Address"、"Card"、"ServiceOrder"、"Event"。默认值为 ""。',
+            },
+            subCategory: {
+                description: '在指定 category 下的子类别过滤，默认值为""。支持字符串或字符串数组。',
+                oneOf: [
+                    { type: "string" },
+                    { type: "array", items: { type: "string" } },
+                ],
+            },
+        },
+        required: [],
+    },
+    async execute(_toolCallId, params) {
+        const { category, subCategory } = params;
+        // Validate category
+        if (category && !VALID_CATEGORIES.includes(category)) {
+            throw new ToolInputError(`category 参数无效，可选值为：${VALID_CATEGORIES.join("、")}`);
+        }
+        // Validate subCategory when category is specified
+        if (category && subCategory && VALID_SUB_CATEGORIES[category]) {
+            const validValues = VALID_SUB_CATEGORIES[category];
+            const subValues = Array.isArray(subCategory) ? subCategory : [subCategory];
+            for (const sv of subValues) {
+                if (sv && !validValues.includes(sv)) {
+                    throw new ToolInputError(`category 为 "${category}" 时，subCategory 可选值为：${validValues.join("、")}`);
+                }
+            }
+        }
+        const sessionContext = getCurrentSessionContext();
+        if (!sessionContext) {
+            throw new Error("No active XY session found.");
+        }
+        const { config, sessionId, taskId, messageId } = sessionContext;
+        const wsManager = getXYWebSocketManager(config);
+        const intentParam = {};
+        if (category)
+            intentParam.category = category;
+        if (subCategory !== undefined)
+            intentParam.subCategory = subCategory;
+        const command = {
+            header: {
+                namespace: "Common",
+                name: "Action",
+            },
+            payload: {
+                cardParam: {},
+                executeParam: {
+                    executeMode: "background",
+                    intentName: "QueryMemoryData",
+                    bundleName: "com.huawei.hmos.vassistant",
+                    needUnlock: true,
+                    actionResponse: true,
+                    appType: "OHOS_APP",
+                    timeOut: 5,
+                    intentParam,
+                    permissionId: [],
+                    achieveType: "INTENT",
+                },
+                responses: [
+                    {
+                        resultCode: "",
+                        displayText: "",
+                        ttsText: "",
+                    },
+                ],
+                needUploadResult: true,
+                noHalfPage: false,
+                pageControlRelated: false,
+            },
+        };
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                wsManager.off("data-event", handler);
+                reject(new Error("查询记忆数据超时（60秒）"));
+            }, 60000);
+            const handler = (event) => {
+                if (event.intentName === "QueryMemoryData") {
+                    clearTimeout(timeout);
+                    wsManager.off("data-event", handler);
+                    if (event.status === "success" && event.outputs) {
+                        resolve({
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify(event.outputs),
+                                },
+                            ],
+                        });
+                    }
+                    else {
+                        reject(new Error(`查询记忆数据失败: ${event.status}`));
+                    }
+                }
+            };
+            wsManager.on("data-event", handler);
+            sendCommand({
+                config,
+                sessionId,
+                taskId,
+                messageId,
+                command,
+            })
+                .then(() => { })
+                .catch((error) => {
+                clearTimeout(timeout);
+                wsManager.off("data-event", handler);
+                reject(error);
+            });
+        });
+    },
+};

package/dist/src/tools/query-todo-task-tool.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 获取指定时间范围内的全局待办任务列表。
+ */
+export declare const queryTodoTaskTool: any;

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

@@ -0,0 +1,133 @@
+// QueryTodoTask tool implementation
+import { getXYWebSocketManager } from "../client.js";
+import { sendCommand } from "../formatter.js";
+import { getCurrentSessionContext } from "./session-manager.js";
+class ToolInputError extends Error {
+    status = 400;
+    constructor(message) {
+        super(message);
+        this.name = "ToolInputError";
+    }
+}
+/**
+ * 获取指定时间范围内的全局待办任务列表。
+ */
+export const queryTodoTaskTool = {
+    name: "query_todo_task",
+    label: "Query Todo Task",
+    description: `获取指定时间范围内的全局待办任务列表。适用于需要查询历史任务、按完成状态筛选、或仅查看待处理任务的场景。支持按时间范围、任务状态进行过滤。
+注意：
+a. 操作超时时间为60秒，请勿重复调用此工具
+b. 如果遇到各类调用失败场景，最多只能重试一次，不可以重复调用多次。
+c. 调用工具前需认真检查调用参数是否满足工具要求
+d. 当只传入 startTime 时，返回该时间点之后的所有任务；当只传入 endTime 时，返回该时间点之前的所有任务；两者都不传则返回所有时间段的任务。
+
+回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，例如告诉用户如何授权，如何解决报错等都是不需要的，请严格遵守。`,
+    parameters: {
+        type: "object",
+        properties: {
+            startTime: {
+                type: "string",
+                description: "查询创建时间大于此值的任务（ISO 8601 字符串，如 2024-01-01T00:00:00Z）。",
+            },
+            endTime: {
+                type: "string",
+                description: "查询创建时间小于此值的任务（ISO 8601 字符串，如 2024-01-31T23:59:59Z）。",
+            },
+            status: {
+                type: "string",
+                description: '任务完成状态过滤。可选值为 "all"、"completed"、"pending"。默认为 "all"。',
+            },
+        },
+        required: [],
+    },
+    async execute(_toolCallId, params) {
+        const { status } = params;
+        if (status && !["all", "completed", "pending"].includes(status)) {
+            throw new ToolInputError('status 参数只能为 "all"、"completed" 或 "pending"');
+        }
+        const sessionContext = getCurrentSessionContext();
+        if (!sessionContext) {
+            throw new Error("No active XY session found.");
+        }
+        const { config, sessionId, taskId, messageId } = sessionContext;
+        const wsManager = getXYWebSocketManager(config);
+        const intentParam = {};
+        if (params.startTime !== undefined)
+            intentParam.startTime = params.startTime;
+        if (params.endTime !== undefined)
+            intentParam.endTime = params.endTime;
+        if (status !== undefined)
+            intentParam.status = status;
+        const command = {
+            header: {
+                namespace: "Common",
+                name: "Action",
+            },
+            payload: {
+                cardParam: {},
+                executeParam: {
+                    executeMode: "background",
+                    intentName: "QueryTodoTask",
+                    bundleName: "com.huawei.hmos.vassistant",
+                    needUnlock: true,
+                    actionResponse: true,
+                    appType: "OHOS_APP",
+                    timeOut: 5,
+                    intentParam,
+                    permissionId: [],
+                    achieveType: "INTENT",
+                },
+                responses: [
+                    {
+                        resultCode: "",
+                        displayText: "",
+                        ttsText: "",
+                    },
+                ],
+                needUploadResult: true,
+                noHalfPage: false,
+                pageControlRelated: false,
+            },
+        };
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                wsManager.off("data-event", handler);
+                reject(new Error("查询待办任务超时（60秒）"));
+            }, 60000);
+            const handler = (event) => {
+                if (event.intentName === "QueryTodoTask") {
+                    clearTimeout(timeout);
+                    wsManager.off("data-event", handler);
+                    if (event.status === "success" && event.outputs) {
+                        resolve({
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify(event.outputs),
+                                },
+                            ],
+                        });
+                    }
+                    else {
+                        reject(new Error(`查询待办任务失败: ${event.status}`));
+                    }
+                }
+            };
+            wsManager.on("data-event", handler);
+            sendCommand({
+                config,
+                sessionId,
+                taskId,
+                messageId,
+                command,
+            })
+                .then(() => { })
+                .catch((error) => {
+                clearTimeout(timeout);
+                wsManager.off("data-event", handler);
+                reject(error);
+            });
+        });
+    },
+};

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

@@ -0,0 +1,5 @@
+/**
+ * XY save file to phone tool - saves files to user's device file manager.
+ * Supports local file paths (auto-uploaded to get public URL) and public URLs.
+ */
+export declare const saveFileToPhoneTool: any;

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

@@ -0,0 +1,166 @@
+import { getXYWebSocketManager } from "../client.js";
+import { sendCommand } from "../formatter.js";
+import { getCurrentSessionContext } from "./session-manager.js";
+import { XYFileUploadService } from "../file-upload.js";
+/**
+ * Duck-typed ToolInputError: openclaw 按 .name 字段匹配，不用 instanceof。
+ * 抛出此错误会让 openclaw 返回 HTTP 400 而非 500，
+ * LLM 会将其识别为参数错误而非瞬时故障，不会触发重试。
+ */
+class ToolInputError extends Error {
+    status = 400;
+    constructor(message) {
+        super(message);
+        this.name = "ToolInputError";
+    }
+}
+/**
+ * XY save file to phone tool - saves files to user's device file manager.
+ * Supports local file paths (auto-uploaded to get public URL) and public URLs.
+ */
+export const saveFileToPhoneTool = {
+    name: "save_file_to_file_manager",
+    label: "Save File to Phone",
+    description: `将文件保存到手机文件管理器。
+
+  注意:
+  a. 操作超时时间为60秒,请勿重复调用此工具
+  b. 如果遇到各类调用失败场景,不可以重试，直接返回错误。
+  c. 调用工具前需认真检查调用参数是否满足工具要求
+
+  回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，例如告诉用户如何授权，如何解决报错等都是不需要的，请严格遵守。
+  `,
+    parameters: {
+        type: "object",
+        properties: {
+            fileName: {
+                type: "string",
+                description: "必填，文件名称。",
+            },
+            url: {
+                type: "string",
+                description: "必填，支持本地路径或者公网url路径。如果是本地路径会先上传获取公网url。",
+            },
+            suffix: {
+                type: "string",
+                description: "必填，文件后缀，例如 ppt、doc、pdf 等。",
+            },
+        },
+        required: ["fileName", "url", "suffix"],
+    },
+    async execute(toolCallId, params) {
+        // Validate parameters
+        const { fileName, url, suffix } = params;
+        if (!url || typeof url !== "string") {
+            throw new ToolInputError("缺少必填参数: url");
+        }
+        if (!fileName || typeof fileName !== "string") {
+            throw new ToolInputError("缺少必填参数: fileName");
+        }
+        if (!suffix || typeof suffix !== "string") {
+            throw new ToolInputError("缺少必填参数: suffix");
+        }
+        // Get session context
+        const sessionContext = getCurrentSessionContext();
+        if (!sessionContext) {
+            throw new Error("No active XY session found. SaveFileToFileManager tool can only be used during an active conversation.");
+        }
+        const { config, sessionId, taskId, messageId } = sessionContext;
+        // Get WebSocket manager
+        const wsManager = getXYWebSocketManager(config);
+        // Determine the URL: if it's a local path, upload first to get public URL
+        let publicUrl = url;
+        if (!url.startsWith("http://") && !url.startsWith("https://")) {
+            // Local file path - upload to get public URL
+            const uploadService = new XYFileUploadService(config.fileUploadUrl, config.apiKey, config.uid);
+            publicUrl = await uploadService.uploadFileAndGetUrl(url);
+            if (!publicUrl) {
+                throw new Error("本地文件上传失败，无法获取公网URL");
+            }
+        }
+        // Build intentParam
+        const intentParam = {
+            fileName: fileName,
+            url: publicUrl,
+            suffix: suffix,
+        };
+        // Build SaveFileToFileManager command
+        const command = {
+            header: {
+                namespace: "Common",
+                name: "Action",
+            },
+            payload: {
+                cardParam: {},
+                executeParam: {
+                    executeMode: "background",
+                    intentName: "SaveFileToFileManager",
+                    bundleName: "com.huawei.hmos.vassistant",
+                    dimension: "",
+                    needUnlock: true,
+                    actionResponse: true,
+                    appType: "OHOS_APP",
+                    timeOut: 5,
+                    timeout: 55000,
+                    intentParam,
+                    permissionId: ["ohos.permission.WRITE_IMAGEVIDEO"],
+                    achieveType: "INTENT",
+                },
+                responses: [
+                    {
+                        resultCode: "",
+                        displayText: "",
+                        ttsText: "",
+                    },
+                ],
+                needUploadResult: true,
+                noHalfPage: false,
+                pageControlRelated: false,
+            },
+        };
+        // Send command and wait for response (60 second timeout)
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                wsManager.off("data-event", handler);
+                reject(new Error("保存文件到手机超时（60秒）"));
+            }, 60000);
+            // Listen for data events from WebSocket
+            const handler = (event) => {
+                if (event.intentName === "SaveFileToFileManager") {
+                    clearTimeout(timeout);
+                    wsManager.off("data-event", handler);
+                    if (event.status === "success" && event.outputs) {
+                        resolve({
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify(event.outputs),
+                                }
+                            ]
+                        });
+                    }
+                    else {
+                        reject(new Error(`保存文件到手机失败: ${event.status}`));
+                    }
+                }
+            };
+            // Register event handler
+            wsManager.on("data-event", handler);
+            // Send the command
+            sendCommand({
+                config,
+                sessionId,
+                taskId,
+                messageId,
+                command,
+            })
+                .then(() => {
+            })
+                .catch((error) => {
+                clearTimeout(timeout);
+                wsManager.off("data-event", handler);
+                reject(error);
+            });
+        });
+    },
+};

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

@@ -0,0 +1,5 @@
+/**
+ * XY save media to gallery tool - saves image or video files to user's device gallery.
+ * Supports local file paths (auto-uploaded to get public URL) and public URLs.
+ */
+export declare const saveMediaToGalleryTool: any;

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

@@ -0,0 +1,174 @@
+import { getXYWebSocketManager } from "../client.js";
+import { sendCommand } from "../formatter.js";
+import { getCurrentSessionContext } from "./session-manager.js";
+import { XYFileUploadService } from "../file-upload.js";
+/**
+ * Duck-typed ToolInputError: openclaw 按 .name 字段匹配，不用 instanceof。
+ * 抛出此错误会让 openclaw 返回 HTTP 400 而非 500，
+ * LLM 会将其识别为参数错误而非瞬时故障，不会触发重试。
+ */
+class ToolInputError extends Error {
+    status = 400;
+    constructor(message) {
+        super(message);
+        this.name = "ToolInputError";
+    }
+}
+/**
+ * XY save media to gallery tool - saves image or video files to user's device gallery.
+ * Supports local file paths (auto-uploaded to get public URL) and public URLs.
+ */
+export const saveMediaToGalleryTool = {
+    name: "save_media_to_gallery",
+    label: "Save Media to Gallery",
+    description: `将图片文件或者视频文件保存到设备图库。
+
+  注意:
+  a. 操作超时时间为60秒,请勿重复调用此工具
+  b. 如果遇到各类调用失败场景,最多只能重试一次，不可以重复调用多次。
+  c. 调用工具前需认真检查调用参数是否满足工具要求
+
+  回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，例如告诉用户如何授权，如何解决报错等都是不需要的，请严格遵守。
+  `,
+    parameters: {
+        type: "object",
+        properties: {
+            mediaType: {
+                type: "string",
+                description: "非必填，不传默认为pic。支持 pic(图片) 或 video(视频)。",
+            },
+            fileName: {
+                type: "string",
+                description: "非必填，文件名称，不传手机侧默认生成随机uuid。",
+            },
+            url: {
+                type: "string",
+                description: "必填，支持本地路径或者公网url路径。如果是本地路径，会先上传获取公网url再保存到图库",
+            },
+        },
+        required: ["url"],
+    },
+    async execute(toolCallId, params) {
+        // Validate parameters
+        const { mediaType, fileName, url } = params;
+        if (!url || typeof url !== "string") {
+            throw new ToolInputError("缺少必填参数: url");
+        }
+        if (mediaType && !["pic", "video"].includes(mediaType)) {
+            throw new ToolInputError(`mediaType只支持 pic 或 video，当前值: ${mediaType}`);
+        }
+        // Strip file extension from fileName if present
+        let sanitizedFileName = fileName;
+        if (sanitizedFileName && typeof sanitizedFileName === "string") {
+            const lastDot = sanitizedFileName.lastIndexOf(".");
+            if (lastDot > 0) {
+                sanitizedFileName = sanitizedFileName.substring(0, lastDot);
+            }
+        }
+        // Get session context
+        const sessionContext = getCurrentSessionContext();
+        if (!sessionContext) {
+            throw new Error("No active XY session found. SaveMediaToGallery tool can only be used during an active conversation.");
+        }
+        const { config, sessionId, taskId, messageId } = sessionContext;
+        // Get WebSocket manager
+        const wsManager = getXYWebSocketManager(config);
+        // Determine the URL: if it's a local path, upload first to get public URL
+        let publicUrl = url;
+        if (!url.startsWith("http://") && !url.startsWith("https://")) {
+            // Local file path - upload to get public URL
+            const uploadService = new XYFileUploadService(config.fileUploadUrl, config.apiKey, config.uid);
+            publicUrl = await uploadService.uploadFileAndGetUrl(url);
+            if (!publicUrl) {
+                throw new Error("本地文件上传失败，无法获取公网URL");
+            }
+        }
+        // Build intentParam
+        const intentParam = {
+            url: publicUrl,
+        };
+        if (mediaType) {
+            intentParam.mediaType = mediaType;
+        }
+        if (sanitizedFileName) {
+            intentParam.fileName = sanitizedFileName;
+        }
+        // Build SaveMediaToGallery command
+        const command = {
+            header: {
+                namespace: "Common",
+                name: "Action",
+            },
+            payload: {
+                cardParam: {},
+                executeParam: {
+                    executeMode: "background",
+                    intentName: "SaveMediaToGallery",
+                    bundleName: "com.huawei.hmos.vassistant",
+                    dimension: "",
+                    needUnlock: true,
+                    actionResponse: true,
+                    appType: "OHOS_APP",
+                    timeOut: 5,
+                    intentParam,
+                    permissionId: ["ohos.permission.WRITE_IMAGEVIDEO"],
+                    achieveType: "INTENT",
+                },
+                responses: [
+                    {
+                        resultCode: "",
+                        displayText: "",
+                        ttsText: "",
+                    },
+                ],
+                needUploadResult: true,
+                noHalfPage: false,
+                pageControlRelated: false,
+            },
+        };
+        // Send command and wait for response (60 second timeout)
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                wsManager.off("data-event", handler);
+                reject(new Error("保存媒体到图库超时（60秒）"));
+            }, 60000);
+            // Listen for data events from WebSocket
+            const handler = (event) => {
+                if (event.intentName === "SaveMediaToGallery") {
+                    clearTimeout(timeout);
+                    wsManager.off("data-event", handler);
+                    if (event.status === "success" && event.outputs) {
+                        resolve({
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify(event.outputs),
+                                }
+                            ]
+                        });
+                    }
+                    else {
+                        reject(new Error(`保存媒体到图库失败: ${event.status}`));
+                    }
+                }
+            };
+            // Register event handler
+            wsManager.on("data-event", handler);
+            // Send the command
+            sendCommand({
+                config,
+                sessionId,
+                taskId,
+                messageId,
+                command,
+            })
+                .then(() => {
+            })
+                .catch((error) => {
+                clearTimeout(timeout);
+                wsManager.off("data-event", handler);
+                reject(error);
+            });
+        });
+    },
+};

package/dist/src/tools/schema-tool-factory.d.ts

@@ -0,0 +1,27 @@
+/**
+ * schema-tool-factory: 创建 get_xxx_tool_schema 工具。
+ * 每个工具在被 LLM 调用时，返回其所包含的子工具的 name / description / parameters schema。
+ */
+interface SchemaToolOptions {
+    name: string;
+    label: string;
+    description: string;
+    tools: any[];
+}
+export declare function createSchemaTool(options: SchemaToolOptions): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export {};