cc-lark 0.1.1

package/dist/tools/im/message.js

@@ -0,0 +1,233 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_im_message tool - Send/reply IM messages with user identity.
+ *
+ * Actions: send, reply
+ *
+ * Uses Feishu IM API:
+ *   - send:  POST /open-apis/im/v1/messages?receive_id_type=...
+ *   - reply: POST /open-apis/im/v1/messages/:message_id/reply
+ *
+ * All calls use user access token (UAT) - requires OAuth authorization.
+ *
+ * Adapted from openclaw-lark for MCP Server architecture.
+ */
+import { z } from 'zod';
+import { getValidAccessToken, NeedAuthorizationError } from '../../core/uat-client.js';
+import { assertLarkOk } from '../../core/api-error.js';
+import { json, jsonError } from './helpers.js';
+import { logger } from '../../utils/logger.js';
+const log = logger('tools:im:message');
+// ---------------------------------------------------------------------------
+// Input schemas (raw shape for ZodRawShapeCompat)
+// ---------------------------------------------------------------------------
+const msgTypeEnum = z.enum([
+    'text',
+    'post',
+    'image',
+    'file',
+    'audio',
+    'media',
+    'interactive',
+    'share_chat',
+    'share_user',
+]);
+// We use separate tools for send and reply to avoid discriminated union issues
+const sendMessageSchema = {
+    action: z.literal('send').describe('Send a message'),
+    receive_id_type: z.enum(['open_id', 'chat_id']).describe('Recipient ID type: open_id (private chat, ou_xxx) or chat_id (group chat, oc_xxx)'),
+    receive_id: z.string().describe("Recipient ID corresponding to receive_id_type. Use 'ou_xxx' for open_id, 'oc_xxx' for chat_id"),
+    msg_type: msgTypeEnum.describe('Message type: text (plain text), post (rich text), image, file, interactive (card), share_chat (group card), share_user (user card), etc.'),
+    content: z.string().describe('Message content (JSON string), format depends on msg_type. ' +
+        'Examples: text -> \'{"text":"Hello"}\', ' +
+        'image -> \'{"image_key":"img_xxx"}\', ' +
+        'share_chat -> \'{"chat_id":"oc_xxx"}\', ' +
+        'post -> \'{"zh_cn":{"title":"Title","content":[[{"tag":"text","text":"Body"}]]}}\''),
+    uuid: z.string().optional().describe('Idempotent unique identifier. Same uuid will only send one message within 1 hour for deduplication.'),
+};
+const replyMessageSchema = {
+    action: z.literal('reply').describe('Reply to a message'),
+    message_id: z.string().describe('Message ID to reply to (om_xxx format)'),
+    msg_type: msgTypeEnum.describe('Message type: text (plain text), post (rich text), image, interactive (card), etc.'),
+    content: z.string().describe('Reply message content (JSON string), same format as send content'),
+    reply_in_thread: z.boolean().optional().describe('Whether to reply in thread. true = message appears in the thread, false (default) = appears in main chat flow'),
+    uuid: z.string().optional().describe('Idempotent unique identifier'),
+};
+// ---------------------------------------------------------------------------
+// Tool registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the feishu_im_message tool for sending messages.
+ */
+export function registerImMessageTool(registry) {
+    // Register send message tool
+    registry.register({
+        name: 'feishu_im_send_message',
+        description: [
+            'Send an IM message with user identity.',
+            '',
+            'Usage:',
+            '- Use receive_id_type=open_id for private chat (provide user open_id)',
+            '- Use receive_id_type=chat_id for group chat (provide chat_id)',
+            '',
+            'Message types:',
+            '- text: Plain text. Content: \'{"text":"message"}\'',
+            '- post: Rich text. Content: \'{"zh_cn":{"title":"Title","content":[[{"tag":"text","text":"text"}]]}}\'',
+            '- image: Image. Content: \'{"image_key":"img_xxx"}\'',
+            '- file: File. Content: \'{"file_key":"file_xxx"}\'',
+            '- interactive: Interactive card.',
+            '',
+            'IMPORTANT: This tool sends messages as the authenticated user.',
+            'Before calling, confirm with the user: 1) Who to send to, 2) Message content.',
+            '',
+            'Requires OAuth authorization (use feishu_oauth tool with action="authorize" first).',
+        ].join('\n'),
+        inputSchema: sendMessageSchema,
+        handler: async (args, context) => {
+            return handleSend(args, context);
+        },
+    });
+    // Register reply message tool
+    registry.register({
+        name: 'feishu_im_reply_message',
+        description: [
+            'Reply to an IM message with user identity.',
+            '',
+            'Usage:',
+            '- Use message_id (om_xxx) to specify which message to reply to',
+            '- Use reply_in_thread=true to create a thread reply',
+            '',
+            'Message types:',
+            '- text: Plain text. Content: \'{"text":"message"}\'',
+            '- post: Rich text. Content: \'{"zh_cn":{"title":"Title","content":[[{"tag":"text","text":"text"}]]}}\'',
+            '- image: Image. Content: \'{"image_key":"img_xxx"}\'',
+            '',
+            'Requires OAuth authorization (use feishu_oauth tool with action="authorize" first).',
+        ].join('\n'),
+        inputSchema: replyMessageSchema,
+        handler: async (args, context) => {
+            return handleReply(args, context);
+        },
+    });
+    log.debug('feishu_im_message tools registered');
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+async function handleSend(args, context) {
+    const p = args;
+    const { larkClient, config } = context;
+    if (!larkClient) {
+        return jsonError('LarkClient not initialized. Check FEISHU_APP_ID and FEISHU_APP_SECRET.');
+    }
+    const { appId, appSecret, brand } = config;
+    if (!appId || !appSecret) {
+        return jsonError('Missing FEISHU_APP_ID or FEISHU_APP_SECRET.');
+    }
+    // Get the first stored user token
+    const { listStoredTokens } = await import('../../core/token-store.js');
+    const tokens = await listStoredTokens(appId);
+    if (tokens.length === 0) {
+        return jsonError('No user authorization found. Please use the feishu_oauth tool with action="authorize" to authorize a user first.');
+    }
+    const userOpenId = tokens[0].userOpenId;
+    try {
+        const accessToken = await getValidAccessToken({
+            userOpenId,
+            appId,
+            appSecret,
+            domain: brand ?? 'feishu',
+        });
+        log.info('Sending message', {
+            receive_id_type: p.receive_id_type,
+            receive_id: p.receive_id,
+            msg_type: p.msg_type,
+        });
+        const Lark = await import('@larksuiteoapi/node-sdk');
+        const opts = Lark.withUserAccessToken(accessToken);
+        const res = await larkClient.sdk.im.v1.message.create({
+            params: { receive_id_type: p.receive_id_type },
+            data: {
+                receive_id: p.receive_id,
+                msg_type: p.msg_type,
+                content: p.content,
+                uuid: p.uuid,
+            },
+        }, opts);
+        assertLarkOk(res);
+        const data = res.data;
+        log.info('Message sent', { message_id: data?.message_id });
+        return json({
+            message_id: data?.message_id,
+            chat_id: data?.chat_id,
+            create_time: data?.create_time,
+        });
+    }
+    catch (err) {
+        if (err instanceof NeedAuthorizationError) {
+            return jsonError(`User authorization required or expired. Please use feishu_oauth tool with action="authorize" to re-authorize.`, { userOpenId });
+        }
+        log.error('Send message failed', { error: err instanceof Error ? err.message : String(err) });
+        return jsonError(err instanceof Error ? err.message : String(err));
+    }
+}
+async function handleReply(args, context) {
+    const p = args;
+    const { larkClient, config } = context;
+    if (!larkClient) {
+        return jsonError('LarkClient not initialized. Check FEISHU_APP_ID or FEISHU_APP_SECRET.');
+    }
+    const { appId, appSecret, brand } = config;
+    if (!appId || !appSecret) {
+        return jsonError('Missing FEISHU_APP_ID or FEISHU_APP_SECRET.');
+    }
+    // Get the first stored user token
+    const { listStoredTokens } = await import('../../core/token-store.js');
+    const tokens = await listStoredTokens(appId);
+    if (tokens.length === 0) {
+        return jsonError('No user authorization found. Please use the feishu_oauth tool with action="authorize" to authorize a user first.');
+    }
+    const userOpenId = tokens[0].userOpenId;
+    try {
+        const accessToken = await getValidAccessToken({
+            userOpenId,
+            appId,
+            appSecret,
+            domain: brand ?? 'feishu',
+        });
+        log.info('Replying to message', {
+            message_id: p.message_id,
+            msg_type: p.msg_type,
+            reply_in_thread: p.reply_in_thread ?? false,
+        });
+        const Lark = await import('@larksuiteoapi/node-sdk');
+        const opts = Lark.withUserAccessToken(accessToken);
+        const res = await larkClient.sdk.im.v1.message.reply({
+            path: { message_id: p.message_id },
+            data: {
+                content: p.content,
+                msg_type: p.msg_type,
+                reply_in_thread: p.reply_in_thread,
+                uuid: p.uuid,
+            },
+        }, opts);
+        assertLarkOk(res);
+        const data = res.data;
+        log.info('Reply sent', { message_id: data?.message_id });
+        return json({
+            message_id: data?.message_id,
+            chat_id: data?.chat_id,
+            create_time: data?.create_time,
+        });
+    }
+    catch (err) {
+        if (err instanceof NeedAuthorizationError) {
+            return jsonError(`User authorization required or expired. Please use feishu_oauth tool with action="authorize" to re-authorize.`, { userOpenId });
+        }
+        log.error('Reply message failed', { error: err instanceof Error ? err.message : String(err) });
+        return jsonError(err instanceof Error ? err.message : String(err));
+    }
+}
+//# sourceMappingURL=message.js.map

package/dist/tools/im/message.js.map

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

package/dist/tools/im/resource.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_im_fetch_resource tool - Download IM message attachments with user identity.
+ *
+ * Uses Feishu API:
+ *   - im.v1.messageResource.get: GET /open-apis/im/v1/messages/:message_id/resources/:file_key
+ *
+ * All calls use user access token (UAT) - requires OAuth authorization.
+ *
+ * Adapted from openclaw-lark for MCP Server architecture.
+ */
+import type { ToolRegistry } from '../index.js';
+/**
+ * Register the feishu_im_fetch_resource tool.
+ */
+export declare function registerImFetchResourceTool(registry: ToolRegistry): void;
+//# sourceMappingURL=resource.d.ts.map

package/dist/tools/im/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../src/tools/im/resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA8EhD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CA4HxE"}

package/dist/tools/im/resource.js

@@ -0,0 +1,185 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_im_fetch_resource tool - Download IM message attachments with user identity.
+ *
+ * Uses Feishu API:
+ *   - im.v1.messageResource.get: GET /open-apis/im/v1/messages/:message_id/resources/:file_key
+ *
+ * All calls use user access token (UAT) - requires OAuth authorization.
+ *
+ * Adapted from openclaw-lark for MCP Server architecture.
+ */
+import { z } from 'zod';
+import { writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { getValidAccessToken, NeedAuthorizationError } from '../../core/uat-client.js';
+import { json, jsonError } from './helpers.js';
+import { logger } from '../../utils/logger.js';
+const log = logger('tools:im:resource');
+// ---------------------------------------------------------------------------
+// MIME type mapping
+// ---------------------------------------------------------------------------
+const MIME_TO_EXT = {
+    // Images
+    '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',
+    // Videos
+    'video/mp4': '.mp4',
+    'video/mpeg': '.mpeg',
+    'video/quicktime': '.mov',
+    'video/x-msvideo': '.avi',
+    'video/webm': '.webm',
+    // Audio
+    'audio/mpeg': '.mp3',
+    'audio/wav': '.wav',
+    'audio/ogg': '.ogg',
+    'audio/mp4': '.m4a',
+    // Documents
+    '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',
+    // Others
+    'application/zip': '.zip',
+    'application/x-rar-compressed': '.rar',
+    'text/plain': '.txt',
+    'application/json': '.json',
+};
+// ---------------------------------------------------------------------------
+// Input schema (raw shape for ZodRawShapeCompat)
+// ---------------------------------------------------------------------------
+const fetchResourceShape = {
+    message_id: z.string().describe('Message ID (om_xxx format), obtained from message events or message list'),
+    file_key: z.string().describe('Resource key from message body. For images use image_key (img_xxx), for files use file_key (file_xxx)'),
+    type: z.enum(['image', 'file']).describe('Resource type: image (image in image message) or file (file/audio/video in file message)'),
+};
+// ---------------------------------------------------------------------------
+// Temp file helper
+// ---------------------------------------------------------------------------
+function buildRandomTempFilePath(options = {}) {
+    const { prefix = 'resource', extension } = options;
+    const randomId = Math.random().toString(36).substring(2, 10);
+    const timestamp = Date.now();
+    const baseName = `${prefix}-${timestamp}-${randomId}`;
+    return join(tmpdir(), 'cc-lark', extension ? `${baseName}${extension}` : baseName);
+}
+// ---------------------------------------------------------------------------
+// Tool registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the feishu_im_fetch_resource tool.
+ */
+export function registerImFetchResourceTool(registry) {
+    registry.register({
+        name: 'feishu_im_fetch_resource',
+        description: [
+            'Download IM message file/image attachments to local file with user identity.',
+            '',
+            'Usage:',
+            '- Use message_id from message list or search results',
+            '- Use file_key from message content (image_key for images, file_key for files)',
+            '- Use type="image" for images, type="file" for files/audio/video',
+            '',
+            'The downloaded file is saved to the system temp directory.',
+            'Returns: message_id, file_key, type, size_bytes, content_type, saved_path',
+            '',
+            'Limitations:',
+            '- File size limit: 100MB',
+            '- Does not support stickers, merge-forward messages, or card resources',
+            '',
+            'Requires OAuth authorization (use feishu_oauth tool with action="authorize" first).',
+        ].join('\n'),
+        inputSchema: fetchResourceShape,
+        handler: async (args, context) => {
+            const p = args;
+            if (!context.larkClient) {
+                return jsonError('LarkClient not initialized. Check FEISHU_APP_ID and FEISHU_APP_SECRET.');
+            }
+            const { appId, appSecret, brand } = context.config;
+            if (!appId || !appSecret) {
+                return jsonError('Missing FEISHU_APP_ID or FEISHU_APP_SECRET.');
+            }
+            // Get the first stored user token
+            const { listStoredTokens } = await import('../../core/token-store.js');
+            const tokens = await listStoredTokens(appId);
+            if (tokens.length === 0) {
+                return jsonError('No user authorization found. Please use the feishu_oauth tool with action="authorize" to authorize a user first.');
+            }
+            const userOpenId = tokens[0].userOpenId;
+            try {
+                const accessToken = await getValidAccessToken({
+                    userOpenId,
+                    appId,
+                    appSecret,
+                    domain: brand ?? 'feishu',
+                });
+                log.info('fetch_resource: downloading', {
+                    message_id: p.message_id,
+                    file_key: p.file_key,
+                    type: p.type,
+                });
+                const Lark = await import('@larksuiteoapi/node-sdk');
+                const opts = Lark.withUserAccessToken(accessToken);
+                // Download the resource
+                const res = await context.larkClient.sdk.im.v1.messageResource.get({
+                    params: { type: p.type },
+                    path: { message_id: p.message_id, file_key: p.file_key },
+                }, opts);
+                // Response is a binary stream, use getReadableStream()
+                const stream = res.getReadableStream();
+                const chunks = [];
+                for await (const chunk of stream) {
+                    chunks.push(chunk);
+                }
+                const buffer = Buffer.concat(chunks);
+                log.info(`fetch_resource: downloaded ${buffer.length} bytes`);
+                // Get Content-Type from response headers
+                const contentType = res.headers?.['content-type'] || '';
+                log.info(`fetch_resource: content-type=${contentType}`);
+                // Infer extension from Content-Type
+                const mimeType = contentType ? contentType.split(';')[0].trim() : '';
+                const mimeExt = mimeType ? MIME_TO_EXT[mimeType] : undefined;
+                const finalPath = buildRandomTempFilePath({
+                    prefix: 'im-resource',
+                    extension: mimeExt,
+                });
+                log.info(`fetch_resource: saving to ${finalPath}`);
+                // Ensure parent directory exists
+                await mkdir(dirname(finalPath), { recursive: true });
+                // Write file
+                await writeFile(finalPath, buffer);
+                log.info(`fetch_resource: saved to ${finalPath}`);
+                return json({
+                    message_id: p.message_id,
+                    file_key: p.file_key,
+                    type: p.type,
+                    size_bytes: buffer.length,
+                    content_type: contentType,
+                    saved_path: finalPath,
+                });
+            }
+            catch (err) {
+                if (err instanceof NeedAuthorizationError) {
+                    return jsonError(`User authorization required or expired. Please use feishu_oauth tool with action="authorize" to re-authorize.`, { userOpenId });
+                }
+                log.error('fetch_resource failed', { error: err instanceof Error ? err.message : String(err) });
+                return jsonError(err instanceof Error ? err.message : String(err));
+            }
+        },
+    });
+    log.debug('feishu_im_fetch_resource tool registered');
+}
+//# sourceMappingURL=resource.js.map

package/dist/tools/im/resource.js.map

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

package/dist/tools/im/time-utils.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Time utilities for IM tools.
+ *
+ * Provides time range parsing and ISO 8601 conversion utilities.
+ * Adapted from openclaw-lark for MCP Server architecture.
+ */
+/** Convert Unix seconds (number) to ISO 8601 Beijing time */
+export declare function secondsToDateTime(seconds: number): string;
+/** Convert Unix seconds (string) to ISO 8601 Beijing time */
+export declare function secondsStringToDateTime(seconds: string): string;
+/** Convert Unix milliseconds (number) to ISO 8601 Beijing time */
+export declare function millisToDateTime(millis: number): string;
+/** Convert Unix milliseconds (string) to ISO 8601 Beijing time */
+export declare function millisStringToDateTime(millis: string): string;
+/** Convert ISO 8601 to Unix seconds (number) */
+export declare function dateTimeToSeconds(datetime: string): number;
+/** Convert ISO 8601 to Unix seconds (string) */
+export declare function dateTimeToSecondsString(datetime: string): string;
+/** Convert ISO 8601 to Unix milliseconds (number) */
+export declare function dateTimeToMillis(datetime: string): number;
+/** ISO 8601 time range */
+export interface TimeRange {
+    start: string;
+    end: string;
+}
+/** Unix timestamp time range (seconds) */
+export interface TimeRangeSeconds {
+    start: string;
+    end: string;
+}
+/**
+ * Parse a time range identifier to ISO 8601 string pair.
+ *
+ * Supported formats:
+ * - `today` / `yesterday` / `day_before_yesterday`
+ * - `this_week` / `last_week` / `this_month` / `last_month`
+ * - `last_{N}_{unit}` — unit: minutes / hours / days
+ *
+ * All calculations are based on Beijing time (UTC+8).
+ */
+export declare function parseTimeRange(input: string): TimeRange;
+/**
+ * Parse a time range identifier to Unix seconds string pair.
+ * This is for SDK API calls that require Unix timestamps.
+ */
+export declare function parseTimeRangeToSeconds(input: string): TimeRangeSeconds;
+/**
+ * Parse a time string to Unix timestamp (seconds).
+ *
+ * Supports:
+ * 1. ISO 8601 / RFC 3339 with timezone: "2024-01-01T00:00:00+08:00"
+ * 2. Formats without timezone (defaults to Beijing time UTC+8):
+ *    - "2026-02-25 14:30"
+ *    - "2026-02-25 14:30:00"
+ *    - "2026-02-25T14:30:00"
+ *
+ * Returns null if parsing fails.
+ */
+export declare function parseTimeToTimestamp(input: string): string | null;
+/**
+ * Convert a Unix timestamp (seconds or milliseconds) to ISO 8601 string
+ * in Asia/Shanghai timezone.
+ *
+ * Auto-detects seconds vs milliseconds based on magnitude.
+ */
+export declare function unixTimestampToISO8601(raw: string | number | undefined): string | null;
+//# sourceMappingURL=time-utils.d.ts.map

package/dist/tools/im/time-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-utils.d.ts","sourceRoot":"","sources":["../../../src/tools/im/time-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwBH,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,6DAA6D;AAC7D,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D;AAMD,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7D;AAMD,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAED,gDAAgD;AAChD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQzD;AAMD,0BAA0B;AAC1B,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CA6FvD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAMvE;AA6CD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0CjE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAqBtF"}