@downcity/plugins 1.0.56 → 1.0.57

package/src/voice/types/VoicePlugin.ts

@@ -1,194 +0,0 @@
-/**
- * Voice Plugin 类型定义。
- *
- * 关键点（中文）
- * - Voice 的行为配置与转写依赖配置统一收敛到 `plugins.asr`。
- * - 这里的类型名直接反映 plugin 自身能力，不再保留 asset 心智。
- */
-
-import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
-
-/**
- * Voice Plugin 行为配置。
- */
-export interface VoicePluginConfig {
-  /**
-   * 兼容统一结构化配置约束的索引签名。
-   */
-  [key: string]: JsonValue | undefined;
-  /**
-   * 是否把转写结果注入 system/prompt 行为链。
-   */
-  injectPrompt?: boolean;
-  /**
-   * 是否在消息进入 Agent 前自动增强语音内容。
-   */
-  augmentMessage?: boolean;
-  /**
-   * 转写提供者类型。
-   */
-  provider?: "local" | "command";
-  /**
-   * 当前激活模型 ID（可选）。
-   */
-  modelId?: string;
-  /**
-   * 模型根目录（可选）。
-   */
-  modelsDir?: string;
-  /**
-   * Python 可执行文件（可选）。
-   */
-  pythonBin?: string;
-  /**
-   * 自定义命令模板（可选）。
-   */
-  command?: string;
-  /**
-   * 默认语言提示（可选）。
-   */
-  language?: string;
-  /**
-   * 转写超时时间（毫秒，可选）。
-   */
-  timeoutMs?: number;
-  /**
-   * 本地推理策略（可选）。
-   */
-  strategy?: "auto" | "funasr" | "transformers-whisper" | "command";
-  /**
-   * 已安装模型列表（可选）。
-   */
-  installedModels?: string[];
-}
-
-/**
- * Voice 转写配置。
- */
-export interface VoiceTranscriberConfig {
-  /**
-   * 兼容统一结构化配置约束的索引签名。
-   */
-  [key: string]: JsonValue | undefined;
-  /**
-   * 转写提供者类型。
-   *
-   * 说明（中文）
-   * - `local`：使用内建本地模型与 Python Runner。
-   * - `command`：使用用户自定义命令模板。
-   */
-  provider?: "local" | "command";
-  /**
-   * 本地模型 ID（可选）。
-   *
-   * 说明（中文）
-   * - 这是 asr plugin 内部依赖字段，不要求其他 service 直接感知。
-   */
-  modelId?: string;
-  /**
-   * 模型根目录（可选）。
-   */
-  modelsDir?: string;
-  /**
-   * Python 可执行文件（可选）。
-   */
-  pythonBin?: string;
-  /**
-   * 自定义命令模板（可选）。
-   */
-  command?: string;
-  /**
-   * 默认语言提示（可选）。
-   */
-  language?: string;
-  /**
-   * 转写超时时间（毫秒，可选）。
-   */
-  timeoutMs?: number;
-  /**
-   * 本地推理策略（可选）。
-   *
-   * 说明（中文）
-   * - `auto`：按模型自动选择 runner。
-   * - `funasr` / `transformers-whisper`：固定使用对应 runner。
-   * - `command`：使用自定义命令模板。
-   */
-  strategy?: "auto" | "funasr" | "transformers-whisper" | "command";
-  /**
-   * 已安装模型列表（可选）。
-   *
-   * 说明（中文）
-   * - 仅作为状态快照使用，不应被 plugin 直接依赖。
-   */
-  installedModels?: string[];
-}
-
-/**
- * Voice 转写安装输入。
- */
-export interface VoiceTranscriberInstallInput {
-  /**
-   * 兼容统一结构化配置约束的索引签名。
-   */
-  [key: string]: JsonValue | undefined;
-  /**
-   * 需要安装的模型 ID 列表（可选）。
-   */
-  modelIds?: string[];
-  /**
-   * 安装完成后激活的模型 ID（可选）。
-   */
-  activeModel?: string;
-  /**
-   * 是否强制覆盖已存在资源。
-   */
-  force?: boolean;
-  /**
-   * 模型目录（可选）。
-   */
-  modelsDir?: string;
-  /**
-   * Python 可执行文件（可选）。
-   */
-  pythonBin?: string;
-  /**
-   * 是否同时安装转写依赖。
-   */
-  installDeps?: boolean;
-  /**
-   * HuggingFace Token（可选）。
-   */
-  hfToken?: string;
-}
-
-/**
- * Voice 转写句柄。
- */
-export interface VoiceTranscriberHandle {
-  /**
-   * 执行音频转写。
-   */
-  transcribe(input: {
-    /**
-     * 待转写音频路径。
-     */
-    audioPath: string;
-    /**
-     * 语言提示（可选）。
-     */
-    language?: string;
-  }): Promise<{
-    /**
-     * 转写是否成功。
-     */
-    success: boolean;
-    /**
-     * 转写文本（可选）。
-     */
-    text?: string;
-    /**
-     * 错误信息（可选）。
-     */
-    error?: string;
-  }>;
-}

package/src/web/Dependency.ts

@@ -1,17 +0,0 @@
-/**
- * Web Plugin 兼容导出层。
- *
- * 关键点（中文）
- * - `web` plugin 只保留薄适配层。
- * - 真正的联网/浏览器能力由外部 provider 项目负责。
- */
-
-export {
-  readWebPluginConfig,
-  writeWebPluginConfig,
-} from "@/web/runtime/Config.js";
-export {
-  inspectWebPluginDependency,
-  installWebPluginDependency,
-  doctorWebPluginDependency,
-} from "@/web/runtime/Source.js";

package/src/web/PROMPT.agent-browser.ts

@@ -1,9 +0,0 @@
-/**
- * 自动生成文件，请勿手改。
- * 源文件：由同路径 `*.ts.txt` 生成。
- */
-
-// Source: src/web/PROMPT.agent-browser.ts.txt
-const TEXT_MODULE_CONTENT = "# Web Plugin / agent-browser\n\n当前 provider 是 `agent-browser`。\n\n你应直接使用 `agent-browser` 项目的浏览器自动化方法，而不是在本项目里自己实现浏览器交互。\n\n工作原则：\n\n- 浏览器交互、打开页面、点击、填写、截图、滚动等操作优先交给 `agent-browser`\n- 严格遵循 `agent-browser` 的基本工作流：\n  1. `open`\n  2. `snapshot -i`\n  3. 使用元素引用交互\n  4. 页面变化后重新 snapshot\n- 如果 `agent-browser` provider 不可用，应先报告依赖缺失\n\n你在处理需要浏览器操作的任务时，应以外部 `agent-browser` 项目为准。\n";
-
-export default TEXT_MODULE_CONTENT;

package/src/web/PROMPT.agent-browser.ts.txt

@@ -1,17 +0,0 @@
-# Web Plugin / agent-browser
-
-当前 provider 是 `agent-browser`。
-
-你应直接使用 `agent-browser` 项目的浏览器自动化方法，而不是在本项目里自己实现浏览器交互。
-
-工作原则：
-
-- 浏览器交互、打开页面、点击、填写、截图、滚动等操作优先交给 `agent-browser`
-- 严格遵循 `agent-browser` 的基本工作流：
-  1. `open`
-  2. `snapshot -i`
-  3. 使用元素引用交互
-  4. 页面变化后重新 snapshot
-- 如果 `agent-browser` provider 不可用，应先报告依赖缺失
-
-你在处理需要浏览器操作的任务时，应以外部 `agent-browser` 项目为准。

package/src/web/PROMPT.web-access.ts

@@ -1,9 +0,0 @@
-/**
- * 自动生成文件，请勿手改。
- * 源文件：由同路径 `*.ts.txt` 生成。
- */
-
-// Source: src/web/PROMPT.web-access.ts.txt
-const TEXT_MODULE_CONTENT = "# Web Plugin / web-access\n\n当前 provider 是 `web-access`。\n\n你应直接遵循已安装的 `web-access` skill/project 逻辑，而不是在本项目里重新实现一套联网框架。\n\n工作原则：\n\n- 优先沿用 `web-access` 自己的联网策略、工具选择和浏览哲学\n- 把 Downcity 的 `web` plugin 视为 provider 选择器与接入层\n- 如果 `web-access` 不可用，先指出依赖缺失，而不是自行退回到本项目里的临时实现\n\n你在处理联网任务时，应以外部 `web-access` 项目为准。\n";
-
-export default TEXT_MODULE_CONTENT;

package/src/web/PROMPT.web-access.ts.txt

@@ -1,13 +0,0 @@
-# Web Plugin / web-access
-
-当前 provider 是 `web-access`。
-
-你应直接遵循已安装的 `web-access` skill/project 逻辑，而不是在本项目里重新实现一套联网框架。
-
-工作原则：
-
-- 优先沿用 `web-access` 自己的联网策略、工具选择和浏览哲学
-- 把 Downcity 的 `web` plugin 视为 provider 选择器与接入层
-- 如果 `web-access` 不可用，先指出依赖缺失，而不是自行退回到本项目里的临时实现
-
-你在处理联网任务时，应以外部 `web-access` 项目为准。

package/src/web/runtime/Config.ts

@@ -1,105 +0,0 @@
-/**
- * Web Plugin 配置读写。
- *
- * 关键点（中文）
- * - `web` 默认启用，不要求用户先在 `downcity.json` 写配置。
- * - 只有当用户显式改动时，才把 `plugins.web` 持久化到项目配置。
- */
-
-import type { JsonObject } from "@downcity/agent/internal/types/common/Json.js";
-import type { PluginCommandContext } from "@downcity/agent/internal/plugin/types/Plugin.js";
-import type { ResolvedWebPluginConfig, WebPluginConfig } from "@/web/types/WebPlugin.js";
-import { WEB_PLUGIN_DEFAULT_REPOSITORY_URL } from "@/web/types/WebPlugin.js";
-
-function toJsonObject(input: Record<string, unknown> | null | undefined): JsonObject {
-  const out: JsonObject = {};
-  if (!input) return out;
-  for (const [key, value] of Object.entries(input)) {
-    if (
-      value === null ||
-      typeof value === "string" ||
-      typeof value === "number" ||
-      typeof value === "boolean"
-    ) {
-      out[key] = value;
-      continue;
-    }
-    if (Array.isArray(value)) {
-      out[key] = value.filter((item) => item !== undefined) as never;
-      continue;
-    }
-    if (value && typeof value === "object") {
-      out[key] = toJsonObject(value as Record<string, unknown>);
-    }
-  }
-  return out;
-}
-
-function readWebPluginRecord(context: PluginCommandContext): Record<string, unknown> {
-  const current = context.config.plugins?.web;
-  if (!current || typeof current !== "object" || Array.isArray(current)) {
-    return {};
-  }
-  return current as Record<string, unknown>;
-}
-
-/**
- * 读取并归一化 web plugin 配置。
- */
-export function readWebPluginConfig(
-  context: PluginCommandContext,
-): ResolvedWebPluginConfig {
-  const { enabled: _ignoredEnabled, ...current } = readWebPluginRecord(
-    context,
-  ) as WebPluginConfig & {
-    enabled?: boolean;
-  };
-  return {
-    provider:
-      current.provider === "agent-browser" || current.provider === "web-access"
-        ? current.provider
-        : "web-access",
-    injectPrompt:
-      typeof current.injectPrompt === "boolean" ? current.injectPrompt : true,
-    repositoryUrl:
-      typeof current.repositoryUrl === "string" && current.repositoryUrl.trim()
-        ? current.repositoryUrl.trim()
-        : WEB_PLUGIN_DEFAULT_REPOSITORY_URL,
-    ...(typeof current.sourceVersion === "string" && current.sourceVersion.trim()
-      ? { sourceVersion: current.sourceVersion.trim() }
-      : {}),
-    browserCommand:
-      typeof current.browserCommand === "string" && current.browserCommand.trim()
-        ? current.browserCommand.trim()
-        : "agent-browser",
-    installScope:
-      current.installScope === "project" || current.installScope === "user"
-        ? current.installScope
-        : "user",
-  };
-}
-
-/**
- * 写入 web plugin 配置。
- */
-export async function writeWebPluginConfig(params: {
-  context: PluginCommandContext;
-  value: Partial<WebPluginConfig>;
-}): Promise<ResolvedWebPluginConfig> {
-  if (!params.context.config.plugins) {
-    params.context.config.plugins = {};
-  }
-  const current = readWebPluginConfig(params.context);
-  const next: WebPluginConfig & {
-    enabled?: boolean;
-  } = {
-    ...current,
-    ...params.value,
-  };
-  delete next.enabled;
-  params.context.config.plugins.web = toJsonObject(
-    next as unknown as Record<string, unknown>,
-  );
-  await params.context.pluginConfig.persistProjectPlugins(params.context.config.plugins);
-  return readWebPluginConfig(params.context);
-}

package/src/web/runtime/Source.ts

@@ -1,257 +0,0 @@
-/**
- * Web Plugin 来源信息与兼容安装动作。
- *
- * 关键点（中文）
- * - 这里不自建联网实现，只检查外部 provider 是否就绪，并记录少量配置。
- */
-
-import fs from "node:fs";
-import path from "node:path";
-import os from "node:os";
-import fsp from "node:fs/promises";
-import { execa } from "execa";
-import fse from "fs-extra";
-import type { JsonObject } from "@downcity/agent/internal/types/common/Json.js";
-import type { PluginCommandContext } from "@downcity/agent/internal/plugin/types/Plugin.js";
-import type {
-  WebPluginDependencyCheckResult,
-  WebPluginInstallInput,
-} from "@/web/types/WebPlugin.js";
-import { readWebPluginConfig, writeWebPluginConfig } from "@/web/runtime/Config.js";
-import { AGENT_BROWSER_PROMPT } from "@/web/WebPromptAssets.js";
-
-function toJsonObject(input: Record<string, unknown> | null | undefined): JsonObject {
-  const out: JsonObject = {};
-  if (!input) return out;
-  for (const [key, value] of Object.entries(input)) {
-    if (
-      value === null ||
-      typeof value === "string" ||
-      typeof value === "number" ||
-      typeof value === "boolean"
-    ) {
-      out[key] = value;
-    }
-  }
-  return out;
-}
-
-function resolveWebAccessSkillCandidates(projectRoot: string): string[] {
-  const home = process.env.HOME || "";
-  return [
-    path.join(projectRoot, ".agents", "skills", "web-access", "SKILL.md"),
-    path.join(home, ".agents", "skills", "web-access", "SKILL.md"),
-    path.join(projectRoot, ".claude", "skills", "web-access", "SKILL.md"),
-    path.join(home, ".claude", "skills", "web-access", "SKILL.md"),
-  ].filter(Boolean);
-}
-
-function resolveManagedSkillRoot(projectRoot: string, scope: "user" | "project"): string {
-  if (scope === "project") {
-    return path.join(projectRoot, ".agents", "skills");
-  }
-  return path.join(process.env.HOME || os.homedir(), ".agents", "skills");
-}
-
-function resolveManagedSkillDir(params: {
-  projectRoot: string;
-  scope: "user" | "project";
-  provider: "web-access" | "agent-browser";
-}): string {
-  return path.join(resolveManagedSkillRoot(params.projectRoot, params.scope), params.provider);
-}
-
-function loadBundledAgentBrowserSkillText(): string {
-  return AGENT_BROWSER_PROMPT || "# agent-browser";
-}
-
-async function ensureAgentBrowserSkillInstalled(params: {
-  projectRoot: string;
-  scope: "user" | "project";
-}): Promise<string> {
-  const targetDir = resolveManagedSkillDir({
-    projectRoot: params.projectRoot,
-    scope: params.scope,
-    provider: "agent-browser",
-  });
-  const skillPath = path.join(targetDir, "SKILL.md");
-  if (fs.existsSync(skillPath)) {
-    return skillPath;
-  }
-  await fsp.mkdir(targetDir, { recursive: true });
-  await fsp.writeFile(`${skillPath}`, `${loadBundledAgentBrowserSkillText()}\n`, "utf-8");
-  return skillPath;
-}
-
-async function ensureWebAccessSkillInstalled(params: {
-  projectRoot: string;
-  scope: "user" | "project";
-  source?: string;
-}): Promise<string> {
-  const targetDir = resolveManagedSkillDir({
-    projectRoot: params.projectRoot,
-    scope: params.scope,
-    provider: "web-access",
-  });
-  const skillPath = path.join(targetDir, "SKILL.md");
-  if (fs.existsSync(skillPath)) {
-    return skillPath;
-  }
-
-  const source = String(params.source || "").trim();
-  if (source && fs.existsSync(source)) {
-    await fse.copy(path.resolve(source), targetDir, {
-      overwrite: true,
-      errorOnExist: false,
-    });
-    return skillPath;
-  }
-
-  await fsp.mkdir(path.dirname(targetDir), { recursive: true });
-  await execa("git", ["clone", "--depth=1", "https://github.com/eze-is/web-access", targetDir], {
-    reject: true,
-  });
-  return skillPath;
-}
-
-async function checkAgentBrowserCommand(command: string): Promise<boolean> {
-  try {
-    await execa(command, ["--help"], {
-      reject: false,
-      timeout: 15_000,
-    });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * 返回当前来源快照。
- */
-export async function inspectWebPluginDependency(
-  context: PluginCommandContext,
-): Promise<WebPluginDependencyCheckResult> {
-  const config = readWebPluginConfig(context);
-  if (config.provider === "agent-browser") {
-    const available = await checkAgentBrowserCommand(config.browserCommand);
-    return {
-      available,
-      installed: available,
-      reasons: available
-        ? []
-        : [
-            `agent-browser command is not available: ${config.browserCommand}`,
-            "Install or expose the agent-browser CLI before using this provider.",
-          ],
-      details: {
-        provider: config.provider,
-        browserCommand: config.browserCommand,
-        source: "external-project",
-        installScope: config.installScope,
-      },
-    };
-  }
-
-  const candidates = resolveWebAccessSkillCandidates(context.rootPath);
-  const skillPath = candidates.find((item) => fs.existsSync(item));
-  const available = Boolean(skillPath);
-  return {
-    available,
-    installed: available,
-    reasons: available
-      ? []
-      : [
-          "web-access skill is not found.",
-          "Install https://github.com/eze-is/web-access into ~/.agents/skills/web-access or project .agents/skills/web-access.",
-        ],
-    details: {
-      provider: config.provider,
-      source: "external-project",
-      repositoryUrl: config.repositoryUrl,
-      installScope: config.installScope,
-      ...(config.sourceVersion ? { sourceVersion: config.sourceVersion } : {}),
-      ...(skillPath ? { skillPath } : { checkedPaths: candidates }),
-    },
-  };
-}
-
-/**
- * 兼容 install 动作。
- */
-export async function installWebPluginDependency(params: {
-  context: PluginCommandContext;
-  input?: WebPluginInstallInput;
-}): Promise<{
-  success: boolean;
-  message?: string;
-  details?: JsonObject;
-}> {
-  const currentConfig = readWebPluginConfig(params.context);
-  const installScope =
-    params.input?.installScope === "project" || params.input?.installScope === "user"
-      ? params.input.installScope
-      : currentConfig.installScope;
-  const provider =
-    params.input?.provider === "agent-browser" || params.input?.provider === "web-access"
-      ? params.input.provider
-      : currentConfig.provider;
-
-  const installedSkillPath =
-    provider === "agent-browser"
-      ? await ensureAgentBrowserSkillInstalled({
-          projectRoot: params.context.rootPath,
-          scope: installScope,
-        })
-      : await ensureWebAccessSkillInstalled({
-          projectRoot: params.context.rootPath,
-          scope: installScope,
-          source: params.input?.repositoryUrl,
-        });
-
-  const nextConfig = await writeWebPluginConfig({
-    context: params.context,
-    value: {
-      provider,
-      injectPrompt:
-        typeof params.input?.injectPrompt === "boolean"
-          ? params.input.injectPrompt
-          : true,
-      ...(typeof params.input?.repositoryUrl === "string" &&
-      params.input.repositoryUrl.trim()
-        ? { repositoryUrl: params.input.repositoryUrl.trim() }
-        : {}),
-      ...(typeof params.input?.sourceVersion === "string" &&
-      params.input.sourceVersion.trim()
-        ? { sourceVersion: params.input.sourceVersion.trim() }
-        : {}),
-      ...(typeof params.input?.browserCommand === "string" &&
-      params.input.browserCommand.trim()
-        ? { browserCommand: params.input.browserCommand.trim() }
-        : {}),
-      installScope,
-    },
-  });
-  return {
-    success: true,
-    message: "web provider installed and configured",
-    details: toJsonObject({
-      provider: nextConfig.provider,
-      injectPrompt: nextConfig.injectPrompt,
-      repositoryUrl: nextConfig.repositoryUrl,
-      sourceVersion: nextConfig.sourceVersion || "",
-      browserCommand: nextConfig.browserCommand,
-      installScope: nextConfig.installScope,
-      skillPath: installedSkillPath,
-    }),
-  };
-}
-
-/**
- * doctor 结果与 inspect 一致。
- */
-export async function doctorWebPluginDependency(
-  context: PluginCommandContext,
-): Promise<WebPluginDependencyCheckResult> {
-  return inspectWebPluginDependency(context);
-}