@larksuite/openclaw-lark 2025.7.15-beta.0

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

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_task_comment tool -- Manage Feishu task comments.
+ *
+ * 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
+ *   - list:   GET  /open-apis/task/v2/tasks/:task_guid/comments
+ *   - get:    GET  /open-apis/task/v2/comments/:comment_id
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuTaskCommentTool(api: OpenClawPluginApi): void;

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

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_task_comment tool -- Manage Feishu task comments.
+ *
+ * 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
+ *   - list:   GET  /open-apis/task/v2/tasks/:task_guid/comments
+ *   - get:    GET  /open-apis/task/v2/comments/:comment_id
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFeishuTaskCommentTool = registerFeishuTaskCommentTool;
+const typebox_1 = require("@sinclair/typebox");
+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（用于回复评论）' })),
+    }),
+    // 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）',
+        })),
+        page_size: typebox_1.Type.Optional(typebox_1.Type.Number({ description: '每页数量，默认 50，最大 100' })),
+        page_token: typebox_1.Type.Optional(typebox_1.Type.String({ description: '分页标记' })),
+    }),
+    // GET (P1)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('get'),
+        auth_type: FeishuTaskCommentAuthType,
+        comment_id: typebox_1.Type.String({ description: '评论 ID' }),
+    }),
+]);
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+function registerFeishuTaskCommentTool(api) {
+    if (!api.config)
+        return;
+    const cfg = api.config;
+    const { toolClient, log } = (0, helpers_1.createToolContext)(api, 'feishu_task_comment');
+    (0, helpers_1.registerTool)(api, {
+        name: 'feishu_task_comment',
+        label: 'Feishu Task Comments',
+        description: '【以用户或应用身份】飞书任务评论管理工具。当用户要求添加/查询任务评论、回复评论时使用。Actions: create（添加评论）, list（列出任务的所有评论）, get（获取单个评论详情）。',
+        parameters: FeishuTaskCommentSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = toolClient();
+                switch (p.action) {
+                    // -----------------------------------------------------------------
+                    // CREATE
+                    // -----------------------------------------------------------------
+                    case 'create': {
+                        log.info(`create: task_guid=${p.task_guid}, reply_to=${p.reply_to_comment_id ?? 'none'}`);
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const data = {
+                            content: p.content,
+                            resource_type: 'task',
+                            resource_id: p.task_guid,
+                        };
+                        if (p.reply_to_comment_id) {
+                            data.reply_to_comment_id = p.reply_to_comment_id;
+                        }
+                        const res = await client.invoke('feishu_task_comment.create', (sdk, opts) => sdk.task.v2.comment.create({
+                            params: {
+                                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                                user_id_type: 'open_id',
+                            },
+                            data,
+                        }, 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)({
+                            comment: res.data?.comment,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // LIST
+                    // -----------------------------------------------------------------
+                    case 'list': {
+                        log.info(`list: resource_id=${p.resource_id}, direction=${p.direction ?? 'asc'}, page_size=${p.page_size ?? 50}`);
+                        const res = await client.invoke('feishu_task_comment.list', (sdk, opts) => sdk.task.v2.comment.list({
+                            params: {
+                                resource_type: 'task',
+                                resource_id: p.resource_id,
+                                direction: p.direction,
+                                page_size: p.page_size,
+                                page_token: p.page_token,
+                                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                                user_id_type: 'open_id',
+                            },
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        const data = res.data;
+                        log.info(`list: returned ${data?.items?.length ?? 0} comments`);
+                        return (0, helpers_1.json)({
+                            comments: data?.items,
+                            has_more: data?.has_more ?? false,
+                            page_token: data?.page_token,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // GET
+                    // -----------------------------------------------------------------
+                    case 'get': {
+                        log.info(`get: comment_id=${p.comment_id}`);
+                        const res = await client.invoke('feishu_task_comment.get', (sdk, opts) => sdk.task.v2.comment.get({
+                            path: {
+                                comment_id: p.comment_id,
+                            },
+                            params: {
+                                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                                user_id_type: 'open_id',
+                            },
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`get: returned comment ${p.comment_id}`);
+                        return (0, helpers_1.json)({
+                            comment: res.data?.comment,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                return await (0, helpers_1.handleInvokeErrorWithAutoAuth)(err, cfg);
+            }
+        },
+    }, { name: 'feishu_task_comment' });
+}

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

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+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

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+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

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_task_section tool -- Manage Feishu task sections.
+ *
+ * P0 Actions: create, get, list, patch, tasks 支持通过 auth_type 参数切换用户(user)或应用(tenant)身份。
+ *
+ * Uses the Feishu Task v2 API:
+ *   - create: POST /open-apis/task/v2/sections
+ *   - get:    GET  /open-apis/task/v2/sections/:section_guid
+ *   - patch:  PATCH /open-apis/task/v2/sections/:section_guid
+ *   - list:   GET  /open-apis/task/v2/sections
+ *   - tasks:  GET  /open-apis/task/v2/sections/:section_guid/tasks
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuTaskSectionTool(api: OpenClawPluginApi): void;

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

@@ -0,0 +1,293 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_task_section tool -- Manage Feishu task sections.
+ *
+ * P0 Actions: create, get, list, patch, tasks 支持通过 auth_type 参数切换用户(user)或应用(tenant)身份。
+ *
+ * Uses the Feishu Task v2 API:
+ *   - create: POST /open-apis/task/v2/sections
+ *   - get:    GET  /open-apis/task/v2/sections/:section_guid
+ *   - patch:  PATCH /open-apis/task/v2/sections/:section_guid
+ *   - list:   GET  /open-apis/task/v2/sections
+ *   - tasks:  GET  /open-apis/task/v2/sections/:section_guid/tasks
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFeishuTaskSectionTool = registerFeishuTaskSectionTool;
+const typebox_1 = require("@sinclair/typebox");
+const helpers_1 = require("../helpers.js");
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const FeishuTaskSectionAuthType = typebox_1.Type.Optional((0, helpers_1.StringEnum)(['tenant', 'user'], {
+    description: '调用 API 时使用的 Token 类型。可选值："tenant"（应用身份） 或 "user"（用户身份）。默认使用 "user"。',
+}));
+const FeishuTaskSectionSchema = typebox_1.Type.Union([
+    // CREATE
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('create'),
+        auth_type: FeishuTaskSectionAuthType,
+        name: typebox_1.Type.String({
+            description: '自定义分组名。不允许为空，最大100个utf8字符。',
+        }),
+        resource_type: (0, helpers_1.StringEnum)(['tasklist', 'my_tasks']),
+        resource_id: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: '自定义分组要归属的资源id。当resource_type为"tasklist"时这里需要填写清单的GUID；当resource_type为"my_tasks"时，无需填写。',
+        })),
+        insert_before: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: '要将新分组插入到自定义分分组的前面的目标分组的guid。',
+        })),
+        insert_after: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: '要将新分组插入到自定义分分组的后面的目标分组的guid。',
+        })),
+        user_id_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['open_id', 'union_id', 'user_id'])),
+    }),
+    // GET
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('get'),
+        auth_type: FeishuTaskSectionAuthType,
+        section_guid: typebox_1.Type.String({
+            description: '要获取的自定义分组GUID',
+        }),
+        user_id_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['open_id', 'union_id', 'user_id'])),
+    }),
+    // PATCH
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('patch'),
+        auth_type: FeishuTaskSectionAuthType,
+        section_guid: typebox_1.Type.String({
+            description: '要更新的自定义分组GUID',
+        }),
+        name: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: '自定义字段名字',
+        })),
+        insert_before: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: '要让当前自定义分组放到某个自定义分组前面的secion_guid，用于改变当前自定义分组的位置。',
+        })),
+        insert_after: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: '要让当前自定义分组放到某个自定义分组后面的secion_guid，用于改变当前自定义分组的位置。',
+        })),
+        user_id_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['open_id', 'union_id', 'user_id'])),
+    }),
+    // LIST
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('list'),
+        auth_type: FeishuTaskSectionAuthType,
+        resource_type: (0, helpers_1.StringEnum)(['tasklist', 'my_tasks']),
+        resource_id: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: '如resource_type为"tasklist"，这里需要填写要列取自定义分组的清单的GUID。',
+        })),
+        page_size: typebox_1.Type.Optional(typebox_1.Type.Number({
+            description: '分页大小',
+        })),
+        page_token: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: '分页标记',
+        })),
+        user_id_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['open_id', 'union_id', 'user_id'])),
+    }),
+    // TASKS
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('tasks'),
+        auth_type: FeishuTaskSectionAuthType,
+        section_guid: typebox_1.Type.String({
+            description: '要获取任务的自定义分组全局唯一ID',
+        }),
+        page_size: typebox_1.Type.Optional(typebox_1.Type.Number({
+            description: '分页大小',
+        })),
+        page_token: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: '分页标记',
+        })),
+        completed: typebox_1.Type.Optional(typebox_1.Type.Boolean({
+            description: '按照任务状态过滤，如果不填写则表示不按完成状态过滤',
+        })),
+        created_from: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: '按照创建时间筛选的起始时间（支持 ISO 8601 或毫秒时间戳）',
+        })),
+        created_to: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: '按照创建时间筛选的结束时间（支持 ISO 8601 或毫秒时间戳）',
+        })),
+        user_id_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['open_id', 'union_id', 'user_id'])),
+    }),
+]);
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+function registerFeishuTaskSectionTool(api) {
+    if (!api.config)
+        return;
+    const cfg = api.config;
+    const { toolClient, log } = (0, helpers_1.createToolContext)(api, 'feishu_task_section');
+    (0, helpers_1.registerTool)(api, {
+        name: 'feishu_task_section',
+        label: 'Feishu Task Section Management',
+        description: '【以用户或应用身份】飞书任务自定义分组管理工具。用于创建、查询、更新自定义分组，以及列出分组内的任务。Actions: create（创建分组）, get（获取分组详情）, patch（更新分组）, list（获取分组列表）, tasks（获取分组任务列表）。',
+        parameters: FeishuTaskSectionSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = toolClient();
+                switch (p.action) {
+                    // -----------------------------------------------------------------
+                    // CREATE SECTION
+                    // -----------------------------------------------------------------
+                    case 'create': {
+                        log.info(`create: name=${p.name}, resource_type=${p.resource_type}`);
+                        const data = {
+                            name: p.name,
+                            resource_type: p.resource_type,
+                        };
+                        if (p.resource_id)
+                            data.resource_id = p.resource_id;
+                        if (p.insert_before)
+                            data.insert_before = p.insert_before;
+                        if (p.insert_after)
+                            data.insert_after = p.insert_after;
+                        const res = await client.invoke('feishu_task_section.create', (sdk, opts) => sdk.task.v2.section.create({
+                            data,
+                            params: {
+                                user_id_type: (p.user_id_type || 'open_id'),
+                            },
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`create: section created: section_guid=${res.data?.section?.guid}`);
+                        return (0, helpers_1.json)({
+                            section: res.data?.section,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // GET SECTION
+                    // -----------------------------------------------------------------
+                    case 'get': {
+                        log.info(`get: section_guid=${p.section_guid}`);
+                        const res = await client.invoke('feishu_task_section.get', (sdk, opts) => sdk.task.v2.section.get({
+                            path: { section_guid: p.section_guid },
+                            params: {
+                                user_id_type: (p.user_id_type || 'open_id'),
+                            },
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`get: retrieved section ${p.section_guid}`);
+                        return (0, helpers_1.json)({
+                            section: res.data?.section,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // PATCH SECTION
+                    // -----------------------------------------------------------------
+                    case 'patch': {
+                        log.info(`patch: section_guid=${p.section_guid}`);
+                        const sectionData = {};
+                        const updateFields = [];
+                        if (p.name !== undefined) {
+                            sectionData.name = p.name;
+                            updateFields.push('name');
+                        }
+                        if (p.insert_before !== undefined) {
+                            sectionData.insert_before = p.insert_before;
+                            updateFields.push('insert_before');
+                        }
+                        if (p.insert_after !== undefined) {
+                            sectionData.insert_after = p.insert_after;
+                            updateFields.push('insert_after');
+                        }
+                        if (updateFields.length === 0) {
+                            return (0, helpers_1.json)({
+                                error: 'No fields to update',
+                            });
+                        }
+                        const res = await client.invoke('feishu_task_section.patch', (sdk, opts) => sdk.task.v2.section.patch({
+                            path: { section_guid: p.section_guid },
+                            data: {
+                                section: sectionData,
+                                update_fields: updateFields,
+                            },
+                            params: {
+                                user_id_type: (p.user_id_type || 'open_id'),
+                            },
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`patch: section ${p.section_guid} updated`);
+                        return (0, helpers_1.json)({
+                            section: res.data?.section,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // LIST SECTIONS
+                    // -----------------------------------------------------------------
+                    case 'list': {
+                        log.info(`list: resource_type=${p.resource_type}, page_size=${p.page_size ?? 50}`);
+                        const paramsData = {
+                            resource_type: p.resource_type,
+                            user_id_type: (p.user_id_type || 'open_id'),
+                        };
+                        if (p.resource_id)
+                            paramsData.resource_id = p.resource_id;
+                        if (p.page_size !== undefined)
+                            paramsData.page_size = p.page_size;
+                        if (p.page_token !== undefined)
+                            paramsData.page_token = p.page_token;
+                        const res = await client.invoke('feishu_task_section.list', (sdk, opts) => sdk.task.v2.section.list({
+                            params: paramsData,
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        const data = res.data;
+                        log.info(`list: returned ${data?.items?.length ?? 0} sections`);
+                        return (0, helpers_1.json)({
+                            sections: data?.items,
+                            has_more: data?.has_more ?? false,
+                            page_token: data?.page_token,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // TASKS IN SECTION
+                    // -----------------------------------------------------------------
+                    case 'tasks': {
+                        log.info(`tasks: section_guid=${p.section_guid}`);
+                        const paramsData = {
+                            user_id_type: (p.user_id_type || 'open_id'),
+                        };
+                        if (p.page_size !== undefined)
+                            paramsData.page_size = p.page_size;
+                        if (p.page_token !== undefined)
+                            paramsData.page_token = p.page_token;
+                        if (p.completed !== undefined)
+                            paramsData.completed = p.completed;
+                        if (p.created_from) {
+                            const ts = (0, helpers_1.parseTimeToTimestampMs)(p.created_from);
+                            if (ts)
+                                paramsData.created_from = ts;
+                            else
+                                paramsData.created_from = p.created_from;
+                        }
+                        if (p.created_to) {
+                            const ts = (0, helpers_1.parseTimeToTimestampMs)(p.created_to);
+                            if (ts)
+                                paramsData.created_to = ts;
+                            else
+                                paramsData.created_to = p.created_to;
+                        }
+                        const res = await client.invoke('feishu_task_section.tasks', (sdk, opts) => sdk.task.v2.section.tasks({
+                            path: { section_guid: p.section_guid },
+                            params: paramsData,
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        const data = res.data;
+                        log.info(`tasks: returned ${data?.items?.length ?? 0} tasks`);
+                        return (0, helpers_1.json)({
+                            tasks: data?.items,
+                            has_more: data?.has_more ?? false,
+                            page_token: data?.page_token,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                return await (0, helpers_1.handleInvokeErrorWithAutoAuth)(err, cfg);
+            }
+        },
+    }, { name: 'feishu_task_section' });
+}

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

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_task_subtask tool -- Manage Feishu task subtasks.
+ *
+ * P1 Actions: create, list 支持通过 auth_type 参数切换用户(user)或应用(tenant)身份。
+ *
+ * Uses the Feishu Task v2 API:
+ *   - create: POST /open-apis/task/v2/tasks/:task_guid/subtasks
+ *   - list:   GET  /open-apis/task/v2/tasks/:task_guid/subtasks
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuTaskSubtaskTool(api: OpenClawPluginApi): void;