@xopcai/xopc 0.0.221 → 0.0.222

package/dist/src/providers/model-registry.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
 import { resolveModelsJsonPath } from "../config/paths.js";
+import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
 import { getDefaultModelValues, init_models_json, validateModelsConfig } from "../config/models-json.js";
 import { getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";

package/dist/src/providers/register-runtime-providers.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
 import { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.js";
+import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
 import { XOPC_CLOUD_PROVIDER_ID, init_xopc_cloud_config, resolveXopcModelRouterUrl } from "./xopc-cloud-config.js";
 //#region src/providers/register-runtime-providers.ts
 function registerRuntimeProvider(modelRuntime, source) {

package/dist/src/tui/tui-startup-resources.js

@@ -1,6 +1,6 @@
 import { resolveStateDir } from "../config/paths-state.js";
-import { init_paths, resolveAgentProfileDir, resolveBundledSkillsDir } from "../config/paths.js";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
+import { init_paths, resolveAgentProfileDir, resolveBundledSkillsDir } from "../config/paths.js";
 import { resolveBootstrapFilesSync } from "../agent/bootstrap/bootstrap-files.js";
 import { createSkillConfigManager, isSkillEnabled } from "../agent/skills/config.js";
 import { loadSkills } from "../agent/skills/index.js";

package/dist/src/tui/tui.js

@@ -2,10 +2,10 @@ import { version } from "../../package.js";
 import { resolveStateDir, resolveXopcDatabasePath } from "../config/paths-state.js";
 import { parseAgentSessionKey } from "../routing/session-key-utils.js";
 import { init_agent_session_key, normalizeAgentId } from "../routing/agent-session-key.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths } from "../config/paths.js";
 import { loadConfig } from "../config/loader.js";
 import { getAllModels, getAllProviders, getApiKey, init_providers, isProviderConfiguredSync } from "../providers/index.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { ProjectTrustStore, hasTrustRequiringProjectResources } from "../project-trust/trust-store.js";
 import { renderWorkflowFinalSummary, renderWorkflowPanel } from "../agent/workflow/snapshot.js";
 import { ensureStarterAgentsInitialized } from "../agent/starter-agents.js";

package/dist/src/voice/audio/normalize.d.ts

@@ -4,6 +4,13 @@ export declare class AudioNormalizationError extends Error {
     readonly code = "unsupported_audio_codec";
     constructor(message: string, options?: ErrorOptions);
 }
+export interface AudioDecoderStatus {
+    available: boolean;
+    command: string;
+    error?: string;
+}
+/** Reports whether compressed browser/mobile recordings can be decoded on this host. */
+export declare function getAudioDecoderStatus(): AudioDecoderStatus;
 export declare function detectAudioFormat(buffer: Buffer): AudioFormat;
 export declare function decodeAudioToMonoFloat32(input: {
     buffer: Buffer;

package/dist/src/voice/audio/normalize.js

@@ -1,7 +1,7 @@
 import { UnsupportedWavEncodingError, decodeWavToMonoFloat32 } from "../local/wav.js";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { mkdtemp, readFile, readdir, rm } from "node:fs/promises";
 //#region src/voice/audio/normalize.ts
 const TARGET_SAMPLE_RATE = 16e3;
@@ -15,6 +15,31 @@ var AudioNormalizationError = class extends Error {
 		this.name = "AudioNormalizationError";
 	}
 };
+function ffmpegCommand() {
+	return process.env.XOPC_FFMPEG_PATH?.trim() || "ffmpeg";
+}
+/** Reports whether compressed browser/mobile recordings can be decoded on this host. */
+function getAudioDecoderStatus() {
+	const command = ffmpegCommand();
+	const result = spawnSync(command, ["-version"], {
+		encoding: "utf8",
+		stdio: [
+			"ignore",
+			"ignore",
+			"pipe"
+		],
+		timeout: 5e3
+	});
+	if (!result.error && result.status === 0) return {
+		available: true,
+		command
+	};
+	return {
+		available: false,
+		command,
+		error: `Audio decoder is unavailable (${command}): ${result.error instanceof Error ? result.error.message : result.stderr?.trim() || `decoder exited with status ${String(result.status)}`}. Install ffmpeg or set XOPC_FFMPEG_PATH.`
+	};
+}
 function detectAudioFormat(buffer) {
 	if (buffer.length >= 12 && buffer.toString("ascii", 0, 4) === "RIFF" && buffer.toString("ascii", 8, 12) === "WAVE") return "wav";
 	if (buffer.length >= 4 && buffer.subarray(0, 4).equals(Buffer.from([
@@ -32,7 +57,8 @@ function detectAudioFormat(buffer) {
 function runFfmpeg(args, options = {}) {
 	options.signal?.throwIfAborted();
 	return new Promise((resolve, reject) => {
-		const child = spawn("ffmpeg", [
+		const command = ffmpegCommand();
+		const child = spawn(command, [
 			"-hide_banner",
 			"-loglevel",
 			"error",
@@ -75,7 +101,7 @@ function runFfmpeg(args, options = {}) {
 			errorBytes += bounded.length;
 		});
 		child.once("error", (error) => {
-			finish(new AudioNormalizationError(error.code === "ENOENT" ? "Audio decoder is unavailable; install ffmpeg to transcribe this format" : `Audio decoder failed to start: ${error.message}`, { cause: error }));
+			finish(new AudioNormalizationError(error.code === "ENOENT" ? `Audio decoder is unavailable (${command}); install ffmpeg or set XOPC_FFMPEG_PATH to transcribe this format` : `Audio decoder failed to start: ${error.message}`, { cause: error }));
 		});
 		child.once("close", (code) => {
 			if (settled) return;
@@ -172,4 +198,4 @@ async function forEachNormalizedAudioSegment(input, consume) {
 	}
 }
 //#endregion
-export { AudioNormalizationError, decodeAudioToMonoFloat32, detectAudioFormat, forEachNormalizedAudioSegment };
+export { AudioNormalizationError, decodeAudioToMonoFloat32, detectAudioFormat, forEachNormalizedAudioSegment, getAudioDecoderStatus };

package/dist/src/voice/local/runtime-worker.js

@@ -7,6 +7,18 @@ import { createInterface } from "node:readline";
 //#region src/voice/local/runtime-worker.ts
 const pipelines = /* @__PURE__ */ new Map();
 const sherpaRecognizers = /* @__PURE__ */ new Map();
+async function assertLocalVoiceEngineAvailable(modelId) {
+	const model = getLocalVoiceModel(modelId);
+	if (model.engine === "sherpa-onnx") {
+		const imported = await import("sherpa-onnx-node").catch((cause) => {
+			throw new Error("The sherpa-onnx local voice engine is not installed. Install sherpa-onnx-node@1.13.4 alongside @xopcai/xopc.", { cause });
+		});
+		if (typeof (imported.default ?? imported).OfflineRecognizer !== "function") throw new Error("The sherpa-onnx local voice engine did not expose OfflineRecognizer");
+	} else await import("@huggingface/transformers").catch((cause) => {
+		throw new Error("The Transformers.js local voice engine is not installed. Install @huggingface/transformers@3.8.1 alongside @xopcai/xopc.", { cause });
+	});
+	return model.engine;
+}
 const networkAgent = new RetryAgent(new EnvHttpProxyAgent(), {
 	maxRetries: 4,
 	minTimeout: 500,
@@ -161,12 +173,20 @@ async function transcribeWithSherpa(modelId, audio, language) {
 }
 async function handle(request) {
 	const params = request.params ?? {};
-	if (request.method === "health") return {
-		ok: true,
-		protocolVersion: 2,
-		engine: "transformers.js+sherpa-onnx",
-		engines: ["transformers.js", "sherpa-onnx"]
-	};
+	if (request.method === "health") {
+		const modelId = typeof params.modelId === "string" && params.modelId ? params.modelId : void 0;
+		const selectedEngine = modelId ? await assertLocalVoiceEngineAvailable(modelId) : void 0;
+		return {
+			ok: true,
+			protocolVersion: 2,
+			engine: "transformers.js+sherpa-onnx",
+			engines: ["transformers.js", "sherpa-onnx"],
+			...modelId ? {
+				modelId,
+				selectedEngine
+			} : {}
+		};
+	}
 	if (request.method === "model.install") {
 		const modelId = String(params.modelId ?? "");
 		const modelDir = resolve(resolveLocalVoiceModelDir(modelId));

package/dist/src/workflows/service/workflow-run-service.js

@@ -1,6 +1,6 @@
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
-import { init_providers, resolveModel } from "../../providers/index.js";
 import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { init_providers, resolveModel } from "../../providers/index.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.221",
+  "version": "0.0.222",
   "description": "Local-first personal AI assistant with reviewable user understanding, durable tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -108,27 +108,22 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@huggingface/transformers": "3.8.1",
     "@larksuiteoapi/node-sdk": "^1.66.0",
-    "playwright-core": "^1.60.0",
-    "sherpa-onnx-node": "1.13.4"
+    "playwright-core": "^1.60.0"
   },
   "peerDependenciesMeta": {
-    "@huggingface/transformers": {
-      "optional": true
-    },
     "@larksuiteoapi/node-sdk": {
       "optional": true
     },
     "playwright-core": {
       "optional": true
-    },
-    "sherpa-onnx-node": {
-      "optional": true
     }
   },
-  "devDependencies": {
+  "optionalDependencies": {
     "@huggingface/transformers": "3.8.1",
+    "sherpa-onnx-node": "1.13.4"
+  },
+  "devDependencies": {
     "@larksuiteoapi/node-sdk": "^1.66.0",
     "@resvg/resvg-js": "^2.6.2",
     "@tailwindcss/vite": "^4.3.0",
@@ -152,7 +147,6 @@
     "onnxruntime-common": "1.21.0",
     "node-pty": "1.1.0",
     "playwright-core": "^1.60.0",
-    "sherpa-onnx-node": "1.13.4",
     "svgo": "4.0.2",
     "tailwindcss": "^4.3.0",
     "tsdown": "0.21.10",
@@ -164,8 +158,8 @@
     "vitest": "4.1.5",
     "vue": "^3.5.35",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
-    "@xopcai/gateway-contract": "0.0.0",
     "@xopcai/realtime-protocol": "0.0.0",
+    "@xopcai/gateway-contract": "0.0.0",
     "@xopcai/realtime-client": "0.0.0"
   },
   "scripts": {