@elizaos/plugin-local-inference 2.0.0-beta.1 → 2.0.11-beta.7

package/src/services/voice/voice-profile-routes.ts

@@ -0,0 +1,425 @@
+/**
+ * Server-side voice-profile management routes.
+ *
+ * Surfaces the available OmniVoice profiles from:
+ *   1. The active Eliza-1 bundle's `cache/voice-preset-*.bin` files.
+ *   2. The `models/voice/profiles/` catalog directory (build-time profiles).
+ *
+ * Routes:
+ *   GET  /v1/voice/profiles           — list available profiles
+ *   POST /v1/voice/profiles/:id/activate  — set the active default profile
+ *   DELETE /v1/voice/profiles/:id     — soft-delete (mark inactive in catalog)
+ *
+ * The active default profile is persisted in the voice profile catalog JSON
+ * (`models/voice/profiles/catalog.json`). On model boot, the engine bridge
+ * reads this to pick which preset to load as the default.
+ *
+ * No runtime recording interface is exposed. Profile creation happens at
+ * build time via `bun run voice:create-profile`.
+ */
+
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import type http from "node:http";
+import path from "node:path";
+import { resolveStateDir } from "@elizaos/core";
+import {
+	readVoicePresetFile,
+	type VoicePresetFile,
+} from "./voice-preset-format";
+
+/** Catalog JSON schema version. */
+const CATALOG_SCHEMA_VERSION = 1 as const;
+
+/** One entry in `catalog.json`. */
+export interface VoiceProfileCatalogEntry {
+	/** Profile identifier — matches the `voice-preset-<id>.bin` filename suffix. */
+	id: string;
+	/** Human-readable display name. */
+	displayName: string;
+	/** Build-time instruct string (VoiceDesign vocabulary). */
+	instruct: string;
+	/** Whether this profile is currently active (visible + usable). */
+	active: boolean;
+	/** ISO timestamp when this entry was created. */
+	createdAt: string;
+	/** Optional source bundle. */
+	sourceBundleId?: string;
+	/** Optional sha256 of the source corpus. */
+	corpusSha256?: string;
+}
+
+export interface VoiceProfileCatalog {
+	version: typeof CATALOG_SCHEMA_VERSION;
+	/** ID of the profile to load as the default on model boot. */
+	defaultProfileId: string;
+	profiles: VoiceProfileCatalogEntry[];
+}
+
+export interface VoiceProfileRouteOptions {
+	/**
+	 * Directory that holds `profiles/catalog.json` and the built-in
+	 * `manifest.json`. Defaults to `<repo>/models/voice/`.
+	 */
+	voiceModelsDir?: string;
+	/**
+	 * Root of the active Eliza-1 bundle. When set, the routes also scan
+	 * `<bundleRoot>/cache/voice-preset-*.bin` for bundle-shipped profiles.
+	 */
+	bundleRoot?: string;
+}
+
+const DEFAULT_PROFILE_ID = "same";
+
+// ---------------------------------------------------------------------------
+// Catalog helpers
+// ---------------------------------------------------------------------------
+
+function resolveCatalogPath(voiceModelsDir: string): string {
+	return path.join(voiceModelsDir, "profiles", "catalog.json");
+}
+
+async function readCatalog(
+	voiceModelsDir: string,
+): Promise<VoiceProfileCatalog> {
+	const catalogPath = resolveCatalogPath(voiceModelsDir);
+	if (!fs.existsSync(catalogPath)) {
+		return {
+			version: CATALOG_SCHEMA_VERSION,
+			defaultProfileId: DEFAULT_PROFILE_ID,
+			profiles: [],
+		};
+	}
+	try {
+		const raw = await fsp.readFile(catalogPath, "utf8");
+		const parsed = JSON.parse(raw) as VoiceProfileCatalog;
+		if (!parsed.profiles) parsed.profiles = [];
+		if (!parsed.defaultProfileId) parsed.defaultProfileId = DEFAULT_PROFILE_ID;
+		parsed.version = CATALOG_SCHEMA_VERSION;
+		return parsed;
+	} catch {
+		return {
+			version: CATALOG_SCHEMA_VERSION,
+			defaultProfileId: DEFAULT_PROFILE_ID,
+			profiles: [],
+		};
+	}
+}
+
+async function writeCatalog(
+	voiceModelsDir: string,
+	catalog: VoiceProfileCatalog,
+): Promise<void> {
+	const catalogPath = resolveCatalogPath(voiceModelsDir);
+	await fsp.mkdir(path.dirname(catalogPath), { recursive: true });
+	const tmp = `${catalogPath}.tmp`;
+	await fsp.writeFile(tmp, JSON.stringify(catalog, null, 2), "utf8");
+	await fsp.rename(tmp, catalogPath);
+}
+
+// ---------------------------------------------------------------------------
+// Profile discovery
+// ---------------------------------------------------------------------------
+
+/** Parse a preset bin and extract the profile metadata we care about. */
+function parsePresetMeta(
+	presetPath: string,
+): Pick<VoicePresetFile, "instruct" | "refText" | "metadata"> | null {
+	if (!fs.existsSync(presetPath)) return null;
+	try {
+		const bytes = fs.readFileSync(presetPath);
+		const preset = readVoicePresetFile(new Uint8Array(bytes));
+		return {
+			instruct: preset.instruct,
+			refText: preset.refText,
+			metadata: preset.metadata,
+		};
+	} catch {
+		return null;
+	}
+}
+
+/** Scan `<bundleRoot>/cache/` for `voice-preset-*.bin` files. */
+function scanBundleProfiles(
+	bundleRoot: string,
+): Array<{ id: string; presetPath: string }> {
+	const cacheDir = path.join(bundleRoot, "cache");
+	if (!fs.existsSync(cacheDir)) return [];
+	const PREFIX = "voice-preset-";
+	const SUFFIX = ".bin";
+	return fs
+		.readdirSync(cacheDir)
+		.filter((f) => f.startsWith(PREFIX) && f.endsWith(SUFFIX))
+		.map((f) => {
+			const id = f.slice(PREFIX.length, f.length - SUFFIX.length);
+			return { id, presetPath: path.join(cacheDir, f) };
+		});
+}
+
+/** Merge bundle-scanned profiles with catalog entries. */
+async function listProfiles(
+	_voiceModelsDir: string,
+	bundleRoot: string | undefined,
+	catalog: VoiceProfileCatalog,
+): Promise<
+	Array<{
+		id: string;
+		displayName: string;
+		instruct: string;
+		active: boolean;
+		isDefault: boolean;
+		source: "bundle" | "catalog";
+		createdAt: string;
+	}>
+> {
+	const seenIds = new Set<string>();
+	const out: Array<{
+		id: string;
+		displayName: string;
+		instruct: string;
+		active: boolean;
+		isDefault: boolean;
+		source: "bundle" | "catalog";
+		createdAt: string;
+	}> = [];
+
+	// Bundle-shipped presets take priority.
+	if (bundleRoot) {
+		for (const { id, presetPath } of scanBundleProfiles(bundleRoot)) {
+			seenIds.add(id);
+			const meta = parsePresetMeta(presetPath);
+			const catalogEntry = catalog.profiles.find((e) => e.id === id);
+			const active = catalogEntry ? catalogEntry.active : true;
+			out.push({
+				id,
+				displayName: catalogEntry?.displayName ?? id,
+				instruct: catalogEntry?.instruct ?? meta?.instruct ?? "",
+				active,
+				isDefault: catalog.defaultProfileId === id,
+				source: "bundle",
+				createdAt: catalogEntry?.createdAt ?? new Date().toISOString(),
+			});
+		}
+	}
+
+	// Catalog-only profiles (not in bundle).
+	for (const entry of catalog.profiles) {
+		if (seenIds.has(entry.id)) continue;
+		out.push({
+			id: entry.id,
+			displayName: entry.displayName,
+			instruct: entry.instruct,
+			active: entry.active,
+			isDefault: catalog.defaultProfileId === entry.id,
+			source: "catalog",
+			createdAt: entry.createdAt,
+		});
+	}
+
+	return out;
+}
+
+// ---------------------------------------------------------------------------
+// Route handler
+// ---------------------------------------------------------------------------
+
+function sendJson(
+	res: http.ServerResponse,
+	status: number,
+	body: unknown,
+): void {
+	if (res.headersSent) return;
+	res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
+	res.end(JSON.stringify(body));
+}
+
+function sendError(
+	res: http.ServerResponse,
+	status: number,
+	message: string,
+): void {
+	sendJson(res, status, { error: message });
+}
+
+/**
+ * Route handler for all `/v1/voice/profiles*` endpoints.
+ *
+ * Returns `true` if the request was handled, `false` to pass through.
+ */
+export async function handleVoiceProfileRoutes(
+	req: http.IncomingMessage,
+	res: http.ServerResponse,
+	opts: VoiceProfileRouteOptions,
+): Promise<boolean> {
+	const method = req.method?.toUpperCase() ?? "GET";
+	const rawUrl = req.url ?? "/";
+	// Strip query string for routing.
+	const pathname = rawUrl.split("?")[0] ?? rawUrl;
+
+	if (!pathname.startsWith("/v1/voice/profiles")) {
+		return false;
+	}
+
+	const voiceModelsDir =
+		opts.voiceModelsDir ??
+		path.join(resolveStateDir(process.env), "models", "voice");
+	const bundleRoot = opts.bundleRoot;
+
+	// -------------------------------------------------------------------
+	// GET /v1/voice/profiles
+	// -------------------------------------------------------------------
+	if (method === "GET" && pathname === "/v1/voice/profiles") {
+		const catalog = await readCatalog(voiceModelsDir);
+		const profiles = await listProfiles(voiceModelsDir, bundleRoot, catalog);
+		sendJson(res, 200, {
+			defaultProfileId: catalog.defaultProfileId,
+			profiles,
+		});
+		return true;
+	}
+
+	// -------------------------------------------------------------------
+	// POST /v1/voice/profiles/:id/activate
+	// -------------------------------------------------------------------
+	const activateMatch = /^\/v1\/voice\/profiles\/([^/]+)\/activate$/.exec(
+		pathname,
+	);
+	if (method === "POST" && activateMatch) {
+		const profileId = decodeURIComponent(activateMatch[1] ?? "");
+		if (!profileId || !/^[A-Za-z0-9._-]+$/.test(profileId)) {
+			sendError(res, 400, `Invalid profile id: ${profileId}`);
+			return true;
+		}
+
+		const catalog = await readCatalog(voiceModelsDir);
+
+		// Accept any profile that exists in the bundle or catalog.
+		const profiles = await listProfiles(voiceModelsDir, bundleRoot, catalog);
+		const target = profiles.find((p) => p.id === profileId);
+		if (!target) {
+			sendError(res, 404, `Profile '${profileId}' not found`);
+			return true;
+		}
+		if (!target.active) {
+			sendError(res, 409, `Profile '${profileId}' is inactive (soft-deleted)`);
+			return true;
+		}
+
+		// Update the catalog default.
+		const prevDefault = catalog.defaultProfileId;
+		catalog.defaultProfileId = profileId;
+
+		// Ensure the profile has a catalog entry (for bundle-only profiles, create one).
+		const existingEntry = catalog.profiles.find((e) => e.id === profileId);
+		if (!existingEntry) {
+			catalog.profiles.push({
+				id: profileId,
+				displayName: target.displayName,
+				instruct: target.instruct,
+				active: true,
+				createdAt: new Date().toISOString(),
+			});
+		}
+
+		await writeCatalog(voiceModelsDir, catalog);
+
+		sendJson(res, 200, {
+			defaultProfileId: profileId,
+			previousDefaultProfileId: prevDefault,
+		});
+		return true;
+	}
+
+	// -------------------------------------------------------------------
+	// DELETE /v1/voice/profiles/:id
+	// -------------------------------------------------------------------
+	const deleteMatch = /^\/v1\/voice\/profiles\/([^/]+)$/.exec(pathname);
+	if (method === "DELETE" && deleteMatch) {
+		const profileId = decodeURIComponent(deleteMatch[1] ?? "");
+		if (!profileId || !/^[A-Za-z0-9._-]+$/.test(profileId)) {
+			sendError(res, 400, `Invalid profile id: ${profileId}`);
+			return true;
+		}
+
+		const catalog = await readCatalog(voiceModelsDir);
+
+		if (catalog.defaultProfileId === profileId) {
+			sendError(
+				res,
+				409,
+				`Cannot delete the active default profile '${profileId}'. Activate a different profile first.`,
+			);
+			return true;
+		}
+
+		// Soft-delete: mark inactive in catalog. Never unlinks shipped bundle files.
+		const existingEntry = catalog.profiles.find((e) => e.id === profileId);
+		if (existingEntry) {
+			existingEntry.active = false;
+		} else {
+			// Profile exists in bundle but is absent from catalog — add as inactive.
+			const profiles = await listProfiles(voiceModelsDir, bundleRoot, catalog);
+			const target = profiles.find((p) => p.id === profileId);
+			if (!target) {
+				sendError(res, 404, `Profile '${profileId}' not found`);
+				return true;
+			}
+			catalog.profiles.push({
+				id: profileId,
+				displayName: target.displayName,
+				instruct: target.instruct,
+				active: false,
+				createdAt: new Date().toISOString(),
+			});
+		}
+
+		await writeCatalog(voiceModelsDir, catalog);
+		sendJson(res, 200, { deleted: profileId, active: false });
+		return true;
+	}
+
+	return false;
+}
+
+// ---------------------------------------------------------------------------
+// Server-side default profile loading
+// ---------------------------------------------------------------------------
+
+/**
+ * Resolve the active default profile id from the voice catalog.
+ *
+ * Called at model boot (before `EngineVoiceBridge.start()`) to determine
+ * which `voice-preset-<id>.bin` to load as the default voice. Returns
+ * `"default"` when the catalog has no explicit default set.
+ */
+export async function resolveDefaultProfileId(
+	voiceModelsDir: string,
+): Promise<string> {
+	const catalog = await readCatalog(voiceModelsDir);
+	return catalog.defaultProfileId || DEFAULT_PROFILE_ID;
+}
+
+/**
+ * Persist a newly created profile into the voice catalog.
+ *
+ * Called by `bun run voice:create-profile` after the freeze pipeline
+ * writes the preset binary. Appends an entry to `catalog.json` if the
+ * profile id is not already there; updates instruct + displayName if it is.
+ */
+export async function registerProfileInCatalog(
+	voiceModelsDir: string,
+	entry: Omit<VoiceProfileCatalogEntry, "active"> & { active?: boolean },
+): Promise<void> {
+	const catalog = await readCatalog(voiceModelsDir);
+	const existing = catalog.profiles.findIndex((e) => e.id === entry.id);
+	const full: VoiceProfileCatalogEntry = {
+		...entry,
+		active: entry.active ?? true,
+	};
+	if (existing >= 0) {
+		catalog.profiles[existing] = full;
+	} else {
+		catalog.profiles.push(full);
+	}
+	await writeCatalog(voiceModelsDir, catalog);
+}

package/src/services/voice/voice-scenario.ts

@@ -0,0 +1,154 @@
+/**
+ * Voice Workbench scenario schema (#8785).
+ *
+ * One declarative format for a voice conversation that BOTH the headless runner
+ * (real services: ASR / diarization / EOT / respond / TTS over a corpus) and
+ * the headful scenario player (the real frontend client pipeline) execute, and
+ * that the benchmark layer scores. A scenario is an ordered list of turns plus
+ * named participants and scenario-level assertions; each turn declares the
+ * expected behavior (respond / don't, transcript, speaker label, entity) so the
+ * runner can score against ground truth.
+ *
+ * Pure types + a pure validator — no model loading, no I/O — so it is safe to
+ * import from the runner, the player, and tests alike.
+ */
+
+/** A named voice/entity participating in the scenario. */
+export interface VoiceScenarioParticipant {
+	/** Stable label used in turns + diarization ground truth (e.g. "alice"). */
+	label: string;
+	/** TTS voice id used to synthesize this participant's turns in the corpus. */
+	ttsVoiceId?: string;
+	/** The elizaOS entity id this voice should resolve to (voice→entity match). */
+	entityId?: string;
+	/** True when this participant is the device owner / primary enrolled speaker. */
+	isOwner?: boolean;
+}
+
+/** One spoken turn in the scenario. */
+export interface VoiceScenarioTurn {
+	/** Participant label (must exist in `participants`). */
+	speaker: string;
+	/** Spoken text — synthesized to audio by the corpus generator. */
+	text?: string;
+	/** OR a reference to a pre-recorded/-generated audio file under the corpus. */
+	audioRef?: string;
+	/** Override the participant's default TTS voice for this turn. */
+	ttsVoiceId?: string;
+	/** Silent gaps (ms) spliced AFTER this turn's audio (pauses / barge-in gaps). */
+	pausesMs?: number[];
+	/** Ground truth: SHOULD the agent respond to this turn? */
+	expectRespond: boolean;
+	/** Expected ASR transcript (for WER scoring); defaults to `text`. */
+	expectedTranscript?: string;
+	/** Expected diarization label (defaults to `speaker`). */
+	expectedSpeakerLabel?: string;
+	/** Expected entity inferred/recognized from this turn (name extraction). */
+	expectedEntity?: string;
+}
+
+/** Scenario-level pass/fail thresholds the benchmark layer enforces. */
+export interface VoiceScenarioAssertions {
+	/** Max word-error-rate across the scenario's transcripts. */
+	maxWer?: number;
+	/** Max diarization error rate. */
+	maxDer?: number;
+	/** Min respond-decision accuracy. */
+	minRespondAccuracy?: number;
+	/** Max EOT false-trigger rate. */
+	maxEotFalseTriggerRate?: number;
+	/** Min voice→entity match rate. */
+	minVoiceEntityMatchRate?: number;
+	/** Latency budgets (ms) — first-audio / time-to-first-token, etc. */
+	maxFirstAudioMs?: number;
+	maxTtftMs?: number;
+}
+
+export type VoiceScenarioClass =
+	| "multi-voice"
+	| "pauses"
+	| "respond-no-respond"
+	| "multi-speaker"
+	| "diarization"
+	| "entity-extraction"
+	| "voice-recognition"
+	| "eot"
+	| "transcription-mode"
+	| "multi-agent-room"
+	| "long-form-monologue";
+
+export interface VoiceScenario {
+	/** Stable id (also the corpus subdirectory name). */
+	id: string;
+	/** Human description of what the scenario exercises. */
+	description?: string;
+	/** Which scenario class(es) this belongs to (drives the headful spec matrix). */
+	classes: VoiceScenarioClass[];
+	participants: VoiceScenarioParticipant[];
+	turns: VoiceScenarioTurn[];
+	assertions?: VoiceScenarioAssertions;
+	/** Agent labels present in a multi-agent room (subset of participants). */
+	agents?: string[];
+}
+
+export interface VoiceScenarioValidation {
+	valid: boolean;
+	errors: string[];
+}
+
+/**
+ * Validate a scenario's internal consistency (pure; no I/O). Checks ids,
+ * participant references, turn audio/text presence, and that any agents named
+ * exist as participants. Returns all errors (does not throw) so a corpus build
+ * can report every problem at once.
+ */
+export function validateVoiceScenario(
+	scenario: VoiceScenario,
+): VoiceScenarioValidation {
+	const errors: string[] = [];
+	if (!scenario.id?.trim()) errors.push("scenario.id is required");
+	if (!Array.isArray(scenario.classes) || scenario.classes.length === 0) {
+		errors.push("scenario.classes must be a non-empty array");
+	}
+	const labels = new Set<string>();
+	for (const p of scenario.participants ?? []) {
+		if (!p.label?.trim()) {
+			errors.push("participant.label is required");
+			continue;
+		}
+		if (labels.has(p.label))
+			errors.push(`duplicate participant label: ${p.label}`);
+		labels.add(p.label);
+	}
+	if (labels.size === 0) errors.push("scenario.participants must be non-empty");
+	if (!Array.isArray(scenario.turns) || scenario.turns.length === 0) {
+		errors.push("scenario.turns must be a non-empty array");
+	}
+	scenario.turns?.forEach((t, i) => {
+		if (!labels.has(t.speaker)) {
+			errors.push(`turn[${i}].speaker "${t.speaker}" is not a participant`);
+		}
+		if (!t.text?.trim() && !t.audioRef?.trim()) {
+			errors.push(`turn[${i}] must have either text or audioRef`);
+		}
+		if (typeof t.expectRespond !== "boolean") {
+			errors.push(`turn[${i}].expectRespond must be a boolean`);
+		}
+	});
+	for (const agent of scenario.agents ?? []) {
+		if (!labels.has(agent)) {
+			errors.push(`agent "${agent}" is not a participant`);
+		}
+	}
+	return { valid: errors.length === 0, errors };
+}
+
+/** The expected ASR reference for a turn (explicit override or its text). */
+export function turnReferenceTranscript(turn: VoiceScenarioTurn): string {
+	return (turn.expectedTranscript ?? turn.text ?? "").trim();
+}
+
+/** The expected diarization label for a turn (explicit override or speaker). */
+export function turnSpeakerLabel(turn: VoiceScenarioTurn): string {
+	return turn.expectedSpeakerLabel ?? turn.speaker;
+}

package/src/services/voice/voice-settings.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Voice settings — the user-facing knobs the runtime + UI consume to
+ * decide local vs cloud, model quality, RAM cap, and quant downgrade.
+ *
+ * R9 §5 spells out the five knobs:
+ *
+ *   1. `voice.forceLocal` / `voice.forceCloud` / `voice.autoSwap` — backend
+ *      mode (auto by default).
+ *   2. `voice.modelQualityPreset` — `"max" | "balanced" | "minimal"`.
+ *   3. `voice.maxRamMB` — hard cap on the allocator's total budget.
+ *   4. `voice.allowQuantDowngrade` — auto-pick smaller quants if RAM tight.
+ *
+ * This module is the env-var resolver + the canonical default table. The
+ * dashboard's Settings panel writes the same fields to `messages.voice.*`
+ * config; I10 wires the persistent store. For now (I9 scope), the resolver
+ * reads env + an optional `Partial<VoiceSettings>` overlay so tests can
+ * lock in deterministic behaviour.
+ *
+ * There is no central `settings.ts` to extend in `plugins/plugin-local-
+ * inference/src/services/` today (R9 §1 path inventory confirms it).
+ * Keeping this file in `voice/` makes its surface area obvious.
+ */
+import type { DeviceTier } from "../device-tier";
+export type VoiceBackendMode = "auto" | "force-local" | "force-cloud";
+export type VoiceModelQualityPreset = "max" | "balanced" | "minimal";
+export interface VoiceSettings {
+    /** Backend selection mode. `auto` consults the device tier. */
+    backendMode: VoiceBackendMode;
+    /** When `backendMode === "auto"`, allow the runtime to swap between
+     *  cloud and local in mid-session to keep latency bounded. */
+    autoSwap: boolean;
+    /** Quality vs RAM tradeoff. Maps to a quant ladder for the LM + voice
+     *  stack — see `qualityPresetQuantizationRanking()`. */
+    modelQualityPreset: VoiceModelQualityPreset;
+    /** Hard cap on the allocator's total budget, in MB. 0 / null = use the
+     *  tier's natural total. */
+    maxRamMb: number | null;
+    /** When true (default), an OOM-pending reservation may pick a smaller
+     *  quant variant instead of refusing. When false, `reserve()` throws. */
+    allowQuantDowngrade: boolean;
+    /** Continuous local recording on mobile when on battery. Off by default. */
+    continuousLocalRecordingOnBattery: boolean;
+}
+declare const DEFAULT_VOICE_SETTINGS: VoiceSettings;
+/**
+ * Resolve voice settings from environment + an optional overlay.
+ * Env wins over defaults; overlay wins over env (so tests / UI can lock
+ * specific fields). All fields are required in the returned settings.
+ *
+ * Env knobs (canonical ELIZA_* prefix; ELIZA_* aliases honored upstream):
+ *
+ *   - `ELIZA_VOICE_BACKEND_MODE`        → backendMode
+ *   - `ELIZA_VOICE_AUTO_SWAP`           → autoSwap
+ *   - `ELIZA_VOICE_QUALITY_PRESET`      → modelQualityPreset
+ *   - `ELIZA_VOICE_MAX_RAM_MB`          → maxRamMb
+ *   - `ELIZA_VOICE_ALLOW_QUANT_DOWNGRADE` → allowQuantDowngrade
+ *   - `ELIZA_VOICE_CONTINUOUS_ON_BATTERY` → continuousLocalRecordingOnBattery
+ */
+export declare function resolveVoiceSettings(overlay?: Partial<VoiceSettings>, env?: NodeJS.ProcessEnv): VoiceSettings;
+/**
+ * Default backend mode given the user's settings + the device tier. R9 §5:
+ *
+ *   - `force-local` overrides the mobile-cloud-default;
+ *   - `force-cloud` overrides the desktop-local-default;
+ *   - `auto` consults the tier (MAX/GOOD → local; OKAY/POOR → cloud).
+ *
+ * Returns the resolved mode the runtime should *act on*, taking the tier
+ * into account.
+ */
+export declare function effectiveBackendMode(settings: VoiceSettings, tier: DeviceTier): "local" | "cloud";
+/**
+ * Ordered quant ladder per quality preset. Most-preferred first. Loaders
+ * pick the most-preferred variant that fits the budget; `allowQuantDowngrade`
+ * controls whether they slide down the ladder when the top choice doesn't
+ * fit.
+ *
+ * Names match the catalog ids in `recommendation.ts:textQuantizationMatrix`
+ * + the voice stack's documented variants.
+ */
+export declare function qualityPresetQuantizationRanking(preset: VoiceModelQualityPreset): ReadonlyArray<string>;
+export { DEFAULT_VOICE_SETTINGS };
+//# sourceMappingURL=voice-settings.d.ts.map

package/src/services/voice/voice-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-settings.d.ts","sourceRoot":"","sources":["voice-settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC;AACtE,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC;AAErE,MAAM,WAAW,aAAa;IAC7B,+DAA+D;IAC/D,WAAW,EAAE,gBAAgB,CAAC;IAC9B;kEAC8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB;4DACwD;IACxD,kBAAkB,EAAE,uBAAuB,CAAC;IAC5C;gCAC4B;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;6EACyE;IACzE,mBAAmB,EAAE,OAAO,CAAC;IAC7B,4EAA4E;IAC5E,iCAAiC,EAAE,OAAO,CAAC;CAC3C;AAED,QAAA,MAAM,sBAAsB,EAAE,aAO7B,CAAC;AAqCF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,EACpC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,aAAa,CAkBf;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,UAAU,GACd,OAAO,GAAG,OAAO,CAMnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAC/C,MAAM,EAAE,uBAAuB,GAC7B,aAAa,CAAC,MAAM,CAAC,CASvB;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC"}