@xopcai/xopc 0.0.220 → 0.0.222

package/dist/gateway/static/root/index.html

@@ -11,7 +11,7 @@
     <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png?v=20260713-1" />
     <link rel="manifest" href="/site.webmanifest?v=20260713-1" />
     <title>XOPC — Keep what matters moving.</title>
-    <script type="module" crossorigin src="/assets/index-V9g9-SWT.js"></script>
+    <script type="module" crossorigin src="/assets/index-jqDCfet4.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-aKtaBQYM.js">
     <link rel="modulepreload" crossorigin href="/assets/preload-helper-zJ_50EbN.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-react-BOUWij0V.js">
@@ -24,13 +24,13 @@
     <link rel="modulepreload" crossorigin href="/assets/download-Dk-ZjtO6.js">
     <link rel="modulepreload" crossorigin href="/assets/plus-Q2yW6OE7.js">
     <link rel="modulepreload" crossorigin href="/assets/x-B_N4OPjy.js">
-    <link rel="modulepreload" crossorigin href="/assets/messages-BQHpB4VI.js">
-    <link rel="modulepreload" crossorigin href="/assets/locale-store-D3Q2yEAb.js">
+    <link rel="modulepreload" crossorigin href="/assets/messages-kx5W39dO.js">
+    <link rel="modulepreload" crossorigin href="/assets/locale-store-iKjqemWG.js">
     <link rel="modulepreload" crossorigin href="/assets/cn-JdwAhgNB.js">
     <link rel="modulepreload" crossorigin href="/assets/schemas-zIBW3wiV.js">
     <link rel="modulepreload" crossorigin href="/assets/product-delivery-tRr-7IxY.js">
     <link rel="modulepreload" crossorigin href="/assets/copy-to-clipboard-HOJ79TWv.js">
-    <link rel="modulepreload" crossorigin href="/assets/markdown-view-WYArkdrc.js">
+    <link rel="modulepreload" crossorigin href="/assets/markdown-view-DYkxMtJA.js">
     <link rel="modulepreload" crossorigin href="/assets/dist-DY4Af0fY.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-swr-BIWyz7Rc.js">
     <link rel="modulepreload" crossorigin href="/assets/check-DUBLcKHA.js">
@@ -44,25 +44,25 @@
     <link rel="modulepreload" crossorigin href="/assets/eye-CABVeTq0.js">
     <link rel="modulepreload" crossorigin href="/assets/file-code-corner-byQA1VfD.js">
     <link rel="modulepreload" crossorigin href="/assets/globe-DSSGFWFn.js">
-    <link rel="modulepreload" crossorigin href="/assets/notes-api-DMEon7Zv.js">
+    <link rel="modulepreload" crossorigin href="/assets/notes-api-DJizatxh.js">
     <link rel="modulepreload" crossorigin href="/assets/loader-circle-CifKLtgG.js">
     <link rel="modulepreload" crossorigin href="/assets/rotate-cw-LIg3Am9S.js">
     <link rel="modulepreload" crossorigin href="/assets/search-DA7gz22f.js">
     <link rel="modulepreload" crossorigin href="/assets/middleware-Pd0e8Igk.js">
     <link rel="modulepreload" crossorigin href="/assets/tool-activity-R8V9l6nk.js">
     <link rel="modulepreload" crossorigin href="/assets/button-CSEbl4zT.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-DdJJZR8M.js">
-    <link rel="modulepreload" crossorigin href="/assets/registry-api-DRyvynb5.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-B2zpkNvi.js">
+    <link rel="modulepreload" crossorigin href="/assets/registry-api-Cx3JxXSL.js">
     <link rel="modulepreload" crossorigin href="/assets/config-reload-event-Bjh2zoKp.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-CnwF9Vso.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-BzTbnu4O.js">
     <link rel="modulepreload" crossorigin href="/assets/electron-env-DH5wF8X8.js">
     <link rel="modulepreload" crossorigin href="/assets/form-field-width-DJw_jULe.js">
     <link rel="modulepreload" crossorigin href="/assets/interaction-BmQogeqz.js">
     <link rel="modulepreload" crossorigin href="/assets/is-masked-secret-DOkL5b_X.js">
-    <link rel="modulepreload" crossorigin href="/assets/activity-store-DeKZ36Jy.js">
-    <link rel="modulepreload" crossorigin href="/assets/theme-store-CvnEHGyP.js">
+    <link rel="modulepreload" crossorigin href="/assets/activity-store-NItGQmvR.js">
+    <link rel="modulepreload" crossorigin href="/assets/theme-store-BOD2D0dJ.js">
     <link rel="stylesheet" crossorigin href="/assets/markdown-view-DD_PgVue.css">
-    <link rel="stylesheet" crossorigin href="/assets/index-Cf0qTkBK.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-BXGC3VFm.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/package.js

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.0.220";
+var version = "0.0.222";
 //#endregion
 export { version };

package/dist/src/agent/agent-manager.js

@@ -4,7 +4,6 @@ import { init_logger } from "../utils/logger.js";
 import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
 import { getSessionConfig } from "../storage/sqlite/config-repository.js";
 import "../storage/sqlite/index.js";
-import { checkBoundary } from "../agent-runtime/boundary-guard.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
@@ -39,6 +38,7 @@ import { UserContextCoordinator } from "./memory/user-context-coordinator.js";
 import { WorkspaceRuntimeRegistry } from "./workspace-runtime/registry.js";
 import { BackgroundReviewCoordinator } from "./background-review/coordinator.js";
 import { maybeRequestChannelExecApproval } from "../channels/exec-approval-runtime.js";
+import { checkBoundary } from "../agent-runtime/boundary-guard.js";
 import { SkillFilesystemWatcher } from "./skills/filesystem-watcher.js";
 import { ProjectTrustStore, hasTrustRequiringProjectResources } from "../project-trust/trust-store.js";
 import { basename, resolve, sep } from "node:path";

package/dist/src/agent/memory/create-memory-manager.js

@@ -1,8 +1,8 @@
-import { buildMemoryRuntime } from "../../agent-runtime/memory-runtime.js";
 import { isMemorySubsystemEnabled } from "./memory-config.js";
 import { BuiltinMemoryProvider } from "./builtin-provider.js";
 import { MemoryManager } from "./manager.js";
 import { loadMemoryPluginProviders } from "./plugin-discovery.js";
+import { buildMemoryRuntime } from "../../agent-runtime/memory-runtime.js";
 //#region src/agent/memory/create-memory-manager.ts
 function createMemoryManagerFromConfig(config) {
 	const routing = resolveMemoryManagerOptions(config);

package/dist/src/agent-runtime/index.js

@@ -1,7 +1,7 @@
+import { buildMemoryRuntime } from "./memory-runtime.js";
 import { checkBoundary } from "./boundary-guard.js";
 import { resolveModelRole } from "./model-router.js";
 import { buildRuntimeToolRegistry } from "./tool-registry.js";
-import { buildMemoryRuntime } from "./memory-runtime.js";
 import { resolveWorkflow, validateWorkflowForRuntime } from "./workflow-runtime.js";
 import { buildAgentRuntimeProfile } from "./runtime-profile.js";
 import { appendAgentRunEvent, createAgentRunTrace, finishAgentRunTrace, hashEffectiveManifest } from "./run-trace.js";

package/dist/src/agent-runtime/runtime-profile.js

@@ -1,9 +1,9 @@
 import { buildAgentManifestPromptSection } from "../agent-manifest/prompt.js";
 import "../agent-manifest/index.js";
+import { buildMemoryRuntime } from "./memory-runtime.js";
 import { checkBoundary } from "./boundary-guard.js";
 import { resolveModelRole } from "./model-router.js";
 import { buildRuntimeToolRegistry } from "./tool-registry.js";
-import { buildMemoryRuntime } from "./memory-runtime.js";
 import { resolveWorkflow, validateWorkflowForRuntime } from "./workflow-runtime.js";
 //#region src/agent-runtime/runtime-profile.ts
 function buildAgentRuntimeProfile(params) {

package/dist/src/channels/attachments/voice-stt-webchat.js

@@ -1,9 +1,13 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
 import { decodeInboundAttachmentBase64, readInboundAttachmentBuffer } from "./inbound-persist.js";
 import { transcribe } from "../../voice/stt/transcribe-core.js";
 import { isSTTAvailable } from "../../voice/stt/availability.js";
 import "../../voice/stt/index.js";
 //#region src/channels/attachments/voice-stt-webchat.ts
+init_logger();
 const STT_MAX_BYTES = 25 * 1024 * 1024;
+const log = createLogger("VoiceAttachmentSTT");
 function isVoiceLikeAttachment(att) {
 	if (att.type === "voice") return true;
 	return (att.mimeType?.toLowerCase() ?? "").startsWith("audio/");
@@ -52,10 +56,23 @@ async function mergeVoiceTranscriptsIntoUserText(prepared, userText, sttConfig,
 			continue;
 		}
 		try {
-			const r = await transcribe(buf, sttConfig, { language: sttConfig.provider === "alibaba" ? "zh" : void 0 });
+			const r = await transcribe(buf, sttConfig, {
+				language: sttConfig.provider === "alibaba" ? "zh" : void 0,
+				mime: att.mimeType,
+				fileName: att.name
+			});
 			transcripts.push(r.text.trim() || "[Voice: no speech detected]");
-		} catch {
-			transcripts.push("[STT failed]");
+		} catch (error) {
+			const errorMessage = error instanceof Error ? error.message : String(error);
+			log.error({
+				...error instanceof Error ? { err: error } : { errorMessage },
+				fileName: att.name,
+				mimeType: att.mimeType,
+				size: buf.length,
+				phase: "inbound_transcribe"
+			}, `Inbound voice transcription failed: ${errorMessage}`);
+			const decoderUnavailable = /ffmpeg|audio decoder|unsupported_audio_codec/i.test(errorMessage);
+			transcripts.push(decoderUnavailable ? "[STT failed: audio decoder unavailable]" : "[STT failed]");
 		}
 	}
 	return {

package/dist/src/config/agent-profile.js

@@ -1,6 +1,6 @@
+import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import "../agent-manifest/index.js";
-import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 //#region src/config/agent-profile.ts

package/dist/src/connectors/learning-coordinator.js

@@ -10,7 +10,7 @@ import { connectorIdentityKey, normalizeConnectorIdentity } from "./connector-id
 import { ComposioSessionsAdapter } from "./composio-sessions.js";
 import { buildConnectorLearningArguments, getConnectorLearningPlan } from "./learning-recipes.js";
 import { getConnectorDefinition } from "./catalog.js";
-import { createUnderstandingSourceRun, getUnderstandingSourceGrant, listUnderstandingSourceRuns, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceRun, upsertUnderstandingSourceGrant, upsertUserFocus } from "../user-context/sources/repository.js";
+import { createUnderstandingSourceRun, getUnderstandingSourceGrant, listUnderstandingSourceRuns, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceRun, upsertUnderstandingSourceGrant } from "../user-context/sources/repository.js";
 import { claimRegisteredExtraction } from "../user-context/extraction/registry.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import { ConnectedKnowledgePipeline } from "../knowledge/connected-knowledge-pipeline.js";
@@ -227,20 +227,10 @@ function startConnectorLearningCoordinator(options) {
 		};
 		if (structuralExtraction.shouldExecute) try {
 			understanding = await new ConnectedUnderstandingPipeline(options.getMemoryManager()).process(job.agentId, structuralExtraction.run.id);
-			const structuralFocuses = understanding.createdRecords.filter((item) => item.kind === "project_context").map((record) => upsertUserFocus({
-				canonicalKey: `connector-focus:${job.accountId}:${record.id}`,
-				title: record.content.slice(0, 120),
-				summary: record.content,
-				horizon: "ongoing",
-				status: "candidate",
-				confidence: .72,
-				evidenceRefs: [`connector-account:${job.accountId}`],
-				sourceRunId: sourceRun.id
-			}));
 			finishContextExtractionRun({
 				runId: structuralExtraction.run.id,
 				status: "completed",
-				outputs: [...(understanding.writeOutputs ?? []).map((output) => ({
+				outputs: (understanding.writeOutputs ?? []).map((output) => ({
 					candidateKey: output.candidateKey,
 					...output.objectId ? {
 						objectType: "understanding",
@@ -248,13 +238,7 @@ function startConnectorLearningCoordinator(options) {
 					} : {},
 					...output.versionId ? { versionId: output.versionId } : {},
 					outcome: output.outcome
-				})), ...structuralFocuses.map((focus) => ({
-					candidateKey: focus.canonicalKey,
-					objectType: "focus",
-					objectId: focus.id,
-					versionId: focus.versionId,
-					outcome: "created"
-				}))]
+				}))
 			});
 		} catch (error) {
 			finishContextExtractionRun({

package/dist/src/gateway/agents-admin.js

@@ -1,5 +1,5 @@
-import { resolveCapabilityPresetLayer, resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
+import { resolveCapabilityPresetLayer, resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { WORKSPACE_FILES, init_paths } from "../config/paths.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";

package/dist/src/gateway/hono/routes/voice.js

@@ -5,6 +5,7 @@ import { isTTSAvailable, resolveSpeechProvider } from "../../../voice/tts/factor
 import { speak } from "../../../voice/tts/speak-core.js";
 import { mergeTtsConfigFromAppConfig } from "../../../voice/tts/merge-config.js";
 import { getLocalVoiceRuntimeClient } from "../../../voice/local/runtime-client.js";
+import { getAudioDecoderStatus } from "../../../voice/audio/normalize.js";
 import { resolveSttProviderConfigSlice } from "../../../voice/stt/config-slice.js";
 import { STTTranscriptionError, transcribe } from "../../../voice/stt/transcribe-core.js";
 import { isSTTAvailable } from "../../../voice/stt/availability.js";
@@ -200,9 +201,13 @@ function registerVoiceRoutes(authenticated, deps) {
 		});
 	});
 	authenticated.get("/api/voice/local/status", async (c) => {
+		const config = service.currentConfig;
+		const sttConfig = mergeSttConfigFromAppConfig(config.tools?.media?.audio, config.tools?.media);
+		const modelId = typeof sttConfig.providers?.["xopc-local"]?.model === "string" ? sttConfig.providers["xopc-local"].model : "sensevoice-small";
 		const models = await listLocalVoiceModelStatuses();
+		const decoder = getAudioDecoderStatus();
 		try {
-			const runtime = await getLocalVoiceRuntimeClient().request("health", {}, {
+			const runtime = await getLocalVoiceRuntimeClient().request("health", { modelId }, {
 				timeoutMs: 1e4,
 				stopOnTimeout: false
 			});
@@ -213,6 +218,7 @@ function registerVoiceRoutes(authenticated, deps) {
 						...runtime,
 						ready: true
 					},
+					decoder,
 					models
 				}
 			});
@@ -225,6 +231,7 @@ function registerVoiceRoutes(authenticated, deps) {
 						ready: false,
 						error: message
 					},
+					decoder,
 					models
 				}
 			});

package/dist/src/gateway/hono/routes/workflows.js

@@ -7,10 +7,10 @@ import { messagesToClientHistory } from "../../../session/client-history.js";
 import "../../../workflows/domain/index.js";
 import { resolveWorkflowRunArtifactsDir } from "../../../workflows/store/paths.js";
 import { WorkflowDraftService } from "../../../workflows/draft/workflow-draft-service.js";
-import { WorkflowDraftConflictError, WorkflowDraftStore } from "../../../workflows/authoring/workflow-draft-store.js";
-import "../../../workflows/authoring/index.js";
 import "../../../workflows/draft/index.js";
 import { ProjectWorkflowPresetRepository } from "../../../workflows/project-presets/project-workflow-preset-repository.js";
+import { WorkflowDraftConflictError, WorkflowDraftStore } from "../../../workflows/authoring/workflow-draft-store.js";
+import "../../../workflows/authoring/index.js";
 import { basename, join } from "node:path";
 import { readFile, stat } from "node:fs/promises";
 //#region src/gateway/hono/routes/workflows.ts

package/dist/src/gateway/service.js

@@ -50,18 +50,18 @@ import { registerClarifyBridge } from "./clarify-runtime.js";
 import { ChannelManager } from "../channels/manager.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
-import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
-import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
-import "../knowledge/index.js";
-import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
-import { ConnectedSourceChangePublisher } from "../connectors/source-change-publisher.js";
-import { startConnectorSupervisor } from "../connectors/supervisor.js";
 import { DiscussionService } from "../discussions/service.js";
 import { DiscussionOrganizer } from "../discussions/organizer.js";
 import { DiscussionLiveWorker } from "../discussions/live-worker.js";
 import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
 import { DiscussionSealer } from "../discussions/sealer.js";
 import "../discussions/index.js";
+import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
+import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
+import "../knowledge/index.js";
+import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
+import { ConnectedSourceChangePublisher } from "../connectors/source-change-publisher.js";
+import { startConnectorSupervisor } from "../connectors/supervisor.js";
 import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
 import "../endpoint-tools/index.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.220",
+  "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",
@@ -165,8 +159,8 @@
     "vue": "^3.5.35",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/realtime-protocol": "0.0.0",
-    "@xopcai/realtime-client": "0.0.0",
-    "@xopcai/gateway-contract": "0.0.0"
+    "@xopcai/gateway-contract": "0.0.0",
+    "@xopcai/realtime-client": "0.0.0"
   },
   "scripts": {
     "assets:brand": "node scripts/generate-brand-assets.mjs",