@downcity/plugins 1.0.174 → 1.0.194

package/src/chat/runtime/ChatChannelActions.ts

@@ -2,39 +2,22 @@
  * ChatChannelActions：chat 渠道 action 执行模块。
  *
  * 关键点（中文）
- * - status/test/reconnect/open/close/configuration/configure 的执行逻辑统一收敛在这里。
+ * - status/test/reconnect 的执行逻辑统一收敛在这里。
  * - 该模块复用 lifecycle/config 模块，不直接持有长期运行态。
  * - 对外只暴露 action 级入口，供 ChatPluginActions 装配使用。
  */
 
-import type {
-  AgentContext,
-  DowncityChatChannelConfig,
-  DowncityConfig,
-} from "@downcity/agent";
+import type { AgentContext } from "@downcity/agent";
 import type { ChatChannelState } from "@/chat/types/ChatRuntime.js";
-import { getStoredChannelAccountSync } from "@/chat/accounts/Store.js";
 import type {
-  ChatCloseActionPayload,
-  ChatConfigurationActionPayload,
-  ChatConfigureActionPayload,
-  ChatOpenActionPayload,
   ChatReconnectActionPayload,
   ChatStatusActionPayload,
   ChatTestActionPayload,
 } from "@/chat/types/ChatPluginActionPayload.js";
 import type { ChatChannelTestResult } from "@/chat/types/ChannelStatus.js";
-import type { ChatChannelName } from "@/chat/types/ChannelStatus.js";
-import {
-  describeChatChannelConfiguration,
-  getChatChannelStatus,
-  listChatChannelConfigurationDescriptions,
-  normalizeChatChannelConfigPatch,
-} from "./ChatChannelConfig.js";
+import { getChatChannelStatus } from "./ChatChannelConfig.js";
 import {
-  type ChatRuntimeBindings,
   getChatChannelBot,
-  resolveChatPluginBindings,
   resolveTargetChannels,
 } from "./ChatChannelCore.js";
 import {
@@ -42,66 +25,6 @@ import {
   stopSingleChatChannel,
 } from "./ChatChannelLifecycle.js";
 
-type ChatRuntimeControlBindings = ChatRuntimeBindings & {
-  applyChannelRuntimePatch: NonNullable<ChatRuntimeBindings["applyChannelRuntimePatch"]>;
-};
-
-function getChatRuntimeBindings(context: AgentContext): ChatRuntimeControlBindings {
-  const plugin = resolveChatPluginBindings(context);
-  if (!plugin?.applyChannelRuntimePatch) {
-    throw new Error("ChatPlugin runtime instance is not available");
-  }
-  return plugin as ChatRuntimeControlBindings;
-}
-
-/**
- * 将 channel patch 合并进完整 plugins 配置并交给宿主持久化。
- *
- * 关键点（中文）
- * - 始终写回完整 plugins 对象，避免覆盖其他 plugin 配置。
- * - 宿主持久化成功后才更新当前 context 快照，保证运行态与存储态一致。
- */
-async function persist_chat_channel_patches(params: {
-  context: AgentContext;
-  patches: Array<{
-    channel: ChatChannelName;
-    enabled?: boolean;
-    channel_account_id?: string | null;
-  }>;
-}): Promise<DowncityConfig["plugins"]> {
-  const current_plugins = params.context.config.plugins || {};
-  const current_chat = current_plugins.chat || {};
-  const next_channels = { ...(current_chat.channels || {}) };
-
-  for (const patch of params.patches) {
-    const current_channel = next_channels[patch.channel] || {};
-    const next_channel: DowncityChatChannelConfig = { ...current_channel };
-    if (typeof patch.enabled === "boolean") {
-      next_channel.enabled = patch.enabled;
-    }
-    if (Object.prototype.hasOwnProperty.call(patch, "channel_account_id")) {
-      const channel_account_id = String(patch.channel_account_id || "").trim();
-      if (channel_account_id) {
-        next_channel.channelAccountId = channel_account_id;
-      } else {
-        delete next_channel.channelAccountId;
-      }
-    }
-    next_channels[patch.channel] = next_channel;
-  }
-
-  const next_plugins: DowncityConfig["plugins"] = {
-    ...current_plugins,
-    chat: {
-      ...current_chat,
-      channels: next_channels,
-    },
-  };
-  await params.context.pluginConfig.persistProjectPlugins(next_plugins);
-  params.context.config.plugins = next_plugins;
-  return next_plugins;
-}
-
 /**
  * 执行 `chat.status` action。
  */
@@ -218,177 +141,3 @@ export async function executeChatReconnectAction(params: {
     },
   };
 }
-
-/**
- * 执行 `chat.open` action。
- */
-export async function executeChatOpenAction(params: {
-  state: ChatChannelState;
-  context: AgentContext;
-  payload: ChatOpenActionPayload;
-}) {
-  const targets = resolveTargetChannels(params.payload.channel);
-  const plugin = getChatRuntimeBindings(params.context);
-  await persist_chat_channel_patches({
-    context: params.context,
-    patches: targets.map((channel) => ({ channel, enabled: true })),
-  });
-  for (const channel of targets) {
-    plugin.applyChannelRuntimePatch({
-      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: {
-  state: ChatChannelState;
-  context: AgentContext;
-  payload: ChatCloseActionPayload;
-}) {
-  const targets = resolveTargetChannels(params.payload.channel);
-  const plugin = getChatRuntimeBindings(params.context);
-  await persist_chat_channel_patches({
-    context: params.context,
-    patches: targets.map((channel) => ({ channel, enabled: false })),
-  });
-  for (const channel of targets) {
-    await stopSingleChatChannel(params.state, channel);
-    plugin.applyChannelRuntimePatch({
-      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: {
-  context: AgentContext;
-  payload: ChatConfigurationActionPayload;
-}) {
-  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: {
-  state: ChatChannelState;
-  context: AgentContext;
-  payload: ChatConfigureActionPayload;
-}) {
-  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}`,
-        };
-      }
-    }
-  }
-
-  const plugin = getChatRuntimeBindings(params.context);
-  await persist_chat_channel_patches({
-    context: params.context,
-    patches: [{
-      channel,
-      ...(typeof patch.enabled === "boolean" ? { enabled: patch.enabled } : {}),
-      ...(Object.prototype.hasOwnProperty.call(patch, "channelAccountId")
-        ? { channel_account_id: String(patch.channelAccountId || "").trim() || null }
-        : {}),
-    }],
-  });
-  plugin.applyChannelRuntimePatch({
-    channel,
-    ...(typeof patch.enabled === "boolean" ? { enabled: patch.enabled } : {}),
-    ...(Object.prototype.hasOwnProperty.call(patch, "channelAccountId")
-      ? { channelAccountId: String(patch.channelAccountId || "").trim() || null }
-      : {}),
-  });
-
-  // 关键点（中文）：默认重载一次目标渠道，让新配置立刻生效。
-  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)],
-    },
-  };
-}

package/src/chat/runtime/ChatChannelConfig.ts

@@ -2,24 +2,19 @@
  * ChatChannelConfig：chat 渠道配置与状态快照模块。
  *
  * 关键点（中文）
- * - 渠道配置摘要、状态快照、patch 归一化都收敛在这里。
- * - chat.configure 的配置持久化由宿主能力承载，运行态更新由 ChatPlugin 实例承载。
- * - 该模块不直接负责 action 流程控制，只提供可复用的底层能力。
+ * - 渠道配置摘要与状态快照统一收敛在这里。
+ * - Plugin 只读取宿主构造时传入的 channel 配置，不负责修改或持久化。
  */
 
-import type { JsonObject, JsonValue } from "@downcity/agent";
+import type { JsonObject } from "@downcity/agent";
 import type { AgentContext } from "@downcity/agent";
 import type { StoredChannelAccount } from "@downcity/agent";
 import type {
   ChatChannelName,
   ChatChannelStateSnapshot,
 } from "@/chat/types/ChannelStatus.js";
-import type { ChatChannelConfigurationField } from "@/chat/types/ChannelConfiguration.js";
 import type { ChatChannelState } from "@/chat/types/ChatRuntime.js";
-import {
-  getChatChannelConfiguration,
-  listChatChannelConfigurations,
-} from "@/chat/channels/ConfigurationRegistry.js";
+import { getChatChannelConfiguration } from "@/chat/channels/ConfigurationRegistry.js";
 import {
   getChatChannelBot,
   isChatChannelEnabled,
@@ -106,127 +101,3 @@ export function getChatChannelStatus(
     },
   };
 }
-
-function isJsonObject(value: JsonValue): value is JsonObject {
-  return !!value && typeof value === "object" && !Array.isArray(value);
-}
-
-function readOptionalStringPatch(value: JsonValue): string | null | undefined {
-  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: JsonValue): boolean | undefined {
-  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: JsonValue): number | null | undefined {
-  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: {
-  field: ChatChannelConfigurationField;
-  value: JsonValue;
-}): string | number | boolean | null | undefined {
-  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: {
-  channel: ChatChannelName;
-  config: Record<string, JsonValue>;
-}): Record<string, string | number | boolean | null> {
-  const configDefinition = getChatChannelConfiguration(params.channel);
-  const writableFields = configDefinition.get_writable_agent_config_fields();
-  const patch: Record<string, string | number | boolean | null> = {};
-
-  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;
-}
-
-/**
- * 读取渠道 configuration 描述。
- */
-export function describeChatChannelConfiguration(channel: ChatChannelName): JsonObject {
-  return toJsonObject(getChatChannelConfiguration(channel).describe());
-}
-
-/**
- * 读取全部渠道 configuration 描述。
- */
-export function listChatChannelConfigurationDescriptions(): JsonObject[] {
-  return listChatChannelConfigurations().map((item) => toJsonObject(item.describe()));
-}
-
-/**
- * 判断输入是否为 JSON object。
- */
-export function isChatChannelConfigObject(value: JsonValue): value is JsonObject {
-  return isJsonObject(value);
-}

package/src/chat/runtime/ChatChannelCore.ts

@@ -22,26 +22,12 @@ export type ChatRuntimeBindings = {
     channel: ChatChannelName,
   ): StoredChannelAccount | null;
   isChannelEnabled?(context: AgentContext, channel: ChatChannelName): boolean;
-  applyChannelRuntimePatch?(params: {
-    /**
-     * 目标渠道。
-     */
-    channel: ChatChannelName;
-    /**
-     * 是否启用该渠道。
-     */
-    enabled?: boolean;
-    /**
-     * 绑定的账号池记录 ID；传入 null 表示清空绑定。
-     */
-    channelAccountId?: string | null;
-  }): void;
 };
 
 export function resolveChatPluginBindings(
   context: AgentContext,
 ): ChatRuntimeBindings | null {
-  const candidate = context.pluginInstances?.get?.("chat") as
+  const candidate = context.plugins.get("chat") as
     | ChatRuntimeBindings
     | undefined;
   return candidate || null;

package/src/chat/runtime/ChatChannelFacade.ts

@@ -16,8 +16,4 @@ export {
   executeChatStatusAction,
   executeChatTestAction,
   executeChatReconnectAction,
-  executeChatOpenAction,
-  executeChatCloseAction,
-  executeChatConfigurationAction,
-  executeChatConfigureAction,
 } from "./ChatChannelActions.js";

package/src/chat/runtime/ChatHistoryStore.ts

@@ -11,6 +11,7 @@ import fs from "fs-extra";
 import path from "node:path";
 import { generateId } from "@downcity/agent";
 import type { AgentContext } from "@downcity/agent";
+import { get_chat_history_path } from "@/chat/runtime/ChatStorage.js";
 import type { JsonObject } from "@downcity/agent";
 import type { ChatDispatchChannel } from "@/chat/types/ChatDispatcher.js";
 import type {
@@ -163,7 +164,7 @@ export async function appendInboundChatHistory(params: {
     extra: toOptionalObject(params.extra),
   });
 
-  const file = params.context.paths.getDowncityChatHistoryPath(sessionId);
+  const file = get_chat_history_path(params.context.rootPath, sessionId);
   await fs.ensureDir(path.dirname(file));
   await fs.appendFile(file, JSON.stringify(event) + "\n", "utf8");
 }
@@ -206,7 +207,7 @@ export async function appendOutboundChatHistory(params: {
     extra: toOptionalObject(params.extra),
   });
 
-  const file = params.context.paths.getDowncityChatHistoryPath(sessionId);
+  const file = get_chat_history_path(params.context.rootPath, sessionId);
   await fs.ensureDir(path.dirname(file));
   await fs.appendFile(file, JSON.stringify(event) + "\n", "utf8");
 }
@@ -228,7 +229,7 @@ export async function readChatHistory(params: {
 }): Promise<{ historyPath: string; events: ChatHistoryEventV1[] }> {
   const rootPath = normalizeTrimmedString(params.context.rootPath);
   const sessionId = normalizeTrimmedString(params.sessionId);
-  const historyPath = params.context.paths.getDowncityChatHistoryPath(sessionId);
+  const historyPath = get_chat_history_path(params.context.rootPath, sessionId);
   if (!rootPath || !sessionId) {
     return {
       historyPath,