@downcity/agent 1.1.1

package/bin/services/chat/runtime/ChatChannelActions.js

@@ -0,0 +1,237 @@
+/**
+ * ChatChannelActions：chat 渠道 action 执行模块。
+ *
+ * 关键点（中文）
+ * - status/test/reconnect/open/close/configuration/configure 的执行逻辑统一收敛在这里。
+ * - 该模块复用 lifecycle/config 模块，不直接持有长期运行态。
+ * - 对外只暴露 action 级入口，供 ChatServiceActions 装配使用。
+ */
+import { ConsoleStore } from "../../../shared/utils/store/index.js";
+import { describeChatChannelConfiguration, getChatChannelStatus, listChatChannelConfigurationDescriptions, normalizeChatChannelConfigPatch, setChatChannelConfig, setChatChannelEnabled, } from "./ChatChannelConfig.js";
+import { getChatChannelBot, resolveTargetChannels, } from "./ChatChannelCore.js";
+import { startSingleChatChannel, stopSingleChatChannel, } from "./ChatChannelLifecycle.js";
+/**
+ * 执行 `chat.status` action。
+ */
+export async function executeChatStatusAction(params) {
+    const channels = resolveTargetChannels(params.payload.channel);
+    const items = channels.map((channel) => getChatChannelStatus(params.state, params.context, channel));
+    return {
+        success: true,
+        data: {
+            channels: items,
+        },
+    };
+}
+/**
+ * 执行 `chat.test` action。
+ */
+export async function executeChatTestAction(params) {
+    const channels = resolveTargetChannels(params.payload.channel);
+    const results = [];
+    for (const channel of channels) {
+        const snapshot = getChatChannelStatus(params.state, params.context, channel);
+        if (!snapshot.enabled) {
+            results.push({
+                channel,
+                success: false,
+                testedAtMs: Date.now(),
+                message: "Channel is disabled",
+            });
+            continue;
+        }
+        if (!snapshot.configured) {
+            results.push({
+                channel,
+                success: false,
+                testedAtMs: Date.now(),
+                message: "Channel credentials are missing",
+            });
+            continue;
+        }
+        const bot = getChatChannelBot(params.state, channel);
+        if (!bot) {
+            results.push({
+                channel,
+                success: false,
+                testedAtMs: Date.now(),
+                message: "Channel is not running. Use reconnect first.",
+            });
+            continue;
+        }
+        results.push(await bot.testConnection());
+    }
+    return {
+        success: true,
+        data: {
+            results,
+            total: results.length,
+            failed: results.filter((item) => !item.success).length,
+        },
+    };
+}
+/**
+ * 执行 `chat.reconnect` action。
+ */
+export async function executeChatReconnectAction(params) {
+    const targets = resolveTargetChannels(params.payload.channel);
+    for (const channel of targets) {
+        const snapshot = getChatChannelStatus(params.state, params.context, channel);
+        if (!snapshot.enabled) {
+            return {
+                success: false,
+                error: `Channel ${channel} is disabled`,
+            };
+        }
+        if (!snapshot.configured) {
+            return {
+                success: false,
+                error: `Channel ${channel} credentials are missing`,
+            };
+        }
+    }
+    for (const channel of targets) {
+        await stopSingleChatChannel(params.state, channel);
+    }
+    for (const channel of targets) {
+        await startSingleChatChannel(params.state, params.context, channel);
+    }
+    const channels = targets.map((channel) => getChatChannelStatus(params.state, params.context, channel));
+    return {
+        success: true,
+        data: {
+            channels,
+        },
+    };
+}
+/**
+ * 执行 `chat.open` action。
+ */
+export async function executeChatOpenAction(params) {
+    const targets = resolveTargetChannels(params.payload.channel);
+    for (const channel of targets) {
+        await setChatChannelEnabled({
+            context: params.context,
+            channel,
+            enabled: true,
+        });
+    }
+    for (const channel of targets) {
+        const snapshot = getChatChannelStatus(params.state, params.context, channel);
+        if (!snapshot.configured)
+            continue;
+        if (snapshot.running)
+            continue;
+        await startSingleChatChannel(params.state, params.context, channel);
+    }
+    const channels = targets.map((channel) => getChatChannelStatus(params.state, params.context, channel));
+    return {
+        success: true,
+        data: {
+            channels,
+        },
+    };
+}
+/**
+ * 执行 `chat.close` action。
+ */
+export async function executeChatCloseAction(params) {
+    const targets = resolveTargetChannels(params.payload.channel);
+    for (const channel of targets) {
+        await stopSingleChatChannel(params.state, channel);
+        await setChatChannelEnabled({
+            context: params.context,
+            channel,
+            enabled: false,
+        });
+    }
+    const channels = targets.map((channel) => getChatChannelStatus(params.state, params.context, channel));
+    return {
+        success: true,
+        data: {
+            channels,
+        },
+    };
+}
+/**
+ * 执行 `chat.configuration` action。
+ */
+export async function executeChatConfigurationAction(params) {
+    void params.context;
+    const targets = resolveTargetChannels(params.payload.channel);
+    const items = targets.map((channel) => ({
+        channel,
+        configuration: describeChatChannelConfiguration(channel),
+    }));
+    return {
+        success: true,
+        data: {
+            channels: items,
+            allChannels: listChatChannelConfigurationDescriptions(),
+        },
+    };
+}
+/**
+ * 执行 `chat.configure` action。
+ */
+export async function executeChatConfigureAction(params) {
+    const channel = params.payload.channel;
+    const patch = normalizeChatChannelConfigPatch({
+        channel,
+        config: params.payload.config || {},
+    });
+    if (Object.keys(patch).length === 0) {
+        return {
+            success: false,
+            error: "No valid config fields provided",
+        };
+    }
+    if (Object.prototype.hasOwnProperty.call(patch, "channelAccountId")) {
+        const channelAccountId = String(patch.channelAccountId || "").trim();
+        if (channelAccountId) {
+            const store = new ConsoleStore();
+            try {
+                const account = store.getChannelAccountSync(channelAccountId);
+                if (!account) {
+                    return {
+                        success: false,
+                        error: `Bot account not found: ${channelAccountId}`,
+                    };
+                }
+                if (account.channel !== channel) {
+                    return {
+                        success: false,
+                        error: `Bot account channel mismatch: expected ${channel}, got ${account.channel}`,
+                    };
+                }
+            }
+            finally {
+                store.close();
+            }
+        }
+    }
+    await setChatChannelConfig({
+        context: params.context,
+        channel,
+        patch,
+    });
+    // 关键点（中文）：默认重载一次目标渠道，让新配置立刻生效。
+    const restart = params.payload.restart !== false;
+    if (restart) {
+        await stopSingleChatChannel(params.state, channel);
+        const snapshot = getChatChannelStatus(params.state, params.context, channel);
+        if (snapshot.enabled && snapshot.configured) {
+            await startSingleChatChannel(params.state, params.context, channel);
+        }
+    }
+    return {
+        success: true,
+        data: {
+            channel,
+            restartApplied: restart,
+            appliedKeys: Object.keys(patch),
+            channels: [getChatChannelStatus(params.state, params.context, channel)],
+        },
+    };
+}
+//# sourceMappingURL=ChatChannelActions.js.map

package/bin/services/chat/runtime/ChatChannelActions.js.map

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

package/bin/services/chat/runtime/ChatChannelConfig.d.ts

@@ -0,0 +1,61 @@
+/**
+ * ChatChannelConfig：chat 渠道配置与状态快照模块。
+ *
+ * 关键点（中文）
+ * - 渠道配置摘要、状态快照、patch 归一化、downcity.json 落盘都收敛在这里。
+ * - 所有配置写入都遵循“先改内存，再落盘”的一致性顺序。
+ * - 该模块不直接负责 action 流程控制，只提供可复用的底层能力。
+ */
+import type { JsonObject, JsonValue } from "../../../shared/types/Json.js";
+import type { AgentContext } from "../../../types/agent/AgentContext.js";
+import type { StoredChannelAccount } from "../../../shared/types/Store.js";
+import type { ChatChannelName, ChatChannelStateSnapshot } from "../../chat/types/ChannelStatus.js";
+import type { ChatChannelState } from "../../../shared/types/ChatRuntime.js";
+/**
+ * 生成可安全暴露给 UI 的渠道配置摘要。
+ *
+ * 关键点（中文）
+ * - 不返回明文密钥，只返回布尔“是否已配置”。
+ * - 字段命名尽量贴近 `downcity.json`，便于前端直接映射编辑。
+ */
+export declare function buildChatChannelConfigSummary(context: AgentContext, channel: ChatChannelName, accountInput?: StoredChannelAccount | null): Record<string, string | number | boolean | null>;
+/**
+ * 读取单个渠道状态快照。
+ */
+export declare function getChatChannelStatus(state: ChatChannelState, context: AgentContext, channel: ChatChannelName): ChatChannelStateSnapshot;
+/**
+ * 更新内存配置与 downcity.json 中的 channel enabled 状态。
+ */
+export declare function setChatChannelEnabled(params: {
+    context: AgentContext;
+    channel: ChatChannelName;
+    enabled: boolean;
+}): Promise<void>;
+/**
+ * 解析 chat.configure patch。
+ */
+export declare function normalizeChatChannelConfigPatch(params: {
+    channel: ChatChannelName;
+    config: Record<string, JsonValue>;
+}): Record<string, string | number | boolean | null>;
+/**
+ * 更新单个 channel 配置（内存 + downcity.json）。
+ */
+export declare function setChatChannelConfig(params: {
+    context: AgentContext;
+    channel: ChatChannelName;
+    patch: Record<string, string | number | boolean | null>;
+}): Promise<void>;
+/**
+ * 读取渠道 configuration 描述。
+ */
+export declare function describeChatChannelConfiguration(channel: ChatChannelName): JsonObject;
+/**
+ * 读取全部渠道 configuration 描述。
+ */
+export declare function listChatChannelConfigurationDescriptions(): JsonObject[];
+/**
+ * 判断输入是否为 JSON object。
+ */
+export declare function isChatChannelConfigObject(value: JsonValue): value is JsonObject;
+//# sourceMappingURL=ChatChannelConfig.d.ts.map

package/bin/services/chat/runtime/ChatChannelConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelConfig.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/runtime/ChatChannelConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACzB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAgBtE;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,EACxB,YAAY,CAAC,EAAE,oBAAoB,GAAG,IAAI,GACzC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CA2BlD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,GACvB,wBAAwB,CA+B1B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgChB;AAiFD;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACnC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAgBnD;AAeD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;CACzD,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,eAAe,GAAG,UAAU,CAErF;AAED;;GAEG;AACH,wBAAgB,wCAAwC,IAAI,UAAU,EAAE,CAEvE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,UAAU,CAE/E"}

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

@@ -0,0 +1,265 @@
+/**
+ * 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, 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);
+    const channels = context.config.services?.chat?.channels;
+    if (channel === "telegram") {
+        const cfg = channels?.telegram;
+        return {
+            enabled: cfg?.enabled === true,
+            channelAccountId: channelAccountId || null,
+            channelAccountConfigured: configured,
+        };
+    }
+    if (channel === "feishu") {
+        const cfg = channels?.feishu;
+        return {
+            enabled: cfg?.enabled === true,
+            channelAccountId: channelAccountId || null,
+            channelAccountConfigured: configured,
+        };
+    }
+    const cfg = channels?.qq;
+    return {
+        enabled: cfg?.enabled === true,
+        channelAccountId: channelAccountId || null,
+        channelAccountConfigured: configured,
+    };
+}
+/**
+ * 读取单个渠道状态快照。
+ */
+export function getChatChannelStatus(state, context, channel) {
+    const channels = context.config.services?.chat?.channels || {};
+    const enabled = channels[channel]?.enabled === true;
+    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 configServices = (context.config.services ??= {});
+    const chatConfig = (configServices.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 shipServices = (shipJson.services ??= {});
+    const shipChat = (shipServices.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 configServices = (context.config.services ??= {});
+    const chatConfig = (configServices.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 shipServices = (shipJson.services ??= {});
+    const shipChat = (shipServices.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/services/chat/runtime/ChatChannelConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelConfig.js","sourceRoot":"","sources":["../../../../src/services/chat/runtime/ChatChannelConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAe,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAAqB,EACrB,OAAwB,EACxB,YAA0C;IAE1C,MAAM,OAAO,GAAG,YAAY,IAAI,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxE,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC;IACzD,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,QAAQ,EAAE,QAAQ,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI;YAC9B,gBAAgB,EAAE,gBAAgB,IAAI,IAAI;YAC1C,wBAAwB,EAAE,UAAU;SACrC,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,QAAQ,EAAE,MAAM,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI;YAC9B,gBAAgB,EAAE,gBAAgB,IAAI,IAAI;YAC1C,wBAAwB,EAAE,UAAU;SACrC,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,EAAE,EAAE,CAAC;IACzB,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI;QAC9B,gBAAgB,EAAE,gBAAgB,IAAI,IAAI;QAC1C,wBAAwB,EAAE,UAAU;KACrC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAuB,EACvB,OAAqB,EACrB,OAAwB;IAExB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC/D,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,MAAM,cAAc,GAAG,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,0BAA0B,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAEvE,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACvE,MAAM,SAAS,GAAG,CAAC,OAAO;QACxB,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,CAAC,UAAU;YACX,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,OAAO,EAAE,SAAS,IAAI,SAAS,CAAC;IACtC,MAAM,UAAU,GAAG,CAAC,OAAO;QACzB,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,CAAC,UAAU;YACX,CAAC,CAAC,gBAAgB;YAClB,CAAC,CAAC,OAAO,EAAE,UAAU,IAAI,aAAa,CAAC;IAE3C,OAAO;QACL,OAAO;QACP,OAAO;QACP,UAAU;QACV,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI;QAClC,SAAS;QACT,UAAU;QACV,MAAM,EAAE;YACN,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC;YAC1B,MAAM,EAAE,6BAA6B,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC;YACvE,aAAa,EAAE,YAAY,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;SAC7E;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAI3C;IACC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAE7C,MAAM,cAAc,GAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,KAAK,EAAE,CAIrD,CAAC;IACH,MAAM,UAAU,GAAG,CAAC,cAAc,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,CAAC,UAAU,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACvD,aAAa,CAAC,OAAO,GAAG,OAAO,CAAC;IAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC9D,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,QAAQ,GAAG,MAAiC,CAAC;QAC/C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,MAAM,YAAY,GAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,EAAE,CAA6B,CAAC;IAC7E,MAAM,QAAQ,GAAI,CAAC,YAAY,CAAC,IAAI,KAAK,EAAE,CAA6B,CAAC;IACzE,MAAM,YAAY,GAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,EAAE,CAA6B,CAAC;IAC7E,MAAM,WAAW,GAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,CAA6B,CAAC;IAChF,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC;IAE9B,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,YAAY,CAAC,KAAgB;IACpC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAgB;IAC/C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1B,OAAO,IAAI,IAAI,IAAI,CAAC;IACtB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAgB;IAChD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;IACrD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAgB;IAC/C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;IAC7C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,wBAAwB,CAAC,MAGjC;IACC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAEhC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7D,OAAO,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3C,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,cAAc,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3C,CAAC;IACD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtF,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAC7E,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,CAAC,GAAG,KAAK,cAAc,cAAc,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAG/C;IACC,MAAM,gBAAgB,GAAG,2BAA2B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,gBAAgB,CAAC,qBAAqB,EAAE,CAAC;IAChE,MAAM,KAAK,GAAqD,EAAE,CAAC;IAEnE,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC;YAAE,SAAS;QAC9E,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,eAAe,GAAG,wBAAwB,CAAC;YAC/C,KAAK;YACL,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QACH,IAAI,eAAe,KAAK,SAAS;YAAE,SAAS;QAC5C,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC;IACrC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CACxB,MAA+B,EAC/B,KAAuD;IAEvD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAI1C;IACC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAC3C,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE5C,MAAM,cAAc,GAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,KAAK,EAAE,CAIrD,CAAC;IACH,MAAM,UAAU,GAAG,CAAC,cAAc,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,CAAC,UAAU,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACvD,iBAAiB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC9D,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,QAAQ,GAAG,MAAiC,CAAC;QAC/C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,MAAM,YAAY,GAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,EAAE,CAA6B,CAAC;IAC7E,MAAM,QAAQ,GAAI,CAAC,YAAY,CAAC,IAAI,KAAK,EAAE,CAA6B,CAAC;IACzE,MAAM,YAAY,GAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,EAAE,CAA6B,CAAC;IAC7E,MAAM,WAAW,GAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,CAA6B,CAAC;IAChF,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAEtC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAClF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAAC,OAAwB;IACvE,OAAO,YAAY,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wCAAwC;IACtD,OAAO,6BAA6B,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;AACtF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAgB;IACxD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,41 @@
+/**
+ * ChatChannelCore：chat 渠道状态的核心共享辅助模块。
+ *
+ * 关键点（中文）
+ * - 这里只放最基础的渠道状态/名称/account 解析能力。
+ * - 生命周期、配置写入、action 执行分别放到更细的模块中。
+ * - 目标是让 chat channel 子模块共享同一套最小公共基元。
+ */
+import type { AgentContext } from "../../../types/agent/AgentContext.js";
+import type { StoredChannelAccount } from "../../../shared/types/Store.js";
+import type { ChatChannelName } from "../../chat/types/ChannelStatus.js";
+import type { ChatChannelState } from "../../../shared/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;
+/**
+ * 从 ConsoleStore 中解析渠道 account。
+ */
+export declare function resolveChannelAccount(context: AgentContext, channel: ChatChannelName): StoredChannelAccount | null;
+/**
+ * 判断渠道 credentials 是否已经配置完整。
+ */
+export declare function isChannelAccountConfigured(channel: ChatChannelName, account: StoredChannelAccount | null): 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/services/chat/runtime/ChatChannelCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelCore.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/runtime/ChatChannelCore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE;;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,CAKR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,GACvB,oBAAoB,GAAG,IAAI,CAc7B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,oBAAoB,GAAG,IAAI,GACnC,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,eAAe,sJAKzB"}