@downcity/plugins 1.0.215 → 1.0.233

package/src/chat/channels/Configuration.ts

@@ -1,35 +0,0 @@
-/**
- * Chat 渠道配置描述器基类。
- *
- * 关键点（中文）
- * - 每个 channel 继承该基类，集中声明自己的配置字段。
- * - 统一提供“可写 Agent 配置字段”提取逻辑，避免在 service 中重复硬编码。
- */
-
-import type {
-  ChatChannelConfigurationDescriptor,
-  ChatChannelConfigurationField,
-} from "@/chat/types/ChannelConfiguration.js";
-import type { ChatChannelName } from "@/chat/types/ChannelStatus.js";
-
-/**
- * Chat 渠道配置描述器抽象基类。
- */
-export abstract class ChatChannelConfiguration {
-  /**
-   * 绑定渠道名。
-   */
-  abstract readonly channel: ChatChannelName;
-
-  /**
-   * 返回完整配置描述。
-   */
-  abstract describe(): ChatChannelConfigurationDescriptor;
-
-  /**
-   * 返回允许上游产品编辑的 Agent 配置字段定义。
-   */
-  get_writable_agent_config_fields(): ChatChannelConfigurationField[] {
-    return this.describe().fields.agent_config.filter((field) => field.writable);
-  }
-}

package/src/chat/channels/ConfigurationRegistry.ts

@@ -1,43 +0,0 @@
-/**
- * Chat 渠道配置描述器注册表。
- *
- * 关键点（中文）
- * - 统一管理各 channel 的 Configuration 实例，避免业务侧散落 import。
- * - 提供按渠道查询与全量枚举能力，便于 Console / DB 复用。
- */
-
-import { TelegramChannelConfiguration } from "@/chat/channels/telegram/Configuration.js";
-import { FeishuChannelConfiguration } from "@/chat/channels/feishu/Configuration.js";
-import { QqChannelConfiguration } from "@/chat/channels/qq/Configuration.js";
-import type { ChatChannelConfiguration } from "@/chat/channels/Configuration.js";
-import type { ChatChannelName } from "@/chat/types/ChannelStatus.js";
-
-const TELEGRAM_CONFIGURATION = new TelegramChannelConfiguration();
-const FEISHU_CONFIGURATION = new FeishuChannelConfiguration();
-const QQ_CONFIGURATION = new QqChannelConfiguration();
-
-const CHANNEL_CONFIGURATION_REGISTRY: Record<
-  ChatChannelName,
-  ChatChannelConfiguration
-> = {
-  telegram: TELEGRAM_CONFIGURATION,
-  feishu: FEISHU_CONFIGURATION,
-  qq: QQ_CONFIGURATION,
-};
-
-/**
- * 按渠道读取配置描述器。
- */
-export function getChatChannelConfiguration(
-  channel: ChatChannelName,
-): ChatChannelConfiguration {
-  return CHANNEL_CONFIGURATION_REGISTRY[channel];
-}
-
-/**
- * 枚举所有渠道配置描述器。
- */
-export function listChatChannelConfigurations(): ChatChannelConfiguration[] {
-  return Object.values(CHANNEL_CONFIGURATION_REGISTRY);
-}
-

package/src/chat/channels/feishu/Configuration.ts

@@ -1,65 +0,0 @@
-/**
- * Feishu 渠道配置描述。
- *
- * 关键点（中文）
- * - ship 层只保留绑定字段。
- * - appId/appSecret/domain 由 chat account 维护。
- */
-
-import { ChatChannelConfiguration } from "@/chat/channels/Configuration.js";
-import type { ChatChannelConfigurationDescriptor } from "@/chat/types/ChannelConfiguration.js";
-
-/**
- * Feishu 渠道配置描述器。
- */
-export class FeishuChannelConfiguration extends ChatChannelConfiguration {
-  readonly channel = "feishu" as const;
-
-  describe(): ChatChannelConfigurationDescriptor {
-    return {
-      channel: this.channel,
-      title: "Feishu Chat Platform Configuration",
-      description:
-        "Bind a Feishu/Lark chat account and control runtime enable/disable state.",
-      version: "1.0.0",
-      capabilities: {
-        canToggleEnabled: true,
-        canBindChannelAccount: true,
-        canConfigure: true,
-      },
-      fields: {
-        agent_config: [
-          {
-            key: "enabled",
-            label: "Enabled",
-            description:
-              "Whether feishu channel should be started by runtime.",
-            type: "boolean",
-            source: "agent_config",
-            required: false,
-            nullable: false,
-            writable: true,
-            restartRequired: true,
-            defaultValue: false,
-            example: true,
-          },
-          {
-            key: "channelAccountId",
-            label: "Chat Account ID",
-            description:
-              "Bind this chat platform to a channel_accounts row in the global downcity.db.",
-            type: "string",
-            source: "agent_config",
-            required: false,
-            nullable: true,
-            writable: true,
-            restartRequired: true,
-            example: "feishu-main",
-          },
-        ],
-        channelAccount: [],
-        envFallback: [],
-      },
-    };
-  }
-}

package/src/chat/channels/qq/Configuration.ts

@@ -1,64 +0,0 @@
-/**
- * QQ 渠道配置描述。
- *
- * 关键点（中文）
- * - ship 层只保留 `enabled` 与 `channelAccountId`。
- * - QQ 专属参数（sandbox 等）在 chat account 中维护。
- */
-
-import { ChatChannelConfiguration } from "@/chat/channels/Configuration.js";
-import type { ChatChannelConfigurationDescriptor } from "@/chat/types/ChannelConfiguration.js";
-
-/**
- * QQ 渠道配置描述器。
- */
-export class QqChannelConfiguration extends ChatChannelConfiguration {
-  readonly channel = "qq" as const;
-
-  describe(): ChatChannelConfigurationDescriptor {
-    return {
-      channel: this.channel,
-      title: "QQ Chat Platform Configuration",
-      description:
-        "Bind a QQ chat account and control runtime enable/disable state.",
-      version: "1.0.0",
-      capabilities: {
-        canToggleEnabled: true,
-        canBindChannelAccount: true,
-        canConfigure: true,
-      },
-      fields: {
-        agent_config: [
-          {
-            key: "enabled",
-            label: "Enabled",
-            description: "Whether qq channel should be started by runtime.",
-            type: "boolean",
-            source: "agent_config",
-            required: false,
-            nullable: false,
-            writable: true,
-            restartRequired: true,
-            defaultValue: false,
-            example: true,
-          },
-          {
-            key: "channelAccountId",
-            label: "Chat Account ID",
-            description:
-              "Bind this chat platform to a channel_accounts row in the global downcity.db.",
-            type: "string",
-            source: "agent_config",
-            required: false,
-            nullable: true,
-            writable: true,
-            restartRequired: true,
-            example: "qq-main",
-          },
-        ],
-        channelAccount: [],
-        envFallback: [],
-      },
-    };
-  }
-}

package/src/chat/channels/telegram/Configuration.ts

@@ -1,65 +0,0 @@
-/**
- * Telegram 渠道配置描述。
- *
- * 关键点（中文）
- * - ship 层只绑定 `enabled` 与 `channelAccountId`。
- * - 真实密钥由 chat account 统一托管。
- */
-
-import { ChatChannelConfiguration } from "@/chat/channels/Configuration.js";
-import type { ChatChannelConfigurationDescriptor } from "@/chat/types/ChannelConfiguration.js";
-
-/**
- * Telegram 渠道配置描述器。
- */
-export class TelegramChannelConfiguration extends ChatChannelConfiguration {
-  readonly channel = "telegram" as const;
-
-  describe(): ChatChannelConfigurationDescriptor {
-    return {
-      channel: this.channel,
-      title: "Telegram Chat Platform Configuration",
-      description:
-        "Bind a Telegram chat account and control runtime enable/disable state.",
-      version: "1.0.0",
-      capabilities: {
-        canToggleEnabled: true,
-        canBindChannelAccount: true,
-        canConfigure: true,
-      },
-      fields: {
-        agent_config: [
-          {
-            key: "enabled",
-            label: "Enabled",
-            description:
-              "Whether telegram channel should be started by runtime.",
-            type: "boolean",
-            source: "agent_config",
-            required: false,
-            nullable: false,
-            writable: true,
-            restartRequired: true,
-            defaultValue: false,
-            example: true,
-          },
-          {
-            key: "channelAccountId",
-            label: "Chat Account ID",
-            description:
-              "Bind this chat platform to a channel_accounts row in the global downcity.db.",
-            type: "string",
-            source: "agent_config",
-            required: false,
-            nullable: true,
-            writable: true,
-            restartRequired: true,
-            example: "telegram-main",
-          },
-        ],
-        channelAccount: [],
-        envFallback: [],
-      },
-    };
-  }
-}

package/src/chat/types/ChannelAccount.ts

@@ -1,232 +0,0 @@
-/**
- * Chat account 管理类型。
- *
- * 关键点（中文）
- * - 这些类型描述 agent 运行时内部的 chat account 管理输入输出。
- * - 凭据明文只允许出现在写入输入中，读取结果必须是脱敏后的安全视图。
- */
-
-import type { StoredChannelAccountChannel } from "@downcity/agent";
-
-/**
- * 支持的 chat account 平台类型。
- */
-export type ChatChannelAccountChannel = StoredChannelAccountChannel;
-
-/**
- * Chat account 探测结果。
- */
-export interface ChatChannelAccountProbeResult {
-  /**
-   * 账号所属 chat platform。
-   */
-  channel: ChatChannelAccountChannel;
-  /**
-   * 系统生成的账号 ID。
-   */
-  accountId: string;
-  /**
-   * 账号展示名称。
-   */
-  name: string;
-  /**
-   * 平台身份展示文案，例如 bot username 或 app id。
-   */
-  identity?: string;
-  /**
-   * 平台返回的所有者信息。
-   */
-  owner?: string;
-  /**
-   * 平台返回的创建者信息。
-   */
-  creator?: string;
-  /**
-   * 平台返回的 bot 用户 ID。
-   */
-  botUserId?: string;
-  /**
-   * 面向用户的探测结果说明。
-   */
-  message: string;
-}
-
-/**
- * Chat account 列表中的安全视图。
- */
-export interface ChatChannelAccountListItem {
-  /**
-   * 账号 ID。
-   */
-  id: string;
-  /**
-   * 账号所属 chat platform。
-   */
-  channel: ChatChannelAccountChannel;
-  /**
-   * 账号展示名称。
-   */
-  name: string;
-  /**
-   * 平台身份展示文案。
-   */
-  identity?: string;
-  /**
-   * 平台所有者信息。
-   */
-  owner?: string;
-  /**
-   * 平台创建者信息。
-   */
-  creator?: string;
-  /**
-   * 渠道域名，例如 Feishu/Lark 域。
-   */
-  domain?: string;
-  /**
-   * QQ 沙箱模式开关。
-   */
-  sandbox: boolean;
-  /**
-   * 是否保存了 bot token。
-   */
-  hasBotToken: boolean;
-  /**
-   * 是否保存了 app id。
-   */
-  hasAppId: boolean;
-  /**
-   * 是否保存了 app secret。
-   */
-  hasAppSecret: boolean;
-  /**
-   * 脱敏后的 bot token。
-   */
-  botTokenMasked?: string;
-  /**
-   * 脱敏后的 app id。
-   */
-  appIdMasked?: string;
-  /**
-   * 脱敏后的 app secret。
-   */
-  appSecretMasked?: string;
-  /**
-   * 创建时间（ISO 字符串）。
-   */
-  createdAt: string;
-  /**
-   * 更新时间（ISO 字符串）。
-   */
-  updatedAt: string;
-}
-
-/**
- * Chat account 列表结果。
- */
-export interface ChatChannelAccountListResult {
-  /**
-   * 脱敏后的账号列表。
-   */
-  items: ChatChannelAccountListItem[];
-}
-
-/**
- * Chat account 写入输入。
- */
-export interface ChatChannelAccountUpsertInput {
-  /**
-   * 账号 ID。
-   */
-  id: string;
-  /**
-   * 账号所属 chat platform。
-   */
-  channel: string;
-  /**
-   * 账号展示名称。
-   */
-  name: string;
-  /**
-   * 平台身份展示文案。
-   */
-  identity?: string;
-  /**
-   * 平台所有者信息。
-   */
-  owner?: string;
-  /**
-   * 平台创建者信息。
-   */
-  creator?: string;
-  /**
-   * Telegram bot token。
-   */
-  botToken?: string;
-  /**
-   * Feishu/QQ app id。
-   */
-  appId?: string;
-  /**
-   * Feishu/QQ app secret。
-   */
-  appSecret?: string;
-  /**
-   * Feishu/Lark 域名。
-   */
-  domain?: string;
-  /**
-   * QQ 沙箱模式。
-   */
-  sandbox?: boolean;
-  /**
-   * 是否清空 bot token。
-   */
-  clearBotToken?: boolean;
-  /**
-   * 是否清空 app id。
-   */
-  clearAppId?: boolean;
-  /**
-   * 是否清空 app secret。
-   */
-  clearAppSecret?: boolean;
-}
-
-/**
- * Chat account 凭据创建输入。
- */
-export interface ChatChannelAccountCreateInput {
-  /**
-   * 账号所属 chat platform。
-   */
-  channel: string;
-  /**
-   * 账号展示名称；未传时优先使用探测结果。
-   */
-  name?: string;
-  /**
-   * Telegram bot token。
-   */
-  botToken?: string;
-  /**
-   * Feishu/QQ app id。
-   */
-  appId?: string;
-  /**
-   * Feishu/QQ app secret。
-   */
-  appSecret?: string;
-  /**
-   * Feishu/Lark 域名。
-   */
-  domain?: string;
-  /**
-   * QQ 沙箱模式。
-   */
-  sandbox?: boolean;
-  /**
-   * 是否跳过自动探测。
-   */
-  probe?: boolean;
-}

package/src/chat/types/ChannelConfiguration.ts

@@ -1,160 +0,0 @@
-/**
- * Chat 渠道配置元信息类型。
- *
- * 关键点（中文）
- * - 每个 channel 通过统一结构声明“需要哪些参数、类型、描述、来源”。
- * - 该结构用于 Console / DB / CLI 直接消费，不依赖硬编码字段。
- */
-
-import type { ChatChannelName } from "@/chat/types/ChannelStatus.js";
-
-/**
- * 配置字段基础值类型。
- */
-export type ChatChannelConfigurationPrimitive = string | number | boolean | null;
-
-/**
- * 配置字段类型枚举。
- */
-export type ChatChannelConfigurationFieldType =
-  | "string"
-  | "boolean"
-  | "number"
-  | "secret"
-  | "enum";
-
-/**
- * 配置字段来源枚举。
- */
-export type ChatChannelConfigurationFieldSource =
-  | "agent_config"
-  | "bot_account"
-  | "env_fallback";
-
-/**
- * 枚举型字段可选项。
- */
-export interface ChatChannelConfigurationFieldOption {
-  /**
-   * 枚举值（真实写入值）。
-   */
-  value: string;
-  /**
-   * 展示标签（用于 UI 下拉选项）。
-   */
-  label: string;
-  /**
-   * 选项说明（用于帮助用户理解差异）。
-   */
-  description: string;
-}
-
-/**
- * 单个配置字段描述。
- */
-export interface ChatChannelConfigurationField {
-  /**
-   * 字段键名（例如 `channelAccountId`、`enabled`）。
-   */
-  key: string;
-  /**
-   * 字段展示名。
-   */
-  label: string;
-  /**
-   * 字段用途说明。
-   */
-  description: string;
-  /**
-   * 字段值类型。
-   */
-  type: ChatChannelConfigurationFieldType;
-  /**
-   * 字段值来源（Agent config / chat account / env fallback）。
-   */
-  source: ChatChannelConfigurationFieldSource;
-  /**
-   * 该字段是否必填。
-   */
-  required: boolean;
-  /**
-   * 字段是否允许 `null`（用于清空）。
-   */
-  nullable: boolean;
-  /**
-   * 是否允许上游产品写入。
-   */
-  writable: boolean;
-  /**
-   * 修改该字段后是否建议重载 channel。
-   */
-  restartRequired: boolean;
-  /**
-   * 默认值（可选）。
-   */
-  defaultValue?: ChatChannelConfigurationPrimitive;
-  /**
-   * 示例值（可选）。
-   */
-  example?: ChatChannelConfigurationPrimitive;
-  /**
-   * 枚举选项（仅 `type=enum` 时使用）。
-   */
-  options?: ChatChannelConfigurationFieldOption[];
-}
-
-/**
- * 单个渠道配置说明。
- */
-export interface ChatChannelConfigurationDescriptor {
-  /**
-   * 渠道名称。
-   */
-  channel: ChatChannelName;
-  /**
-   * 配置卡片标题。
-   */
-  title: string;
-  /**
-   * 配置说明（面向用户）。
-   */
-  description: string;
-  /**
-   * 描述器版本号（便于 UI 做兼容升级）。
-   */
-  version: string;
-  /**
-   * 该渠道支持的写入动作能力。
-   */
-  capabilities: {
-    /**
-     * 是否支持启用/禁用开关。
-     */
-    canToggleEnabled: boolean;
-    /**
-     * 是否支持 chat account 绑定。
-     */
-    canBindChannelAccount: boolean;
-    /**
-     * 上游产品是否支持编辑该渠道配置。
-     */
-    canConfigure: boolean;
-  };
-  /**
-   * 渠道配置字段集合（按来源分组）。
-   */
-  fields: {
-    /**
-     * Agent 全局配置可声明字段。
-     */
-    agent_config: ChatChannelConfigurationField[];
-    /**
-     * `channel_accounts` 字段。
-     */
-    channelAccount: ChatChannelConfigurationField[];
-    /**
-     * 环境变量回退字段。
-     */
-    envFallback: ChatChannelConfigurationField[];
-  };
-}