@larksuite/openclaw-lark 2026.3.9

package/src/tools/oapi/wiki/space-node.js

@@ -0,0 +1,253 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_wiki_space_node tool -- Manage Feishu Wiki space nodes.
+ *
+ * Actions: list, get, create, move, copy
+ *
+ * Uses the Feishu Wiki API:
+ *   - list:   GET  /open-apis/wiki/v2/spaces/:space_id/nodes
+ *   - get:    GET  /open-apis/wiki/v2/spaces/get_node
+ *   - create: POST /open-apis/wiki/v2/spaces/:space_id/nodes
+ *   - move:   POST /open-apis/wiki/v2/spaces/:space_id/nodes/:node_token/move
+ *   - copy:   POST /open-apis/wiki/v2/spaces/:space_id/nodes/:node_token/copy
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { Type } from '@sinclair/typebox';
+import { json, createToolContext, assertLarkOk, handleInvokeErrorWithAutoAuth, } from '../helpers';
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const FeishuWikiSpaceNodeSchema = Type.Union([
+    // LIST NODES
+    Type.Object({
+        action: Type.Literal('list'),
+        space_id: Type.String({
+            description: 'space_id',
+        }),
+        parent_node_token: Type.Optional(Type.String({
+            description: 'parent_node_token',
+        })),
+        page_size: Type.Optional(Type.Integer({
+            description: 'page_size',
+            minimum: 1,
+        })),
+        page_token: Type.Optional(Type.String({
+            description: 'page_token',
+        })),
+    }),
+    // GET NODE
+    Type.Object({
+        action: Type.Literal('get'),
+        token: Type.String({
+            description: 'node token',
+        }),
+        obj_type: Type.Optional(Type.Union([
+            Type.Literal('doc'),
+            Type.Literal('sheet'),
+            Type.Literal('mindnote'),
+            Type.Literal('bitable'),
+            Type.Literal('file'),
+            Type.Literal('docx'),
+            Type.Literal('slides'),
+            Type.Literal('wiki'),
+        ], {
+            description: 'obj_type',
+        })),
+    }),
+    // CREATE NODE
+    Type.Object({
+        action: Type.Literal('create'),
+        space_id: Type.String({
+            description: 'space_id',
+        }),
+        obj_type: Type.Union([
+            Type.Literal('doc'),
+            Type.Literal('sheet'),
+            Type.Literal('mindnote'),
+            Type.Literal('bitable'),
+            Type.Literal('file'),
+            Type.Literal('docx'),
+            Type.Literal('slides'),
+        ], {
+            description: 'obj_type',
+        }),
+        parent_node_token: Type.Optional(Type.String({
+            description: 'parent_node_token',
+        })),
+        node_type: Type.Optional(Type.Union([Type.Literal('origin'), Type.Literal('shortcut')], {
+            description: 'node_type',
+        })),
+        origin_node_token: Type.Optional(Type.String({
+            description: 'origin_node_token',
+        })),
+        title: Type.Optional(Type.String({
+            description: 'title',
+        })),
+    }),
+    // MOVE NODE
+    Type.Object({
+        action: Type.Literal('move'),
+        space_id: Type.String({
+            description: 'space_id',
+        }),
+        node_token: Type.String({
+            description: 'node_token',
+        }),
+        target_parent_token: Type.Optional(Type.String({
+            description: 'target_parent_token',
+        })),
+    }),
+    // COPY NODE
+    Type.Object({
+        action: Type.Literal('copy'),
+        space_id: Type.String({
+            description: 'space_id',
+        }),
+        node_token: Type.String({
+            description: 'node_token',
+        }),
+        target_space_id: Type.Optional(Type.String({
+            description: 'target_space_id',
+        })),
+        target_parent_token: Type.Optional(Type.String({
+            description: 'target_parent_token',
+        })),
+        title: Type.Optional(Type.String({
+            description: 'title',
+        })),
+    }),
+]);
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+export function registerFeishuWikiSpaceNodeTool(api) {
+    if (!api.config)
+        return;
+    const cfg = api.config;
+    const { toolClient, log } = createToolContext(api, 'feishu_wiki_space_node');
+    api.registerTool({
+        name: 'feishu_wiki_space_node',
+        label: 'Feishu Wiki Space Nodes',
+        description: '飞书知识库节点管理工具。操作：list（列表）、get（获取）、create（创建）、move（移动）、copy（复制）。' +
+            '节点是知识库中的文档，包括 doc、bitable(多维表表格)、sheet(电子表格) 等类型。' +
+            'node_token 是节点的唯一标识符，obj_token 是实际文档的 token。可通过 get 操作将 wiki 类型的 node_token 转换为实际文档的 obj_token。',
+        parameters: FeishuWikiSpaceNodeSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = toolClient();
+                switch (p.action) {
+                    // -----------------------------------------------------------------
+                    // LIST NODES
+                    // -----------------------------------------------------------------
+                    case 'list': {
+                        log.info(`list: space_id=${p.space_id}, parent=${p.parent_node_token ?? '(root)'}, page_size=${p.page_size ?? 50}`);
+                        const res = await client.invoke('feishu_wiki_space_node.list', (sdk, opts) => sdk.wiki.spaceNode.list({
+                            path: { space_id: p.space_id },
+                            params: {
+                                page_size: p.page_size,
+                                page_token: p.page_token,
+                                parent_node_token: p.parent_node_token,
+                            },
+                        }, opts), { as: 'user' });
+                        assertLarkOk(res);
+                        const data = res.data;
+                        log.info(`list: returned ${data?.items?.length ?? 0} nodes`);
+                        return json({
+                            nodes: data?.items,
+                            has_more: data?.has_more,
+                            page_token: data?.page_token,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // GET NODE
+                    // -----------------------------------------------------------------
+                    case 'get': {
+                        log.info(`get: token=${p.token}, obj_type=${p.obj_type ?? 'wiki'}`);
+                        const res = await client.invoke('feishu_wiki_space_node.get', (sdk, opts) => sdk.wiki.space.getNode({
+                            params: {
+                                token: p.token,
+                                obj_type: (p.obj_type || 'wiki'),
+                            },
+                        }, opts), { as: 'user' });
+                        assertLarkOk(res);
+                        log.info(`get: retrieved node ${p.token}`);
+                        return json({
+                            node: res.data?.node,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // CREATE NODE
+                    // -----------------------------------------------------------------
+                    case 'create': {
+                        log.info(`create: space_id=${p.space_id}, obj_type=${p.obj_type}, parent=${p.parent_node_token ?? '(root)'}, title=${p.title ?? '(empty)'}`);
+                        const res = await client.invoke('feishu_wiki_space_node.create', (sdk, opts) => sdk.wiki.spaceNode.create({
+                            path: { space_id: p.space_id },
+                            data: {
+                                obj_type: p.obj_type,
+                                parent_node_token: p.parent_node_token,
+                                node_type: p.node_type,
+                                origin_node_token: p.origin_node_token,
+                                title: p.title,
+                            },
+                        }, opts), { as: 'user' });
+                        assertLarkOk(res);
+                        log.info(`create: created node_token=${res.data?.node?.node_token}`);
+                        return json({
+                            node: res.data?.node,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // MOVE NODE
+                    // -----------------------------------------------------------------
+                    case 'move': {
+                        log.info(`move: space_id=${p.space_id}, node_token=${p.node_token}, target_parent=${p.target_parent_token ?? '(root)'}`);
+                        const res = await client.invoke('feishu_wiki_space_node.move', (sdk, opts) => sdk.wiki.spaceNode.move({
+                            path: {
+                                space_id: p.space_id,
+                                node_token: p.node_token,
+                            },
+                            data: {
+                                target_parent_token: p.target_parent_token,
+                            },
+                        }, opts), { as: 'user' });
+                        assertLarkOk(res);
+                        log.info(`move: moved node ${p.node_token}`);
+                        return json({
+                            node: res.data?.node,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // COPY NODE
+                    // -----------------------------------------------------------------
+                    case 'copy': {
+                        log.info(`copy: space_id=${p.space_id}, node_token=${p.node_token}, target_space=${p.target_space_id ?? '(same)'}, target_parent=${p.target_parent_token ?? '(root)'}`);
+                        const res = await client.invoke('feishu_wiki_space_node.copy', (sdk, opts) => sdk.wiki.spaceNode.copy({
+                            path: {
+                                space_id: p.space_id,
+                                node_token: p.node_token,
+                            },
+                            data: {
+                                target_space_id: p.target_space_id,
+                                target_parent_token: p.target_parent_token,
+                                title: p.title,
+                            },
+                        }, opts), { as: 'user' });
+                        assertLarkOk(res);
+                        log.info(`copy: copied to node_token=${res.data?.node?.node_token}`);
+                        return json({
+                            node: res.data?.node,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                return await handleInvokeErrorWithAutoAuth(err, cfg);
+            }
+        },
+    }, { name: 'feishu_wiki_space_node' });
+    api.logger.info?.('feishu_wiki_space_node: Registered feishu_wiki_space_node tool');
+}
+//# sourceMappingURL=space-node.js.map

package/src/tools/oapi/wiki/space-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-node.js","sourceRoot":"","sources":["../../../../../src/tools/oapi/wiki/space-node.ts"],"names":[],"mappings":"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"}

package/src/tools/oapi/wiki/space.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_wiki_space tool -- Manage Feishu Wiki spaces.
+ *
+ * Actions: list, get, create
+ *
+ * Uses the Feishu Wiki API:
+ *   - list:   GET  /open-apis/wiki/v2/spaces
+ *   - get:    GET  /open-apis/wiki/v2/spaces/:space_id
+ *   - create: POST /open-apis/wiki/v2/spaces
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuWikiSpaceTool(api: OpenClawPluginApi): void;
+//# sourceMappingURL=space.d.ts.map

package/src/tools/oapi/wiki/space.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space.d.ts","sourceRoot":"","sources":["../../../../../src/tools/oapi/wiki/space.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAiF7D,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,iBAAiB,QAuHjE"}

package/src/tools/oapi/wiki/space.js

@@ -0,0 +1,132 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_wiki_space tool -- Manage Feishu Wiki spaces.
+ *
+ * Actions: list, get, create
+ *
+ * Uses the Feishu Wiki API:
+ *   - list:   GET  /open-apis/wiki/v2/spaces
+ *   - get:    GET  /open-apis/wiki/v2/spaces/:space_id
+ *   - create: POST /open-apis/wiki/v2/spaces
+ */
+import { Type } from '@sinclair/typebox';
+import { json, createToolContext, assertLarkOk, handleInvokeErrorWithAutoAuth, } from '../helpers';
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const FeishuWikiSpaceSchema = Type.Union([
+    // LIST SPACES
+    Type.Object({
+        action: Type.Literal('list'),
+        page_size: Type.Optional(Type.Integer({
+            description: '分页大小（默认 10，最大 50）',
+            minimum: 1,
+            maximum: 50,
+        })),
+        page_token: Type.Optional(Type.String({
+            description: '分页标记。首次请求无需填写',
+        })),
+    }),
+    // GET SPACE
+    Type.Object({
+        action: Type.Literal('get'),
+        space_id: Type.String({
+            description: '知识空间 ID（必填）',
+        }),
+    }),
+    // CREATE SPACE
+    Type.Object({
+        action: Type.Literal('create'),
+        name: Type.Optional(Type.String({
+            description: '知识空间名称',
+        })),
+        description: Type.Optional(Type.String({
+            description: '知识空间描述',
+        })),
+    }),
+]);
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+export function registerFeishuWikiSpaceTool(api) {
+    if (!api.config)
+        return;
+    const cfg = api.config;
+    const { toolClient, log } = createToolContext(api, 'feishu_wiki_space');
+    api.registerTool({
+        name: 'feishu_wiki_space',
+        label: 'Feishu Wiki Spaces',
+        description: '飞书知识空间管理工具。当用户要求查看知识库列表、获取知识库信息、创建知识库时使用。Actions: list（列出知识空间）, get（获取知识空间信息）, create（创建知识空间）。' +
+            '【重要】space_id 可以从浏览器 URL 中获取，或通过 list 接口获取。' +
+            '【重要】知识空间（Space）是知识库的基本组成单位，包含多个具有层级关系的文档节点。',
+        parameters: FeishuWikiSpaceSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = toolClient();
+                switch (p.action) {
+                    // -----------------------------------------------------------------
+                    // LIST SPACES
+                    // -----------------------------------------------------------------
+                    case 'list': {
+                        log.info(`list: page_size=${p.page_size ?? 10}`);
+                        const res = await client.invoke('feishu_wiki_space.list', (sdk, opts) => sdk.wiki.space.list({
+                            params: {
+                                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                                page_size: p.page_size,
+                                page_token: p.page_token,
+                            },
+                        }, opts), { as: 'user' });
+                        assertLarkOk(res);
+                        const data = res.data;
+                        log.info(`list: returned ${data?.items?.length ?? 0} spaces`);
+                        return json({
+                            spaces: data?.items,
+                            has_more: data?.has_more,
+                            page_token: data?.page_token,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // GET SPACE
+                    // -----------------------------------------------------------------
+                    case 'get': {
+                        log.info(`get: space_id=${p.space_id}`);
+                        const res = await client.invoke('feishu_wiki_space.get', (sdk, opts) => sdk.wiki.space.get({
+                            path: { space_id: p.space_id },
+                        }, opts), { as: 'user' });
+                        assertLarkOk(res);
+                        log.info(`get: retrieved space ${p.space_id}`);
+                        return json({
+                            space: res.data?.space,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // CREATE SPACE
+                    // -----------------------------------------------------------------
+                    case 'create': {
+                        log.info(`create: name=${p.name ?? '(empty)'}, description=${p.description ?? '(empty)'}`);
+                        const res = await client.invoke('feishu_wiki_space.create', (sdk, opts) => sdk.wiki.space.create({
+                            data: {
+                                name: p.name,
+                                description: p.description,
+                            },
+                        }, opts), { as: 'user' });
+                        assertLarkOk(res);
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        log.info(`create: created space_id=${res.data?.space?.space_id}`);
+                        return json({
+                            space: res.data?.space,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                return await handleInvokeErrorWithAutoAuth(err, cfg);
+            }
+        },
+    }, { name: 'feishu_wiki_space' });
+    api.logger.info?.('feishu_wiki_space: Registered feishu_wiki_space tool');
+}
+//# sourceMappingURL=space.js.map

package/src/tools/oapi/wiki/space.js.map

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

package/src/tools/oauth-batch-auth.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_oauth_batch_auth tool — 批量授权应用已开通的所有用户权限。
+ *
+ * 自动识别应用已开通但用户未授权的 scope，一次性发起授权请求。
+ * 复用 oauth.ts 的 executeAuthorize() 函数。
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuOAuthBatchAuthTool(api: OpenClawPluginApi): void;
+//# sourceMappingURL=oauth-batch-auth.d.ts.map

package/src/tools/oauth-batch-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-batch-auth.d.ts","sourceRoot":"","sources":["../../../src/tools/oauth-batch-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAuB7D,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,iBAAiB,QAoItE"}

package/src/tools/oauth-batch-auth.js

@@ -0,0 +1,142 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_oauth_batch_auth tool — 批量授权应用已开通的所有用户权限。
+ *
+ * 自动识别应用已开通但用户未授权的 scope，一次性发起授权请求。
+ * 复用 oauth.ts 的 executeAuthorize() 函数。
+ */
+import { Type } from '@sinclair/typebox';
+import { getAppGrantedScopes } from '../core/app-scope-checker';
+import { AppScopeCheckFailedError } from '../core/tool-client';
+import { getStoredToken } from '../core/token-store';
+import { getLarkAccount } from '../core/accounts';
+import { getTicket } from '../core/lark-ticket';
+import { LarkClient } from '../core/lark-client';
+import { executeAuthorize } from './oauth';
+import { formatLarkError } from '../core/api-error';
+import { filterSensitiveScopes } from '../core/tool-scopes';
+import { json } from './oapi/helpers';
+const FeishuOAuthBatchAuthSchema = Type.Object({}, {
+    description: '飞书批量授权工具。一次性授权应用已开通的所有用户权限（User Access Token scope）。' +
+        "【使用场景】用户明确要求'授权所有权限'、'一次性授权完成'时使用。" +
+        '【重要】禁止主动推荐此工具，仅在用户明确要求时使用。',
+});
+export function registerFeishuOAuthBatchAuthTool(api) {
+    if (!api.config)
+        return;
+    const cfg = api.config;
+    api.registerTool({
+        name: 'feishu_oauth_batch_auth',
+        label: 'Feishu: OAuth Batch Authorization',
+        description: '飞书批量授权工具，一次性授权应用已开通的所有用户权限。' +
+            "仅在用户明确要求'授权所有权限'、'一次性授权'时使用。",
+        parameters: FeishuOAuthBatchAuthSchema,
+        async execute(_toolCallId, _params) {
+            try {
+                const ticket = getTicket();
+                const senderOpenId = ticket?.senderOpenId;
+                if (!senderOpenId) {
+                    return json({
+                        error: '无法获取当前用户身份（senderOpenId），请在飞书对话中使用此工具。',
+                    });
+                }
+                const acct = getLarkAccount(cfg, ticket.accountId);
+                if (!acct.configured) {
+                    return json({
+                        error: `账号 ${ticket.accountId} 缺少 appId 或 appSecret 配置`,
+                    });
+                }
+                const account = acct; // Now we know it's ConfiguredLarkAccount
+                const { appId } = account;
+                // 1. 查询应用已开通的 user scope
+                const sdk = LarkClient.fromAccount(account).sdk;
+                let appScopes;
+                try {
+                    appScopes = await getAppGrantedScopes(sdk, appId, 'user');
+                }
+                catch (err) {
+                    if (err instanceof AppScopeCheckFailedError) {
+                        return json({
+                            error: 'app_scope_check_failed',
+                            message: `应用缺少核心权限 application:application:self_manage，无法查询可授权 scope 列表。\n\n` +
+                                `请管理员在飞书开放平台开通此权限后重试。`,
+                            permission_link: `https://open.feishu.cn/app/${appId}/auth?q=application:application:self_manage`,
+                            app_id: appId,
+                        });
+                    }
+                    throw err;
+                }
+                // 2. 边界情况：应用无 user scope
+                if (appScopes.length === 0) {
+                    return json({
+                        success: false,
+                        message: '当前应用未开通任何用户级权限（User Access Token scope），' +
+                            '无法使用用户身份调用 API。\n\n' +
+                            '如需使用用户级功能，请联系管理员在开放平台开通相关权限。',
+                        total_app_scopes: 0,
+                        app_id: appId,
+                    });
+                }
+                // 3. 查询用户已授权的 scope
+                const existing = await getStoredToken(appId, senderOpenId);
+                const grantedScopes = new Set(existing?.scope?.split(/\s+/).filter(Boolean) ?? []);
+                // 4. 计算差集（应用已开通但用户未授权）
+                let missingScopes = appScopes.filter((s) => !grantedScopes.has(s));
+                missingScopes = filterSensitiveScopes(missingScopes);
+                // 5. 边界情况：用户已授权所有 scope
+                if (missingScopes.length === 0) {
+                    return json({
+                        success: true,
+                        message: `您已授权所有可用权限（共 ${appScopes.length} 个），无需重复授权。`,
+                        total_app_scopes: appScopes.length,
+                        already_granted: appScopes.length,
+                        missing: 0,
+                    });
+                }
+                // 6. 飞书限制：单次最多请求 100 个 scope
+                const MAX_SCOPES_PER_BATCH = 100;
+                let scopesToAuthorize = missingScopes;
+                let batchInfo = '';
+                if (missingScopes.length > MAX_SCOPES_PER_BATCH) {
+                    // 分批授权：取前 50 个
+                    scopesToAuthorize = missingScopes.slice(0, MAX_SCOPES_PER_BATCH);
+                    const remainingCount = missingScopes.length - MAX_SCOPES_PER_BATCH;
+                    batchInfo =
+                        `\n\n由于飞书限制（单次最多 ${MAX_SCOPES_PER_BATCH} 个 scope），` +
+                            `本次将授权前 ${MAX_SCOPES_PER_BATCH} 个权限。\n` +
+                            `授权完成后，还需授权剩余 ${remainingCount} 个权限`;
+                }
+                // 7. 调用共享的 executeAuthorize() 函数（复用 oauth.ts 逻辑）
+                const scope = scopesToAuthorize.join(' ');
+                const result = await executeAuthorize({
+                    account,
+                    senderOpenId,
+                    scope,
+                    isBatchAuth: true,
+                    totalAppScopes: appScopes.length,
+                    alreadyGranted: grantedScopes.size,
+                    batchInfo,
+                    cfg,
+                    ticket,
+                });
+                // 8. 如果是分批授权，在返回结果中添加提示
+                if (batchInfo && result.details) {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const details = result.details;
+                    if (details.message) {
+                        details.message = details.message + batchInfo;
+                    }
+                }
+                return result;
+            }
+            catch (err) {
+                api.logger.error?.(`feishu_oauth_batch_auth: ${err}`);
+                return json({ error: formatLarkError(err) });
+            }
+        },
+    }, { name: 'feishu_oauth_batch_auth' });
+    api.logger.info?.('feishu_oauth_batch_auth: Registered feishu_oauth_batch_auth tool');
+}
+//# sourceMappingURL=oauth-batch-auth.js.map

package/src/tools/oauth-batch-auth.js.map

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

package/src/tools/oauth-cards.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * oauth-cards.ts — OAuth 授权卡片构建函数。
+ *
+ * 从 oauth.ts 提取的纯 UI 函数，与 OAuth 业务流程解耦。
+ */
+export declare function buildAuthCard(params: {
+    verificationUriComplete: string;
+    expiresMin: number;
+    scope?: string;
+    isBatchAuth?: boolean;
+    totalAppScopes?: number;
+    alreadyGranted?: number;
+    batchInfo?: string;
+    filteredScopes?: string[];
+    appId?: string;
+    showBatchAuthHint?: boolean;
+}): Record<string, unknown>;
+/** scope 字符串 → 可读描述 */
+export declare function formatScopeDescription(scope?: string, isBatchAuth?: boolean, totalAppScopes?: number, alreadyGranted?: number, batchInfo?: string, _filteredScopes?: string[], _appId?: string): string;
+export declare function toInAppWebUrl(targetUrl: string): string;
+export declare function buildAuthSuccessCard(): Record<string, unknown>;
+export declare function buildAuthFailedCard(_reason: string): Record<string, unknown>;
+export declare function buildAuthIdentityMismatchCard(): Record<string, unknown>;
+//# sourceMappingURL=oauth-cards.d.ts.map

package/src/tools/oauth-cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-cards.d.ts","sourceRoot":"","sources":["../../../src/tools/oauth-cards.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,uBAAuB,EAAE,MAAM,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8G1B;AAED,uBAAuB;AACvB,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,OAAO,EACrB,cAAc,CAAC,EAAE,MAAM,EACvB,cAAc,CAAC,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,MAAM,EAClB,eAAe,CAAC,EAAE,MAAM,EAAE,EAC1B,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CA6BR;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAcvD;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyC9D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuC5E;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCvE"}