@downcity/plugins 1.0.4

package/bin/voice/Config.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Voice plugin 配置读写工具。
+ *
+ * 关键点（中文）
+ * - 行为配置与转写依赖配置统一收敛到 `plugins.voice`。
+ * - 写入前将输入规范化为 JSON object，避免 undefined 进入项目配置。
+ */
+import type { VoicePluginConfig } from "../voice/types/VoicePlugin.js";
+import type { AgentPluginConfigRuntime } from "@downcity/agent/internal/types/runtime/host/AgentHost.js";
+import type { JsonObject, JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+/**
+ * 将普通对象转为可持久化 JSON object。
+ */
+export declare function toJsonObject(input: Record<string, unknown> | null | undefined): JsonObject | null;
+/**
+ * 读取字符串选项。
+ */
+export declare function getStringOpt(opts: Record<string, JsonValue>, key: string): string | undefined;
+/**
+ * 读取布尔选项。
+ */
+export declare function getBooleanOpt(opts: Record<string, JsonValue>, key: string, defaultValue: boolean): boolean;
+/**
+ * 读取 Voice Plugin 配置。
+ */
+export declare function readVoicePluginConfig(runtime: {
+    config: {
+        plugins?: Record<string, unknown>;
+    };
+}): VoicePluginConfig;
+/**
+ * 写入完整 voice plugin 配置。
+ */
+export declare function writeVoicePluginConfig(params: {
+    agentState: {
+        config: {
+            plugins?: Record<string, unknown>;
+        };
+        pluginConfig: AgentPluginConfigRuntime;
+    };
+    value: VoicePluginConfig;
+}): Promise<void>;
+//# sourceMappingURL=Config.d.ts.map

package/bin/voice/Config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/voice/Config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AACzG,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE3F;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAChD,UAAU,GAAG,IAAI,CAyBnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAKpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,OAAO,GACpB,OAAO,CAST;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,MAAM,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH,GAAG,iBAAiB,CA+BpB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,UAAU,EAAE;QACV,MAAM,EAAE;YACN,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACnC,CAAC;QACF,YAAY,EAAE,wBAAwB,CAAC;KACxC,CAAC;IACF,KAAK,EAAE,iBAAiB,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB"}

package/bin/voice/Config.js

@@ -0,0 +1,104 @@
+/**
+ * Voice plugin 配置读写工具。
+ *
+ * 关键点（中文）
+ * - 行为配置与转写依赖配置统一收敛到 `plugins.voice`。
+ * - 写入前将输入规范化为 JSON object，避免 undefined 进入项目配置。
+ */
+/**
+ * 将普通对象转为可持久化 JSON object。
+ */
+export function toJsonObject(input) {
+    if (!input)
+        return null;
+    const out = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (value === undefined)
+            continue;
+        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)
+                .map((item) => item);
+            continue;
+        }
+        if (typeof value === "object") {
+            out[key] = toJsonObject(value) || {};
+        }
+    }
+    return out;
+}
+/**
+ * 读取字符串选项。
+ */
+export function getStringOpt(opts, key) {
+    const value = opts[key];
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+/**
+ * 读取布尔选项。
+ */
+export function getBooleanOpt(opts, key, defaultValue) {
+    const value = opts[key];
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        if (["1", "true", "yes", "y", "on"].includes(normalized))
+            return true;
+        if (["0", "false", "no", "n", "off"].includes(normalized))
+            return false;
+    }
+    return defaultValue;
+}
+/**
+ * 读取 Voice Plugin 配置。
+ */
+export function readVoicePluginConfig(runtime) {
+    const current = runtime.config.plugins?.voice;
+    const normalized = current && typeof current === "object" && !Array.isArray(current)
+        ? current
+        : {};
+    return {
+        enabled: normalized.enabled === true,
+        injectPrompt: typeof normalized.injectPrompt === "boolean"
+            ? normalized.injectPrompt
+            : true,
+        augmentMessage: typeof normalized.augmentMessage === "boolean"
+            ? normalized.augmentMessage
+            : true,
+        provider: normalized.provider === "command" || normalized.provider === "local"
+            ? normalized.provider
+            : "local",
+        ...(typeof normalized.modelId === "string" ? { modelId: normalized.modelId } : {}),
+        ...(typeof normalized.modelsDir === "string" ? { modelsDir: normalized.modelsDir } : {}),
+        ...(typeof normalized.pythonBin === "string" ? { pythonBin: normalized.pythonBin } : {}),
+        ...(typeof normalized.command === "string" ? { command: normalized.command } : {}),
+        ...(typeof normalized.language === "string" ? { language: normalized.language } : {}),
+        ...(typeof normalized.timeoutMs === "number" ? { timeoutMs: normalized.timeoutMs } : {}),
+        ...(typeof normalized.strategy === "string" ? { strategy: normalized.strategy } : {}),
+        ...(Array.isArray(normalized.installedModels)
+            ? { installedModels: normalized.installedModels }
+            : {}),
+    };
+}
+/**
+ * 写入完整 voice plugin 配置。
+ */
+export async function writeVoicePluginConfig(params) {
+    if (!params.agentState.config.plugins) {
+        params.agentState.config.plugins = {};
+    }
+    params.agentState.config.plugins.voice = (toJsonObject(params.value) || {});
+    await params.agentState.pluginConfig.persistProjectPlugins(params.agentState.config.plugins);
+}
+//# sourceMappingURL=Config.js.map

package/bin/voice/Config.js.map

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

package/bin/voice/Dependency.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Voice Plugin Dependency Helper。
+ *
+ * 关键点（中文）
+ * - voice 的转写依赖现在内聚在 plugin 内部，不再暴露独立依赖端口心智。
+ * - 这里统一管理检查、安装、配置读写与转写句柄解析。
+ */
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+import type { PluginCommandContext } from "@downcity/agent/internal/plugin/types/Plugin.js";
+import type { VoicePluginConfig, VoiceTranscriberConfig, VoiceTranscriberInstallInput, VoiceTranscriberHandle } from "../voice/types/VoicePlugin.js";
+export interface VoiceDependencyCheckResult {
+    /**
+     * 当前依赖是否可用。
+     */
+    available: boolean;
+    /**
+     * 不可用原因列表。
+     */
+    reasons: string[];
+    /**
+     * 结构化附加数据（可选）。
+     */
+    details?: JsonValue;
+}
+export interface VoiceDependencyInstallResult {
+    /**
+     * 安装是否成功。
+     */
+    success: boolean;
+    /**
+     * 人类可读消息（可选）。
+     */
+    message?: string;
+    /**
+     * 结构化附加数据（可选）。
+     */
+    details?: JsonValue;
+}
+/**
+ * 读取 voice 转写依赖配置。
+ */
+export declare function readVoiceTranscriberConfig(context: PluginCommandContext): VoiceTranscriberConfig;
+/**
+ * 写入 voice 转写依赖配置。
+ */
+export declare function writeVoiceTranscriberConfig(params: {
+    context: PluginCommandContext;
+    value: Partial<VoiceTranscriberConfig>;
+}): Promise<VoicePluginConfig>;
+/**
+ * 检查 voice 转写依赖可用性。
+ */
+export declare function checkVoiceTranscriber(context: PluginCommandContext): Promise<VoiceDependencyCheckResult>;
+/**
+ * 安装或修复 voice 转写依赖。
+ */
+export declare function installVoiceTranscriber(params: {
+    context: PluginCommandContext;
+    input?: VoiceTranscriberInstallInput;
+}): Promise<VoiceDependencyInstallResult>;
+/**
+ * 解析 voice 转写句柄。
+ */
+export declare function resolveVoiceTranscriber(context: PluginCommandContext): Promise<VoiceTranscriberHandle>;
+/**
+ * 执行一次 voice 转写。
+ */
+export declare function transcribeWithVoiceDependency(params: {
+    context: PluginCommandContext;
+    audioPath: string;
+    language?: string;
+}): Promise<{
+    success: boolean;
+    text?: string;
+    error?: string;
+}>;
+//# sourceMappingURL=Dependency.d.ts.map

package/bin/voice/Dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dependency.d.ts","sourceRoot":"","sources":["../../src/voice/Dependency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,8BAA8B,CAAC;AAoBtC,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAqCD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,oBAAoB,GAC5B,sBAAsB,CAMxB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACxC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAY7B;AA4CD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,0BAA0B,CAAC,CAUrC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,CAAC,EAAE,4BAA4B,CAAC;CACtC,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAqFxC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAqBjC;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAM/D"}

package/bin/voice/Dependency.js

@@ -0,0 +1,237 @@
+/**
+ * Voice Plugin Dependency Helper。
+ *
+ * 关键点（中文）
+ * - voice 的转写依赖现在内聚在 plugin 内部，不再暴露独立依赖端口心智。
+ * - 这里统一管理检查、安装、配置读写与转写句柄解析。
+ */
+import { execFile as execFileCb } from "node:child_process";
+import { promisify } from "node:util";
+import { transcribeVoiceAudio } from "../voice/runtime/Transcriber.js";
+import { VOICE_MODEL_CATALOG, resolveVoiceModelId, } from "../voice/runtime/Catalog.js";
+import { detectLocalVoiceModelInstallState, installVoiceModelFromHuggingFace, } from "../voice/runtime/Installer.js";
+import { installVoiceTranscribeDependencies, resolveVoiceRunnersByModels, resolveVoiceStrategyByModel, } from "../voice/runtime/DependencyInstaller.js";
+import { resolveVoiceModelsRootDir } from "../voice/runtime/Paths.js";
+const execFileAsync = promisify(execFileCb);
+function readVoicePluginRecord(context) {
+    const current = context.config.plugins?.voice;
+    if (!current || typeof current !== "object" || Array.isArray(current)) {
+        return {};
+    }
+    return current;
+}
+function toJsonObject(input) {
+    const out = {};
+    if (!input)
+        return out;
+    for (const [key, value] of Object.entries(input)) {
+        if (value === undefined)
+            continue;
+        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)
+                .map((item) => item);
+            continue;
+        }
+        if (typeof value === "object") {
+            out[key] = toJsonObject(value);
+        }
+    }
+    return out;
+}
+/**
+ * 读取 voice 转写依赖配置。
+ */
+export function readVoiceTranscriberConfig(context) {
+    const current = readVoicePluginRecord(context);
+    return {
+        provider: "local",
+        ...current,
+    };
+}
+/**
+ * 写入 voice 转写依赖配置。
+ */
+export async function writeVoiceTranscriberConfig(params) {
+    if (!params.context.config.plugins) {
+        params.context.config.plugins = {};
+    }
+    const current = readVoicePluginRecord(params.context);
+    const next = {
+        ...current,
+        ...params.value,
+    };
+    params.context.config.plugins.voice = toJsonObject(next);
+    await params.context.pluginConfig.persistProjectPlugins(params.context.config.plugins);
+    return params.context.config.plugins.voice;
+}
+async function checkLocalProviderAvailability(context, config) {
+    const reasons = [];
+    const modelId = resolveVoiceModelId(String(config.modelId || ""));
+    if (!modelId) {
+        reasons.push("voice transcriber modelId is missing");
+        return {
+            available: false,
+            reasons,
+        };
+    }
+    const modelsRootDir = resolveVoiceModelsRootDir({
+        projectRoot: context.rootPath,
+        modelsDir: config.modelsDir,
+    });
+    const installState = await detectLocalVoiceModelInstallState({
+        modelId,
+        modelsRootDir,
+    });
+    if (!installState.installed) {
+        reasons.push(`voice model is not installed: ${modelId}`);
+    }
+    const pythonBin = String(config.pythonBin || "").trim() || "python3";
+    try {
+        await execFileAsync(pythonBin, ["--version"], {
+            timeout: 15_000,
+            maxBuffer: 1024 * 1024,
+        });
+    }
+    catch (error) {
+        reasons.push(`python runtime missing: ${String(error)}`);
+    }
+    return {
+        available: reasons.length === 0,
+        reasons,
+    };
+}
+/**
+ * 检查 voice 转写依赖可用性。
+ */
+export async function checkVoiceTranscriber(context) {
+    const config = readVoiceTranscriberConfig(context);
+    if (config.provider === "command") {
+        const command = String(config.command || "").trim();
+        return {
+            available: Boolean(command),
+            reasons: command ? [] : ["voice transcriber command is missing"],
+        };
+    }
+    return checkLocalProviderAvailability(context, config);
+}
+/**
+ * 安装或修复 voice 转写依赖。
+ */
+export async function installVoiceTranscriber(params) {
+    const context = params.context;
+    const input = params.input;
+    const config = readVoiceTranscriberConfig(context);
+    if (config.provider === "command") {
+        return {
+            success: true,
+            message: "voice command provider does not require install",
+        };
+    }
+    const requestedModelIds = (Array.isArray(input?.modelIds) ? input?.modelIds : [])
+        .map((item) => resolveVoiceModelId(String(item || "").trim()))
+        .filter((item) => Boolean(item));
+    const selectedModelIds = requestedModelIds.length > 0
+        ? requestedModelIds
+        : [resolveVoiceModelId(String(config.modelId || "SenseVoiceSmall")) || "SenseVoiceSmall"];
+    const modelsRootDir = resolveVoiceModelsRootDir({
+        projectRoot: context.rootPath,
+        modelsDir: input?.modelsDir || config.modelsDir,
+    });
+    for (const modelId of selectedModelIds) {
+        const model = VOICE_MODEL_CATALOG.find((item) => item.id === modelId);
+        if (!model) {
+            throw new Error(`Unsupported voice model: ${modelId}`);
+        }
+        const installState = await detectLocalVoiceModelInstallState({
+            modelId,
+            modelsRootDir,
+        });
+        if (!installState.installed || input?.force === true) {
+            await installVoiceModelFromHuggingFace({
+                model,
+                modelsRootDir,
+                force: input?.force === true,
+                hfToken: input?.hfToken,
+            });
+        }
+    }
+    if (input?.installDeps !== false) {
+        await installVoiceTranscribeDependencies({
+            pythonBin: String(input?.pythonBin || config.pythonBin || "").trim() || "python3",
+            runners: resolveVoiceRunnersByModels(selectedModelIds),
+        });
+    }
+    const activeModelId = resolveVoiceModelId(String(input?.activeModel || "")) ||
+        selectedModelIds[0];
+    const nextConfig = {
+        ...config,
+        provider: "local",
+        modelId: activeModelId,
+        modelsDir: modelsRootDir,
+        pythonBin: String(input?.pythonBin || config.pythonBin || "").trim() || undefined,
+        ...(config.command ? { command: config.command } : {}),
+        language: typeof config.language === "string" && config.language.trim()
+            ? config.language.trim()
+            : undefined,
+        strategy: resolveVoiceStrategyByModel(activeModelId),
+        installedModels: selectedModelIds,
+    };
+    await writeVoiceTranscriberConfig({
+        context,
+        value: nextConfig,
+    });
+    return {
+        success: true,
+        message: "voice transcriber installed",
+        details: {
+            modelIds: selectedModelIds,
+            activeModel: activeModelId,
+            modelsRootDir,
+        },
+    };
+}
+/**
+ * 解析 voice 转写句柄。
+ */
+export async function resolveVoiceTranscriber(context) {
+    return {
+        async transcribe(input) {
+            try {
+                const result = await transcribeVoiceAudio({
+                    context,
+                    audioPath: input.audioPath,
+                    language: input.language,
+                });
+                return {
+                    success: true,
+                    text: result.text,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: String(error),
+                };
+            }
+        },
+    };
+}
+/**
+ * 执行一次 voice 转写。
+ */
+export async function transcribeWithVoiceDependency(params) {
+    const transcriber = await resolveVoiceTranscriber(params.context);
+    return transcriber.transcribe({
+        audioPath: params.audioPath,
+        ...(params.language ? { language: params.language } : {}),
+    });
+}
+//# sourceMappingURL=Dependency.js.map

package/bin/voice/Dependency.js.map

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

package/bin/voice/InboundAugment.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Voice 入站消息增强 hook。
+ *
+ * 关键点（中文）
+ * - 只处理 voice/audio 附件，转写结果作为 plugin section 注入。
+ * - 转写失败不阻塞主链路，保持 best-effort。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+/**
+ * 自动转写入站语音附件。
+ */
+export declare function augmentVoiceInboundMessage(params: {
+    context: AgentContext;
+    value: JsonValue;
+}): Promise<JsonValue>;
+//# sourceMappingURL=InboundAugment.d.ts.map

package/bin/voice/InboundAugment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InboundAugment.d.ts","sourceRoot":"","sources":["../../src/voice/InboundAugment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAEjG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAG/E;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;CAClB,GAAG,OAAO,CAAC,SAAS,CAAC,CAuCrB"}

package/bin/voice/InboundAugment.js

@@ -0,0 +1,47 @@
+/**
+ * Voice 入站消息增强 hook。
+ *
+ * 关键点（中文）
+ * - 只处理 voice/audio 附件，转写结果作为 plugin section 注入。
+ * - 转写失败不阻塞主链路，保持 best-effort。
+ */
+import { transcribeWithVoiceDependency } from "../voice/Dependency.js";
+/**
+ * 自动转写入站语音附件。
+ */
+export async function augmentVoiceInboundMessage(params) {
+    const input = params.value;
+    const voiceAttachments = (Array.isArray(input.attachments) ? input.attachments : []).filter((item) => (item.kind === "voice" || item.kind === "audio") &&
+        typeof item.path === "string" &&
+        item.path.trim());
+    if (voiceAttachments.length === 0) {
+        return input;
+    }
+    const pluginSections = Array.isArray(input.pluginSections)
+        ? [...input.pluginSections]
+        : [];
+    for (const attachment of voiceAttachments) {
+        try {
+            const result = await transcribeWithVoiceDependency({
+                context: params.context,
+                audioPath: String(attachment.path || "").trim(),
+            });
+            const text = typeof result.text === "string" ? result.text.trim() : "";
+            if (!text)
+                continue;
+            const absPath = String(attachment.path || "").trim();
+            const rel = absPath.startsWith(`${params.context.rootPath}/`)
+                ? absPath.slice(params.context.rootPath.length + 1)
+                : absPath;
+            pluginSections.push(`【语音转写 ${attachment.kind}: ${rel}】\n${text}`);
+        }
+        catch {
+            // 关键点（中文）：转写失败不阻塞主链路，保持 best-effort。
+        }
+    }
+    return {
+        ...input,
+        pluginSections,
+    };
+}
+//# sourceMappingURL=InboundAugment.js.map

package/bin/voice/InboundAugment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InboundAugment.js","sourceRoot":"","sources":["../../src/voice/InboundAugment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,MAGhD;IACC,MAAM,KAAK,GAAG,MAAM,CAAC,KAA2C,CAAC;IACjE,MAAM,gBAAgB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CACzF,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC;QAChD,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CACnB,CAAC;IACF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,KAA6B,CAAC;IACvC,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;QACxD,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC;QAC3B,CAAC,CAAC,EAAE,CAAC;IAEP,KAAK,MAAM,UAAU,IAAI,gBAAgB,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAAC;gBACjD,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;aAChD,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACrD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC;gBAC3D,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;gBACnD,CAAC,CAAC,OAAO,CAAC;YACZ,cAAc,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,IAAI,KAAK,GAAG,MAAM,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,KAAK;QACR,cAAc;KACS,CAAC;AAC5B,CAAC"}

package/bin/voice/ModelCatalog.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Voice 插件模型目录封装。
+ *
+ * 关键点（中文）
+ * - 对 plugin 层暴露稳定的 voice 领域接口。
+ * - plugin 不直接依赖底层 runtime 文件布局，只依赖这里的领域封装。
+ */
+/**
+ * 列出内置 voice 模型目录。
+ */
+export declare function listVoiceModels(): Array<{
+    /**
+     * 稳定模型 ID。
+     */
+    id: string;
+    /**
+     * 用户可读标签。
+     */
+    label: string;
+    /**
+     * 用户可读说明。
+     */
+    description: string;
+}>;
+/**
+ * 解析用户输入的 voice 模型 ID。
+ */
+export declare function resolveVoicePluginModelId(input: string): string | null;
+//# sourceMappingURL=ModelCatalog.d.ts.map

package/bin/voice/ModelCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelCatalog.d.ts","sourceRoot":"","sources":["../../src/voice/ModelCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;GAEG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IACvC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAMD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEtE"}

package/bin/voice/ModelCatalog.js

@@ -0,0 +1,25 @@
+/**
+ * Voice 插件模型目录封装。
+ *
+ * 关键点（中文）
+ * - 对 plugin 层暴露稳定的 voice 领域接口。
+ * - plugin 不直接依赖底层 runtime 文件布局，只依赖这里的领域封装。
+ */
+import { VOICE_MODEL_CATALOG, resolveVoiceModelId, } from "../voice/runtime/Catalog.js";
+/**
+ * 列出内置 voice 模型目录。
+ */
+export function listVoiceModels() {
+    return VOICE_MODEL_CATALOG.map((item) => ({
+        id: item.id,
+        label: item.label,
+        description: item.description,
+    }));
+}
+/**
+ * 解析用户输入的 voice 模型 ID。
+ */
+export function resolveVoicePluginModelId(input) {
+    return resolveVoiceModelId(input);
+}
+//# sourceMappingURL=ModelCatalog.js.map

package/bin/voice/ModelCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelCatalog.js","sourceRoot":"","sources":["../../src/voice/ModelCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,eAAe;IAc7B,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxC,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/bin/voice/runtime/Catalog.d.ts

@@ -0,0 +1,18 @@
+import type { VoiceModelCatalogItem, VoiceModelId } from "../../voice/types/Voice.js";
+/**
+ * Voice 内置模型目录。
+ *
+ * 关键点（中文）
+ * - 统一维护 CLI 展示、下载源与配置落盘 ID。
+ * - 只保留“稳定字段”，避免目录频繁变动影响外部调用。
+ */
+export declare const VOICE_MODEL_CATALOG: readonly VoiceModelCatalogItem[];
+/**
+ * 解析用户输入为稳定模型 ID（支持别名与大小写）。
+ */
+export declare function resolveVoiceModelId(input: string): VoiceModelId | null;
+/**
+ * 读取目录项；不存在返回 null。
+ */
+export declare function getVoiceModelCatalogItem(id: VoiceModelId): VoiceModelCatalogItem | null;
+//# sourceMappingURL=Catalog.d.ts.map

package/bin/voice/runtime/Catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Catalog.d.ts","sourceRoot":"","sources":["../../../src/voice/runtime/Catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAElF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,qBAAqB,EAsBtD,CAAC;AAoBX;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMtE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,GAAG,qBAAqB,GAAG,IAAI,CAEvF"}