@larksuite/openclaw-lark 2026.3.9

package/src/tools/oapi/search/doc-search.js

@@ -0,0 +1,203 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_search_doc_wiki tool -- Search Feishu documents and wikis.
+ *
+ * Actions: search
+ *
+ * Uses the Feishu Search API:
+ *   - search: POST /open-apis/search/v2/doc_wiki/search
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { Type } from '@sinclair/typebox';
+import { json, createToolContext, handleInvokeErrorWithAutoAuth, convertTimeRange, unixTimestampToISO8601, } from '../helpers';
+// ---------------------------------------------------------------------------
+// Schema - Helper types
+// ---------------------------------------------------------------------------
+const TimeRangeSchema = Type.Object({
+    start: Type.Optional(Type.String({
+        description: "时间范围的起始时间，ISO 8601 / RFC 3339 格式（包含时区），例如 '2024-01-01T00:00:00+08:00'",
+    })),
+    end: Type.Optional(Type.String({
+        description: "时间范围的截止时间，ISO 8601 / RFC 3339 格式（包含时区），例如 '2024-01-01T00:00:00+08:00'",
+    })),
+});
+const DocTypeEnum = Type.Union([
+    Type.Literal('DOC'),
+    Type.Literal('SHEET'),
+    Type.Literal('BITABLE'),
+    Type.Literal('MINDNOTE'),
+    Type.Literal('FILE'),
+    Type.Literal('WIKI'),
+    Type.Literal('DOCX'),
+    Type.Literal('FOLDER'),
+    Type.Literal('CATALOG'),
+    Type.Literal('SLIDES'),
+    Type.Literal('SHORTCUT'),
+]);
+const SortTypeEnum = Type.Union([
+    Type.Literal('DEFAULT_TYPE'),
+    Type.Literal('OPEN_TIME'),
+    Type.Literal('EDIT_TIME'), // User编辑时间降序（推荐获取最新文档）
+    Type.Literal('EDIT_TIME_ASC'),
+    // 以下排序类型暂不支持：
+    // Type.Literal("ENTITY_CREATE_TIME_ASC"),
+    // Type.Literal("ENTITY_CREATE_TIME_DESC"),
+    Type.Literal('CREATE_TIME'),
+    // Type.Literal("CREATE_TIME_ASC"),
+], {
+    description: '排序方式。EDIT_TIME=编辑时间降序（最新文档在前，推荐），EDIT_TIME_ASC=编辑时间升序，CREATE_TIME=按文档创建时间排序，OPEN_TIME=打开时间，DEFAULT_TYPE=默认排序',
+});
+// ---------------------------------------------------------------------------
+// Schema - Main
+// ---------------------------------------------------------------------------
+const FeishuSearchDocWikiSchema = Type.Object({
+    action: Type.Literal('search'),
+    query: Type.Optional(Type.String({
+        description: '搜索关键词（可选）。不传或传空字符串表示空搜，也可以支持排序规则与筛选，默认根据最近浏览时间返回结果',
+        maxLength: 50,
+    })),
+    filter: Type.Optional(Type.Object({
+        creator_ids: Type.Optional(Type.Array(Type.String(), {
+            description: '创建者 OpenID 列表（最多 20 个）',
+            maxItems: 20,
+        })),
+        doc_types: Type.Optional(Type.Array(DocTypeEnum, {
+            description: '文档类型列表：DOC（文档）、SHEET（表格）、BITABLE（多维表格）、MINDNOTE（思维导图）、FILE（文件）、WIKI（维基）、DOCX（新版文档）、FOLDER（space文件夹）、CATALOG（wiki2.0文件夹）、SLIDES（新版幻灯片）、SHORTCUT（快捷方式）',
+            maxItems: 10,
+        })),
+        only_title: Type.Optional(Type.Boolean({
+            description: '仅搜索标题（默认 false，搜索标题和正文）',
+        })),
+        open_time: Type.Optional(TimeRangeSchema),
+        sort_type: Type.Optional(SortTypeEnum),
+        create_time: Type.Optional(TimeRangeSchema),
+    }, {
+        description: '搜索过滤条件（可选）。不传则搜索所有文档和 Wiki；传了则同时对文档和 Wiki 应用相同的过滤条件。',
+    })),
+    page_token: Type.Optional(Type.String({
+        description: '分页标记。首次请求不填；当返回结果中 has_more 为 true 时，可传入返回的 page_token 继续请求下一页',
+    })),
+    page_size: Type.Optional(Type.Integer({
+        description: '分页大小（默认 15，最大 20）',
+        minimum: 0,
+        maximum: 20,
+    })),
+});
+function normalizeSearchResultTimeFields(value, converted) {
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeSearchResultTimeFields(item, converted));
+    }
+    if (!value || typeof value !== 'object') {
+        return value;
+    }
+    const source = value;
+    const normalized = {};
+    for (const [key, item] of Object.entries(source)) {
+        if (key.endsWith('_time')) {
+            const iso = unixTimestampToISO8601(item);
+            if (iso) {
+                normalized[key] = iso;
+                converted.count += 1;
+                continue;
+            }
+        }
+        normalized[key] = normalizeSearchResultTimeFields(item, converted);
+    }
+    return normalized;
+}
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+export function registerFeishuSearchDocWikiTool(api) {
+    if (!api.config)
+        return;
+    const cfg = api.config;
+    const { toolClient, log } = createToolContext(api, 'feishu_search_doc_wiki');
+    api.registerTool({
+        name: 'feishu_search_doc_wiki',
+        label: 'Feishu Document & Wiki Search',
+        description: '【以用户身份】飞书文档与 Wiki 统一搜索工具。同时搜索云空间文档和知识库 Wiki。Actions: search。' +
+            '【重要】query 参数是搜索关键词（必填），filter 参数可选。' +
+            '【重要】filter 不传时，搜索所有文档和 Wiki；传了则同时对文档和 Wiki 应用相同的过滤条件。' +
+            '【重要】支持按文档类型、创建者、创建时间、打开时间等多维度筛选。' +
+            '【重要】返回结果包含标题和摘要高亮（<h>标签包裹匹配关键词）。',
+        parameters: FeishuSearchDocWikiSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = toolClient();
+                switch (p.action) {
+                    // -----------------------------------------------------------------
+                    // SEARCH DOCUMENTS AND WIKIS
+                    // -----------------------------------------------------------------
+                    case 'search': {
+                        // query 为可选参数，默认使用空字符串（表示空搜）
+                        const query = p.query ?? '';
+                        log.info(`search: query="${query}", has_filter=${!!p.filter}, page_size=${p.page_size ?? 15}`);
+                        // 构建请求体
+                        const requestData = {
+                            query: query,
+                            page_size: p.page_size,
+                            page_token: p.page_token,
+                        };
+                        // 必须传递 doc_filter 和 wiki_filter，即使为空对象（API 要求）
+                        if (p.filter) {
+                            const filter = { ...p.filter };
+                            // 处理时间字段转换
+                            if (filter.open_time) {
+                                filter.open_time = convertTimeRange(filter.open_time);
+                            }
+                            if (filter.create_time) {
+                                filter.create_time = convertTimeRange(filter.create_time);
+                            }
+                            // 同时设置 doc_filter 和 wiki_filter（内容相同）
+                            requestData.doc_filter = { ...filter };
+                            requestData.wiki_filter = { ...filter };
+                            log.info(`search: applying filter to both doc and wiki: doc_types=${filter.doc_types?.join(',') || 'all'}, only_title=${filter.only_title ?? false}`);
+                        }
+                        else {
+                            // 即使没有筛选条件，也必须传空对象（否则 API 不返回内容）
+                            requestData.doc_filter = {};
+                            requestData.wiki_filter = {};
+                            log.info(`search: no filter provided, using empty filters (required by API)`);
+                        }
+                        // 使用 client.invoke 统一封装底层 request 调用
+                        const res = await client.invoke('feishu_search_doc_wiki.search', async (sdk, _opts, uat) => {
+                            return sdk.request({
+                                method: 'POST',
+                                url: '/open-apis/search/v2/doc_wiki/search',
+                                data: requestData,
+                                headers: {
+                                    Authorization: `Bearer ${uat}`,
+                                    'Content-Type': 'application/json; charset=utf-8',
+                                },
+                            }, _opts);
+                        }, { as: 'user' });
+                        // 检查响应
+                        if (res.code !== 0) {
+                            throw new Error(`API Error: code=${res.code}, msg=${res.msg}`);
+                        }
+                        const data = res.data || {};
+                        log.info(`search: found ${data.res_units?.length ?? 0} results, total=${data.total ?? 0}, has_more=${data.has_more ?? false}`);
+                        const converted = { count: 0 };
+                        const normalizedResults = normalizeSearchResultTimeFields(data.res_units, converted);
+                        log.info(`search: normalized ${converted.count} timestamp fields to ISO8601`);
+                        return json({
+                            total: data.total,
+                            has_more: data.has_more,
+                            results: normalizedResults,
+                            page_token: data.page_token,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                return await handleInvokeErrorWithAutoAuth(err, cfg);
+            }
+        },
+    }, { name: 'feishu_search_doc_wiki' });
+    api.logger.info?.('feishu_search_doc_wiki: Registered feishu_search_doc_wiki tool');
+}
+//# sourceMappingURL=doc-search.js.map

package/src/tools/oapi/search/doc-search.js.map

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

package/src/tools/oapi/search/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Search 工具集
+ * 统一导出所有搜索相关工具的注册函数
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+/**
+ * 注册所有 Search 工具
+ */
+export declare function registerFeishuSearchTools(api: OpenClawPluginApi): void;
+//# sourceMappingURL=index.d.ts.map

package/src/tools/oapi/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tools/oapi/search/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAK7D;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,iBAAiB,QAuB/D"}

package/src/tools/oapi/search/index.js

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Search 工具集
+ * 统一导出所有搜索相关工具的注册函数
+ */
+import { getEnabledLarkAccounts } from '../../../core/accounts';
+import { resolveAnyEnabledToolsConfig } from '../../../core/tools-config';
+import { registerFeishuSearchDocWikiTool } from './doc-search';
+/**
+ * 注册所有 Search 工具
+ */
+export function registerFeishuSearchTools(api) {
+    if (!api.config) {
+        api.logger.debug?.('feishu_search: No config available, skipping');
+        return;
+    }
+    const accounts = getEnabledLarkAccounts(api.config);
+    if (accounts.length === 0) {
+        api.logger.debug?.('feishu_search: No Feishu accounts configured, skipping');
+        return;
+    }
+    // search 工具使用 doc 配置项控制，因为搜索是文档相关功能
+    const toolsCfg = resolveAnyEnabledToolsConfig(accounts);
+    if (!toolsCfg.doc) {
+        api.logger.debug?.('feishu_search: search tool disabled in all accounts (controlled by doc config)');
+        return;
+    }
+    // 注册所有工具
+    registerFeishuSearchDocWikiTool(api);
+    api.logger.info?.('feishu_search: Registered feishu_search_doc_wiki');
+}
+//# sourceMappingURL=index.js.map

package/src/tools/oapi/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/tools/oapi/search/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAE/D;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAsB;IAC9D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,8CAA8C,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,wDAAwD,CAAC,CAAC;QAC7E,OAAO;IACT,CAAC;IAED,oCAAoC;IACpC,MAAM,QAAQ,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QAClB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,gFAAgF,CAAC,CAAC;QACrG,OAAO;IACT,CAAC;IAED,SAAS;IACT,+BAA+B,CAAC,GAAG,CAAC,CAAC;IAErC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,kDAAkD,CAAC,CAAC;AACxE,CAAC"}

package/src/tools/oapi/sheets/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Sheets 工具集
+ * 注册飞书电子表格工具
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+/**
+ * 注册 Sheets 工具
+ */
+export declare function registerFeishuSheetsTools(api: OpenClawPluginApi): void;
+//# sourceMappingURL=index.d.ts.map

package/src/tools/oapi/sheets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tools/oapi/sheets/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAK7D;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,iBAAiB,QAqB/D"}

package/src/tools/oapi/sheets/index.js

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Sheets 工具集
+ * 注册飞书电子表格工具
+ */
+import { getEnabledLarkAccounts } from '../../../core/accounts';
+import { resolveAnyEnabledToolsConfig } from '../../../core/tools-config';
+import { registerFeishuSheetTool } from './sheet';
+/**
+ * 注册 Sheets 工具
+ */
+export function registerFeishuSheetsTools(api) {
+    if (!api.config) {
+        api.logger.debug?.('feishu_sheets: No config available, skipping');
+        return;
+    }
+    const accounts = getEnabledLarkAccounts(api.config);
+    if (accounts.length === 0) {
+        api.logger.debug?.('feishu_sheets: No Feishu accounts configured, skipping');
+        return;
+    }
+    const toolsCfg = resolveAnyEnabledToolsConfig(accounts);
+    if (!toolsCfg.sheets) {
+        api.logger.debug?.('feishu_sheets: sheets tool disabled in all accounts');
+        return;
+    }
+    registerFeishuSheetTool(api);
+    api.logger.info?.('feishu_sheets: Registered feishu_sheet tool');
+}
+//# sourceMappingURL=index.js.map

package/src/tools/oapi/sheets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/tools/oapi/sheets/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAsB;IAC9D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,8CAA8C,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,wDAAwD,CAAC,CAAC;QAC7E,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,qDAAqD,CAAC,CAAC;QAC1E,OAAO;IACT,CAAC;IAED,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAE7B,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,6CAA6C,CAAC,CAAC;AACnE,CAAC"}

package/src/tools/oapi/sheets/sheet.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_sheet — 飞书电子表格统一工具。
+ *
+ * Actions: info, read, write, append, find, create, export
+ *
+ * 设计原则：
+ *   - 接受 URL 或 spreadsheet_token（工具层自动解析）
+ *   - read 不指定 range 时自动读取第一个工作表全部数据
+ *   - create 支持带表头和初始数据一步创建
+ *   - info 一次返回表格信息 + 全部工作表列表
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuSheetTool(api: OpenClawPluginApi): void;
+//# sourceMappingURL=sheet.d.ts.map

package/src/tools/oapi/sheets/sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet.d.ts","sourceRoot":"","sources":["../../../../../src/tools/oapi/sheets/sheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAuc7D,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,QAme7D"}