@lark-project/openclaw-lark-project 2026.3.131

package/dist/src/tools/oapi/drive/index.js

@@ -0,0 +1,29 @@
+import { getEnabledLarkAccounts } from "../../../core/accounts";
+import { resolveAnyEnabledToolsConfig } from "../../../core/tools-config";
+import { registerFeishuDriveFileTool } from "./file";
+import { registerDocCommentsTool } from "./doc-comments";
+import { registerDocMediaTool } from "./doc-media";
+function registerFeishuDriveTools(api) {
+  if (!api.config) {
+    api.logger.debug?.("feishu_drive: No config available, skipping");
+    return;
+  }
+  const accounts = getEnabledLarkAccounts(api.config);
+  if (accounts.length === 0) {
+    api.logger.debug?.("feishu_drive: No Feishu accounts configured, skipping");
+    return;
+  }
+  const toolsCfg = resolveAnyEnabledToolsConfig(accounts);
+  if (!toolsCfg.drive) {
+    api.logger.debug?.("feishu_drive: drive tool disabled in all accounts");
+    return;
+  }
+  registerFeishuDriveFileTool(api);
+  registerDocCommentsTool(api);
+  registerDocMediaTool(api);
+  api.logger.info?.("feishu_drive: Registered feishu_drive_file, feishu_doc_comments, feishu_doc_media");
+}
+export {
+  registerFeishuDriveTools
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/tools/oapi/drive/index.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Drive \u5DE5\u5177\u96C6\n * \u7EDF\u4E00\u5BFC\u51FA\u6240\u6709\u4E91\u7A7A\u95F4\u76F8\u5173\u5DE5\u5177\u7684\u6CE8\u518C\u51FD\u6570\n */\n\nimport type { OpenClawPluginApi } from 'openclaw/plugin-sdk';\nimport { getEnabledLarkAccounts } from '../../../core/accounts';\nimport { resolveAnyEnabledToolsConfig } from '../../../core/tools-config';\nimport { registerFeishuDriveFileTool } from './file';\nimport { registerDocCommentsTool } from './doc-comments';\nimport { registerDocMediaTool } from './doc-media';\n\n/**\n * \u6CE8\u518C\u6240\u6709 Drive \u5DE5\u5177\n */\nexport function registerFeishuDriveTools(api: OpenClawPluginApi) {\n  if (!api.config) {\n    api.logger.debug?.('feishu_drive: No config available, skipping');\n    return;\n  }\n\n  const accounts = getEnabledLarkAccounts(api.config);\n  if (accounts.length === 0) {\n    api.logger.debug?.('feishu_drive: No Feishu accounts configured, skipping');\n    return;\n  }\n\n  const toolsCfg = resolveAnyEnabledToolsConfig(accounts);\n  if (!toolsCfg.drive) {\n    api.logger.debug?.('feishu_drive: drive tool disabled in all accounts');\n    return;\n  }\n\n  // \u6CE8\u518C\u6240\u6709\u5DE5\u5177\n  registerFeishuDriveFileTool(api);\n  registerDocCommentsTool(api);\n  registerDocMediaTool(api);\n\n  api.logger.info?.('feishu_drive: Registered feishu_drive_file, feishu_doc_comments, feishu_doc_media');\n}\n"],
+  "mappings": "AASA,SAAS,8BAA8B;AACvC,SAAS,oCAAoC;AAC7C,SAAS,mCAAmC;AAC5C,SAAS,+BAA+B;AACxC,SAAS,4BAA4B;AAK9B,SAAS,yBAAyB,KAAwB;AAC/D,MAAI,CAAC,IAAI,QAAQ;AACf,QAAI,OAAO,QAAQ,6CAA6C;AAChE;AAAA,EACF;AAEA,QAAM,WAAW,uBAAuB,IAAI,MAAM;AAClD,MAAI,SAAS,WAAW,GAAG;AACzB,QAAI,OAAO,QAAQ,uDAAuD;AAC1E;AAAA,EACF;AAEA,QAAM,WAAW,6BAA6B,QAAQ;AACtD,MAAI,CAAC,SAAS,OAAO;AACnB,QAAI,OAAO,QAAQ,mDAAmD;AACtE;AAAA,EACF;AAGA,8BAA4B,GAAG;AAC/B,0BAAwB,GAAG;AAC3B,uBAAqB,GAAG;AAExB,MAAI,OAAO,OAAO,mFAAmF;AACvG;",
+  "names": []
+}

package/dist/src/tools/oapi/helpers.js

@@ -0,0 +1,199 @@
+import {
+  formatToolResult,
+  formatToolError,
+  createToolLogger,
+  createClientGetter,
+  createToolContext,
+  getFirstAccount,
+  validateRequiredParams,
+  validateEnum
+} from "../helpers";
+import {
+  ToolClient,
+  createToolClient,
+  NeedAuthorizationError,
+  AppScopeMissingError,
+  UserAuthRequiredError,
+  UserScopeInsufficientError
+} from "../../core/tool-client";
+import { createClientGetter as createClientGetter2 } from "../helpers";
+function createFeishuClientFromConfig(config) {
+  const getClient = createClientGetter2(config);
+  return getClient();
+}
+import { formatToolResult as formatToolResult2 } from "../helpers";
+function json(data) {
+  return formatToolResult2(data);
+}
+function parseTimeToTimestamp(input) {
+  try {
+    const trimmed = input.trim();
+    const hasTimezone = /[Zz]$|[+-]\d{2}:\d{2}$/.test(trimmed);
+    if (hasTimezone) {
+      const date = new Date(trimmed);
+      if (isNaN(date.getTime())) return null;
+      return Math.floor(date.getTime() / 1e3).toString();
+    }
+    const normalized = trimmed.replace("T", " ");
+    const match = normalized.match(/^(\d{4})-(\d{2})-(\d{2})\s+(\d{2}):(\d{2})(?::(\d{2}))?$/);
+    if (!match) {
+      const date = new Date(trimmed);
+      if (isNaN(date.getTime())) return null;
+      return Math.floor(date.getTime() / 1e3).toString();
+    }
+    const [, year, month, day, hour, minute, second] = match;
+    const utcDate = new Date(
+      Date.UTC(
+        parseInt(year),
+        parseInt(month) - 1,
+        parseInt(day),
+        parseInt(hour) - 8,
+        // 北京时间减去 8 小时得到 UTC
+        parseInt(minute),
+        parseInt(second ?? "0")
+      )
+    );
+    return Math.floor(utcDate.getTime() / 1e3).toString();
+  } catch {
+    return null;
+  }
+}
+function parseTimeToTimestampMs(input) {
+  try {
+    const trimmed = input.trim();
+    const hasTimezone = /[Zz]$|[+-]\d{2}:\d{2}$/.test(trimmed);
+    if (hasTimezone) {
+      const date = new Date(trimmed);
+      if (isNaN(date.getTime())) return null;
+      return date.getTime().toString();
+    }
+    const normalized = trimmed.replace("T", " ");
+    const match = normalized.match(/^(\d{4})-(\d{2})-(\d{2})\s+(\d{2}):(\d{2})(?::(\d{2}))?$/);
+    if (!match) {
+      const date = new Date(trimmed);
+      if (isNaN(date.getTime())) return null;
+      return date.getTime().toString();
+    }
+    const [, year, month, day, hour, minute, second] = match;
+    const utcDate = new Date(
+      Date.UTC(
+        parseInt(year),
+        parseInt(month) - 1,
+        parseInt(day),
+        parseInt(hour) - 8,
+        // 北京时间减去 8 小时得到 UTC
+        parseInt(minute),
+        parseInt(second ?? "0")
+      )
+    );
+    return utcDate.getTime().toString();
+  } catch {
+    return null;
+  }
+}
+function parseTimeToRFC3339(input) {
+  try {
+    const trimmed = input.trim();
+    const hasTimezone = /[Zz]$|[+-]\d{2}:\d{2}$/.test(trimmed);
+    if (hasTimezone) {
+      const date = new Date(trimmed);
+      if (isNaN(date.getTime())) return null;
+      return trimmed;
+    }
+    const normalized = trimmed.replace("T", " ");
+    const match = normalized.match(/^(\d{4})-(\d{2})-(\d{2})\s+(\d{2}):(\d{2})(?::(\d{2}))?$/);
+    if (!match) {
+      const date = new Date(trimmed);
+      if (isNaN(date.getTime())) return null;
+      return trimmed.includes("T") ? `${trimmed}+08:00` : trimmed;
+    }
+    const [, year, month, day, hour, minute, second] = match;
+    const sec = second ?? "00";
+    return `${year}-${month}-${day}T${hour}:${minute}:${sec}+08:00`;
+  } catch {
+    return null;
+  }
+}
+function convertTimeRange(timeRange, unit = "s") {
+  if (!timeRange) return void 0;
+  const result = {};
+  const parseFn = unit === "ms" ? parseTimeToTimestampMs : parseTimeToTimestamp;
+  if (timeRange.start) {
+    const ts = parseFn(timeRange.start);
+    if (!ts) {
+      throw new Error(
+        `Invalid time format for start. Must use ISO 8601 / RFC 3339 with timezone, e.g. "2024-01-01T00:00:00+08:00". Received: ${timeRange.start}`
+      );
+    }
+    result.start = parseInt(ts, 10);
+  }
+  if (timeRange.end) {
+    const ts = parseFn(timeRange.end);
+    if (!ts) {
+      throw new Error(
+        `Invalid time format for end. Must use ISO 8601 / RFC 3339 with timezone, e.g. "2024-01-01T00:00:00+08:00". Received: ${timeRange.end}`
+      );
+    }
+    result.end = parseInt(ts, 10);
+  }
+  return Object.keys(result).length > 0 ? result : void 0;
+}
+const SHANGHAI_UTC_OFFSET_HOURS = 8;
+const SHANGHAI_OFFSET_SUFFIX = "+08:00";
+function pad2(value) {
+  return String(value).padStart(2, "0");
+}
+function unixTimestampToISO8601(raw) {
+  if (raw === void 0 || raw === null) return null;
+  const text = typeof raw === "number" ? String(raw) : String(raw).trim();
+  if (!/^-?\d+$/.test(text)) return null;
+  const num = Number(text);
+  if (!Number.isFinite(num)) return null;
+  const utcMs = Math.abs(num) >= 1e12 ? num : num * 1e3;
+  const beijingDate = new Date(utcMs + SHANGHAI_UTC_OFFSET_HOURS * 60 * 60 * 1e3);
+  if (Number.isNaN(beijingDate.getTime())) return null;
+  const year = beijingDate.getUTCFullYear();
+  const month = pad2(beijingDate.getUTCMonth() + 1);
+  const day = pad2(beijingDate.getUTCDate());
+  const hour = pad2(beijingDate.getUTCHours());
+  const minute = pad2(beijingDate.getUTCMinutes());
+  const second = pad2(beijingDate.getUTCSeconds());
+  return `${year}-${month}-${day}T${hour}:${minute}:${second}${SHANGHAI_OFFSET_SUFFIX}`;
+}
+import { assertLarkOk, formatLarkError } from "../../core/api-error";
+import { AppScopeMissingError as AppScopeMissingError2, UserAuthRequiredError as UserAuthRequiredError2, UserScopeInsufficientError as UserScopeInsufficientError2 } from "../../core/tool-client";
+function isInvokeError(err) {
+  return err instanceof UserAuthRequiredError2 || err instanceof AppScopeMissingError2 || err instanceof UserScopeInsufficientError2;
+}
+import { handleInvokeErrorWithAutoAuth } from "../auto-auth";
+export {
+  AppScopeMissingError,
+  NeedAuthorizationError,
+  SHANGHAI_OFFSET_SUFFIX,
+  SHANGHAI_UTC_OFFSET_HOURS,
+  ToolClient,
+  UserAuthRequiredError,
+  UserScopeInsufficientError,
+  assertLarkOk,
+  convertTimeRange,
+  createClientGetter,
+  createFeishuClientFromConfig,
+  createToolClient,
+  createToolContext,
+  createToolLogger,
+  formatLarkError,
+  formatToolError,
+  formatToolResult,
+  getFirstAccount,
+  handleInvokeErrorWithAutoAuth,
+  isInvokeError,
+  json,
+  pad2,
+  parseTimeToRFC3339,
+  parseTimeToTimestamp,
+  parseTimeToTimestampMs,
+  unixTimestampToISO8601,
+  validateEnum,
+  validateRequiredParams
+};
+//# sourceMappingURL=helpers.js.map

package/dist/src/tools/oapi/helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/oapi/helpers.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * OAPI \u5DE5\u5177\u4E13\u7528\u8F85\u52A9\u51FD\u6570\n *\n * \u63D0\u4F9B OAPI \u5DE5\u5177\u7279\u6709\u7684\u529F\u80FD\uFF08\u5982\u65F6\u95F4\u8F6C\u6362\uFF09\uFF0C\u5E76\u590D\u7528\u901A\u7528\u8F85\u52A9\u51FD\u6570\u3002\n */\n\nimport type { ClawdbotConfig } from 'openclaw/plugin-sdk';\nimport type { Client as LarkClient } from '@larksuiteoapi/node-sdk';\n\n// ---------------------------------------------------------------------------\n// \u901A\u7528\u529F\u80FD\uFF08\u4ECE tools/helpers.ts \u5BFC\u5165\uFF09\n// ---------------------------------------------------------------------------\n\nexport {\n  formatToolResult,\n  formatToolError,\n  createToolLogger,\n  createClientGetter,\n  createToolContext,\n  getFirstAccount,\n  validateRequiredParams,\n  validateEnum,\n} from '../helpers';\n\nexport type { ToolResult, ClientGetter, ToolContext } from '../helpers';\n\n// ---------------------------------------------------------------------------\n// ToolClient\uFF08\u5DE5\u5177\u5C42\u7EDF\u4E00\u5BA2\u6237\u7AEF\uFF09\n// ---------------------------------------------------------------------------\n\nexport {\n  ToolClient,\n  createToolClient,\n  NeedAuthorizationError,\n  AppScopeMissingError,\n  UserAuthRequiredError,\n  UserScopeInsufficientError,\n} from '../../core/tool-client';\nexport type {\n  ApiFn,\n  InvokeFn,\n  InvokeOptions,\n  InvokeByPathOptions,\n  AuthHint,\n  TryInvokeResult,\n} from '../../core/tool-client';\n\n// ---------------------------------------------------------------------------\n// OAPI \u4E13\u7528\uFF1A\u5BA2\u6237\u7AEF\u4FBF\u6377\u521B\u5EFA\n// ---------------------------------------------------------------------------\n\nimport { createClientGetter } from '../helpers';\n\n/**\n * \u4ECE\u914D\u7F6E\u76F4\u63A5\u521B\u5EFA\u98DE\u4E66\u5BA2\u6237\u7AEF\uFF08OAPI \u5DE5\u5177\u5E38\u7528\u6A21\u5F0F\uFF09\n *\n * \u8FD9\u662F\u5BF9 createClientGetter \u7684\u7B80\u5316\u5C01\u88C5\uFF0C\u76F4\u63A5\u8FD4\u56DE\u5BA2\u6237\u7AEF\u5B9E\u4F8B\u800C\u975E getter \u51FD\u6570\u3002\n *\n * @param config - OpenClaw \u914D\u7F6E\u5BF9\u8C61\n * @returns \u98DE\u4E66 SDK \u5BA2\u6237\u7AEF\u5B9E\u4F8B\n * @throws \u5982\u679C\u6CA1\u6709\u542F\u7528\u7684\u8D26\u53F7\n *\n * @example\n * ```typescript\n * export function registerMyOapiTool(api: OpenClawPluginApi) {\n *   api.registerTool({\n *     name: \"my_oapi_tool\",\n *     async execute(_toolCallId, params) {\n *       const client = createFeishuClientFromConfig(api.config);\n *       const res = await client.calendar.calendarEvent.list({ ... });\n *       return json(res.data);\n *     }\n *   });\n * }\n * ```\n */\nexport function createFeishuClientFromConfig(config: ClawdbotConfig): LarkClient {\n  const getClient = createClientGetter(config);\n  return getClient();\n}\n\n// ---------------------------------------------------------------------------\n// OAPI \u4E13\u7528\uFF1A\u8FD4\u56DE\u503C\u683C\u5F0F\u5316\uFF08\u7B80\u5316\u7248\uFF09\n// ---------------------------------------------------------------------------\n\nimport { formatToolResult } from '../helpers';\n\n/**\n * \u683C\u5F0F\u5316\u8FD4\u56DE\u503C\u4E3A JSON\uFF08OAPI \u5DE5\u5177\u5E38\u7528\u7B80\u5316\u63A5\u53E3\uFF09\n *\n * \u8FD9\u662F\u5BF9 formatToolResult \u7684\u7B80\u5316\u5C01\u88C5\uFF0C\u51FD\u6570\u540D\u66F4\u77ED\u4FBF\u4E8E\u9891\u7E41\u4F7F\u7528\u3002\n *\n * @param data - \u8981\u8FD4\u56DE\u7684\u6570\u636E\n * @returns \u683C\u5F0F\u5316\u7684\u5DE5\u5177\u8FD4\u56DE\u503C\n *\n * @example\n * ```typescript\n * return json({ task: taskData });\n * return json({ error: \"Invalid parameter\" });\n * ```\n */\nexport function json(data: unknown) {\n  return formatToolResult(data);\n}\n\n// ---------------------------------------------------------------------------\n// OAPI \u4E13\u7528\uFF1A\u65F6\u95F4\u8F6C\u6362\u5DE5\u5177\n// ---------------------------------------------------------------------------\n\n/**\n * \u89E3\u6790\u65F6\u95F4\u5B57\u7B26\u4E32\u4E3A Unix \u65F6\u95F4\u6233\uFF08\u79D2\uFF09\n *\n * \u652F\u6301\u591A\u79CD\u683C\u5F0F\uFF1A\n * 1. ISO 8601 / RFC 3339\uFF08\u5E26\u65F6\u533A\uFF09\uFF1A\"2024-01-01T00:00:00+08:00\"\n * 2. \u4E0D\u5E26\u65F6\u533A\u7684\u683C\u5F0F\uFF08\u9ED8\u8BA4\u4E3A\u5317\u4EAC\u65F6\u95F4 UTC+8\uFF09\uFF1A\n *    - \"2026-02-25 14:30\"\n *    - \"2026-02-25 14:30:00\"\n *    - \"2026-02-25T14:30:00\"\n *\n * @param input - \u65F6\u95F4\u5B57\u7B26\u4E32\n * @returns Unix \u65F6\u95F4\u6233\u5B57\u7B26\u4E32\uFF08\u79D2\uFF09\uFF0C\u89E3\u6790\u5931\u8D25\u8FD4\u56DE null\n *\n * @example\n * ```typescript\n * parseTimeToTimestamp(\"2026-02-25T14:30:00+08:00\")  // => \"1740459000\"\n * parseTimeToTimestamp(\"2026-02-25 14:30\")           // => \"1740459000\" (\u9ED8\u8BA4\u5317\u4EAC\u65F6\u95F4)\n * parseTimeToTimestamp(\"2026-02-25T14:30:00\")        // => \"1740459000\" (\u9ED8\u8BA4\u5317\u4EAC\u65F6\u95F4)\n * parseTimeToTimestamp(\"invalid\")                    // => null\n * ```\n */\nexport function parseTimeToTimestamp(input: string): string | null {\n  try {\n    const trimmed = input.trim();\n\n    // \u68C0\u67E5\u662F\u5426\u5305\u542B\u65F6\u533A\u4FE1\u606F\uFF08Z \u6216 +/- \u504F\u79FB\uFF09\n    const hasTimezone = /[Zz]$|[+-]\\d{2}:\\d{2}$/.test(trimmed);\n\n    if (hasTimezone) {\n      // \u6709\u65F6\u533A\u4FE1\u606F\uFF0C\u76F4\u63A5\u89E3\u6790\n      const date = new Date(trimmed);\n      if (isNaN(date.getTime())) return null;\n      return Math.floor(date.getTime() / 1000).toString();\n    }\n\n    // \u6CA1\u6709\u65F6\u533A\u4FE1\u606F\uFF0C\u5F53\u4F5C\u5317\u4EAC\u65F6\u95F4\u5904\u7406\n    // \u652F\u6301\u683C\u5F0F\uFF1AYYYY-MM-DD HH:mm \u6216 YYYY-MM-DD HH:mm:ss \u6216 YYYY-MM-DDTHH:mm:ss\n    const normalized = trimmed.replace('T', ' ');\n    const match = normalized.match(/^(\\d{4})-(\\d{2})-(\\d{2})\\s+(\\d{2}):(\\d{2})(?::(\\d{2}))?$/);\n\n    if (!match) {\n      // \u5C1D\u8BD5\u76F4\u63A5\u89E3\u6790\uFF08\u53EF\u80FD\u662F\u5176\u4ED6 ISO 8601 \u683C\u5F0F\uFF09\n      const date = new Date(trimmed);\n      if (isNaN(date.getTime())) return null;\n      return Math.floor(date.getTime() / 1000).toString();\n    }\n\n    const [, year, month, day, hour, minute, second] = match;\n    // \u5F53\u4F5C\u5317\u4EAC\u65F6\u95F4\uFF08UTC+8\uFF09\uFF0C\u8F6C\u6362\u4E3A UTC\n    const utcDate = new Date(\n      Date.UTC(\n        parseInt(year),\n        parseInt(month) - 1,\n        parseInt(day),\n        parseInt(hour) - 8, // \u5317\u4EAC\u65F6\u95F4\u51CF\u53BB 8 \u5C0F\u65F6\u5F97\u5230 UTC\n        parseInt(minute),\n        parseInt(second ?? '0'),\n      ),\n    );\n\n    return Math.floor(utcDate.getTime() / 1000).toString();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * \u89E3\u6790\u65F6\u95F4\u5B57\u7B26\u4E32\u4E3A Unix \u65F6\u95F4\u6233\uFF08\u6BEB\u79D2\uFF09\n *\n * \u652F\u6301\u591A\u79CD\u683C\u5F0F\uFF1A\n * 1. ISO 8601 / RFC 3339\uFF08\u5E26\u65F6\u533A\uFF09\uFF1A\"2024-01-01T00:00:00+08:00\"\n * 2. \u4E0D\u5E26\u65F6\u533A\u7684\u683C\u5F0F\uFF08\u9ED8\u8BA4\u4E3A\u5317\u4EAC\u65F6\u95F4 UTC+8\uFF09\uFF1A\n *    - \"2026-02-25 14:30\"\n *    - \"2026-02-25 14:30:00\"\n *    - \"2026-02-25T14:30:00\"\n *\n * @param input - \u65F6\u95F4\u5B57\u7B26\u4E32\n * @returns Unix \u65F6\u95F4\u6233\u5B57\u7B26\u4E32\uFF08\u6BEB\u79D2\uFF09\uFF0C\u89E3\u6790\u5931\u8D25\u8FD4\u56DE null\n *\n * @example\n * ```typescript\n * parseTimeToTimestampMs(\"2026-02-25T14:30:00+08:00\")  // => \"1740459000000\"\n * parseTimeToTimestampMs(\"2026-02-25 14:30\")           // => \"1740459000000\" (\u9ED8\u8BA4\u5317\u4EAC\u65F6\u95F4)\n * parseTimeToTimestampMs(\"2026-02-25T14:30:00\")        // => \"1740459000000\" (\u9ED8\u8BA4\u5317\u4EAC\u65F6\u95F4)\n * parseTimeToTimestampMs(\"invalid\")                    // => null\n * ```\n */\nexport function parseTimeToTimestampMs(input: string): string | null {\n  try {\n    const trimmed = input.trim();\n\n    // \u68C0\u67E5\u662F\u5426\u5305\u542B\u65F6\u533A\u4FE1\u606F\uFF08Z \u6216 +/- \u504F\u79FB\uFF09\n    const hasTimezone = /[Zz]$|[+-]\\d{2}:\\d{2}$/.test(trimmed);\n\n    if (hasTimezone) {\n      // \u6709\u65F6\u533A\u4FE1\u606F\uFF0C\u76F4\u63A5\u89E3\u6790\n      const date = new Date(trimmed);\n      if (isNaN(date.getTime())) return null;\n      return date.getTime().toString();\n    }\n\n    // \u6CA1\u6709\u65F6\u533A\u4FE1\u606F\uFF0C\u5F53\u4F5C\u5317\u4EAC\u65F6\u95F4\u5904\u7406\n    // \u652F\u6301\u683C\u5F0F\uFF1AYYYY-MM-DD HH:mm \u6216 YYYY-MM-DD HH:mm:ss \u6216 YYYY-MM-DDTHH:mm:ss\n    const normalized = trimmed.replace('T', ' ');\n    const match = normalized.match(/^(\\d{4})-(\\d{2})-(\\d{2})\\s+(\\d{2}):(\\d{2})(?::(\\d{2}))?$/);\n\n    if (!match) {\n      // \u5C1D\u8BD5\u76F4\u63A5\u89E3\u6790\uFF08\u53EF\u80FD\u662F\u5176\u4ED6 ISO 8601 \u683C\u5F0F\uFF09\n      const date = new Date(trimmed);\n      if (isNaN(date.getTime())) return null;\n      return date.getTime().toString();\n    }\n\n    const [, year, month, day, hour, minute, second] = match;\n    // \u5F53\u4F5C\u5317\u4EAC\u65F6\u95F4\uFF08UTC+8\uFF09\uFF0C\u8F6C\u6362\u4E3A UTC\n    const utcDate = new Date(\n      Date.UTC(\n        parseInt(year),\n        parseInt(month) - 1,\n        parseInt(day),\n        parseInt(hour) - 8, // \u5317\u4EAC\u65F6\u95F4\u51CF\u53BB 8 \u5C0F\u65F6\u5F97\u5230 UTC\n        parseInt(minute),\n        parseInt(second ?? '0'),\n      ),\n    );\n\n    return utcDate.getTime().toString();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * \u89E3\u6790\u65F6\u95F4\u5B57\u7B26\u4E32\u4E3A RFC 3339 \u683C\u5F0F\uFF08\u7528\u4E8E freebusy API\uFF09\n *\n * \u652F\u6301\u591A\u79CD\u683C\u5F0F\uFF1A\n * 1. ISO 8601 / RFC 3339\uFF08\u5E26\u65F6\u533A\uFF09\uFF1A\"2024-01-01T00:00:00+08:00\" - \u76F4\u63A5\u8FD4\u56DE\n * 2. \u4E0D\u5E26\u65F6\u533A\u7684\u683C\u5F0F\uFF08\u9ED8\u8BA4\u4E3A\u5317\u4EAC\u65F6\u95F4 UTC+8\uFF09\uFF1A\n *    - \"2026-02-25 14:30\" - \u8F6C\u6362\u4E3A \"2026-02-25T14:30:00+08:00\"\n *    - \"2026-02-25 14:30:00\" - \u8F6C\u6362\u4E3A \"2026-02-25T14:30:00+08:00\"\n *    - \"2026-02-25T14:30:00\" - \u8F6C\u6362\u4E3A \"2026-02-25T14:30:00+08:00\"\n *\n * @param input - \u65F6\u95F4\u5B57\u7B26\u4E32\n * @returns RFC 3339 \u683C\u5F0F\u7684\u65F6\u95F4\u5B57\u7B26\u4E32\uFF0C\u89E3\u6790\u5931\u8D25\u8FD4\u56DE null\n *\n * @example\n * ```typescript\n * parseTimeToRFC3339(\"2026-02-25T14:30:00+08:00\")  // => \"2026-02-25T14:30:00+08:00\"\n * parseTimeToRFC3339(\"2026-02-25 14:30\")           // => \"2026-02-25T14:30:00+08:00\"\n * parseTimeToRFC3339(\"2026-02-25T14:30:00\")        // => \"2026-02-25T14:30:00+08:00\"\n * ```\n */\nexport function parseTimeToRFC3339(input: string): string | null {\n  try {\n    const trimmed = input.trim();\n\n    // \u68C0\u67E5\u662F\u5426\u5305\u542B\u65F6\u533A\u4FE1\u606F\uFF08Z \u6216 +/- \u504F\u79FB\uFF09\n    const hasTimezone = /[Zz]$|[+-]\\d{2}:\\d{2}$/.test(trimmed);\n\n    if (hasTimezone) {\n      // \u6709\u65F6\u533A\u4FE1\u606F\uFF0C\u9A8C\u8BC1\u540E\u76F4\u63A5\u8FD4\u56DE\n      const date = new Date(trimmed);\n      if (isNaN(date.getTime())) return null;\n      return trimmed;\n    }\n\n    // \u6CA1\u6709\u65F6\u533A\u4FE1\u606F\uFF0C\u5F53\u4F5C\u5317\u4EAC\u65F6\u95F4\u5904\u7406\uFF0C\u8F6C\u6362\u4E3A RFC 3339 \u683C\u5F0F\n    // \u652F\u6301\u683C\u5F0F\uFF1AYYYY-MM-DD HH:mm \u6216 YYYY-MM-DD HH:mm:ss \u6216 YYYY-MM-DDTHH:mm:ss\n    const normalized = trimmed.replace('T', ' ');\n    const match = normalized.match(/^(\\d{4})-(\\d{2})-(\\d{2})\\s+(\\d{2}):(\\d{2})(?::(\\d{2}))?$/);\n\n    if (!match) {\n      // \u5C1D\u8BD5\u76F4\u63A5\u89E3\u6790\uFF08\u53EF\u80FD\u662F\u5176\u4ED6 ISO 8601 \u683C\u5F0F\uFF09\n      const date = new Date(trimmed);\n      if (isNaN(date.getTime())) return null;\n      // \u5982\u679C\u80FD\u89E3\u6790\u4F46\u6CA1\u6709\u65F6\u533A\uFF0C\u6DFB\u52A0 +08:00\n      return trimmed.includes('T') ? `${trimmed}+08:00` : trimmed;\n    }\n\n    const [, year, month, day, hour, minute, second] = match;\n    const sec = second ?? '00';\n\n    // \u76F4\u63A5\u6784\u9020 RFC 3339 \u683C\u5F0F\uFF08\u5317\u4EAC\u65F6\u95F4 UTC+8\uFF09\n    return `${year}-${month}-${day}T${hour}:${minute}:${sec}+08:00`;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * \u8F6C\u6362\u65F6\u95F4\u8303\u56F4\u5BF9\u8C61\uFF08\u7528\u4E8E search \u7B49 API\uFF09\n *\n * \u5C06\u5305\u542B ISO 8601 \u683C\u5F0F\u65F6\u95F4\u5B57\u7B26\u4E32\u7684\u65F6\u95F4\u8303\u56F4\u8F6C\u6362\u4E3A\u65F6\u95F4\u6233\u3002\n *\n * @param timeRange - \u65F6\u95F4\u8303\u56F4\u5BF9\u8C61\uFF0C\u5305\u542B\u53EF\u9009\u7684 start \u548C end \u5B57\u6BB5\n * @param unit - \u65F6\u95F4\u6233\u5355\u4F4D\uFF0C's' \u4E3A\u79D2\uFF0C'ms' \u4E3A\u6BEB\u79D2\uFF0C\u9ED8\u8BA4\u4E3A 's'\n * @returns \u8F6C\u6362\u540E\u7684\u65F6\u95F4\u8303\u56F4\u5BF9\u8C61\uFF0C\u5305\u542B\u6570\u5B57\u7C7B\u578B\u7684\u65F6\u95F4\u6233\n * @throws \u5982\u679C\u65F6\u95F4\u683C\u5F0F\u9519\u8BEF\n *\n * @example\n * ```typescript\n * convertTimeRange({ start: \"2026-02-25T14:00:00+08:00\", end: \"2026-02-25T18:00:00+08:00\" })\n * // => { start: 1740459000, end: 1740473400 }\n *\n * convertTimeRange({ start: \"2026-02-25T14:00:00+08:00\" }, 'ms')\n * // => { start: 1740459000000 }\n * ```\n */\nexport function convertTimeRange(\n  timeRange: { start?: string; end?: string } | undefined,\n  unit: 's' | 'ms' = 's',\n): { start?: number; end?: number } | undefined {\n  if (!timeRange) return undefined;\n\n  const result: { start?: number; end?: number } = {};\n  const parseFn = unit === 'ms' ? parseTimeToTimestampMs : parseTimeToTimestamp;\n\n  if (timeRange.start) {\n    const ts = parseFn(timeRange.start);\n    if (!ts) {\n      throw new Error(\n        `Invalid time format for start. Must use ISO 8601 / RFC 3339 with timezone, e.g. \"2024-01-01T00:00:00+08:00\". Received: ${timeRange.start}`,\n      );\n    }\n    result.start = parseInt(ts, 10);\n  }\n\n  if (timeRange.end) {\n    const ts = parseFn(timeRange.end);\n    if (!ts) {\n      throw new Error(\n        `Invalid time format for end. Must use ISO 8601 / RFC 3339 with timezone, e.g. \"2024-01-01T00:00:00+08:00\". Received: ${timeRange.end}`,\n      );\n    }\n    result.end = parseInt(ts, 10);\n  }\n\n  return Object.keys(result).length > 0 ? result : undefined;\n}\n\n// ---------------------------------------------------------------------------\n// OAPI \u4E13\u7528\uFF1AUnix \u65F6\u95F4\u6233 \u2192 ISO 8601 (\u4E0A\u6D77\u65F6\u533A)\n// ---------------------------------------------------------------------------\n\nexport const SHANGHAI_UTC_OFFSET_HOURS = 8;\nexport const SHANGHAI_OFFSET_SUFFIX = '+08:00';\n\nexport function pad2(value: number): string {\n  return String(value).padStart(2, '0');\n}\n\n/**\n * Convert a Unix timestamp (seconds or milliseconds) to ISO 8601 string\n * in the Asia/Shanghai timezone.\n *\n * Auto-detects seconds vs milliseconds based on magnitude.\n *\n * @returns e.g. `\"2026-02-25T14:30:00+08:00\"`, or `null` on invalid input\n */\nexport function unixTimestampToISO8601(raw: string | number | undefined): string | null {\n  if (raw === undefined || raw === null) return null;\n\n  const text = typeof raw === 'number' ? String(raw) : String(raw).trim();\n  if (!/^-?\\d+$/.test(text)) return null;\n\n  const num = Number(text);\n  if (!Number.isFinite(num)) return null;\n\n  const utcMs = Math.abs(num) >= 1e12 ? num : num * 1000;\n  const beijingDate = new Date(utcMs + SHANGHAI_UTC_OFFSET_HOURS * 60 * 60 * 1000);\n  if (Number.isNaN(beijingDate.getTime())) return null;\n\n  const year = beijingDate.getUTCFullYear();\n  const month = pad2(beijingDate.getUTCMonth() + 1);\n  const day = pad2(beijingDate.getUTCDate());\n  const hour = pad2(beijingDate.getUTCHours());\n  const minute = pad2(beijingDate.getUTCMinutes());\n  const second = pad2(beijingDate.getUTCSeconds());\n\n  return `${year}-${month}-${day}T${hour}:${minute}:${second}${SHANGHAI_OFFSET_SUFFIX}`;\n}\n\n// ---------------------------------------------------------------------------\n// OAPI \u4E13\u7528\uFF1A\u98DE\u4E66 API \u9519\u8BEF\u5904\u7406\n// ---------------------------------------------------------------------------\n\n/**\n * Re-export \u98DE\u4E66 API \u9519\u8BEF\u5904\u7406\u51FD\u6570\n *\n * \u8FD9\u4E9B\u51FD\u6570\u4E13\u95E8\u7528\u4E8E\u5904\u7406\u98DE\u4E66 Open API \u7684\u54CD\u5E94\u548C\u9519\u8BEF\u3002\n */\nexport { assertLarkOk, formatLarkError } from '../../core/api-error';\n\n// ---------------------------------------------------------------------------\n// OAPI \u4E13\u7528\uFF1Ainvoke() \u9519\u8BEF\u5224\u65AD\n// ---------------------------------------------------------------------------\n\nimport { AppScopeMissingError, UserAuthRequiredError, UserScopeInsufficientError } from '../../core/tool-client';\n\n/**\n * Check whether an error is a structured invoke-level auth/permission error.\n *\n * Useful in intermediate catch blocks that need to let auth errors bubble up\n * to the outer `handleInvokeErrorWithAutoAuth`.\n *\n * For \"allow-to-fail\" sub-operations, prefer `client.tryInvoke()` over\n * manual `isInvokeError` + throw.\n */\nexport function isInvokeError(err: unknown): boolean {\n  return (\n    err instanceof UserAuthRequiredError ||\n    err instanceof AppScopeMissingError ||\n    err instanceof UserScopeInsufficientError\n  );\n}\n\n// ---------------------------------------------------------------------------\n// \u81EA\u52A8\u6388\u6743\uFF1AhandleInvokeErrorWithAutoAuth\n// ---------------------------------------------------------------------------\n\nexport { handleInvokeErrorWithAutoAuth } from '../auto-auth';\n"],
+  "mappings": "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",
+  "names": ["createClientGetter", "formatToolResult", "AppScopeMissingError", "UserAuthRequiredError", "UserScopeInsufficientError"]
+}

package/dist/src/tools/oapi/im/format-messages.js

@@ -0,0 +1,128 @@
+import { larkLogger } from "../../../core/lark-logger";
+import {
+  convertMessageContent,
+  buildConvertContextFromItem,
+  extractMentionOpenId
+} from "../../../messaging/converters/content-converter";
+import { getUATUserName, setUATUserNames, batchResolveUserNamesAsUser } from "./user-name-uat";
+import { millisStringToDateTime } from "./time-utils";
+const log = larkLogger("oapi/im/format-messages");
+function createUATFetchSubMessages(client) {
+  return async (messageId) => {
+    const res = await client.invokeByPath("feishu_im_user_get_messages.default", `/open-apis/im/v1/messages/${messageId}`, {
+      method: "GET",
+      query: { user_id_type: "open_id", card_msg_content_type: "raw_card_content" },
+      as: "user"
+    });
+    if (res.code !== 0) {
+      throw new Error(`API error: code=${res.code} msg=${res.msg}`);
+    }
+    return res.data?.items ?? [];
+  };
+}
+async function formatMessageItem(item, accountId, nameResolver, ctxOverrides) {
+  const messageId = item.message_id ?? "";
+  const msgType = item.msg_type ?? "unknown";
+  let content = "";
+  try {
+    const rawContent = item.body?.content ?? "";
+    if (rawContent) {
+      const ctx = {
+        ...buildConvertContextFromItem(item, messageId, accountId),
+        ...ctxOverrides
+      };
+      const result = await convertMessageContent(rawContent, msgType, ctx);
+      content = result.content;
+    }
+  } catch (err) {
+    log.warn("converter failed, falling back to raw content", {
+      messageId,
+      msgType,
+      error: err instanceof Error ? err.message : String(err)
+    });
+    content = item.body?.content ?? "";
+  }
+  const senderId = item.sender?.id ?? "";
+  const senderType = item.sender?.sender_type ?? "unknown";
+  let senderName;
+  if (senderId && senderType === "user") {
+    senderName = nameResolver(senderId);
+  }
+  const sender = {
+    id: senderId,
+    sender_type: senderType
+  };
+  if (senderName) {
+    sender.name = senderName;
+  }
+  let mentions;
+  if (item.mentions && item.mentions.length > 0) {
+    mentions = item.mentions.map((m) => ({
+      key: m.key ?? "",
+      id: extractMentionOpenId(m.id),
+      name: m.name ?? ""
+    }));
+  }
+  const createTime = item.create_time ? millisStringToDateTime(item.create_time) : "";
+  const formatted = {
+    message_id: messageId,
+    msg_type: msgType,
+    content,
+    sender,
+    create_time: createTime,
+    deleted: item.deleted ?? false,
+    updated: item.updated ?? false
+  };
+  if (item.thread_id) {
+    formatted.thread_id = item.thread_id;
+  } else if (item.parent_id) {
+    formatted.reply_to = item.parent_id;
+  }
+  if (mentions) {
+    formatted.mentions = mentions;
+  }
+  return formatted;
+}
+async function formatMessageList(items, account, log2, client) {
+  const accountId = account.accountId;
+  const nameResolver = (openId) => getUATUserName(accountId, openId);
+  const mentionNames = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    for (const m of item.mentions ?? []) {
+      const openId = extractMentionOpenId(m.id);
+      if (openId && m.name) {
+        mentionNames.set(openId, m.name);
+      }
+    }
+  }
+  if (mentionNames.size > 0) {
+    setUATUserNames(accountId, mentionNames);
+  }
+  const senderIds = [
+    ...new Set(
+      items.map((item) => item.sender?.sender_type === "user" ? item.sender.id : void 0).filter((id) => !!id)
+    )
+  ];
+  if (senderIds.length > 0) {
+    const missing = senderIds.filter((id) => getUATUserName(accountId, id) === void 0);
+    if (missing.length > 0) {
+      await batchResolveUserNamesAsUser({ client, openIds: missing, log: log2 });
+    }
+  }
+  const uatBatchResolve = async (openIds) => {
+    await batchResolveUserNamesAsUser({ client, openIds, log: log2 });
+  };
+  const ctxOverrides = {
+    account,
+    accountId,
+    resolveUserName: nameResolver,
+    batchResolveNames: uatBatchResolve,
+    fetchSubMessages: createUATFetchSubMessages(client)
+  };
+  return Promise.all(items.map((item) => formatMessageItem(item, accountId, nameResolver, ctxOverrides)));
+}
+export {
+  formatMessageItem,
+  formatMessageList
+};
+//# sourceMappingURL=format-messages.js.map

package/dist/src/tools/oapi/im/format-messages.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/tools/oapi/im/format-messages.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * \u6D88\u606F\u683C\u5F0F\u5316\u516C\u5171\u51FD\u6570\n *\n * \u5C06\u98DE\u4E66 IM API \u8FD4\u56DE\u7684\u539F\u59CB\u6D88\u606F\u5BF9\u8C61\u8F6C\u6362\u4E3A AI \u53EF\u8BFB\u7684 JSON \u683C\u5F0F\u3002\n * \u7531 feishu_im_user_get_messages \u548C feishu_im_user_get_thread_messages \u5171\u4EAB\u3002\n *\n * \u6240\u6709 API \u8C03\u7528\u5747\u901A\u8FC7 UAT\uFF08\u7528\u6237\u8EAB\u4EFD\uFF09\u8FDB\u884C\u3002\n */\n\nimport type { LarkAccount } from '../../../core/types';\nimport type { ToolClient } from '../../../core/tool-client';\nimport type { ApiMessageItem } from '../../../messaging/converters/types';\nimport { larkLogger } from '../../../core/lark-logger';\nimport {\n  convertMessageContent,\n  buildConvertContextFromItem,\n  extractMentionOpenId,\n} from '../../../messaging/converters/content-converter';\nimport { getUATUserName, setUATUserNames, batchResolveUserNamesAsUser } from './user-name-uat';\nimport { millisStringToDateTime } from './time-utils';\n\nconst log = larkLogger('oapi/im/format-messages');\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface FormattedMessage {\n  message_id: string;\n  msg_type: string;\n  content: string;\n  sender: { id: string; sender_type: string; name?: string };\n  create_time: string;\n  /** \u56DE\u590D\u7684\u6D88\u606F ID\uFF08parent_id\uFF09\u3002\u6709 thread_id \u65F6\u7701\u7565\uFF0C\u56E0\u4E3A\u8BDD\u9898\u4E0A\u4E0B\u6587\u53EF\u63A8\u65AD */\n  reply_to?: string;\n  thread_id?: string;\n  mentions?: Array<{ key: string; id: string; name: string }>;\n  deleted: boolean;\n  updated: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// UAT callbacks for merge_forward expansion\n// ---------------------------------------------------------------------------\n\n/** \u901A\u8FC7 UAT \u83B7\u53D6\u5408\u5E76\u8F6C\u53D1\u5B50\u6D88\u606F */\nfunction createUATFetchSubMessages(client: ToolClient) {\n  return async (messageId: string): Promise<ApiMessageItem[]> => {\n    const res = await client.invokeByPath<{\n      code?: number;\n      msg?: string;\n      data?: { items?: ApiMessageItem[] };\n    }>('feishu_im_user_get_messages.default', `/open-apis/im/v1/messages/${messageId}`, {\n      method: 'GET',\n      query: { user_id_type: 'open_id', card_msg_content_type: 'raw_card_content' },\n      as: 'user',\n    });\n    if (res.code !== 0) {\n      throw new Error(`API error: code=${res.code} msg=${res.msg}`);\n    }\n    return res.data?.items ?? [];\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * \u683C\u5F0F\u5316\u5355\u6761\u6D88\u606F\u5BF9\u8C61\u3002\n *\n * \u4F7F\u7528 convertMessageContent \u5C06 body.content \u8F6C\u4E3A AI \u53EF\u8BFB\u6587\u672C\uFF0C\n * \u5E76\u8FC7\u6EE4\u6389 AI \u4E0D\u9700\u8981\u7684\u5B57\u6BB5\uFF08upper_message_id\u3001tenant_key \u7B49\uFF09\u3002\n */\nexport async function formatMessageItem(\n  item: ApiMessageItem,\n  accountId: string,\n  nameResolver: (openId: string) => string | undefined,\n  ctxOverrides?: Partial<import('../../../messaging/converters/types.js').ConvertContext>,\n): Promise<FormattedMessage> {\n  const messageId: string = item.message_id ?? '';\n  const msgType: string = item.msg_type ?? 'unknown';\n\n  // \u4F7F\u7528 converter \u5904\u7406\u6D88\u606F\u5185\u5BB9\n  let content = '';\n  try {\n    const rawContent: string = item.body?.content ?? '';\n    if (rawContent) {\n      const ctx = {\n        ...buildConvertContextFromItem(item, messageId, accountId),\n        ...ctxOverrides,\n      };\n      const result = await convertMessageContent(rawContent, msgType, ctx);\n      content = result.content;\n    }\n  } catch (err) {\n    log.warn('converter failed, falling back to raw content', {\n      messageId,\n      msgType,\n      error: err instanceof Error ? err.message : String(err),\n    });\n    content = item.body?.content ?? '';\n  }\n\n  // \u6784\u5EFA sender\uFF08\u4ECE UAT \u7F13\u5B58\u4E2D\u8BFB\u53D6\u540D\u5B57\uFF09\n  const senderId: string = item.sender?.id ?? '';\n  const senderType: string = item.sender?.sender_type ?? 'unknown';\n  let senderName: string | undefined;\n  if (senderId && senderType === 'user') {\n    senderName = nameResolver(senderId);\n  }\n\n  const sender: FormattedMessage['sender'] = {\n    id: senderId,\n    sender_type: senderType,\n  };\n  if (senderName) {\n    sender.name = senderName;\n  }\n\n  // \u6784\u5EFA mentions\uFF08\u7B80\u5316\u683C\u5F0F\uFF09\n  let mentions: FormattedMessage['mentions'];\n  if (item.mentions && item.mentions.length > 0) {\n    mentions = item.mentions.map((m) => ({\n      key: m.key ?? '',\n      id: extractMentionOpenId(m.id),\n      name: m.name ?? '',\n    }));\n  }\n\n  // \u8F6C\u6362 create_time\uFF08\u98DE\u4E66 API \u8FD4\u56DE\u6BEB\u79D2\u65F6\u95F4\u6233\u5B57\u7B26\u4E32 \u2192 ISO 8601 +08:00\uFF09\n  const createTime = item.create_time ? millisStringToDateTime(item.create_time) : '';\n\n  const formatted: FormattedMessage = {\n    message_id: messageId,\n    msg_type: msgType,\n    content,\n    sender,\n    create_time: createTime,\n    deleted: item.deleted ?? false,\n    updated: item.updated ?? false,\n  };\n\n  // \u53EF\u9009\u5B57\u6BB5\n  // reply_to\uFF08parent_id\uFF09\u548C thread_id \u7684\u5C55\u793A\u903B\u8F91\u53C2\u8003 Go MCP\uFF1A\n  // - \u6709 thread_id \u65F6\u53EA\u5C55\u793A thread_id\uFF0C\u7701\u7565 reply_to\uFF08\u8BDD\u9898\u4E0A\u4E0B\u6587\u53EF\u63A8\u65AD\uFF09\n  // - \u65E0 thread_id \u4F46\u6709 parent_id \u65F6\uFF0C\u5C55\u793A\u4E3A reply_to\n  if (item.thread_id) {\n    formatted.thread_id = item.thread_id;\n  } else if (item.parent_id) {\n    formatted.reply_to = item.parent_id;\n  }\n  if (mentions) {\n    formatted.mentions = mentions;\n  }\n\n  return formatted;\n}\n\n/**\n * \u6279\u91CF\u683C\u5F0F\u5316\u6D88\u606F\u5217\u8868\uFF08UAT \u8DEF\u5F84\uFF09\u3002\n *\n * \u5148\u6279\u91CF\u89E3\u6790\u6240\u6709 sender \u7684\u540D\u5B57\uFF08\u5199\u5165 UAT \u7F13\u5B58\uFF09\uFF0C\u518D\u9010\u6761\u683C\u5F0F\u5316\u3002\n * \u8FD9\u6837 formatMessageItem \u4E2D\u7684 sender.name \u548C converter \u7684\n * resolveUserName \u90FD\u80FD\u4ECE UAT \u7F13\u5B58\u4E2D\u8BFB\u5230\u540D\u5B57\u3002\n */\nexport async function formatMessageList(\n  items: ApiMessageItem[],\n  account: LarkAccount,\n  log: (...args: unknown[]) => void,\n  client: ToolClient,\n): Promise<FormattedMessage[]> {\n  const accountId = account.accountId;\n  const nameResolver = (openId: string) => getUATUserName(accountId, openId);\n\n  // 1. \u628A mention \u81EA\u5E26\u7684\u540D\u5B57\u5199\u5165 UAT \u7F13\u5B58\uFF08\u514D\u8D39\u4FE1\u606F\uFF09\n  const mentionNames = new Map<string, string>();\n  for (const item of items) {\n    for (const m of item.mentions ?? []) {\n      const openId = extractMentionOpenId(m.id);\n      if (openId && m.name) {\n        mentionNames.set(openId, m.name);\n      }\n    }\n  }\n  if (mentionNames.size > 0) {\n    setUATUserNames(accountId, mentionNames);\n  }\n\n  // 2. \u6536\u96C6\u6240\u6709 user \u7C7B\u578B sender \u7684 open_id\n  const senderIds = [\n    ...new Set(\n      items\n        .map((item) => (item.sender?.sender_type === 'user' ? item.sender.id : undefined))\n        .filter((id): id is string => !!id),\n    ),\n  ];\n\n  // 3. \u6279\u91CF\u89E3\u6790 UAT \u7F13\u5B58\u4E2D\u7F3A\u5931\u7684\u540D\u5B57\n  if (senderIds.length > 0) {\n    const missing = senderIds.filter((id) => getUATUserName(accountId, id) === undefined);\n    if (missing.length > 0) {\n      await batchResolveUserNamesAsUser({ client, openIds: missing, log });\n    }\n  }\n\n  // 4. \u6784\u5EFA merge_forward \u5C55\u5F00\u6240\u9700\u7684\u56DE\u8C03\n  const uatBatchResolve = async (openIds: string[]) => {\n    await batchResolveUserNamesAsUser({ client, openIds, log });\n  };\n  const ctxOverrides = {\n    account,\n    accountId,\n    resolveUserName: nameResolver,\n    batchResolveNames: uatBatchResolve,\n    fetchSubMessages: createUATFetchSubMessages(client),\n  };\n\n  // 5. \u9010\u6761\u683C\u5F0F\u5316\n  return Promise.all(items.map((item) => formatMessageItem(item, accountId, nameResolver, ctxOverrides)));\n}\n"],
+  "mappings": "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",
+  "names": ["log"]
+}

package/dist/src/tools/oapi/im/index.js

@@ -0,0 +1,15 @@
+import { registerFeishuImUserMessageTool } from "./message";
+import { registerFeishuImUserFetchResourceTool } from "./resource";
+import { registerMessageReadTools } from "./message-read";
+function registerFeishuImTools(api) {
+  registerFeishuImUserMessageTool(api);
+  registerFeishuImUserFetchResourceTool(api);
+  registerMessageReadTools(api);
+  api.logger.info?.(
+    "feishu_im: Registered feishu_im_user_message, feishu_im_user_fetch_resource, feishu_im_user_get_messages, feishu_im_user_get_thread_messages, feishu_im_user_search_messages"
+  );
+}
+export {
+  registerFeishuImTools
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/tools/oapi/im/index.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * IM Tools Index\n *\n * \u5373\u65F6\u901A\u8BAF\u76F8\u5173\u5DE5\u5177\n */\n\nimport type { OpenClawPluginApi } from 'openclaw/plugin-sdk';\nimport { registerFeishuImUserMessageTool } from './message';\nimport { registerFeishuImUserFetchResourceTool } from './resource';\nimport { registerMessageReadTools } from './message-read';\n\nexport function registerFeishuImTools(api: OpenClawPluginApi) {\n  registerFeishuImUserMessageTool(api);\n  registerFeishuImUserFetchResourceTool(api);\n  registerMessageReadTools(api);\n\n  api.logger.info?.(\n    'feishu_im: Registered feishu_im_user_message, feishu_im_user_fetch_resource, feishu_im_user_get_messages, feishu_im_user_get_thread_messages, feishu_im_user_search_messages',\n  );\n}\n"],
+  "mappings": "AAUA,SAAS,uCAAuC;AAChD,SAAS,6CAA6C;AACtD,SAAS,gCAAgC;AAElC,SAAS,sBAAsB,KAAwB;AAC5D,kCAAgC,GAAG;AACnC,wCAAsC,GAAG;AACzC,2BAAyB,GAAG;AAE5B,MAAI,OAAO;AAAA,IACT;AAAA,EACF;AACF;",
+  "names": []
+}