@downcity/agent 1.1.35 → 1.1.43

package/src/plugin/builtins/chat/runtime/ChatChannelActions.ts

@@ -1,307 +0,0 @@
-/**
- * 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";
-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: {
-  state: ChatChannelState;
-  context: AgentContext;
-  payload: ChatStatusActionPayload;
-}) {
-  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: {
-  state: ChatChannelState;
-  context: AgentContext;
-  payload: ChatTestActionPayload;
-}) {
-  const channels = resolveTargetChannels(params.payload.channel);
-  const results: ChatChannelTestResult[] = [];
-  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: {
-  state: ChatChannelState;
-  context: AgentContext;
-  payload: ChatReconnectActionPayload;
-}) {
-  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: {
-  state: ChatChannelState;
-  context: AgentContext;
-  payload: ChatOpenActionPayload;
-}) {
-  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: {
-  state: ChatChannelState;
-  context: AgentContext;
-  payload: ChatCloseActionPayload;
-}) {
-  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: {
-  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 = 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)],
-    },
-  };
-}

package/src/plugin/builtins/chat/runtime/ChatChannelConfig.ts

@@ -1,330 +0,0 @@
-/**
- * ChatChannelConfig：chat 渠道配置与状态快照模块。
- *
- * 关键点（中文）
- * - 渠道配置摘要、状态快照、patch 归一化、downcity.json 落盘都收敛在这里。
- * - 所有配置写入都遵循“先改内存，再落盘”的一致性顺序。
- * - 该模块不直接负责 action 流程控制，只提供可复用的底层能力。
- */
-
-import fs from "node:fs/promises";
-import path from "node:path";
-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 { ChatChannelConfigurationField } from "@/plugin/builtins/chat/types/ChannelConfiguration.js";
-import type { ChatChannelState } from "@/plugin/builtins/chat/types/ChatRuntime.js";
-import {
-  getChatChannelConfiguration,
-  listChatChannelConfigurations,
-} from "@/plugin/builtins/chat/channels/ConfigurationRegistry.js";
-import {
-  getChatChannelBot,
-  isChatChannelEnabled,
-  isChannelAccountConfigured,
-  resolveChannelAccount,
-  resolveChannelAccountId,
-} from "./ChatChannelCore.js";
-
-function toJsonObject(input: unknown): JsonObject {
-  return JSON.parse(JSON.stringify(input)) as JsonObject;
-}
-
-/**
- * 生成可安全暴露给 UI 的渠道配置摘要。
- *
- * 关键点（中文）
- * - 不返回明文密钥，只返回布尔“是否已配置”。
- * - 字段命名尽量贴近 `downcity.json`，便于前端直接映射编辑。
- */
-export function buildChatChannelConfigSummary(
-  context: AgentContext,
-  channel: ChatChannelName,
-  accountInput?: StoredChannelAccount | null,
-): Record<string, string | number | boolean | null> {
-  const account = accountInput ?? resolveChannelAccount(context, channel);
-  const channelAccountId = resolveChannelAccountId(context, channel);
-  const configured = isChannelAccountConfigured(channel, account);
-  if (channel === "telegram") {
-    return {
-      enabled: isChatChannelEnabled(context, channel),
-      channelAccountId: channelAccountId || null,
-      channelAccountConfigured: configured,
-    };
-  }
-  if (channel === "feishu") {
-    return {
-      enabled: isChatChannelEnabled(context, channel),
-      channelAccountId: channelAccountId || null,
-      channelAccountConfigured: configured,
-    };
-  }
-  return {
-    enabled: isChatChannelEnabled(context, channel),
-    channelAccountId: channelAccountId || null,
-    channelAccountConfigured: configured,
-  };
-}
-
-/**
- * 读取单个渠道状态快照。
- */
-export function getChatChannelStatus(
-  state: ChatChannelState,
-  context: AgentContext,
-  channel: ChatChannelName,
-): ChatChannelStateSnapshot {
-  const enabled = isChatChannelEnabled(context, channel);
-  const channelAccount = resolveChannelAccount(context, channel);
-  const configured = isChannelAccountConfigured(channel, channelAccount);
-
-  const runtime = getChatChannelBot(state, channel)?.getExecutorStatus();
-  const linkState = !enabled
-    ? "disconnected"
-    : !configured
-      ? "disconnected"
-      : runtime?.linkState || "unknown";
-  const statusText = !enabled
-    ? "disabled"
-    : !configured
-      ? "config_missing"
-      : runtime?.statusText || "not_started";
-
-  return {
-    channel,
-    enabled,
-    configured,
-    running: runtime?.running === true,
-    linkState,
-    statusText,
-    detail: {
-      ...(runtime?.detail || {}),
-      config: buildChatChannelConfigSummary(context, channel, channelAccount),
-      configuration: toJsonObject(getChatChannelConfiguration(channel).describe()),
-    },
-  };
-}
-
-/**
- * 更新内存配置与 downcity.json 中的 channel enabled 状态。
- */
-export async function setChatChannelEnabled(params: {
-  context: AgentContext;
-  channel: ChatChannelName;
-  enabled: boolean;
-}): Promise<void> {
-  const { context, channel, enabled } = params;
-
-  const configPlugins = ((context.config.plugins ??= {}) as {
-    chat?: {
-      channels?: Record<string, Record<string, unknown>>;
-    };
-  });
-  const chatConfig = (configPlugins.chat ??= {});
-  const channelConfigs = (chatConfig.channels ??= {});
-  const channelConfig = (channelConfigs[channel] ??= {});
-  channelConfig.enabled = enabled;
-
-  const shipPath = path.join(context.rootPath, "downcity.json");
-  let shipJson: Record<string, unknown> = {};
-  try {
-    const raw = await fs.readFile(shipPath, "utf-8");
-    const parsed = JSON.parse(raw) as unknown;
-    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-      shipJson = parsed as Record<string, unknown>;
-    }
-  } catch {
-    shipJson = {};
-  }
-
-  const shipPlugins = ((shipJson.plugins ??= {}) as Record<string, unknown>);
-  const shipChat = ((shipPlugins.chat ??= {}) as Record<string, unknown>);
-  const shipChannels = ((shipChat.channels ??= {}) as Record<string, unknown>);
-  const shipChannel = ((shipChannels[channel] ??= {}) as Record<string, unknown>);
-  shipChannel.enabled = enabled;
-
-  await fs.writeFile(shipPath, `${JSON.stringify(shipJson, null, 2)}\n`, "utf-8");
-}
-
-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.getWritableShipFields();
-  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;
-}
-
-function applyChannelPatch(
-  target: Record<string, unknown>,
-  patch: Record<string, string | number | boolean | null>,
-): void {
-  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: {
-  context: AgentContext;
-  channel: ChatChannelName;
-  patch: Record<string, string | number | boolean | null>;
-}): Promise<void> {
-  const { context, channel, patch } = params;
-  if (Object.keys(patch).length === 0) return;
-
-  const configPlugins = ((context.config.plugins ??= {}) as {
-    chat?: {
-      channels?: Record<string, Record<string, unknown>>;
-    };
-  });
-  const chatConfig = (configPlugins.chat ??= {});
-  const channelConfigs = (chatConfig.channels ??= {});
-  const channelConfig = (channelConfigs[channel] ??= {});
-  applyChannelPatch(channelConfig, patch);
-
-  const shipPath = path.join(context.rootPath, "downcity.json");
-  let shipJson: Record<string, unknown> = {};
-  try {
-    const raw = await fs.readFile(shipPath, "utf-8");
-    const parsed = JSON.parse(raw) as unknown;
-    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-      shipJson = parsed as Record<string, unknown>;
-    }
-  } catch {
-    shipJson = {};
-  }
-
-  const shipPlugins = ((shipJson.plugins ??= {}) as Record<string, unknown>);
-  const shipChat = ((shipPlugins.chat ??= {}) as Record<string, unknown>);
-  const shipChannels = ((shipChat.channels ??= {}) as Record<string, unknown>);
-  const shipChannel = ((shipChannels[channel] ??= {}) as Record<string, unknown>);
-  applyChannelPatch(shipChannel, patch);
-
-  await fs.writeFile(shipPath, `${JSON.stringify(shipJson, null, 2)}\n`, "utf-8");
-}
-
-/**
- * 读取渠道 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);
-}