@downcity/plugins 1.0.4

package/bin/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 "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ChatChannelState } from "../../chat/types/ChatRuntime.js";
+import type { ChatCloseActionPayload, ChatConfigurationActionPayload, ChatConfigureActionPayload, ChatOpenActionPayload, ChatReconnectActionPayload, ChatStatusActionPayload, ChatTestActionPayload } from "../../chat/types/ChatPluginActionPayload.js";
+import type { ChatChannelTestResult } from "../../chat/types/ChannelStatus.js";
+/**
+ * 执行 `chat.status` action。
+ */
+export declare function executeChatStatusAction(params: {
+    state: ChatChannelState;
+    context: AgentContext;
+    payload: ChatStatusActionPayload;
+}): Promise<{
+    success: boolean;
+    data: {
+        channels: import("../../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("../../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("../../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("../../chat/types/ChannelStatus.js").ChatChannelStateSnapshot[];
+    };
+}>;
+/**
+ * 执行 `chat.configuration` action。
+ */
+export declare function executeChatConfigurationAction(params: {
+    context: AgentContext;
+    payload: ChatConfigurationActionPayload;
+}): Promise<{
+    success: boolean;
+    data: {
+        channels: {
+            channel: import("../../chat/types/ChannelStatus.js").ChatChannelName;
+            configuration: import("@downcity/agent/internal/types/common/Json.js").JsonObject;
+        }[];
+        allChannels: import("@downcity/agent/internal/types/common/Json.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("../../chat/types/ChannelStatus.js").ChatChannelName;
+        restartApplied: boolean;
+        appliedKeys: string[];
+        channels: import("../../chat/types/ChannelStatus.js").ChatChannelStateSnapshot[];
+    };
+    error?: undefined;
+}>;
+//# sourceMappingURL=ChatChannelActions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelActions.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatChannelActions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,KAAK,EACV,sBAAsB,EACtB,8BAA8B,EAC9B,0BAA0B,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAkB3E;;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/chat/runtime/ChatChannelActions.js

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelConfig.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatChannelConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AACjG,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACzB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAiBpE;;;;;;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"}