@larksuite/openclaw-lark 2026.4.8 → 2026.4.9-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larksuite/openclaw-lark",
-  "version": "2026.4.8",
+  "version": "2026.4.9-beta.0",
   "description": "OpenClaw Lark/Feishu channel plugin",
   "exports": {
     ".": {
@@ -26,6 +26,7 @@
     "@larksuiteoapi/node-sdk": "^1.60.0",
     "@sinclair/typebox": "0.34.48",
     "image-size": "^2.0.2",
+    "undici-types": "^8.1.0",
     "zod": "^4.3.6"
   },
   "peerDependencies": {

package/skills/feishu-task/SKILL.md

@@ -8,7 +8,7 @@ description: |
   (2) 需要创建、管理任务清单
   (3) 需要查看任务列表或清单内的任务
   (4) 用户提到"任务"、"待办"、"to-do"、"清单"、"task"
-  (5) 需要设置任务负责人、关注人、截止时间
+  (5) 需要设置任务负责人、关注人、截止时间、添加成员
 ---
 
 # 飞书任务管理
@@ -16,6 +16,7 @@ description: |
 ## 🚨 执行前必读
 
 - ✅ **时间格式**：ISO 8601 / RFC 3339（带时区），例如 `2026-02-28T17:00:00+08:00`
+- ✅ **身份授权**：工具支持 `auth_type` 为 `user`（默认，用户身份）或 `tenant`（应用身份）。
 - ✅ **current_user_id 强烈建议**：从消息上下文的 SenderId 获取（ou_...），工具会自动添加为 follower（如不在 members 中），确保创建者可以编辑任务
 - ✅ **patch/get 必须**：task_guid
 - ✅ **tasklist.tasks 必须**：tasklist_guid
@@ -28,12 +29,13 @@ description: |
 
 | 用户意图 | 工具 | action | 必填参数 | 强烈建议 | 常用可选 |
 |---------|------|--------|---------|---------|---------|
-| 新建待办 | feishu_task_task | create | summary | current_user_id（SenderId） | members, due, description |
-| 查未完成任务 | feishu_task_task | list | - | completed=false | page_size |
-| 获取任务详情 | feishu_task_task | get | task_guid | - | - |
-| 完成任务 | feishu_task_task | patch | task_guid, completed_at | - | - |
-| 反完成任务 | feishu_task_task | patch | task_guid, completed_at="0" | - | - |
-| 改截止时间 | feishu_task_task | patch | task_guid, due | - | - |
+| 新建待办 | feishu_task_task | create | summary | current_user_id（SenderId） | members, due, description, auth_type |
+| 查未完成任务 | feishu_task_task | list | - | completed=false | page_size, auth_type |
+| 获取任务详情 | feishu_task_task | get | task_guid | - | auth_type |
+| 完成任务 | feishu_task_task | patch | task_guid, completed_at | - | auth_type |
+| 反完成任务 | feishu_task_task | patch | task_guid, completed_at="0" | - | auth_type |
+| 改截止时间 | feishu_task_task | patch | task_guid, due | - | auth_type |
+| 添加任务成员 | feishu_task_task | add_members | task_guid, members[] | - | auth_type |
 | 创建清单 | feishu_task_tasklist | create | name | - | members |
 | 查看清单任务 | feishu_task_tasklist | tasks | tasklist_guid | - | completed |
 | 添加清单成员 | feishu_task_tasklist | add_members | tasklist_guid, members[] | - | - |
@@ -42,38 +44,39 @@ description: |
 
 ## 🎯 核心约束（Schema 未透露的知识）
 
-### 1. 当前工具使用用户身份（已内置保护）
+### 1. 授权身份与可见性 (auth_type)
 
-**工具使用 `user_access_token`（用户身份）**
-
-这意味着：
-- ✅ 创建任务时可以指定任意成员（包括只分配给别人）
-- ⚠️ 只能查看和编辑**自己是成员的任务**
-- ⚠️ **如果创建时没把自己加入成员，后续无法编辑该任务**
+**工具支持两种调用身份 `auth_type`**：
+- **`user` (默认)**：用户身份（user_access_token）。用于需要严格代表用户操作或查询用户私有任务的场景。
+  - ⚠️ 使用 `user` 身份时，只能查看和编辑**自己是成员的任务**。
+  - ⚠️ **如果创建时没把自己加入成员，后续无法编辑该任务**。
+- **`tenant`**：应用身份（tenant_access_token）。当用户身份不满足要求时，使用应用身份。如果创建的任务没有把用户加入成员，用户可能看不见。
 
 **自动保护机制**：
 - 传入 `current_user_id` 参数（从 SenderId 获取）
 - 如果 `members` 中不包含 `current_user_id`，工具会**自动添加为 follower**
-- 确保创建者始终可以编辑任务
-
-**推荐用法**：创建任务时始终传 `current_user_id`，工具会自动处理成员关系。
+- 确保创建者始终可以编辑和查看任务
 
-### 2. 任务成员的角色说明
+### 2. 任务成员的角色与类型
 
-- **assignee（负责人）**：负责完成任务，可以编辑任务
-- **follower（关注人）**：关注任务进展，接收通知
+- **角色 (role)**：
+  - **assignee（负责人）**：负责完成任务，可以编辑任务
+  - **follower（关注人）**：关注任务进展，接收通知
+- **类型 (type)**：
+  - **user（默认，用户）**：普通的飞书用户
+  - **app（应用/机器人）**：如果是把机器人自己或者其他应用加入任务，必须指定 `type: "app"`
 
 **添加成员示例**：
 ```json
 {
   "members": [
-    {"id": "ou_xxx", "role": "assignee"},  // 负责人
-    {"id": "ou_yyy", "role": "follower"}   // 关注人
+    {"id": "ou_xxx", "role": "assignee", "type": "user"},  // 负责人（用户）
+    {"id": "cli_yyy", "role": "follower", "type": "app"}   // 关注人（机器人/应用）
   ]
 }
 ```
 
-**说明**：`id` 使用用户的 `open_id`（从消息上下文的 SenderId 获取）
+**说明**：`id` 默认使用 `open_id`。
 
 ### 3. 任务清单角色冲突
 
@@ -133,12 +136,13 @@ description: |
   "summary": "准备周会材料",
   "description": "整理本周工作进展和下周计划",
   "current_user_id": "ou_发送者的open_id",
+  "auth_type": "tenant",
   "due": {
     "timestamp": "2026-02-28 17:00:00",
     "is_all_day": false
   },
   "members": [
-    {"id": "ou_协作者的open_id", "role": "assignee"}
+    {"id": "ou_协作者的open_id", "role": "assignee", "type": "user"}
   ]
 }
 ```
@@ -147,7 +151,7 @@ description: |
 - `summary` 是必填字段
 - `current_user_id` 强烈建议传入（从 SenderId 获取），工具会自动添加为 follower
 - `members` 可以只包含其他协作者，当前用户会被自动添加
-- 时间使用北京时间字符串格式
+- 时间使用带时区的 ISO 8601 格式
 
 ### 场景 2: 查询我负责的未完成任务
 
@@ -155,11 +159,25 @@ description: |
 {
   "action": "list",
   "completed": false,
-  "page_size": 20
+  "page_size": 20,
+  "auth_type": "user"
+}
+```
+
+### 场景 3: 为现有任务添加机器人或成员
+
+```json
+{
+  "action": "add_members",
+  "task_guid": "任务的guid",
+  "auth_type": "tenant",
+  "members": [
+    {"id": "cli_机器人的app_id", "role": "follower", "type": "app"}
+  ]
 }
 ```
 
-### 场景 3: 完成任务
+### 场景 4: 完成任务
 
 ```json
 {
@@ -169,7 +187,7 @@ description: |
 }
 ```
 
-### 场景 4: 反完成任务（恢复未完成状态）
+### 场景 5: 反完成任务（恢复未完成状态）
 
 ```json
 {
@@ -179,7 +197,7 @@ description: |
 }
 ```
 
-### 场景 5: 创建清单并添加协作者
+### 场景 6: 创建清单并添加协作者
 
 ```json
 {
@@ -192,7 +210,7 @@ description: |
 }
 ```
 
-### 场景 6: 查看清单内的未完成任务
+### 场景 7: 查看清单内的未完成任务
 
 ```json
 {
@@ -202,7 +220,7 @@ description: |
 }
 ```
 
-### 场景 7: 全天任务
+### 场景 8: 全天任务
 
 ```json
 {
@@ -222,10 +240,11 @@ description: |
 | 错误现象 | 根本原因 | 解决方案 |
 |---------|---------|---------|
 | **创建后无法编辑任务** | 创建时未将自己加入 members | 创建时至少将当前用户（SenderId）加为 assignee 或 follower |
-| **patch 失败提示 task_guid 缺失** | 未传 task_guid 参数 | patch/get 必须传 task_guid |
+| **patch 失败提示 task_guid 缺失** | 未传 task_guid 参数 | patch/get/add_members 必须传 task_guid |
 | **tasks 失败提示 tasklist_guid 缺失** | 未传 tasklist_guid 参数 | tasklist.tasks action 必须传 tasklist_guid |
 | **反完成失败** | completed_at 格式错误 | 使用 `"0"` 字符串，不是数字 0 |
 | **时间不对** | 使用了 Unix 时间戳 | 改用 ISO 8601 格式（带时区）：`2024-01-01T00:00:00+08:00` |
+| **添加机器人失败** | 未指定成员 type 为 app | 将机器人的 type 指定为 `"app"` |
 
 ---
 

package/src/core/raw-request.js

@@ -11,6 +11,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveDomainUrl = resolveDomainUrl;
 exports.rawLarkRequest = rawLarkRequest;
+const node_url_1 = require("node:url");
 const feishu_fetch_1 = require("./feishu-fetch.js");
 // ---------------------------------------------------------------------------
 // Domain URL resolution
@@ -23,6 +24,24 @@ function resolveDomainUrl(brand) {
     };
     return map[brand] ?? `https://${brand}`;
 }
+function isFormDataBody(body) {
+    return (typeof body === 'object' &&
+        body !== null &&
+        typeof body.append === 'function' &&
+        typeof body.entries === 'function');
+}
+function isBinaryBody(body) {
+    return body instanceof ArrayBuffer || ArrayBuffer.isView(body);
+}
+function buildRequestBody(body) {
+    if (typeof body === 'string' || body instanceof node_url_1.URLSearchParams || isFormDataBody(body) || isBinaryBody(body)) {
+        return { body: body };
+    }
+    return {
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    };
+}
 /**
  * 发起 raw HTTP 请求到飞书 API，自动处理域名解析、header 注入和错误检测。
  *
@@ -37,11 +56,16 @@ async function rawLarkRequest(options) {
         }
     }
     const headers = {};
+    let requestBody;
     if (options.accessToken) {
         headers['Authorization'] = `Bearer ${options.accessToken}`;
     }
     if (options.body !== undefined) {
-        headers['Content-Type'] = 'application/json';
+        const prepared = buildRequestBody(options.body);
+        requestBody = prepared.body;
+        if (prepared.headers) {
+            Object.assign(headers, prepared.headers);
+        }
     }
     if (options.headers) {
         Object.assign(headers, options.headers);
@@ -49,7 +73,7 @@ async function rawLarkRequest(options) {
     const resp = await (0, feishu_fetch_1.feishuFetch)(url.toString(), {
         method: options.method ?? 'GET',
         headers,
-        ...(options.body !== undefined ? { body: JSON.stringify(options.body) } : {}),
+        ...(requestBody !== undefined ? { body: requestBody } : {}),
     });
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const data = (await resp.json());

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

@@ -53,7 +53,7 @@
  *
  * 总计：96 个工具动作
  */
-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.create' | '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.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.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.list_replies' | 'feishu_doc_comments.patch' | 'feishu_doc_comments.reply' | '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.basic_batch' | '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_section.create' | 'feishu_task_section.get' | 'feishu_task_section.list' | 'feishu_task_section.patch' | 'feishu_task_section.tasks' | '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.get' | 'feishu_task_tasklist.list' | 'feishu_task_tasklist.patch' | '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';
+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.create' | '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.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.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.list_replies' | 'feishu_doc_comments.patch' | 'feishu_doc_comments.reply' | '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.basic_batch' | '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_attachment.upload' | 'feishu_task_comment.create' | 'feishu_task_comment.get' | 'feishu_task_comment.list' | 'feishu_task_section.create' | 'feishu_task_section.get' | 'feishu_task_section.list' | 'feishu_task_section.patch' | 'feishu_task_section.tasks' | '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_task.add_members' | 'feishu_task_task.append_steps' | 'feishu_task_tasklist.add_members' | 'feishu_task_tasklist.create' | 'feishu_task_tasklist.get' | 'feishu_task_tasklist.list' | 'feishu_task_tasklist.patch' | 'feishu_task_tasklist.tasks' | 'feishu_task_agent.register' | 'feishu_task_agent.update_profile' | '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 映射类型
  *
@@ -153,4 +153,4 @@ export declare function filterSensitiveScopes(scopes: string[]): string[];
  * 唯一 scope 总数: 74
  * 必需应用权限总数: 20
  * 高敏感权限总数: 4
- */
+ */ 

package/src/core/tool-scopes.js

@@ -107,10 +107,13 @@ exports.TOOL_SCOPES = {
     'feishu_calendar_event_attendee.create': ['calendar:calendar.event:update'],
     'feishu_calendar_event_attendee.list': ['calendar:calendar.event:read'],
     'feishu_calendar_freebusy.list': ['calendar:calendar.free_busy:read'],
+    'feishu_task_attachment.upload': ['task:attachment:write'],
     '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_task.add_members': ['task:task:write', 'task:task:writeonly'],
+    'feishu_task_task.append_steps': ['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'],
@@ -127,6 +130,8 @@ exports.TOOL_SCOPES = {
     'feishu_task_section.tasks': ['task:task'],
     'feishu_task_subtask.create': ['task:task:write'],
     'feishu_task_subtask.list': ['task:task:read', 'task:task:write'],
+    'feishu_task_agent.register': ['task:task:write'],
+    'feishu_task_agent.update_profile': ['task:task:write', 'task:task:writeonly'],
     'feishu_chat.search': ['im:chat:read'],
     'feishu_chat.get': ['im:chat:read'],
     'feishu_chat_members.default': ['im:chat.members:read'],
@@ -336,4 +341,4 @@ function filterSensitiveScopes(scopes) {
  * 唯一 scope 总数: 74
  * 必需应用权限总数: 20
  * 高敏感权限总数: 4
- */
+ */ 

package/src/tools/oapi/index.js

@@ -39,9 +39,11 @@ function registerOapiTools(api) {
     // Task tools
     (0, index_3.registerFeishuTaskTaskTool)(api);
     (0, index_3.registerFeishuTaskTasklistTool)(api);
+    (0, index_3.registerFeishuTaskAttachmentTool)(api);
     (0, index_3.registerFeishuTaskSectionTool)(api);
     (0, index_3.registerFeishuTaskCommentTool)(api);
     (0, index_3.registerFeishuTaskSubtaskTool)(api);
+    (0, index_3.registerFeishuTaskAgentTool)(api);
     // Bitable tools
     (0, index_4.registerFeishuBitableAppTool)(api);
     (0, index_4.registerFeishuBitableAppTableTool)(api);

package/src/tools/oapi/task/attachment.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_task_attachment tool -- Manage task attachments.
+ *
+ * Actions:
+ * - upload: Upload task attachment (tenant identity)
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export interface FeishuTaskAttachmentParams {
+    action: 'upload';
+    resource_type?: 'task' | 'task_delivery';
+    resource_id: string;
+    file: string;
+    name?: string;
+}
+export declare function registerFeishuTaskAttachmentTool(api: OpenClawPluginApi): void;

package/src/tools/oapi/task/attachment.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_task_attachment tool -- Manage task attachments.
+ *
+ * Actions:
+ * - upload: Upload task attachment (tenant identity)
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFeishuTaskAttachmentTool = registerFeishuTaskAttachmentTool;
+const typebox_1 = require("@sinclair/typebox");
+const helpers_1 = require("../helpers.js");
+const raw_request_1 = require("../../../core/raw-request.js");
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const FeishuTaskAttachmentSchema = typebox_1.Type.Union([
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('upload'),
+        resource_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['task', 'task_delivery'], {
+            description: '资源类型，可选值：task、task_delivery。默认 task。',
+            default: 'task',
+        })),
+        resource_id: typebox_1.Type.String({
+            description: '资源 ID。',
+        }),
+        file: typebox_1.Type.String({
+            description: '文件内容base64编码字符串',
+        }),
+        name: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: '文件名。',
+        })),
+    }),
+]);
+;
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function resolvePathForAction(action) {
+    if (action === 'upload') {
+        return { path: '/open-apis/task/v2/attachments/upload', env: [] };
+    }
+    return { path: '/open-apis/task/v2/attachments/upload', env: [] };
+}
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+function registerFeishuTaskAttachmentTool(api) {
+    if (!api.config)
+        return;
+    const cfg = api.config;
+    const { toolClient } = (0, helpers_1.createToolContext)(api, 'feishu_task_attachment');
+    (0, helpers_1.registerTool)(api, {
+        name: 'feishu_task_attachment',
+        label: 'Feishu Task Attachment',
+        description: '飞书任务附件工具。当前提供 upload action，用于上传任务附件。',
+        parameters: FeishuTaskAttachmentSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const resolved = resolvePathForAction(p.action);
+                const client = toolClient();
+                const resourceType = p.resource_type ?? 'task';
+                const formData = new FormData();
+                formData.append('resource_type', resourceType);
+                formData.append('resource_id', p.resource_id);
+                // 将 base64 字符串解码为二进制文件
+                const fileBuffer = Buffer.from(p.file, 'base64');
+                // 创建 File 对象并添加到 FormData
+                const file = new File([fileBuffer], p.name ?? 'attachment');
+                formData.append('file', file);
+                const as = 'tenant';
+                const tatRes = await (0, raw_request_1.rawLarkRequest)({
+                    brand: client.account.brand,
+                    path: '/open-apis/auth/v3/tenant_access_token/internal/',
+                    method: 'POST',
+                    body: {
+                        app_id: client.account.appId,
+                        app_secret: client.account.appSecret,
+                    },
+                });
+                const token = tatRes?.tenant_access_token;
+                if (!token) {
+                    return (0, helpers_1.json)({
+                        error: 'Failed to get tenant_access_token.',
+                        response: tatRes,
+                    });
+                }
+                const res = await client.invokeByPath('feishu_task_attachment.upload', resolved.path, {
+                    method: 'POST',
+                    as,
+                    body: formData,
+                    headers: {
+                        'Authorization': `Bearer ${token}`,
+                    },
+                });
+                return (0, helpers_1.json)(res);
+            }
+            catch (err) {
+                return await (0, helpers_1.handleInvokeErrorWithAutoAuth)(err, cfg);
+            }
+        },
+    }, { name: 'feishu_task_attachment' });
+}

package/src/tools/oapi/task/comment.d.ts

@@ -4,7 +4,7 @@
  *
  * feishu_task_comment tool -- Manage Feishu task comments.
  *
- * P1 Actions: create, list, get
+ * P1 Actions: create, list, get 支持通过 auth_type 参数切换用户(user)或应用(tenant)身份。
  *
  * Uses the Feishu Task v2 API:
  *   - create: POST /open-apis/task/v2/tasks/:task_guid/comments

package/src/tools/oapi/task/comment.js

@@ -5,7 +5,7 @@
  *
  * feishu_task_comment tool -- Manage Feishu task comments.
  *
- * P1 Actions: create, list, get
+ * P1 Actions: create, list, get 支持通过 auth_type 参数切换用户(user)或应用(tenant)身份。
  *
  * Uses the Feishu Task v2 API:
  *   - create: POST /open-apis/task/v2/tasks/:task_guid/comments
@@ -19,10 +19,14 @@ const helpers_1 = require("../helpers.js");
 // ---------------------------------------------------------------------------
 // Schema
 // ---------------------------------------------------------------------------
+const FeishuTaskCommentAuthType = typebox_1.Type.Optional((0, helpers_1.StringEnum)(['tenant', 'user'], {
+    description: '调用 API 时使用的 Token 类型。可选值："tenant"（应用身份） 或 "user"（用户身份）。默认使用 "user"。',
+}));
 const FeishuTaskCommentSchema = typebox_1.Type.Union([
     // CREATE (P1)
     typebox_1.Type.Object({
         action: typebox_1.Type.Literal('create'),
+        auth_type: FeishuTaskCommentAuthType,
         task_guid: typebox_1.Type.String({ description: '任务 GUID' }),
         content: typebox_1.Type.String({ description: '评论内容（纯文本，最长 3000 字符）' }),
         reply_to_comment_id: typebox_1.Type.Optional(typebox_1.Type.String({ description: '要回复的评论 ID（用于回复评论）' })),
@@ -30,6 +34,7 @@ const FeishuTaskCommentSchema = typebox_1.Type.Union([
     // LIST (P1)
     typebox_1.Type.Object({
         action: typebox_1.Type.Literal('list'),
+        auth_type: FeishuTaskCommentAuthType,
         resource_id: typebox_1.Type.String({ description: '要获取评论的资源 ID（任务 GUID）' }),
         direction: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['asc', 'desc'], {
             description: '排序方式（asc=从旧到新，desc=从新到旧，默认 asc）',
@@ -40,6 +45,7 @@ const FeishuTaskCommentSchema = typebox_1.Type.Union([
     // GET (P1)
     typebox_1.Type.Object({
         action: typebox_1.Type.Literal('get'),
+        auth_type: FeishuTaskCommentAuthType,
         comment_id: typebox_1.Type.String({ description: '评论 ID' }),
     }),
 ]);
@@ -54,7 +60,7 @@ function registerFeishuTaskCommentTool(api) {
     (0, helpers_1.registerTool)(api, {
         name: 'feishu_task_comment',
         label: 'Feishu Task Comments',
-        description: '【以用户身份】飞书任务评论管理工具。当用户要求添加/查询任务评论、回复评论时使用。Actions: create（添加评论）, list（列出任务的所有评论）, get（获取单个评论详情）。',
+        description: '【以用户或应用身份】飞书任务评论管理工具。当用户要求添加/查询任务评论、回复评论时使用。Actions: create（添加评论）, list（列出任务的所有评论）, get（获取单个评论详情）。',
         parameters: FeishuTaskCommentSchema,
         async execute(_toolCallId, params) {
             const p = params;
@@ -81,7 +87,7 @@ function registerFeishuTaskCommentTool(api) {
                                 user_id_type: 'open_id',
                             },
                             data,
-                        }, opts), { as: 'user' });
+                        }, opts), { as: p.auth_type || 'user' });
                         (0, helpers_1.assertLarkOk)(res);
                         log.info(`create: created comment ${res.data?.comment?.id}`);
                         return (0, helpers_1.json)({
@@ -103,7 +109,7 @@ function registerFeishuTaskCommentTool(api) {
                                 // eslint-disable-next-line @typescript-eslint/no-explicit-any
                                 user_id_type: 'open_id',
                             },
-                        }, opts), { as: 'user' });
+                        }, opts), { as: p.auth_type || 'user' });
                         (0, helpers_1.assertLarkOk)(res);
                         const data = res.data;
                         log.info(`list: returned ${data?.items?.length ?? 0} comments`);
@@ -126,7 +132,7 @@ function registerFeishuTaskCommentTool(api) {
                                 // eslint-disable-next-line @typescript-eslint/no-explicit-any
                                 user_id_type: 'open_id',
                             },
-                        }, opts), { as: 'user' });
+                        }, opts), { as: p.auth_type || 'user' });
                         (0, helpers_1.assertLarkOk)(res);
                         log.info(`get: returned comment ${p.comment_id}`);
                         return (0, helpers_1.json)({

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

@@ -4,6 +4,8 @@
  */
 export { registerFeishuTaskTaskTool } from './task';
 export { registerFeishuTaskTasklistTool } from './tasklist';
+export { registerFeishuTaskAttachmentTool } from './attachment';
 export { registerFeishuTaskCommentTool } from './comment';
 export { registerFeishuTaskSubtaskTool } from './subtask';
 export { registerFeishuTaskSectionTool } from './section';
+export { registerFeishuTaskAgentTool } from './task_agent';

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

@@ -4,14 +4,18 @@
  * SPDX-License-Identifier: MIT
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerFeishuTaskSectionTool = exports.registerFeishuTaskSubtaskTool = exports.registerFeishuTaskCommentTool = exports.registerFeishuTaskTasklistTool = exports.registerFeishuTaskTaskTool = void 0;
+exports.registerFeishuTaskAgentTool = exports.registerFeishuTaskSectionTool = exports.registerFeishuTaskSubtaskTool = exports.registerFeishuTaskCommentTool = exports.registerFeishuTaskAttachmentTool = exports.registerFeishuTaskTasklistTool = exports.registerFeishuTaskTaskTool = void 0;
 var task_1 = require("./task.js");
 Object.defineProperty(exports, "registerFeishuTaskTaskTool", { enumerable: true, get: function () { return task_1.registerFeishuTaskTaskTool; } });
 var tasklist_1 = require("./tasklist.js");
 Object.defineProperty(exports, "registerFeishuTaskTasklistTool", { enumerable: true, get: function () { return tasklist_1.registerFeishuTaskTasklistTool; } });
+var attachment_1 = require("./attachment.js");
+Object.defineProperty(exports, "registerFeishuTaskAttachmentTool", { enumerable: true, get: function () { return attachment_1.registerFeishuTaskAttachmentTool; } });
 var comment_1 = require("./comment.js");
 Object.defineProperty(exports, "registerFeishuTaskCommentTool", { enumerable: true, get: function () { return comment_1.registerFeishuTaskCommentTool; } });
 var subtask_1 = require("./subtask.js");
 Object.defineProperty(exports, "registerFeishuTaskSubtaskTool", { enumerable: true, get: function () { return subtask_1.registerFeishuTaskSubtaskTool; } });
 var section_1 = require("./section.js");
 Object.defineProperty(exports, "registerFeishuTaskSectionTool", { enumerable: true, get: function () { return section_1.registerFeishuTaskSectionTool; } });
+var task_agent_1 = require("./task_agent.js");
+Object.defineProperty(exports, "registerFeishuTaskAgentTool", { enumerable: true, get: function () { return task_agent_1.registerFeishuTaskAgentTool; } });

package/src/tools/oapi/task/section.d.ts

@@ -4,7 +4,7 @@
  *
  * feishu_task_section tool -- Manage Feishu task sections.
  *
- * P0 Actions: create, get, list, patch, tasks
+ * P0 Actions: create, get, list, patch, tasks 支持通过 auth_type 参数切换用户(user)或应用(tenant)身份。
  *
  * Uses the Feishu Task v2 API:
  *   - create: POST /open-apis/task/v2/sections