moltbot-feishu 0.1.0

package/dist/src/group-filter.js

@@ -0,0 +1,44 @@
+/**
+ * Smart group chat reply filter.
+ *
+ * In group chats, only respond when the message looks like a real
+ * question, request, or direct address — avoids spamming.
+ */
+/** Default bot name patterns for address detection. */
+const DEFAULT_BOT_NAMES = ["clawdbot", "moltbot", "bot", "助手", "智能体"];
+/**
+ * Determine whether the bot should respond to a group message.
+ *
+ * @param text - Message text (after stripping @mention placeholders)
+ * @param mentions - Array of mention objects from the Feishu event
+ * @param botNames - Custom bot name list for address detection
+ */
+export function shouldRespondInGroup(text, mentions, botNames) {
+    // Always respond to @-mentions
+    if (mentions.length > 0)
+        return true;
+    const t = text.toLowerCase();
+    // Ends with question mark
+    if (/[？?]$/.test(text))
+        return true;
+    // English question words
+    if (/\b(why|how|what|when|where|who|help)\b/.test(t))
+        return true;
+    // Chinese request verbs
+    const verbs = [
+        "帮", "麻烦", "请", "能否", "可以", "解释", "看看",
+        "排查", "分析", "总结", "写", "改", "修", "查", "对比", "翻译",
+    ];
+    if (verbs.some((k) => text.includes(k)))
+        return true;
+    // Direct address by bot name
+    const names = botNames?.length ? botNames : DEFAULT_BOT_NAMES;
+    const namePattern = new RegExp(`^(${names.map(escapeRegex).join("|")})[\\s,:，：]`, "i");
+    if (namePattern.test(text))
+        return true;
+    return false;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=group-filter.js.map

package/dist/src/group-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-filter.js","sourceRoot":"","sources":["../../src/group-filter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uDAAuD;AACvD,MAAM,iBAAiB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,QAAmB,EACnB,QAAmB;IAEnB,+BAA+B;IAC/B,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAE7B,0BAA0B;IAC1B,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,yBAAyB;IACzB,IAAI,wCAAwC,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAElE,wBAAwB;IACxB,MAAM,KAAK,GAAG;QACZ,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;QACtC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI;KACjD,CAAC;IACF,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAErD,6BAA6B;IAC7B,MAAM,KAAK,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAC9D,MAAM,WAAW,GAAG,IAAI,MAAM,CAC5B,KAAK,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EACjD,GAAG,CACJ,CAAC;IACF,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAExC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC"}

package/dist/src/media.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Media upload/download helpers for Feishu.
+ */
+import type * as Lark from "@larksuiteoapi/node-sdk";
+import type { FeishuMediaType } from "./types.js";
+/** Detect media type from URL or mime type. */
+export declare function getMediaType(url: string, mimeType?: string): FeishuMediaType;
+/** Extract file extension from a URL. */
+export declare function getFileExtension(url: string): string;
+/** Download a URL to a temporary file. Returns path and cleanup flag. */
+export declare function downloadToTempFile(url: string): Promise<{
+    path: string;
+    isTemp: boolean;
+}>;
+/** Upload an image to Feishu and return the image_key. */
+export declare function uploadImage(client: InstanceType<typeof Lark.Client>, filePath: string): Promise<string>;
+/** Upload a file to Feishu and return the file_key. */
+export declare function uploadFile(client: InstanceType<typeof Lark.Client>, filePath: string, filename: string, fileType?: "stream" | "opus" | "mp4" | "pdf" | "doc" | "xls" | "ppt"): Promise<string>;
+/** Clean up a temp file. */
+export declare function cleanupTemp(filePath: string, isTemp: boolean): void;
+//# sourceMappingURL=media.d.ts.map

package/dist/src/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/media.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,KAAK,KAAK,IAAI,MAAM,yBAAyB,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAc5E;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,yEAAyE;AACzE,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAiD5C;AAED,0DAA0D;AAC1D,wBAAsB,WAAW,CAC/B,MAAM,EAAE,YAAY,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,EACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,uDAAuD;AACvD,wBAAsB,UAAU,CAC9B,MAAM,EAAE,YAAY,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,EACxC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAgB,GAC7E,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,4BAA4B;AAC5B,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAInE"}

package/dist/src/media.js

@@ -0,0 +1,133 @@
+/**
+ * Media upload/download helpers for Feishu.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import https from "node:https";
+import http from "node:http";
+/** Detect media type from URL or mime type. */
+export function getMediaType(url, mimeType) {
+    const urlLower = url.toLowerCase();
+    if (/\.(jpg|jpeg|png|gif|webp|bmp)(\?|$)/i.test(urlLower))
+        return "image";
+    if (/\.(mp4|mov|avi|mkv|webm)(\?|$)/i.test(urlLower))
+        return "video";
+    if (/\.(mp3|wav|ogg|m4a|aac)(\?|$)/i.test(urlLower))
+        return "audio";
+    if (mimeType) {
+        if (mimeType.startsWith("image/"))
+            return "image";
+        if (mimeType.startsWith("video/"))
+            return "video";
+        if (mimeType.startsWith("audio/"))
+            return "audio";
+    }
+    return "file";
+}
+/** Extract file extension from a URL. */
+export function getFileExtension(url) {
+    const match = url.match(/\.([a-zA-Z0-9]+)(\?|$)/);
+    return match ? match[1].toLowerCase() : "bin";
+}
+/** Download a URL to a temporary file. Returns path and cleanup flag. */
+export async function downloadToTempFile(url) {
+    // Local file reference
+    if (url.startsWith("/") || url.startsWith("file://")) {
+        const filePath = url.replace("file://", "");
+        return { path: filePath, isTemp: false };
+    }
+    const extension = getFileExtension(url);
+    const tempPath = path.join(os.tmpdir(), `feishu_${Date.now()}.${extension}`);
+    return new Promise((resolve, reject) => {
+        const protocol = url.startsWith("https") ? https : http;
+        const file = fs.createWriteStream(tempPath);
+        protocol
+            .get(url, (response) => {
+            if (response.statusCode === 301 || response.statusCode === 302) {
+                file.close();
+                try {
+                    fs.unlinkSync(tempPath);
+                }
+                catch { /* ignore */ }
+                const location = response.headers.location;
+                if (!location) {
+                    reject(new Error("Redirect without location header"));
+                    return;
+                }
+                downloadToTempFile(location).then(resolve).catch(reject);
+                return;
+            }
+            if (response.statusCode !== 200) {
+                file.close();
+                try {
+                    fs.unlinkSync(tempPath);
+                }
+                catch { /* ignore */ }
+                reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+                return;
+            }
+            response.pipe(file);
+            file.on("finish", () => {
+                file.close();
+                resolve({ path: tempPath, isTemp: true });
+            });
+            file.on("error", (err) => {
+                try {
+                    fs.unlinkSync(tempPath);
+                }
+                catch { /* ignore */ }
+                reject(err);
+            });
+        })
+            .on("error", (err) => {
+            file.close();
+            try {
+                fs.unlinkSync(tempPath);
+            }
+            catch { /* ignore */ }
+            reject(err);
+        });
+    });
+}
+/** Upload an image to Feishu and return the image_key. */
+export async function uploadImage(client, filePath) {
+    const response = await client.im.image.create({
+        data: {
+            image_type: "message",
+            image: fs.createReadStream(filePath),
+        },
+    });
+    const imageKey = response.image_key ??
+        response.data?.image_key;
+    if (!imageKey) {
+        throw new Error(`Upload image failed: ${JSON.stringify(response)}`);
+    }
+    return imageKey;
+}
+/** Upload a file to Feishu and return the file_key. */
+export async function uploadFile(client, filePath, filename, fileType = "stream") {
+    const response = await client.im.file.create({
+        data: {
+            file_type: fileType,
+            file_name: filename,
+            file: fs.createReadStream(filePath),
+        },
+    });
+    const fileKey = response.file_key ??
+        response.data?.file_key;
+    if (!fileKey) {
+        throw new Error(`Upload file failed: ${JSON.stringify(response)}`);
+    }
+    return fileKey;
+}
+/** Clean up a temp file. */
+export function cleanupTemp(filePath, isTemp) {
+    if (isTemp) {
+        try {
+            fs.unlinkSync(filePath);
+        }
+        catch { /* ignore */ }
+    }
+}
+//# sourceMappingURL=media.js.map

package/dist/src/media.js.map

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

package/dist/src/onboarding.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Feishu onboarding wizard adapter.
+ */
+import type { ClawdbotConfig } from "clawdbot/plugin-sdk";
+/** WizardPrompter interface for onboarding. */
+interface WizardPrompter {
+    note(message: string, title?: string): Promise<void>;
+    text(opts: {
+        message: string;
+        placeholder?: string;
+        initialValue?: string;
+        validate?: (value: unknown) => string | undefined;
+    }): Promise<string>;
+    select<T>(opts: {
+        message: string;
+        options: Array<{
+            value: T;
+            label: string;
+        }>;
+        initialValue?: T;
+    }): Promise<T>;
+    confirm?(opts: {
+        message: string;
+        initialValue?: boolean;
+    }): Promise<boolean>;
+}
+/** Feishu onboarding adapter for the channel. */
+export declare const feishuOnboardingAdapter: {
+    /** Check if Feishu channel is configured. */
+    configuredCheck: (cfg: ClawdbotConfig) => boolean;
+    /** Set the DM policy. */
+    setDmPolicy: (cfg: ClawdbotConfig, policy: "pairing" | "allowlist" | "open" | "disabled") => ClawdbotConfig;
+    /** Prompt user for allowFrom configuration. */
+    promptAllowFrom: (params: {
+        cfg: ClawdbotConfig;
+        prompter: WizardPrompter;
+        accountId: string;
+    }) => Promise<ClawdbotConfig>;
+    /** Show setup help notes. */
+    noteSetupHelp: (prompter: WizardPrompter) => Promise<void>;
+    /** Run the full setup wizard. */
+    runSetupWizard: (params: {
+        cfg: ClawdbotConfig;
+        prompter: WizardPrompter;
+        accountOverrides?: Record<string, string | undefined>;
+        shouldPromptAccountIds?: boolean;
+        forceAllowFrom?: boolean;
+    }) => Promise<ClawdbotConfig>;
+};
+export {};
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/src/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/onboarding.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,cAAc,EACf,MAAM,qBAAqB,CAAC;AAoD7B,+CAA+C;AAC/C,UAAU,cAAc;IACtB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,IAAI,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;KACnD,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,CAAC,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC5C,YAAY,CAAC,EAAE,CAAC,CAAC;KAClB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACf,OAAO,CAAC,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E;AAmED,iDAAiD;AACjD,eAAO,MAAM,uBAAuB;IAClC,6CAA6C;2BACtB,cAAc,KAAG,OAAO;IAM/C,yBAAyB;uBACN,cAAc,UAAU,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,KAAG,cAAc;IAIzG,+CAA+C;8BACf;QAC9B,GAAG,EAAE,cAAc,CAAC;QACpB,QAAQ,EAAE,cAAc,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;KACnB,KAAG,OAAO,CAAC,cAAc,CAAC;IAI3B,6BAA6B;8BACG,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,iCAAiC;6BACF;QAC7B,GAAG,EAAE,cAAc,CAAC;QACpB,QAAQ,EAAE,cAAc,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;QACtD,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,KAAG,OAAO,CAAC,cAAc,CAAC;CAsH5B,CAAC"}

package/dist/src/onboarding.js

@@ -0,0 +1,213 @@
+/**
+ * Feishu onboarding wizard adapter.
+ */
+import { addWildcardAllowFrom, DEFAULT_ACCOUNT_ID, normalizeAccountId, } from "clawdbot/plugin-sdk";
+import { listFeishuAccountIds, resolveDefaultFeishuAccountId, resolveFeishuAccount, } from "./accounts.js";
+const channel = "feishu";
+function setFeishuDmPolicy(cfg, dmPolicy) {
+    const feishuCfg = cfg.channels?.feishu ?? {};
+    const existingAllowFrom = Array.isArray(feishuCfg.allowFrom) ? feishuCfg.allowFrom : [];
+    const allowFrom = dmPolicy === "open" ? addWildcardAllowFrom(existingAllowFrom) : undefined;
+    return {
+        ...cfg,
+        channels: {
+            ...(cfg.channels ?? {}),
+            feishu: {
+                ...feishuCfg,
+                dmPolicy,
+                ...(allowFrom ? { allowFrom } : {}),
+            },
+        },
+    };
+}
+async function noteFeishuSetupHelp(prompter) {
+    await prompter.note([
+        "1) Go to https://open.feishu.cn/app → Create self-built app",
+        "2) Add Bot capability to the app",
+        '3) Enable permissions: im:message, im:message.group_at_msg, im:message.p2p_msg',
+        '4) Events: add im.message.receive_v1, set delivery to "WebSocket long-connection"',
+        "5) Publish the app (create version → request approval)",
+        "6) Note the App ID (cli_xxx) and App Secret",
+        "",
+        "Docs: https://open.feishu.cn/document/home/index",
+    ].join("\n"), "Feishu Bot Setup");
+}
+async function promptFeishuAllowFrom(params) {
+    const { cfg, prompter, accountId } = params;
+    const resolved = resolveFeishuAccount({ cfg, accountId });
+    const existingAllowFrom = resolved.config.allowFrom ?? [];
+    const entry = await prompter.text({
+        message: "Feishu allowFrom (open_id or union_id)",
+        placeholder: "ou_xxxxxxxxxx",
+        initialValue: existingAllowFrom[0] ? String(existingAllowFrom[0]) : undefined,
+        validate: (value) => {
+            const raw = String(value ?? "").trim();
+            if (!raw)
+                return "Required";
+            return undefined;
+        },
+    });
+    const normalized = String(entry).trim();
+    const merged = [
+        ...existingAllowFrom.map((item) => String(item).trim()).filter(Boolean),
+        normalized,
+    ];
+    const unique = [...new Set(merged)];
+    const feishuCfg = (cfg.channels?.feishu ?? {});
+    const accounts = (feishuCfg.accounts ?? {});
+    if (accountId === DEFAULT_ACCOUNT_ID) {
+        return {
+            ...cfg,
+            channels: {
+                ...(cfg.channels ?? {}),
+                feishu: {
+                    ...feishuCfg,
+                    enabled: true,
+                    dmPolicy: "allowlist",
+                    allowFrom: unique,
+                },
+            },
+        };
+    }
+    const accountCfg = (accounts[accountId] ?? {});
+    return {
+        ...cfg,
+        channels: {
+            ...(cfg.channels ?? {}),
+            feishu: {
+                ...feishuCfg,
+                enabled: true,
+                accounts: {
+                    ...accounts,
+                    [accountId]: {
+                        ...accountCfg,
+                        enabled: accountCfg.enabled ?? true,
+                        dmPolicy: "allowlist",
+                        allowFrom: unique,
+                    },
+                },
+            },
+        },
+    };
+}
+/** Feishu onboarding adapter for the channel. */
+export const feishuOnboardingAdapter = {
+    /** Check if Feishu channel is configured. */
+    configuredCheck: (cfg) => {
+        return listFeishuAccountIds(cfg).some((accountId) => Boolean(resolveFeishuAccount({ cfg, accountId }).appId));
+    },
+    /** Set the DM policy. */
+    setDmPolicy: (cfg, policy) => {
+        return setFeishuDmPolicy(cfg, policy);
+    },
+    /** Prompt user for allowFrom configuration. */
+    promptAllowFrom: async (params) => {
+        return promptFeishuAllowFrom(params);
+    },
+    /** Show setup help notes. */
+    noteSetupHelp: async (prompter) => {
+        return noteFeishuSetupHelp(prompter);
+    },
+    /** Run the full setup wizard. */
+    runSetupWizard: async (params) => {
+        const { cfg, prompter, accountOverrides, shouldPromptAccountIds, forceAllowFrom } = params;
+        const feishuOverride = accountOverrides?.feishu?.trim();
+        const defaultAccountId = resolveDefaultFeishuAccountId(cfg);
+        let feishuAccountId = feishuOverride
+            ? normalizeAccountId(feishuOverride)
+            : defaultAccountId;
+        if (shouldPromptAccountIds && !feishuOverride) {
+            const accountIds = listFeishuAccountIds(cfg);
+            const options = accountIds.map((id) => ({ value: id, label: id }));
+            feishuAccountId = await prompter.select({
+                message: "Select Feishu account",
+                options,
+                initialValue: feishuAccountId,
+            });
+        }
+        let next = cfg;
+        const resolvedAccount = resolveFeishuAccount({ cfg: next, accountId: feishuAccountId });
+        const accountConfigured = Boolean(resolvedAccount.appId);
+        if (!accountConfigured) {
+            await noteFeishuSetupHelp(prompter);
+        }
+        const hasConfigCredentials = Boolean(resolvedAccount.config.appId && resolvedAccount.config.appSecret);
+        let appId = null;
+        let appSecret = null;
+        if (hasConfigCredentials && prompter.confirm) {
+            const keep = await prompter.confirm({
+                message: "Feishu credentials already configured. Keep them?",
+                initialValue: true,
+            });
+            if (!keep) {
+                appId = String(await prompter.text({
+                    message: "Enter Feishu App ID (cli_xxx)",
+                    validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
+                })).trim();
+                appSecret = String(await prompter.text({
+                    message: "Enter Feishu App Secret",
+                    validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
+                })).trim();
+            }
+        }
+        else if (!hasConfigCredentials) {
+            appId = String(await prompter.text({
+                message: "Enter Feishu App ID (cli_xxx)",
+                validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
+            })).trim();
+            appSecret = String(await prompter.text({
+                message: "Enter Feishu App Secret",
+                validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
+            })).trim();
+        }
+        const feishuCfg2 = (next.channels?.feishu ?? {});
+        const accounts2 = (feishuCfg2.accounts ?? {});
+        if (appId && appSecret) {
+            if (feishuAccountId === DEFAULT_ACCOUNT_ID) {
+                next = {
+                    ...next,
+                    channels: {
+                        ...(next.channels ?? {}),
+                        feishu: {
+                            ...feishuCfg2,
+                            enabled: true,
+                            appId,
+                            appSecret,
+                        },
+                    },
+                };
+            }
+            else {
+                const accountCfg2 = (accounts2[feishuAccountId] ?? {});
+                next = {
+                    ...next,
+                    channels: {
+                        ...(next.channels ?? {}),
+                        feishu: {
+                            ...feishuCfg2,
+                            enabled: true,
+                            accounts: {
+                                ...accounts2,
+                                [feishuAccountId]: {
+                                    ...accountCfg2,
+                                    enabled: true,
+                                    appId,
+                                    appSecret,
+                                },
+                            },
+                        },
+                    },
+                };
+            }
+        }
+        if (forceAllowFrom) {
+            next = await promptFeishuAllowFrom({
+                cfg: next,
+                prompter,
+                accountId: feishuAccountId,
+            });
+        }
+        return next;
+    },
+};
+//# sourceMappingURL=onboarding.js.map

package/dist/src/onboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../src/onboarding.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,MAAM,OAAO,GAAG,QAAiB,CAAC;AAElC,SAAS,iBAAiB,CACxB,GAAmB,EACnB,QAAuD;IAEvD,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;IAC7C,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,MAAM,SAAS,GACb,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,OAAO;QACL,GAAG,GAAG;QACN,QAAQ,EAAE;YACR,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;YACvB,MAAM,EAAE;gBACN,GAAG,SAAS;gBACZ,QAAQ;gBACR,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpC;SACF;KACgB,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,QAAwB;IACzD,MAAM,QAAQ,CAAC,IAAI,CACjB;QACE,6DAA6D;QAC7D,kCAAkC;QAClC,gFAAgF;QAChF,mFAAmF;QACnF,wDAAwD;QACxD,6CAA6C;QAC7C,EAAE;QACF,kDAAkD;KACnD,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ,kBAAkB,CACnB,CAAC;AACJ,CAAC;AAmBD,KAAK,UAAU,qBAAqB,CAAC,MAIpC;IACC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC5C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1D,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC;QAChC,OAAO,EAAE,wCAAwC;QACjD,WAAW,EAAE,eAAe;QAC5B,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7E,QAAQ,EAAE,CAAC,KAAc,EAAE,EAAE;YAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC,GAAG;gBAAE,OAAO,UAAU,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG;QACb,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAChF,UAAU;KACX,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAA4B,CAAC;IAC1E,MAAM,QAAQ,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAA4B,CAAC;IAEvE,IAAI,SAAS,KAAK,kBAAkB,EAAE,CAAC;QACrC,OAAO;YACL,GAAG,GAAG;YACN,QAAQ,EAAE;gBACR,GAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAA6B;gBACpD,MAAM,EAAE;oBACN,GAAG,SAAS;oBACZ,OAAO,EAAE,IAAI;oBACb,QAAQ,EAAE,WAAW;oBACrB,SAAS,EAAE,MAAM;iBAClB;aACF;SACgB,CAAC;IACtB,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAA4B,CAAC;IAC1E,OAAO;QACL,GAAG,GAAG;QACN,QAAQ,EAAE;YACR,GAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAA6B;YACpD,MAAM,EAAE;gBACN,GAAG,SAAS;gBACZ,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE;oBACR,GAAG,QAAQ;oBACX,CAAC,SAAS,CAAC,EAAE;wBACX,GAAG,UAAU;wBACb,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,IAAI;wBACnC,QAAQ,EAAE,WAAW;wBACrB,SAAS,EAAE,MAAM;qBAClB;iBACF;aACF;SACF;KACgB,CAAC;AACtB,CAAC;AAED,iDAAiD;AACjD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,6CAA6C;IAC7C,eAAe,EAAE,CAAC,GAAmB,EAAW,EAAE;QAChD,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAClD,OAAO,CAAC,oBAAoB,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CACxD,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,WAAW,EAAE,CAAC,GAAmB,EAAE,MAAqD,EAAkB,EAAE;QAC1G,OAAO,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,+CAA+C;IAC/C,eAAe,EAAE,KAAK,EAAE,MAIvB,EAA2B,EAAE;QAC5B,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,6BAA6B;IAC7B,aAAa,EAAE,KAAK,EAAE,QAAwB,EAAiB,EAAE;QAC/D,OAAO,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,iCAAiC;IACjC,cAAc,EAAE,KAAK,EAAE,MAMtB,EAA2B,EAAE;QAC5B,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;QAC3F,MAAM,cAAc,GAAG,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACxD,MAAM,gBAAgB,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;QAC5D,IAAI,eAAe,GAAG,cAAc;YAClC,CAAC,CAAC,kBAAkB,CAAC,cAAc,CAAC;YACpC,CAAC,CAAC,gBAAgB,CAAC;QAErB,IAAI,sBAAsB,IAAI,CAAC,cAAc,EAAE,CAAC;YAC9C,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;YACnE,eAAe,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;gBACtC,OAAO,EAAE,uBAAuB;gBAChC,OAAO;gBACP,YAAY,EAAE,eAAe;aAC9B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,GAAG,GAAG,CAAC;QACf,MAAM,eAAe,GAAG,oBAAoB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,CAAC;QACxF,MAAM,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAEzD,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,oBAAoB,GAAG,OAAO,CAClC,eAAe,CAAC,MAAM,CAAC,KAAK,IAAI,eAAe,CAAC,MAAM,CAAC,SAAS,CACjE,CAAC;QAEF,IAAI,KAAK,GAAkB,IAAI,CAAC;QAChC,IAAI,SAAS,GAAkB,IAAI,CAAC;QAEpC,IAAI,oBAAoB,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;gBAClC,OAAO,EAAE,mDAAmD;gBAC5D,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,KAAK,GAAG,MAAM,CACZ,MAAM,QAAQ,CAAC,IAAI,CAAC;oBAClB,OAAO,EAAE,+BAA+B;oBACxC,QAAQ,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;iBACpF,CAAC,CACH,CAAC,IAAI,EAAE,CAAC;gBACT,SAAS,GAAG,MAAM,CAChB,MAAM,QAAQ,CAAC,IAAI,CAAC;oBAClB,OAAO,EAAE,yBAAyB;oBAClC,QAAQ,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;iBACpF,CAAC,CACH,CAAC,IAAI,EAAE,CAAC;YACX,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACjC,KAAK,GAAG,MAAM,CACZ,MAAM,QAAQ,CAAC,IAAI,CAAC;gBAClB,OAAO,EAAE,+BAA+B;gBACxC,QAAQ,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;aACpF,CAAC,CACH,CAAC,IAAI,EAAE,CAAC;YACT,SAAS,GAAG,MAAM,CAChB,MAAM,QAAQ,CAAC,IAAI,CAAC;gBAClB,OAAO,EAAE,yBAAyB;gBAClC,QAAQ,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;aACpF,CAAC,CACH,CAAC,IAAI,EAAE,CAAC;QACX,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAA4B,CAAC;QAC5E,MAAM,SAAS,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAA4B,CAAC;QAEzE,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;YACvB,IAAI,eAAe,KAAK,kBAAkB,EAAE,CAAC;gBAC3C,IAAI,GAAG;oBACL,GAAG,IAAI;oBACP,QAAQ,EAAE;wBACR,GAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAA6B;wBACrD,MAAM,EAAE;4BACN,GAAG,UAAU;4BACb,OAAO,EAAE,IAAI;4BACb,KAAK;4BACL,SAAS;yBACV;qBACF;iBACgB,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,MAAM,WAAW,GAAG,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,CAA4B,CAAC;gBAClF,IAAI,GAAG;oBACL,GAAG,IAAI;oBACP,QAAQ,EAAE;wBACR,GAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAA6B;wBACrD,MAAM,EAAE;4BACN,GAAG,UAAU;4BACb,OAAO,EAAE,IAAI;4BACb,QAAQ,EAAE;gCACR,GAAG,SAAS;gCACZ,CAAC,eAAe,CAAC,EAAE;oCACjB,GAAG,WAAW;oCACd,OAAO,EAAE,IAAI;oCACb,KAAK;oCACL,SAAS;iCACV;6BACF;yBACF;qBACF;iBACgB,CAAC;YACtB,CAAC;QACH,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,GAAG,MAAM,qBAAqB,CAAC;gBACjC,GAAG,EAAE,IAAI;gBACT,QAAQ;gBACR,SAAS,EAAE,eAAe;aAC3B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/src/probe.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Feishu API connectivity probe.
+ */
+import type { FeishuProbeResult } from "./types.js";
+/**
+ * Probe the Feishu API by fetching bot info.
+ * Uses the internal tenant access token endpoint.
+ */
+export declare function probeFeishu(appId: string, appSecret: string, timeoutMs?: number): Promise<FeishuProbeResult>;
+//# sourceMappingURL=probe.d.ts.map

package/dist/src/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../src/probe.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,SAAS,SAAO,GACf,OAAO,CAAC,iBAAiB,CAAC,CA6C5B"}

package/dist/src/probe.js

@@ -0,0 +1,48 @@
+/**
+ * Feishu API connectivity probe.
+ */
+import * as Lark from "@larksuiteoapi/node-sdk";
+/**
+ * Probe the Feishu API by fetching bot info.
+ * Uses the internal tenant access token endpoint.
+ */
+export async function probeFeishu(appId, appSecret, timeoutMs = 5000) {
+    if (!appId?.trim() || !appSecret?.trim()) {
+        return { ok: false, error: "Missing appId or appSecret", elapsedMs: 0 };
+    }
+    const startTime = Date.now();
+    try {
+        const client = new Lark.Client({
+            appId: appId.trim(),
+            appSecret: appSecret.trim(),
+            domain: Lark.Domain.Feishu,
+            appType: Lark.AppType.SelfBuild,
+        });
+        // Use bot info endpoint to validate credentials
+        const response = await client.bot.v3.botInfo.get({});
+        const elapsedMs = Date.now() - startTime;
+        const bot = response?.data?.bot;
+        if (bot) {
+            return {
+                ok: true,
+                bot: {
+                    name: bot.bot_name,
+                    openId: bot.open_id,
+                },
+                elapsedMs,
+            };
+        }
+        return { ok: true, elapsedMs };
+    }
+    catch (err) {
+        const elapsedMs = Date.now() - startTime;
+        if (err instanceof Error) {
+            if (err.name === "AbortError") {
+                return { ok: false, error: `Request timed out after ${timeoutMs}ms`, elapsedMs };
+            }
+            return { ok: false, error: err.message, elapsedMs };
+        }
+        return { ok: false, error: String(err), elapsedMs };
+    }
+}
+//# sourceMappingURL=probe.js.map

package/dist/src/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../src/probe.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,IAAI,MAAM,yBAAyB,CAAC;AAIhD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,SAAiB,EACjB,SAAS,GAAG,IAAI;IAEhB,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;QACzC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAC1E,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC;YAC7B,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;YACnB,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;SAChC,CAAC,CAAC;QAEH,gDAAgD;QAChD,MAAM,QAAQ,GAAG,MAAO,MAAqJ,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAErM,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEzC,MAAM,GAAG,GAAG,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC;QAChC,IAAI,GAAG,EAAE,CAAC;YACR,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,GAAG,EAAE;oBACH,IAAI,EAAG,GAA+B,CAAC,QAA8B;oBACrE,MAAM,EAAG,GAA+B,CAAC,OAA6B;iBACvE;gBACD,SAAS;aACV,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEzC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC9B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;YACnF,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QACtD,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/src/receive.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Feishu WebSocket message receive handler.
+ *
+ * Connects to Feishu via the SDK's WSClient, dispatches incoming
+ * messages to Clawdbot's channel reply infrastructure.
+ */
+import type { ClawdbotConfig } from "clawdbot/plugin-sdk";
+import type { ResolvedFeishuAccount } from "./types.js";
+/** Options for the Feishu provider. */
+export type FeishuProviderOptions = {
+    account: ResolvedFeishuAccount;
+    config: ClawdbotConfig;
+    log: {
+        info: (msg: string) => void;
+        error: (msg: string) => void;
+        debug?: (msg: string) => void;
+    };
+    abortSignal?: AbortSignal;
+    statusSink?: (patch: Record<string, unknown>) => void;
+};
+/** Start the Feishu WebSocket provider. Returns a stop function. */
+export declare function startFeishuProvider(options: FeishuProviderOptions): {
+    stop: () => void;
+};
+//# sourceMappingURL=receive.d.ts.map

package/dist/src/receive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receive.d.ts","sourceRoot":"","sources":["../../src/receive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAOxD,uCAAuC;AACvC,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE;QACH,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC7B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;KAC/B,CAAC;IACF,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG;IAAE,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CAuDxF"}