@downcity/plugins 1.0.254 → 1.0.280

package/src/chat/config/ChatPluginConfig.ts

@@ -1,266 +0,0 @@
-/**
- * Chat Plugin 的结构化配置协议。
- *
- * 关键点（中文）
- * - Zod Schema 是内建 Chat 行为配置与 Resource 配置的唯一源码。
- * - Plugin config 只描述 queue 行为，完整渠道配置由独立 Resource Item 承载。
- * - `readOnly` 字段由 Resource Resolver 写入，`writeOnly` 字段由 CLI 安全采集和脱敏。
- */
-
-import type { JsonObject } from "@downcity/agent";
-import { z } from "zod";
-import { resolveChatChannelBotInfo } from "@/chat/channels/BotInfoProvider.js";
-import type { ChatPluginResource } from "@/chat/types/ChatPluginResource.js";
-
-const resource_id_schema = z.string()
-  .trim()
-  .min(1)
-  .max(80)
-  .regex(/^[a-z0-9][a-z0-9_-]*$/u)
-  .meta({
-    title: "Resource ID",
-    description: "Stable Resource ID generated by City.",
-    readOnly: true,
-  });
-
-const resource_name_schema = z.string()
-  .trim()
-  .min(1)
-  .meta({
-    title: "Name",
-    description: "Display name written by the Resource Resolver.",
-    readOnly: true,
-  });
-
-const secret_schema = z.string()
-  .trim()
-  .min(1)
-  .meta({ writeOnly: true });
-
-/** Telegram Resource 完整配置 Schema。 */
-const telegram_resource_schema = z.object({
-  id: resource_id_schema,
-  type: z.literal("telegram").meta({ title: "Type" }),
-  name: resource_name_schema,
-  bot_token: secret_schema.meta({
-    title: "Bot Token",
-    description: "Telegram Bot API Token.",
-    writeOnly: true,
-  }),
-  username: z.string().trim().min(1).optional().meta({
-    title: "Username",
-    description: "Telegram username written by the Resource Resolver.",
-    readOnly: true,
-  }),
-  bot_user_id: z.string().trim().min(1).optional().meta({
-    title: "Bot User ID",
-    description: "Telegram Bot user ID written by the Resource Resolver.",
-    readOnly: true,
-  }),
-}).strict().meta({
-  title: "Telegram",
-  description: "Telegram Bot Resource.",
-});
-
-/** Feishu / Lark Resource 完整配置 Schema。 */
-const feishu_resource_schema = z.object({
-  id: resource_id_schema,
-  type: z.literal("feishu").meta({ title: "Type" }),
-  name: resource_name_schema,
-  app_id: z.string().trim().min(1).meta({
-    title: "App ID",
-    description: "Feishu or Lark App ID.",
-  }),
-  app_secret: secret_schema.meta({
-    title: "App Secret",
-    description: "Feishu or Lark App Secret.",
-    writeOnly: true,
-  }),
-  domain: z.url().optional().meta({
-    title: "Open API Domain",
-    description: "Optional Feishu or Lark Open API domain.",
-  }),
-  identity: z.string().trim().min(1).optional().meta({
-    title: "Identity",
-    readOnly: true,
-  }),
-  owner: z.string().trim().min(1).optional().meta({
-    title: "Owner",
-    readOnly: true,
-  }),
-  creator: z.string().trim().min(1).optional().meta({
-    title: "Creator",
-    readOnly: true,
-  }),
-  bot_user_id: z.string().trim().min(1).optional().meta({
-    title: "Bot User ID",
-    readOnly: true,
-  }),
-}).strict().meta({
-  title: "Feishu / Lark",
-  description: "Feishu or Lark Bot Resource.",
-});
-
-/** QQ Resource 完整配置 Schema。 */
-const qq_resource_schema = z.object({
-  id: resource_id_schema,
-  type: z.literal("qq").meta({ title: "Type" }),
-  name: resource_name_schema,
-  app_id: z.string().trim().min(1).meta({
-    title: "App ID",
-    description: "QQ Bot App ID.",
-  }),
-  app_secret: secret_schema.meta({
-    title: "App Secret",
-    description: "QQ Bot App Secret.",
-    writeOnly: true,
-  }),
-  sandbox: z.boolean().optional().meta({
-    title: "Sandbox",
-    description: "Whether to use the QQ sandbox environment.",
-    default: false,
-  }),
-  identity: z.string().trim().min(1).optional().meta({
-    title: "Identity",
-    readOnly: true,
-  }),
-  bot_user_id: z.string().trim().min(1).optional().meta({
-    title: "Bot User ID",
-    readOnly: true,
-  }),
-}).strict().meta({
-  title: "QQ",
-  description: "QQ Bot Resource.",
-});
-
-/** Chat Plugin 单个完整 Resource Item Schema。 */
-export const chat_plugin_resource_schema = z.discriminatedUnion("type", [
-  telegram_resource_schema,
-  feishu_resource_schema,
-  qq_resource_schema,
-]);
-
-/** Chat Plugin 完整配置 Schema。 */
-export const chat_plugin_config_schema = z.object({
-  queue: z.object({
-    max_concurrency: z.number()
-      .int()
-      .min(1)
-      .max(32)
-      .optional()
-      .meta({
-        title: "Maximum concurrency",
-        description: "Maximum number of chat lanes executed concurrently.",
-      }),
-    merge_debounce_ms: z.number()
-      .int()
-      .min(0)
-      .max(60_000)
-      .optional()
-      .meta({
-        title: "Merge debounce",
-        description: "Debounce window used to merge consecutive inbound messages.",
-      }),
-    merge_max_wait_ms: z.number()
-      .int()
-      .min(0)
-      .max(120_000)
-      .optional()
-      .meta({
-        title: "Maximum merge wait",
-        description: "Maximum time to wait before executing a merged inbound burst.",
-      }),
-  }).strict().optional().meta({
-    title: "Queue",
-    description: "Chat queue scheduling and inbound message merge behavior.",
-  }),
-}).strict().meta({
-  title: "Chat Plugin",
-  description: "Chat queue behavior. Messaging channels are Plugin Resources.",
-});
-
-/** Chat Plugin 完整结构化配置。 */
-export type ChatPluginConfig = z.infer<typeof chat_plugin_config_schema>;
-
-/** 供 City Plugin Catalog 使用的标准 JSON Schema。 */
-export const CHAT_PLUGIN_CONFIG_JSON_SCHEMA = z.toJSONSchema(
-  chat_plugin_config_schema,
-  { target: "draft-2020-12" },
-) as JsonObject;
-
-/** 供 City Plugin Catalog 使用的完整 Resource Item JSON Schema。 */
-export const CHAT_PLUGIN_RESOURCE_JSON_SCHEMA = z.toJSONSchema(
-  chat_plugin_resource_schema,
-  { target: "draft-2020-12" },
-) as JsonObject;
-
-/** 在运行时装配边界解析并收窄 Chat Plugin 配置。 */
-export function parse_chat_plugin_config(input: unknown): ChatPluginConfig {
-  return chat_plugin_config_schema.parse(input);
-}
-
-/** 解析一个完整 Chat Plugin Resource Item。 */
-export function parse_chat_plugin_resource(input: unknown): ChatPluginResource {
-  return chat_plugin_resource_schema.parse(input);
-}
-
-/** 读取一个 Chat Resource 类型分支的标准 JSON Schema。 */
-export function get_chat_plugin_resource_json_schema(
-  resource_type: ChatPluginResource["type"],
-): JsonObject {
-  const variants = Array.isArray(CHAT_PLUGIN_RESOURCE_JSON_SCHEMA.oneOf)
-    ? CHAT_PLUGIN_RESOURCE_JSON_SCHEMA.oneOf
-    : [];
-  for (const value of variants) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) continue;
-    const variant = value as JsonObject;
-    const properties = variant.properties;
-    if (!properties || typeof properties !== "object" || Array.isArray(properties)) continue;
-    const type_schema = (properties as JsonObject).type;
-    if (
-      type_schema
-      && typeof type_schema === "object"
-      && !Array.isArray(type_schema)
-      && (type_schema as JsonObject).const === resource_type
-    ) {
-      return JSON.parse(JSON.stringify(variant)) as JsonObject;
-    }
-  }
-  throw new Error(`Missing Chat Resource schema: ${resource_type}`);
-}
-
-/**
- * 根据用户字段解析并返回 Resolver 可写的动态字段。
- *
- * 关键点（中文）：返回值不包含 `id`、`type` 和凭据，字段所有权由 City 按 Schema 校验。
- */
-export async function resolve_chat_plugin_resource(
-  input: JsonObject,
-): Promise<JsonObject> {
-  const type = String(input.type || "").trim();
-  if (type !== "telegram" && type !== "feishu" && type !== "qq") {
-    throw new Error(`Unsupported Chat Resource type: ${type}`);
-  }
-  const result = await resolveChatChannelBotInfo({
-    channel: type,
-    credentials: {
-      botToken: typeof input.bot_token === "string" ? input.bot_token : undefined,
-      appId: typeof input.app_id === "string" ? input.app_id : undefined,
-      appSecret: typeof input.app_secret === "string" ? input.app_secret : undefined,
-      domain: typeof input.domain === "string" ? input.domain : undefined,
-      sandbox: input.sandbox === true,
-    },
-  });
-  const identity = String(result.identity || "").trim();
-  const bot_user_id = String(result.botUserId || "").trim();
-  const owner = String(result.owner || "").trim();
-  const creator = String(result.creator || "").trim();
-  return {
-    name: result.name,
-    ...(type === "telegram" && identity ? { username: identity } : {}),
-    ...(type !== "telegram" && identity ? { identity } : {}),
-    ...(bot_user_id ? { bot_user_id } : {}),
-    ...(type === "feishu" && owner ? { owner } : {}),
-    ...(type === "feishu" && creator ? { creator } : {}),
-  };
-}

package/src/chat/types/ChatPluginResource.ts

@@ -1,95 +0,0 @@
-/**
- * Chat Plugin Resource 类型。
- *
- * 关键点（中文）
- * - Resource 是 City 解析后传给 Chat Plugin Factory 的完整配置对象。
- * - `id` 是稳定本地身份，`type` 是渠道判别字段，`name` 等只读字段由 Resolver 写入。
- * - 凭据仍属于完整 Resource Item，但 CLI 展示时必须根据 Schema 的 `writeOnly` 注解脱敏。
- */
-
-/** Telegram Bot Resource。 */
-export interface TelegramPluginResource {
-  /** CLI 生成的稳定 Resource ID。 */
-  id: string;
-
-  /** Telegram Resource 判别字段。 */
-  type: "telegram";
-
-  /** Resolver 获取的 Bot 真实名称。 */
-  name: string;
-
-  /** Telegram Bot API Token。 */
-  bot_token: string;
-
-  /** Resolver 获取的 Telegram username。 */
-  username?: string;
-
-  /** Resolver 获取的 Telegram Bot 用户 ID。 */
-  bot_user_id?: string;
-}
-
-/** Feishu / Lark Bot Resource。 */
-export interface FeishuPluginResource {
-  /** CLI 生成的稳定 Resource ID。 */
-  id: string;
-
-  /** Feishu Resource 判别字段。 */
-  type: "feishu";
-
-  /** Resolver 获取的 Bot 真实名称。 */
-  name: string;
-
-  /** Feishu / Lark App ID。 */
-  app_id: string;
-
-  /** Feishu / Lark App Secret。 */
-  app_secret: string;
-
-  /** 可选 Open API Domain。 */
-  domain?: string;
-
-  /** Resolver 获取的 Bot 身份。 */
-  identity?: string;
-
-  /** Resolver 获取的所有者名称。 */
-  owner?: string;
-
-  /** Resolver 获取的创建者名称。 */
-  creator?: string;
-
-  /** Resolver 获取的 Bot 用户 ID。 */
-  bot_user_id?: string;
-}
-
-/** QQ Bot Resource。 */
-export interface QqPluginResource {
-  /** CLI 生成的稳定 Resource ID。 */
-  id: string;
-
-  /** QQ Resource 判别字段。 */
-  type: "qq";
-
-  /** Resolver 获取的 Bot 真实名称。 */
-  name: string;
-
-  /** QQ Bot App ID。 */
-  app_id: string;
-
-  /** QQ Bot App Secret。 */
-  app_secret: string;
-
-  /** 是否使用 QQ 沙箱环境。 */
-  sandbox?: boolean;
-
-  /** Resolver 获取的 Bot 身份。 */
-  identity?: string;
-
-  /** Resolver 获取的 Bot 用户 ID。 */
-  bot_user_id?: string;
-}
-
-/** Chat Plugin 支持的完整 Resource Item。 */
-export type ChatPluginResource =
-  | TelegramPluginResource
-  | FeishuPluginResource
-  | QqPluginResource;

package/src/contact/Index.ts

@@ -1,8 +0,0 @@
-/**
- * contact plugin 导出入口。
- *
- * 关键点（中文）
- * - Index 只负责导出类实现，具体逻辑集中在 `ContactPlugin`。
- */
-
-export { ContactPlugin } from "./ContactPlugin.js";

package/src/memory/Index.ts

@@ -1,14 +0,0 @@
-/**
- * Memory Plugin 导出入口。
- *
- * 关键点（中文）
- * - Index 只负责导出 Memory Plugin 与默认实现。
- * - 真正运行时的 per-agent 实例由宿主显式创建并传给 Agent。
- */
-
-export { MemoryPlugin } from "./MemoryPlugin.js";
-export { BuiltinMemoryProvider } from "./providers/BuiltinMemoryProvider.js";
-export {
-  FileMemoryStorageAdapter,
-  get_default_file_memory_root_path,
-} from "./adapters/FileMemoryStorageAdapter.js";

package/src/skill/Command.ts

@@ -1,58 +0,0 @@
-/**
- * Skill 安装命令 helper。
- *
- * 设计目标（中文）
- * - 不自建 registry，直接复用社区的 `npx skills` 安装生态。
- * - 当前 helper 由需要准备 skill 依赖的其他 plugin 复用，不作为 SkillPlugin action 暴露。
- */
-
-import { execa } from "execa";
-
-async function runNpxSkills(args: string[], opts?: { yes?: boolean }): Promise<number> {
-  const yes = opts?.yes !== false;
-  const result = await execa("npx", [yes ? "-y" : "", "skills", ...args].filter(Boolean), {
-    stdio: "inherit",
-  });
-  return result.exitCode ?? 0;
-}
-
-/**
- * skill 安装选项。
- */
-export interface SkillInstallOptions {
-  /**
-   * 是否执行全局安装。
-   */
-  global?: boolean;
-  /**
-   * 是否跳过交互确认。
-   */
-  yes?: boolean;
-  /**
-   * 安装目标 agent 名称。
-   */
-  agent?: string;
-}
-
-/**
- * 安装指定 skill。
- */
-export async function skillInstallCommand(
-  spec: string,
-  options: SkillInstallOptions = {},
-): Promise<void> {
-  const s = String(spec || "").trim();
-  if (!s) throw new Error("Missing spec");
-
-  const args: string[] = ["add", s];
-  const agent = String(options.agent || "").trim();
-  if (agent) args.push("--agent", agent);
-
-  const yes = options.yes !== false;
-  if (yes) args.push("-y");
-
-  const globalInstall = options.global !== false;
-  if (globalInstall) args.push("-g");
-
-  await runNpxSkills(args, { yes });
-}

package/src/task/Index.ts

@@ -1,8 +0,0 @@
-/**
- * Task plugin 静态导出入口。
- *
- * 关键点（中文）
- * - Index 只保留导出职责，不再承载 task plugin 的具体实现。
- * - 真正的类实现收敛到 `TaskPlugin.ts`。
- */
-export { TaskPlugin } from "./TaskPlugin.js";