@downcity/plugins 1.0.4

package/bin/chat/channels/Configuration.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Chat 渠道配置描述器基类。
+ *
+ * 关键点（中文）
+ * - 每个 channel 继承该基类，集中声明自己的配置字段。
+ * - 统一提供“可写 ship 字段”提取逻辑，避免在 service 中重复硬编码。
+ */
+import type { ChatChannelConfigurationDescriptor, ChatChannelConfigurationField } from "../../chat/types/ChannelConfiguration.js";
+import type { ChatChannelName } from "../../chat/types/ChannelStatus.js";
+/**
+ * Chat 渠道配置描述器抽象基类。
+ */
+export declare abstract class ChatChannelConfiguration {
+    /**
+     * 绑定渠道名。
+     */
+    abstract readonly channel: ChatChannelName;
+    /**
+     * 返回完整配置描述。
+     */
+    abstract describe(): ChatChannelConfigurationDescriptor;
+    /**
+     * 返回可通过 `chat.configure` 写入的 downcity.json 字段定义。
+     */
+    getWritableShipFields(): ChatChannelConfigurationField[];
+}
+//# sourceMappingURL=Configuration.d.ts.map

package/bin/chat/channels/Configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Configuration.d.ts","sourceRoot":"","sources":["../../../src/chat/channels/Configuration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kCAAkC,EAClC,6BAA6B,EAC9B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE;;GAEG;AACH,8BAAsB,wBAAwB;IAC5C;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,QAAQ,IAAI,kCAAkC;IAEvD;;OAEG;IACH,qBAAqB,IAAI,6BAA6B,EAAE;CAGzD"}

package/bin/chat/channels/Configuration.js

@@ -0,0 +1,19 @@
+/**
+ * Chat 渠道配置描述器基类。
+ *
+ * 关键点（中文）
+ * - 每个 channel 继承该基类，集中声明自己的配置字段。
+ * - 统一提供“可写 ship 字段”提取逻辑，避免在 service 中重复硬编码。
+ */
+/**
+ * Chat 渠道配置描述器抽象基类。
+ */
+export class ChatChannelConfiguration {
+    /**
+     * 返回可通过 `chat.configure` 写入的 downcity.json 字段定义。
+     */
+    getWritableShipFields() {
+        return this.describe().fields.ship.filter((field) => field.writable);
+    }
+}
+//# sourceMappingURL=Configuration.js.map

package/bin/chat/channels/Configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Configuration.js","sourceRoot":"","sources":["../../../src/chat/channels/Configuration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;GAEG;AACH,MAAM,OAAgB,wBAAwB;IAW5C;;OAEG;IACH,qBAAqB;QACnB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvE,CAAC;CACF"}

package/bin/chat/channels/ConfigurationRegistry.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Chat 渠道配置描述器注册表。
+ *
+ * 关键点（中文）
+ * - 统一管理各 channel 的 Configuration 实例，避免业务侧散落 import。
+ * - 提供按渠道查询与全量枚举能力，便于 Console / DB 复用。
+ */
+import type { ChatChannelConfiguration } from "../../chat/channels/Configuration.js";
+import type { ChatChannelName } from "../../chat/types/ChannelStatus.js";
+/**
+ * 按渠道读取配置描述器。
+ */
+export declare function getChatChannelConfiguration(channel: ChatChannelName): ChatChannelConfiguration;
+/**
+ * 枚举所有渠道配置描述器。
+ */
+export declare function listChatChannelConfigurations(): ChatChannelConfiguration[];
+//# sourceMappingURL=ConfigurationRegistry.d.ts.map

package/bin/chat/channels/ConfigurationRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationRegistry.d.ts","sourceRoot":"","sources":["../../../src/chat/channels/ConfigurationRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAerE;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,GACvB,wBAAwB,CAE1B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,wBAAwB,EAAE,CAE1E"}

package/bin/chat/channels/ConfigurationRegistry.js

@@ -0,0 +1,31 @@
+/**
+ * Chat 渠道配置描述器注册表。
+ *
+ * 关键点（中文）
+ * - 统一管理各 channel 的 Configuration 实例，避免业务侧散落 import。
+ * - 提供按渠道查询与全量枚举能力，便于 Console / DB 复用。
+ */
+import { TelegramChannelConfiguration } from "../../chat/channels/telegram/Configuration.js";
+import { FeishuChannelConfiguration } from "../../chat/channels/feishu/Configuration.js";
+import { QqChannelConfiguration } from "../../chat/channels/qq/Configuration.js";
+const TELEGRAM_CONFIGURATION = new TelegramChannelConfiguration();
+const FEISHU_CONFIGURATION = new FeishuChannelConfiguration();
+const QQ_CONFIGURATION = new QqChannelConfiguration();
+const CHANNEL_CONFIGURATION_REGISTRY = {
+    telegram: TELEGRAM_CONFIGURATION,
+    feishu: FEISHU_CONFIGURATION,
+    qq: QQ_CONFIGURATION,
+};
+/**
+ * 按渠道读取配置描述器。
+ */
+export function getChatChannelConfiguration(channel) {
+    return CHANNEL_CONFIGURATION_REGISTRY[channel];
+}
+/**
+ * 枚举所有渠道配置描述器。
+ */
+export function listChatChannelConfigurations() {
+    return Object.values(CHANNEL_CONFIGURATION_REGISTRY);
+}
+//# sourceMappingURL=ConfigurationRegistry.js.map

package/bin/chat/channels/ConfigurationRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationRegistry.js","sourceRoot":"","sources":["../../../src/chat/channels/ConfigurationRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAI7E,MAAM,sBAAsB,GAAG,IAAI,4BAA4B,EAAE,CAAC;AAClE,MAAM,oBAAoB,GAAG,IAAI,0BAA0B,EAAE,CAAC;AAC9D,MAAM,gBAAgB,GAAG,IAAI,sBAAsB,EAAE,CAAC;AAEtD,MAAM,8BAA8B,GAGhC;IACF,QAAQ,EAAE,sBAAsB;IAChC,MAAM,EAAE,oBAAoB;IAC5B,EAAE,EAAE,gBAAgB;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAwB;IAExB,OAAO,8BAA8B,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,8BAA8B,CAAC,CAAC;AACvD,CAAC"}

package/bin/chat/channels/feishu/BotInfo.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Feishu Bot 信息探测实现。
+ *
+ * 关键点（中文）
+ * - 先通过 appId/appSecret 换取 tenant access token。
+ * - 再尝试读取 bot profile，失败时回退到凭据推断。
+ * - 官方接口返回体核心字段在 `bot.app_name` / `bot.open_id`，这里同时兼容旧兜底结构。
+ */
+import type { ChatBotInfoCredentialInput, ChatBotInfoResult, ChatChannelBotInfoProvider } from "../../../chat/types/BotInfo.js";
+/**
+ * Feishu 渠道 Bot 信息探测器。
+ */
+export declare class FeishuBotInfoProvider implements ChatChannelBotInfoProvider {
+    readonly channel: "feishu";
+    /**
+     * 探测 Feishu bot 信息。
+     */
+    resolve(credentials: ChatBotInfoCredentialInput): Promise<ChatBotInfoResult>;
+}
+//# sourceMappingURL=BotInfo.d.ts.map

package/bin/chat/channels/feishu/BotInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotInfo.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/feishu/BotInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,0BAA0B,EAC3B,MAAM,yBAAyB,CAAC;AAkDjC;;GAEG;AACH,qBAAa,qBAAsB,YAAW,0BAA0B;IACtE,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAU;IAErC;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,0BAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA8HnF"}

package/bin/chat/channels/feishu/BotInfo.js

@@ -0,0 +1,147 @@
+/**
+ * Feishu Bot 信息探测实现。
+ *
+ * 关键点（中文）
+ * - 先通过 appId/appSecret 换取 tenant access token。
+ * - 再尝试读取 bot profile，失败时回退到凭据推断。
+ * - 官方接口返回体核心字段在 `bot.app_name` / `bot.open_id`，这里同时兼容旧兜底结构。
+ */
+function pickFirstNonEmpty(inputs) {
+    for (const input of inputs) {
+        const text = String(input || "").trim();
+        if (text)
+            return text;
+    }
+    return "";
+}
+function normalizeDomain(input) {
+    const text = String(input || "").trim();
+    return (text || "https://open.feishu.cn").replace(/\/+$/, "");
+}
+/**
+ * Feishu 渠道 Bot 信息探测器。
+ */
+export class FeishuBotInfoProvider {
+    channel = "feishu";
+    /**
+     * 探测 Feishu bot 信息。
+     */
+    async resolve(credentials) {
+        const appId = String(credentials.appId || "").trim();
+        const appSecret = String(credentials.appSecret || "").trim();
+        const domain = normalizeDomain(String(credentials.domain || ""));
+        if (!appId || !appSecret) {
+            throw new Error("Missing appId/appSecret");
+        }
+        const authEndpoint = `${domain}/open-apis/auth/v3/tenant_access_token/internal`;
+        const authResponse = await fetch(authEndpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                app_id: appId,
+                app_secret: appSecret,
+            }),
+        });
+        const authRaw = await authResponse.text();
+        let authPayload = {};
+        try {
+            authPayload = JSON.parse(authRaw);
+        }
+        catch {
+            authPayload = {};
+        }
+        const token = pickFirstNonEmpty([
+            authPayload.tenant_access_token,
+            authPayload.app_access_token,
+        ]);
+        if (!authResponse.ok || authPayload.code !== 0 || !token) {
+            const details = pickFirstNonEmpty([authPayload.msg, authRaw, `HTTP ${authResponse.status}`]);
+            throw new Error(`Feishu bot info probe failed: ${details}`);
+        }
+        // 关键点（中文）：尽力读取 bot profile，若失败则使用 appId 回退。
+        let botName = "";
+        let botOpenId = "";
+        try {
+            const profileResponse = await fetch(`${domain}/open-apis/bot/v3/info`, {
+                method: "GET",
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            const profileRaw = await profileResponse.text();
+            const profilePayload = JSON.parse(profileRaw);
+            if (profileResponse.ok && profilePayload.code === 0) {
+                // 关键点（中文）：官方文档当前返回 `bot.app_name` / `bot.open_id`。
+                // 为了兼容历史或不同网关形态，保留对旧 `data.*` 结构的兜底读取。
+                botName = pickFirstNonEmpty([
+                    profilePayload.bot?.app_name,
+                    profilePayload.data?.bot_name,
+                    profilePayload.data?.name,
+                    profilePayload.data?.app_name,
+                    profilePayload.data?.bot?.bot_name,
+                    profilePayload.data?.bot?.name,
+                    profilePayload.data?.bot?.app_name,
+                ]);
+                botOpenId = pickFirstNonEmpty([
+                    profilePayload.bot?.open_id,
+                    profilePayload.data?.open_id,
+                    profilePayload.data?.bot_open_id,
+                    profilePayload.data?.bot_id,
+                    profilePayload.data?.bot?.open_id,
+                    profilePayload.data?.bot?.bot_open_id,
+                    profilePayload.data?.bot?.bot_id,
+                    profilePayload.data?.app_id,
+                ]);
+                const owner = pickFirstNonEmpty([
+                    profilePayload.data?.owner_name,
+                    profilePayload.data?.owner,
+                    profilePayload.data?.owner_open_id,
+                ]);
+                const creator = pickFirstNonEmpty([
+                    profilePayload.data?.creator_name,
+                    profilePayload.data?.creator,
+                    profilePayload.data?.creator_open_id,
+                ]);
+                return {
+                    channel: this.channel,
+                    name: pickFirstNonEmpty([
+                        botName,
+                        `Feishu Bot ${appId.slice(-6)}`,
+                        "Feishu Bot",
+                    ]),
+                    identity: pickFirstNonEmpty([botOpenId, appId]) || undefined,
+                    owner: owner || undefined,
+                    creator: creator || undefined,
+                    botUserId: botOpenId || undefined,
+                    idSeed: pickFirstNonEmpty([botOpenId, appId, "bot"]),
+                    message: botName
+                        ? "Feishu bot profile fetched"
+                        : "Feishu credentials verified; fallback profile generated",
+                };
+            }
+        }
+        catch {
+            // ignore profile lookup error
+        }
+        const name = pickFirstNonEmpty([
+            botName,
+            `Feishu Bot ${appId.slice(-6)}`,
+            "Feishu Bot",
+        ]);
+        const identity = pickFirstNonEmpty([botOpenId, appId]);
+        return {
+            channel: this.channel,
+            name,
+            identity: identity || undefined,
+            owner: undefined,
+            creator: undefined,
+            botUserId: botOpenId || undefined,
+            idSeed: pickFirstNonEmpty([botOpenId, appId, "bot"]),
+            message: botName
+                ? "Feishu bot profile fetched"
+                : "Feishu credentials verified; fallback profile generated",
+        };
+    }
+}
+//# sourceMappingURL=BotInfo.js.map

package/bin/chat/channels/feishu/BotInfo.js.map

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

package/bin/chat/channels/feishu/Configuration.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Feishu 渠道配置描述。
+ *
+ * 关键点（中文）
+ * - ship 层只保留绑定字段。
+ * - appId/appSecret/domain 由 channel account 维护。
+ */
+import { ChatChannelConfiguration } from "../../../chat/channels/Configuration.js";
+import type { ChatChannelConfigurationDescriptor } from "../../../chat/types/ChannelConfiguration.js";
+/**
+ * Feishu 渠道配置描述器。
+ */
+export declare class FeishuChannelConfiguration extends ChatChannelConfiguration {
+    readonly channel: "feishu";
+    describe(): ChatChannelConfigurationDescriptor;
+}
+//# sourceMappingURL=Configuration.d.ts.map

package/bin/chat/channels/feishu/Configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Configuration.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/feishu/Configuration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,sCAAsC,CAAC;AAE/F;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,wBAAwB;IACtE,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAU;IAErC,QAAQ,IAAI,kCAAkC;CA+C/C"}

package/bin/chat/channels/feishu/Configuration.js

@@ -0,0 +1,59 @@
+/**
+ * Feishu 渠道配置描述。
+ *
+ * 关键点（中文）
+ * - ship 层只保留绑定字段。
+ * - appId/appSecret/domain 由 channel account 维护。
+ */
+import { ChatChannelConfiguration } from "../../../chat/channels/Configuration.js";
+/**
+ * Feishu 渠道配置描述器。
+ */
+export class FeishuChannelConfiguration extends ChatChannelConfiguration {
+    channel = "feishu";
+    describe() {
+        return {
+            channel: this.channel,
+            title: "Feishu Channel Configuration",
+            description: "Bind a Feishu/Lark channel account and control runtime enable/disable state.",
+            version: "1.0.0",
+            capabilities: {
+                canToggleEnabled: true,
+                canBindChannelAccount: true,
+                canConfigure: true,
+            },
+            fields: {
+                ship: [
+                    {
+                        key: "enabled",
+                        label: "Enabled",
+                        description: "Whether feishu channel should be started by runtime.",
+                        type: "boolean",
+                        source: "ship_json",
+                        required: false,
+                        nullable: false,
+                        writable: true,
+                        restartRequired: true,
+                        defaultValue: false,
+                        example: true,
+                    },
+                    {
+                        key: "channelAccountId",
+                        label: "Channel Account ID",
+                        description: "Bind channel to a channel account row in ~/.downcity/downcity.db channel_accounts.",
+                        type: "string",
+                        source: "ship_json",
+                        required: false,
+                        nullable: true,
+                        writable: true,
+                        restartRequired: true,
+                        example: "feishu-main",
+                    },
+                ],
+                channelAccount: [],
+                envFallback: [],
+            },
+        };
+    }
+}
+//# sourceMappingURL=Configuration.js.map

package/bin/chat/channels/feishu/Configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Configuration.js","sourceRoot":"","sources":["../../../../src/chat/channels/feishu/Configuration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAG5E;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,wBAAwB;IAC7D,OAAO,GAAG,QAAiB,CAAC;IAErC,QAAQ;QACN,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,8BAA8B;YACrC,WAAW,EACT,8EAA8E;YAChF,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE;gBACZ,gBAAgB,EAAE,IAAI;gBACtB,qBAAqB,EAAE,IAAI;gBAC3B,YAAY,EAAE,IAAI;aACnB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ;wBACE,GAAG,EAAE,SAAS;wBACd,KAAK,EAAE,SAAS;wBAChB,WAAW,EACT,sDAAsD;wBACxD,IAAI,EAAE,SAAS;wBACf,MAAM,EAAE,WAAW;wBACnB,QAAQ,EAAE,KAAK;wBACf,QAAQ,EAAE,KAAK;wBACf,QAAQ,EAAE,IAAI;wBACd,eAAe,EAAE,IAAI;wBACrB,YAAY,EAAE,KAAK;wBACnB,OAAO,EAAE,IAAI;qBACd;oBACD;wBACE,GAAG,EAAE,kBAAkB;wBACvB,KAAK,EAAE,oBAAoB;wBAC3B,WAAW,EACT,oFAAoF;wBACtF,IAAI,EAAE,QAAQ;wBACd,MAAM,EAAE,WAAW;wBACnB,QAAQ,EAAE,KAAK;wBACf,QAAQ,EAAE,IAAI;wBACd,QAAQ,EAAE,IAAI;wBACd,eAAe,EAAE,IAAI;wBACrB,OAAO,EAAE,aAAa;qBACvB;iBACF;gBACD,cAAc,EAAE,EAAE;gBAClB,WAAW,EAAE,EAAE;aAChB;SACF,CAAC;IACJ,CAAC;CACF"}

package/bin/chat/channels/feishu/Feishu.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Feishu 渠道门面。
+ *
+ * 关键点（中文）
+ * - `FeishuBot` 只保留入站授权、命令处理、消息入队与回复编排。
+ * - Feishu SDK、token、Open API 查询、附件上传下载已经下沉到 `FeishuPlatformClient`。
+ * - 纯入站解析逻辑下沉到 `FeishuInbound`，保持渠道门面聚焦主流程。
+ */
+import { BaseChatChannel } from "../../../chat/channels/BaseChatChannel.js";
+import type { ChannelChatKeyParams, ChannelSendTextParams } from "../../../chat/channels/BaseChatChannel.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ChatChannelTestResult } from "../../../chat/types/ChannelStatus.js";
+import type { ParsedFeishuAttachmentCommand } from "../../../chat/types/FeishuAttachment.js";
+import type { FeishuConfig, FeishuMessagePayloadType } from "../../../chat/channels/feishu/types/FeishuChannel.js";
+/**
+ * 飞书入站确认 reaction 类型。
+ *
+ * 说明（中文）
+ * - 飞书 reaction API 使用 `emoji_type`，不是直接传 Unicode emoji。
+ * - 这里选择 `OK` 作为更轻量的“已收到”反馈。
+ */
+export declare const FEISHU_INBOUND_ACK_REACTION_TYPE = "OK";
+/**
+ * 飞书平台适配器。
+ */
+export declare class FeishuBot extends BaseChatChannel {
+    private readonly appId;
+    private readonly appSecret;
+    private readonly domain?;
+    private readonly dedupeDir;
+    private readonly platform;
+    private readonly processingMessages;
+    private readonly processedMessages;
+    private readonly knownChats;
+    constructor(context: AgentContext, appId: string, appSecret: string, domain: string | undefined);
+    protected getChatKey(params: ChannelChatKeyParams): string;
+    protected sendTextToPlatform(params: ChannelSendTextParams): Promise<void>;
+    /**
+     * 兼容旧的 per-chat locking 入口。
+     */
+    private runInChat;
+    /**
+     * 读取线程级去重集合。
+     */
+    private loadDedupeSet;
+    /**
+     * 持久化线程级去重集合。
+     */
+    private persistDedupeSet;
+    /**
+     * 读取 Feishu runtime 快照。
+     */
+    getExecutorStatus(): {
+        running: boolean;
+        linkState: "connected" | "disconnected" | "unknown";
+        statusText: string;
+        detail: Record<string, string | number | boolean | null>;
+    };
+    /**
+     * 执行 Feishu 连通性测试。
+     */
+    testConnection(): Promise<ChatChannelTestResult>;
+    /**
+     * 启动机器人。
+     */
+    start(): Promise<void>;
+    /**
+     * 处理入站消息。
+     */
+    private handleMessage;
+    /**
+     * 处理命令。
+     */
+    private handleCommand;
+    /**
+     * 执行指令并回复。
+     */
+    private executeAndReply;
+    /**
+     * 回复消息。
+     */
+    sendMessage(chatId: string, chatType: string, messageId: string, text: string): Promise<void>;
+    /**
+     * 普通发送消息。
+     */
+    sendChatMessage(chatId: string, chatType: string, text: string): Promise<void>;
+    /**
+     * 按正文与附件的真实顺序发送。
+     */
+    private sendParsedMessage;
+    /**
+     * 发送单个附件。
+     */
+    sendAttachment(chatId: string, chatType: string, messageId: string | undefined, attachment: ParsedFeishuAttachmentCommand): Promise<void>;
+    /**
+     * 发送底层平台消息。
+     */
+    sendPlatformMessage(chatId: string, chatType: string, messageId: string | undefined, msgType: FeishuMessagePayloadType, content: Record<string, unknown> | string): Promise<void>;
+    /**
+     * 发送统一错误文本。
+     */
+    private sendErrorMessage;
+    /**
+     * 停止机器人。
+     */
+    stop(): Promise<void>;
+    /**
+     * 生成 chatKey。
+     */
+    private buildChatKey;
+}
+/**
+ * 创建飞书机器人实例。
+ */
+export declare function createFeishuBot(config: FeishuConfig, context: AgentContext): Promise<FeishuBot | null>;
+//# sourceMappingURL=Feishu.d.ts.map

package/bin/chat/channels/feishu/Feishu.d.ts.map

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