@larksuite/openclaw-lark 2026.3.9

package/src/tools/oapi/im/time-utils.js

@@ -0,0 +1,202 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * 时间工具函数 — 对齐 Go 实现 (time.go + timerange.go)
+ *
+ * 以 ISO 8601 (RFC 3339) 作为标准时间交换格式，
+ * 提供 ISO 8601 ↔ Unix 转换工具及时间范围解析。
+ */
+const BJ_OFFSET_MS = 8 * 60 * 60 * 1000;
+// ===========================================================================
+// ISO 8601 ↔ Unix 转换工具（对齐 time.go）
+// ===========================================================================
+/** 将 Date 格式化为北京时间 ISO 8601 字符串 */
+function formatBeijingISO(d) {
+    const bj = new Date(d.getTime() + BJ_OFFSET_MS);
+    const y = bj.getUTCFullYear();
+    const mo = String(bj.getUTCMonth() + 1).padStart(2, '0');
+    const da = String(bj.getUTCDate()).padStart(2, '0');
+    const h = String(bj.getUTCHours()).padStart(2, '0');
+    const mi = String(bj.getUTCMinutes()).padStart(2, '0');
+    const s = String(bj.getUTCSeconds()).padStart(2, '0');
+    return `${y}-${mo}-${da}T${h}:${mi}:${s}+08:00`;
+}
+// ---------------------------------------------------------------------------
+// Unix 秒 → ISO 8601
+// ---------------------------------------------------------------------------
+/** Unix 秒（数字）→ ISO 8601 北京时间 */
+export function secondsToDateTime(seconds) {
+    return formatBeijingISO(new Date(seconds * 1000));
+}
+/** Unix 秒（字符串）→ ISO 8601 北京时间 */
+export function secondsStringToDateTime(seconds) {
+    return secondsToDateTime(parseInt(seconds, 10));
+}
+// ---------------------------------------------------------------------------
+// Unix 毫秒 → ISO 8601
+// ---------------------------------------------------------------------------
+/** Unix 毫秒（数字）→ ISO 8601 北京时间 */
+export function millisToDateTime(millis) {
+    return formatBeijingISO(new Date(millis));
+}
+/** Unix 毫秒（字符串）→ ISO 8601 北京时间 */
+export function millisStringToDateTime(millis) {
+    return millisToDateTime(parseInt(millis, 10));
+}
+// ---------------------------------------------------------------------------
+// ISO 8601 → Unix
+// ---------------------------------------------------------------------------
+/** ISO 8601 → Unix 秒（数字） */
+export function dateTimeToSeconds(datetime) {
+    const d = new Date(datetime);
+    if (isNaN(d.getTime())) {
+        throw new Error(`无法解析 ISO 8601 时间: "${datetime}"。格式示例: 2026-02-27T14:30:00+08:00`);
+    }
+    return Math.floor(d.getTime() / 1000);
+}
+/** ISO 8601 → Unix 秒（字符串） */
+export function dateTimeToSecondsString(datetime) {
+    return dateTimeToSeconds(datetime).toString();
+}
+/** ISO 8601 → Unix 毫秒（数字） */
+export function dateTimeToMillis(datetime) {
+    const d = new Date(datetime);
+    if (isNaN(d.getTime())) {
+        throw new Error(`无法解析 ISO 8601 时间: "${datetime}"。格式示例: 2026-02-27T14:30:00+08:00`);
+    }
+    return d.getTime();
+}
+/**
+ * 解析时间范围标识，返回 ISO 8601 字符串对。
+ *
+ * 支持的格式：
+ * - `today` / `yesterday` / `day_before_yesterday`
+ * - `this_week` / `last_week` / `this_month` / `last_month`
+ * - `last_{N}_{unit}` — unit: minutes / hours / days
+ *
+ * 所有计算基于北京时间 (UTC+8)。
+ */
+export function parseTimeRange(input) {
+    const now = new Date();
+    const bjNow = toBeijingDate(now);
+    let start;
+    let end;
+    switch (input) {
+        case 'today':
+            start = beijingStartOfDay(bjNow);
+            end = now;
+            break;
+        case 'yesterday': {
+            const d = new Date(bjNow);
+            d.setUTCDate(d.getUTCDate() - 1);
+            start = beijingStartOfDay(d);
+            end = beijingEndOfDay(d);
+            break;
+        }
+        case 'day_before_yesterday': {
+            const d = new Date(bjNow);
+            d.setUTCDate(d.getUTCDate() - 2);
+            start = beijingStartOfDay(d);
+            end = beijingEndOfDay(d);
+            break;
+        }
+        case 'this_week': {
+            const day = bjNow.getUTCDay(); // 0=Sun .. 6=Sat
+            const diffToMon = day === 0 ? 6 : day - 1;
+            const monday = new Date(bjNow);
+            monday.setUTCDate(monday.getUTCDate() - diffToMon);
+            start = beijingStartOfDay(monday);
+            end = now;
+            break;
+        }
+        case 'last_week': {
+            const day = bjNow.getUTCDay();
+            const diffToMon = day === 0 ? 6 : day - 1;
+            const thisMonday = new Date(bjNow);
+            thisMonday.setUTCDate(thisMonday.getUTCDate() - diffToMon);
+            const lastMonday = new Date(thisMonday);
+            lastMonday.setUTCDate(lastMonday.getUTCDate() - 7);
+            const lastSunday = new Date(thisMonday);
+            lastSunday.setUTCDate(lastSunday.getUTCDate() - 1);
+            start = beijingStartOfDay(lastMonday);
+            end = beijingEndOfDay(lastSunday);
+            break;
+        }
+        case 'this_month': {
+            const firstDay = new Date(Date.UTC(bjNow.getUTCFullYear(), bjNow.getUTCMonth(), 1));
+            start = beijingStartOfDay(firstDay);
+            end = now;
+            break;
+        }
+        case 'last_month': {
+            const firstDayThisMonth = new Date(Date.UTC(bjNow.getUTCFullYear(), bjNow.getUTCMonth(), 1));
+            const lastDayPrevMonth = new Date(firstDayThisMonth);
+            lastDayPrevMonth.setUTCDate(lastDayPrevMonth.getUTCDate() - 1);
+            const firstDayPrevMonth = new Date(Date.UTC(lastDayPrevMonth.getUTCFullYear(), lastDayPrevMonth.getUTCMonth(), 1));
+            start = beijingStartOfDay(firstDayPrevMonth);
+            end = beijingEndOfDay(lastDayPrevMonth);
+            break;
+        }
+        default: {
+            // last_{N}_{unit} — 只支持 minutes / hours / days（对齐 Go）
+            const match = input.match(/^last_(\d+)_(minutes?|hours?|days?)$/);
+            if (!match) {
+                throw new Error(`不支持的 relative_time 格式: "${input}"。` +
+                    '支持: today, yesterday, day_before_yesterday, this_week, last_week, this_month, last_month, last_{N}_{unit}（unit: minutes/hours/days）');
+            }
+            const n = parseInt(match[1], 10);
+            const unit = match[2].replace(/s$/, ''); // normalize plural
+            start = subtractFromNow(now, n, unit);
+            end = now;
+            break;
+        }
+    }
+    return {
+        start: formatBeijingISO(start),
+        end: formatBeijingISO(end),
+    };
+}
+/**
+ * 解析时间范围标识，返回 Unix 秒字符串对（供 SDK 调用）。
+ */
+export function parseTimeRangeToSeconds(input) {
+    const range = parseTimeRange(input);
+    return {
+        start: dateTimeToSecondsString(range.start),
+        end: dateTimeToSecondsString(range.end),
+    };
+}
+// ===========================================================================
+// Internal helpers
+// ===========================================================================
+/** 将 UTC Date 转为「北京时间各部分存在 UTC 字段上」的 Date */
+function toBeijingDate(d) {
+    return new Date(d.getTime() + BJ_OFFSET_MS);
+}
+/** 北京时间当天 00:00:00 对应的真实 UTC Date */
+function beijingStartOfDay(bjDate) {
+    return new Date(Date.UTC(bjDate.getUTCFullYear(), bjDate.getUTCMonth(), bjDate.getUTCDate()) - BJ_OFFSET_MS);
+}
+/** 北京时间当天 23:59:59 对应的真实 UTC Date */
+function beijingEndOfDay(bjDate) {
+    return new Date(Date.UTC(bjDate.getUTCFullYear(), bjDate.getUTCMonth(), bjDate.getUTCDate(), 23, 59, 59) - BJ_OFFSET_MS);
+}
+function subtractFromNow(now, n, unit) {
+    const d = new Date(now);
+    switch (unit) {
+        case 'minute':
+            d.setMinutes(d.getMinutes() - n);
+            break;
+        case 'hour':
+            d.setHours(d.getHours() - n);
+            break;
+        case 'day':
+            d.setDate(d.getDate() - n);
+            break;
+        default:
+            throw new Error(`不支持的时间单位: ${unit}`);
+    }
+    return d;
+}
+//# sourceMappingURL=time-utils.js.map

package/src/tools/oapi/im/time-utils.js.map

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

package/src/tools/oapi/im/user-name-uat.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * UAT 用户名解析模块
+ *
+ * 独立于 messaging/inbound 层的 TAT UserNameCache，
+ * 用于工具层以用户身份（UAT）批量解析用户显示名。
+ *
+ * 设计动机：TAT 调用 contact/v3/users/batch 缺少权限导致返回的用户
+ * 条目不含 name 字段，而工具层搜索消息等场景运行在 UAT 上下文中，
+ * 用户 token 可以读取其他用户的名称。
+ */
+import type { ToolClient } from '../../../core/tool-client';
+/** 从 UAT 缓存中获取用户名 */
+export declare function getUATUserName(accountId: string, openId: string): string | undefined;
+/** 批量写入 UAT 缓存 */
+export declare function setUATUserNames(accountId: string, entries: Map<string, string>): void;
+export declare function batchResolveUserNamesAsUser(params: {
+    client: ToolClient;
+    openIds: string[];
+    log: (...args: unknown[]) => void;
+}): Promise<Map<string, string>>;
+//# sourceMappingURL=user-name-uat.d.ts.map

package/src/tools/oapi/im/user-name-uat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-name-uat.d.ts","sourceRoot":"","sources":["../../../../../src/tools/oapi/im/user-name-uat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAiC5D,qBAAqB;AACrB,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAapF;AAED,kBAAkB;AAClB,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAQrF;AAQD,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACnC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAmE/B"}

package/src/tools/oapi/im/user-name-uat.js

@@ -0,0 +1,128 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * UAT 用户名解析模块
+ *
+ * 独立于 messaging/inbound 层的 TAT UserNameCache，
+ * 用于工具层以用户身份（UAT）批量解析用户显示名。
+ *
+ * 设计动机：TAT 调用 contact/v3/users/batch 缺少权限导致返回的用户
+ * 条目不含 name 字段，而工具层搜索消息等场景运行在 UAT 上下文中，
+ * 用户 token 可以读取其他用户的名称。
+ */
+import { isInvokeError } from '../helpers';
+// ---------------------------------------------------------------------------
+// 独立缓存：accountId → Map<openId, { name, expireAt }>
+// ---------------------------------------------------------------------------
+const UAT_MAX_SIZE = 500;
+const UAT_TTL_MS = 30 * 60 * 1000; // 30 分钟
+const uatRegistry = new Map();
+function getOrCreateCache(accountId) {
+    let cache = uatRegistry.get(accountId);
+    if (!cache) {
+        cache = new Map();
+        uatRegistry.set(accountId, cache);
+    }
+    return cache;
+}
+function evict(cache) {
+    while (cache.size > UAT_MAX_SIZE) {
+        const oldest = cache.keys().next().value;
+        if (oldest !== undefined)
+            cache.delete(oldest);
+    }
+}
+/** 从 UAT 缓存中获取用户名 */
+export function getUATUserName(accountId, openId) {
+    const cache = uatRegistry.get(accountId);
+    if (!cache)
+        return undefined;
+    const entry = cache.get(openId);
+    if (!entry)
+        return undefined;
+    if (entry.expireAt <= Date.now()) {
+        cache.delete(openId);
+        return undefined;
+    }
+    // LRU refresh
+    cache.delete(openId);
+    cache.set(openId, entry);
+    return entry.name;
+}
+/** 批量写入 UAT 缓存 */
+export function setUATUserNames(accountId, entries) {
+    const cache = getOrCreateCache(accountId);
+    const now = Date.now();
+    for (const [openId, name] of entries) {
+        cache.delete(openId);
+        cache.set(openId, { name, expireAt: now + UAT_TTL_MS });
+    }
+    evict(cache);
+}
+// ---------------------------------------------------------------------------
+// 以 UAT 身份批量解析用户名
+// ---------------------------------------------------------------------------
+const BATCH_SIZE = 50;
+export async function batchResolveUserNamesAsUser(params) {
+    const { client, openIds, log } = params;
+    if (openIds.length === 0)
+        return new Map();
+    const accountId = client.account.accountId;
+    const cache = getOrCreateCache(accountId);
+    const result = new Map();
+    const now = Date.now();
+    // 1. 从缓存读取已有的
+    const missing = [];
+    for (const id of openIds) {
+        const entry = cache.get(id);
+        if (entry && entry.expireAt > now) {
+            result.set(id, entry.name);
+        }
+        else {
+            if (entry)
+                cache.delete(id);
+            missing.push(id);
+        }
+    }
+    // 去重
+    const uniqueMissing = [...new Set(missing)];
+    if (uniqueMissing.length === 0)
+        return result;
+    // 2. 分批通过 SDK 调用 contact/v3/users/batch（UAT）
+    for (let i = 0; i < uniqueMissing.length; i += BATCH_SIZE) {
+        const chunk = uniqueMissing.slice(i, i + BATCH_SIZE);
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const res = await client.invoke('feishu_get_user.default', // 注：实际调用 batch API，共享 get_user 的 scope
+            (sdk, opts) => sdk.contact.user.batch({
+                params: {
+                    user_ids: chunk,
+                    user_id_type: 'open_id',
+                },
+            }, opts), {
+                as: 'user',
+            });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const items = res?.data?.items ?? [];
+            for (const item of items) {
+                const openId = item.open_id;
+                const name = item.name || item.display_name || item.nickname || item.en_name;
+                if (openId && name) {
+                    cache.delete(openId);
+                    cache.set(openId, { name, expireAt: Date.now() + UAT_TTL_MS });
+                    result.set(openId, name);
+                }
+            }
+        }
+        catch (err) {
+            // 授权/权限错误向上冒泡，由上层 handleInvokeErrorWithAutoAuth 处理自动授权
+            if (isInvokeError(err))
+                throw err;
+            log(`batchResolveUserNamesAsUser: failed: ${String(err)}`);
+        }
+    }
+    evict(cache);
+    return result;
+}
+//# sourceMappingURL=user-name-uat.js.map

package/src/tools/oapi/im/user-name-uat.js.map

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

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

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * OAPI Tools Index
+ *
+ * This module registers all tools that directly use Feishu Open API (OAPI).
+ * These tools are placed here to distinguish them from MCP-based tools.
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerOapiTools(api: OpenClawPluginApi): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/oapi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAgC7D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,QA8CvD"}

package/src/tools/oapi/index.js

@@ -0,0 +1,59 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * OAPI Tools Index
+ *
+ * This module registers all tools that directly use Feishu Open API (OAPI).
+ * These tools are placed here to distinguish them from MCP-based tools.
+ */
+import { registerFeishuCalendarCalendarTool, registerFeishuCalendarEventTool, registerFeishuCalendarEventAttendeeTool, registerFeishuCalendarFreebusyTool, } from './calendar/index';
+import { registerFeishuTaskTaskTool, registerFeishuTaskTasklistTool, registerFeishuTaskCommentTool, registerFeishuTaskSubtaskTool, } from './task/index';
+import { registerFeishuBitableAppTool, registerFeishuBitableAppTableTool, registerFeishuBitableAppTableRecordTool, registerFeishuBitableAppTableFieldTool, registerFeishuBitableAppTableViewTool, } from './bitable/index';
+import { registerGetUserTool, registerSearchUserTool } from './common/index';
+// import { registerFeishuMailTools } from "./mail/index";
+import { registerFeishuSearchTools } from './search/index';
+import { registerFeishuDriveTools } from './drive/index';
+import { registerFeishuWikiTools } from './wiki/index';
+import { registerFeishuImTools as registerFeishuImBotTools } from '../tat/im/index';
+import { registerFeishuSheetsTools } from './sheets/index';
+// import { registerFeishuOkrTools } from "./okr/index";
+import { registerFeishuChatTools } from './chat/index';
+import { registerFeishuImTools as registerFeishuImUserTools } from './im/index';
+export function registerOapiTools(api) {
+    // Common tools
+    registerGetUserTool(api);
+    registerSearchUserTool(api);
+    // Chat tools
+    registerFeishuChatTools(api);
+    // IM tools (user identity)
+    registerFeishuImUserTools(api);
+    // Calendar tools
+    registerFeishuCalendarCalendarTool(api);
+    registerFeishuCalendarEventTool(api);
+    registerFeishuCalendarEventAttendeeTool(api);
+    registerFeishuCalendarFreebusyTool(api);
+    // Task tools
+    registerFeishuTaskTaskTool(api);
+    registerFeishuTaskTasklistTool(api);
+    registerFeishuTaskCommentTool(api);
+    registerFeishuTaskSubtaskTool(api);
+    // Bitable tools
+    registerFeishuBitableAppTool(api);
+    registerFeishuBitableAppTableTool(api);
+    registerFeishuBitableAppTableRecordTool(api);
+    registerFeishuBitableAppTableFieldTool(api);
+    registerFeishuBitableAppTableViewTool(api);
+    // Search tools
+    registerFeishuSearchTools(api);
+    // Drive tools
+    registerFeishuDriveTools(api);
+    // Wiki tools
+    registerFeishuWikiTools(api);
+    // Sheets tools
+    registerFeishuSheetsTools(api);
+    // IM tools (bot identity)
+    registerFeishuImBotTools(api);
+    api.logger.info?.('Registered all OAPI tools (calendar, task, bitable, search, drive, wiki, sheets, im)');
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/oapi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,kCAAkC,EAClC,+BAA+B,EAC/B,uCAAuC,EACvC,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,4BAA4B,EAC5B,iCAAiC,EACjC,uCAAuC,EACvC,sCAAsC,EACtC,qCAAqC,GACtC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,0DAA0D;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,qBAAqB,IAAI,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,wDAAwD;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,IAAI,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,UAAU,iBAAiB,CAAC,GAAsB;IACtD,eAAe;IACf,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACzB,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAE5B,aAAa;IACb,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAE7B,2BAA2B;IAC3B,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAE/B,iBAAiB;IACjB,kCAAkC,CAAC,GAAG,CAAC,CAAC;IACxC,+BAA+B,CAAC,GAAG,CAAC,CAAC;IACrC,uCAAuC,CAAC,GAAG,CAAC,CAAC;IAC7C,kCAAkC,CAAC,GAAG,CAAC,CAAC;IAExC,aAAa;IACb,0BAA0B,CAAC,GAAG,CAAC,CAAC;IAChC,8BAA8B,CAAC,GAAG,CAAC,CAAC;IACpC,6BAA6B,CAAC,GAAG,CAAC,CAAC;IACnC,6BAA6B,CAAC,GAAG,CAAC,CAAC;IAEnC,gBAAgB;IAChB,4BAA4B,CAAC,GAAG,CAAC,CAAC;IAClC,iCAAiC,CAAC,GAAG,CAAC,CAAC;IACvC,uCAAuC,CAAC,GAAG,CAAC,CAAC;IAC7C,sCAAsC,CAAC,GAAG,CAAC,CAAC;IAC5C,qCAAqC,CAAC,GAAG,CAAC,CAAC;IAE3C,eAAe;IACf,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAE/B,cAAc;IACd,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAE9B,aAAa;IACb,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAE7B,eAAe;IACf,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAE/B,0BAA0B;IAC1B,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAE9B,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,sFAAsF,CAAC,CAAC;AAC5G,CAAC"}

package/src/tools/oapi/sdk-types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Common response type helpers for Lark SDK.
+ *
+ * The Lark Node SDK's generic response types often lack specific field
+ * definitions for `data`, requiring `as any` casts.  These lightweight
+ * interfaces let us replace `(res.data as any)?.items` with a single typed
+ * assertion at the top of each block.
+ */
+/** Standard paginated list response (items / has_more / page_token). */
+export interface PaginatedData<T = unknown> {
+    items?: T[];
+    has_more?: boolean;
+    page_token?: string;
+    total?: number;
+}
+/** Calendar-specific list response that uses `calendar_list` key. */
+export interface CalendarListData {
+    calendar_list?: unknown[];
+    has_more?: boolean;
+    page_token?: string;
+}
+/** Calendar primary response. */
+export interface CalendarPrimaryData {
+    calendars?: Array<{
+        calendar?: {
+            calendar_id?: string;
+        };
+    }>;
+}
+/** Freebusy response. */
+export interface FreebusyData {
+    freebusy_lists?: unknown[];
+}
+/** Drive file list response (uses `files` key). */
+export interface DriveFileListData {
+    files?: unknown[];
+    has_more?: boolean;
+    next_page_token?: string;
+}
+/** Drive file copy / create response. */
+export interface DriveFileData {
+    file?: {
+        token?: string;
+        [key: string]: unknown;
+    };
+}
+/** Drive async task response (move / delete). */
+export interface DriveTaskData {
+    task_id?: string;
+}
+/** Bitable app list response (uses `files` key from drive search). */
+export interface BitableAppListData {
+    files?: unknown[];
+    has_more?: boolean;
+    page_token?: string;
+}
+/** Field create / update response. */
+export interface FieldData {
+    field?: {
+        field_id?: string;
+        [key: string]: unknown;
+    };
+}
+/** Chat member list response. */
+export interface ChatMemberListData {
+    items?: unknown[];
+    member_total?: number;
+    has_more?: boolean;
+    page_token?: string;
+}
+/** Search user response. */
+export interface SearchUserData {
+    users?: unknown[];
+    has_more?: boolean;
+    page_token?: string;
+}
+/** Task create response. */
+export interface TaskCreateData {
+    task?: {
+        guid?: string;
+        [key: string]: unknown;
+    };
+}
+/** Calendar get response. */
+export interface CalendarGetData {
+    calendar?: unknown;
+}
+/** Comment list reply response. */
+export interface CommentReplyListData {
+    items?: unknown[];
+    has_more?: boolean;
+    page_token?: string;
+}
+//# sourceMappingURL=sdk-types.d.ts.map

package/src/tools/oapi/sdk-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-types.d.ts","sourceRoot":"","sources":["../../../../src/tools/oapi/sdk-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wEAAwE;AACxE,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,yBAAyB;AACzB,MAAM,WAAW,YAAY;IAC3B,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;CAC5B;AAED,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACnD;AAED,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACvD;AAED,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CAClD;AAED,6BAA6B;AAC7B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/src/tools/oapi/sdk-types.js

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Common response type helpers for Lark SDK.
+ *
+ * The Lark Node SDK's generic response types often lack specific field
+ * definitions for `data`, requiring `as any` casts.  These lightweight
+ * interfaces let us replace `(res.data as any)?.items` with a single typed
+ * assertion at the top of each block.
+ */
+export {};
+//# sourceMappingURL=sdk-types.js.map

package/src/tools/oapi/sdk-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-types.js","sourceRoot":"","sources":["../../../../src/tools/oapi/sdk-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/src/tools/oapi/search/doc-search.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuSearchDocWikiTool(api: OpenClawPluginApi): void;
+//# sourceMappingURL=doc-search.d.ts.map

package/src/tools/oapi/search/doc-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-search.d.ts","sourceRoot":"","sources":["../../../../../src/tools/oapi/search/doc-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AA6K7D,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,iBAAiB,QAoHrE"}