@larksuite/openclaw-lark 2026.3.9

package/src/tools/oapi/drive/doc-media.js

@@ -0,0 +1,337 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_doc_media tool -- 文档媒体管理（插入 + 下载）
+ *
+ * Actions:
+ *   insert   - 在飞书文档末尾插入本地图片或文件（3 步流程）
+ *   download - 下载文档素材或画板缩略图到本地
+ *
+ * 使用以下 SDK 接口:
+ * - sdk.docx.documentBlockChildren.create - 创建子块
+ * - sdk.drive.v1.media.uploadAll - 上传素材
+ * - sdk.docx.documentBlock.batchUpdate - 批量更新块
+ * - sdk.drive.v1.media.download - 下载素材
+ * - sdk.board.v1.whiteboard.downloadAsImage - 下载画板缩略图
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { Type } from '@sinclair/typebox';
+import { json, createToolContext, assertLarkOk, handleInvokeErrorWithAutoAuth } from '../helpers';
+import { validateLocalMediaRoots } from '../../../messaging/outbound/media-url-utils';
+import * as fs from 'node:fs/promises';
+import { createReadStream } from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { imageSize } from 'image-size';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_FILE_SIZE = 20 * 1024 * 1024; // 20MB
+const ALIGN_MAP = {
+    left: 1,
+    center: 2,
+    right: 3,
+};
+/** 插入时的媒体类型配置 */
+const MEDIA_CONFIG = {
+    image: {
+        block_type: 27,
+        block_data: { image: {} },
+        parent_type: 'docx_image',
+        label: '图片',
+    },
+    file: {
+        block_type: 23,
+        block_data: { file: { token: '' } },
+        parent_type: 'docx_file',
+        label: '文件',
+    },
+};
+/** MIME type → 扩展名映射 */
+const MIME_TO_EXT = {
+    'image/png': '.png',
+    'image/jpeg': '.jpg',
+    'image/jpg': '.jpg',
+    'image/gif': '.gif',
+    'image/webp': '.webp',
+    'image/svg+xml': '.svg',
+    'image/bmp': '.bmp',
+    'image/tiff': '.tiff',
+    'video/mp4': '.mp4',
+    'video/mpeg': '.mpeg',
+    'video/quicktime': '.mov',
+    'video/x-msvideo': '.avi',
+    'video/webm': '.webm',
+    'application/pdf': '.pdf',
+    'application/msword': '.doc',
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document': '.docx',
+    'application/vnd.ms-excel': '.xls',
+    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': '.xlsx',
+    'application/vnd.ms-powerpoint': '.ppt',
+    'application/vnd.openxmlformats-officedocument.presentationml.presentation': '.pptx',
+    'application/zip': '.zip',
+    'application/x-rar-compressed': '.rar',
+    'text/plain': '.txt',
+    'application/json': '.json',
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * 从文档 URL 或纯 ID 中提取 document_id
+ */
+function extractDocumentId(input) {
+    const trimmed = input.trim();
+    const urlMatch = trimmed.match(/\/docx\/([A-Za-z0-9]+)/);
+    if (urlMatch)
+        return urlMatch[1];
+    return trimmed;
+}
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const DocMediaSchema = Type.Union([
+    // INSERT action
+    Type.Object({
+        action: Type.Literal('insert'),
+        doc_id: Type.String({
+            description: '文档 ID 或文档 URL（必填）。支持从 URL 自动提取 document_id',
+        }),
+        file_path: Type.String({
+            description: '本地文件的绝对路径（必填）。图片支持 jpg/png/gif/webp 等，文件支持任意格式，最大 20MB',
+        }),
+        type: Type.Optional(Type.Union([Type.Literal('image'), Type.Literal('file')], {
+            description: '媒体类型："image"（图片，默认）或 "file"（文件附件）',
+        })),
+        align: Type.Optional(Type.Union([Type.Literal('left'), Type.Literal('center'), Type.Literal('right')], {
+            description: '对齐方式（仅图片生效）："center"（默认居中）、"left"（居左）、"right"（居右）',
+        })),
+        caption: Type.Optional(Type.String({
+            description: '图片描述/标题（可选，仅图片生效）',
+        })),
+    }),
+    // DOWNLOAD action
+    Type.Object({
+        action: Type.Literal('download'),
+        resource_token: Type.String({
+            description: '资源的唯一标识（file_token 用于文档素材，whiteboard_id 用于画板）',
+        }),
+        resource_type: Type.Union([Type.Literal('media'), Type.Literal('whiteboard')], {
+            description: '资源类型：media（文档素材：图片、视频、文件等）或 whiteboard（画板缩略图）',
+        }),
+        output_path: Type.String({
+            description: '保存文件的完整本地路径。可以包含扩展名（如 /tmp/image.png），' +
+                '也可以不带扩展名，系统会根据 Content-Type 自动添加',
+        }),
+    }),
+]);
+// ---------------------------------------------------------------------------
+// Action handlers
+// ---------------------------------------------------------------------------
+async function handleInsert(p, client, log) {
+    const documentId = extractDocumentId(p.doc_id);
+    const mediaType = p.type ?? 'image';
+    const config = MEDIA_CONFIG[mediaType];
+    // 0. 路径白名单校验 — 仅允许 tmpdir 下的文件
+    const filePath = p.file_path;
+    const DOC_MEDIA_ALLOWED_ROOTS = [os.tmpdir()];
+    validateLocalMediaRoots(path.resolve(filePath), DOC_MEDIA_ALLOWED_ROOTS);
+    // 1. 读取并校验本地文件
+    let fileSize;
+    try {
+        const stat = await fs.stat(filePath);
+        fileSize = stat.size;
+    }
+    catch (err) {
+        return json({
+            error: `failed to read file: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    }
+    if (fileSize > MAX_FILE_SIZE) {
+        return json({
+            error: `file ${(fileSize / 1024 / 1024).toFixed(1)}MB exceeds 20MB limit`,
+        });
+    }
+    const fileName = path.basename(filePath);
+    log.info(`insert: doc=${documentId}, type=${mediaType}, file=${fileName}, size=${fileSize}`);
+    // 2. 创建空 Block（追加到文档末尾）
+    const createRes = await client.invoke('feishu_doc_media.insert', (sdk, opts) => sdk.docx.documentBlockChildren.create({
+        path: {
+            document_id: documentId,
+            block_id: documentId,
+        },
+        data: {
+            children: [{ block_type: config.block_type, ...config.block_data }],
+        },
+        params: { document_revision_id: -1 },
+    }, opts), { as: 'user' });
+    assertLarkOk(createRes);
+    // File Block 返回 View Block（block_type: 33）作为容器，
+    // 真正的 File Block ID 在 children[0].children[0]；
+    // Image Block 直接返回，block_id 在 children[0].block_id
+    let blockId;
+    if (mediaType === 'file') {
+        blockId = createRes.data?.children?.[0]?.children?.[0];
+    }
+    else {
+        blockId = createRes.data?.children?.[0]?.block_id;
+    }
+    if (!blockId) {
+        return json({
+            error: `failed to create ${config.label} block: no block_id returned`,
+        });
+    }
+    log.info(`insert: created ${mediaType} block ${blockId}`);
+    // 3. 上传素材
+    const uploadRes = await client.invoke('feishu_doc_media.insert', (sdk, opts) => sdk.drive.v1.media.uploadAll({
+        data: {
+            file_name: fileName,
+            parent_type: config.parent_type,
+            parent_node: blockId,
+            size: fileSize,
+            file: createReadStream(filePath),
+            extra: JSON.stringify({
+                drive_route_token: documentId,
+            }),
+        },
+    }, opts), { as: 'user' });
+    const fileToken = uploadRes?.file_token ?? uploadRes?.data?.file_token;
+    if (!fileToken) {
+        return json({
+            error: `failed to upload ${config.label} media: no file_token returned`,
+        });
+    }
+    log.info(`insert: uploaded media, file_token=${fileToken}`);
+    // 4. 批量更新 Block - 设置 token
+    const patchRequest = { block_id: blockId };
+    if (mediaType === 'image') {
+        const alignNum = ALIGN_MAP[p.align ?? 'center'];
+        // 自动检测图片尺寸
+        let width;
+        let height;
+        try {
+            const imgBuf = await fs.readFile(filePath);
+            const dims = imageSize(imgBuf);
+            if (dims.width && dims.height) {
+                width = dims.width;
+                height = dims.height;
+                log.info(`insert: detected image size ${width}x${height}`);
+            }
+        }
+        catch {
+            log.info('insert: could not detect image dimensions, skipping');
+        }
+        patchRequest.replace_image = {
+            token: fileToken,
+            align: alignNum,
+            ...(width != null ? { width } : {}),
+            ...(height != null ? { height } : {}),
+            ...(p.caption ? { caption: { content: p.caption } } : {}),
+        };
+    }
+    else {
+        patchRequest.replace_file = { token: fileToken };
+    }
+    const patchRes = await client.invoke('feishu_doc_media.insert', (sdk, opts) => sdk.docx.documentBlock.batchUpdate({
+        path: { document_id: documentId },
+        data: { requests: [patchRequest] },
+        params: { document_revision_id: -1 },
+    }, opts), { as: 'user' });
+    assertLarkOk(patchRes);
+    log.info(`insert: patched ${mediaType} block with file_token`);
+    return json({
+        success: true,
+        type: mediaType,
+        document_id: documentId,
+        block_id: blockId,
+        file_token: fileToken,
+        file_name: fileName,
+    });
+}
+async function handleDownload(p, client, log) {
+    log.info(`download: resource_type=${p.resource_type}, token="${p.resource_token}"`);
+    let res;
+    if (p.resource_type === 'media') {
+        res = await client.invoke('feishu_doc_media.download', (sdk, opts) => sdk.drive.v1.media.download({ path: { file_token: p.resource_token } }, opts), { as: 'user' });
+    }
+    else {
+        res = await client.invoke('feishu_doc_media.download', (sdk, opts) => sdk.board.v1.whiteboard.downloadAsImage({ path: { whiteboard_id: p.resource_token } }, opts), { as: 'user' });
+    }
+    // 读取二进制流
+    const stream = res.getReadableStream();
+    const chunks = [];
+    for await (const chunk of stream) {
+        chunks.push(chunk);
+    }
+    const buffer = Buffer.concat(chunks);
+    log.info(`download: received ${buffer.length} bytes`);
+    // 从 Content-Type 推断扩展名
+    const contentType = res.headers?.['content-type'] || '';
+    let finalPath = p.output_path;
+    const currentExt = path.extname(p.output_path);
+    if (!currentExt && contentType) {
+        const mimeType = contentType.split(';')[0].trim();
+        const defaultExt = p.resource_type === 'whiteboard' ? '.png' : undefined;
+        const suggestedExt = MIME_TO_EXT[mimeType] || defaultExt;
+        if (suggestedExt) {
+            finalPath = p.output_path + suggestedExt;
+            log.info(`download: auto-detected extension ${suggestedExt}`);
+        }
+    }
+    // 确保父目录存在并保存
+    await fs.mkdir(path.dirname(finalPath), { recursive: true });
+    try {
+        await fs.writeFile(finalPath, buffer);
+        log.info(`download: saved to ${finalPath}`);
+    }
+    catch (err) {
+        return json({
+            error: `failed to save file: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    }
+    return json({
+        resource_type: p.resource_type,
+        resource_token: p.resource_token,
+        size_bytes: buffer.length,
+        content_type: contentType,
+        saved_path: finalPath,
+    });
+}
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+export function registerDocMediaTool(api) {
+    if (!api.config)
+        return;
+    const cfg = api.config;
+    const { toolClient, log } = createToolContext(api, 'feishu_doc_media');
+    api.registerTool({
+        name: 'feishu_doc_media',
+        label: 'Feishu: Document Media',
+        description: '【以用户身份】文档媒体管理工具。' +
+            '支持两种操作：' +
+            '(1) insert - 在飞书文档末尾插入本地图片或文件（需要文档 ID + 本地文件路径）；' +
+            '(2) download - 下载文档素材或画板缩略图到本地（需要资源 token + 输出路径）。' +
+            '\n\n【重要】insert 仅支持本地文件路径。URL 图片请使用 create-doc/update-doc 的 <image url="..."/> 语法。',
+        parameters: DocMediaSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = toolClient();
+                if (p.action === 'insert') {
+                    return await handleInsert(p, client, log);
+                }
+                if (p.action === 'download') {
+                    return await handleDownload(p, client, log);
+                }
+                return json({ error: `unknown action: ${p.action}` });
+            }
+            catch (err) {
+                return await handleInvokeErrorWithAutoAuth(err, cfg);
+            }
+        },
+    }, { name: 'feishu_doc_media' });
+    api.logger.info?.('feishu_doc_media: Registered feishu_doc_media tool (insert, download)');
+}
+//# sourceMappingURL=doc-media.js.map

package/src/tools/oapi/drive/doc-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-media.js","sourceRoot":"","sources":["../../../../../src/tools/oapi/drive/doc-media.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,uDAAuD;AAGvD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,YAAY,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO;AAE/C,MAAM,SAAS,GAA2B;IACxC,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,iBAAiB;AACjB,MAAM,YAAY,GAAG;IACnB,KAAK,EAAE;QACL,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,WAAW,EAAE,YAAqB;QAClC,KAAK,EAAE,IAAI;KACZ;IACD,IAAI,EAAE;QACJ,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QACnC,WAAW,EAAE,WAAoB;QACjC,KAAK,EAAE,IAAI;KACZ;CACF,CAAC;AAEF,wBAAwB;AACxB,MAAM,WAAW,GAA2B;IAC1C,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,OAAO;IACrB,eAAe,EAAE,MAAM;IACvB,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,OAAO;IACrB,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,OAAO;IACrB,iBAAiB,EAAE,MAAM;IACzB,iBAAiB,EAAE,MAAM;IACzB,YAAY,EAAE,OAAO;IACrB,iBAAiB,EAAE,MAAM;IACzB,oBAAoB,EAAE,MAAM;IAC5B,yEAAyE,EAAE,OAAO;IAClF,0BAA0B,EAAE,MAAM;IAClC,mEAAmE,EAAE,OAAO;IAC5E,+BAA+B,EAAE,MAAM;IACvC,2EAA2E,EAAE,OAAO;IACpF,iBAAiB,EAAE,MAAM;IACzB,8BAA8B,EAAE,MAAM;IACtC,YAAY,EAAE,MAAM;IACpB,kBAAkB,EAAE,OAAO;CAC5B,CAAC;AAEF,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAa;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACzD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC;IAChC,gBAAgB;IAChB,IAAI,CAAC,MAAM,CAAC;QACV,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC9B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;YAClB,WAAW,EAAE,4CAA4C;SAC1D,CAAC;QACF,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;YACrB,WAAW,EAAE,wDAAwD;SACtE,CAAC;QACF,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE;YACxD,WAAW,EAAE,mCAAmC;SACjD,CAAC,CACH;QACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE;YAChF,WAAW,EAAE,mDAAmD;SACjE,CAAC,CACH;QACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC;YACV,WAAW,EAAE,mBAAmB;SACjC,CAAC,CACH;KACF,CAAC;IAEF,kBAAkB;IAClB,IAAI,CAAC,MAAM,CAAC;QACV,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QAChC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC;YAC1B,WAAW,EAAE,+CAA+C;SAC7D,CAAC;QACF,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE;YAC7E,WAAW,EAAE,+CAA+C;SAC7D,CAAC;QACF,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;YACvB,WAAW,EACT,wCAAwC;gBACxC,kCAAkC;SACrC,CAAC;KACH,CAAC;CACH,CAAC,CAAC;AAwBH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,KAAK,UAAU,YAAY,CACzB,CAAe,EACf,MAAsE,EACtE,GAAgD;IAEhD,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC;IACpC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAEvC,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC;IAC7B,MAAM,uBAAuB,GAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAC,CAAC;IAEzE,eAAe;IACf,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;YACV,KAAK,EAAE,wBAAwB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAClF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,GAAG,aAAa,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;YACV,KAAK,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB;SAC1E,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,GAAG,CAAC,IAAI,CAAC,eAAe,UAAU,UAAU,SAAS,UAAU,QAAQ,UAAU,QAAQ,EAAE,CAAC,CAAC;IAE7F,wBAAwB;IACxB,MAAM,SAAS,GAAQ,MAAM,MAAM,CAAC,MAAM,CACxC,yBAAyB,EACzB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CACX,GAAG,CAAC,IAAI,CAAC,qBAA6B,CAAC,MAAM,CAC5C;QACE,IAAI,EAAE;YACJ,WAAW,EAAE,UAAU;YACvB,QAAQ,EAAE,UAAU;SACrB;QACD,IAAI,EAAE;YACJ,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;SACpE;QACD,MAAM,EAAE,EAAE,oBAAoB,EAAE,CAAC,CAAC,EAAE;KACrC,EACD,IAAI,CACL,EACH,EAAE,EAAE,EAAE,MAAM,EAAE,CACf,CAAC;IACF,YAAY,CAAC,SAAS,CAAC,CAAC;IAExB,gDAAgD;IAChD,+CAA+C;IAC/C,mDAAmD;IACnD,IAAI,OAA2B,CAAC;IAChC,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;YACV,KAAK,EAAE,oBAAoB,MAAM,CAAC,KAAK,8BAA8B;SACtE,CAAC,CAAC;IACL,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,mBAAmB,SAAS,UAAU,OAAO,EAAE,CAAC,CAAC;IAE1D,UAAU;IACV,MAAM,SAAS,GAAQ,MAAM,MAAM,CAAC,MAAM,CACxC,yBAAyB,EACzB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CACX,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAa,CAAC,SAAS,CACnC;QACE,IAAI,EAAE;YACJ,SAAS,EAAE,QAAQ;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,OAAO;YACpB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC;YAChC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC;gBACpB,iBAAiB,EAAE,UAAU;aAC9B,CAAC;SACH;KACF,EACD,IAAI,CACL,EACH,EAAE,EAAE,EAAE,MAAM,EAAE,CACf,CAAC;IAEF,MAAM,SAAS,GAAG,SAAS,EAAE,UAAU,IAAI,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC;IACvE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;YACV,KAAK,EAAE,oBAAoB,MAAM,CAAC,KAAK,gCAAgC;SACxE,CAAC,CAAC;IACL,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;IAE5D,2BAA2B;IAC3B,MAAM,YAAY,GAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEhD,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC;QAEhD,WAAW;QACX,IAAI,KAAyB,CAAC;QAC9B,IAAI,MAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC9B,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;gBACnB,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;gBACrB,GAAG,CAAC,IAAI,CAAC,+BAA+B,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QAClE,CAAC;QAED,YAAY,CAAC,aAAa,GAAG;YAC3B,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,QAAQ;YACf,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1D,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,YAAY,CAAC,YAAY,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,QAAQ,GAAQ,MAAM,MAAM,CAAC,MAAM,CACvC,yBAAyB,EACzB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CACZ,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,CAChC;QACE,IAAI,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE;QACjC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE;QAClC,MAAM,EAAE,EAAE,oBAAoB,EAAE,CAAC,CAAC,EAAE;KACrC,EACD,IAAI,CACL,EACH,EAAE,EAAE,EAAE,MAAM,EAAE,CACf,CAAC;IACF,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvB,GAAG,CAAC,IAAI,CAAC,mBAAmB,SAAS,wBAAwB,CAAC,CAAC;IAE/D,OAAO,IAAI,CAAC;QACV,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,UAAU;QACvB,QAAQ,EAAE,OAAO;QACjB,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,CAAiB,EACjB,MAAsE,EACtE,GAAgD;IAEhD,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,aAAa,YAAY,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC;IAEpF,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC,CAAC,aAAa,KAAK,OAAO,EAAE,CAAC;QAChC,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CACvB,2BAA2B,EAC3B,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,cAAc,EAAE,EAAE,EAAE,IAAI,CAAC,EAC5F,EAAE,EAAE,EAAE,MAAM,EAAE,CACf,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CACvB,2BAA2B,EAC3B,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,cAAc,EAAE,EAAE,EAAE,IAAI,CAAC,EAC3G,EAAE,EAAE,EAAE,MAAM,EAAE,CACf,CAAC;IACJ,CAAC;IAED,SAAS;IACT,MAAM,MAAM,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,GAAG,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,MAAM,QAAQ,CAAC,CAAC;IAEtD,uBAAuB;IACvB,MAAM,WAAW,GAAW,GAAG,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAChE,IAAI,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAE/C,IAAI,CAAC,UAAU,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,MAAM,UAAU,GAAG,CAAC,CAAC,aAAa,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC;QACzD,IAAI,YAAY,EAAE,CAAC;YACjB,SAAS,GAAG,CAAC,CAAC,WAAW,GAAG,YAAY,CAAC;YACzC,GAAG,CAAC,IAAI,CAAC,qCAAqC,YAAY,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,aAAa;IACb,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7D,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;YACV,KAAK,EAAE,wBAAwB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAClF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;QACV,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,cAAc,EAAE,CAAC,CAAC,cAAc;QAChC,UAAU,EAAE,MAAM,CAAC,MAAM;QACzB,YAAY,EAAE,WAAW;QACzB,UAAU,EAAE,SAAS;KACtB,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,UAAU,oBAAoB,CAAC,GAAsB;IACzD,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,OAAO;IACxB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IAEvB,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAEvE,GAAG,CAAC,YAAY,CACd;QACE,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,kBAAkB;YAClB,SAAS;YACT,kDAAkD;YAClD,oDAAoD;YACpD,mFAAmF;QACrF,UAAU,EAAE,cAAc;QAC1B,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAAe;YAChD,MAAM,CAAC,GAAG,MAAwB,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;gBAC5B,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC1B,OAAO,MAAM,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;gBAC5C,CAAC;gBACD,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;oBAC5B,OAAO,MAAM,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;gBAC9C,CAAC;gBACD,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAoB,CAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACjE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,MAAM,6BAA6B,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;KACF,EACD,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAC7B,CAAC;IAEF,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,uEAAuE,CAAC,CAAC;AAC7F,CAAC"}

package/src/tools/oapi/drive/file.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_drive_file tool -- Manage Feishu Drive files.
+ *
+ * Actions: list, get_meta, copy, move, delete, upload, download
+ *
+ * Uses the Feishu Drive API:
+ *   - list:        GET    /open-apis/drive/v1/files
+ *   - get_meta:    POST   /open-apis/drive/v1/metas/batch_query
+ *   - copy:        POST   /open-apis/drive/v1/files/:file_token/copy
+ *   - move:        POST   /open-apis/drive/v1/files/:file_token/move
+ *   - delete:      DELETE /open-apis/drive/v1/files/:file_token
+ *   - upload:      POST   /open-apis/drive/v1/files/upload_all
+ *   - download:    GET    /open-apis/drive/v1/files/:file_token/download
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuDriveFileTool(api: OpenClawPluginApi): void;
+//# sourceMappingURL=file.d.ts.map

package/src/tools/oapi/drive/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../../../src/tools/oapi/drive/file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAqR7D,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,iBAAiB,QAgcjE"}