@xopcai/xopc 0.0.144 → 0.0.145

package/dist/src/voice/language-profile.js

@@ -0,0 +1,156 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { DEFAULT_LOCAL_VOICE_MODEL_ID, isLocalVoiceModelInstalled } from "./local/models.js";
+import { startLocalVoiceModelInstall } from "./local/model-manager.js";
+//#region src/voice/language-profile.ts
+init_logger();
+const log = createLogger("Voice:Language");
+function resolveVoiceLanguageProfile(language) {
+	return language === "zh" ? {
+		language,
+		sttLanguage: "auto",
+		edgeLanguage: "zh-CN",
+		edgeVoice: "zh-CN-XiaoxiaoNeural"
+	} : {
+		language,
+		sttLanguage: "en",
+		edgeLanguage: "en-US",
+		edgeVoice: "en-US-MichelleNeural"
+	};
+}
+function inferProductLanguageFromEnvironment() {
+	return [
+		process.env.LC_ALL,
+		process.env.LC_MESSAGES,
+		process.env.LANG,
+		Intl.DateTimeFormat().resolvedOptions().locale
+	].find((value) => typeof value === "string" && value.trim())?.trim().toLowerCase().startsWith("zh") ? "zh" : "en";
+}
+function hasLegacyManualLanguageSelection(config) {
+	const local = config.tools?.media?.audio?.providers?.["xopc-local"];
+	const edge = config.messages?.tts?.providers?.edge;
+	return typeof local?.language === "string" && local.language.trim().length > 0 || typeof edge?.voice === "string" && edge.voice.trim().length > 0 || typeof edge?.lang === "string" && edge.lang.trim().length > 0;
+}
+/**
+* Install safe product defaults while preserving every explicit on/off choice.
+* Older configs with a persisted language or Edge voice are treated as manual.
+*/
+function initializeVoiceDefaults(config, language = inferProductLanguageFromEnvironment()) {
+	const before = JSON.stringify({
+		voice: config.voice,
+		tools: config.tools?.media?.audio,
+		tts: config.messages?.tts
+	});
+	const languageMode = config.voice?.languageMode ?? (hasLegacyManualLanguageSelection(config) ? "manual" : "auto");
+	config.voice = {
+		...config.voice,
+		languageMode,
+		language: config.voice?.language ?? language
+	};
+	config.tools = config.tools ?? {};
+	config.tools.media = config.tools.media ?? {};
+	const audio = config.tools.media.audio;
+	config.tools.media.audio = {
+		...audio,
+		enabled: audio?.enabled ?? true,
+		provider: audio?.provider ?? "xopc-local",
+		fallback: audio?.fallback ?? {
+			enabled: false,
+			order: ["xopc-local"]
+		},
+		providers: {
+			...audio?.providers ?? {},
+			"xopc-local": {
+				model: DEFAULT_LOCAL_VOICE_MODEL_ID,
+				...audio?.providers?.["xopc-local"] ?? {}
+			}
+		}
+	};
+	config.messages = config.messages ?? {};
+	const tts = config.messages.tts;
+	config.messages.tts = {
+		...tts,
+		enabled: tts?.enabled ?? true,
+		provider: tts?.provider ?? "edge",
+		trigger: tts?.trigger ?? "inbound",
+		providers: {
+			...tts?.providers ?? {},
+			edge: {
+				enabled: true,
+				...tts?.providers?.edge ?? {}
+			}
+		}
+	};
+	if (languageMode === "auto") applyAutomaticVoiceLanguage(config, language);
+	return before !== JSON.stringify({
+		voice: config.voice,
+		tools: config.tools?.media?.audio,
+		tts: config.messages?.tts
+	});
+}
+/** Apply product language only to providers whose language mapping is known. */
+function applyAutomaticVoiceLanguage(config, language) {
+	if ((config.voice?.languageMode ?? "auto") !== "auto") return false;
+	const before = JSON.stringify({
+		voice: config.voice,
+		tools: config.tools?.media?.audio,
+		tts: config.messages?.tts
+	});
+	const profile = resolveVoiceLanguageProfile(language);
+	config.voice = {
+		...config.voice,
+		languageMode: "auto",
+		language
+	};
+	const audio = config.tools?.media?.audio;
+	if (audio?.provider === "xopc-local") audio.providers = {
+		...audio.providers ?? {},
+		"xopc-local": {
+			...audio.providers?.["xopc-local"] ?? {},
+			model: DEFAULT_LOCAL_VOICE_MODEL_ID,
+			language: profile.sttLanguage
+		}
+	};
+	const tts = config.messages?.tts;
+	if (tts?.provider === "edge") tts.providers = {
+		...tts.providers ?? {},
+		edge: {
+			enabled: true,
+			...tts.providers?.edge ?? {},
+			voice: profile.edgeVoice,
+			lang: profile.edgeLanguage
+		}
+	};
+	return before !== JSON.stringify({
+		voice: config.voice,
+		tools: config.tools?.media?.audio,
+		tts: config.messages?.tts
+	});
+}
+/** Start the model download without delaying gateway readiness. */
+function prepareConfiguredLocalVoiceModel(config) {
+	const audio = config.tools?.media?.audio;
+	if (audio?.enabled === false || (audio?.provider ?? "xopc-local") !== "xopc-local") return;
+	const configuredModel = audio?.providers?.["xopc-local"]?.model;
+	const modelId = typeof configuredModel === "string" && configuredModel.trim() ? configuredModel.trim() : DEFAULT_LOCAL_VOICE_MODEL_ID;
+	if (isLocalVoiceModelInstalled(modelId)) return;
+	try {
+		startLocalVoiceModelInstall(modelId);
+		log.info({
+			modelId,
+			phase: "startup_prepare"
+		}, "Local voice model preparation started");
+	} catch (err) {
+		const errorMessage = err instanceof Error ? err.message : String(err);
+		log.warn({
+			err,
+			modelId,
+			errorMessage,
+			phase: "startup_prepare"
+		}, `Local voice model preparation failed: ${errorMessage}`);
+	}
+}
+//#endregion
+export { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults, prepareConfiguredLocalVoiceModel, resolveVoiceLanguageProfile };
+
+//# sourceMappingURL=language-profile.js.map

package/dist/src/voice/language-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-profile.js","names":[],"sources":["../../../src/voice/language-profile.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport { createLogger } from '../utils/logger.js';\nimport { startLocalVoiceModelInstall } from './local/model-manager.js';\nimport {\n  DEFAULT_LOCAL_VOICE_MODEL_ID,\n  isLocalVoiceModelInstalled,\n} from './local/models.js';\n\nconst log = createLogger('Voice:Language');\n\nexport type ProductLanguage = 'en' | 'zh';\nexport type VoiceLanguageMode = 'auto' | 'manual';\n\nexport interface VoiceLanguageProfile {\n  language: ProductLanguage;\n  sttLanguage: 'auto' | 'en';\n  edgeLanguage: 'en-US' | 'zh-CN';\n  edgeVoice: 'en-US-MichelleNeural' | 'zh-CN-XiaoxiaoNeural';\n}\n\nexport function resolveVoiceLanguageProfile(language: ProductLanguage): VoiceLanguageProfile {\n  return language === 'zh'\n    ? {\n        language,\n        sttLanguage: 'auto',\n        edgeLanguage: 'zh-CN',\n        edgeVoice: 'zh-CN-XiaoxiaoNeural',\n      }\n    : {\n        language,\n        sttLanguage: 'en',\n        edgeLanguage: 'en-US',\n        edgeVoice: 'en-US-MichelleNeural',\n      };\n}\n\nexport function inferProductLanguageFromEnvironment(): ProductLanguage {\n  const locale = [\n    process.env.LC_ALL,\n    process.env.LC_MESSAGES,\n    process.env.LANG,\n    Intl.DateTimeFormat().resolvedOptions().locale,\n  ].find((value) => typeof value === 'string' && value.trim());\n  return locale?.trim().toLowerCase().startsWith('zh') ? 'zh' : 'en';\n}\n\nfunction hasLegacyManualLanguageSelection(config: Config): boolean {\n  const local = config.tools?.media?.audio?.providers?.['xopc-local'];\n  const edge = config.messages?.tts?.providers?.edge;\n  return (\n    (typeof local?.language === 'string' && local.language.trim().length > 0) ||\n    (typeof edge?.voice === 'string' && edge.voice.trim().length > 0) ||\n    (typeof edge?.lang === 'string' && edge.lang.trim().length > 0)\n  );\n}\n\n/**\n * Install safe product defaults while preserving every explicit on/off choice.\n * Older configs with a persisted language or Edge voice are treated as manual.\n */\nexport function initializeVoiceDefaults(\n  config: Config,\n  language: ProductLanguage = inferProductLanguageFromEnvironment(),\n): boolean {\n  const before = JSON.stringify({ voice: config.voice, tools: config.tools?.media?.audio, tts: config.messages?.tts });\n  const existingMode = config.voice?.languageMode;\n  const languageMode: VoiceLanguageMode =\n    existingMode ?? (hasLegacyManualLanguageSelection(config) ? 'manual' : 'auto');\n\n  config.voice = {\n    ...config.voice,\n    languageMode,\n    language: config.voice?.language ?? language,\n  };\n\n  config.tools = config.tools ?? {};\n  config.tools.media = config.tools.media ?? {};\n  const audio = config.tools.media.audio;\n  config.tools.media.audio = {\n    ...audio,\n    enabled: audio?.enabled ?? true,\n    provider: audio?.provider ?? 'xopc-local',\n    fallback: audio?.fallback ?? { enabled: false, order: ['xopc-local'] },\n    providers: {\n      ...(audio?.providers ?? {}),\n      'xopc-local': {\n        model: DEFAULT_LOCAL_VOICE_MODEL_ID,\n        ...(audio?.providers?.['xopc-local'] ?? {}),\n      },\n    },\n  };\n\n  config.messages = config.messages ?? {};\n  const tts = config.messages.tts;\n  config.messages.tts = {\n    ...tts,\n    enabled: tts?.enabled ?? true,\n    provider: tts?.provider ?? 'edge',\n    trigger: tts?.trigger ?? 'inbound',\n    providers: {\n      ...(tts?.providers ?? {}),\n      edge: {\n        enabled: true,\n        ...(tts?.providers?.edge ?? {}),\n      },\n    },\n  };\n\n  if (languageMode === 'auto') {\n    applyAutomaticVoiceLanguage(config, language);\n  }\n  return before !== JSON.stringify({ voice: config.voice, tools: config.tools?.media?.audio, tts: config.messages?.tts });\n}\n\n/** Apply product language only to providers whose language mapping is known. */\nexport function applyAutomaticVoiceLanguage(config: Config, language: ProductLanguage): boolean {\n  if ((config.voice?.languageMode ?? 'auto') !== 'auto') return false;\n  const before = JSON.stringify({ voice: config.voice, tools: config.tools?.media?.audio, tts: config.messages?.tts });\n  const profile = resolveVoiceLanguageProfile(language);\n\n  config.voice = { ...config.voice, languageMode: 'auto', language };\n  const audio = config.tools?.media?.audio;\n  if (audio?.provider === 'xopc-local') {\n    audio.providers = {\n      ...(audio.providers ?? {}),\n      'xopc-local': {\n        ...(audio.providers?.['xopc-local'] ?? {}),\n        model: DEFAULT_LOCAL_VOICE_MODEL_ID,\n        language: profile.sttLanguage,\n      },\n    };\n  }\n  const tts = config.messages?.tts;\n  if (tts?.provider === 'edge') {\n    tts.providers = {\n      ...(tts.providers ?? {}),\n      edge: {\n        enabled: true,\n        ...(tts.providers?.edge ?? {}),\n        voice: profile.edgeVoice,\n        lang: profile.edgeLanguage,\n      },\n    };\n  }\n  return before !== JSON.stringify({ voice: config.voice, tools: config.tools?.media?.audio, tts: config.messages?.tts });\n}\n\n/** Start the model download without delaying gateway readiness. */\nexport function prepareConfiguredLocalVoiceModel(config: Config): void {\n  const audio = config.tools?.media?.audio;\n  if (audio?.enabled === false || (audio?.provider ?? 'xopc-local') !== 'xopc-local') return;\n  const configuredModel = audio?.providers?.['xopc-local']?.model;\n  const modelId = typeof configuredModel === 'string' && configuredModel.trim()\n    ? configuredModel.trim()\n    : DEFAULT_LOCAL_VOICE_MODEL_ID;\n  if (isLocalVoiceModelInstalled(modelId)) return;\n  try {\n    startLocalVoiceModelInstall(modelId);\n    log.info({ modelId, phase: 'startup_prepare' }, 'Local voice model preparation started');\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    log.warn({ err, modelId, errorMessage, phase: 'startup_prepare' }, `Local voice model preparation failed: ${errorMessage}`);\n  }\n}\n"],"mappings":"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"}

package/dist/src/voice/local/model-files.d.ts

@@ -0,0 +1,14 @@
+import type { LocalVoiceModelDefinition } from './models.js';
+export interface LocalVoiceFileProgress {
+    status: 'download';
+    file: string;
+    loaded: number;
+    total: number;
+    progress: number;
+}
+export declare function downloadLocalVoiceModelFiles(options: {
+    model: LocalVoiceModelDefinition;
+    destinationDir: string;
+    remoteHosts: readonly string[];
+    onProgress?: (progress: LocalVoiceFileProgress) => void;
+}): Promise<void>;

package/dist/src/voice/local/model-files.js

@@ -0,0 +1,94 @@
+import { dirname, join } from "node:path";
+import { createReadStream, createWriteStream } from "node:fs";
+import { createHash } from "node:crypto";
+import { mkdir, rm, stat } from "node:fs/promises";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+//#region src/voice/local/model-files.ts
+function resolveModelFileUrl(remoteHost, model, file) {
+	const base = remoteHost.endsWith("/") ? remoteHost : `${remoteHost}/`;
+	const path = file.path.split("/").map(encodeURIComponent).join("/");
+	return new URL(`${model.repository}/resolve/${model.revision}/${path}`, base).toString();
+}
+async function sha256File(path) {
+	const hash = createHash("sha256");
+	for await (const chunk of createReadStream(path)) hash.update(chunk);
+	return hash.digest("hex");
+}
+async function downloadFile(url, destination, expectedBytes, onBytes) {
+	const existing = await stat(destination).catch(() => null);
+	let offset = existing?.isFile() ? existing.size : 0;
+	if (offset > expectedBytes) {
+		await rm(destination, { force: true });
+		offset = 0;
+	}
+	if (offset === expectedBytes) {
+		onBytes(offset);
+		return;
+	}
+	const response = await fetch(url, {
+		redirect: "follow",
+		headers: offset > 0 ? { Range: `bytes=${offset}-` } : void 0
+	});
+	if (!response.ok || !response.body) throw new Error(`Model download failed with HTTP ${response.status}`);
+	const isResume = offset > 0 && response.status === 206;
+	if (offset > 0 && !isResume) offset = 0;
+	const declaredBytes = Number(response.headers.get("content-length"));
+	const expectedResponseBytes = expectedBytes - offset;
+	if (Number.isFinite(declaredBytes) && declaredBytes > 0 && declaredBytes !== expectedResponseBytes) throw new Error(`Model download size mismatch: expected ${expectedResponseBytes}, received ${declaredBytes}`);
+	await mkdir(dirname(destination), { recursive: true });
+	let loaded = offset;
+	let lastReportedBytes = offset;
+	let lastReportedAt = 0;
+	const source = Readable.fromWeb(response.body);
+	source.on("data", (chunk) => {
+		loaded += chunk.length;
+		const now = Date.now();
+		if (loaded === expectedBytes || loaded - lastReportedBytes >= 256 * 1024 || now - lastReportedAt >= 250) {
+			lastReportedBytes = loaded;
+			lastReportedAt = now;
+			onBytes(loaded);
+		}
+	});
+	await pipeline(source, createWriteStream(destination, {
+		flags: isResume ? "a" : "w",
+		mode: 384
+	}));
+	if (loaded !== expectedBytes) throw new Error(`Model download was incomplete: expected ${expectedBytes}, received ${loaded}`);
+}
+async function verifyModelFile(path, file) {
+	if ((await stat(path)).size !== file.bytes) throw new Error(`Model file size mismatch for ${file.path}`);
+	if (await sha256File(path) !== file.sha256) throw new Error(`Model file checksum mismatch for ${file.path}`);
+}
+async function downloadLocalVoiceModelFiles(options) {
+	const files = options.model.files;
+	if (!files?.length) throw new Error(`No downloadable files declared for ${options.model.id}`);
+	const total = files.reduce((sum, file) => sum + file.bytes, 0);
+	let completedBytes = 0;
+	for (const file of files) {
+		const destination = join(options.destinationDir, file.path);
+		let lastError;
+		for (const host of options.remoteHosts) try {
+			await downloadFile(resolveModelFileUrl(host, options.model, file), destination, file.bytes, (fileBytes) => options.onProgress?.({
+				status: "download",
+				file: file.path,
+				loaded: completedBytes + fileBytes,
+				total,
+				progress: (completedBytes + fileBytes) / total
+			}));
+			await verifyModelFile(destination, file);
+			lastError = void 0;
+			break;
+		} catch (error) {
+			lastError = error;
+			const message = error instanceof Error ? error.message : String(error);
+			if (message.includes("checksum mismatch") || message.includes("size mismatch")) await rm(destination, { force: true });
+		}
+		if (lastError) throw lastError;
+		completedBytes += file.bytes;
+	}
+}
+//#endregion
+export { downloadLocalVoiceModelFiles };
+
+//# sourceMappingURL=model-files.js.map

package/dist/src/voice/local/model-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-files.js","names":[],"sources":["../../../../src/voice/local/model-files.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { createReadStream, createWriteStream } from 'node:fs';\nimport { mkdir, rm, stat } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport { Readable } from 'node:stream';\nimport { pipeline } from 'node:stream/promises';\n\nimport type { LocalVoiceModelDefinition, LocalVoiceModelFile } from './models.js';\n\nexport interface LocalVoiceFileProgress {\n  status: 'download';\n  file: string;\n  loaded: number;\n  total: number;\n  progress: number;\n}\n\nfunction resolveModelFileUrl(\n  remoteHost: string,\n  model: LocalVoiceModelDefinition,\n  file: LocalVoiceModelFile,\n): string {\n  const base = remoteHost.endsWith('/') ? remoteHost : `${remoteHost}/`;\n  const path = file.path.split('/').map(encodeURIComponent).join('/');\n  return new URL(`${model.repository}/resolve/${model.revision}/${path}`, base).toString();\n}\n\nasync function sha256File(path: string): Promise<string> {\n  const hash = createHash('sha256');\n  for await (const chunk of createReadStream(path)) hash.update(chunk as Buffer);\n  return hash.digest('hex');\n}\n\nasync function downloadFile(\n  url: string,\n  destination: string,\n  expectedBytes: number,\n  onBytes: (bytes: number) => void,\n): Promise<void> {\n  const existing = await stat(destination).catch(() => null);\n  let offset = existing?.isFile() ? existing.size : 0;\n  if (offset > expectedBytes) {\n    await rm(destination, { force: true });\n    offset = 0;\n  }\n  if (offset === expectedBytes) {\n    onBytes(offset);\n    return;\n  }\n  const response = await fetch(url, {\n    redirect: 'follow',\n    headers: offset > 0 ? { Range: `bytes=${offset}-` } : undefined,\n  });\n  if (!response.ok || !response.body) {\n    throw new Error(`Model download failed with HTTP ${response.status}`);\n  }\n  const isResume = offset > 0 && response.status === 206;\n  if (offset > 0 && !isResume) offset = 0;\n  const declaredBytes = Number(response.headers.get('content-length'));\n  const expectedResponseBytes = expectedBytes - offset;\n  if (Number.isFinite(declaredBytes) && declaredBytes > 0 && declaredBytes !== expectedResponseBytes) {\n    throw new Error(`Model download size mismatch: expected ${expectedResponseBytes}, received ${declaredBytes}`);\n  }\n\n  await mkdir(dirname(destination), { recursive: true });\n  let loaded = offset;\n  let lastReportedBytes = offset;\n  let lastReportedAt = 0;\n  const source = Readable.fromWeb(response.body as never);\n  source.on('data', (chunk: Buffer) => {\n    loaded += chunk.length;\n    const now = Date.now();\n    if (loaded === expectedBytes || loaded - lastReportedBytes >= 256 * 1024 || now - lastReportedAt >= 250) {\n      lastReportedBytes = loaded;\n      lastReportedAt = now;\n      onBytes(loaded);\n    }\n  });\n  await pipeline(source, createWriteStream(destination, { flags: isResume ? 'a' : 'w', mode: 0o600 }));\n  if (loaded !== expectedBytes) {\n    throw new Error(`Model download was incomplete: expected ${expectedBytes}, received ${loaded}`);\n  }\n}\n\nasync function verifyModelFile(path: string, file: LocalVoiceModelFile): Promise<void> {\n  const info = await stat(path);\n  if (info.size !== file.bytes) {\n    throw new Error(`Model file size mismatch for ${file.path}`);\n  }\n  const actual = await sha256File(path);\n  if (actual !== file.sha256) {\n    throw new Error(`Model file checksum mismatch for ${file.path}`);\n  }\n}\n\nexport async function downloadLocalVoiceModelFiles(options: {\n  model: LocalVoiceModelDefinition;\n  destinationDir: string;\n  remoteHosts: readonly string[];\n  onProgress?: (progress: LocalVoiceFileProgress) => void;\n}): Promise<void> {\n  const files = options.model.files;\n  if (!files?.length) throw new Error(`No downloadable files declared for ${options.model.id}`);\n  const total = files.reduce((sum, file) => sum + file.bytes, 0);\n  let completedBytes = 0;\n\n  for (const file of files) {\n    const destination = join(options.destinationDir, file.path);\n    let lastError: unknown;\n    for (const host of options.remoteHosts) {\n      try {\n        await downloadFile(\n          resolveModelFileUrl(host, options.model, file),\n          destination,\n          file.bytes,\n          (fileBytes) => options.onProgress?.({\n            status: 'download',\n            file: file.path,\n            loaded: completedBytes + fileBytes,\n            total,\n            progress: (completedBytes + fileBytes) / total,\n          }),\n        );\n        await verifyModelFile(destination, file);\n        lastError = undefined;\n        break;\n      } catch (error) {\n        lastError = error;\n        const message = error instanceof Error ? error.message : String(error);\n        if (message.includes('checksum mismatch') || message.includes('size mismatch')) {\n          await rm(destination, { force: true });\n        }\n      }\n    }\n    if (lastError) {\n      throw lastError;\n    }\n    completedBytes += file.bytes;\n  }\n}\n"],"mappings":"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"}

package/dist/src/voice/local/model-manager.d.ts

@@ -0,0 +1,18 @@
+export type LocalVoiceModelState = 'not_installed' | 'downloading' | 'ready' | 'error';
+export interface LocalVoiceModelStatus {
+    id: string;
+    name: string;
+    description: string;
+    approximateBytes: number;
+    engine: string;
+    languages: readonly string[];
+    recommended?: boolean;
+    state: LocalVoiceModelState;
+    progress?: number;
+    downloadedBytes?: number;
+    totalBytes?: number;
+    error?: string;
+}
+export declare function listLocalVoiceModelStatuses(): Promise<LocalVoiceModelStatus[]>;
+export declare function startLocalVoiceModelInstall(modelId: string): LocalVoiceModelStatus;
+export declare function removeLocalVoiceModel(modelId: string): Promise<void>;

package/dist/src/voice/local/model-manager.js

@@ -0,0 +1,135 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { LOCAL_VOICE_MODELS, getLocalVoiceModel, isLocalVoiceModelInstalled, resolveLocalVoiceModelDir, resolveLocalVoiceModelMarkerPath } from "./models.js";
+import { getLocalVoiceRuntimeClient } from "./runtime-client.js";
+import { join } from "node:path";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+//#region src/voice/local/model-manager.ts
+init_logger();
+const log = createLogger("LocalVoice:Models");
+const jobs = /* @__PURE__ */ new Map();
+function progressFraction(progress) {
+	if (typeof progress.progress === "number" && Number.isFinite(progress.progress)) return progress.progress > 1 ? progress.progress / 100 : progress.progress;
+	if (typeof progress.loaded === "number" && typeof progress.total === "number" && progress.total > 0) return progress.loaded / progress.total;
+}
+async function listLocalVoiceModelStatuses() {
+	return Promise.all(LOCAL_VOICE_MODELS.map(async (model) => {
+		const active = jobs.get(model.id);
+		if (active) return { ...active };
+		if (!isLocalVoiceModelInstalled(model.id)) return {
+			id: model.id,
+			name: model.name,
+			description: model.description,
+			approximateBytes: model.approximateBytes,
+			engine: model.engine,
+			languages: model.languages,
+			recommended: model.recommended,
+			state: "not_installed"
+		};
+		let installedAt;
+		try {
+			installedAt = JSON.parse(await readFile(resolveLocalVoiceModelMarkerPath(model.id), "utf8")).installedAt;
+		} catch {}
+		return {
+			id: model.id,
+			name: model.name,
+			description: installedAt ? `${model.description} Installed ${installedAt}.` : model.description,
+			approximateBytes: model.approximateBytes,
+			engine: model.engine,
+			languages: model.languages,
+			recommended: model.recommended,
+			state: "ready"
+		};
+	}));
+}
+function startLocalVoiceModelInstall(modelId) {
+	const model = getLocalVoiceModel(modelId);
+	const existing = jobs.get(model.id);
+	if (existing?.state === "downloading") return { ...existing };
+	const status = {
+		id: model.id,
+		name: model.name,
+		description: model.description,
+		approximateBytes: model.approximateBytes,
+		engine: model.engine,
+		languages: model.languages,
+		recommended: model.recommended,
+		state: "downloading",
+		progress: 0
+	};
+	jobs.set(model.id, status);
+	(async () => {
+		const modelDir = resolveLocalVoiceModelDir(model.id);
+		const stagingDir = `${modelDir}.download`;
+		try {
+			if (model.engine === "transformers.js") await rm(stagingDir, {
+				recursive: true,
+				force: true
+			});
+			await mkdir(stagingDir, { recursive: true });
+			await getLocalVoiceRuntimeClient().request("model.install", {
+				modelId: model.id,
+				cacheDir: stagingDir
+			}, { onProgress: (progress) => {
+				const current = jobs.get(model.id);
+				if (!current) return;
+				current.progress = progressFraction(progress) ?? current.progress;
+				current.downloadedBytes = progress.loaded;
+				current.totalBytes = progress.total;
+			} });
+			await writeFile(join(stagingDir, "installed.json"), `${JSON.stringify({
+				modelId: model.id,
+				repository: model.repository,
+				revision: model.revision,
+				engine: model.engine,
+				...model.dtype ? { dtype: model.dtype } : {},
+				installedAt: (/* @__PURE__ */ new Date()).toISOString()
+			}, null, 2)}\n`, { mode: 384 });
+			await rm(modelDir, {
+				recursive: true,
+				force: true
+			});
+			await rename(stagingDir, modelDir);
+			jobs.delete(model.id);
+			log.info({ modelId: model.id }, "Local voice model installed");
+		} catch (error) {
+			if (model.engine === "transformers.js") await rm(stagingDir, {
+				recursive: true,
+				force: true
+			}).catch(() => {});
+			const message = error instanceof Error ? error.message : String(error);
+			jobs.set(model.id, {
+				...status,
+				state: "error",
+				error: message
+			});
+			log.error({
+				err: error,
+				modelId: model.id
+			}, `Local voice model installation failed: ${message}`);
+		}
+	})();
+	return { ...status };
+}
+async function removeLocalVoiceModel(modelId) {
+	const model = getLocalVoiceModel(modelId);
+	if (jobs.get(model.id)?.state === "downloading") throw new Error("Cannot remove a model while it is downloading");
+	try {
+		await getLocalVoiceRuntimeClient().request("model.unload", { modelId: model.id }, { timeoutMs: 1e4 });
+	} catch (error) {
+		log.warn({
+			err: error,
+			modelId: model.id
+		}, "Local voice runtime unload failed; removing model files");
+	}
+	await rm(resolveLocalVoiceModelDir(model.id), {
+		recursive: true,
+		force: true
+	});
+	jobs.delete(model.id);
+	log.info({ modelId: model.id }, "Local voice model removed");
+}
+//#endregion
+export { listLocalVoiceModelStatuses, removeLocalVoiceModel, startLocalVoiceModelInstall };
+
+//# sourceMappingURL=model-manager.js.map

package/dist/src/voice/local/model-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-manager.js","names":[],"sources":["../../../../src/voice/local/model-manager.ts"],"sourcesContent":["import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { createLogger } from '../../utils/logger.js';\nimport {\n  LOCAL_VOICE_MODELS,\n  getLocalVoiceModel,\n  isLocalVoiceModelInstalled,\n  resolveLocalVoiceModelDir,\n  resolveLocalVoiceModelMarkerPath,\n} from './models.js';\nimport { getLocalVoiceRuntimeClient, type LocalVoiceRuntimeProgress } from './runtime-client.js';\n\nconst log = createLogger('LocalVoice:Models');\n\nexport type LocalVoiceModelState = 'not_installed' | 'downloading' | 'ready' | 'error';\n\nexport interface LocalVoiceModelStatus {\n  id: string;\n  name: string;\n  description: string;\n  approximateBytes: number;\n  engine: string;\n  languages: readonly string[];\n  recommended?: boolean;\n  state: LocalVoiceModelState;\n  progress?: number;\n  downloadedBytes?: number;\n  totalBytes?: number;\n  error?: string;\n}\n\nconst jobs = new Map<string, LocalVoiceModelStatus>();\n\nfunction progressFraction(progress: LocalVoiceRuntimeProgress): number | undefined {\n  if (typeof progress.progress === 'number' && Number.isFinite(progress.progress)) {\n    return progress.progress > 1 ? progress.progress / 100 : progress.progress;\n  }\n  if (typeof progress.loaded === 'number' && typeof progress.total === 'number' && progress.total > 0) {\n    return progress.loaded / progress.total;\n  }\n  return undefined;\n}\n\nexport async function listLocalVoiceModelStatuses(): Promise<LocalVoiceModelStatus[]> {\n  return Promise.all(\n    LOCAL_VOICE_MODELS.map(async (model) => {\n      const active = jobs.get(model.id);\n      if (active) return { ...active };\n      if (!isLocalVoiceModelInstalled(model.id)) {\n        return {\n          id: model.id,\n          name: model.name,\n          description: model.description,\n          approximateBytes: model.approximateBytes,\n          engine: model.engine,\n          languages: model.languages,\n          recommended: model.recommended,\n          state: 'not_installed' as const,\n        };\n      }\n      let installedAt: string | undefined;\n      try {\n        const marker = JSON.parse(await readFile(resolveLocalVoiceModelMarkerPath(model.id), 'utf8')) as { installedAt?: string };\n        installedAt = marker.installedAt;\n      } catch {\n        // The marker's presence is authoritative; metadata is best-effort.\n      }\n      return {\n        id: model.id,\n        name: model.name,\n        description: installedAt ? `${model.description} Installed ${installedAt}.` : model.description,\n        approximateBytes: model.approximateBytes,\n        engine: model.engine,\n        languages: model.languages,\n        recommended: model.recommended,\n        state: 'ready' as const,\n      };\n    }),\n  );\n}\n\nexport function startLocalVoiceModelInstall(modelId: string): LocalVoiceModelStatus {\n  const model = getLocalVoiceModel(modelId);\n  const existing = jobs.get(model.id);\n  if (existing?.state === 'downloading') return { ...existing };\n  const status: LocalVoiceModelStatus = {\n    id: model.id,\n    name: model.name,\n    description: model.description,\n    approximateBytes: model.approximateBytes,\n    engine: model.engine,\n    languages: model.languages,\n    recommended: model.recommended,\n    state: 'downloading',\n    progress: 0,\n  };\n  jobs.set(model.id, status);\n  void (async () => {\n    const modelDir = resolveLocalVoiceModelDir(model.id);\n    const stagingDir = `${modelDir}.download`;\n    try {\n      if (model.engine === 'transformers.js') {\n        await rm(stagingDir, { recursive: true, force: true });\n      }\n      await mkdir(stagingDir, { recursive: true });\n      await getLocalVoiceRuntimeClient().request(\n        'model.install',\n        { modelId: model.id, cacheDir: stagingDir },\n        {\n          onProgress: (progress) => {\n            const current = jobs.get(model.id);\n            if (!current) return;\n            current.progress = progressFraction(progress) ?? current.progress;\n            current.downloadedBytes = progress.loaded;\n            current.totalBytes = progress.total;\n          },\n        },\n      );\n      await writeFile(\n        join(stagingDir, 'installed.json'),\n        `${JSON.stringify({\n          modelId: model.id,\n          repository: model.repository,\n          revision: model.revision,\n          engine: model.engine,\n          ...(model.dtype ? { dtype: model.dtype } : {}),\n          installedAt: new Date().toISOString(),\n        }, null, 2)}\\n`,\n        { mode: 0o600 },\n      );\n      await rm(modelDir, { recursive: true, force: true });\n      await rename(stagingDir, modelDir);\n      jobs.delete(model.id);\n      log.info({ modelId: model.id }, 'Local voice model installed');\n    } catch (error) {\n      // Keep verified/partial sherpa model files so a retry can continue with HTTP Range.\n      if (model.engine === 'transformers.js') {\n        await rm(stagingDir, { recursive: true, force: true }).catch(() => {});\n      }\n      const message = error instanceof Error ? error.message : String(error);\n      jobs.set(model.id, { ...status, state: 'error', error: message });\n      log.error({ err: error, modelId: model.id }, `Local voice model installation failed: ${message}`);\n    }\n  })();\n  return { ...status };\n}\n\nexport async function removeLocalVoiceModel(modelId: string): Promise<void> {\n  const model = getLocalVoiceModel(modelId);\n  if (jobs.get(model.id)?.state === 'downloading') {\n    throw new Error('Cannot remove a model while it is downloading');\n  }\n  try {\n    await getLocalVoiceRuntimeClient().request('model.unload', { modelId: model.id }, { timeoutMs: 10_000 });\n  } catch (error) {\n    log.warn({ err: error, modelId: model.id }, 'Local voice runtime unload failed; removing model files');\n  }\n  await rm(resolveLocalVoiceModelDir(model.id), { recursive: true, force: true });\n  jobs.delete(model.id);\n  log.info({ modelId: model.id }, 'Local voice model removed');\n}\n"],"mappings":"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"}

package/dist/src/voice/local/models.d.ts

@@ -0,0 +1,28 @@
+export type LocalVoiceModelId = 'sensevoice-small' | 'tiny' | 'base' | 'small';
+export type LocalVoiceEngine = 'sherpa-onnx' | 'transformers.js';
+export interface LocalVoiceModelFile {
+    path: string;
+    bytes: number;
+    sha256: string;
+}
+export interface LocalVoiceModelDefinition {
+    id: LocalVoiceModelId;
+    name: string;
+    description: string;
+    engine: LocalVoiceEngine;
+    repository: string;
+    revision: string;
+    dtype?: 'q8';
+    files?: readonly LocalVoiceModelFile[];
+    languages: readonly string[];
+    recommended?: boolean;
+    approximateBytes: number;
+}
+export declare const DEFAULT_LOCAL_VOICE_MODEL_ID: LocalVoiceModelId;
+export declare const LOCAL_VOICE_MODELS: readonly LocalVoiceModelDefinition[];
+export declare function resolveLocalVoiceRootDir(): string;
+export declare function resolveLocalVoiceModelDir(modelId: string): string;
+export declare function resolveLocalVoiceModelMarkerPath(modelId: string): string;
+export declare function getLocalVoiceModel(modelId: string | undefined): LocalVoiceModelDefinition;
+export declare function isLocalVoiceModelInstalled(modelId: string): boolean;
+export declare function hasInstalledLocalVoiceModel(): boolean;

package/dist/src/voice/local/models.js

@@ -0,0 +1,101 @@
+import { resolveStateDir } from "../../config/paths-state.js";
+import { init_paths } from "../../config/paths.js";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+//#region src/voice/local/models.ts
+init_paths();
+const DEFAULT_LOCAL_VOICE_MODEL_ID = "sensevoice-small";
+const LOCAL_VOICE_MODELS = [
+	{
+		id: "sensevoice-small",
+		name: "SenseVoice Small 中文",
+		description: "中文推荐；适合普通话、粤语和中英混说，支持标点与数字规整。",
+		engine: "sherpa-onnx",
+		repository: "csukuangfj/sherpa-onnx-sense-voice-zh-en-ja-ko-yue-2024-07-17",
+		revision: "2365baeacb507f821a0c8120fcee3d484dba7a07",
+		files: [
+			{
+				path: "model.int8.onnx",
+				bytes: 239233841,
+				sha256: "c71f0ce00bec95b07744e116345e33d8cbbe08cef896382cf907bf4b51a2cd51"
+			},
+			{
+				path: "tokens.txt",
+				bytes: 315894,
+				sha256: "f449eb28dc567533d7fa59be34e2abca8784f771850c78a47fb731a31429a1dc"
+			},
+			{
+				path: "LICENSE",
+				bytes: 71,
+				sha256: "221c6df10b0931a5629adad671ea48fb7747e034c414b6d2bfa275bc3dd4ea17"
+			}
+		],
+		languages: [
+			"zh",
+			"yue",
+			"en",
+			"ja",
+			"ko"
+		],
+		recommended: true,
+		approximateBytes: 239549806
+	},
+	{
+		id: "tiny",
+		name: "Whisper Tiny",
+		description: "Fastest and smallest; best for short commands.",
+		engine: "transformers.js",
+		repository: "onnx-community/whisper-tiny",
+		revision: "ff4177021cc41f7db950912b73ea4fdf7d01d8e7",
+		dtype: "q8",
+		languages: ["multilingual"],
+		approximateBytes: 45 * 1024 * 1024
+	},
+	{
+		id: "base",
+		name: "Whisper Base",
+		description: "Recommended balance of accuracy, speed, and disk use.",
+		engine: "transformers.js",
+		repository: "onnx-community/whisper-base",
+		revision: "1846881b6b3a3024392c1eea3ad983695bc23925",
+		dtype: "q8",
+		languages: ["multilingual"],
+		approximateBytes: 80 * 1024 * 1024
+	},
+	{
+		id: "small",
+		name: "Whisper Small",
+		description: "Higher accuracy with more memory and disk use.",
+		engine: "transformers.js",
+		repository: "onnx-community/whisper-small",
+		revision: "36050c46d777d46dc4b5f43f6d90574fc38f8732",
+		dtype: "q8",
+		languages: ["multilingual"],
+		approximateBytes: 245 * 1024 * 1024
+	}
+];
+function resolveLocalVoiceRootDir() {
+	return process.env.XOPC_VOICE_MODEL_DIR?.trim() || join(resolveStateDir(), "voice");
+}
+function resolveLocalVoiceModelDir(modelId) {
+	return join(resolveLocalVoiceRootDir(), "models", modelId);
+}
+function resolveLocalVoiceModelMarkerPath(modelId) {
+	return join(resolveLocalVoiceModelDir(modelId), "installed.json");
+}
+function getLocalVoiceModel(modelId) {
+	const id = modelId?.trim() || "sensevoice-small";
+	const model = LOCAL_VOICE_MODELS.find((entry) => entry.id === id);
+	if (!model) throw new Error(`Unknown local voice model: ${id}`);
+	return model;
+}
+function isLocalVoiceModelInstalled(modelId) {
+	return existsSync(resolveLocalVoiceModelMarkerPath(modelId));
+}
+function hasInstalledLocalVoiceModel() {
+	return LOCAL_VOICE_MODELS.some((model) => isLocalVoiceModelInstalled(model.id));
+}
+//#endregion
+export { DEFAULT_LOCAL_VOICE_MODEL_ID, LOCAL_VOICE_MODELS, getLocalVoiceModel, hasInstalledLocalVoiceModel, isLocalVoiceModelInstalled, resolveLocalVoiceModelDir, resolveLocalVoiceModelMarkerPath, resolveLocalVoiceRootDir };
+
+//# sourceMappingURL=models.js.map

package/dist/src/voice/local/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","names":[],"sources":["../../../../src/voice/local/models.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { resolveStateDir } from '../../config/paths.js';\n\nexport type LocalVoiceModelId = 'sensevoice-small' | 'tiny' | 'base' | 'small';\n\nexport type LocalVoiceEngine = 'sherpa-onnx' | 'transformers.js';\n\nexport interface LocalVoiceModelFile {\n  path: string;\n  bytes: number;\n  sha256: string;\n}\n\nexport interface LocalVoiceModelDefinition {\n  id: LocalVoiceModelId;\n  name: string;\n  description: string;\n  engine: LocalVoiceEngine;\n  repository: string;\n  revision: string;\n  dtype?: 'q8';\n  files?: readonly LocalVoiceModelFile[];\n  languages: readonly string[];\n  recommended?: boolean;\n  approximateBytes: number;\n}\n\nexport const DEFAULT_LOCAL_VOICE_MODEL_ID: LocalVoiceModelId = 'sensevoice-small';\n\nexport const LOCAL_VOICE_MODELS: readonly LocalVoiceModelDefinition[] = [\n  {\n    id: 'sensevoice-small',\n    name: 'SenseVoice Small 中文',\n    description: '中文推荐；适合普通话、粤语和中英混说，支持标点与数字规整。',\n    engine: 'sherpa-onnx',\n    repository: 'csukuangfj/sherpa-onnx-sense-voice-zh-en-ja-ko-yue-2024-07-17',\n    revision: '2365baeacb507f821a0c8120fcee3d484dba7a07',\n    files: [\n      {\n        path: 'model.int8.onnx',\n        bytes: 239_233_841,\n        sha256: 'c71f0ce00bec95b07744e116345e33d8cbbe08cef896382cf907bf4b51a2cd51',\n      },\n      {\n        path: 'tokens.txt',\n        bytes: 315_894,\n        sha256: 'f449eb28dc567533d7fa59be34e2abca8784f771850c78a47fb731a31429a1dc',\n      },\n      {\n        path: 'LICENSE',\n        bytes: 71,\n        sha256: '221c6df10b0931a5629adad671ea48fb7747e034c414b6d2bfa275bc3dd4ea17',\n      },\n    ],\n    languages: ['zh', 'yue', 'en', 'ja', 'ko'],\n    recommended: true,\n    approximateBytes: 239_549_806,\n  },\n  {\n    id: 'tiny',\n    name: 'Whisper Tiny',\n    description: 'Fastest and smallest; best for short commands.',\n    engine: 'transformers.js',\n    repository: 'onnx-community/whisper-tiny',\n    revision: 'ff4177021cc41f7db950912b73ea4fdf7d01d8e7',\n    dtype: 'q8',\n    languages: ['multilingual'],\n    approximateBytes: 45 * 1024 * 1024,\n  },\n  {\n    id: 'base',\n    name: 'Whisper Base',\n    description: 'Recommended balance of accuracy, speed, and disk use.',\n    engine: 'transformers.js',\n    repository: 'onnx-community/whisper-base',\n    revision: '1846881b6b3a3024392c1eea3ad983695bc23925',\n    dtype: 'q8',\n    languages: ['multilingual'],\n    approximateBytes: 80 * 1024 * 1024,\n  },\n  {\n    id: 'small',\n    name: 'Whisper Small',\n    description: 'Higher accuracy with more memory and disk use.',\n    engine: 'transformers.js',\n    repository: 'onnx-community/whisper-small',\n    revision: '36050c46d777d46dc4b5f43f6d90574fc38f8732',\n    dtype: 'q8',\n    languages: ['multilingual'],\n    approximateBytes: 245 * 1024 * 1024,\n  },\n] as const;\n\nexport function resolveLocalVoiceRootDir(): string {\n  return process.env.XOPC_VOICE_MODEL_DIR?.trim() || join(resolveStateDir(), 'voice');\n}\n\nexport function resolveLocalVoiceModelDir(modelId: string): string {\n  return join(resolveLocalVoiceRootDir(), 'models', modelId);\n}\n\nexport function resolveLocalVoiceModelMarkerPath(modelId: string): string {\n  return join(resolveLocalVoiceModelDir(modelId), 'installed.json');\n}\n\nexport function getLocalVoiceModel(modelId: string | undefined): LocalVoiceModelDefinition {\n  const id = modelId?.trim() || DEFAULT_LOCAL_VOICE_MODEL_ID;\n  const model = LOCAL_VOICE_MODELS.find((entry) => entry.id === id);\n  if (!model) {\n    throw new Error(`Unknown local voice model: ${id}`);\n  }\n  return model;\n}\n\nexport function isLocalVoiceModelInstalled(modelId: string): boolean {\n  return existsSync(resolveLocalVoiceModelMarkerPath(modelId));\n}\n\nexport function hasInstalledLocalVoiceModel(): boolean {\n  return LOCAL_VOICE_MODELS.some((model) => isLocalVoiceModelInstalled(model.id));\n}\n"],"mappings":";;;;;YAGwD;AA0BxD,MAAa,+BAAkD;AAE/D,MAAa,qBAA2D;CACtE;EACE,IAAI;EACJ,MAAM;EACN,aAAa;EACb,QAAQ;EACR,YAAY;EACZ,UAAU;EACV,OAAO;GACL;IACE,MAAM;IACN,OAAO;IACP,QAAQ;IACT;GACD;IACE,MAAM;IACN,OAAO;IACP,QAAQ;IACT;GACD;IACE,MAAM;IACN,OAAO;IACP,QAAQ;IACT;GACF;EACD,WAAW;GAAC;GAAM;GAAO;GAAM;GAAM;GAAK;EAC1C,aAAa;EACb,kBAAkB;EACnB;CACD;EACE,IAAI;EACJ,MAAM;EACN,aAAa;EACb,QAAQ;EACR,YAAY;EACZ,UAAU;EACV,OAAO;EACP,WAAW,CAAC,eAAe;EAC3B,kBAAkB,KAAK,OAAO;EAC/B;CACD;EACE,IAAI;EACJ,MAAM;EACN,aAAa;EACb,QAAQ;EACR,YAAY;EACZ,UAAU;EACV,OAAO;EACP,WAAW,CAAC,eAAe;EAC3B,kBAAkB,KAAK,OAAO;EAC/B;CACD;EACE,IAAI;EACJ,MAAM;EACN,aAAa;EACb,QAAQ;EACR,YAAY;EACZ,UAAU;EACV,OAAO;EACP,WAAW,CAAC,eAAe;EAC3B,kBAAkB,MAAM,OAAO;EAChC;CACF;AAED,SAAgB,2BAAmC;AACjD,QAAO,QAAQ,IAAI,sBAAsB,MAAM,IAAI,KAAK,iBAAiB,EAAE,QAAQ;;AAGrF,SAAgB,0BAA0B,SAAyB;AACjE,QAAO,KAAK,0BAA0B,EAAE,UAAU,QAAQ;;AAG5D,SAAgB,iCAAiC,SAAyB;AACxE,QAAO,KAAK,0BAA0B,QAAQ,EAAE,iBAAiB;;AAGnE,SAAgB,mBAAmB,SAAwD;CACzF,MAAM,KAAK,SAAS,MAAM,IAAA;CAC1B,MAAM,QAAQ,mBAAmB,MAAM,UAAU,MAAM,OAAO,GAAG;AACjE,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,8BAA8B,KAAK;AAErD,QAAO;;AAGT,SAAgB,2BAA2B,SAA0B;AACnE,QAAO,WAAW,iCAAiC,QAAQ,CAAC;;AAG9D,SAAgB,8BAAuC;AACrD,QAAO,mBAAmB,MAAM,UAAU,2BAA2B,MAAM,GAAG,CAAC"}

package/dist/src/voice/local/runtime-client.d.ts

@@ -0,0 +1,26 @@
+export interface LocalVoiceRuntimeProgress {
+    status?: string;
+    file?: string;
+    progress?: number;
+    loaded?: number;
+    total?: number;
+}
+export declare class LocalVoiceRuntimeClient {
+    private child;
+    private nextId;
+    private pending;
+    request<T>(method: string, params?: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+        /** Health/status probes must never terminate an active model download on timeout. */
+        stopOnTimeout?: boolean;
+        onProgress?: (progress: LocalVoiceRuntimeProgress) => void;
+    }): Promise<T>;
+    stop(): void;
+    private ensureStarted;
+    private handleLine;
+    private rejectAll;
+    private deletePending;
+}
+export declare function getLocalVoiceRuntimeClient(): LocalVoiceRuntimeClient;
+export declare function resetLocalVoiceRuntimeForTests(): void;