@downcity/agent 1.1.25 → 1.1.35

package/bin/plugin/builtins/chat/runtime/ChatActionInput.js

@@ -0,0 +1,114 @@
+/**
+ * ChatActionInput：chat plugin runtime 的 CLI 输入映射模块。
+ *
+ * 关键点（中文）
+ * - 这里统一处理命令行到 action payload 的转换。
+ * - 所有校验错误都尽量在输入层 fail-fast，避免进入执行层后才发现参数非法。
+ * - `chat send` 的 frontmatter / <file> 协议也在这里完成标准化解析。
+ */
+import { resolveChatKey } from "../../../../plugin/builtins/chat/Action.js";
+import { resolveChatChannelNameOrThrow } from "../../../../plugin/builtins/chat/runtime/ChatChannelFacade.js";
+import { getBooleanOpt, getStringOpt, isJsonObject, parseOptionalTimestampOrThrow, parsePositiveIntOptionOrThrow, readHistoryDirectionOrThrow, } from "./ChatActionInputSupport.js";
+export { mapChatSendCommandInput, } from "./ChatSendActionInput.js";
+export function mapChatChannelCommandInput(input) {
+    const channelRaw = getStringOpt(input.opts, "channel");
+    if (!channelRaw)
+        return {};
+    return {
+        channel: resolveChatChannelNameOrThrow(channelRaw),
+    };
+}
+export function mapChatListCommandInput(input) {
+    const channelRaw = getStringOpt(input.opts, "channel");
+    const limitRaw = getStringOpt(input.opts, "limit");
+    const q = getStringOpt(input.opts, "q");
+    const channel = channelRaw ? resolveChatChannelNameOrThrow(channelRaw) : undefined;
+    const limit = limitRaw ? parsePositiveIntOptionOrThrow(limitRaw, "limit") : undefined;
+    return {
+        ...(channel ? { channel } : {}),
+        ...(typeof limit === "number" ? { limit } : {}),
+        ...(q ? { q } : {}),
+    };
+}
+export function mapChatInfoCommandInput(input) {
+    const chatKey = getStringOpt(input.opts, "chatKey");
+    const sessionId = getStringOpt(input.opts, "sessionId");
+    return {
+        ...(chatKey ? { chatKey } : {}),
+        ...(sessionId ? { sessionId } : {}),
+    };
+}
+export function mapChatConfigureCommandInput(input) {
+    const channelRaw = getStringOpt(input.opts, "channel");
+    if (!channelRaw) {
+        throw new Error("Missing --channel. Use telegram|feishu|qq.");
+    }
+    const channel = resolveChatChannelNameOrThrow(channelRaw);
+    const rawConfigJson = getStringOpt(input.opts, "configJson");
+    if (!rawConfigJson) {
+        throw new Error("Missing --config-json.");
+    }
+    let parsed = {};
+    try {
+        parsed = JSON.parse(rawConfigJson);
+    }
+    catch (error) {
+        throw new Error(`Invalid --config-json: ${String(error)}`);
+    }
+    if (!isJsonObject(parsed)) {
+        throw new Error("--config-json must be a JSON object");
+    }
+    return {
+        channel,
+        config: parsed,
+        restart: getBooleanOpt(input.opts, "restart"),
+    };
+}
+export function mapChatHistoryCommandInput(input) {
+    const chatKey = getStringOpt(input.opts, "chatKey");
+    const sessionId = getStringOpt(input.opts, "sessionId");
+    const direction = readHistoryDirectionOrThrow(getStringOpt(input.opts, "direction"));
+    const limitRaw = getStringOpt(input.opts, "limit");
+    const beforeTs = parseOptionalTimestampOrThrow(getStringOpt(input.opts, "beforeTs"), "beforeTs");
+    const afterTs = parseOptionalTimestampOrThrow(getStringOpt(input.opts, "afterTs"), "afterTs");
+    const limit = limitRaw ? parsePositiveIntOptionOrThrow(limitRaw, "limit") : undefined;
+    if (typeof beforeTs === "number" &&
+        typeof afterTs === "number" &&
+        afterTs >= beforeTs) {
+        throw new Error("Invalid range: afterTs must be less than beforeTs.");
+    }
+    return {
+        ...(chatKey ? { chatKey } : {}),
+        ...(sessionId ? { sessionId } : {}),
+        ...(typeof limit === "number" ? { limit } : {}),
+        ...(direction ? { direction } : {}),
+        ...(typeof beforeTs === "number" ? { beforeTs } : {}),
+        ...(typeof afterTs === "number" ? { afterTs } : {}),
+    };
+}
+export function mapChatReactCommandInput(input) {
+    const chatKey = resolveChatKey({
+        chatKey: getStringOpt(input.opts, "chatKey"),
+    });
+    if (!chatKey) {
+        throw new Error("Missing chatKey. Provide --chat-key or ensure DC_CTX_CHAT_KEY is injected in current shell context.");
+    }
+    const emoji = getStringOpt(input.opts, "emoji");
+    const messageId = getStringOpt(input.opts, "messageId");
+    const big = getBooleanOpt(input.opts, "big");
+    return {
+        chatKey,
+        ...(emoji ? { emoji } : {}),
+        ...(messageId ? { messageId } : {}),
+        ...(big ? { big: true } : {}),
+    };
+}
+export function mapChatDeleteCommandInput(input) {
+    const chatKey = getStringOpt(input.opts, "chatKey");
+    const sessionId = getStringOpt(input.opts, "sessionId");
+    return {
+        ...(chatKey ? { chatKey } : {}),
+        ...(sessionId ? { sessionId } : {}),
+    };
+}
+//# sourceMappingURL=ChatActionInput.js.map

package/bin/plugin/builtins/chat/runtime/ChatActionInput.js.map

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

package/bin/plugin/builtins/chat/runtime/ChatActionInputSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatActionInputSupport.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatActionInputSupport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEpE;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,UAAU,CAElE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,GAAG,EAAE,MAAM,GACV,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,GAAG,EAAE,MAAM,GACV,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,CAaR;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAIpB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,GACZ,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAS5C"}

package/bin/plugin/builtins/chat/runtime/ChatActionInputSupport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatActionInputSupport.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatActionInputSupport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,IAA+B,EAC/B,GAAW;IAEX,OAAO,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,IAA+B,EAC/B,GAAW;IAEX,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAa,EACb,SAAiB;IAEjB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,cAAc,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,KAAK,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,KAAK,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAa,EACb,SAAiB;IAEjB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,6BAA6B,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAa;IAEb,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;SAC7B,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IACjB,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,6BAA6B,CAAC,CAAC;AAC5E,CAAC"}

package/bin/plugin/builtins/chat/runtime/ChatChannelActions.d.ts

@@ -0,0 +1,122 @@
+/**
+ * ChatChannelActions：chat 渠道 action 执行模块。
+ *
+ * 关键点（中文）
+ * - status/test/reconnect/open/close/configuration/configure 的执行逻辑统一收敛在这里。
+ * - 该模块复用 lifecycle/config 模块，不直接持有长期运行态。
+ * - 对外只暴露 action 级入口，供 ChatPluginActions 装配使用。
+ */
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+import type { ChatChannelState } from "../../../../plugin/builtins/chat/types/ChatRuntime.js";
+import type { ChatCloseActionPayload, ChatConfigurationActionPayload, ChatConfigureActionPayload, ChatOpenActionPayload, ChatReconnectActionPayload, ChatStatusActionPayload, ChatTestActionPayload } from "../../../../plugin/builtins/chat/types/ChatPluginActionPayload.js";
+import type { ChatChannelTestResult } from "../../../../plugin/builtins/chat/types/ChannelStatus.js";
+/**
+ * 执行 `chat.status` action。
+ */
+export declare function executeChatStatusAction(params: {
+    state: ChatChannelState;
+    context: AgentContext;
+    payload: ChatStatusActionPayload;
+}): Promise<{
+    success: boolean;
+    data: {
+        channels: import("../../../../plugin/builtins/chat/types/ChannelStatus.js").ChatChannelStateSnapshot[];
+    };
+}>;
+/**
+ * 执行 `chat.test` action。
+ */
+export declare function executeChatTestAction(params: {
+    state: ChatChannelState;
+    context: AgentContext;
+    payload: ChatTestActionPayload;
+}): Promise<{
+    success: boolean;
+    data: {
+        results: ChatChannelTestResult[];
+        total: number;
+        failed: number;
+    };
+}>;
+/**
+ * 执行 `chat.reconnect` action。
+ */
+export declare function executeChatReconnectAction(params: {
+    state: ChatChannelState;
+    context: AgentContext;
+    payload: ChatReconnectActionPayload;
+}): Promise<{
+    success: boolean;
+    error: string;
+    data?: undefined;
+} | {
+    success: boolean;
+    data: {
+        channels: import("../../../../plugin/builtins/chat/types/ChannelStatus.js").ChatChannelStateSnapshot[];
+    };
+    error?: undefined;
+}>;
+/**
+ * 执行 `chat.open` action。
+ */
+export declare function executeChatOpenAction(params: {
+    state: ChatChannelState;
+    context: AgentContext;
+    payload: ChatOpenActionPayload;
+}): Promise<{
+    success: boolean;
+    data: {
+        channels: import("../../../../plugin/builtins/chat/types/ChannelStatus.js").ChatChannelStateSnapshot[];
+    };
+}>;
+/**
+ * 执行 `chat.close` action。
+ */
+export declare function executeChatCloseAction(params: {
+    state: ChatChannelState;
+    context: AgentContext;
+    payload: ChatCloseActionPayload;
+}): Promise<{
+    success: boolean;
+    data: {
+        channels: import("../../../../plugin/builtins/chat/types/ChannelStatus.js").ChatChannelStateSnapshot[];
+    };
+}>;
+/**
+ * 执行 `chat.configuration` action。
+ */
+export declare function executeChatConfigurationAction(params: {
+    context: AgentContext;
+    payload: ChatConfigurationActionPayload;
+}): Promise<{
+    success: boolean;
+    data: {
+        channels: {
+            channel: import("../../../../plugin/builtins/chat/types/ChannelStatus.js").ChatChannelName;
+            configuration: import("../../../../index.js").JsonObject;
+        }[];
+        allChannels: import("../../../../index.js").JsonObject[];
+    };
+}>;
+/**
+ * 执行 `chat.configure` action。
+ */
+export declare function executeChatConfigureAction(params: {
+    state: ChatChannelState;
+    context: AgentContext;
+    payload: ChatConfigureActionPayload;
+}): Promise<{
+    success: boolean;
+    error: string;
+    data?: undefined;
+} | {
+    success: boolean;
+    data: {
+        channel: import("../../../../plugin/builtins/chat/types/ChannelStatus.js").ChatChannelName;
+        restartApplied: boolean;
+        appliedKeys: string[];
+        channels: import("../../../../plugin/builtins/chat/types/ChannelStatus.js").ChatChannelStateSnapshot[];
+    };
+    error?: undefined;
+}>;
+//# sourceMappingURL=ChatChannelActions.d.ts.map

package/bin/plugin/builtins/chat/runtime/ChatChannelActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelActions.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatChannelActions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,KAAK,EACV,sBAAsB,EACtB,8BAA8B,EAC9B,0BAA0B,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,yDAAyD,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAkB3F;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,uBAAuB,CAAC;CAClC;;;;;GAWA;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,qBAAqB,CAAC;CAChC;;;;;;;GA6CA;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,0BAA0B,CAAC;CACrC;;;;;;;;;;GAkCA;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,qBAAqB,CAAC;CAChC;;;;;GA0BA;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,sBAAsB,CAAC;CACjC;;;;;GAoBA;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAAC,MAAM,EAAE;IAC3D,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,8BAA8B,CAAC;CACzC;;;;;;;;;GAcA;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,0BAA0B,CAAC;CACrC;;;;;;;;;;;;;GA0DA"}

package/bin/plugin/builtins/chat/runtime/ChatChannelActions.js

@@ -0,0 +1,230 @@
+/**
+ * ChatChannelActions：chat 渠道 action 执行模块。
+ *
+ * 关键点（中文）
+ * - status/test/reconnect/open/close/configuration/configure 的执行逻辑统一收敛在这里。
+ * - 该模块复用 lifecycle/config 模块，不直接持有长期运行态。
+ * - 对外只暴露 action 级入口，供 ChatPluginActions 装配使用。
+ */
+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 account = params.context.platform.getChannelAccount(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}`,
+                };
+            }
+        }
+    }
+    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/plugin/builtins/chat/runtime/ChatChannelActions.js.map

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

package/bin/plugin/builtins/chat/runtime/ChatChannelConfig.d.ts

@@ -0,0 +1,61 @@
+/**
+ * ChatChannelConfig：chat 渠道配置与状态快照模块。
+ *
+ * 关键点（中文）
+ * - 渠道配置摘要、状态快照、patch 归一化、downcity.json 落盘都收敛在这里。
+ * - 所有配置写入都遵循“先改内存，再落盘”的一致性顺序。
+ * - 该模块不直接负责 action 流程控制，只提供可复用的底层能力。
+ */
+import type { JsonObject, JsonValue } from "../../../../types/common/Json.js";
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+import type { StoredChannelAccount } from "../../../../types/runtime/host/Store.js";
+import type { ChatChannelName, ChatChannelStateSnapshot } from "../../../../plugin/builtins/chat/types/ChannelStatus.js";
+import type { ChatChannelState } from "../../../../plugin/builtins/chat/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/plugin/builtins/chat/runtime/ChatChannelConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelConfig.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/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,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACzB,MAAM,+CAA+C,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAiBpF;;;;;;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,CAuBlD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,GACvB,wBAAwB,CA8B1B;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"}