@downcity/agent 1.1.25 → 1.1.32

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

@@ -0,0 +1,27 @@
+/**
+ * Chat 渠道配置描述器基类。
+ *
+ * 关键点（中文）
+ * - 每个 channel 继承该基类，集中声明自己的配置字段。
+ * - 统一提供“可写 ship 字段”提取逻辑，避免在 service 中重复硬编码。
+ */
+import type { ChatChannelConfigurationDescriptor, ChatChannelConfigurationField } from "../../../../plugin/builtins/chat/types/ChannelConfiguration.js";
+import type { ChatChannelName } from "../../../../plugin/builtins/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/plugin/builtins/chat/channels/Configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Configuration.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/channels/Configuration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kCAAkC,EAClC,6BAA6B,EAC9B,MAAM,sDAAsD,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AAErF;;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/plugin/builtins/chat/channels/Configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Configuration.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/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/plugin/builtins/chat/channels/ConfigurationRegistry.d.ts

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

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

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

package/bin/plugin/builtins/chat/channels/ConfigurationRegistry.js

@@ -0,0 +1,31 @@
+/**
+ * Chat 渠道配置描述器注册表。
+ *
+ * 关键点（中文）
+ * - 统一管理各 channel 的 Configuration 实例，避免业务侧散落 import。
+ * - 提供按渠道查询与全量枚举能力，便于 Console / DB 复用。
+ */
+import { TelegramChannelConfiguration } from "../../../../plugin/builtins/chat/channels/telegram/Configuration.js";
+import { FeishuChannelConfiguration } from "../../../../plugin/builtins/chat/channels/feishu/Configuration.js";
+import { QqChannelConfiguration } from "../../../../plugin/builtins/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/plugin/builtins/chat/channels/ConfigurationRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationRegistry.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/channels/ConfigurationRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,2DAA2D,CAAC;AACzG,OAAO,EAAE,0BAA0B,EAAE,MAAM,yDAAyD,CAAC;AACrG,OAAO,EAAE,sBAAsB,EAAE,MAAM,qDAAqD,CAAC;AAI7F,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/plugin/builtins/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 "../../../../../plugin/builtins/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/plugin/builtins/chat/channels/feishu/BotInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotInfo.d.ts","sourceRoot":"","sources":["../../../../../../src/plugin/builtins/chat/channels/feishu/BotInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,0BAA0B,EAC3B,MAAM,yCAAyC,CAAC;AAkDjD;;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/plugin/builtins/chat/channels/feishu/BotInfo.js.map

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

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

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

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

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

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

@@ -0,0 +1,59 @@
+/**
+ * Feishu 渠道配置描述。
+ *
+ * 关键点（中文）
+ * - ship 层只保留绑定字段。
+ * - appId/appSecret/domain 由 channel account 维护。
+ */
+import { ChatChannelConfiguration } from "../../../../../plugin/builtins/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/plugin/builtins/chat/channels/feishu/Configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Configuration.js","sourceRoot":"","sources":["../../../../../../src/plugin/builtins/chat/channels/feishu/Configuration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AAG5F;;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/plugin/builtins/chat/channels/feishu/Feishu.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Feishu 渠道门面。
+ *
+ * 关键点（中文）
+ * - `FeishuBot` 只保留入站授权、命令处理、消息入队与回复编排。
+ * - Feishu SDK、token、Open API 查询、附件上传下载已经下沉到 `FeishuPlatformClient`。
+ * - 纯入站解析逻辑下沉到 `FeishuInbound`，保持渠道门面聚焦主流程。
+ */
+import { BaseChatChannel } from "../../../../../plugin/builtins/chat/channels/BaseChatChannel.js";
+import type { ChannelChatKeyParams, ChannelSendTextParams } from "../../../../../plugin/builtins/chat/channels/BaseChatChannel.js";
+import type { AgentContext } from "../../../../../core/AgentContextTypes.js";
+import type { ChatChannelTestResult } from "../../../../../plugin/builtins/chat/types/ChannelStatus.js";
+import type { ParsedFeishuAttachmentCommand } from "../../../../../plugin/builtins/chat/types/FeishuAttachment.js";
+import type { FeishuConfig, FeishuMessagePayloadType } from "../../../../../plugin/builtins/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/plugin/builtins/chat/channels/feishu/Feishu.d.ts.map

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

package/bin/plugin/builtins/chat/channels/feishu/Feishu.js

@@ -0,0 +1,326 @@
+/**
+ * Feishu 渠道门面。
+ *
+ * 关键点（中文）
+ * - `FeishuBot` 只保留入站授权、命令处理、消息入队与回复编排。
+ * - Feishu SDK、token、Open API 查询、附件上传下载已经下沉到 `FeishuPlatformClient`。
+ * - 纯入站解析逻辑下沉到 `FeishuInbound`，保持渠道门面聚焦主流程。
+ */
+import fs from "fs-extra";
+import path from "path";
+import { BaseChatChannel } from "../../../../../plugin/builtins/chat/channels/BaseChatChannel.js";
+import { parseFeishuAttachments } from "./Shared.js";
+import { FeishuPlatformClient } from "./FeishuPlatformClient.js";
+import { handleFeishuMessage } from "./FeishuMessageHandler.js";
+/**
+ * 飞书入站确认 reaction 类型。
+ *
+ * 说明（中文）
+ * - 飞书 reaction API 使用 `emoji_type`，不是直接传 Unicode emoji。
+ * - 这里选择 `OK` 作为更轻量的“已收到”反馈。
+ */
+export const FEISHU_INBOUND_ACK_REACTION_TYPE = "OK";
+/**
+ * 飞书平台适配器。
+ */
+export class FeishuBot extends BaseChatChannel {
+    appId;
+    appSecret;
+    domain;
+    dedupeDir;
+    platform;
+    processingMessages = new Set();
+    processedMessages = new Set();
+    knownChats = new Map();
+    constructor(context, appId, appSecret, domain) {
+        super({ channel: "feishu", context });
+        this.appId = appId;
+        this.appSecret = appSecret;
+        this.domain = domain;
+        this.dedupeDir = path.join(context.paths.getCacheDirPath(), "feishu", "dedupe");
+        this.platform = new FeishuPlatformClient({
+            context,
+            config: {
+                appId: this.appId,
+                appSecret: this.appSecret,
+                domain: this.domain,
+            },
+            onMessage: async (data) => {
+                await this.handleMessage(data);
+            },
+        });
+    }
+    getChatKey(params) {
+        return this.buildChatKey(params.chatId);
+    }
+    async sendTextToPlatform(params) {
+        const chatType = typeof params.chatType === "string" ? params.chatType : "p2p";
+        const messageId = typeof params.messageId === "string" ? params.messageId : undefined;
+        const text = String(params.text ?? "");
+        const shouldReplyToMessage = params.replyToMessage === true;
+        if (shouldReplyToMessage && messageId && chatType !== "p2p") {
+            await this.sendMessage(params.chatId, chatType, messageId, text);
+        }
+        else {
+            await this.sendChatMessage(params.chatId, chatType, text);
+        }
+    }
+    /**
+     * 兼容旧的 per-chat locking 入口。
+     */
+    runInChat(_chatKey, fn) {
+        return fn();
+    }
+    /**
+     * 读取线程级去重集合。
+     */
+    async loadDedupeSet(threadId) {
+        const file = path.join(this.dedupeDir, `${encodeURIComponent(threadId)}.json`);
+        try {
+            if (!(await fs.pathExists(file)))
+                return new Set();
+            const data = (await fs.readJson(file));
+            const ids = Array.isArray(data?.ids) ? data.ids : [];
+            return new Set(ids.map((value) => String(value)));
+        }
+        catch {
+            return new Set();
+        }
+    }
+    /**
+     * 持久化线程级去重集合。
+     */
+    async persistDedupeSet(threadId, set) {
+        const file = path.join(this.dedupeDir, `${encodeURIComponent(threadId)}.json`);
+        try {
+            await fs.ensureDir(this.dedupeDir);
+            const ids = Array.from(set).slice(-800);
+            await fs.writeJson(file, { ids }, { spaces: 2 });
+        }
+        catch {
+            // ignore
+        }
+    }
+    /**
+     * 读取 Feishu runtime 快照。
+     */
+    getExecutorStatus() {
+        const runtime = this.platform.getExecutorStatus();
+        return {
+            ...runtime,
+            detail: {
+                ...runtime.detail,
+                knownChatCount: this.knownChats.size,
+                dedupeCacheSize: this.processedMessages.size,
+            },
+        };
+    }
+    /**
+     * 执行 Feishu 连通性测试。
+     */
+    async testConnection() {
+        return await this.platform.testConnection();
+    }
+    /**
+     * 启动机器人。
+     */
+    async start() {
+        if (!this.appId || !this.appSecret) {
+            this.logger.warn("Feishu App ID or App Secret not configured, skipping startup");
+            return;
+        }
+        this.logger.info("🤖 Starting Feishu Bot...");
+        try {
+            await this.platform.start(this.processedMessages);
+        }
+        catch (error) {
+            this.logger.error("Failed to start Feishu Bot", { error: String(error) });
+        }
+    }
+    /**
+     * 处理入站消息。
+     */
+    async handleMessage(data) {
+        await handleFeishuMessage({
+            context: this.context,
+            rootPath: this.rootPath,
+            logger: this.logger,
+            buildChatKey: (chatId) => this.buildChatKey(chatId),
+            processedMessages: this.processedMessages,
+            processingMessages: this.processingMessages,
+            loadDedupeSet: async (threadId) => await this.loadDedupeSet(threadId),
+            persistDedupeSet: async (threadId, set) => await this.persistDedupeSet(threadId, set),
+            downloadIncomingAttachments: async (params) => await this.platform.downloadIncomingAttachments(params),
+            resolveReplyContext: async (params) => await this.platform.resolveReplyContext(params),
+            resolveSenderName: async (params) => await this.platform.resolveSenderName(params),
+            resolveChatTitle: async (chatId) => await this.platform.resolveChatTitle(chatId),
+            sendInboundAckReaction: async (params) => await this.platform.sendInboundAckReaction(params),
+            rememberChat: (threadId, value) => {
+                this.knownChats.set(threadId, value);
+            },
+            observeIncomingAuthorization: async (params) => {
+                await this.observeIncomingAuthorization(params);
+            },
+            evaluateIncomingAuthorization: async (params) => await this.evaluateIncomingAuthorization(params),
+            sendAuthorizationText: async (params) => {
+                await this.sendAuthorizationText(params);
+            },
+            buildUnauthorizedBlockedText: (params) => this.buildUnauthorizedBlockedText(params),
+            runInChat: async (chatKey, fn) => {
+                await this.runInChat(chatKey, fn);
+            },
+            handleCommand: async (params) => {
+                await this.handleCommand(params.chatId, params.chatType, params.messageId, params.command);
+            },
+            executeAndReply: async (params) => {
+                await this.executeAndReply(params.chatId, params.chatType, params.messageId, params.instructions, params.actorId, params.actorName, params.chatTitle, params.extra);
+            },
+            sendErrorMessage: async (params) => {
+                await this.sendErrorMessage(params.chatId, params.chatType, params.messageId, params.errorText);
+            },
+        }, data);
+    }
+    /**
+     * 处理命令。
+     */
+    async handleCommand(chatId, chatType, messageId, command) {
+        this.logger.info(`Received Feishu command: ${command}`);
+        let responseText = "";
+        switch (command.toLowerCase().split(" ")[0]) {
+            case "/help":
+            case "/帮助":
+                responseText = `🤖 Downcity Bot
+
+Available commands:
+- /help or /帮助 - View help information
+- /status or /状态 - View agent status
+- /tasks or /任务 - View task list
+- /clear or /清除 - Delete current conversation completely
+- <any message> - Execute instruction`;
+                break;
+            case "/status":
+            case "/状态":
+                responseText = "📊 Agent status: Running\nTasks: 0\nPending approvals: 0";
+                break;
+            case "/tasks":
+            case "/任务":
+                responseText = "📋 Task list\nNo tasks";
+                break;
+            case "/clear":
+            case "/清除":
+                await this.clearChatByTarget({
+                    chatId,
+                    chatType,
+                });
+                responseText = "✅ Conversation deleted completely";
+                break;
+            default:
+                responseText = `Unknown command: ${command}\nType /help to view available commands`;
+        }
+        await this.sendMessage(chatId, chatType, messageId, responseText);
+    }
+    /**
+     * 执行指令并回复。
+     */
+    async executeAndReply(chatId, chatType, messageId, instructions, actorId, actorName, chatTitle, extra) {
+        try {
+            const { chatKey } = await this.enqueueMessage({
+                chatId,
+                text: instructions,
+                chatType,
+                messageId,
+                userId: actorId,
+                username: actorName,
+                chatTitle,
+                ...(extra ? { extra } : {}),
+            });
+            this.knownChats.set(chatKey, {
+                chatId,
+                chatType,
+                ...(chatTitle ? { chatTitle } : {}),
+            });
+        }
+        catch (error) {
+            await this.sendErrorMessage(chatId, chatType, messageId, `Execution error: ${String(error)}`);
+        }
+    }
+    /**
+     * 回复消息。
+     */
+    async sendMessage(chatId, chatType, messageId, text) {
+        const parsed = parseFeishuAttachments(text);
+        await this.sendParsedMessage(chatId, chatType, messageId, parsed.segments);
+    }
+    /**
+     * 普通发送消息。
+     */
+    async sendChatMessage(chatId, chatType, text) {
+        const parsed = parseFeishuAttachments(text);
+        await this.sendParsedMessage(chatId, chatType, undefined, parsed.segments);
+    }
+    /**
+     * 按正文与附件的真实顺序发送。
+     */
+    async sendParsedMessage(chatId, chatType, messageId, segments) {
+        for (const segment of segments) {
+            if (segment.kind === "text") {
+                const normalizedText = String(segment.text || "").trim();
+                if (!normalizedText)
+                    continue;
+                await this.sendPlatformMessage(chatId, chatType, messageId, "text", {
+                    text: normalizedText,
+                });
+                continue;
+            }
+            try {
+                await this.sendAttachment(chatId, chatType, messageId, segment.attachment);
+            }
+            catch (error) {
+                await this.sendPlatformMessage(chatId, chatType, messageId, "text", {
+                    text: `❌ Failed to send attachment: ${segment.attachment.pathOrUrl}\n${String(error)}`,
+                });
+            }
+        }
+    }
+    /**
+     * 发送单个附件。
+     */
+    async sendAttachment(chatId, chatType, messageId, attachment) {
+        await this.platform.sendAttachment(chatId, chatType, messageId, attachment);
+    }
+    /**
+     * 发送底层平台消息。
+     */
+    async sendPlatformMessage(chatId, chatType, messageId, msgType, content) {
+        await this.platform.sendPlatformMessage(chatId, chatType, messageId, msgType, content);
+    }
+    /**
+     * 发送统一错误文本。
+     */
+    async sendErrorMessage(chatId, chatType, messageId, errorText) {
+        await this.sendMessage(chatId, chatType, messageId, `❌ ${errorText}`);
+    }
+    /**
+     * 停止机器人。
+     */
+    async stop() {
+        await this.platform.stop();
+        this.processedMessages.clear();
+    }
+    /**
+     * 生成 chatKey。
+     */
+    buildChatKey(chatId) {
+        return `feishu-chat-${chatId}`;
+    }
+}
+/**
+ * 创建飞书机器人实例。
+ */
+export async function createFeishuBot(config, context) {
+    if (!config.enabled || !config.appId || !config.appSecret) {
+        return null;
+    }
+    return new FeishuBot(context, config.appId, config.appSecret, config.domain);
+}
+//# sourceMappingURL=Feishu.js.map