@larksuite/openclaw-lark 2026.3.9

package/src/channel/onboarding.js

@@ -0,0 +1,297 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Onboarding wizard adapter for the Feishu/Lark channel plugin.
+ *
+ * Implements the ChannelOnboardingAdapter interface so the `openclaw
+ * setup` wizard can configure Feishu credentials, domain, group
+ * policies, and DM allowlists interactively.
+ */
+import { DEFAULT_ACCOUNT_ID, formatDocsLink } from 'openclaw/plugin-sdk';
+import { getLarkCredentials } from '../core/accounts';
+import { probeFeishu } from './probe';
+import { setFeishuDmPolicy, setFeishuAllowFrom, setFeishuGroupPolicy, setFeishuGroupAllowFrom, parseAllowFromInput, } from './onboarding-config';
+import { migrateLegacyGroupAllowFrom } from './onboarding-migrate';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const channel = 'feishu';
+// ---------------------------------------------------------------------------
+// Prompter helpers
+// ---------------------------------------------------------------------------
+async function noteFeishuCredentialHelp(prompter) {
+    await prompter.note([
+        '1) Go to Feishu Open Platform (open.feishu.cn)',
+        '2) Create a self-built app',
+        '3) Get App ID and App Secret from Credentials page',
+        '4) Enable required permissions: im:message, im:chat, contact:user.base:readonly',
+        '5) Publish the app or add it to a test group',
+        'Tip: you can also set FEISHU_APP_ID / FEISHU_APP_SECRET env vars.',
+        `Docs: ${formatDocsLink('/channels/feishu', 'feishu')}`,
+    ].join('\n'), 'Feishu credentials');
+}
+async function promptFeishuAllowFrom(params) {
+    const existing = params.cfg.channels?.feishu?.allowFrom ?? [];
+    await params.prompter.note([
+        'Allowlist Feishu DMs by open_id or user_id.',
+        'You can find user open_id in Feishu admin console or via API.',
+        'Examples:',
+        '- ou_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
+        '- on_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
+    ].join('\n'), 'Feishu allowlist');
+    while (true) {
+        const entry = await params.prompter.text({
+            message: 'Feishu allowFrom (user open_ids)',
+            placeholder: 'ou_xxxxx, ou_yyyyy',
+            initialValue: existing[0] ? String(existing[0]) : undefined,
+            validate: (value) => (String(value ?? '').trim() ? undefined : 'Required'),
+        });
+        const parts = parseAllowFromInput(String(entry));
+        if (parts.length === 0) {
+            await params.prompter.note('Enter at least one user.', 'Feishu allowlist');
+            continue;
+        }
+        const unique = [...new Set([...existing.map((v) => String(v).trim()).filter(Boolean), ...parts])];
+        return setFeishuAllowFrom(params.cfg, unique);
+    }
+}
+// ---------------------------------------------------------------------------
+// Credential acquisition
+// ---------------------------------------------------------------------------
+async function acquireCredentials(params) {
+    const { prompter, feishuCfg } = params;
+    let next = params.cfg;
+    const hasConfigCreds = Boolean(feishuCfg?.appId?.trim() && feishuCfg?.appSecret?.trim());
+    const canUseEnv = Boolean(!hasConfigCreds && process.env.FEISHU_APP_ID?.trim() && process.env.FEISHU_APP_SECRET?.trim());
+    let appId = null;
+    let appSecret = null;
+    if (canUseEnv) {
+        const keepEnv = await prompter.confirm({
+            message: 'FEISHU_APP_ID + FEISHU_APP_SECRET detected. Use env vars?',
+            initialValue: true,
+        });
+        if (keepEnv) {
+            next = {
+                ...next,
+                channels: {
+                    ...next.channels,
+                    feishu: { ...next.channels?.feishu, enabled: true },
+                },
+            };
+        }
+        else {
+            appId = String(await prompter.text({
+                message: 'Enter Feishu App ID',
+                validate: (value) => (value?.trim() ? undefined : 'Required'),
+            })).trim();
+            appSecret = String(await prompter.text({
+                message: 'Enter Feishu App Secret',
+                validate: (value) => (value?.trim() ? undefined : 'Required'),
+            })).trim();
+        }
+    }
+    else if (hasConfigCreds) {
+        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',
+                validate: (value) => (value?.trim() ? undefined : 'Required'),
+            })).trim();
+            appSecret = String(await prompter.text({
+                message: 'Enter Feishu App Secret',
+                validate: (value) => (value?.trim() ? undefined : 'Required'),
+            })).trim();
+        }
+    }
+    else {
+        appId = String(await prompter.text({
+            message: 'Enter Feishu App ID',
+            validate: (value) => (value?.trim() ? undefined : 'Required'),
+        })).trim();
+        appSecret = String(await prompter.text({
+            message: 'Enter Feishu App Secret',
+            validate: (value) => (value?.trim() ? undefined : 'Required'),
+        })).trim();
+    }
+    return { cfg: next, appId, appSecret };
+}
+// ---------------------------------------------------------------------------
+// DM policy
+// ---------------------------------------------------------------------------
+const dmPolicy = {
+    label: 'Feishu',
+    channel,
+    policyKey: 'channels.feishu.dmPolicy',
+    allowFromKey: 'channels.feishu.allowFrom',
+    getCurrent: (cfg) => cfg.channels?.feishu?.dmPolicy ?? 'pairing',
+    setPolicy: (cfg, policy) => setFeishuDmPolicy(cfg, policy),
+    promptAllowFrom: promptFeishuAllowFrom,
+};
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+export const feishuOnboardingAdapter = {
+    channel,
+    // -----------------------------------------------------------------------
+    // getStatus
+    // -----------------------------------------------------------------------
+    getStatus: async ({ cfg }) => {
+        const feishuCfg = cfg.channels?.feishu;
+        const configured = Boolean(getLarkCredentials(feishuCfg));
+        // Attempt a live probe when credentials are present.
+        let probeResult = null;
+        if (configured && feishuCfg) {
+            try {
+                probeResult = await probeFeishu(feishuCfg);
+            }
+            catch {
+                // Ignore probe errors -- status degrades gracefully.
+            }
+        }
+        const statusLines = [];
+        if (!configured) {
+            statusLines.push('Feishu: needs app credentials');
+        }
+        else if (probeResult?.ok) {
+            statusLines.push(`Feishu: connected as ${probeResult.botName ?? probeResult.botOpenId ?? 'bot'}`);
+        }
+        else {
+            statusLines.push('Feishu: configured (connection not verified)');
+        }
+        return {
+            channel,
+            configured,
+            statusLines,
+            selectionHint: configured ? 'configured' : 'needs app creds',
+            quickstartScore: configured ? 2 : 0,
+        };
+    },
+    // -----------------------------------------------------------------------
+    // configure
+    // -----------------------------------------------------------------------
+    configure: async ({ cfg, prompter }) => {
+        const feishuCfg = cfg.channels?.feishu;
+        const resolved = getLarkCredentials(feishuCfg);
+        let next = cfg;
+        // Show credential help if nothing is configured yet.
+        if (!resolved) {
+            await noteFeishuCredentialHelp(prompter);
+        }
+        // --- Credential acquisition ---
+        const creds = await acquireCredentials({ cfg: next, prompter, feishuCfg });
+        next = creds.cfg;
+        // --- Persist and test credentials ---
+        if (creds.appId && creds.appSecret) {
+            next = {
+                ...next,
+                channels: {
+                    ...next.channels,
+                    feishu: {
+                        ...next.channels?.feishu,
+                        enabled: true,
+                        appId: creds.appId,
+                        appSecret: creds.appSecret,
+                    },
+                },
+            };
+            const testCfg = next.channels?.feishu;
+            try {
+                const probe = await probeFeishu(testCfg);
+                if (probe.ok) {
+                    await prompter.note(`Connected as ${probe.botName ?? probe.botOpenId ?? 'bot'}`, 'Feishu connection test');
+                }
+                else {
+                    await prompter.note(`Connection failed: ${probe.error ?? 'unknown error'}`, 'Feishu connection test');
+                }
+            }
+            catch (err) {
+                await prompter.note(`Connection test failed: ${String(err)}`, 'Feishu connection test');
+            }
+        }
+        // --- Domain selection ---
+        const currentDomain = next.channels?.feishu?.domain ?? 'feishu';
+        const domain = await prompter.select({
+            message: 'Which Feishu domain?',
+            options: [
+                { value: 'feishu', label: 'Feishu (feishu.cn) - China' },
+                { value: 'lark', label: 'Lark (larksuite.com) - International' },
+            ],
+            initialValue: currentDomain,
+        });
+        if (domain) {
+            next = {
+                ...next,
+                channels: {
+                    ...next.channels,
+                    feishu: {
+                        ...next.channels?.feishu,
+                        domain: domain,
+                    },
+                },
+            };
+        }
+        // --- Legacy migration ---
+        next = await migrateLegacyGroupAllowFrom({ cfg: next, prompter });
+        // --- Group policy ---
+        const groupPolicy = await prompter.select({
+            message: 'Group chat policy — which groups can interact with the bot?',
+            options: [
+                {
+                    value: 'allowlist',
+                    label: 'Allowlist — only groups listed in `groups` config (default)',
+                },
+                {
+                    value: 'open',
+                    label: 'Open — any group (requires @mention)',
+                },
+                {
+                    value: 'disabled',
+                    label: 'Disabled — no group interactions',
+                },
+            ],
+            initialValue: next.channels?.feishu?.groupPolicy ?? 'allowlist',
+        });
+        if (groupPolicy) {
+            next = setFeishuGroupPolicy(next, groupPolicy);
+        }
+        // --- Group sender allowlist ---
+        if (groupPolicy !== 'disabled') {
+            const existing = next.channels?.feishu?.groupAllowFrom ?? [];
+            const entry = await prompter.text({
+                message: 'Group sender allowlist — which users can trigger the bot in allowed groups? (user open_ids)',
+                placeholder: 'ou_xxxxx, ou_yyyyy',
+                initialValue: existing.length > 0 ? existing.map(String).join(', ') : undefined,
+            });
+            if (entry) {
+                const parts = parseAllowFromInput(String(entry));
+                if (parts.length > 0) {
+                    next = setFeishuGroupAllowFrom(next, parts);
+                }
+            }
+            else if (groupPolicy === 'allowlist') {
+                await prompter.note('Empty sender list + allowlist = nobody can trigger. ' +
+                    "Use groupPolicy 'open' if you want anyone in allowed groups to trigger.", 'Note');
+            }
+        }
+        return { cfg: next, accountId: DEFAULT_ACCOUNT_ID };
+    },
+    // -----------------------------------------------------------------------
+    // dmPolicy
+    // -----------------------------------------------------------------------
+    dmPolicy,
+    // -----------------------------------------------------------------------
+    // disable
+    // -----------------------------------------------------------------------
+    disable: (cfg) => ({
+        ...cfg,
+        channels: {
+            ...cfg.channels,
+            feishu: { ...cfg.channels?.feishu, enabled: false },
+        },
+    }),
+};
+//# sourceMappingURL=onboarding.js.map

package/src/channel/onboarding.js.map

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

package/src/channel/plugin.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * ChannelPlugin interface implementation for the Feishu/Lark channel.
+ *
+ * This is the top-level entry point that the OpenClaw plugin system uses to
+ * discover capabilities, resolve accounts, obtain outbound adapters, and
+ * start the inbound event gateway.
+ */
+import type { ChannelPlugin } from 'openclaw/plugin-sdk';
+import type { LarkAccount } from '../core/types';
+export declare const feishuPlugin: ChannelPlugin<LarkAccount>;
+//# sourceMappingURL=plugin.d.ts.map

package/src/channel/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/channel/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAe,aAAa,EAA+C,MAAM,qBAAqB,CAAC;AAEnH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA+DjD,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,WAAW,CA2QnD,CAAC"}

package/src/channel/plugin.js

@@ -0,0 +1,279 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * ChannelPlugin interface implementation for the Feishu/Lark channel.
+ *
+ * This is the top-level entry point that the OpenClaw plugin system uses to
+ * discover capabilities, resolve accounts, obtain outbound adapters, and
+ * start the inbound event gateway.
+ */
+import { DEFAULT_ACCOUNT_ID, PAIRING_APPROVED_MESSAGE } from 'openclaw/plugin-sdk';
+import { getLarkAccount, getLarkAccountIds, getDefaultLarkAccountId } from '../core/accounts';
+import { listFeishuDirectoryPeers, listFeishuDirectoryGroups, listFeishuDirectoryPeersLive, listFeishuDirectoryGroupsLive, } from './directory';
+import { feishuOnboardingAdapter } from './onboarding';
+import { feishuOutbound } from '../messaging/outbound/outbound';
+import { feishuMessageActions } from '../messaging/outbound/actions';
+import { resolveFeishuGroupToolPolicy } from '../messaging/inbound/policy';
+import { LarkClient } from '../core/lark-client';
+import { sendMessageFeishu } from '../messaging/outbound/send';
+import { normalizeFeishuTarget, looksLikeFeishuId } from '../core/targets';
+import { triggerOnboarding } from '../tools/onboarding-auth';
+import { setAccountEnabled, applyAccountConfig, deleteAccount, collectFeishuSecurityWarnings } from './config-adapter';
+import { larkLogger } from '../core/lark-logger';
+import { FEISHU_CONFIG_JSON_SCHEMA } from '../core/config-schema';
+const pluginLog = larkLogger('channel/plugin');
+/** 状态轮询的探针结果缓存时长（10 分钟）。 */
+const PROBE_CACHE_TTL_MS = 10 * 60 * 1000;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Convert nullable SDK params to optional params for directory functions. */
+function adaptDirectoryParams(params) {
+    return {
+        cfg: params.cfg,
+        query: params.query ?? undefined,
+        limit: params.limit ?? undefined,
+        accountId: params.accountId ?? undefined,
+    };
+}
+// ---------------------------------------------------------------------------
+// Meta
+// ---------------------------------------------------------------------------
+const meta = {
+    id: 'feishu',
+    label: 'Feishu',
+    selectionLabel: 'Feishu/Lark (\u98DE\u4E66)',
+    docsPath: '/channels/feishu',
+    docsLabel: 'feishu',
+    blurb: '\u98DE\u4E66/Lark enterprise messaging.',
+    aliases: ['lark'],
+    order: 70,
+};
+// ---------------------------------------------------------------------------
+// Channel plugin definition
+// ---------------------------------------------------------------------------
+export const feishuPlugin = {
+    id: 'feishu',
+    meta: {
+        ...meta,
+    },
+    // -------------------------------------------------------------------------
+    // Pairing
+    // -------------------------------------------------------------------------
+    pairing: {
+        idLabel: 'feishuUserId',
+        normalizeAllowEntry: (entry) => entry.replace(/^(feishu|user|open_id):/i, ''),
+        notifyApproval: async ({ cfg, id }) => {
+            const accountId = getDefaultLarkAccountId(cfg);
+            pluginLog.info('notifyApproval called', { id, accountId });
+            // 1. 发送配对成功消息（保持现有行为）
+            await sendMessageFeishu({
+                cfg,
+                to: id,
+                text: PAIRING_APPROVED_MESSAGE,
+                accountId,
+            });
+            // 2. 触发 onboarding
+            try {
+                await triggerOnboarding({ cfg, userOpenId: id, accountId });
+                pluginLog.info('onboarding completed', { id });
+            }
+            catch (err) {
+                pluginLog.warn('onboarding failed', { id, error: String(err) });
+            }
+        },
+    },
+    // -------------------------------------------------------------------------
+    // Capabilities
+    // -------------------------------------------------------------------------
+    capabilities: {
+        chatTypes: ['direct', 'group'],
+        media: true,
+        reactions: true,
+        threads: true,
+        polls: false,
+        nativeCommands: true,
+        blockStreaming: true,
+    },
+    // -------------------------------------------------------------------------
+    // Agent prompt
+    // -------------------------------------------------------------------------
+    agentPrompt: {
+        messageToolHints: () => [
+            '- Feishu targeting: omit `target` to reply to the current conversation (auto-inferred). Explicit targets: `user:open_id` or `chat:chat_id`.',
+            '- Feishu supports interactive cards for rich messages.',
+            '- Feishu reactions use UPPERCASE emoji type names (e.g. `OK`,`THUMBSUP`,`THANKS`,`MUSCLE`,`FINGERHEART`,`APPLAUSE`,`FISTBUMP`,`JIAYI`,`DONE`,`SMILE`,`BLUSH` ), not Unicode emoji characters.',
+            "- Feishu `action=delete`/`action=unsend` only deletes messages sent by the bot. When the user quotes a message and says 'delete this', use the **quoted message's** message_id, not the user's own message_id.",
+        ],
+    },
+    // -------------------------------------------------------------------------
+    // Groups
+    // -------------------------------------------------------------------------
+    groups: {
+        resolveToolPolicy: resolveFeishuGroupToolPolicy,
+    },
+    // -------------------------------------------------------------------------
+    // Reload
+    // -------------------------------------------------------------------------
+    reload: { configPrefixes: ['channels.feishu'] },
+    // -------------------------------------------------------------------------
+    // Config schema (JSON Schema)
+    // -------------------------------------------------------------------------
+    configSchema: {
+        schema: FEISHU_CONFIG_JSON_SCHEMA,
+    },
+    // -------------------------------------------------------------------------
+    // Config adapter
+    // -------------------------------------------------------------------------
+    config: {
+        listAccountIds: (cfg) => getLarkAccountIds(cfg),
+        resolveAccount: (cfg, accountId) => getLarkAccount(cfg, accountId),
+        defaultAccountId: (cfg) => getDefaultLarkAccountId(cfg),
+        setAccountEnabled: ({ cfg, accountId, enabled }) => {
+            return setAccountEnabled(cfg, accountId, enabled);
+        },
+        deleteAccount: ({ cfg, accountId }) => {
+            return deleteAccount(cfg, accountId);
+        },
+        isConfigured: (account) => account.configured,
+        describeAccount: (account) => ({
+            accountId: account.accountId,
+            enabled: account.enabled,
+            configured: account.configured,
+            name: account.name,
+            appId: account.appId,
+            brand: account.brand,
+        }),
+        resolveAllowFrom: ({ cfg, accountId }) => {
+            const account = getLarkAccount(cfg, accountId);
+            return (account.config?.allowFrom ?? []).map((entry) => String(entry));
+        },
+        formatAllowFrom: ({ allowFrom }) => allowFrom
+            .map((entry) => String(entry).trim())
+            .filter(Boolean)
+            .map((entry) => entry.toLowerCase()),
+    },
+    // -------------------------------------------------------------------------
+    // Security
+    // -------------------------------------------------------------------------
+    security: {
+        collectWarnings: ({ cfg, accountId }) => collectFeishuSecurityWarnings({ cfg, accountId: accountId ?? DEFAULT_ACCOUNT_ID }),
+    },
+    // -------------------------------------------------------------------------
+    // Setup
+    // -------------------------------------------------------------------------
+    setup: {
+        resolveAccountId: () => DEFAULT_ACCOUNT_ID,
+        applyAccountConfig: ({ cfg, accountId }) => {
+            return applyAccountConfig(cfg, accountId, { enabled: true });
+        },
+    },
+    // -------------------------------------------------------------------------
+    // Onboarding
+    // -------------------------------------------------------------------------
+    onboarding: feishuOnboardingAdapter,
+    // -------------------------------------------------------------------------
+    // Messaging
+    // -------------------------------------------------------------------------
+    messaging: {
+        normalizeTarget: (raw) => normalizeFeishuTarget(raw) ?? undefined,
+        targetResolver: {
+            looksLikeId: looksLikeFeishuId,
+            hint: '<chatId|user:openId|chat:chatId>',
+        },
+    },
+    // -------------------------------------------------------------------------
+    // Directory
+    // -------------------------------------------------------------------------
+    directory: {
+        self: async () => null,
+        listPeers: async (p) => listFeishuDirectoryPeers(adaptDirectoryParams(p)),
+        listGroups: async (p) => listFeishuDirectoryGroups(adaptDirectoryParams(p)),
+        listPeersLive: async (p) => listFeishuDirectoryPeersLive(adaptDirectoryParams(p)),
+        listGroupsLive: async (p) => listFeishuDirectoryGroupsLive(adaptDirectoryParams(p)),
+    },
+    // -------------------------------------------------------------------------
+    // Outbound
+    // -------------------------------------------------------------------------
+    outbound: feishuOutbound,
+    // -------------------------------------------------------------------------
+    // Threading
+    // -------------------------------------------------------------------------
+    threading: {
+        buildToolContext: ({ context, hasRepliedRef }) => ({
+            currentChannelId: normalizeFeishuTarget(context.To ?? '') ?? undefined,
+            currentThreadTs: context.MessageThreadId != null ? String(context.MessageThreadId) : undefined,
+            currentMessageId: context.CurrentMessageId,
+            hasRepliedRef,
+        }),
+    },
+    // -------------------------------------------------------------------------
+    // Actions
+    // -------------------------------------------------------------------------
+    actions: feishuMessageActions,
+    // -------------------------------------------------------------------------
+    // Status
+    // -------------------------------------------------------------------------
+    status: {
+        defaultRuntime: {
+            accountId: DEFAULT_ACCOUNT_ID,
+            running: false,
+            lastStartAt: null,
+            lastStopAt: null,
+            lastError: null,
+            port: null,
+        },
+        buildChannelSummary: ({ snapshot }) => ({
+            configured: snapshot.configured ?? false,
+            running: snapshot.running ?? false,
+            lastStartAt: snapshot.lastStartAt ?? null,
+            lastStopAt: snapshot.lastStopAt ?? null,
+            lastError: snapshot.lastError ?? null,
+            port: snapshot.port ?? null,
+            probe: snapshot.probe,
+            lastProbeAt: snapshot.lastProbeAt ?? null,
+        }),
+        probeAccount: async ({ account }) => {
+            return await LarkClient.fromAccount(account).probe({ maxAgeMs: PROBE_CACHE_TTL_MS });
+        },
+        buildAccountSnapshot: ({ account, runtime, probe }) => ({
+            accountId: account.accountId,
+            enabled: account.enabled,
+            configured: account.configured,
+            name: account.name,
+            appId: account.appId,
+            brand: account.brand,
+            running: runtime?.running ?? false,
+            lastStartAt: runtime?.lastStartAt ?? null,
+            lastStopAt: runtime?.lastStopAt ?? null,
+            lastError: runtime?.lastError ?? null,
+            port: runtime?.port ?? null,
+            probe,
+        }),
+    },
+    // -------------------------------------------------------------------------
+    // Gateway
+    // -------------------------------------------------------------------------
+    gateway: {
+        startAccount: async (ctx) => {
+            const { monitorFeishuProvider } = await import('./monitor.js');
+            const account = getLarkAccount(ctx.cfg, ctx.accountId);
+            const port = account.config?.webhookPort ?? null;
+            ctx.setStatus({ accountId: ctx.accountId, port });
+            ctx.log?.info(`starting feishu[${ctx.accountId}] (mode: ${account.config?.connectionMode ?? 'websocket'})`);
+            return monitorFeishuProvider({
+                config: ctx.cfg,
+                runtime: ctx.runtime,
+                abortSignal: ctx.abortSignal,
+                accountId: ctx.accountId,
+            });
+        },
+        stopAccount: async (ctx) => {
+            ctx.log?.info(`stopping feishu[${ctx.accountId}]`);
+            LarkClient.clearCache(ctx.accountId);
+            ctx.log?.info(`stopped feishu[${ctx.accountId}]`);
+        },
+    },
+};
+//# sourceMappingURL=plugin.js.map

package/src/channel/plugin.js.map

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

package/src/channel/probe.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+import type { FeishuProbeResult } from './types';
+import { type LarkClientCredentials } from '../core/lark-client';
+/**
+ * Probe the Feishu bot connection by calling the bot/v3/info API.
+ *
+ * Returns a result indicating whether the bot is reachable and its
+ * basic identity (name, open_id).  Used by onboarding and status
+ * checks to verify credentials before committing them to config.
+ */
+export declare function probeFeishu(credentials?: LarkClientCredentials): Promise<FeishuProbeResult>;
+//# sourceMappingURL=probe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../src/channel/probe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAc,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE7E;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,WAAW,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CASjG"}