@downcity/agent 1.1.8 → 1.1.11

package/bin/plugin/builtins/asr/Plugin.js

@@ -0,0 +1,462 @@
+/**
+ * ASR Plugin。
+ *
+ * 关键点（中文）
+ * - ASR Plugin 现在自己内聚转写依赖，不再暴露独立依赖端口心智。
+ * - 具体模型、依赖安装、命令模板等实现细节全部收敛到 plugin 内部 dependency helper。
+ * - 当前作为 chat 入站消息增强中间件接入语音转写。
+ */
+import { CHAT_PLUGIN_POINTS } from "../../../service/builtins/chat/runtime/PluginPoints.js";
+import { isPluginEnabled } from "../../../plugin/core/Activation.js";
+import { listVoiceModels, resolveVoicePluginModelId, } from "../../../plugin/builtins/asr/ModelCatalog.js";
+import { getBooleanOpt, getStringOpt, readVoicePluginConfig, toJsonObject, writeVoicePluginConfig, } from "../../../plugin/builtins/asr/Config.js";
+import { augmentAsrInboundMessage } from "../../../plugin/builtins/asr/InboundAugment.js";
+import { checkVoiceTranscriber, installVoiceTranscriber, readVoiceTranscriberConfig, transcribeWithVoiceDependency, writeVoiceTranscriberConfig, } from "../../../plugin/builtins/asr/Dependency.js";
+/**
+ * asrPlugin：声明式插件定义。
+ */
+export const asrPlugin = {
+    name: "asr",
+    title: "Automatic Speech Recognition",
+    description: "Detects voice and audio attachments in inbound chat messages, runs transcription through the configured ASR dependency, and appends readable text so the agent can work with spoken input like normal message content.",
+    config: {
+        plugin: "asr",
+        scope: "project",
+        defaultValue: {
+            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",
+    },
+    usage: {
+        title: "配置语音识别",
+        description: "设置当前 agent 如何把语音内容转成文本并注入对话链路。",
+        fields: [
+            {
+                key: "injectPrompt",
+                label: "注入 Prompt 提示",
+                type: "boolean",
+                trueLabel: "开启",
+                falseLabel: "关闭",
+                description: "开启后会把 ASR 使用约束注入到 agent 的系统提示词。",
+            },
+            {
+                key: "augmentMessage",
+                label: "自动增强消息",
+                type: "boolean",
+                trueLabel: "开启",
+                falseLabel: "关闭",
+                description: "开启后，入站语音消息会先自动转写再交给 agent。",
+            },
+            {
+                key: "modelId",
+                label: "默认模型",
+                type: "select",
+                sourceAction: "models",
+            },
+            {
+                key: "language",
+                label: "默认语言提示",
+                type: "string",
+                placeholder: "auto / zh / en",
+            },
+            {
+                key: "timeoutMs",
+                label: "超时（毫秒）",
+                type: "number",
+                placeholder: "60000",
+            },
+        ],
+        saveAction: "configure",
+        statusAction: "status",
+    },
+    async availability(context) {
+        if (!isPluginEnabled({ plugin: asrPlugin, context })) {
+            return {
+                enabled: false,
+                available: false,
+                reasons: ["asr plugin disabled in city config"],
+            };
+        }
+        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 augmentAsrInboundMessage({ context, value });
+                },
+            ],
+        },
+    },
+    actions: {
+        status: {
+            allowWhenDisabled: true,
+            command: {
+                description: "查看 asr plugin 当前状态",
+                mapInput() {
+                    return {};
+                },
+            },
+            execute: async ({ context }) => {
+                const config = readVoicePluginConfig(context);
+                const availability = await asrPlugin.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)),
+                    },
+                };
+            },
+        },
+        install: {
+            allowWhenDisabled: true,
+            command: {
+                description: "安装 asr 转写依赖",
+                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 payloadObject = payload && typeof payload === "object" && !Array.isArray(payload)
+                    ? payload
+                    : {};
+                const { enabled: _ignoredEnabled, ...patch } = payloadObject;
+                const current = readVoicePluginConfig(context);
+                const next = {
+                    ...current,
+                    ...patch,
+                };
+                await writeVoicePluginConfig({
+                    agentState: context,
+                    value: next,
+                });
+                return {
+                    success: true,
+                    data: {
+                        plugin: toJsonObject(next) || {},
+                    },
+                };
+            },
+        },
+        on: {
+            allowWhenDisabled: true,
+            command: {
+                description: "启用 asr 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 }) => {
+                context.platform.setPluginEnabled?.("asr", true);
+                const nextConfig = {
+                    ...readVoicePluginConfig(context),
+                    injectPrompt: typeof payload.injectPrompt === "boolean"
+                        ? payload.injectPrompt
+                        : true,
+                    augmentMessage: typeof payload.augmentMessage === "boolean"
+                        ? payload.augmentMessage
+                        : true,
+                };
+                await writeVoicePluginConfig({
+                    agentState: context,
+                    value: nextConfig,
+                });
+                if (payload.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 || "asr dependency install failed",
+                            message: installResult.message || "asr dependency install failed",
+                        };
+                    }
+                }
+                return {
+                    success: true,
+                    data: {
+                        plugin: toJsonObject(nextConfig) || {},
+                        transcriber: toJsonObject(readVoiceTranscriberConfig(context)) || {},
+                    },
+                };
+            },
+        },
+        off: {
+            command: {
+                description: "关闭 asr plugin",
+                mapInput() {
+                    return {};
+                },
+            },
+            execute: async ({ context }) => {
+                context.platform.setPluginEnabled?.("asr", false);
+                return {
+                    success: true,
+                    data: {
+                        plugin: toJsonObject(readVoicePluginConfig(context)) || {},
+                    },
+                };
+            },
+        },
+        use: {
+            command: {
+                description: "切换 asr 当前转写模型",
+                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.modelId || "").trim();
+                const resolvedModelId = resolveVoicePluginModelId(modelId);
+                if (!resolvedModelId) {
+                    return {
+                        success: false,
+                        error: `Unsupported asr model: ${modelId}`,
+                        message: `Unsupported asr model: ${modelId}`,
+                    };
+                }
+                const transcriberConfig = await writeVoiceTranscriberConfig({
+                    context,
+                    value: {
+                        ...readVoiceTranscriberConfig(context),
+                        modelId: resolvedModelId,
+                    },
+                });
+                return {
+                    success: true,
+                    data: {
+                        transcriber: toJsonObject(transcriberConfig) || {},
+                    },
+                };
+            },
+        },
+        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 asrPlugin.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.audioPath || ""),
+                    language: typeof payload.language === "string"
+                        ? String(payload.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: "列出内置 asr 支持的模型目录",
+                mapInput() {
+                    return {};
+                },
+            },
+            execute: async () => {
+                return {
+                    success: true,
+                    data: {
+                        models: listVoiceModels(),
+                    },
+                };
+            },
+        },
+        doctor: {
+            command: {
+                description: "检查 asr plugin 与转写依赖可用性",
+                mapInput() {
+                    return {};
+                },
+            },
+            execute: async ({ context }) => {
+                const availability = await asrPlugin.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
+                        ? "asr plugin is available"
+                        : availability.reasons.join("; ") || "asr plugin is not available",
+                };
+            },
+        },
+    },
+    system(context) {
+        const config = readVoicePluginConfig(context);
+        if (!isPluginEnabled({ plugin: asrPlugin, context }) || config.injectPrompt !== true) {
+            return "";
+        }
+        return [
+            "# ASR Plugin",
+            "Audio attachments may be transcribed before agent execution.",
+        ].join("\n");
+    },
+};
+//# sourceMappingURL=Plugin.js.map

package/bin/plugin/builtins/asr/Plugin.js.map

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

package/bin/plugin/builtins/auth/Plugin.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Auth Plugin。
+ *
+ * 关键点（中文）
+ * - auth 是内建且必需的 plugin，不走可选启停语义。
+ * - 所有 chat 授权配置仍然保存在 `downcity.db`，动态观测态仍落 `.downcity/chat/authorization/state.json`。
+ * - auth plugin 只负责统一暴露扩展点 / action 边界，不改变底层存储模型。
+ */
+import type { Plugin } from "../../../plugin/types/Plugin.js";
+/**
+ * authPlugin：统一承载授权能力。
+ */
+export declare const authPlugin: Plugin;
+//# sourceMappingURL=Plugin.d.ts.map

package/bin/plugin/builtins/auth/Plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugin/builtins/auth/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AA6DvD;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAuIxB,CAAC"}