@downcity/agent 1.1.25 → 1.1.35

package/src/plugin/builtins/voice/Plugin.ts

@@ -1,450 +0,0 @@
-/**
- * Voice Plugin。
- *
- * 关键点（中文）
- * - Voice Plugin 现在自己内聚转写依赖，不再暴露独立依赖端口心智。
- * - 具体模型、依赖安装、命令模板等实现细节全部收敛到 plugin 内部 dependency helper。
- * - 当前作为 chat 入站消息增强中间件接入语音转写。
- */
-
-import type { Plugin } from "@/plugin/types/Plugin.js";
-import { CHAT_PLUGIN_POINTS } from "@/service/builtins/chat/runtime/PluginPoints.js";
-import {
-  listVoiceModels,
-  resolveVoicePluginModelId,
-} from "@/plugin/builtins/voice/ModelCatalog.js";
-import {
-  getBooleanOpt,
-  getStringOpt,
-  readVoicePluginConfig,
-  toJsonObject,
-  writeVoicePluginConfig,
-} from "@/plugin/builtins/voice/Config.js";
-import { augmentVoiceInboundMessage } from "@/plugin/builtins/voice/InboundAugment.js";
-import {
-  checkVoiceTranscriber,
-  installVoiceTranscriber,
-  readVoiceTranscriberConfig,
-  transcribeWithVoiceDependency,
-  writeVoiceTranscriberConfig,
-} from "@/plugin/builtins/voice/Dependency.js";
-
-/**
- * voicePlugin：声明式插件定义。
- */
-export const voicePlugin: Plugin = {
-  name: "voice",
-  title: "Voice Message Transcription",
-  description:
-    "Detects voice and audio attachments in inbound chat messages, runs transcription through the configured voice dependency, and appends readable text so the agent can work with spoken input like normal message content.",
-  config: {
-    plugin: "voice",
-    scope: "project",
-    defaultValue: {
-      enabled: false,
-      injectPrompt: true,
-      augmentMessage: true,
-      provider: "local",
-      modelId: "SenseVoiceSmall",
-    },
-  },
-  setup: {
-    mode: "install-configure",
-    title: "安装语音转写",
-    description: "选择模型后即可完成依赖安装与当前配置写入。",
-    fields: [
-      {
-        key: "modelId",
-        label: "模型",
-        type: "select",
-        required: true,
-        sourceAction: "models",
-      },
-      {
-        key: "installDeps",
-        label: "安装 Python 依赖",
-        type: "checkbox",
-      },
-    ],
-    primaryAction: "install",
-    statusAction: "status",
-  },
-  async availability(context) {
-    const config = readVoicePluginConfig(context);
-    if (config.enabled !== true) {
-      return {
-        enabled: false,
-        available: false,
-        reasons: ["voice plugin disabled"],
-      };
-    }
-    const dependencyStatus = await checkVoiceTranscriber(context);
-    return {
-      enabled: true,
-      available: dependencyStatus.available,
-      reasons: dependencyStatus.reasons,
-    };
-  },
-  hooks: {
-    pipeline: {
-      [CHAT_PLUGIN_POINTS.augmentInbound]: [
-        async ({ context, value }) => {
-          return await augmentVoiceInboundMessage({ context, value });
-        },
-      ],
-    },
-  },
-  actions: {
-    status: {
-      allowWhenDisabled: true,
-      command: {
-        description: "查看 voice plugin 当前状态",
-        mapInput() {
-          return {};
-        },
-      },
-      execute: async ({ context }) => {
-        const config = readVoicePluginConfig(context);
-        const availability = await voicePlugin.availability!(context);
-        const transcriberConfig = readVoiceTranscriberConfig(context);
-        return {
-          success: true,
-          data: {
-            plugin: toJsonObject(config) || {},
-            availability: {
-              enabled: availability.enabled,
-              available: availability.available,
-              reasons: availability.reasons,
-            },
-            transcriber:
-              toJsonObject((transcriberConfig || null) as Record<string, unknown> | null),
-          },
-        };
-      },
-    },
-    install: {
-      allowWhenDisabled: true,
-      command: {
-        description: "安装 voice 转写依赖",
-        configure(command) {
-          command
-            .argument("[models...]")
-            .option("--active-model <modelId>", "安装完成后设为当前模型")
-            .option("--models-dir <path>", "模型目录（可选）")
-            .option("--python <bin>", "Python 可执行文件（默认 python3）")
-            .option("--no-install-deps", "跳过依赖安装")
-            .option("--force", "强制覆盖已存在资源")
-            .option("--hf-token <token>", "HuggingFace token（可选）");
-        },
-        mapInput({ args, opts }) {
-          return {
-            modelIds: args,
-            ...(getStringOpt(opts, "activeModel")
-              ? { activeModel: getStringOpt(opts, "activeModel") }
-              : {}),
-            ...(getStringOpt(opts, "modelsDir")
-              ? { modelsDir: getStringOpt(opts, "modelsDir") }
-              : {}),
-            ...(getStringOpt(opts, "python")
-              ? { pythonBin: getStringOpt(opts, "python") }
-              : {}),
-            installDeps: getBooleanOpt(opts, "installDeps", true),
-            force: getBooleanOpt(opts, "force", false),
-            ...(getStringOpt(opts, "hfToken")
-              ? { hfToken: getStringOpt(opts, "hfToken") }
-              : {}),
-          };
-        },
-      },
-      execute: async ({ context, payload }) => {
-        const result = await installVoiceTranscriber({
-          context,
-          input:
-            payload && typeof payload === "object" && !Array.isArray(payload)
-              ? payload
-              : undefined,
-        });
-        return {
-          success: result.success,
-          ...(result.message ? { message: result.message } : {}),
-          ...(result.details !== undefined ? { data: result.details } : {}),
-          ...(result.success ? {} : { error: result.message || "install failed" }),
-        };
-      },
-    },
-    configure: {
-      allowWhenDisabled: true,
-      execute: async ({ context, payload }) => {
-        const current = readVoicePluginConfig(context);
-        const next = {
-          ...current,
-          ...(payload && typeof payload === "object" && !Array.isArray(payload)
-            ? payload
-            : {}),
-        };
-        await writeVoicePluginConfig({
-          agentState: context,
-          value: next,
-        });
-        return {
-          success: true,
-          data: {
-            plugin: toJsonObject(next) || {},
-          },
-        };
-      },
-    },
-    on: {
-      allowWhenDisabled: true,
-      command: {
-        description: "启用 voice plugin，并可选安装转写依赖",
-        configure(command) {
-          command
-            .argument("[models...]")
-            .option("--active-model <modelId>", "安装完成后设为当前模型")
-            .option("--models-dir <path>", "模型目录（可选）")
-            .option("--python <bin>", "Python 可执行文件（默认 python3）")
-            .option("--no-install", "仅启用 plugin，不安装依赖")
-            .option("--no-install-deps", "跳过依赖安装")
-            .option("--force", "强制覆盖已存在资源")
-            .option("--hf-token <token>", "HuggingFace token（可选）")
-            .option("--no-inject-prompt", "关闭 prompt 注入")
-            .option("--no-augment-message", "关闭消息增强");
-        },
-        mapInput({ args, opts }) {
-          return {
-            modelIds: args,
-            ...(getStringOpt(opts, "activeModel")
-              ? { activeModel: getStringOpt(opts, "activeModel") }
-              : {}),
-            ...(getStringOpt(opts, "modelsDir")
-              ? { modelsDir: getStringOpt(opts, "modelsDir") }
-              : {}),
-            ...(getStringOpt(opts, "python")
-              ? { pythonBin: getStringOpt(opts, "python") }
-              : {}),
-            install: getBooleanOpt(opts, "install", true),
-            installDeps: getBooleanOpt(opts, "installDeps", true),
-            force: getBooleanOpt(opts, "force", false),
-            injectPrompt: getBooleanOpt(opts, "injectPrompt", true),
-            augmentMessage: getBooleanOpt(opts, "augmentMessage", true),
-            ...(getStringOpt(opts, "hfToken")
-              ? { hfToken: getStringOpt(opts, "hfToken") }
-              : {}),
-          };
-        },
-      },
-      execute: async ({ context, payload }) => {
-        const nextConfig = {
-          ...readVoicePluginConfig(context),
-          enabled: true,
-          injectPrompt:
-            typeof (payload as { injectPrompt?: unknown }).injectPrompt === "boolean"
-              ? ((payload as { injectPrompt?: boolean }).injectPrompt as boolean)
-              : true,
-          augmentMessage:
-            typeof (payload as { augmentMessage?: unknown }).augmentMessage === "boolean"
-              ? ((payload as { augmentMessage?: boolean }).augmentMessage as boolean)
-              : true,
-        };
-        await writeVoicePluginConfig({
-          agentState: context,
-          value: nextConfig,
-        });
-        if ((payload as { install?: unknown }).install !== false) {
-          const installResult = await installVoiceTranscriber({
-            context,
-            input:
-              payload && typeof payload === "object" && !Array.isArray(payload)
-                ? payload
-                : undefined,
-          });
-          if (!installResult.success) {
-            return {
-              success: false,
-              error: installResult.message || "voice dependency install failed",
-              message: installResult.message || "voice dependency install failed",
-            };
-          }
-        }
-        return {
-          success: true,
-          data: {
-            plugin: toJsonObject(nextConfig) || {},
-            transcriber: toJsonObject(readVoiceTranscriberConfig(context)) || {},
-          },
-        };
-      },
-    },
-    off: {
-      command: {
-        description: "关闭 voice plugin",
-        mapInput() {
-          return {};
-        },
-      },
-      execute: async ({ context }) => {
-        const nextConfig = {
-          ...readVoicePluginConfig(context),
-          enabled: false,
-        };
-        await writeVoicePluginConfig({
-          agentState: context,
-          value: nextConfig,
-        });
-        return {
-          success: true,
-          data: {
-            plugin: toJsonObject(nextConfig) || {},
-          },
-        };
-      },
-    },
-    use: {
-      command: {
-        description: "切换 voice 当前转写模型",
-        configure(command) {
-          command.argument("<modelId>");
-        },
-        mapInput({ args }) {
-          const modelId = String(args[0] || "").trim();
-          if (!modelId) {
-            throw new Error("modelId is required");
-          }
-          return {
-            modelId,
-          };
-        },
-      },
-      execute: async ({ context, payload }) => {
-        const modelId = String((payload as { modelId?: unknown }).modelId || "").trim();
-        const resolvedModelId = resolveVoicePluginModelId(modelId);
-        if (!resolvedModelId) {
-          return {
-            success: false,
-            error: `Unsupported voice model: ${modelId}`,
-            message: `Unsupported voice model: ${modelId}`,
-          };
-        }
-        const transcriberConfig = await writeVoiceTranscriberConfig({
-          context,
-          value: {
-            ...readVoiceTranscriberConfig(context),
-            modelId: resolvedModelId,
-          },
-        });
-        return {
-          success: true,
-          data: {
-            transcriber: toJsonObject(transcriberConfig as Record<string, unknown>) || {},
-          },
-        };
-      },
-    },
-    transcribe: {
-      command: {
-        description: "转写本地音频文件",
-        configure(command) {
-          command
-            .argument("<audioPath>")
-            .option("--language <code>", "语言提示（可选，例如 zh / en）");
-        },
-        mapInput({ args, opts }) {
-          const audioPath = String(args[0] || "").trim();
-          if (!audioPath) {
-            throw new Error("audioPath is required");
-          }
-          return {
-            audioPath,
-            ...(getStringOpt(opts, "language")
-              ? { language: getStringOpt(opts, "language") }
-              : {}),
-          };
-        },
-      },
-      execute: async ({ context, payload }) => {
-        const pluginStatus = await voicePlugin.availability!(context);
-        if (!pluginStatus.enabled || !pluginStatus.available) {
-          return {
-            success: false,
-            error: pluginStatus.reasons.join("; "),
-            message: pluginStatus.reasons.join("; "),
-          };
-        }
-        const result = await transcribeWithVoiceDependency({
-          context,
-          audioPath: String((payload as { audioPath?: unknown }).audioPath || ""),
-          language:
-            typeof (payload as { language?: unknown }).language === "string"
-              ? String((payload as { language?: unknown }).language || "")
-              : undefined,
-        });
-        return {
-          success: result.success,
-          ...(result !== undefined ? { data: result } : {}),
-          ...(result.success ? {} : { error: result.error || "transcribe failed" }),
-          ...(result.success ? {} : { message: result.error || "transcribe failed" }),
-        };
-      },
-    },
-    models: {
-      allowWhenDisabled: true,
-      command: {
-        description: "列出内置 voice 支持的模型目录",
-        mapInput() {
-          return {};
-        },
-      },
-      execute: async () => {
-        return {
-          success: true,
-          data: {
-            models: listVoiceModels(),
-          },
-        };
-      },
-    },
-    doctor: {
-      command: {
-        description: "检查 voice plugin 与转写依赖可用性",
-        mapInput() {
-          return {};
-        },
-      },
-      execute: async ({ context }) => {
-        const availability = await voicePlugin.availability!(context);
-        const dependencyStatus = await checkVoiceTranscriber(context);
-        return {
-          success: true,
-          data: {
-            availability: {
-              enabled: availability.enabled,
-              available: availability.available,
-              reasons: availability.reasons,
-            },
-            transcriberStatus: {
-              available: dependencyStatus.available,
-              reasons: dependencyStatus.reasons,
-              ...(dependencyStatus.details !== undefined
-                ? { details: dependencyStatus.details }
-                : {}),
-            },
-          },
-          message: availability.available
-            ? "voice plugin is available"
-            : availability.reasons.join("; ") || "voice plugin is not available",
-        };
-      },
-    },
-  },
-  system(context) {
-    const config = readVoicePluginConfig(context);
-    if (config.enabled !== true || config.injectPrompt !== true) {
-      return "";
-    }
-    return [
-      "# Voice Plugin",
-      "Audio attachments may be transcribed before agent execution.",
-    ].join("\n");
-  },
-};

package/src/plugin/core/PluginManager.ts

@@ -1,66 +0,0 @@
-/**
- * PluginManager 单例。
- *
- * 关键点（中文）
- * - `plugin/core/*` 是 plugin 的管理层，不是具体 plugin 实现层。
- * - plugin hook / resolve / system 注入所依赖的注册与调度统一收口到这里。
- * - PluginManager 属于 agent runtime，不直接反向依赖 AgentContext 单例。
- * - agent 只是通过 AgentContext 调用统一 plugin manager。
- * - 具体 plugin 实现位于 `src/plugin/builtins/*`，CLI plugin 命令则直接走本地命令执行器。
- */
-
-import { isPluginEnabled } from "@/plugin/core/Activation.js";
-import { HookRegistry } from "@/plugin/core/HookRegistry.js";
-import { PluginRegistry } from "@/plugin/core/PluginRegistry.js";
-import { registerBuiltinPlugins } from "@/plugin/core/Plugins.js";
-import { getPluginRuntimeContextResolver } from "@/runtime/host/PluginRuntime.js";
-
-let pluginManager: PluginRegistry | null = null;
-
-/**
- * 初始化全局 plugin manager。
- */
-export function initializePluginManager(): PluginRegistry {
-  if (pluginManager) return pluginManager;
-
-  const contextResolver = getPluginRuntimeContextResolver();
-  let pluginRegistryRef: PluginRegistry | null = null;
-  const hookRegistry = new HookRegistry({
-    contextResolver,
-    pluginEnabledChecker: (pluginName, context) => {
-      const plugin = pluginRegistryRef?.get(pluginName);
-      if (!plugin) return false;
-      return isPluginEnabled({
-        plugin,
-      });
-    },
-  });
-
-  const registry = new PluginRegistry({
-    contextResolver,
-    hookRegistry,
-  });
-  pluginRegistryRef = registry;
-  registerBuiltinPlugins({
-    pluginRegistry: registry,
-  });
-  pluginManager = registry;
-  return registry;
-}
-
-/**
- * 读取全局 plugin manager。
- */
-export function getPluginManager(): PluginRegistry {
-  if (!pluginManager) {
-    return initializePluginManager();
-  }
-  return pluginManager;
-}
-
-/**
- * 重置全局 plugin manager（测试/重启场景）。
- */
-export function resetPluginManager(): void {
-  pluginManager = null;
-}

package/src/plugin/core/Plugins.ts

@@ -1,39 +0,0 @@
-/**
- * 内建 Plugin 清单（单一事实源）。
- *
- * 关键点（中文）
- * - 统一维护全部内建 plugin，避免 CLI / agent / docs 各自硬编码。
- * - 同时提供统一注册入口，减少额外跳转层级。
- */
-
-import type { PluginRegistry } from "@/plugin/core/PluginRegistry.js";
-import type { Plugin } from "@/plugin/types/Plugin.js";
-import { authPlugin } from "@/plugin/builtins/auth/Plugin.js";
-import { skillPlugin } from "@/plugin/builtins/skill/Plugin.js";
-import { webPlugin } from "@/plugin/builtins/web/Plugin.js";
-import { asrPlugin } from "@/plugin/builtins/asr/Plugin.js";
-import { ttsPlugin } from "@/plugin/builtins/tts/Plugin.js";
-import { workboardPlugin } from "@/plugin/builtins/workboard/Plugin.js";
-
-/**
- * 全部内建 Plugin。
- */
-export const PLUGINS: Plugin[] = [
-  authPlugin,
-  skillPlugin,
-  webPlugin,
-  asrPlugin,
-  ttsPlugin,
-  workboardPlugin,
-];
-
-/**
- * 注册全部内建插件体系对象。
- */
-export function registerBuiltinPlugins(params: {
-  pluginRegistry: PluginRegistry;
-}): void {
-  for (const plugin of PLUGINS) {
-    params.pluginRegistry.register(plugin);
-  }
-}

package/src/runtime/host/PluginRuntime.ts

@@ -1,42 +0,0 @@
-/**
- * PluginRuntime：city 级 plugin 运行时注入模块。
- *
- * 关键点（中文）
- * - PluginRegistry / PluginManager 属于 city runtime，不应直接反向 import agent AgentContext 单例。
- * - 当前模块只负责保存“当前执行上下文 resolver”的注入入口。
- * - agent runtime 仅作为 context provider 注册方，不再成为 plugin manager 的宿主。
- */
-
-import type { AgentContext } from "@/core/AgentContextTypes.js";
-
-type AgentContextResolver = () => AgentContext;
-
-let executionContextResolver: AgentContextResolver | null = null;
-
-/**
- * 设置当前 city plugin runtime 的执行上下文 resolver。
- */
-export function setPluginRuntimeContextResolver(
-  resolver: AgentContextResolver,
-): void {
-  executionContextResolver = resolver;
-}
-
-/**
- * 清理当前 city plugin runtime 的执行上下文 resolver。
- */
-export function clearPluginRuntimeContextResolver(): void {
-  executionContextResolver = null;
-}
-
-/**
- * 读取当前 city plugin runtime 的执行上下文 resolver。
- */
-export function getPluginRuntimeContextResolver(): AgentContextResolver {
-  if (!executionContextResolver) {
-    throw new Error(
-      "Plugin runtime context resolver is not configured. Configure city plugin runtime before using PluginManager.",
-    );
-  }
-  return executionContextResolver;
-}

package/src/runtime/server/http/auth/AuthError.ts

@@ -1,31 +0,0 @@
-/**
- * Auth 领域错误定义。
- *
- * 关键点（中文）
- * - 用统一错误类把 HTTP 状态码和业务语义绑在一起。
- * - 路由层只负责把错误转成响应，不负责猜测状态码。
- */
-
-/**
- * Auth 业务错误。
- */
-export class AuthError extends Error {
-  /**
-   * HTTP 状态码。
-   */
-  readonly status: number;
-
-  constructor(message: string, status: number) {
-    super(message);
-    this.name = "AuthError";
-    this.status = status;
-  }
-}
-
-/**
- * 判断是否为 AuthError。
- */
-export function isAuthError(error: unknown): error is AuthError {
-  return error instanceof AuthError;
-}
-

package/src/runtime/server/http/auth/PasswordHasher.ts

@@ -1,37 +0,0 @@
-/**
- * 密码哈希工具。
- *
- * 关键点（中文）
- * - V1 先使用 Node 内建 `scryptSync`，避免引入额外依赖。
- * - 存储格式固定为 `scrypt$<salt>$<hash>`，便于后续平滑升级。
- */
-
-import { randomBytes, scryptSync, timingSafeEqual } from "node:crypto";
-
-/**
- * 哈希密码。
- */
-export function hashPassword(passwordInput: string): string {
-  const password = String(passwordInput || "");
-  const salt = randomBytes(16).toString("hex");
-  const derived = scryptSync(password, salt, 64).toString("hex");
-  return `scrypt$${salt}$${derived}`;
-}
-
-/**
- * 校验密码。
- */
-export function verifyPassword(passwordInput: string, passwordHashInput: string): boolean {
-  const password = String(passwordInput || "");
-  const passwordHash = String(passwordHashInput || "").trim();
-  const parts = passwordHash.split("$");
-  if (parts.length !== 3 || parts[0] !== "scrypt") return false;
-  const salt = parts[1];
-  const expectedHex = parts[2];
-  if (!salt || !expectedHex) return false;
-  const actual = scryptSync(password, salt, 64);
-  const expected = Buffer.from(expectedHex, "hex");
-  if (actual.length !== expected.length) return false;
-  return timingSafeEqual(actual, expected);
-}
-

package/src/runtime/server/http/auth/TokenService.ts

@@ -1,36 +0,0 @@
-/**
- * Bearer Token 工具。
- *
- * 关键点（中文）
- * - 明文 token 只在签发时生成一次。
- * - 存储层始终只保存哈希值，避免数据库泄漏时直接暴露访问凭证。
- */
-
-import { createHash, randomBytes } from "node:crypto";
-
-/**
- * 生成新的明文 token。
- */
-export function generateAccessToken(): string {
-  return `dc_${randomBytes(24).toString("hex")}`;
-}
-
-/**
- * 计算 token 哈希。
- */
-export function hashAccessToken(tokenInput: string): string {
-  return createHash("sha256").update(String(tokenInput || ""), "utf8").digest("hex");
-}
-
-/**
- * 从 Authorization 头提取 Bearer Token。
- */
-export function extractBearerToken(headerValue: string | undefined): string | null {
-  const header = String(headerValue || "").trim();
-  if (!header) return null;
-  const match = /^Bearer\s+(.+)$/i.exec(header);
-  if (!match?.[1]) return null;
-  const token = match[1].trim();
-  return token || null;
-}
-