@downcity/plugins 1.0.174 → 1.0.194

package/bin/web/runtime/Install.js

@@ -1,178 +0,0 @@
-/**
- * WebPlugin 安装器。
- *
- * 关键点（中文）
- * - install 只负责准备联网相关 skill / CLI 依赖，不写 provider 配置。
- * - skill 安装复用 SkillPlugin 的 `npx skills` 通道，避免 web 自建 registry。
- * - agent-browser 额外准备 npm CLI 包，因为其 skill 需要 `agent-browser` 命令可用。
- */
-import { execa } from "execa";
-import fs from "node:fs";
-import path from "node:path";
-import { skillInstallCommand } from "../../skill/Command.js";
-/**
- * 读取字符串字段。
- */
-function read_string(value) {
-    if (typeof value !== "string")
-        return undefined;
-    const trimmed = value.trim();
-    return trimmed || undefined;
-}
-/**
- * 读取布尔字段。
- */
-function read_boolean(value) {
-    return typeof value === "boolean" ? value : undefined;
-}
-/**
- * 归一化安装目标。
- */
-function resolve_install_target(value) {
-    const target = read_string(value);
-    if (target === "web-access" || target === "agent-browser" || target === "all") {
-        return target;
-    }
-    return "web-access";
-}
-/**
- * 归一化安装作用域。
- */
-function resolve_install_scope(value) {
-    const scope = read_string(value);
-    return scope === "project" ? "project" : "user";
-}
-/**
- * 判断命令是否已经可用。
- */
-async function command_exists(command) {
-    try {
-        const result = await execa(command, ["--help"], {
-            reject: false,
-            timeout: 15_000,
-        });
-        return (result.exitCode ?? 1) === 0;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * 执行 npm 包安装。
- */
-async function install_npm_package(params) {
-    if (params.scope === "project") {
-        const package_manager = resolve_project_package_manager(params.root_path);
-        const args = package_manager === "pnpm"
-            ? ["add", "-D", params.package_name]
-            : package_manager === "yarn"
-                ? ["add", "-D", params.package_name]
-                : ["install", "--save-dev", params.package_name];
-        await execa(package_manager, args, {
-            cwd: params.root_path,
-            stdio: "inherit",
-        });
-        return;
-    }
-    await execa("npm", ["install", "-g", params.package_name], {
-        stdio: "inherit",
-    });
-}
-/**
- * 根据锁文件推断项目包管理器。
- */
-function resolve_project_package_manager(root_path) {
-    if (fs.existsSync(path.join(root_path, "pnpm-lock.yaml")))
-        return "pnpm";
-    if (fs.existsSync(path.join(root_path, "yarn.lock")))
-        return "yarn";
-    return "npm";
-}
-/**
- * 将步骤列表转成 JSON。
- */
-function serialize_steps(steps) {
-    return steps.map((step) => ({
-        name: step.name,
-        success: step.success,
-        message: step.message,
-    }));
-}
-/**
- * 安装 skill。
- */
-async function install_skill(params) {
-    await skillInstallCommand(params.spec, {
-        global: params.scope === "user",
-        yes: params.yes,
-        agent: params.agent,
-    });
-    params.steps.push({
-        name: `${params.spec}:skill`,
-        success: true,
-        message: params.scope === "user"
-            ? `Installed ${params.spec} skill in user scope.`
-            : `Installed ${params.spec} skill in project scope.`,
-    });
-}
-/**
- * 准备 agent-browser CLI。
- */
-async function install_agent_browser_cli(params) {
-    if (await command_exists("agent-browser")) {
-        params.steps.push({
-            name: "agent-browser:cli",
-            success: true,
-            message: "agent-browser CLI is already available.",
-        });
-        return;
-    }
-    await install_npm_package({
-        root_path: params.context.rootPath,
-        package_name: "agent-browser",
-        scope: params.scope,
-    });
-    params.steps.push({
-        name: "agent-browser:cli",
-        success: true,
-        message: params.scope === "user"
-            ? "Installed agent-browser CLI globally with npm."
-            : "Installed agent-browser as a project devDependency.",
-    });
-}
-/**
- * 执行 WebPlugin install action。
- */
-export async function installWebPluginTargets(params) {
-    const payload = params.payload || {};
-    const target = resolve_install_target(payload.target);
-    const scope = resolve_install_scope(payload.scope);
-    const yes = read_boolean(payload.yes) ?? true;
-    const agent = read_string(payload.agent);
-    const targets = target === "all" ? ["web-access", "agent-browser"] : [target];
-    const steps = [];
-    for (const item of targets) {
-        await install_skill({
-            spec: item,
-            scope,
-            yes,
-            agent,
-            steps,
-        });
-        if (item === "agent-browser") {
-            await install_agent_browser_cli({
-                context: params.context,
-                scope,
-                steps,
-            });
-        }
-    }
-    return {
-        target,
-        scope,
-        ...(agent ? { agent } : {}),
-        steps: serialize_steps(steps),
-        nextAction: "Use SkillPlugin lookup/list to inspect installed skills, then let the agent choose the concrete web path during task execution.",
-    };
-}
-//# sourceMappingURL=Install.js.map

package/bin/web/runtime/Install.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Install.js","sourceRoot":"","sources":["../../../src/web/runtime/Install.ts"],"names":[],"mappings":"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"}

package/src/asr/Plugin.ts

@@ -1,322 +0,0 @@
-/**
- * AsrPlugin：语音转写插件。
- *
- * 关键点（中文）
- * - ASR 能力通过 constructor 注入，推荐传入 `city.ai.asr`。
- * - plugin 不负责本地模型、Python 依赖、provider 或项目配置。
- * - `auto: true` 时会在 chat 入站阶段自动转写 voice/audio 附件，并把结果写入正文。
- */
-
-import path from "node:path";
-import { BasePlugin } from "@downcity/agent";
-import { createAction } from "@downcity/agent";
-import { z } from "zod";
-import type { AgentContext } from "@downcity/agent";
-import type {
-  JsonObject,
-  JsonValue,
-} from "@downcity/agent";
-import { CHAT_PLUGIN_POINTS } from "@/chat/runtime/PluginPoints.js";
-import type {
-  ChatInboundAugmentInput,
-  ChatPluginAttachment,
-} from "@/chat/types/ChatPlugin.js";
-import type {
-  AsrPluginInput,
-  AsrPluginOptions,
-  AsrPluginResult,
-} from "@/asr/types/AsrPlugin.js";
-
-const DEFAULT_ASR_PLUGIN_NAME = "asr";
-const DEFAULT_ASR_PLUGIN_TITLE = "ASR";
-const DEFAULT_ASR_PLUGIN_DESCRIPTION =
-  "Transcribe voice and audio attachments through an injected ASR function.";
-
-/**
- * 判断值是否为普通对象。
- */
-function to_record(value: unknown): Record<string, unknown> | null {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
-  return value as Record<string, unknown>;
-}
-
-/**
- * XML 文本转义。
- */
-function escape_xml_text(value: string): string {
-  return String(value || "")
-    .replace(/&/g, "&amp;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;");
-}
-
-/**
- * XML 属性转义。
- */
-function escape_xml_attr(value: string): string {
-  return escape_xml_text(value).replace(/"/g, "&quot;");
-}
-
-/**
- * 归一化 action payload。
- */
-function normalize_asr_payload(payload: JsonValue | undefined): AsrPluginInput {
-  const record = to_record(payload ?? {});
-  if (!record) {
-    throw new TypeError("AsrPlugin.transcribe payload must be an object");
-  }
-  const audio_path =
-    typeof record.audio_path === "string"
-      ? record.audio_path.trim()
-      : "";
-  const url = typeof record.url === "string" ? record.url.trim() : "";
-  const data_url = typeof record.data_url === "string" ? record.data_url.trim() : "";
-  if (!audio_path && !url && !data_url) {
-    throw new Error("AsrPlugin.transcribe requires audio_path, url, or data_url");
-  }
-  return {
-    ...(record as AsrPluginInput),
-    ...(audio_path ? { audio_path } : {}),
-    ...(url ? { url } : {}),
-    ...(data_url ? { data_url } : {}),
-  };
-}
-
-/**
- * 校验 ASR 返回结果。
- */
-function normalize_asr_result(result: AsrPluginResult): AsrPluginResult {
-  const record = to_record(result);
-  if (!record || typeof record.text !== "string") {
-    throw new TypeError("AsrPlugin asr function must return { text: string }");
-  }
-  return {
-    ...record,
-    text: record.text.trim(),
-  } as AsrPluginResult;
-}
-
-/**
- * 生成相对展示路径。
- */
-function to_display_src(root_path: string, attachment: ChatPluginAttachment): string {
-  const raw =
-    typeof attachment.path === "string" && attachment.path.trim()
-      ? attachment.path.trim()
-      : attachment.fileName || attachment.attachmentId || attachment.kind;
-  const normalized_root = path.resolve(root_path);
-  const normalized_raw = path.isAbsolute(raw) ? path.resolve(raw) : raw;
-  if (path.isAbsolute(normalized_raw) && normalized_raw.startsWith(`${normalized_root}${path.sep}`)) {
-    return normalized_raw.slice(normalized_root.length + 1);
-  }
-  return raw;
-}
-
-/**
- * 把语音转写结果写入 bodyText。
- */
-function append_voice_text(input: ChatInboundAugmentInput, voice_blocks: string[]): ChatInboundAugmentInput {
-  const current = String(input.bodyText || "").trim();
-  const addition = voice_blocks.map((item) => item.trim()).filter(Boolean).join("\n\n");
-  if (!addition) return input;
-  return {
-    ...input,
-    bodyText: [current, addition].filter(Boolean).join("\n\n"),
-  };
-}
-
-/**
- * Agent ASR 插件。
- */
-export class AsrPlugin extends BasePlugin {
-  /**
-   * 当前 plugin 稳定名称。
-   */
-  readonly name: string;
-
-  /**
-   * 插件标题。
-   */
-  readonly title: string;
-
-  /**
-   * 插件说明。
-   */
-  readonly description: string;
-
-  private readonly asr: AsrPluginOptions["asr"];
-  private readonly auto: boolean;
-  private readonly language?: string;
-
-  constructor(options: AsrPluginOptions) {
-    super();
-    const name = String(options.name || DEFAULT_ASR_PLUGIN_NAME).trim();
-    if (!name) {
-      throw new Error("AsrPlugin requires a non-empty name");
-    }
-    if (typeof options.asr !== "function") {
-      throw new Error("AsrPlugin requires an asr function");
-    }
-    this.name = name;
-    this.title = String(options.title || DEFAULT_ASR_PLUGIN_TITLE).trim();
-    this.description = String(
-      options.description || DEFAULT_ASR_PLUGIN_DESCRIPTION,
-    ).trim();
-    this.asr = options.asr;
-    this.auto = options.auto === true;
-    this.language =
-      typeof options.language === "string" && options.language.trim()
-        ? options.language.trim()
-        : undefined;
-  }
-
-  /**
-   * ASR 插件给模型的使用说明。
-   */
-  system(_context: AgentContext): string {
-    return [
-      "# ASR Plugin",
-      "",
-      "Use this plugin when the user asks to transcribe, recognize, or understand voice/audio content.",
-      this.auto
-        ? "Inbound voice/audio chat attachments are automatically transcribed into `<voice src=\"...\">...</voice>` blocks in the user text."
-        : "Automatic inbound voice transcription is disabled; call the plugin explicitly when transcription is needed.",
-      "",
-      "Call through `plugin_call`:",
-      "",
-      "```ts",
-      "plugin_call({",
-      `  plugin: "${this.name}",`,
-      '  action: "transcribe",',
-      "  payload: {",
-      '    audio_path: "...",',
-      "  },",
-      "});",
-      "```",
-      "",
-      "Payload rules:",
-      "- Provide one of `audio_path`, `url`, or `data_url`.",
-      "- Optional fields: `language`, `media_type`, `file_name`, `provider_options`.",
-      "- Do not invent transcript text. If transcription fails, report the failure clearly.",
-    ].join("\n");
-  }
-
-  /**
-   * 执行一次 ASR 转写。
-   */
-  private async transcribe(input: AsrPluginInput): Promise<AsrPluginResult> {
-    const result = await this.asr({
-      ...(this.language ? { language: this.language } : {}),
-      ...input,
-    });
-    return normalize_asr_result(result);
-  }
-
-  /**
-   * 自动增强 chat 入站消息。
-   */
-  private async auto_transcribe_inbound(params: {
-    context: AgentContext;
-    value: JsonValue;
-  }): Promise<JsonValue> {
-    if (!this.auto) return params.value;
-    const input = params.value as unknown as ChatInboundAugmentInput;
-    const voice_attachments = (Array.isArray(input.attachments) ? input.attachments : []).filter(
-      (item) =>
-        (item.kind === "voice" || item.kind === "audio") &&
-        typeof item.path === "string" &&
-        item.path.trim(),
-    );
-    if (voice_attachments.length === 0) {
-      return input as unknown as JsonValue;
-    }
-
-    const voice_blocks: string[] = [];
-    for (const attachment of voice_attachments) {
-      try {
-        const result = await this.transcribe({
-          audio_path: String(attachment.path || "").trim(),
-          ...(attachment.contentType ? { media_type: attachment.contentType } : {}),
-          ...(attachment.fileName ? { file_name: attachment.fileName } : {}),
-        });
-        if (!result.text) continue;
-        const src = to_display_src(params.context.rootPath, attachment);
-        voice_blocks.push(
-          `<voice src="${escape_xml_attr(src)}">${escape_xml_text(result.text)}</voice>`,
-        );
-      } catch {
-        // 关键点（中文）：自动转写失败不阻塞主消息链路。
-      }
-    }
-
-    return append_voice_text(input, voice_blocks) as unknown as JsonValue;
-  }
-
-  /**
-   * pipeline / action 扩展点。
-   */
-  readonly hooks = {
-    pipeline: {
-      [CHAT_PLUGIN_POINTS.augmentInbound]: [
-        async ({ context, value }: { context: AgentContext; value: JsonValue }) => {
-          return await this.auto_transcribe_inbound({ context, value });
-        },
-      ],
-    },
-  };
-
-  /**
-   * 显式 action 集合。
-   */
-  readonly actions = {
-    transcribe: createAction({
-      description:
-        "Transcribe a voice or audio source into text. Provide one of audio_path / url / data_url.",
-      input_schema: {
-        zod: z
-          .object({
-            audio_path: z.string().optional(),
-            url: z.string().optional(),
-            data_url: z.string().optional(),
-            language: z.string().optional(),
-            media_type: z.string().optional(),
-            file_name: z.string().optional(),
-            provider_options: z.record(z.string(), z.unknown()).optional(),
-          })
-          .passthrough(),
-        json_schema: {
-          type: "object",
-          properties: {
-            audio_path: { type: "string", description: "Absolute or relative local audio path." },
-            url: { type: "string", description: "Online audio URL." },
-            data_url: { type: "string", description: "Audio as a data: URL." },
-            language: { type: "string", description: "Target language code, optional." },
-            media_type: { type: "string", description: "Media type, optional." },
-            file_name: { type: "string", description: "File name, optional." },
-          },
-        },
-      },
-      examples: [
-        { title: "Local audio", payload: { audio_path: "./input.wav" } },
-        { title: "Remote URL", payload: { url: "https://example.com/a.mp3" } },
-      ],
-      execute: async ({ input }: { input: JsonValue }) => {
-        try {
-          const transcribe_input = normalize_asr_payload(input);
-          const result = await this.transcribe(transcribe_input);
-          return {
-            success: true,
-            data: result as unknown as JsonObject,
-            message: "audio transcribed",
-          };
-        } catch (error) {
-          return {
-            success: false,
-            error: String(error),
-            message: String(error),
-          };
-        }
-      },
-    }),
-  };
-}

package/src/asr/types/AsrPlugin.ts

@@ -1,118 +0,0 @@
-/**
- * AsrPlugin 类型定义。
- *
- * 关键点（中文）
- * - ASR plugin 只定义 agent 侧协议，不绑定本地模型、Python 或 City 具体实现。
- * - 真实转写能力通过 constructor 的 `asr` 函数注入，推荐传入 `city.ai.asr`。
- * - `auto` 只表示是否在 chat 入站时自动转写语音附件。
- */
-
-import type { JsonObject, JsonValue } from "@downcity/agent";
-
-/**
- * ASR 输入。
- */
-export interface AsrPluginInput {
-  /**
-   * 本地音频文件路径。
-   *
-   * 说明（中文）
-   * - chat runtime 下载附件后会传入本地路径。
-   * - 显式 action 调用时也优先使用该字段。
-   */
-  audio_path?: string;
-  /**
-   * 远程音频 URL。
-   */
-  url?: string;
-  /**
-   * data URL 音频内容。
-   */
-  data_url?: string;
-  /**
-   * 语言提示，例如 `auto`、`zh`、`en`。
-   */
-  language?: string;
-  /**
-   * 音频 MIME 类型，例如 `audio/ogg`。
-   */
-  media_type?: string;
-  /**
-   * 原始文件名。
-   */
-  file_name?: string;
-  /**
-   * Provider 私有参数。
-   */
-  provider_options?: JsonObject;
-  /**
-   * 允许外部 asr 函数接收其他 JSON 可序列化参数。
-   */
-  [key: string]: JsonValue | undefined;
-}
-
-/**
- * ASR 输出。
- */
-export interface AsrPluginResult {
-  /**
-   * 转写文本。
-   */
-  text: string;
-  /**
-   * 识别到的语言（可选）。
-   */
-  language?: string;
-  /**
-   * 结果置信度（可选）。
-   */
-  confidence?: number;
-  /**
-   * Provider 原始元信息（可选）。
-   */
-  metadata?: JsonObject;
-  /**
-   * 允许外部 asr 函数返回其他 JSON 可序列化字段。
-   */
-  [key: string]: JsonValue | undefined;
-}
-
-/**
- * AsrPlugin 构造参数。
- */
-export interface AsrPluginOptions {
-  /**
-   * Plugin 稳定名称，默认 `asr`。
-   */
-  name?: string;
-  /**
-   * Plugin 展示标题，默认 `ASR`。
-   */
-  title?: string;
-  /**
-   * Plugin 用途说明。
-   */
-  description?: string;
-  /**
-   * 真实 ASR 能力函数。
-   *
-   * 说明（中文）
-   * - 推荐传入 `(input) => city.ai.asr(input)`。
-   * - plugin 只负责调用该函数，不关心模型、provider、鉴权或运行依赖。
-   */
-  asr: (input: AsrPluginInput) => Promise<AsrPluginResult> | AsrPluginResult;
-  /**
-   * 是否自动转写 chat 入站语音附件。
-   *
-   * 说明（中文）
-   * - `true`：遇到 voice/audio 附件时自动调用 `asr`。
-   * - `false`：仅保留显式 `transcribe` action。
-   * - 默认 `false`，避免 agent 隐式调用外部 ASR 成本。
-   */
-  auto?: boolean;
-  /**
-   * 默认语言提示。
-   */
-  language?: string;
-}
-