@larksuite/openclaw-lark 2026.3.9

package/src/tools/onboarding-auth.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Onboarding 预授权模块。
+ *
+ * 配对后自动发起 OAuth Device Flow，引导应用 owner 完成用户授权。
+ * 仅当配对用户 === 应用 owner 时触发。
+ *
+ * 飞书限制：单次 OAuth 最多 50 个 scope。
+ * 超过 50 个时自动分批处理，每批授权完成后自动发起下一批（链式触发）。
+ */
+import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
+/**
+ * 配对后触发 onboarding OAuth 授权。
+ *
+ * 流程：
+ *   1. 检查 userOpenId === 应用 owner，不匹配则静默跳过
+ *   2. 读取 onboarding-scopes.json 中的 user scope 列表
+ *   3. 分批处理（每批最多 50 个），第一批直接发起 OAuth Device Flow
+ *   4. 每批授权完成后通过 onAuthComplete 回调自动发起下一批
+ */
+export declare function triggerOnboarding(params: {
+    cfg: ClawdbotConfig;
+    userOpenId: string;
+    accountId: string;
+}): Promise<void>;
+//# sourceMappingURL=onboarding-auth.d.ts.map

package/src/tools/onboarding-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-auth.d.ts","sourceRoot":"","sources":["../../../src/tools/onboarding-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAqB1D;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,GAAG,EAAE,cAAc,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0GhB"}

package/src/tools/onboarding-auth.js

@@ -0,0 +1,131 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Onboarding 预授权模块。
+ *
+ * 配对后自动发起 OAuth Device Flow，引导应用 owner 完成用户授权。
+ * 仅当配对用户 === 应用 owner 时触发。
+ *
+ * 飞书限制：单次 OAuth 最多 50 个 scope。
+ * 超过 50 个时自动分批处理，每批授权完成后自动发起下一批（链式触发）。
+ */
+import { getLarkAccount } from '../core/accounts';
+import { LarkClient } from '../core/lark-client';
+import { getAppGrantedScopes } from '../core/app-scope-checker';
+import { getAppOwnerFallback } from '../core/app-owner-fallback';
+import { executeAuthorize } from './oauth';
+import { larkLogger } from '../core/lark-logger';
+import { filterSensitiveScopes } from '../core/tool-scopes';
+const log = larkLogger('tools/onboarding-auth');
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_SCOPES_PER_BATCH = 100;
+// ---------------------------------------------------------------------------
+// Trigger onboarding
+// ---------------------------------------------------------------------------
+/**
+ * 配对后触发 onboarding OAuth 授权。
+ *
+ * 流程：
+ *   1. 检查 userOpenId === 应用 owner，不匹配则静默跳过
+ *   2. 读取 onboarding-scopes.json 中的 user scope 列表
+ *   3. 分批处理（每批最多 50 个），第一批直接发起 OAuth Device Flow
+ *   4. 每批授权完成后通过 onAuthComplete 回调自动发起下一批
+ */
+export async function triggerOnboarding(params) {
+    const { cfg, userOpenId, accountId } = params;
+    const acct = getLarkAccount(cfg, accountId);
+    if (!acct.configured) {
+        log.warn(`account ${accountId} not configured, skipping`);
+        return;
+    }
+    const sdk = LarkClient.fromAccount(acct).sdk;
+    const { appId } = acct;
+    // 1. 检查 userOpenId === 应用 owner（统一走 getAppOwnerFallback）
+    const ownerOpenId = await getAppOwnerFallback(acct, sdk);
+    if (!ownerOpenId) {
+        log.info(`app ${appId} has no owner info, skipping`);
+        return;
+    }
+    if (userOpenId !== ownerOpenId) {
+        log.info(`user ${userOpenId} is not app owner (${ownerOpenId}), skipping`);
+        return;
+    }
+    log.info(`user ${userOpenId} is app owner, starting OAuth`);
+    // 3. 动态获取应用已开通的 user scope 列表
+    let allUserScopes;
+    try {
+        allUserScopes = await getAppGrantedScopes(sdk, appId, 'user');
+    }
+    catch (err) {
+        log.warn(`failed to get app granted scopes: ${err}`);
+        return;
+    }
+    // 过滤掉敏感 scope
+    allUserScopes = filterSensitiveScopes(allUserScopes);
+    if (allUserScopes.length === 0) {
+        log.info('no user scopes configured, skipping');
+        return;
+    }
+    // 4. 分批
+    const batches = [];
+    for (let i = 0; i < allUserScopes.length; i += MAX_SCOPES_PER_BATCH) {
+        batches.push(allUserScopes.slice(i, i + MAX_SCOPES_PER_BATCH));
+    }
+    log.info(`${allUserScopes.length} user scopes, ${batches.length} batch(es)`);
+    // 5. 链式发起授权（第一批同步发起，后续批次由 onAuthComplete 回调触发）
+    const startBatch = async (batchIndex) => {
+        if (batchIndex >= batches.length) {
+            log.info('all batches completed');
+            return;
+        }
+        const batch = batches[batchIndex];
+        const scope = batch.join(' ');
+        let batchInfo = '';
+        if (batches.length > 1) {
+            batchInfo =
+                `\n\n📋 授权进度：第 ${batchIndex + 1}/${batches.length} 批` +
+                    `（本批 ${batch.length} 个权限，共 ${allUserScopes.length} 个）`;
+            if (batchIndex < batches.length - 1) {
+                batchInfo += `\n授权完成后将自动发起下一批。`;
+            }
+            else {
+                batchInfo += `\n这是最后一批，授权完成后即可使用所有功能。`;
+            }
+        }
+        const ticket = {
+            messageId: `onboarding:${Date.now()}`,
+            chatId: userOpenId,
+            accountId,
+            startTime: Date.now(),
+            senderOpenId: userOpenId,
+            chatType: 'p2p',
+        };
+        log.info(`starting batch ${batchIndex + 1}/${batches.length}, scopes=${batch.length}`);
+        try {
+            await executeAuthorize({
+                account: acct,
+                senderOpenId: userOpenId,
+                scope,
+                isBatchAuth: true,
+                totalAppScopes: allUserScopes.length,
+                alreadyGranted: batchIndex * MAX_SCOPES_PER_BATCH,
+                batchInfo,
+                skipSyntheticMessage: true,
+                cfg,
+                ticket,
+                onAuthComplete: async () => {
+                    log.info(`batch ${batchIndex + 1}/${batches.length} auth completed`);
+                    await startBatch(batchIndex + 1);
+                },
+            });
+        }
+        catch (err) {
+            log.error(`batch ${batchIndex + 1} failed: ${err}`);
+        }
+    };
+    await startBatch(0);
+}
+//# sourceMappingURL=onboarding-auth.js.map

package/src/tools/onboarding-auth.js.map

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

package/src/tools/tat/im/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * IM 工具集
+ * 统一导出所有即时通讯相关工具的注册函数
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+/**
+ * 注册所有 IM 工具
+ *
+ * Note: feishu_im_message_reaction 和 feishu_im_message_recall 已移除，
+ * 其功能由 ChannelMessageActionAdapter (actions.ts) 的 react/delete action 统一覆盖。
+ */
+export declare function registerFeishuImTools(api: OpenClawPluginApi): void;
+//# sourceMappingURL=index.d.ts.map

package/src/tools/tat/im/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tools/tat/im/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,QAG3D"}

package/src/tools/tat/im/index.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * IM 工具集
+ * 统一导出所有即时通讯相关工具的注册函数
+ */
+import { registerFeishuImBotImageTool } from './resource';
+/**
+ * 注册所有 IM 工具
+ *
+ * Note: feishu_im_message_reaction 和 feishu_im_message_recall 已移除，
+ * 其功能由 ChannelMessageActionAdapter (actions.ts) 的 react/delete action 统一覆盖。
+ */
+export function registerFeishuImTools(api) {
+    registerFeishuImBotImageTool(api);
+    api.logger.info?.('feishu_im: Registered feishu_im_bot_image');
+}
+//# sourceMappingURL=index.js.map

package/src/tools/tat/im/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/tools/tat/im/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAsB;IAC1D,4BAA4B,CAAC,GAAG,CAAC,CAAC;IAClC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,2CAA2C,CAAC,CAAC;AACjE,CAAC"}

package/src/tools/tat/im/resource.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_im_bot_image 工具
+ *
+ * 以机器人身份下载飞书 IM 消息中的图片/文件资源到本地。
+ *
+ * 飞书 API:
+ *   - 下载资源: GET  /open-apis/im/v1/messages/:message_id/resources/:file_key
+ * 权限: im:resource
+ * 凭证: tenant_access_token
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuImBotImageTool(api: OpenClawPluginApi): void;
+//# sourceMappingURL=resource.d.ts.map

package/src/tools/tat/im/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../../../src/tools/tat/im/resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAmH7D,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,iBAAiB,QAyDlE"}

package/src/tools/tat/im/resource.js

@@ -0,0 +1,158 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_im_bot_image 工具
+ *
+ * 以机器人身份下载飞书 IM 消息中的图片/文件资源到本地。
+ *
+ * 飞书 API:
+ *   - 下载资源: GET  /open-apis/im/v1/messages/:message_id/resources/:file_key
+ * 权限: im:resource
+ * 凭证: tenant_access_token
+ */
+import { buildRandomTempFilePath } from 'openclaw/plugin-sdk';
+import { Type } from '@sinclair/typebox';
+import { json, createToolContext, formatLarkError } from '../../oapi/helpers';
+import * as fsPromises from 'node:fs/promises';
+import * as path from 'node:path';
+// ===========================================================================
+// Shared constants
+// ===========================================================================
+/** 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',
+    'audio/mpeg': '.mp3',
+    'audio/wav': '.wav',
+    'audio/ogg': '.ogg',
+    'audio/mp4': '.m4a',
+    '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',
+};
+// ===========================================================================
+// Shared helpers
+// ===========================================================================
+/**
+ * 从二进制响应中提取 Buffer、Content-Type。
+ * SDK 的二进制响应可能有 getReadableStream()，也可能直接是 Buffer 等格式。
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function extractBuffer(res) {
+    let chunks;
+    if (typeof res.getReadableStream === 'function') {
+        const stream = res.getReadableStream();
+        chunks = [];
+        for await (const chunk of stream) {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+    }
+    else if (Buffer.isBuffer(res)) {
+        chunks = [res];
+    }
+    else if (Buffer.isBuffer(res?.data)) {
+        chunks = [res.data];
+    }
+    else {
+        throw new Error('无法从响应中提取二进制数据');
+    }
+    const buffer = Buffer.concat(chunks);
+    const contentType = res.headers?.['content-type'] ?? '';
+    return { buffer, contentType };
+}
+/**
+ * 将 buffer 保存到临时文件，返回路径。
+ */
+async function saveToTempFile(buffer, contentType, prefix) {
+    const mimeType = contentType ? contentType.split(';')[0].trim() : '';
+    const mimeExt = mimeType ? MIME_TO_EXT[mimeType] : undefined;
+    const filePath = buildRandomTempFilePath({
+        prefix,
+        extension: mimeExt,
+    });
+    await fsPromises.mkdir(path.dirname(filePath), { recursive: true });
+    await fsPromises.writeFile(filePath, buffer);
+    return filePath;
+}
+// ===========================================================================
+// Download tool — feishu_im_bot_image
+// ===========================================================================
+const FeishuImBotImageSchema = Type.Object({
+    message_id: Type.String({
+        description: '消息 ID（om_xxx 格式），引用消息可从上下文中的 [message_id=om_xxx] 提取',
+    }),
+    file_key: Type.String({
+        description: '资源 Key，图片消息的 image_key（img_xxx）或文件消息的 file_key（file_xxx）',
+    }),
+    type: Type.Union([Type.Literal('image'), Type.Literal('file')], {
+        description: '资源类型：image（图片消息中的图片）、file（文件/音频/视频消息中的文件）',
+    }),
+});
+export function registerFeishuImBotImageTool(api) {
+    if (!api.config)
+        return;
+    const { getClient, log } = createToolContext(api, 'feishu_im_bot_image');
+    api.registerTool({
+        name: 'feishu_im_bot_image',
+        label: 'Feishu: IM Bot Image Download',
+        description: '【以机器人身份】下载飞书 IM 消息中的图片或文件资源到本地。' +
+            '\n\n适用场景：用户直接发送给机器人的消息、用户引用的消息、机器人收到的群聊消息中的图片/文件。' +
+            '即当前对话上下文中出现的 message_id 和 image_key/file_key，应使用本工具下载。' +
+            '\n引用消息的 message_id 可从上下文中的 [message_id=om_xxx] 提取，无需向用户询问。' +
+            '\n\n文件自动保存到 /tmp/openclaw/ 下，返回值中的 saved_path 为实际保存路径。',
+        parameters: FeishuImBotImageSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = getClient();
+                log.info(`download: message_id="${p.message_id}", file_key="${p.file_key}", type="${p.type}"`);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const res = await client.im.messageResource.get({
+                    path: {
+                        message_id: p.message_id,
+                        file_key: p.file_key,
+                    },
+                    params: { type: p.type },
+                });
+                const { buffer, contentType } = await extractBuffer(res);
+                log.info(`download: ${buffer.length} bytes, content-type=${contentType}`);
+                const savedPath = await saveToTempFile(buffer, contentType, 'bot-resource');
+                log.info(`download: saved to ${savedPath}`);
+                return json({
+                    message_id: p.message_id,
+                    file_key: p.file_key,
+                    type: p.type,
+                    size_bytes: buffer.length,
+                    content_type: contentType,
+                    saved_path: savedPath,
+                });
+            }
+            catch (err) {
+                log.error(`Error: ${formatLarkError(err)}`);
+                return json({ error: formatLarkError(err) });
+            }
+        },
+    }, { name: 'feishu_im_bot_image' });
+    api.logger.info?.('feishu_im_bot_image: Registered feishu_im_bot_image tool');
+}
+//# sourceMappingURL=resource.js.map

package/src/tools/tat/im/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../../../../src/tools/tat/im/resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,+BAA+B;AAC/B,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,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,MAAM;IACnB,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,iBAAiB;AACjB,8EAA8E;AAE9E;;;GAGG;AACH,8DAA8D;AAC9D,KAAK,UAAU,aAAa,CAAC,GAAQ;IAInC,IAAI,MAAgB,CAAC;IACrB,IAAI,OAAO,GAAG,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;QACvC,MAAM,GAAG,EAAE,CAAC;QACZ,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;SAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;SAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,WAAW,GAAW,GAAG,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAChE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,WAAmB,EAAE,MAAc;IAC/E,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE7D,MAAM,QAAQ,GAAG,uBAAuB,CAAC;QACvC,MAAM;QACN,SAAS,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,MAAM,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,sCAAsC;AACtC,8EAA8E;AAE9E,MAAM,sBAAsB,GAAG,IAAI,CAAC,MAAM,CAAC;IACzC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;QACtB,WAAW,EAAE,qDAAqD;KACnE,CAAC;IACF,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,0DAA0D;KACxE,CAAC;IACF,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE;QAC9D,WAAW,EAAE,2CAA2C;KACzD,CAAC;CACH,CAAC,CAAC;AAQH,MAAM,UAAU,4BAA4B,CAAC,GAAsB;IACjE,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,OAAO;IAExB,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,iBAAiB,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IAEzE,GAAG,CAAC,YAAY,CACd;QACE,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,+BAA+B;QACtC,WAAW,EACT,iCAAiC;YACjC,mDAAmD;YACnD,wDAAwD;YACxD,4DAA4D;YAC5D,wDAAwD;QAC1D,UAAU,EAAE,sBAAsB;QAClC,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAAe;YAChD,MAAM,CAAC,GAAG,MAAgC,CAAC;YAE3C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;gBAE3B,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,UAAU,gBAAgB,CAAC,CAAC,QAAQ,YAAY,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;gBAE/F,8DAA8D;gBAC9D,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC;oBACnD,IAAI,EAAE;wBACJ,UAAU,EAAE,CAAC,CAAC,UAAU;wBACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;qBACrB;oBACD,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;iBACzB,CAAC,CAAC;gBAEH,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;gBACzD,GAAG,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,wBAAwB,WAAW,EAAE,CAAC,CAAC;gBAE1E,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;gBAC5E,GAAG,CAAC,IAAI,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;gBAE5C,OAAO,IAAI,CAAC;oBACV,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,UAAU,EAAE,MAAM,CAAC,MAAM;oBACzB,YAAY,EAAE,WAAW;oBACzB,UAAU,EAAE,SAAS;iBACtB,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,KAAK,CAAC,UAAU,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC5C,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;KACF,EACD,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAChC,CAAC;IAEF,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,0DAA0D,CAAC,CAAC;AAChF,CAAC"}