@larksuite/openclaw-lark 2026.3.9

package/src/core/tool-scopes.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Tool Scopes 配置
+ *
+ * 定义所有工具动作所需的飞书权限映射。
+ *
+ * ## 维护方式
+ *
+ * ⚠️ 此文件采用**手动维护**，新增或修改工具时需同步更新。
+ *
+ * ### 新增工具动作
+ *
+ * 1. 在 `ToolActionKey` 类型中添加新键：
+ *    ```typescript
+ *    export type ToolActionKey =
+ *      | "feishu_calendar_event.create"
+ *      | "feishu_new_tool.action"  // 新增
+ *    ```
+ *
+ * 2. 在 `TOOL_SCOPES` 对象中添加对应配置：
+ *    ```typescript
+ *    export const TOOL_SCOPES: ToolScopeMapping = {
+ *      "feishu_new_tool.action": [
+ *        "required:scope:here"
+ *      ],
+ *    };
+ *    ```
+ *
+ * 3. 运行 TypeScript 类型检查验证一致性：
+ *    ```bash
+ *    cd openclaw/feishu && npx tsc --noEmit
+ *    ```
+ *
+ * ### 如何确定所需 Scope
+ *
+ * 1. **查阅飞书开放平台 API 文档**：https://open.feishu.cn/document
+ * 2. **使用 feishu-oapi-search skill**：在 Claude Code 中搜索 API 文档
+ * 3. **参考类似工具**：查看功能相近的工具的 scope 配置
+ * 4. **实际测试**：观察 API 调用的错误码（LARK_ERROR.APP_SCOPE_MISSING/99991672=应用缺权限，LARK_ERROR.USER_SCOPE_INSUFFICIENT/99991679=用户缺授权）
+ *
+ * 最后更新: 2026-03-03
+ */
+/**
+ * 所有可用的工具动作键
+ *
+ * 格式：{tool_name}.{action_name}
+ *
+ * 示例：
+ * - "feishu_calendar_event.create"
+ * - "feishu_bitable_app_table_record.update"
+ *
+ * 总计：98 个工具动作
+ */
+export type ToolActionKey = 'feishu_bitable_app.copy' | 'feishu_bitable_app.create' | 'feishu_bitable_app.get' | 'feishu_bitable_app.list' | 'feishu_bitable_app.patch' | 'feishu_bitable_app_table.batch_create' | 'feishu_bitable_app_table.batch_delete' | 'feishu_bitable_app_table.create' | 'feishu_bitable_app_table.delete' | 'feishu_bitable_app_table.list' | 'feishu_bitable_app_table.patch' | 'feishu_bitable_app_table_field.create' | 'feishu_bitable_app_table_field.delete' | 'feishu_bitable_app_table_field.list' | 'feishu_bitable_app_table_field.update' | 'feishu_bitable_app_table_record.batch_create' | 'feishu_bitable_app_table_record.batch_delete' | 'feishu_bitable_app_table_record.batch_update' | 'feishu_bitable_app_table_record.create' | 'feishu_bitable_app_table_record.delete' | 'feishu_bitable_app_table_record.list' | 'feishu_bitable_app_table_record.update' | 'feishu_bitable_app_table_view.create' | 'feishu_bitable_app_table_view.delete' | 'feishu_bitable_app_table_view.get' | 'feishu_bitable_app_table_view.list' | 'feishu_bitable_app_table_view.patch' | 'feishu_calendar_calendar.get' | 'feishu_calendar_calendar.list' | 'feishu_calendar_calendar.primary' | 'feishu_calendar_event.create' | 'feishu_calendar_event.delete' | 'feishu_calendar_event.get' | 'feishu_calendar_event.instance_view' | 'feishu_calendar_event.instances' | 'feishu_calendar_event.list' | 'feishu_calendar_event.patch' | 'feishu_calendar_event.reply' | 'feishu_calendar_event.search' | 'feishu_calendar_event_attendee.batch_delete' | 'feishu_calendar_event_attendee.create' | 'feishu_calendar_event_attendee.list' | 'feishu_calendar_freebusy.list' | 'feishu_chat.get' | 'feishu_chat.search' | 'feishu_chat_members.default' | 'feishu_create_doc.default' | 'feishu_doc_comments.create' | 'feishu_doc_comments.list' | 'feishu_doc_comments.patch' | 'feishu_doc_media.download' | 'feishu_doc_media.insert' | 'feishu_drive_file.copy' | 'feishu_drive_file.delete' | 'feishu_drive_file.download' | 'feishu_drive_file.get_meta' | 'feishu_drive_file.list' | 'feishu_drive_file.move' | 'feishu_drive_file.upload' | 'feishu_fetch_doc.default' | 'feishu_get_user.default' | 'feishu_im_user_fetch_resource.default' | 'feishu_im_user_get_messages.default' | 'feishu_im_user_message.reply' | 'feishu_im_user_message.send' | 'feishu_im_user_search_messages.default' | 'feishu_search_doc_wiki.search' | 'feishu_search_user.default' | 'feishu_task_comment.create' | 'feishu_task_comment.get' | 'feishu_task_comment.list' | 'feishu_task_subtask.create' | 'feishu_task_subtask.list' | 'feishu_task_task.create' | 'feishu_task_task.get' | 'feishu_task_task.list' | 'feishu_task_task.patch' | 'feishu_task_tasklist.add_members' | 'feishu_task_tasklist.create' | 'feishu_task_tasklist.delete' | 'feishu_task_tasklist.get' | 'feishu_task_tasklist.list' | 'feishu_task_tasklist.patch' | 'feishu_task_tasklist.remove_members' | 'feishu_task_tasklist.tasks' | 'feishu_update_doc.default' | 'feishu_wiki_space.create' | 'feishu_wiki_space.get' | 'feishu_wiki_space.list' | 'feishu_wiki_space_node.copy' | 'feishu_wiki_space_node.create' | 'feishu_wiki_space_node.get' | 'feishu_wiki_space_node.list' | 'feishu_wiki_space_node.move' | 'feishu_sheet.info' | 'feishu_sheet.read' | 'feishu_sheet.write' | 'feishu_sheet.append' | 'feishu_sheet.find' | 'feishu_sheet.create' | 'feishu_sheet.export';
+/**
+ * Tool Scope 映射类型
+ *
+ * 将每个 ToolActionKey 映射到其所需的 scope 数组
+ */
+export type ToolScopeMapping = Record<ToolActionKey, string[]>;
+/**
+ * Tool Scope 数据
+ *
+ * 每个工具动作所需的飞书权限列表（Required Scopes）
+ *
+ * ## 数据说明
+ *
+ * - 空数组 `[]` 表示该工具动作不需要任何权限
+ * - 多个权限表示需要同时拥有所有权限（AND 关系）
+ * - 所有 scope 都是 user scopes（用户级权限）
+ *
+ * ## 示例
+ *
+ * ```typescript
+ * TOOL_SCOPES["feishu_calendar_event.create"]
+ * // 返回: ["calendar:calendar.event:create", "calendar:calendar.event:update"]
+ * ```
+ *
+ * @see {@link ToolActionKey} 所有可用的工具动作键
+ */
+export declare const TOOL_SCOPES: ToolScopeMapping;
+/**
+ * 飞书插件运行必须开通的应用身份权限清单
+ *
+ * 这些权限是插件基础功能（消息接收、卡片交互、基本信息查询等）所必需的，
+ * 如果缺失这些权限，插件将无法正常工作。
+ *
+ * 权限分类：
+ * - im:message.* - 消息接收和发送
+ * - im:chat.* - 群聊管理
+ * - im:resource - 消息资源（图片、文件等）
+ * - cardkit:card.* - 卡片交互
+ * - application:application:self_manage - 应用自身权限查询（权限检查基础）
+ * - contact:contact.base:readonly - 通讯录基础信息
+ * - docx:document:readonly - 文档基础只读（文档链接预览等）
+ *
+ * 最后更新: 2026-03-03
+ */
+export declare const REQUIRED_APP_SCOPES: readonly ["contact:contact.base:readonly", "docx:document:readonly", "im:chat:read", "im:chat:update", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message.pins:read", "im:message.pins:write_only", "im:message.reactions:read", "im:message.reactions:write_only", "im:message:readonly", "im:message:recall", "im:message:send_as_bot", "im:message:send_multi_users", "im:message:send_sys_msg", "im:message:update", "im:resource", "application:application:self_manage", "cardkit:card:write", "cardkit:card:read"];
+/**
+ * 必需应用权限类型
+ */
+export type RequiredAppScope = (typeof REQUIRED_APP_SCOPES)[number];
+/**
+ * 必需权限用途说明
+ *
+ * 描述每个必需权限的具体用途，帮助管理员理解为什么需要开通该权限。
+ */
+export declare const REQUIRED_SCOPE_DESCRIPTIONS: Record<RequiredAppScope, string>;
+/**
+ * 高敏感权限清单
+ *
+ * 这些权限具有较高的敏感度，不应在批量授权时自动申请。
+ * 用户需要明确知晓这些权限的影响后，才能手动授权。
+ *
+ * 权限说明：
+ * - im:message:send_as_user - 以用户身份发送消息（高风险，可能被滥用发送钓鱼或垃圾消息）
+ *
+ * 使用场景：
+ * - 批量授权时会自动过滤掉这些权限
+ * - 需要这些权限的功能会单独提示用户授权
+ *
+ * 最后更新: 2026-03-03
+ */
+export declare const SENSITIVE_SCOPES: readonly ["im:message.send_as_user"];
+/**
+ * 高敏感权限类型
+ */
+export type SensitiveScope = (typeof SENSITIVE_SCOPES)[number];
+/**
+ * 过滤掉高敏感权限
+ *
+ * 用于批量授权时排除高敏感权限，这些权限需要用户明确授权。
+ *
+ * @param scopes - 原始权限列表
+ * @returns 过滤后的权限列表（不包含高敏感权限）
+ *
+ * @example
+ * ```typescript
+ * const allScopes = ["im:message", "im:message:send_as_user", "calendar:calendar:read"];
+ * const safeScopes = filterSensitiveScopes(allScopes);
+ * // 返回: ["im:message", "calendar:calendar:read"]
+ * ```
+ */
+export declare function filterSensitiveScopes(scopes: string[]): string[];
+/**
+ * 工具动作总数: 98
+ * 唯一 scope 总数: 66
+ * 必需应用权限总数: 20
+ * 高敏感权限总数: 1
+ */
+//# sourceMappingURL=tool-scopes.d.ts.map

package/src/core/tool-scopes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-scopes.d.ts","sourceRoot":"","sources":["../../../src/core/tool-scopes.ts"],"names":[],"mappings":"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"}

package/src/core/tool-scopes.js

@@ -0,0 +1,326 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Tool Scopes 配置
+ *
+ * 定义所有工具动作所需的飞书权限映射。
+ *
+ * ## 维护方式
+ *
+ * ⚠️ 此文件采用**手动维护**，新增或修改工具时需同步更新。
+ *
+ * ### 新增工具动作
+ *
+ * 1. 在 `ToolActionKey` 类型中添加新键：
+ *    ```typescript
+ *    export type ToolActionKey =
+ *      | "feishu_calendar_event.create"
+ *      | "feishu_new_tool.action"  // 新增
+ *    ```
+ *
+ * 2. 在 `TOOL_SCOPES` 对象中添加对应配置：
+ *    ```typescript
+ *    export const TOOL_SCOPES: ToolScopeMapping = {
+ *      "feishu_new_tool.action": [
+ *        "required:scope:here"
+ *      ],
+ *    };
+ *    ```
+ *
+ * 3. 运行 TypeScript 类型检查验证一致性：
+ *    ```bash
+ *    cd openclaw/feishu && npx tsc --noEmit
+ *    ```
+ *
+ * ### 如何确定所需 Scope
+ *
+ * 1. **查阅飞书开放平台 API 文档**：https://open.feishu.cn/document
+ * 2. **使用 feishu-oapi-search skill**：在 Claude Code 中搜索 API 文档
+ * 3. **参考类似工具**：查看功能相近的工具的 scope 配置
+ * 4. **实际测试**：观察 API 调用的错误码（LARK_ERROR.APP_SCOPE_MISSING/99991672=应用缺权限，LARK_ERROR.USER_SCOPE_INSUFFICIENT/99991679=用户缺授权）
+ *
+ * 最后更新: 2026-03-03
+ */
+// ===== 数据 =====
+/**
+ * Tool Scope 数据
+ *
+ * 每个工具动作所需的飞书权限列表（Required Scopes）
+ *
+ * ## 数据说明
+ *
+ * - 空数组 `[]` 表示该工具动作不需要任何权限
+ * - 多个权限表示需要同时拥有所有权限（AND 关系）
+ * - 所有 scope 都是 user scopes（用户级权限）
+ *
+ * ## 示例
+ *
+ * ```typescript
+ * TOOL_SCOPES["feishu_calendar_event.create"]
+ * // 返回: ["calendar:calendar.event:create", "calendar:calendar.event:update"]
+ * ```
+ *
+ * @see {@link ToolActionKey} 所有可用的工具动作键
+ */
+export const TOOL_SCOPES = {
+    'feishu_bitable_app.create': ['base:app:create'],
+    'feishu_bitable_app.get': ['base:app:read'],
+    'feishu_bitable_app.list': ['space:document:retrieve'],
+    'feishu_bitable_app.patch': ['base:app:update'],
+    'feishu_bitable_app.copy': ['base:app:copy'],
+    'feishu_bitable_app_table.create': ['base:table:create'],
+    'feishu_bitable_app_table.list': ['base:table:read'],
+    'feishu_bitable_app_table.patch': ['base:table:update'],
+    'feishu_bitable_app_table.delete': ['base:table:delete'],
+    'feishu_bitable_app_table.batch_create': ['base:table:create'],
+    'feishu_bitable_app_table.batch_delete': ['base:table:delete'],
+    'feishu_bitable_app_table_record.create': ['base:record:create'],
+    'feishu_bitable_app_table_record.update': ['base:record:update'],
+    'feishu_bitable_app_table_record.delete': ['base:record:delete'],
+    'feishu_bitable_app_table_record.batch_create': ['base:record:create'],
+    'feishu_bitable_app_table_record.batch_update': ['base:record:update'],
+    'feishu_bitable_app_table_record.batch_delete': ['base:record:delete'],
+    'feishu_bitable_app_table_record.list': ['base:record:retrieve'],
+    'feishu_bitable_app_table_field.create': ['base:field:create'],
+    'feishu_bitable_app_table_field.list': ['base:field:read'],
+    'feishu_bitable_app_table_field.update': ['base:field:read', 'base:field:update'],
+    'feishu_bitable_app_table_field.delete': ['base:field:delete'],
+    'feishu_bitable_app_table_view.create': ['base:view:write_only'],
+    'feishu_bitable_app_table_view.get': ['base:view:read'],
+    'feishu_bitable_app_table_view.list': ['base:view:read'],
+    'feishu_bitable_app_table_view.patch': ['base:view:write_only'],
+    'feishu_bitable_app_table_view.delete': ['base:view:write_only'],
+    'feishu_calendar_calendar.list': ['calendar:calendar:read'],
+    'feishu_calendar_calendar.get': ['calendar:calendar:read'],
+    'feishu_calendar_calendar.primary': ['calendar:calendar:read'],
+    'feishu_calendar_event.create': ['calendar:calendar.event:create', 'calendar:calendar.event:update'],
+    'feishu_calendar_event.list': ['calendar:calendar.event:read'],
+    'feishu_calendar_event.get': ['calendar:calendar.event:read'],
+    'feishu_calendar_event.patch': ['calendar:calendar.event:update'],
+    'feishu_calendar_event.delete': ['calendar:calendar.event:delete'],
+    'feishu_calendar_event.search': ['calendar:calendar.event:read'],
+    'feishu_calendar_event.reply': ['calendar:calendar.event:reply'],
+    'feishu_calendar_event.instances': ['calendar:calendar.event:read'],
+    'feishu_calendar_event.instance_view': ['calendar:calendar.event:read'],
+    'feishu_calendar_event_attendee.create': ['calendar:calendar.event:update'],
+    'feishu_calendar_event_attendee.list': ['calendar:calendar.event:read'],
+    'feishu_calendar_event_attendee.batch_delete': ['calendar:calendar.event:read', 'calendar:calendar.event:update'],
+    'feishu_calendar_freebusy.list': ['calendar:calendar.free_busy:read'],
+    'feishu_task_task.create': ['task:task:write', 'task:task:writeonly'],
+    'feishu_task_task.get': ['task:task:read', 'task:task:write'],
+    'feishu_task_task.list': ['task:task:read', 'task:task:write'],
+    'feishu_task_task.patch': ['task:task:write', 'task:task:writeonly'],
+    'feishu_task_tasklist.create': ['task:tasklist:write'],
+    'feishu_task_tasklist.get': ['task:tasklist:read', 'task:tasklist:write'],
+    'feishu_task_tasklist.list': ['task:tasklist:read', 'task:tasklist:write'],
+    'feishu_task_tasklist.tasks': ['task:tasklist:read', 'task:tasklist:write'],
+    'feishu_task_tasklist.patch': ['task:tasklist:write'],
+    'feishu_task_tasklist.delete': ['task:tasklist:write'],
+    'feishu_task_tasklist.add_members': ['task:tasklist:write'],
+    'feishu_task_tasklist.remove_members': ['task:tasklist:write'],
+    'feishu_task_comment.create': ['task:comment:write'],
+    'feishu_task_comment.list': ['task:comment:read', 'task:comment:write'],
+    'feishu_task_comment.get': ['task:comment:read', 'task:comment:write'],
+    'feishu_task_subtask.create': ['task:task:write'],
+    'feishu_task_subtask.list': ['task:task:read', 'task:task:write'],
+    'feishu_chat.search': ['im:chat:read'],
+    'feishu_chat.get': ['im:chat:read'],
+    'feishu_chat_members.default': ['im:chat.members:read'],
+    'feishu_drive_file.list': ['space:document:retrieve'],
+    'feishu_drive_file.get_meta': ['drive:drive.metadata:readonly'],
+    'feishu_drive_file.copy': ['docs:document:copy'],
+    'feishu_drive_file.move': ['space:document:move'],
+    'feishu_drive_file.delete': ['space:document:delete'],
+    'feishu_drive_file.upload': ['drive:file:upload'],
+    'feishu_drive_file.download': ['drive:file:download'],
+    'feishu_doc_media.download': ['board:whiteboard:node:read', 'docs:document.media:download'],
+    'feishu_doc_media.insert': ['docx:document:write_only', 'docs:document.media:upload'],
+    'feishu_doc_comments.list': ['wiki:node:read', 'docs:document.comment:read'],
+    'feishu_doc_comments.create': ['wiki:node:read', 'docs:document.comment:create'],
+    'feishu_doc_comments.patch': ['docs:document.comment:update'],
+    'feishu_wiki_space.list': ['wiki:space:retrieve'],
+    'feishu_wiki_space.get': ['wiki:space:read'],
+    'feishu_wiki_space.create': ['wiki:space:write_only'],
+    'feishu_wiki_space_node.list': ['wiki:node:retrieve'],
+    'feishu_wiki_space_node.get': ['wiki:node:read'],
+    'feishu_wiki_space_node.create': ['wiki:node:create'],
+    'feishu_wiki_space_node.move': ['wiki:node:move'],
+    'feishu_wiki_space_node.copy': ['wiki:node:copy'],
+    'feishu_im_user_message.send': ['im:message', 'im:message.send_as_user'],
+    'feishu_im_user_message.reply': ['im:message', 'im:message.send_as_user'],
+    'feishu_im_user_fetch_resource.default': [
+        'im:message.group_msg:get_as_user',
+        'im:message.p2p_msg:get_as_user',
+        'im:message:readonly',
+    ],
+    'feishu_im_user_get_messages.default': [
+        'im:chat:read',
+        'im:message:readonly',
+        'im:message.group_msg:get_as_user',
+        'im:message.p2p_msg:get_as_user',
+        'contact:contact.base:readonly',
+        'contact:user.base:readonly',
+    ],
+    'feishu_im_user_search_messages.default': [
+        'im:chat:read',
+        'im:message:readonly',
+        'im:message.group_msg:get_as_user',
+        'im:message.p2p_msg:get_as_user',
+        'contact:contact.base:readonly',
+        'contact:user.base:readonly',
+        'search:message',
+    ],
+    'feishu_search_doc_wiki.search': ['search:docs:read'],
+    'feishu_get_user.default': ['contact:contact.base:readonly', 'contact:user.base:readonly'],
+    'feishu_search_user.default': ['contact:user:search'],
+    'feishu_create_doc.default': [
+        'board:whiteboard:node:create',
+        'docx:document:create',
+        'docx:document:readonly',
+        'docx:document:write_only',
+        'wiki:node:create',
+        'wiki:node:read',
+        'docs:document.media:upload',
+    ],
+    'feishu_fetch_doc.default': ['docx:document:readonly', 'wiki:node:read'],
+    'feishu_update_doc.default': [
+        'board:whiteboard:node:create',
+        'docx:document:create',
+        'docx:document:readonly',
+        'docx:document:write_only',
+    ],
+    'feishu_sheet.info': ['sheets:spreadsheet.meta:read', 'sheets:spreadsheet:read'],
+    'feishu_sheet.read': ['sheets:spreadsheet.meta:read', 'sheets:spreadsheet:read'],
+    'feishu_sheet.write': [
+        'sheets:spreadsheet.meta:read',
+        'sheets:spreadsheet:read',
+        'sheets:spreadsheet:create',
+        'sheets:spreadsheet:write_only',
+    ],
+    'feishu_sheet.append': [
+        'sheets:spreadsheet.meta:read',
+        'sheets:spreadsheet:read',
+        'sheets:spreadsheet:create',
+        'sheets:spreadsheet:write_only',
+    ],
+    'feishu_sheet.find': ['sheets:spreadsheet.meta:read', 'sheets:spreadsheet:read'],
+    'feishu_sheet.create': [
+        'sheets:spreadsheet.meta:read',
+        'sheets:spreadsheet:read',
+        'sheets:spreadsheet:create',
+        'sheets:spreadsheet:write_only',
+    ],
+    'feishu_sheet.export': ['docs:document:export'],
+};
+// ===== 必需的应用身份权限 =====
+/**
+ * 飞书插件运行必须开通的应用身份权限清单
+ *
+ * 这些权限是插件基础功能（消息接收、卡片交互、基本信息查询等）所必需的，
+ * 如果缺失这些权限，插件将无法正常工作。
+ *
+ * 权限分类：
+ * - im:message.* - 消息接收和发送
+ * - im:chat.* - 群聊管理
+ * - im:resource - 消息资源（图片、文件等）
+ * - cardkit:card.* - 卡片交互
+ * - application:application:self_manage - 应用自身权限查询（权限检查基础）
+ * - contact:contact.base:readonly - 通讯录基础信息
+ * - docx:document:readonly - 文档基础只读（文档链接预览等）
+ *
+ * 最后更新: 2026-03-03
+ */
+export const REQUIRED_APP_SCOPES = [
+    'contact:contact.base:readonly',
+    'docx:document:readonly',
+    'im:chat:read',
+    'im:chat:update',
+    'im:message.group_at_msg:readonly',
+    'im:message.p2p_msg:readonly',
+    'im:message.pins:read',
+    'im:message.pins:write_only',
+    'im:message.reactions:read',
+    'im:message.reactions:write_only',
+    'im:message:readonly',
+    'im:message:recall',
+    'im:message:send_as_bot',
+    'im:message:send_multi_users',
+    'im:message:send_sys_msg',
+    'im:message:update',
+    'im:resource',
+    'application:application:self_manage',
+    'cardkit:card:write',
+    'cardkit:card:read',
+];
+/**
+ * 必需权限用途说明
+ *
+ * 描述每个必需权限的具体用途，帮助管理员理解为什么需要开通该权限。
+ */
+export const REQUIRED_SCOPE_DESCRIPTIONS = {
+    'contact:contact.base:readonly': '获取用户基本信息（姓名、头像）',
+    'docx:document:readonly': '读取文档内容、预览文档链接',
+    'im:chat:read': '读取群聊信息、获取群成员列表',
+    'im:chat:update': '修改群聊设置（群名称、群公告等）',
+    'im:message.group_at_msg:readonly': '接收群聊中 @ 机器人的消息',
+    'im:message.p2p_msg:readonly': '接收私聊消息',
+    'im:message.pins:read': '读取消息置顶状态',
+    'im:message.pins:write_only': '置顶/取消置顶消息',
+    'im:message.reactions:read': '读取消息表情回复',
+    'im:message.reactions:write_only': '添加/删除消息表情回复',
+    'im:message:readonly': '读取消息内容、历史消息',
+    'im:message:recall': '↩撤回机器人发送的消息',
+    'im:message:send_as_bot': '以机器人身份发送消息',
+    'im:message:send_multi_users': '批量发送私聊消息',
+    'im:message:send_sys_msg': '发送系统通知消息',
+    'im:message:update': '更新/编辑已发送的消息',
+    'im:resource': '上传/下载消息资源（图片、文件等）',
+    'application:application:self_manage': '查询应用自身权限状态（诊断基础）',
+    'cardkit:card:write': '创建和更新消息卡片',
+    'cardkit:card:read': '读取消息卡片状态',
+};
+// ===== 高敏感权限 =====
+/**
+ * 高敏感权限清单
+ *
+ * 这些权限具有较高的敏感度，不应在批量授权时自动申请。
+ * 用户需要明确知晓这些权限的影响后，才能手动授权。
+ *
+ * 权限说明：
+ * - im:message:send_as_user - 以用户身份发送消息（高风险，可能被滥用发送钓鱼或垃圾消息）
+ *
+ * 使用场景：
+ * - 批量授权时会自动过滤掉这些权限
+ * - 需要这些权限的功能会单独提示用户授权
+ *
+ * 最后更新: 2026-03-03
+ */
+export const SENSITIVE_SCOPES = ['im:message.send_as_user'];
+/**
+ * 过滤掉高敏感权限
+ *
+ * 用于批量授权时排除高敏感权限，这些权限需要用户明确授权。
+ *
+ * @param scopes - 原始权限列表
+ * @returns 过滤后的权限列表（不包含高敏感权限）
+ *
+ * @example
+ * ```typescript
+ * const allScopes = ["im:message", "im:message:send_as_user", "calendar:calendar:read"];
+ * const safeScopes = filterSensitiveScopes(allScopes);
+ * // 返回: ["im:message", "calendar:calendar:read"]
+ * ```
+ */
+export function filterSensitiveScopes(scopes) {
+    const sensitiveSet = new Set(SENSITIVE_SCOPES);
+    return scopes.filter((scope) => !sensitiveSet.has(scope));
+}
+// ===== 统计信息 =====
+/**
+ * 工具动作总数: 98
+ * 唯一 scope 总数: 66
+ * 必需应用权限总数: 20
+ * 高敏感权限总数: 1
+ */
+//# sourceMappingURL=tool-scopes.js.map

package/src/core/tool-scopes.js.map

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

package/src/core/tools-config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Default values and resolution logic for the Feishu tools configuration.
+ *
+ * Each boolean flag controls whether a particular category of Feishu-specific
+ * agent tools (document access, wiki queries, drive operations, etc.) is
+ * enabled for a given account.
+ */
+import type { FeishuToolsConfig, LarkAccount } from './types';
+/**
+ * The default tools configuration.
+ *
+ * By default every non-destructive capability is enabled.  The `perm` flag
+ * (permission management) defaults to `false` because granting / revoking
+ * permissions is a privileged operation that admins should opt into
+ * explicitly.
+ */
+export declare const DEFAULT_TOOLS_CONFIG: Required<FeishuToolsConfig>;
+/**
+ * Merge a partial tools configuration with `DEFAULT_TOOLS_CONFIG`.
+ *
+ * Fields present in the input take precedence; anything absent falls back
+ * to the default value.
+ */
+export declare function resolveToolsConfig(cfg?: FeishuToolsConfig): Required<FeishuToolsConfig>;
+/**
+ * 合并多个账户的工具配置（取并集）。
+ *
+ * 工具注册是全局的（启动时注册一次），只要任意一个账户启用了某工具，
+ * 该工具就应被注册。执行时由 LarkTicket 路由到具体账户。
+ */
+export declare function resolveAnyEnabledToolsConfig(accounts: LarkAccount[]): Required<FeishuToolsConfig>;
+//# sourceMappingURL=tools-config.d.ts.map

package/src/core/tools-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-config.d.ts","sourceRoot":"","sources":["../../../src/core/tools-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAM9D;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,iBAAiB,CAS5D,CAAC;AAMF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,iBAAiB,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAavF;AAMD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAuBjG"}

package/src/core/tools-config.js

@@ -0,0 +1,88 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Default values and resolution logic for the Feishu tools configuration.
+ *
+ * Each boolean flag controls whether a particular category of Feishu-specific
+ * agent tools (document access, wiki queries, drive operations, etc.) is
+ * enabled for a given account.
+ */
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+/**
+ * The default tools configuration.
+ *
+ * By default every non-destructive capability is enabled.  The `perm` flag
+ * (permission management) defaults to `false` because granting / revoking
+ * permissions is a privileged operation that admins should opt into
+ * explicitly.
+ */
+export const DEFAULT_TOOLS_CONFIG = {
+    doc: true,
+    wiki: true,
+    drive: true,
+    scopes: true,
+    perm: false,
+    mail: true,
+    sheets: true,
+    okr: false,
+};
+// ---------------------------------------------------------------------------
+// Resolver
+// ---------------------------------------------------------------------------
+/**
+ * Merge a partial tools configuration with `DEFAULT_TOOLS_CONFIG`.
+ *
+ * Fields present in the input take precedence; anything absent falls back
+ * to the default value.
+ */
+export function resolveToolsConfig(cfg) {
+    if (!cfg)
+        return { ...DEFAULT_TOOLS_CONFIG };
+    return {
+        doc: cfg.doc ?? DEFAULT_TOOLS_CONFIG.doc,
+        wiki: cfg.wiki ?? DEFAULT_TOOLS_CONFIG.wiki,
+        drive: cfg.drive ?? DEFAULT_TOOLS_CONFIG.drive,
+        perm: cfg.perm ?? DEFAULT_TOOLS_CONFIG.perm,
+        scopes: cfg.scopes ?? DEFAULT_TOOLS_CONFIG.scopes,
+        mail: cfg.mail ?? DEFAULT_TOOLS_CONFIG.mail,
+        sheets: cfg.sheets ?? DEFAULT_TOOLS_CONFIG.sheets,
+        okr: cfg.okr ?? DEFAULT_TOOLS_CONFIG.okr,
+    };
+}
+// ---------------------------------------------------------------------------
+// Multi-account aggregation
+// ---------------------------------------------------------------------------
+/**
+ * 合并多个账户的工具配置（取并集）。
+ *
+ * 工具注册是全局的（启动时注册一次），只要任意一个账户启用了某工具，
+ * 该工具就应被注册。执行时由 LarkTicket 路由到具体账户。
+ */
+export function resolveAnyEnabledToolsConfig(accounts) {
+    const merged = {
+        doc: false,
+        wiki: false,
+        drive: false,
+        perm: false,
+        scopes: false,
+        mail: false,
+        sheets: false,
+        okr: false,
+    };
+    for (const account of accounts) {
+        const cfg = resolveToolsConfig(account.config.tools);
+        merged.doc = merged.doc || cfg.doc;
+        merged.wiki = merged.wiki || cfg.wiki;
+        merged.drive = merged.drive || cfg.drive;
+        merged.perm = merged.perm || cfg.perm;
+        merged.scopes = merged.scopes || cfg.scopes;
+        merged.mail = merged.mail || cfg.mail;
+        merged.sheets = merged.sheets || cfg.sheets;
+        merged.okr = merged.okr || cfg.okr;
+    }
+    return merged;
+}
+//# sourceMappingURL=tools-config.js.map

package/src/core/tools-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-config.js","sourceRoot":"","sources":["../../../src/core/tools-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgC;IAC/D,GAAG,EAAE,IAAI;IACT,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,KAAK;CACX,CAAC;AAEF,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAuB;IACxD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAE7C,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,oBAAoB,CAAC,GAAG;QACxC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,oBAAoB,CAAC,IAAI;QAC3C,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,oBAAoB,CAAC,KAAK;QAC9C,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,oBAAoB,CAAC,IAAI;QAC3C,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,oBAAoB,CAAC,MAAM;QACjD,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,oBAAoB,CAAC,IAAI;QAC3C,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,oBAAoB,CAAC,MAAM;QACjD,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,oBAAoB,CAAC,GAAG;KACzC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAuB;IAClE,MAAM,MAAM,GAAgC;QAC1C,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,KAAK;KACX,CAAC;IACF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,kBAAkB,CAAE,OAAO,CAAC,MAAwC,CAAC,KAAK,CAAC,CAAC;QACxF,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC;QACnC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;QACtC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC;QACzC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;QACtC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;QAC5C,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;QACtC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;QAC5C,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC;IACrC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}