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

package/dist/src/tools/find-pc-devices-tool.js

@@ -0,0 +1,98 @@
+import { getXYWebSocketManager } from "../client.js";
+import { sendCommand } from "../formatter.js";
+import { getCurrentSessionContext } from "./session-manager.js";
+/**
+ * XY find PC devices tool - finds all PC devices associated with the user.
+ * Returns device IDs for use in subsequent file search operations.
+ */
+export const findPcDevicesTool = {
+    name: "find_pc_devices",
+    label: "Find PC Devices",
+    description: `查找用户所有PC/电脑设备，获取设备ID列表。当用户说"帮我找一下PC/电脑上的xxx文件"、"帮我搜索电脑上的xxx"等涉及PC设备的请求时，先调用此工具获取设备ID，再进行后续操作。注意:操作超时时间为60秒,请勿重复调用此工具,如果超时或失败,最多重试一次。回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，请严格遵守。`,
+    parameters: {
+        type: "object",
+        properties: {},
+        required: [],
+    },
+    async execute(toolCallId, params) {
+        // Get session context
+        const sessionContext = getCurrentSessionContext();
+        if (!sessionContext) {
+            throw new Error("No active XY session found. Find PC devices tool can only be used during an active conversation.");
+        }
+        const { config, sessionId, taskId, messageId } = sessionContext;
+        // Get WebSocket manager
+        const wsManager = getXYWebSocketManager(config);
+        // Build GetAllDevice command
+        const command = {
+            header: {
+                namespace: "Common",
+                name: "Action",
+            },
+            payload: {
+                cardParam: {},
+                executeParam: {
+                    achieveType: "INTENT",
+                    actionResponse: true,
+                    bundleName: "com.huawei.hmos.aidispatchservice",
+                    dimension: "",
+                    executeMode: "background",
+                    intentName: "GetAllDevice",
+                    intentParam: {},
+                    needUnlock: true,
+                    permissionId: [],
+                    timeOut: 5,
+                },
+                needUploadResult: true,
+                pageControlRelated: false,
+                responses: [{
+                        displayText: "",
+                        resultCode: "",
+                        ttsText: "",
+                    }],
+            },
+        };
+        // 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("查找PC设备超时（60秒）"));
+            }, 60000);
+            // Listen for data events from WebSocket
+            const handler = (event) => {
+                if (event.intentName === "GetAllDevice") {
+                    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(`查找PC设备失败: ${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/get-alarm-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getAlarmToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/src/tools/get-alarm-tool-schema.js

@@ -0,0 +1,11 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { createAlarmTool } from "./create-alarm-tool.js";
+import { searchAlarmTool } from "./search-alarm-tool.js";
+import { modifyAlarmTool } from "./modify-alarm-tool.js";
+import { deleteAlarmTool } from "./delete-alarm-tool.js";
+export const getAlarmToolSchemaTool = createSchemaTool({
+    name: "get_alarm_tool_schema",
+    label: "Get Alarm Tool Schema",
+    description: "获取可在用户设备上创建、检索、修改、删除闹钟的相关端工具列表。",
+    tools: [createAlarmTool, searchAlarmTool, modifyAlarmTool, deleteAlarmTool],
+});

package/dist/src/tools/get-calendar-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getCalendarToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/src/tools/get-calendar-tool-schema.js

@@ -0,0 +1,9 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { calendarTool } from "./calendar-tool.js";
+import { searchCalendarTool } from "./search-calendar-tool.js";
+export const getCalendarToolSchemaTool = createSchemaTool({
+    name: "get_calendar_tool_schema",
+    label: "Get Calendar Tool Schema",
+    description: "获取可在用户设备上创建、检索日程的相关端工具列表。",
+    tools: [calendarTool, searchCalendarTool],
+});

package/dist/src/tools/get-collection-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getCollectionToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/src/tools/get-collection-tool-schema.js

@@ -0,0 +1,10 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { xiaoyiAddCollectionTool } from "./xiaoyi-add-collection-tool.js";
+import { xiaoyiCollectionTool } from "./xiaoyi-collection-tool.js";
+import { xiaoyiDeleteCollectionTool } from "./xiaoyi-delete-collection-tool.js";
+export const getCollectionToolSchemaTool = createSchemaTool({
+    name: "get_collection_tool_schema",
+    label: "Get Collection Tool Schema",
+    description: "获取可在用户设备上添加、检索、删除小艺收藏中的公共知识数据的相关端工具列表。",
+    tools: [xiaoyiAddCollectionTool, xiaoyiCollectionTool, xiaoyiDeleteCollectionTool],
+});

package/dist/src/tools/get-contact-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getContactToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/src/tools/get-contact-tool-schema.js

@@ -0,0 +1,11 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { searchContactTool } from "./search-contact-tool.js";
+import { callPhoneTool } from "./call-phone-tool.js";
+import { searchMessageTool } from "./search-message-tool.js";
+import { sendMessageTool } from "./send-message-tool.js";
+export const getContactToolSchemaTool = createSchemaTool({
+    name: "get_contact_tool_schema",
+    label: "Get Contact Tool Schema",
+    description: "获取可在用户设备上检索通讯录联系人信息、拨打电话、搜索短信与发送短信的相关端工具列表。",
+    tools: [searchContactTool, callPhoneTool, searchMessageTool, sendMessageTool],
+});

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

@@ -0,0 +1,16 @@
+export declare const getDeviceFileToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

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

@@ -0,0 +1,10 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { searchFileTool } from "./search-file-tool.js";
+import { uploadFileTool } from "./upload-file-tool.js";
+import { saveFileToPhoneTool } from "./save-file-to-phone-tool.js";
+export const getDeviceFileToolSchemaTool = createSchemaTool({
+    name: "get_device_file_tool_schema",
+    label: "Get Device File Tool Schema",
+    description: "获取可在用户设备上搜索文件系统的文件、将用户设备本地文件上传到公网并获取链接、保存文件到文件管理器的相关端工具列表。",
+    tools: [searchFileTool, uploadFileTool, saveFileToPhoneTool],
+});

package/dist/src/tools/get-email-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getEmailToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/src/tools/get-email-tool-schema.js

@@ -0,0 +1,9 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { sendEmailTool } from "./send-email-tool.js";
+import { searchEmailTool } from "./search-email-tool.js";
+export const getEmailToolSchemaTool = createSchemaTool({
+    name: "get_email_tool_schema",
+    label: "Get Email Tool Schema",
+    description: "获取可在用户设备上发送邮件、检索邮件的相关端工具列表。",
+    tools: [sendEmailTool, searchEmailTool],
+});

package/dist/src/tools/get-note-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getNoteToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

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

@@ -0,0 +1,10 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { noteTool } from "./note-tool.js";
+import { searchNoteTool } from "./search-note-tool.js";
+import { modifyNoteTool } from "./modify-note-tool.js";
+export const getNoteToolSchemaTool = createSchemaTool({
+    name: "get_note_tool_schema",
+    label: "Get Note Tool Schema",
+    description: "获取可在用户设备上创建、搜索、追加备忘录的相关端工具列表。",
+    tools: [noteTool, searchNoteTool, modifyNoteTool],
+});

package/dist/src/tools/get-photo-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getPhotoToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/src/tools/get-photo-tool-schema.js

@@ -0,0 +1,10 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { searchPhotoGalleryTool } from "./search-photo-gallery-tool.js";
+import { uploadPhotoTool } from "./upload-photo-tool.js";
+import { saveMediaToGalleryTool } from "./save-media-to-gallery-tool.js";
+export const getPhotoToolSchemaTool = createSchemaTool({
+    name: "get_photo_tool_schema",
+    label: "Get Photo Tool Schema",
+    description: "获取可在用户设备上搜索图库照片、将照片上传到公网并获取链接、保存图片或视频到图库的相关端工具列表。",
+    tools: [searchPhotoGalleryTool, uploadPhotoTool, saveMediaToGalleryTool],
+});

package/dist/src/tools/image-reading-tool.js

@@ -223,10 +223,7 @@ export const imageReadingTool = {
 工具能力描述：对图片进行理解和分析，返回图片的描述内容。
 
 工具参数说明：
-a. localUrl：本地图片文件路径（可选，通常从用户消息的 mediaPath 字段获取）
-b. remoteUrl：公网图片地址（可选）
-c. prompt：对图片的提示问题，默认为"描述这张图片内容"，可根据用户的具体问题自定义
-d. localUrl 与 remoteUrl 任意一个不为空即可，优先使用 localUrl
+localUrl 与 remoteUrl 任意一个不为空即可，优先使用 localUrl
 
 注意事项：
 a. 支持常见图片格式（jpg, png, gif等）
@@ -238,15 +235,15 @@ d. 返回图像理解的文本描述内容`,
         properties: {
             localUrl: {
                 type: "string",
-                description: "本地图片文件路径",
+                description: "本地图片文件路径（可选，通常从用户消息的 mediaPath 字段获取）",
             },
             remoteUrl: {
                 type: "string",
-                description: "公网图片地址（HTTP/HTTPS URL）",
+                description: "公网图片地址（可选）,公网图片地址（HTTP/HTTPS URL）",
             },
             prompt: {
                 type: "string",
-                description: "对图片的提示问题，默认为'描述这张图片内容'",
+                description: "对图片的提示问题，默认为'描述这张图片内容'，可根据用户的具体问题自定义",
             },
         },
     },

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

@@ -20,23 +20,10 @@ export const modifyAlarmTool = {
     label: "Modify Alarm",
     description: `修改用户设备上已存在的闹钟。
 
-必需参数：
-- entityId: 闹钟的唯一标识符，必须先通过 search_alarm 或 create_alarm 工具获取
-
-可选参数（与创建闹钟的参数完全一致）：
-- alarmTime: 闹钟时间，格式必须为：YYYYMMDD hhmmss（例如：20240315 143000）
-- alarmTitle: 闹钟名称/标题
-- alarmState: 闹钟开启状态，0=关闭，1=开启
-- alarmSnoozeDuration: 小睡间隔（分钟），枚举值：5,10,15,20,25,30
-- alarmSnoozeTotal: 再响次数，枚举值：0,1,3,5,10
-- alarmRingDuration: 响铃时长（分钟），枚举值：1,5,10,15,20,30
-- daysOfWakeType: 闹钟响铃类型，枚举值：0=单次，1=法定节假日，2=每天，3=自定义，4=法定工作日
-- daysOfWeek: 自定义响铃星期，仅当daysOfWakeType=3（自定义时间）时必需且有效，其他情况不要传递此参数。数组或JSON字符串，枚举值：Mon,Tues,Wed,Thur,Fri,Sat,Sun。
-
 使用流程：
 1. 先调用 search_alarm 工具查询闹钟，获取 entityId，
 2. 调用此工具修改闹钟，传入 entityId 和需要修改的参数
-3. 其余不涉及需改的参数，如果search_alarm 或 create_alarm的结果中有相应的值，需要一并填上，需要与原有的保持一致，防止不填采用默认值
+3. 其余不涉及修改的参数，如果search_alarm 或 create_alarm的结果中有相应的值，需要一并填上，需要与原有的保持一致，防止不填采用默认值
 
 注意事项：操作超时时间为60秒，请勿重复调用此工具，如果超时或失败，最多重试一次。
 
@@ -46,40 +33,40 @@ export const modifyAlarmTool = {
         properties: {
             entityId: {
                 type: "string",
-                description: "闹钟的唯一标识符，必须先通过 search_alarm 或 create_alarm 工具获取",
+                description: "（必需）闹钟的唯一标识符，必须先通过 search_alarm 或 create_alarm 工具获取",
             },
             alarmTime: {
                 type: "string",
-                description: "闹钟时间，格式必须为：YYYYMMDD hhmmss（例如：20240315 143000）",
+                description: "（可选）闹钟时间，格式必须为：YYYYMMDD hhmmss（例如：20240315 143000）",
             },
             alarmTitle: {
                 type: "string",
-                description: "闹钟名称/标题",
+                description: "（可选）闹钟名称/标题",
             },
             alarmState: {
                 type: "number",
-                description: "闹钟开启状态：0=关闭，1=开启",
+                description: "（可选）闹钟开启状态，枚举值：0=关闭，1=开启",
             },
             alarmSnoozeDuration: {
                 type: "number",
-                description: "小睡间隔（分钟），枚举值：5,10,15,20,25,30",
+                description: "（可选）小睡间隔（分钟），枚举值：5,10,15,20,25,30",
             },
             alarmSnoozeTotal: {
                 type: "number",
-                description: "再响次数，枚举值：0,1,3,5,10",
+                description: "（可选）再响次数，枚举值：0,1,3,5,10",
             },
             alarmRingDuration: {
                 type: "number",
-                description: "响铃时长（分钟），枚举值：1,5,10,15,20,30",
+                description: "（可选）响铃时长（分钟），枚举值：1,5,10,15,20,30",
             },
             daysOfWakeType: {
                 type: "number",
-                description: "闹钟响铃类型：0=单次，1=法定节假日，2=每天，3=自定义，4=法定工作日",
+                description: "（可选）闹钟响铃类型，枚举值：0=单次，1=法定节假日，2=每天，3=自定义，4=法定工作日",
             },
             daysOfWeek: {
                 // 不指定 type，允许传入数组或 JSON 字符串
                 // 具体的类型验证和转换在 execute 函数内部进行
-                description: "自定义响铃星期（仅当daysOfWakeType=3时需要，其他情况不要传递），数组或JSON字符串，枚举值：Mon,Tues,Wed,Thur,Fri,Sat,Sun。",
+                description: "（可选）自定义响铃星期，仅当daysOfWakeType=3（自定义时间）时必需且有效，其他情况不要传递此参数。数组或JSON字符串，枚举值：Mon,Tues,Wed,Thur,Fri,Sat,Sun",
             },
         },
         required: ["entityId"],

package/dist/src/tools/query-app-message-tool.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 查询指定时间范围内的设备通知消息。
+ */
+export declare const queryAppMessageTool: any;

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

@@ -0,0 +1,138 @@
+// QueryAppMessage 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 queryAppMessageTool = {
+    name: "query_app_message",
+    label: "Query App Message",
+    description: `获取指定时间范围内的设备通知消息。适用于需要查询历史通知、按应用筛选通知、或仅查看未读通知的场景。支持按时间范围、应用包名、已读/未读状态进行过滤。
+注意：
+a. 操作超时时间为60秒，请勿重复调用此工具
+b. 如果遇到各类调用失败场景，最多只能重试一次，不可以重复调用多次。
+c. 调用工具前需认真检查调用参数是否满足工具要求
+
+回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，例如告诉用户如何授权，如何解决报错等都是不需要的，请严格遵守。`,
+    parameters: {
+        type: "object",
+        properties: {
+            startTime: {
+                type: "string",
+                description: "查询通知的起始时间（ISO 8601 字符串）。若endTime为空，则默认值为24小时前。",
+            },
+            endTime: {
+                type: "string",
+                description: "查询通知的结束时间（ISO 8601 字符串）。默认值为当前时间。",
+            },
+            packageName: {
+                type: "string",
+                description: "按应用名称过滤通知（例如「微信」「小红书」）。默认值为所有应用。",
+            },
+            state: {
+                type: "integer",
+                description: "通知的已读/未读状态。0 = 全部，1 = 仅未读。默认值为 0。",
+            },
+        },
+        required: [],
+    },
+    async execute(_toolCallId, params) {
+        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 (params.packageName !== undefined)
+            intentParam.packageName = params.packageName;
+        if (params.state !== undefined) {
+            if (params.state !== 0 && params.state !== 1) {
+                throw new ToolInputError("state 参数只能为 0（全部）或 1（仅未读）");
+            }
+            intentParam.state = params.state;
+        }
+        const command = {
+            header: {
+                namespace: "Common",
+                name: "Action",
+            },
+            payload: {
+                cardParam: {},
+                executeParam: {
+                    executeMode: "background",
+                    intentName: "QueryAppMessage",
+                    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 === "QueryAppMessage") {
+                    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-memory-data-tool.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 查询存储在设备本地的结构化记忆数据。
+ */
+export declare const queryMemoryDataTool: any;