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

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

@@ -0,0 +1,32 @@
+/**
+ * schema-tool-factory: 创建 get_xxx_tool_schema 工具。
+ * 每个工具在被 LLM 调用时，返回其所包含的子工具的 name / description / parameters schema。
+ */
+export function createSchemaTool(options) {
+    const { name, label, description, tools } = options;
+    return {
+        name,
+        label,
+        description,
+        parameters: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+        async execute(_toolCallId, _params) {
+            const schemas = tools.map((t) => ({
+                name: t.name,
+                description: t.description,
+                parameters: t.parameters,
+            }));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(schemas, null, 2),
+                    },
+                ],
+            };
+        },
+    };
+}

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

@@ -15,14 +15,7 @@ const DAYS_OF_WAKE_TYPE_VALUES = [0, 1, 2, 3, 4];
 export const searchAlarmTool = {
     name: "search_alarm",
     label: "Search Alarm",
-    description: `检索用户设备上的闹钟。支持多种检索条件，至少需要提供一个检索条件，多个条件可以组合使用。
-
-检索条件（至少提供一个）：
-- rangeType: 查询范围，枚举值：all=查询所有闹钟，next=查找下一个响铃闹钟，current=一小时内最近一次增查改的闹钟
-- alarmState: 闹钟开启状态，0=关闭，1=开启
-- daysOfWakeType: 闹钟响铃类型，0=单次响铃，1=法定节假日，2=每天，3=自定义时间，4=法定工作日
-- startTime: 时间间隔开始，格式 YYYYMMDD hhmmss（例如：20240315 000000），需要与 endTime 一起使用
-- endTime: 时间间隔结束，格式 YYYYMMDD hhmmss（例如：20240315 235959），需要与 startTime 一起使用
+    description: `检索用户设备上的闹钟。至少需要提供一个检索条件，多个条件可以组合使用。
 
 使用示例：
 - 查询所有闹钟：{"rangeType": "all"}
@@ -41,25 +34,25 @@ b. 使用该工具之前需获取当前真实时间
             rangeType: {
                 type: "string",
                 enum: ["all", "next", "current"],
-                description: "查询范围：all=所有闹钟，next=下一个响铃闹钟，current=一小时内最近修改的闹钟",
+                description: "（检索条件之一）查询范围，枚举值：all=查询所有闹钟，next=查找下一个响铃闹钟，current=一小时内最近一次增查改的闹钟",
             },
             alarmState: {
                 type: "number",
                 enum: [0, 1],
-                description: "闹钟开启状态：0=关闭，1=开启",
+                description: "（检索条件之一）闹钟开启状态，枚举值：0=关闭，1=开启",
             },
             daysOfWakeType: {
                 type: "number",
                 enum: [0, 1, 2, 3, 4],
-                description: "闹钟响铃类型：0=单次，1=法定节假日，2=每天，3=自定义，4=法定工作日",
+                description: "（检索条件之一）闹钟响铃类型，枚举值：0=单次响铃，1=法定节假日，2=每天，3=自定义时间，4=法定工作日",
             },
             startTime: {
                 type: "string",
-                description: "时间间隔开始，格式 YYYYMMDD hhmmss（例如：20240315 000000），必须与 endTime 一起使用",
+                description: "（检索条件之一）时间间隔开始，格式 YYYYMMDD hhmmss（例如：20240315 000000），必须与 endTime 一起使用",
             },
             endTime: {
                 type: "string",
-                description: "时间间隔结束，格式 YYYYMMDD hhmmss（例如：20240315 235959），必须与 startTime 一起使用",
+                description: "（检索条件之一）时间间隔结束，格式 YYYYMMDD hhmmss（例如：20240315 235959），必须与 startTime 一起使用",
             },
         },
     },

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

@@ -27,6 +27,8 @@ export const searchCalendarTool = {
 注意：
 a. 该工具执行时间较长（最多60秒），请勿重复调用，超时或失败时最多重试一次。
 b. 使用该工具之前需获取当前真实时间
+c. 该工具仅支持不超过28天时间范围的日程查询，如果时间区间大于该窗口需要拆分多个时间窗口进行多次查询
+d. 如果查询结果返回-303，代表查询结果为空
 
 回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，例如告诉用户如何授权，如何解决报错等都是不需要的，请严格遵守。
 `,

package/dist/src/tools/search-email-tool.d.ts

@@ -0,0 +1,5 @@
+/**
+ * XY search email tool - searches emails on user's device (花瓣邮箱).
+ * Returns matching emails based on query text and search type.
+ */
+export declare const searchEmailTool: any;

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

@@ -0,0 +1,137 @@
+// Search Email tool implementation
+import { getXYWebSocketManager } from "../client.js";
+import { sendCommand } from "../formatter.js";
+import { getCurrentSessionContext } from "./session-manager.js";
+/**
+ * XY search email tool - searches emails on user's device (花瓣邮箱).
+ * Returns matching emails based on query text and search type.
+ */
+export const searchEmailTool = {
+    name: "search_email",
+    label: "Search Email",
+    description: `检索用户花瓣邮箱中的邮件。根据查询语料和搜索类型检索邮件。
+
+使用示例：
+- 通用搜索：{"queryText": "个人所得税邮件", "type": 0}
+- 按主题搜索：{"queryText": "会议纪要", "type": 1}
+- 按发件人搜索：{"queryText": "张三", "type": 2}
+- 按收件人搜索：{"queryText": "李四", "type": 3}
+
+注意：
+a. 操作超时时间为60秒，请勿重复调用此工具，如果超时或失败，最多重试一次。
+b. 使用该工具之前需获取当前真实时间
+
+回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，例如告诉用户如何授权，如何解决报错等都是不需要的，请严格遵守。`,
+    parameters: {
+        type: "object",
+        properties: {
+            queryText: {
+                type: "string",
+                description: "查询语料，用于搜索邮件的关键词或语句",
+            },
+            type: {
+                type: "number",
+                enum: [0, 1, 2, 3],
+                description: "搜索类型：0=全部(all)，1=主题(subject)，2=发件人(fromList)，3=收件人(toList)。默认为0",
+            },
+        },
+        required: ["queryText"],
+    },
+    async execute(_toolCallId, params) {
+        // ===== Validate queryText =====
+        if (!params.queryText || typeof params.queryText !== "string" || !params.queryText.trim()) {
+            throw new Error("queryText 为必填参数，且不能为空字符串");
+        }
+        // ===== Validate type =====
+        const searchType = params.type ?? 0;
+        if (typeof searchType !== "number" || ![0, 1, 2, 3].includes(searchType)) {
+            throw new Error("type 必须是 0-3 的整数：0=全部，1=主题，2=发件人，3=收件人");
+        }
+        // Get session context
+        const sessionContext = getCurrentSessionContext();
+        if (!sessionContext) {
+            throw new Error("No active XY session found. Search email tool can only be used during an active conversation.");
+        }
+        const { config, sessionId, taskId, messageId } = sessionContext;
+        // Get WebSocket manager
+        const wsManager = getXYWebSocketManager(config);
+        // Build SearchEmails command
+        const command = {
+            header: {
+                namespace: "Common",
+                name: "Action",
+            },
+            payload: {
+                cardParam: {},
+                executeParam: {
+                    executeMode: "background",
+                    intentName: "SearchEmails",
+                    bundleName: "com.huawei.hmos.email",
+                    needUnlock: true,
+                    actionResponse: true,
+                    appType: "OHOS_APP",
+                    timeOut: 5,
+                    intentParam: {
+                        type: searchType,
+                        queryText: params.queryText.trim(),
+                    },
+                    permissionId: [],
+                    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 === "SearchEmails") {
+                    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/search-file-tool.js

@@ -8,15 +8,15 @@ import { getCurrentSessionContext } from "./session-manager.js";
 export const searchFileTool = {
     name: "search_file",
     label: "Search File",
-    description: `搜索手机文件系统的文件。
+    description: `搜索用户设备文件系统的文件。
 
-【重要】使用约束：此工具仅在用户显著说明要从手机搜索时才执行，例如：
-- "从我手机里面搜索xxxx"
+【重要】使用约束：此工具仅在用户显著说明要从手机/PC等用户设备搜索时才执行，例如：
+- "从我手机/鸿蒙PC里面搜索xxxx"
 - "从手机文件系统找一下xxxx"
 - "在手机上查找文件xxxx"
 - "搜索手机里的文件"
 
-如果用户没有明确说明从手机搜索（如仅说"搜索文件"、"找一下xxxx"），应默认从 openclaw 本地的文件系统查询，不要调用此工具。
+如果用户没有明确说明从手机或者PC搜索（如仅说"搜索文件"、"找一下xxxx"），应默认从当前runtime运行环境的本地的文件系统查询，不要调用此工具。
 
 功能说明：根据关键词搜索文件名称或内容，返回匹配的文件列表（包括文件名、路径、大小、修改时间等信息）。
 

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

@@ -50,6 +50,7 @@ export const searchMessageTool = {
                     timeOut: 5,
                     intentParam: {
                         content: params.content.trim(),
+                        size: 50
                     },
                     permissionId: [],
                     achieveType: "INTENT",

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

@@ -11,9 +11,9 @@ import { getCurrentSessionContext } from "./session-manager.js";
 export const searchPhotoGalleryTool = {
     name: "search_photo_gallery",
     label: "Search Photo Gallery",
-    description: `插件功能描述：搜索用户手机图库中的照片
+    description: `插件功能描述：搜索用户设备图库中的照片
 
-  工具使用约束：如果用户说从手机图库中或者从相册中查询xx图片时调用此工具,注意此工具仅支持从本地图库检索，不支持云空间相册检索。
+  工具使用约束：如果用户说从手机/鸿蒙PC图库中或者从相册中查询xx图片时调用此工具,注意此工具仅支持从本地图库检索，不支持云空间相册检索。
 
   工具输入输出简介：
   a. 根据图像描述语料检索匹配的照片,返回照片在手机本地的 mediaUri以及thumbnailUri。

package/dist/src/tools/send-email-tool.d.ts

@@ -0,0 +1,4 @@
+/**
+ * XY send email tool - sends an email via 花瓣邮箱 on user's device.
+ */
+export declare const sendEmailTool: any;

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

@@ -0,0 +1,134 @@
+// Send Email 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";
+    }
+}
+/**
+ * XY send email tool - sends an email via 花瓣邮箱 on user's device.
+ */
+export const sendEmailTool = {
+    name: "send_email",
+    label: "Send Email",
+    description: `在用户设备上通过花瓣邮箱发送邮件。
+注意：
+a. 操作超时时间为60秒，请勿重复调用此工具
+b. 如果遇到各类调用失败场景，最多只能重试一次，不可以重复调用多次。
+c. 调用工具前需认真检查调用参数是否满足工具要求
+
+回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，例如告诉用户如何授权，如何解决报错等都是不需要的，请严格遵守。`,
+    parameters: {
+        type: "object",
+        properties: {
+            subject: {
+                type: "string",
+                description: "邮件主题，必填",
+            },
+            to: {
+                type: "string",
+                description: "收件人邮箱地址，必填",
+            },
+            body: {
+                type: "string",
+                description: "邮件内容，必填",
+            },
+        },
+        required: ["subject", "to", "body"],
+    },
+    async execute(_toolCallId, params) {
+        if (typeof params.subject !== "string" || !params.subject.trim()) {
+            throw new ToolInputError("缺少必填参数 subject（邮件主题）");
+        }
+        if (typeof params.to !== "string" || !params.to.trim()) {
+            throw new ToolInputError("缺少必填参数 to（收件人邮箱地址）");
+        }
+        if (typeof params.body !== "string" || !params.body.trim()) {
+            throw new ToolInputError("缺少必填参数 body（邮件内容）");
+        }
+        const sessionContext = getCurrentSessionContext();
+        if (!sessionContext) {
+            throw new Error("No active XY session found. Send email tool can only be used during an active conversation.");
+        }
+        const { config, sessionId, taskId, messageId } = sessionContext;
+        const wsManager = getXYWebSocketManager(config);
+        const command = {
+            header: {
+                namespace: "Common",
+                name: "Action",
+            },
+            payload: {
+                cardParam: {},
+                executeParam: {
+                    executeMode: "background",
+                    intentName: "SendEmail",
+                    bundleName: "com.huawei.hmos.email",
+                    needUnlock: true,
+                    actionResponse: true,
+                    appType: "OHOS_APP",
+                    timeOut: 5,
+                    intentParam: {
+                        subject: params.subject.trim(),
+                        to: [params.to.trim()],
+                        body: params.body.trim(),
+                    },
+                    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 === "SendEmail") {
+                    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/send-file-to-user-tool.js

@@ -99,12 +99,10 @@ async function downloadRemoteFile(url) {
 export const sendFileToUserTool = {
     name: "send_file_to_user",
     label: "Send File to User",
-    description: `工具能力描述：帮助用户把本地的文件或者公网地址的文件传到手机。
+    description: `工具能力描述：帮助用户把本地的文件或者公网地址的文件传到用户设备。
 
 工具参数说明：
-a. fileLocalUrls：本地文件路径数组，包含用户需要回传的文件在本地的地址
-b. fileRemoteUrls：公网地址数组，包含用户需要回传的文件的公网地址（会先下载到本地再发送）
-c. fileLocalUrls 与 fileRemoteUrls 任意一个不为空即可，两者都提供时都会处理
+a. fileLocalUrls 与 fileRemoteUrls 任意一个不为空即可，两者都提供时都会处理
 
 注意事项：
 a. 支持传入数组或 JSON 字符串格式

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

@@ -5,6 +5,7 @@ export interface SessionContext {
     taskId: string;
     messageId: string;
     agentId: string;
+    deviceType?: string;
 }
 /**
  * Register a session context for tool access.

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

@@ -16,14 +16,14 @@ import { getCurrentSessionContext } from "./session-manager.js";
 export const uploadFileTool = {
     name: "upload_file",
     label: "Upload File",
-    description: `工具能力描述：将手机本地文件上传并获取可公网访问的 URL。
+    description: `工具能力描述：将用户本地设备文件上传并获取可公网访问的 URL。
 
-  前置工具调用：此工具使用前必须先调用 search_file 工具获取文件的 uri
+  前置工具调用：此工具使用前必须先通过call_device_tool调用 search_file 或者 query_collection 工具获取文件的 uri
 
   工具参数说明：
-  a. 入参中的fileInfos数组，每个元素必须包含mediaUri字段（对应于search_file工具返回结果中的uri），必须与search_file结果中对应的uri完全保持一致，不要自行修改。
+  a. 入参中的fileInfos数组，每个元素必须包含mediaUri字段（对应于search_file工具或者query_collection返回结果中的uri），必须与search_file或者query_collection结果中对应的uri完全保持一致，不要自行修改。
   b. fileInfos中的timeout字段是可选的，表示上传文件超时时间，单位是毫秒，默认是20000（20秒）。
-  c. fileInfos 是文件在手机本地的信息数组（从 search_file 工具响应中获取）。限制：每次最多支持传入 5 条文件信息。
+  c. fileInfos 是文件在用户设备本地的信息数组（从 search_file 工具或者query_collection 工具响应中获取）。限制：每次最多支持传入 5 条文件信息。
 
   注意事项：
   a. 操作超时时间为60秒,请勿重复调用此工具,如果超时或失败,最多重试一次。

package/dist/src/tools/upload-photo-tool.js

@@ -12,9 +12,9 @@ import { getCurrentSessionContext } from "./session-manager.js";
 export const uploadPhotoTool = {
     name: "upload_photo",
     label: "Upload Photo",
-    description: `工具能力描述：将手机本地文件回传并获取可公网访问的 URL。
+    description: `工具能力描述：将用户本地设备文件回传并获取可公网访问的 URL。
   
-  前置工具调用：此工具使用前必须先调用 search_photo_gallery 工具获取照片的 mediaUri或者thumbnailUri
+  前置工具调用：此工具使用前必须先通过call_device_tool工具调用 search_photo_gallery 工具获取照片的 mediaUri或者thumbnailUri
   工具参数说明：
   a. 入参中的mediaUris中的mediaUri必须与search_photo_gallery结果中对应的mediaUri或者thumbnailUri完全保持一致，不要自行修改，必须是file:://开头的路径。
   b. 优先使用search_photo_gallery结果中的thumbnailUri作为入参，thumbnailUri是缩略图，清晰度与文件大小都非常合适展示给用户，如果thumbnailUri不存在或者用户要求使用原图，则使用search_photo_gallery结果中对应的mediaUri

package/dist/src/tools/xiaoyi-add-collection-tool.d.ts

@@ -0,0 +1,4 @@
+/**
+ * XY add collection tool - adds data to user's XiaoYi collection.
+ */
+export declare const xiaoyiAddCollectionTool: any;