@downcity/plugins 1.0.4

package/bin/chat/runtime/ChatChannelConfig.js

@@ -0,0 +1,260 @@
+/**
+ * ChatChannelConfig：chat 渠道配置与状态快照模块。
+ *
+ * 关键点（中文）
+ * - 渠道配置摘要、状态快照、patch 归一化、downcity.json 落盘都收敛在这里。
+ * - 所有配置写入都遵循“先改内存，再落盘”的一致性顺序。
+ * - 该模块不直接负责 action 流程控制，只提供可复用的底层能力。
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { getChatChannelConfiguration, listChatChannelConfigurations, } from "../../chat/channels/ConfigurationRegistry.js";
+import { getChatChannelBot, isChatChannelEnabled, isChannelAccountConfigured, resolveChannelAccount, resolveChannelAccountId, } from "./ChatChannelCore.js";
+function toJsonObject(input) {
+    return JSON.parse(JSON.stringify(input));
+}
+/**
+ * 生成可安全暴露给 UI 的渠道配置摘要。
+ *
+ * 关键点（中文）
+ * - 不返回明文密钥，只返回布尔“是否已配置”。
+ * - 字段命名尽量贴近 `downcity.json`，便于前端直接映射编辑。
+ */
+export function buildChatChannelConfigSummary(context, channel, accountInput) {
+    const account = accountInput ?? resolveChannelAccount(context, channel);
+    const channelAccountId = resolveChannelAccountId(context, channel);
+    const configured = isChannelAccountConfigured(channel, account);
+    if (channel === "telegram") {
+        return {
+            enabled: isChatChannelEnabled(context, channel),
+            channelAccountId: channelAccountId || null,
+            channelAccountConfigured: configured,
+        };
+    }
+    if (channel === "feishu") {
+        return {
+            enabled: isChatChannelEnabled(context, channel),
+            channelAccountId: channelAccountId || null,
+            channelAccountConfigured: configured,
+        };
+    }
+    return {
+        enabled: isChatChannelEnabled(context, channel),
+        channelAccountId: channelAccountId || null,
+        channelAccountConfigured: configured,
+    };
+}
+/**
+ * 读取单个渠道状态快照。
+ */
+export function getChatChannelStatus(state, context, channel) {
+    const enabled = isChatChannelEnabled(context, channel);
+    const channelAccount = resolveChannelAccount(context, channel);
+    const configured = isChannelAccountConfigured(channel, channelAccount);
+    const runtime = getChatChannelBot(state, channel)?.getExecutorStatus();
+    const linkState = !enabled
+        ? "disconnected"
+        : !configured
+            ? "disconnected"
+            : runtime?.linkState || "unknown";
+    const statusText = !enabled
+        ? "disabled"
+        : !configured
+            ? "config_missing"
+            : runtime?.statusText || "not_started";
+    return {
+        channel,
+        enabled,
+        configured,
+        running: runtime?.running === true,
+        linkState,
+        statusText,
+        detail: {
+            ...(runtime?.detail || {}),
+            config: buildChatChannelConfigSummary(context, channel, channelAccount),
+            configuration: toJsonObject(getChatChannelConfiguration(channel).describe()),
+        },
+    };
+}
+/**
+ * 更新内存配置与 downcity.json 中的 channel enabled 状态。
+ */
+export async function setChatChannelEnabled(params) {
+    const { context, channel, enabled } = params;
+    const configPlugins = (context.config.plugins ??= {});
+    const chatConfig = (configPlugins.chat ??= {});
+    const channelConfigs = (chatConfig.channels ??= {});
+    const channelConfig = (channelConfigs[channel] ??= {});
+    channelConfig.enabled = enabled;
+    const shipPath = path.join(context.rootPath, "downcity.json");
+    let shipJson = {};
+    try {
+        const raw = await fs.readFile(shipPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            shipJson = parsed;
+        }
+    }
+    catch {
+        shipJson = {};
+    }
+    const shipPlugins = (shipJson.plugins ??= {});
+    const shipChat = (shipPlugins.chat ??= {});
+    const shipChannels = (shipChat.channels ??= {});
+    const shipChannel = (shipChannels[channel] ??= {});
+    shipChannel.enabled = enabled;
+    await fs.writeFile(shipPath, `${JSON.stringify(shipJson, null, 2)}\n`, "utf-8");
+}
+function isJsonObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function readOptionalStringPatch(value) {
+    if (value === null)
+        return null;
+    if (typeof value === "string") {
+        const text = value.trim();
+        return text || null;
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return String(value);
+    }
+    return undefined;
+}
+function readOptionalBooleanPatch(value) {
+    if (value === true)
+        return true;
+    if (value === false)
+        return false;
+    if (typeof value === "string") {
+        const text = value.trim().toLowerCase();
+        if (text === "true" || text === "1")
+            return true;
+        if (text === "false" || text === "0")
+            return false;
+    }
+    return undefined;
+}
+function readOptionalNumberPatch(value) {
+    if (value === null)
+        return null;
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "string") {
+        const text = value.trim();
+        if (!text)
+            return null;
+        const parsed = Number(text);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return undefined;
+}
+function normalizePatchFieldValue(params) {
+    const { field, value } = params;
+    if (field.type === "boolean") {
+        if (value === null)
+            return field.nullable ? null : undefined;
+        return readOptionalBooleanPatch(value);
+    }
+    if (field.type === "number") {
+        const normalized = readOptionalNumberPatch(value);
+        if (normalized === null) {
+            return field.nullable ? null : undefined;
+        }
+        return normalized;
+    }
+    const normalizedText = readOptionalStringPatch(value);
+    if (normalizedText === null) {
+        return field.nullable ? null : undefined;
+    }
+    if (normalizedText === undefined) {
+        return undefined;
+    }
+    if (field.type === "enum" && Array.isArray(field.options) && field.options.length > 0) {
+        const allowed = new Set(field.options.map((item) => String(item.value || "").trim()).filter(Boolean));
+        if (!allowed.has(normalizedText)) {
+            throw new Error(`Invalid value for ${field.key}: ${normalizedText}. Allowed: ${[...allowed].join(", ")}`);
+        }
+    }
+    return normalizedText;
+}
+/**
+ * 解析 chat.configure patch。
+ */
+export function normalizeChatChannelConfigPatch(params) {
+    const configDefinition = getChatChannelConfiguration(params.channel);
+    const writableFields = configDefinition.getWritableShipFields();
+    const patch = {};
+    for (const field of writableFields) {
+        if (!Object.prototype.hasOwnProperty.call(params.config, field.key))
+            continue;
+        const rawValue = params.config[field.key];
+        const normalizedValue = normalizePatchFieldValue({
+            field,
+            value: rawValue,
+        });
+        if (normalizedValue === undefined)
+            continue;
+        patch[field.key] = normalizedValue;
+    }
+    return patch;
+}
+function applyChannelPatch(target, patch) {
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null) {
+            delete target[key];
+            continue;
+        }
+        target[key] = value;
+    }
+}
+/**
+ * 更新单个 channel 配置（内存 + downcity.json）。
+ */
+export async function setChatChannelConfig(params) {
+    const { context, channel, patch } = params;
+    if (Object.keys(patch).length === 0)
+        return;
+    const configPlugins = (context.config.plugins ??= {});
+    const chatConfig = (configPlugins.chat ??= {});
+    const channelConfigs = (chatConfig.channels ??= {});
+    const channelConfig = (channelConfigs[channel] ??= {});
+    applyChannelPatch(channelConfig, patch);
+    const shipPath = path.join(context.rootPath, "downcity.json");
+    let shipJson = {};
+    try {
+        const raw = await fs.readFile(shipPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            shipJson = parsed;
+        }
+    }
+    catch {
+        shipJson = {};
+    }
+    const shipPlugins = (shipJson.plugins ??= {});
+    const shipChat = (shipPlugins.chat ??= {});
+    const shipChannels = (shipChat.channels ??= {});
+    const shipChannel = (shipChannels[channel] ??= {});
+    applyChannelPatch(shipChannel, patch);
+    await fs.writeFile(shipPath, `${JSON.stringify(shipJson, null, 2)}\n`, "utf-8");
+}
+/**
+ * 读取渠道 configuration 描述。
+ */
+export function describeChatChannelConfiguration(channel) {
+    return toJsonObject(getChatChannelConfiguration(channel).describe());
+}
+/**
+ * 读取全部渠道 configuration 描述。
+ */
+export function listChatChannelConfigurationDescriptions() {
+    return listChatChannelConfigurations().map((item) => toJsonObject(item.describe()));
+}
+/**
+ * 判断输入是否为 JSON object。
+ */
+export function isChatChannelConfigObject(value) {
+    return isJsonObject(value);
+}
+//# sourceMappingURL=ChatChannelConfig.js.map

package/bin/chat/runtime/ChatChannelConfig.js.map

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

package/bin/chat/runtime/ChatChannelCore.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ChatChannelCore：chat 渠道状态的核心共享辅助模块。
+ *
+ * 关键点（中文）
+ * - 这里只放最基础的渠道状态/名称/account 解析能力。
+ * - 生命周期、配置写入、action 执行分别放到更细的模块中。
+ * - 目标是让 chat channel 子模块共享同一套最小公共基元。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { StoredChannelAccount } from "@downcity/agent/internal/types/runtime/host/Store.js";
+import type { ChatChannelName } from "../../chat/types/ChannelStatus.js";
+import type { ChatChannelState } from "../../chat/types/ChatRuntime.js";
+/**
+ * 创建 chat 渠道状态对象。
+ */
+export declare function createChatChannelState(): ChatChannelState;
+/**
+ * 解析并校验渠道名。
+ */
+export declare function resolveChatChannelNameOrThrow(value: string): ChatChannelName;
+/**
+ * 解析目标渠道列表。
+ */
+export declare function resolveTargetChannels(channel?: ChatChannelName): ChatChannelName[];
+/**
+ * 读取渠道绑定的 bot account id。
+ */
+export declare function resolveChannelAccountId(context: AgentContext, channel: ChatChannelName): string;
+/**
+ * 解析渠道 account。
+ *
+ * 关键点（中文）
+ * - 优先使用 ChatPlugin 实例上的显式解析逻辑。
+ * - 若未命中，再回退到默认全局账号池 `~/.downcity/downcity.db`。
+ */
+export declare function resolveChannelAccount(context: AgentContext, channel: ChatChannelName): StoredChannelAccount | null;
+/**
+ * 判断渠道 credentials 是否已经配置完整。
+ */
+export declare function isChannelAccountConfigured(channel: ChatChannelName, account: StoredChannelAccount | null): boolean;
+/**
+ * 判断指定渠道当前是否启用。
+ */
+export declare function isChatChannelEnabled(context: AgentContext, channel: ChatChannelName): boolean;
+/**
+ * 读取当前渠道 bot 实例。
+ */
+export declare function getChatChannelBot(state: ChatChannelState, channel: ChatChannelName): import("../channels/feishu/Feishu.js").FeishuBot | import("../channels/qq/QQ.js").QQBot | import("../channels/telegram/Bot.js").TelegramBot | null;
+//# sourceMappingURL=ChatChannelCore.d.ts.map

package/bin/chat/runtime/ChatChannelCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelCore.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatChannelCore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAuBpE;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAMzD;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAY5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAElF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,GACvB,MAAM,CAQR;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,GACvB,oBAAoB,GAAG,IAAI,CAW7B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,oBAAoB,GAAG,IAAI,GACnC,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,GACvB,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,eAAe,sJAKzB"}

package/bin/chat/runtime/ChatChannelCore.js

@@ -0,0 +1,109 @@
+/**
+ * ChatChannelCore：chat 渠道状态的核心共享辅助模块。
+ *
+ * 关键点（中文）
+ * - 这里只放最基础的渠道状态/名称/account 解析能力。
+ * - 生命周期、配置写入、action 执行分别放到更细的模块中。
+ * - 目标是让 chat channel 子模块共享同一套最小公共基元。
+ */
+import { getStoredChannelAccountSync } from "../../chat/accounts/Store.js";
+const CHAT_CHANNEL_NAMES = ["telegram", "feishu", "qq"];
+function resolveChatPluginBindings(context) {
+    const candidate = context.agent?.pluginInstances?.get?.("chat");
+    return candidate || null;
+}
+/**
+ * 创建 chat 渠道状态对象。
+ */
+export function createChatChannelState() {
+    return {
+        telegram: null,
+        feishu: null,
+        qq: null,
+    };
+}
+/**
+ * 解析并校验渠道名。
+ */
+export function resolveChatChannelNameOrThrow(value) {
+    const normalized = String(value || "")
+        .trim()
+        .toLowerCase();
+    if (normalized === "telegram" ||
+        normalized === "feishu" ||
+        normalized === "qq") {
+        return normalized;
+    }
+    throw new Error(`Invalid channel: ${value}. Use telegram|feishu|qq.`);
+}
+/**
+ * 解析目标渠道列表。
+ */
+export function resolveTargetChannels(channel) {
+    return channel ? [channel] : [...CHAT_CHANNEL_NAMES];
+}
+/**
+ * 读取渠道绑定的 bot account id。
+ */
+export function resolveChannelAccountId(context, channel) {
+    const plugin = resolveChatPluginBindings(context);
+    const explicit = String(plugin?.getChannelAccountId?.(context, channel) || "").trim();
+    if (explicit)
+        return explicit;
+    const config = context.config.plugins?.chat?.channels?.[channel];
+    return String(config?.channelAccountId || "").trim();
+}
+/**
+ * 解析渠道 account。
+ *
+ * 关键点（中文）
+ * - 优先使用 ChatPlugin 实例上的显式解析逻辑。
+ * - 若未命中，再回退到默认全局账号池 `~/.downcity/downcity.db`。
+ */
+export function resolveChannelAccount(context, channel) {
+    const plugin = resolveChatPluginBindings(context);
+    const explicit = plugin?.resolveChannelAccount?.(context, channel);
+    if (explicit)
+        return explicit;
+    const channelAccountId = resolveChannelAccountId(context, channel);
+    const account = channelAccountId
+        ? getStoredChannelAccountSync(channelAccountId)
+        : null;
+    if (!account)
+        return null;
+    if (account.channel !== channel)
+        return null;
+    return account;
+}
+/**
+ * 判断渠道 credentials 是否已经配置完整。
+ */
+export function isChannelAccountConfigured(channel, account) {
+    if (!account)
+        return false;
+    if (channel === "telegram") {
+        return !!String(account.botToken || "").trim();
+    }
+    return !!String(account.appId || "").trim() && !!String(account.appSecret || "").trim();
+}
+/**
+ * 判断指定渠道当前是否启用。
+ */
+export function isChatChannelEnabled(context, channel) {
+    const plugin = resolveChatPluginBindings(context);
+    if (typeof plugin?.isChannelEnabled === "function") {
+        return plugin.isChannelEnabled(context, channel);
+    }
+    return context.config.plugins?.chat?.channels?.[channel]?.enabled === true;
+}
+/**
+ * 读取当前渠道 bot 实例。
+ */
+export function getChatChannelBot(state, channel) {
+    if (channel === "telegram")
+        return state.telegram;
+    if (channel === "feishu")
+        return state.feishu;
+    return state.qq;
+}
+//# sourceMappingURL=ChatChannelCore.js.map

package/bin/chat/runtime/ChatChannelCore.js.map

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

package/bin/chat/runtime/ChatChannelFacade.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ChatChannelFacade：chat 渠道子模块门面。
+ *
+ * 关键点（中文）
+ * - 这里只负责把 channel 相关子模块重新聚合为一个稳定入口。
+ * - 内部实现已经拆为 core / lifecycle / config / actions 四层。
+ * - 这样可以在不影响 `ChatPlugin` 与 action 调用方的前提下，持续收敛复杂度。
+ */
+export { createChatChannelState, resolveChatChannelNameOrThrow, } from "./ChatChannelCore.js";
+export { startChatChannels, stopChatChannels } from "./ChatChannelLifecycle.js";
+export { executeChatStatusAction, executeChatTestAction, executeChatReconnectAction, executeChatOpenAction, executeChatCloseAction, executeChatConfigurationAction, executeChatConfigureAction, } from "./ChatChannelActions.js";
+//# sourceMappingURL=ChatChannelFacade.d.ts.map

package/bin/chat/runtime/ChatChannelFacade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelFacade.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatChannelFacade.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}

package/bin/chat/runtime/ChatChannelFacade.js

@@ -0,0 +1,12 @@
+/**
+ * ChatChannelFacade：chat 渠道子模块门面。
+ *
+ * 关键点（中文）
+ * - 这里只负责把 channel 相关子模块重新聚合为一个稳定入口。
+ * - 内部实现已经拆为 core / lifecycle / config / actions 四层。
+ * - 这样可以在不影响 `ChatPlugin` 与 action 调用方的前提下，持续收敛复杂度。
+ */
+export { createChatChannelState, resolveChatChannelNameOrThrow, } from "./ChatChannelCore.js";
+export { startChatChannels, stopChatChannels } from "./ChatChannelLifecycle.js";
+export { executeChatStatusAction, executeChatTestAction, executeChatReconnectAction, executeChatOpenAction, executeChatCloseAction, executeChatConfigurationAction, executeChatConfigureAction, } from "./ChatChannelActions.js";
+//# sourceMappingURL=ChatChannelFacade.js.map

package/bin/chat/runtime/ChatChannelFacade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelFacade.js","sourceRoot":"","sources":["../../../src/chat/runtime/ChatChannelFacade.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}

package/bin/chat/runtime/ChatChannelLifecycle.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ChatChannelLifecycle：chat 渠道生命周期模块。
+ *
+ * 关键点（中文）
+ * - 渠道 bot 的创建、启动、停止逻辑统一收敛在这里。
+ * - 渠道 bot 状态归属于 chat plugin runtime 实例持有的 `ChatChannelState`。
+ * - 本模块不处理 downcity.json 写入，也不负责 action 输入输出包装。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ChatChannelState } from "../../chat/types/ChatRuntime.js";
+import type { ChatChannelName } from "../../chat/types/ChannelStatus.js";
+/**
+ * 启动单个渠道。
+ */
+export declare function startSingleChatChannel(state: ChatChannelState, context: AgentContext, channel: ChatChannelName): Promise<void>;
+/**
+ * 停止单个渠道。
+ */
+export declare function stopSingleChatChannel(state: ChatChannelState, channel: ChatChannelName): Promise<void>;
+/**
+ * 启动全部已启用的 chat 渠道。
+ */
+export declare function startChatChannels(state: ChatChannelState, context: AgentContext): Promise<void>;
+/**
+ * 停止全部 chat 渠道。
+ */
+export declare function stopChatChannels(state: ChatChannelState): Promise<void>;
+//# sourceMappingURL=ChatChannelLifecycle.d.ts.map

package/bin/chat/runtime/ChatChannelLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelLifecycle.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatChannelLifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AA+ErE;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe7E"}

package/bin/chat/runtime/ChatChannelLifecycle.js

@@ -0,0 +1,132 @@
+/**
+ * ChatChannelLifecycle：chat 渠道生命周期模块。
+ *
+ * 关键点（中文）
+ * - 渠道 bot 的创建、启动、停止逻辑统一收敛在这里。
+ * - 渠道 bot 状态归属于 chat plugin runtime 实例持有的 `ChatChannelState`。
+ * - 本模块不处理 downcity.json 写入，也不负责 action 输入输出包装。
+ */
+import { createTelegramBot } from "../../chat/channels/telegram/Bot.js";
+import { createFeishuBot } from "../../chat/channels/feishu/Feishu.js";
+import { createQQBot } from "../../chat/channels/qq/QQ.js";
+import { isChatChannelEnabled, resolveChannelAccount, resolveTargetChannels, } from "./ChatChannelCore.js";
+async function startTelegramChannel(state, context) {
+    if (!isChatChannelEnabled(context, "telegram"))
+        return;
+    context.logger.info("Telegram channel enabled");
+    const account = resolveChannelAccount(context, "telegram");
+    const token = String(account?.botToken || "").trim();
+    if (!token)
+        return;
+    state.telegram = createTelegramBot({
+        enabled: true,
+        botToken: token,
+    }, context);
+    if (state.telegram) {
+        await state.telegram.start();
+    }
+}
+async function startFeishuChannel(state, context) {
+    if (!isChatChannelEnabled(context, "feishu"))
+        return;
+    context.logger.info("Feishu channel enabled");
+    const account = resolveChannelAccount(context, "feishu");
+    const appId = String(account?.appId || "").trim();
+    const appSecret = String(account?.appSecret || "").trim();
+    if (!appId || !appSecret)
+        return;
+    state.feishu = await createFeishuBot({
+        enabled: true,
+        appId,
+        appSecret,
+        domain: String(account?.domain || "").trim() || "https://open.feishu.cn",
+    }, context);
+    if (state.feishu) {
+        await state.feishu.start();
+    }
+}
+async function startQQChannel(state, context) {
+    if (!isChatChannelEnabled(context, "qq"))
+        return;
+    context.logger.info("QQ channel enabled");
+    const account = resolveChannelAccount(context, "qq");
+    const appId = String(account?.appId || "").trim();
+    const appSecret = String(account?.appSecret || "").trim();
+    if (!appId || !appSecret)
+        return;
+    state.qq = await createQQBot({
+        enabled: true,
+        appId,
+        appSecret,
+        sandbox: account?.sandbox === true,
+    }, context);
+    if (state.qq) {
+        await state.qq.start();
+    }
+}
+/**
+ * 启动单个渠道。
+ */
+export async function startSingleChatChannel(state, context, channel) {
+    if (channel === "telegram") {
+        await startTelegramChannel(state, context);
+        return;
+    }
+    if (channel === "feishu") {
+        await startFeishuChannel(state, context);
+        return;
+    }
+    await startQQChannel(state, context);
+}
+/**
+ * 停止单个渠道。
+ */
+export async function stopSingleChatChannel(state, channel) {
+    if (channel === "telegram" && state.telegram) {
+        const bot = state.telegram;
+        state.telegram = null;
+        await bot.stop();
+        return;
+    }
+    if (channel === "feishu" && state.feishu) {
+        const bot = state.feishu;
+        state.feishu = null;
+        await bot.stop();
+        return;
+    }
+    if (channel === "qq" && state.qq) {
+        const bot = state.qq;
+        state.qq = null;
+        await bot.stop();
+    }
+}
+/**
+ * 启动全部已启用的 chat 渠道。
+ */
+export async function startChatChannels(state, context) {
+    if (state.telegram || state.feishu || state.qq) {
+        await stopChatChannels(state);
+    }
+    for (const channel of resolveTargetChannels()) {
+        await startSingleChatChannel(state, context, channel);
+    }
+}
+/**
+ * 停止全部 chat 渠道。
+ */
+export async function stopChatChannels(state) {
+    const current = { ...state };
+    state.telegram = null;
+    state.feishu = null;
+    state.qq = null;
+    if (current.telegram) {
+        await current.telegram.stop();
+    }
+    if (current.feishu) {
+        await current.feishu.stop();
+    }
+    if (current.qq) {
+        await current.qq.stop();
+    }
+}
+//# sourceMappingURL=ChatChannelLifecycle.js.map

package/bin/chat/runtime/ChatChannelLifecycle.js.map

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