@xopcai/xopc 0.0.144 → 0.0.145

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

@@ -0,0 +1,166 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { resolveLocalVoiceRootDir } from "./models.js";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+//#region src/voice/local/runtime-client.ts
+init_logger();
+const log = createLogger("LocalVoice:Runtime");
+const DEFAULT_REQUEST_TIMEOUT_MS = 10 * 6e4;
+function resolveWorkerCommand() {
+	const configured = process.env.XOPC_VOICE_RUNTIME_ENTRY?.trim();
+	if (configured) return {
+		entry: configured,
+		args: [configured]
+	};
+	const jsEntry = fileURLToPath(new URL("./runtime-worker.js", import.meta.url));
+	if (existsSync(jsEntry)) return {
+		entry: jsEntry,
+		args: [jsEntry]
+	};
+	const tsEntry = fileURLToPath(new URL("./runtime-worker.ts", import.meta.url));
+	if (existsSync(tsEntry)) return {
+		entry: tsEntry,
+		args: [
+			"--import",
+			"tsx",
+			tsEntry
+		]
+	};
+	throw new Error("Bundled local voice runtime entry is missing");
+}
+var LocalVoiceRuntimeClient = class {
+	child = null;
+	nextId = 1;
+	pending = /* @__PURE__ */ new Map();
+	async request(method, params = {}, options = {}) {
+		options.signal?.throwIfAborted();
+		const child = this.ensureStarted();
+		const id = this.nextId++;
+		return new Promise((resolve, reject) => {
+			const timeout = setTimeout(() => {
+				this.deletePending(id);
+				reject(/* @__PURE__ */ new Error(`Local voice runtime request timed out: ${method}`));
+				if (options.stopOnTimeout !== false) this.stop();
+			}, options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS);
+			this.pending.set(id, {
+				resolve: (value) => resolve(value),
+				reject,
+				timeout,
+				signal: options.signal,
+				onProgress: options.onProgress
+			});
+			const abort = () => {
+				const pending = this.pending.get(id);
+				if (!pending) return;
+				this.deletePending(id);
+				pending.reject(/* @__PURE__ */ new Error("Local voice transcription aborted"));
+				this.stop();
+			};
+			const pending = this.pending.get(id);
+			if (pending) pending.abort = abort;
+			options.signal?.addEventListener("abort", abort, { once: true });
+			child.stdin.write(`${JSON.stringify({
+				id,
+				method,
+				params
+			})}\n`, (error) => {
+				if (!error) return;
+				this.deletePending(id);
+				reject(error);
+			});
+		});
+	}
+	stop() {
+		const child = this.child;
+		this.child = null;
+		if (child && !child.killed) child.kill("SIGTERM");
+		this.rejectAll(/* @__PURE__ */ new Error("Local voice runtime stopped"));
+	}
+	ensureStarted() {
+		if (this.child && !this.child.killed) return this.child;
+		const command = resolveWorkerCommand();
+		const child = spawn(process.execPath, command.args, {
+			env: {
+				...process.env,
+				ELECTRON_RUN_AS_NODE: "1",
+				XOPC_VOICE_MODEL_DIR: resolveLocalVoiceRootDir()
+			},
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			],
+			windowsHide: true
+		});
+		this.child = child;
+		createInterface({ input: child.stdout }).on("line", (line) => this.handleLine(line));
+		child.stderr.on("data", (chunk) => {
+			const message = chunk.toString().trim();
+			if (message) log.debug({ message }, "Local voice runtime stderr");
+		});
+		child.once("error", (error) => {
+			if (this.child === child) this.child = null;
+			this.rejectAll(error);
+		});
+		child.once("exit", (code, signal) => {
+			if (this.child === child) this.child = null;
+			if (this.pending.size > 0) this.rejectAll(/* @__PURE__ */ new Error(`Local voice runtime exited (${code ?? signal ?? "unknown"})`));
+		});
+		return child;
+	}
+	handleLine(line) {
+		let message;
+		try {
+			message = JSON.parse(line);
+		} catch {
+			log.warn({ linePreview: line.slice(0, 200) }, "Ignored invalid local voice runtime output");
+			return;
+		}
+		if (typeof message.id !== "number") return;
+		const pending = this.pending.get(message.id);
+		if (!pending) return;
+		if (message.event === "progress") {
+			pending.onProgress?.(message.data ?? {});
+			return;
+		}
+		this.deletePending(message.id);
+		if (message.error) {
+			const detail = typeof message.error === "string" ? { message: message.error } : message.error;
+			const suffix = [detail.code, detail.cause].filter(Boolean).join(": ");
+			const error = /* @__PURE__ */ new Error(`${detail.message || "Local voice runtime failed"}${suffix ? ` (${suffix})` : ""}`);
+			if (detail.code) Object.assign(error, { code: detail.code });
+			pending.reject(error);
+		} else pending.resolve(message.result);
+	}
+	rejectAll(error) {
+		for (const pending of this.pending.values()) {
+			clearTimeout(pending.timeout);
+			if (pending.signal && pending.abort) pending.signal.removeEventListener("abort", pending.abort);
+			pending.reject(error);
+		}
+		this.pending.clear();
+	}
+	deletePending(id) {
+		const pending = this.pending.get(id);
+		if (!pending) return;
+		clearTimeout(pending.timeout);
+		if (pending.signal && pending.abort) pending.signal.removeEventListener("abort", pending.abort);
+		this.pending.delete(id);
+	}
+};
+let sharedRuntime;
+function getLocalVoiceRuntimeClient() {
+	sharedRuntime ??= new LocalVoiceRuntimeClient();
+	return sharedRuntime;
+}
+function resetLocalVoiceRuntimeForTests() {
+	sharedRuntime?.stop();
+	sharedRuntime = void 0;
+}
+//#endregion
+export { LocalVoiceRuntimeClient, getLocalVoiceRuntimeClient, resetLocalVoiceRuntimeForTests };
+
+//# sourceMappingURL=runtime-client.js.map

package/dist/src/voice/local/runtime-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-client.js","names":[],"sources":["../../../../src/voice/local/runtime-client.ts"],"sourcesContent":["import { spawn, type ChildProcessWithoutNullStreams } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport { createInterface } from 'node:readline';\nimport { fileURLToPath } from 'node:url';\n\nimport { createLogger } from '../../utils/logger.js';\nimport { resolveLocalVoiceRootDir } from './models.js';\n\nconst log = createLogger('LocalVoice:Runtime');\nconst DEFAULT_REQUEST_TIMEOUT_MS = 10 * 60_000;\n\ntype PendingRequest = {\n  resolve: (value: unknown) => void;\n  reject: (error: Error) => void;\n  timeout: ReturnType<typeof setTimeout>;\n  signal?: AbortSignal;\n  abort?: () => void;\n  onProgress?: (progress: LocalVoiceRuntimeProgress) => void;\n};\n\nexport interface LocalVoiceRuntimeProgress {\n  status?: string;\n  file?: string;\n  progress?: number;\n  loaded?: number;\n  total?: number;\n}\n\nfunction resolveWorkerCommand(): { entry: string; args: string[] } {\n  const configured = process.env.XOPC_VOICE_RUNTIME_ENTRY?.trim();\n  if (configured) return { entry: configured, args: [configured] };\n\n  const jsEntry = fileURLToPath(new URL('./runtime-worker.js', import.meta.url));\n  if (existsSync(jsEntry)) return { entry: jsEntry, args: [jsEntry] };\n\n  const tsEntry = fileURLToPath(new URL('./runtime-worker.ts', import.meta.url));\n  if (existsSync(tsEntry)) return { entry: tsEntry, args: ['--import', 'tsx', tsEntry] };\n  throw new Error('Bundled local voice runtime entry is missing');\n}\n\nexport class LocalVoiceRuntimeClient {\n  private child: ChildProcessWithoutNullStreams | null = null;\n  private nextId = 1;\n  private pending = new Map<number, PendingRequest>();\n\n  async request<T>(\n    method: string,\n    params: Record<string, unknown> = {},\n    options: {\n      signal?: AbortSignal;\n      timeoutMs?: number;\n      /** Health/status probes must never terminate an active model download on timeout. */\n      stopOnTimeout?: boolean;\n      onProgress?: (progress: LocalVoiceRuntimeProgress) => void;\n    } = {},\n  ): Promise<T> {\n    options.signal?.throwIfAborted();\n    const child = this.ensureStarted();\n    const id = this.nextId++;\n    return new Promise<T>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        this.deletePending(id);\n        reject(new Error(`Local voice runtime request timed out: ${method}`));\n        if (options.stopOnTimeout !== false) this.stop();\n      }, options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS);\n      this.pending.set(id, {\n        resolve: (value) => resolve(value as T),\n        reject,\n        timeout,\n        signal: options.signal,\n        onProgress: options.onProgress,\n      });\n      const abort = () => {\n        const pending = this.pending.get(id);\n        if (!pending) return;\n        this.deletePending(id);\n        pending.reject(new Error('Local voice transcription aborted'));\n        this.stop();\n      };\n      const pending = this.pending.get(id);\n      if (pending) pending.abort = abort;\n      options.signal?.addEventListener('abort', abort, { once: true });\n      child.stdin.write(`${JSON.stringify({ id, method, params })}\\n`, (error) => {\n        if (!error) return;\n        this.deletePending(id);\n        reject(error);\n      });\n    });\n  }\n\n  stop(): void {\n    const child = this.child;\n    this.child = null;\n    if (child && !child.killed) child.kill('SIGTERM');\n    this.rejectAll(new Error('Local voice runtime stopped'));\n  }\n\n  private ensureStarted(): ChildProcessWithoutNullStreams {\n    if (this.child && !this.child.killed) return this.child;\n    const command = resolveWorkerCommand();\n    const child = spawn(process.execPath, command.args, {\n      env: {\n        ...process.env,\n        ELECTRON_RUN_AS_NODE: '1',\n        XOPC_VOICE_MODEL_DIR: resolveLocalVoiceRootDir(),\n      },\n      stdio: ['pipe', 'pipe', 'pipe'],\n      windowsHide: true,\n    });\n    this.child = child;\n    createInterface({ input: child.stdout }).on('line', (line) => this.handleLine(line));\n    child.stderr.on('data', (chunk: Buffer) => {\n      const message = chunk.toString().trim();\n      if (message) log.debug({ message }, 'Local voice runtime stderr');\n    });\n    child.once('error', (error) => {\n      if (this.child === child) this.child = null;\n      this.rejectAll(error);\n    });\n    child.once('exit', (code, signal) => {\n      if (this.child === child) this.child = null;\n      if (this.pending.size > 0) {\n        this.rejectAll(new Error(`Local voice runtime exited (${code ?? signal ?? 'unknown'})`));\n      }\n    });\n    return child;\n  }\n\n  private handleLine(line: string): void {\n    let message: {\n      id?: number;\n      result?: unknown;\n      error?: string | { message?: string; code?: string; cause?: string };\n      event?: string;\n      data?: unknown;\n    };\n    try {\n      message = JSON.parse(line) as typeof message;\n    } catch {\n      log.warn({ linePreview: line.slice(0, 200) }, 'Ignored invalid local voice runtime output');\n      return;\n    }\n    if (typeof message.id !== 'number') return;\n    const pending = this.pending.get(message.id);\n    if (!pending) return;\n    if (message.event === 'progress') {\n      pending.onProgress?.((message.data ?? {}) as LocalVoiceRuntimeProgress);\n      return;\n    }\n    this.deletePending(message.id);\n    if (message.error) {\n      const detail = typeof message.error === 'string' ? { message: message.error } : message.error;\n      const suffix = [detail.code, detail.cause].filter(Boolean).join(': ');\n      const error = new Error(`${detail.message || 'Local voice runtime failed'}${suffix ? ` (${suffix})` : ''}`);\n      if (detail.code) Object.assign(error, { code: detail.code });\n      pending.reject(error);\n    } else pending.resolve(message.result);\n  }\n\n  private rejectAll(error: Error): void {\n    for (const pending of this.pending.values()) {\n      clearTimeout(pending.timeout);\n      if (pending.signal && pending.abort) {\n        pending.signal.removeEventListener('abort', pending.abort);\n      }\n      pending.reject(error);\n    }\n    this.pending.clear();\n  }\n\n  private deletePending(id: number): void {\n    const pending = this.pending.get(id);\n    if (!pending) return;\n    clearTimeout(pending.timeout);\n    if (pending.signal && pending.abort) {\n      pending.signal.removeEventListener('abort', pending.abort);\n    }\n    this.pending.delete(id);\n  }\n}\n\nlet sharedRuntime: LocalVoiceRuntimeClient | undefined;\n\nexport function getLocalVoiceRuntimeClient(): LocalVoiceRuntimeClient {\n  sharedRuntime ??= new LocalVoiceRuntimeClient();\n  return sharedRuntime;\n}\n\nexport function resetLocalVoiceRuntimeForTests(): void {\n  sharedRuntime?.stop();\n  sharedRuntime = undefined;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+export interface RuntimeDispatchRequest {
+    id: number;
+    method: string;
+}
+export declare function createRuntimeDispatcher<T extends RuntimeDispatchRequest>(options: {
+    execute: (request: T) => Promise<unknown>;
+    sendResult: (request: T, result: unknown) => void;
+    sendError: (request: T, error: unknown) => void;
+}): (request: T) => void;

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

@@ -0,0 +1,22 @@
+//#region src/voice/local/runtime-dispatcher.ts
+function createRuntimeDispatcher(options) {
+	let queue = Promise.resolve();
+	const run = async (request) => {
+		try {
+			options.sendResult(request, await options.execute(request));
+		} catch (error) {
+			options.sendError(request, error);
+		}
+	};
+	return (request) => {
+		if (request.method === "health") {
+			run(request);
+			return;
+		}
+		queue = queue.then(() => run(request));
+	};
+}
+//#endregion
+export { createRuntimeDispatcher };
+
+//# sourceMappingURL=runtime-dispatcher.js.map

package/dist/src/voice/local/runtime-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-dispatcher.js","names":[],"sources":["../../../../src/voice/local/runtime-dispatcher.ts"],"sourcesContent":["export interface RuntimeDispatchRequest {\n  id: number;\n  method: string;\n}\n\nexport function createRuntimeDispatcher<T extends RuntimeDispatchRequest>(options: {\n  execute: (request: T) => Promise<unknown>;\n  sendResult: (request: T, result: unknown) => void;\n  sendError: (request: T, error: unknown) => void;\n}): (request: T) => void {\n  let queue = Promise.resolve();\n  const run = async (request: T) => {\n    try {\n      options.sendResult(request, await options.execute(request));\n    } catch (error) {\n      options.sendError(request, error);\n    }\n  };\n\n  return (request) => {\n    if (request.method === 'health') {\n      void run(request);\n      return;\n    }\n    queue = queue.then(() => run(request));\n  };\n}\n"],"mappings":";AAKA,SAAgB,wBAA0D,SAIjD;CACvB,IAAI,QAAQ,QAAQ,SAAS;CAC7B,MAAM,MAAM,OAAO,YAAe;AAChC,MAAI;AACF,WAAQ,WAAW,SAAS,MAAM,QAAQ,QAAQ,QAAQ,CAAC;WACpD,OAAO;AACd,WAAQ,UAAU,SAAS,MAAM;;;AAIrC,SAAQ,YAAY;AAClB,MAAI,QAAQ,WAAW,UAAU;AAC1B,OAAI,QAAQ;AACjB;;AAEF,UAAQ,MAAM,WAAW,IAAI,QAAQ,CAAC"}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,249 @@
+import { getLocalVoiceModel, resolveLocalVoiceModelDir } from "./models.js";
+import { downloadLocalVoiceModelFiles } from "./model-files.js";
+import { createRuntimeDispatcher } from "./runtime-dispatcher.js";
+import { join, resolve, sep } from "node:path";
+import { mkdir, rm } from "node:fs/promises";
+import { EnvHttpProxyAgent, RetryAgent, setGlobalDispatcher } from "undici";
+import { createInterface } from "node:readline";
+//#region src/voice/local/runtime-worker.ts
+const pipelines = /* @__PURE__ */ new Map();
+const sherpaRecognizers = /* @__PURE__ */ new Map();
+const networkAgent = new RetryAgent(new EnvHttpProxyAgent(), {
+	maxRetries: 4,
+	minTimeout: 500,
+	maxTimeout: 8e3,
+	timeoutFactor: 2,
+	retryAfter: true
+});
+setGlobalDispatcher(networkAgent);
+function normalizeRemoteHost(value) {
+	const url = new URL(value);
+	if (url.username || url.password) throw new Error("Local voice model endpoint must not contain credentials");
+	if (url.protocol !== "https:" && url.hostname !== "127.0.0.1" && url.hostname !== "localhost") throw new Error("Local voice model endpoint must use HTTPS");
+	url.pathname = `${url.pathname.replace(/\/+$/, "")}/`;
+	return url.toString();
+}
+function resolveRemoteHosts() {
+	const configured = process.env.XOPC_VOICE_MODEL_ENDPOINT?.trim() || process.env.HF_ENDPOINT?.trim();
+	if (configured) return [normalizeRemoteHost(configured)];
+	return [normalizeRemoteHost("https://xopc.ai/api/voice/models"), normalizeRemoteHost("https://huggingface.co")];
+}
+function serializeError(error) {
+	if (!(error instanceof Error)) return { message: String(error) };
+	const withCode = error;
+	const nested = withCode.cause;
+	const nestedMessage = nested instanceof Error ? nested.message : void 0;
+	const nestedCode = nested && typeof nested === "object" && "code" in nested ? String(nested.code ?? "") : void 0;
+	return {
+		message: error.message,
+		...typeof withCode.code === "string" ? { code: withCode.code } : {},
+		...nestedCode ? { code: nestedCode } : {},
+		...nestedMessage && nestedMessage !== error.message ? { cause: nestedMessage } : {}
+	};
+}
+function send(message) {
+	process.stdout.write(`${JSON.stringify(message)}\n`);
+}
+async function loadPipeline(modelId, allowRemote, cacheDir = resolveLocalVoiceModelDir(modelId), onProgress) {
+	const key = `${modelId}:${cacheDir}`;
+	const existing = pipelines.get(key);
+	if (existing) return existing;
+	const model = getLocalVoiceModel(modelId);
+	if (model.engine !== "transformers.js") throw new Error(`Model ${model.id} does not use the Transformers.js engine`);
+	const promise = (async () => {
+		const transformers = await import("@huggingface/transformers");
+		transformers.env.cacheDir = cacheDir;
+		transformers.env.allowRemoteModels = allowRemote;
+		transformers.env.allowLocalModels = true;
+		const remoteHosts = allowRemote ? resolveRemoteHosts() : [normalizeRemoteHost("https://xopc.ai")];
+		let lastError;
+		for (const [index, remoteHost] of remoteHosts.entries()) {
+			transformers.env.remoteHost = remoteHost;
+			try {
+				return await transformers.pipeline("automatic-speech-recognition", model.repository, {
+					revision: model.revision,
+					dtype: model.dtype,
+					progress_callback: onProgress
+				});
+			} catch (error) {
+				lastError = error;
+				if (index + 1 < remoteHosts.length) {
+					await rm(cacheDir, {
+						recursive: true,
+						force: true
+					});
+					await mkdir(cacheDir, { recursive: true });
+				}
+			}
+		}
+		throw lastError;
+	})();
+	pipelines.set(key, promise);
+	try {
+		return await promise;
+	} catch (error) {
+		pipelines.delete(key);
+		throw error;
+	}
+}
+function normalizeSenseVoiceLanguage(language) {
+	if (typeof language !== "string") return "auto";
+	const value = language.trim().toLowerCase().replace("_", "-");
+	if (!value || value === "auto") return "auto";
+	if (value === "cmn" || value.startsWith("zh")) return "zh";
+	if (value === "cantonese" || value.startsWith("yue")) return "yue";
+	if (value.startsWith("en")) return "en";
+	if (value.startsWith("ja")) return "ja";
+	if (value.startsWith("ko")) return "ko";
+	return "auto";
+}
+function cleanSenseVoiceTag(value) {
+	return value?.replace(/^<\|/, "").replace(/\|>$/, "").trim() || void 0;
+}
+async function loadSherpaRecognizer(modelId, language) {
+	const key = `${modelId}:${language}`;
+	const existing = sherpaRecognizers.get(key);
+	if (existing) return existing;
+	const model = getLocalVoiceModel(modelId);
+	if (model.engine !== "sherpa-onnx") throw new Error(`Model ${model.id} does not use the sherpa-onnx engine`);
+	const modelDir = resolveLocalVoiceModelDir(model.id);
+	const promise = (async () => {
+		const imported = await import("sherpa-onnx-node");
+		return new (imported.default ?? imported).OfflineRecognizer({
+			featConfig: {
+				sampleRate: 16e3,
+				featureDim: 80
+			},
+			modelConfig: {
+				senseVoice: {
+					model: join(modelDir, "model.int8.onnx"),
+					language,
+					useInverseTextNormalization: 1
+				},
+				tokens: join(modelDir, "tokens.txt"),
+				numThreads: Math.max(1, Math.min(4, Number(process.env.XOPC_VOICE_THREADS) || 2)),
+				provider: "cpu",
+				debug: 0
+			}
+		});
+	})();
+	sherpaRecognizers.set(key, promise);
+	try {
+		return await promise;
+	} catch (error) {
+		sherpaRecognizers.delete(key);
+		throw error;
+	}
+}
+async function transcribeWithSherpa(modelId, audio, language) {
+	const recognizer = await loadSherpaRecognizer(modelId, normalizeSenseVoiceLanguage(language));
+	const stream = recognizer.createStream();
+	stream.acceptWaveform({
+		sampleRate: 16e3,
+		samples: audio
+	});
+	const result = recognizer.decodeAsync ? await recognizer.decodeAsync(stream) : (recognizer.decode(stream), recognizer.getResult(stream));
+	return {
+		text: String(result.text ?? "").trim(),
+		...cleanSenseVoiceTag(result.lang) ? { language: cleanSenseVoiceTag(result.lang) } : {},
+		...cleanSenseVoiceTag(result.emotion) ? { emotion: cleanSenseVoiceTag(result.emotion) } : {},
+		...cleanSenseVoiceTag(result.event) ? { event: cleanSenseVoiceTag(result.event) } : {}
+	};
+}
+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 === "model.install") {
+		const modelId = String(params.modelId ?? "");
+		const modelDir = resolve(resolveLocalVoiceModelDir(modelId));
+		const requestedCacheDir = typeof params.cacheDir === "string" ? resolve(params.cacheDir) : modelDir;
+		const allowedPrefix = `${resolve(modelDir, "..")}${sep}`;
+		if (requestedCacheDir !== modelDir && !requestedCacheDir.startsWith(allowedPrefix)) throw new Error("Local voice model cache directory is outside the managed root");
+		const model = getLocalVoiceModel(modelId);
+		if (model.engine === "sherpa-onnx") await downloadLocalVoiceModelFiles({
+			model,
+			destinationDir: requestedCacheDir,
+			remoteHosts: resolveRemoteHosts(),
+			onProgress: (data) => send({
+				id: request.id,
+				event: "progress",
+				data
+			})
+		});
+		else {
+			await loadPipeline(modelId, true, requestedCacheDir, (data) => send({
+				id: request.id,
+				event: "progress",
+				data
+			}));
+			pipelines.delete(`${modelId}:${requestedCacheDir}`);
+		}
+		return {
+			installed: true,
+			modelId
+		};
+	}
+	if (request.method === "model.unload") {
+		const modelId = String(params.modelId ?? "");
+		for (const key of pipelines.keys()) if (key.startsWith(`${modelId}:`)) pipelines.delete(key);
+		for (const key of sherpaRecognizers.keys()) if (key.startsWith(`${modelId}:`)) sherpaRecognizers.delete(key);
+		return { unloaded: true };
+	}
+	if (request.method === "transcribe") {
+		const modelId = String(params.modelId ?? "");
+		const bytes = Buffer.from(String(params.audioBase64 ?? ""), "base64");
+		const copied = Uint8Array.from(bytes);
+		const audio = new Float32Array(copied.buffer);
+		const language = typeof params.language === "string" && params.language ? params.language : void 0;
+		const model = getLocalVoiceModel(modelId);
+		if (model.engine === "sherpa-onnx") return {
+			...await transcribeWithSherpa(model.id, audio, language),
+			modelId
+		};
+		const output = await (await loadPipeline(modelId, false))(audio, {
+			task: "transcribe",
+			...language ? { language } : {},
+			chunk_length_s: 30,
+			stride_length_s: 5,
+			return_timestamps: false
+		});
+		return {
+			text: (output && typeof output === "object" && "text" in output ? String(output.text ?? "") : "").trim(),
+			modelId
+		};
+	}
+	throw new Error(`Unknown local voice runtime method: ${request.method}`);
+}
+const lines = createInterface({ input: process.stdin });
+const dispatch = createRuntimeDispatcher({
+	execute: handle,
+	sendResult: (request, result) => send({
+		id: request.id,
+		result
+	}),
+	sendError: (request, error) => send({
+		id: request.id,
+		error: serializeError(error)
+	})
+});
+lines.on("line", (line) => {
+	let request;
+	try {
+		request = JSON.parse(line);
+	} catch {
+		return;
+	}
+	dispatch(request);
+});
+lines.once("close", () => {
+	networkAgent.close().finally(() => process.exit(0));
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=runtime-worker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-worker.js","names":[],"sources":["../../../../src/voice/local/runtime-worker.ts"],"sourcesContent":["import { createInterface } from 'node:readline';\nimport { join, resolve, sep } from 'node:path';\nimport { mkdir, rm } from 'node:fs/promises';\n\nimport { EnvHttpProxyAgent, RetryAgent, setGlobalDispatcher } from 'undici';\n\nimport { getLocalVoiceModel, resolveLocalVoiceModelDir } from './models.js';\nimport { downloadLocalVoiceModelFiles } from './model-files.js';\nimport { createRuntimeDispatcher } from './runtime-dispatcher.js';\n\ntype RuntimeRequest = { id: number; method: string; params?: Record<string, unknown> };\ntype AsrPipeline = (audio: Float32Array, options?: Record<string, unknown>) => Promise<unknown>;\n\nconst pipelines = new Map<string, Promise<AsrPipeline>>();\n\ninterface SherpaOfflineStream {\n  acceptWaveform(input: { sampleRate: number; samples: Float32Array }): void;\n  setOption?(key: string, value: string): void;\n}\n\ninterface SherpaResult {\n  text?: string;\n  lang?: string;\n  emotion?: string;\n  event?: string;\n}\n\ninterface SherpaOfflineRecognizer {\n  createStream(): SherpaOfflineStream;\n  decodeAsync?(stream: SherpaOfflineStream): Promise<SherpaResult>;\n  decode(stream: SherpaOfflineStream): void;\n  getResult(stream: SherpaOfflineStream): SherpaResult;\n}\n\ntype SherpaModule = {\n  OfflineRecognizer: new (config: Record<string, unknown>) => SherpaOfflineRecognizer;\n};\n\nconst sherpaRecognizers = new Map<string, Promise<SherpaOfflineRecognizer>>();\n\nconst networkAgent = new RetryAgent(new EnvHttpProxyAgent(), {\n  maxRetries: 4,\n  minTimeout: 500,\n  maxTimeout: 8_000,\n  timeoutFactor: 2,\n  retryAfter: true,\n});\nsetGlobalDispatcher(networkAgent);\n\nfunction normalizeRemoteHost(value: string): string {\n  const url = new URL(value);\n  if (url.username || url.password) {\n    throw new Error('Local voice model endpoint must not contain credentials');\n  }\n  if (url.protocol !== 'https:' && url.hostname !== '127.0.0.1' && url.hostname !== 'localhost') {\n    throw new Error('Local voice model endpoint must use HTTPS');\n  }\n  url.pathname = `${url.pathname.replace(/\\/+$/, '')}/`;\n  return url.toString();\n}\n\nfunction resolveRemoteHosts(): string[] {\n  const configured = process.env.XOPC_VOICE_MODEL_ENDPOINT?.trim()\n    || process.env.HF_ENDPOINT?.trim();\n  if (configured) return [normalizeRemoteHost(configured)];\n  return [\n    normalizeRemoteHost('https://xopc.ai/api/voice/models'),\n    normalizeRemoteHost('https://huggingface.co'),\n  ];\n}\n\nfunction serializeError(error: unknown): { message: string; code?: string; cause?: string } {\n  if (!(error instanceof Error)) return { message: String(error) };\n  const withCode = error as Error & { code?: unknown; cause?: unknown };\n  const nested = withCode.cause;\n  const nestedMessage = nested instanceof Error ? nested.message : undefined;\n  const nestedCode = nested && typeof nested === 'object' && 'code' in nested\n    ? String((nested as { code?: unknown }).code ?? '')\n    : undefined;\n  return {\n    message: error.message,\n    ...(typeof withCode.code === 'string' ? { code: withCode.code } : {}),\n    ...(nestedCode ? { code: nestedCode } : {}),\n    ...(nestedMessage && nestedMessage !== error.message ? { cause: nestedMessage } : {}),\n  };\n}\n\nfunction send(message: Record<string, unknown>): void {\n  process.stdout.write(`${JSON.stringify(message)}\\n`);\n}\n\nasync function loadPipeline(\n  modelId: string,\n  allowRemote: boolean,\n  cacheDir = resolveLocalVoiceModelDir(modelId),\n  onProgress?: (data: Record<string, unknown>) => void,\n): Promise<AsrPipeline> {\n  const key = `${modelId}:${cacheDir}`;\n  const existing = pipelines.get(key);\n  if (existing) return existing;\n  const model = getLocalVoiceModel(modelId);\n  if (model.engine !== 'transformers.js') {\n    throw new Error(`Model ${model.id} does not use the Transformers.js engine`);\n  }\n  const promise = (async () => {\n    const transformers = await import('@huggingface/transformers');\n    transformers.env.cacheDir = cacheDir;\n    transformers.env.allowRemoteModels = allowRemote;\n    transformers.env.allowLocalModels = true;\n    const remoteHosts = allowRemote ? resolveRemoteHosts() : [normalizeRemoteHost('https://xopc.ai')];\n    let lastError: unknown;\n    for (const [index, remoteHost] of remoteHosts.entries()) {\n      transformers.env.remoteHost = remoteHost;\n      try {\n        const result = await transformers.pipeline('automatic-speech-recognition', model.repository, {\n          revision: model.revision,\n          dtype: model.dtype,\n          progress_callback: onProgress,\n        });\n        return result as unknown as AsrPipeline;\n      } catch (error) {\n        lastError = error;\n        if (index + 1 < remoteHosts.length) {\n          await rm(cacheDir, { recursive: true, force: true });\n          await mkdir(cacheDir, { recursive: true });\n        }\n      }\n    }\n    throw lastError;\n  })();\n  pipelines.set(key, promise);\n  try {\n    return await promise;\n  } catch (error) {\n    pipelines.delete(key);\n    throw error;\n  }\n}\n\nfunction normalizeSenseVoiceLanguage(language: unknown): string {\n  if (typeof language !== 'string') return 'auto';\n  const value = language.trim().toLowerCase().replace('_', '-');\n  if (!value || value === 'auto') return 'auto';\n  if (value === 'cmn' || value.startsWith('zh')) return 'zh';\n  if (value === 'cantonese' || value.startsWith('yue')) return 'yue';\n  if (value.startsWith('en')) return 'en';\n  if (value.startsWith('ja')) return 'ja';\n  if (value.startsWith('ko')) return 'ko';\n  return 'auto';\n}\n\nfunction cleanSenseVoiceTag(value: string | undefined): string | undefined {\n  const cleaned = value?.replace(/^<\\|/, '').replace(/\\|>$/, '').trim();\n  return cleaned || undefined;\n}\n\nasync function loadSherpaRecognizer(\n  modelId: string,\n  language: string,\n): Promise<SherpaOfflineRecognizer> {\n  const key = `${modelId}:${language}`;\n  const existing = sherpaRecognizers.get(key);\n  if (existing) return existing;\n  const model = getLocalVoiceModel(modelId);\n  if (model.engine !== 'sherpa-onnx') {\n    throw new Error(`Model ${model.id} does not use the sherpa-onnx engine`);\n  }\n  const modelDir = resolveLocalVoiceModelDir(model.id);\n  const promise = (async () => {\n    const imported = await import('sherpa-onnx-node');\n    const sherpa = ((imported as { default?: SherpaModule }).default ?? imported) as SherpaModule;\n    return new sherpa.OfflineRecognizer({\n      featConfig: { sampleRate: 16_000, featureDim: 80 },\n      modelConfig: {\n        senseVoice: {\n          model: join(modelDir, 'model.int8.onnx'),\n          language,\n          useInverseTextNormalization: 1,\n        },\n        tokens: join(modelDir, 'tokens.txt'),\n        numThreads: Math.max(1, Math.min(4, Number(process.env.XOPC_VOICE_THREADS) || 2)),\n        provider: 'cpu',\n        debug: 0,\n      },\n    });\n  })();\n  sherpaRecognizers.set(key, promise);\n  try {\n    return await promise;\n  } catch (error) {\n    sherpaRecognizers.delete(key);\n    throw error;\n  }\n}\n\nasync function transcribeWithSherpa(\n  modelId: string,\n  audio: Float32Array,\n  language: unknown,\n): Promise<{ text: string; language?: string; emotion?: string; event?: string }> {\n  const recognizer = await loadSherpaRecognizer(modelId, normalizeSenseVoiceLanguage(language));\n  const stream = recognizer.createStream();\n  stream.acceptWaveform({ sampleRate: 16_000, samples: audio });\n  const result = recognizer.decodeAsync\n    ? await recognizer.decodeAsync(stream)\n    : (recognizer.decode(stream), recognizer.getResult(stream));\n  return {\n    text: String(result.text ?? '').trim(),\n    ...(cleanSenseVoiceTag(result.lang) ? { language: cleanSenseVoiceTag(result.lang) } : {}),\n    ...(cleanSenseVoiceTag(result.emotion) ? { emotion: cleanSenseVoiceTag(result.emotion) } : {}),\n    ...(cleanSenseVoiceTag(result.event) ? { event: cleanSenseVoiceTag(result.event) } : {}),\n  };\n}\n\nasync function handle(request: RuntimeRequest): Promise<unknown> {\n  const params = request.params ?? {};\n  if (request.method === 'health') {\n    return {\n      ok: true,\n      protocolVersion: 2,\n      engine: 'transformers.js+sherpa-onnx',\n      engines: ['transformers.js', 'sherpa-onnx'],\n    };\n  }\n  if (request.method === 'model.install') {\n    const modelId = String(params.modelId ?? '');\n    const modelDir = resolve(resolveLocalVoiceModelDir(modelId));\n    const requestedCacheDir = typeof params.cacheDir === 'string' ? resolve(params.cacheDir) : modelDir;\n    const allowedPrefix = `${resolve(modelDir, '..')}${sep}`;\n    if (requestedCacheDir !== modelDir && !requestedCacheDir.startsWith(allowedPrefix)) {\n      throw new Error('Local voice model cache directory is outside the managed root');\n    }\n    const model = getLocalVoiceModel(modelId);\n    if (model.engine === 'sherpa-onnx') {\n      await downloadLocalVoiceModelFiles({\n        model,\n        destinationDir: requestedCacheDir,\n        remoteHosts: resolveRemoteHosts(),\n        onProgress: (data) => send({ id: request.id, event: 'progress', data }),\n      });\n    } else {\n      await loadPipeline(\n        modelId,\n        true,\n        requestedCacheDir,\n        (data) => send({ id: request.id, event: 'progress', data }),\n      );\n      pipelines.delete(`${modelId}:${requestedCacheDir}`);\n    }\n    return { installed: true, modelId };\n  }\n  if (request.method === 'model.unload') {\n    const modelId = String(params.modelId ?? '');\n    for (const key of pipelines.keys()) {\n      if (key.startsWith(`${modelId}:`)) pipelines.delete(key);\n    }\n    for (const key of sherpaRecognizers.keys()) {\n      if (key.startsWith(`${modelId}:`)) sherpaRecognizers.delete(key);\n    }\n    return { unloaded: true };\n  }\n  if (request.method === 'transcribe') {\n    const modelId = String(params.modelId ?? '');\n    const bytes = Buffer.from(String(params.audioBase64 ?? ''), 'base64');\n    const copied = Uint8Array.from(bytes);\n    const audio = new Float32Array(copied.buffer);\n    const language = typeof params.language === 'string' && params.language ? params.language : undefined;\n    const model = getLocalVoiceModel(modelId);\n    if (model.engine === 'sherpa-onnx') {\n      return { ...(await transcribeWithSherpa(model.id, audio, language)), modelId };\n    }\n    const pipeline = await loadPipeline(modelId, false);\n    const output = await pipeline(audio, {\n      task: 'transcribe',\n      ...(language ? { language } : {}),\n      chunk_length_s: 30,\n      stride_length_s: 5,\n      return_timestamps: false,\n    });\n    const text = output && typeof output === 'object' && 'text' in output\n      ? String((output as { text?: unknown }).text ?? '')\n      : '';\n    return { text: text.trim(), modelId };\n  }\n  throw new Error(`Unknown local voice runtime method: ${request.method}`);\n}\n\nconst lines = createInterface({ input: process.stdin });\nconst dispatch = createRuntimeDispatcher<RuntimeRequest>({\n  execute: handle,\n  sendResult: (request, result) => send({ id: request.id, result }),\n  sendError: (request, error) => send({ id: request.id, error: serializeError(error) }),\n});\nlines.on('line', (line) => {\n  let request: RuntimeRequest;\n  try {\n    request = JSON.parse(line) as RuntimeRequest;\n  } catch {\n    return;\n  }\n  dispatch(request);\n});\nlines.once('close', () => {\n  void networkAgent.close().finally(() => process.exit(0));\n});\n"],"mappings":"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"}

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

@@ -0,0 +1,6 @@
+export interface DecodedPcmAudio {
+    samples: Float32Array;
+    sampleRate: number;
+    durationSeconds: number;
+}
+export declare function decodeWavToMonoFloat32(buffer: Buffer, targetRate?: number): DecodedPcmAudio;

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

@@ -0,0 +1,69 @@
+//#region src/voice/local/wav.ts
+function readChunkId(buffer, offset) {
+	return buffer.toString("ascii", offset, offset + 4);
+}
+function resampleLinear(input, sourceRate, targetRate) {
+	if (sourceRate === targetRate) return input;
+	const outputLength = Math.max(1, Math.round(input.length * targetRate / sourceRate));
+	const output = new Float32Array(outputLength);
+	const ratio = sourceRate / targetRate;
+	for (let i = 0; i < outputLength; i += 1) {
+		const sourcePosition = i * ratio;
+		const left = Math.min(input.length - 1, Math.floor(sourcePosition));
+		const right = Math.min(input.length - 1, left + 1);
+		const fraction = sourcePosition - left;
+		output[i] = input[left] * (1 - fraction) + input[right] * fraction;
+	}
+	return output;
+}
+function decodeWavToMonoFloat32(buffer, targetRate = 16e3) {
+	if (buffer.length < 44 || readChunkId(buffer, 0) !== "RIFF" || readChunkId(buffer, 8) !== "WAVE") throw new Error("Local STT currently requires PCM WAV audio");
+	let offset = 12;
+	let format;
+	let dataOffset = -1;
+	let dataLength = 0;
+	while (offset + 8 <= buffer.length) {
+		const id = readChunkId(buffer, offset);
+		const length = buffer.readUInt32LE(offset + 4);
+		const bodyOffset = offset + 8;
+		if (bodyOffset + length > buffer.length) break;
+		if (id === "fmt " && length >= 16) format = {
+			audioFormat: buffer.readUInt16LE(bodyOffset),
+			channels: buffer.readUInt16LE(bodyOffset + 2),
+			sampleRate: buffer.readUInt32LE(bodyOffset + 4),
+			bitsPerSample: buffer.readUInt16LE(bodyOffset + 14)
+		};
+		else if (id === "data") {
+			dataOffset = bodyOffset;
+			dataLength = length;
+			break;
+		}
+		offset = bodyOffset + length + length % 2;
+	}
+	if (!format || dataOffset < 0 || dataLength === 0) throw new Error("WAV audio is missing format or data chunks");
+	if (format.channels < 1 || format.channels > 8 || format.sampleRate < 8e3) throw new Error("Unsupported WAV channel count or sample rate");
+	const bytesPerSample = format.bitsPerSample / 8;
+	if (!Number.isInteger(bytesPerSample) || bytesPerSample < 2) throw new Error(`Unsupported WAV bit depth: ${format.bitsPerSample}`);
+	const frameBytes = bytesPerSample * format.channels;
+	const frameCount = Math.floor(dataLength / frameBytes);
+	const mono = new Float32Array(frameCount);
+	for (let frame = 0; frame < frameCount; frame += 1) {
+		let sum = 0;
+		for (let channel = 0; channel < format.channels; channel += 1) {
+			const sampleOffset = dataOffset + frame * frameBytes + channel * bytesPerSample;
+			if (format.audioFormat === 1 && format.bitsPerSample === 16) sum += buffer.readInt16LE(sampleOffset) / 32768;
+			else if (format.audioFormat === 3 && format.bitsPerSample === 32) sum += buffer.readFloatLE(sampleOffset);
+			else throw new Error(`Unsupported WAV encoding: format ${format.audioFormat}, ${format.bitsPerSample}-bit`);
+		}
+		mono[frame] = Math.max(-1, Math.min(1, sum / format.channels));
+	}
+	return {
+		samples: resampleLinear(mono, format.sampleRate, targetRate),
+		sampleRate: targetRate,
+		durationSeconds: frameCount / format.sampleRate
+	};
+}
+//#endregion
+export { decodeWavToMonoFloat32 };
+
+//# sourceMappingURL=wav.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wav.js","names":[],"sources":["../../../../src/voice/local/wav.ts"],"sourcesContent":["export interface DecodedPcmAudio {\n  samples: Float32Array;\n  sampleRate: number;\n  durationSeconds: number;\n}\n\nfunction readChunkId(buffer: Buffer, offset: number): string {\n  return buffer.toString('ascii', offset, offset + 4);\n}\n\nfunction resampleLinear(input: Float32Array, sourceRate: number, targetRate: number): Float32Array {\n  if (sourceRate === targetRate) return input;\n  const outputLength = Math.max(1, Math.round((input.length * targetRate) / sourceRate));\n  const output = new Float32Array(outputLength);\n  const ratio = sourceRate / targetRate;\n  for (let i = 0; i < outputLength; i += 1) {\n    const sourcePosition = i * ratio;\n    const left = Math.min(input.length - 1, Math.floor(sourcePosition));\n    const right = Math.min(input.length - 1, left + 1);\n    const fraction = sourcePosition - left;\n    output[i] = input[left]! * (1 - fraction) + input[right]! * fraction;\n  }\n  return output;\n}\n\nexport function decodeWavToMonoFloat32(buffer: Buffer, targetRate = 16_000): DecodedPcmAudio {\n  if (buffer.length < 44 || readChunkId(buffer, 0) !== 'RIFF' || readChunkId(buffer, 8) !== 'WAVE') {\n    throw new Error('Local STT currently requires PCM WAV audio');\n  }\n\n  let offset = 12;\n  let format: { audioFormat: number; channels: number; sampleRate: number; bitsPerSample: number } | undefined;\n  let dataOffset = -1;\n  let dataLength = 0;\n  while (offset + 8 <= buffer.length) {\n    const id = readChunkId(buffer, offset);\n    const length = buffer.readUInt32LE(offset + 4);\n    const bodyOffset = offset + 8;\n    if (bodyOffset + length > buffer.length) break;\n    if (id === 'fmt ' && length >= 16) {\n      format = {\n        audioFormat: buffer.readUInt16LE(bodyOffset),\n        channels: buffer.readUInt16LE(bodyOffset + 2),\n        sampleRate: buffer.readUInt32LE(bodyOffset + 4),\n        bitsPerSample: buffer.readUInt16LE(bodyOffset + 14),\n      };\n    } else if (id === 'data') {\n      dataOffset = bodyOffset;\n      dataLength = length;\n      break;\n    }\n    offset = bodyOffset + length + (length % 2);\n  }\n\n  if (!format || dataOffset < 0 || dataLength === 0) {\n    throw new Error('WAV audio is missing format or data chunks');\n  }\n  if (format.channels < 1 || format.channels > 8 || format.sampleRate < 8_000) {\n    throw new Error('Unsupported WAV channel count or sample rate');\n  }\n  const bytesPerSample = format.bitsPerSample / 8;\n  if (!Number.isInteger(bytesPerSample) || bytesPerSample < 2) {\n    throw new Error(`Unsupported WAV bit depth: ${format.bitsPerSample}`);\n  }\n  const frameBytes = bytesPerSample * format.channels;\n  const frameCount = Math.floor(dataLength / frameBytes);\n  const mono = new Float32Array(frameCount);\n  for (let frame = 0; frame < frameCount; frame += 1) {\n    let sum = 0;\n    for (let channel = 0; channel < format.channels; channel += 1) {\n      const sampleOffset = dataOffset + frame * frameBytes + channel * bytesPerSample;\n      if (format.audioFormat === 1 && format.bitsPerSample === 16) {\n        sum += buffer.readInt16LE(sampleOffset) / 32768;\n      } else if (format.audioFormat === 3 && format.bitsPerSample === 32) {\n        sum += buffer.readFloatLE(sampleOffset);\n      } else {\n        throw new Error(`Unsupported WAV encoding: format ${format.audioFormat}, ${format.bitsPerSample}-bit`);\n      }\n    }\n    mono[frame] = Math.max(-1, Math.min(1, sum / format.channels));\n  }\n\n  const samples = resampleLinear(mono, format.sampleRate, targetRate);\n  return {\n    samples,\n    sampleRate: targetRate,\n    durationSeconds: frameCount / format.sampleRate,\n  };\n}\n"],"mappings":";AAMA,SAAS,YAAY,QAAgB,QAAwB;AAC3D,QAAO,OAAO,SAAS,SAAS,QAAQ,SAAS,EAAE;;AAGrD,SAAS,eAAe,OAAqB,YAAoB,YAAkC;AACjG,KAAI,eAAe,WAAY,QAAO;CACtC,MAAM,eAAe,KAAK,IAAI,GAAG,KAAK,MAAO,MAAM,SAAS,aAAc,WAAW,CAAC;CACtF,MAAM,SAAS,IAAI,aAAa,aAAa;CAC7C,MAAM,QAAQ,aAAa;AAC3B,MAAK,IAAI,IAAI,GAAG,IAAI,cAAc,KAAK,GAAG;EACxC,MAAM,iBAAiB,IAAI;EAC3B,MAAM,OAAO,KAAK,IAAI,MAAM,SAAS,GAAG,KAAK,MAAM,eAAe,CAAC;EACnE,MAAM,QAAQ,KAAK,IAAI,MAAM,SAAS,GAAG,OAAO,EAAE;EAClD,MAAM,WAAW,iBAAiB;AAClC,SAAO,KAAK,MAAM,SAAU,IAAI,YAAY,MAAM,SAAU;;AAE9D,QAAO;;AAGT,SAAgB,uBAAuB,QAAgB,aAAa,MAAyB;AAC3F,KAAI,OAAO,SAAS,MAAM,YAAY,QAAQ,EAAE,KAAK,UAAU,YAAY,QAAQ,EAAE,KAAK,OACxF,OAAM,IAAI,MAAM,6CAA6C;CAG/D,IAAI,SAAS;CACb,IAAI;CACJ,IAAI,aAAa;CACjB,IAAI,aAAa;AACjB,QAAO,SAAS,KAAK,OAAO,QAAQ;EAClC,MAAM,KAAK,YAAY,QAAQ,OAAO;EACtC,MAAM,SAAS,OAAO,aAAa,SAAS,EAAE;EAC9C,MAAM,aAAa,SAAS;AAC5B,MAAI,aAAa,SAAS,OAAO,OAAQ;AACzC,MAAI,OAAO,UAAU,UAAU,GAC7B,UAAS;GACP,aAAa,OAAO,aAAa,WAAW;GAC5C,UAAU,OAAO,aAAa,aAAa,EAAE;GAC7C,YAAY,OAAO,aAAa,aAAa,EAAE;GAC/C,eAAe,OAAO,aAAa,aAAa,GAAG;GACpD;WACQ,OAAO,QAAQ;AACxB,gBAAa;AACb,gBAAa;AACb;;AAEF,WAAS,aAAa,SAAU,SAAS;;AAG3C,KAAI,CAAC,UAAU,aAAa,KAAK,eAAe,EAC9C,OAAM,IAAI,MAAM,6CAA6C;AAE/D,KAAI,OAAO,WAAW,KAAK,OAAO,WAAW,KAAK,OAAO,aAAa,IACpE,OAAM,IAAI,MAAM,+CAA+C;CAEjE,MAAM,iBAAiB,OAAO,gBAAgB;AAC9C,KAAI,CAAC,OAAO,UAAU,eAAe,IAAI,iBAAiB,EACxD,OAAM,IAAI,MAAM,8BAA8B,OAAO,gBAAgB;CAEvE,MAAM,aAAa,iBAAiB,OAAO;CAC3C,MAAM,aAAa,KAAK,MAAM,aAAa,WAAW;CACtD,MAAM,OAAO,IAAI,aAAa,WAAW;AACzC,MAAK,IAAI,QAAQ,GAAG,QAAQ,YAAY,SAAS,GAAG;EAClD,IAAI,MAAM;AACV,OAAK,IAAI,UAAU,GAAG,UAAU,OAAO,UAAU,WAAW,GAAG;GAC7D,MAAM,eAAe,aAAa,QAAQ,aAAa,UAAU;AACjE,OAAI,OAAO,gBAAgB,KAAK,OAAO,kBAAkB,GACvD,QAAO,OAAO,YAAY,aAAa,GAAG;YACjC,OAAO,gBAAgB,KAAK,OAAO,kBAAkB,GAC9D,QAAO,OAAO,YAAY,aAAa;OAEvC,OAAM,IAAI,MAAM,oCAAoC,OAAO,YAAY,IAAI,OAAO,cAAc,MAAM;;AAG1G,OAAK,SAAS,KAAK,IAAI,IAAI,KAAK,IAAI,GAAG,MAAM,OAAO,SAAS,CAAC;;AAIhE,QAAO;EACL,SAFc,eAAe,MAAM,OAAO,YAAY,WAE/C;EACP,YAAY;EACZ,iBAAiB,aAAa,OAAO;EACtC"}