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

package/src/services/voice/engine-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-bridge.d.ts","sourceRoot":"","sources":["engine-bridge.ts"],"names":[],"mappings":"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"}

package/src/services/voice/engine-bridge.test.ts

@@ -0,0 +1,384 @@
+/**
+ * Tests for the streaming-TTS routing in `engine-bridge.ts`.
+ *
+ * Covers the `FfiOmniVoiceBackend` ↔ fused `libelizainference` seam W9's
+ * scheduler drives:
+ *   - when the loaded build advertises streaming TTS
+ *     (`tts_stream_supported() == 1`), `synthesizeStream` forwards to
+ *     `eliza_inference_tts_synthesize_stream` and the chunk callback runs
+ *     per delivered PCM segment;
+ *   - when it does NOT, `synthesizeStream` still satisfies the seam — but
+ *     with exactly one body chunk + one `isFinal` tail (the batch
+ *     forward-pass result), so callers never mistake a non-streaming
+ *     build for a streaming one (no fallback sludge);
+ *   - `synthesize` (whole-phrase) routes through the streaming entry when
+ *     supported and concatenates the chunks;
+ *   - `cancelSignal` flips end the stream at the next chunk boundary;
+ *   - `StubOmniVoiceBackend` implements the same seam for scheduler tests.
+ */
+
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { fakeFfi } from "./__test-helpers__/fake-ffi";
+import {
+	EngineVoiceBridge,
+	FfiOmniVoiceBackend,
+	isStreamingTtsBackend,
+	nativeRejectedRangeToRollbackRange,
+	StubOmniVoiceBackend,
+	type TtsPcmChunk,
+} from "./engine-bridge";
+import type { VoiceLifecycleLoaders } from "./lifecycle";
+import type { MmapRegionHandle, RefCountedResource } from "./shared-resources";
+import type { OmniVoiceBackend, Phrase, SpeakerPreset } from "./types";
+import { writeVoicePresetFile } from "./voice-preset-format";
+
+function phrase(text: string): Phrase {
+	return {
+		id: 1,
+		text,
+		fromIndex: 0,
+		toIndex: text.length,
+		terminator: "punctuation",
+	};
+}
+
+function preset(): SpeakerPreset {
+	return {
+		voiceId: "default",
+		embedding: new Float32Array(4),
+		bytes: new Uint8Array(0),
+	};
+}
+
+function writePresetBundle(root: string): void {
+	mkdirSync(path.join(root, "cache"), { recursive: true });
+	const embedding = new Float32Array(16);
+	for (let i = 0; i < embedding.length; i++) embedding[i] = (i + 1) / 100;
+	writeFileSync(
+		path.join(root, "cache", "voice-preset-default.bin"),
+		Buffer.from(writeVoicePresetFile({ embedding, phrases: [] })),
+	);
+}
+
+function lifecycleLoadersOk(): VoiceLifecycleLoaders {
+	const region: MmapRegionHandle = {
+		id: "region-ok",
+		path: "/tmp/tts-ok",
+		sizeBytes: 1024,
+		async evictPages() {},
+		async release() {},
+	};
+	const refc: RefCountedResource = { id: "refc-ok", async release() {} };
+	return {
+		loadTtsRegion: async () => region,
+		loadAsrRegion: async () => region,
+		loadVoiceCaches: async () => refc,
+		loadVoiceSchedulerNodes: async () => refc,
+	};
+}
+
+describe("FfiOmniVoiceBackend — streaming TTS routing", () => {
+	it("synthesizeStream forwards to the streaming entry when the build supports it", async () => {
+		const backend = new FfiOmniVoiceBackend({
+			ffi: fakeFfi("ignored", { ttsSamples: 16, ttsStreamSupported: true }),
+			ctx: 1n,
+			sampleRate: 24_000,
+		});
+		expect(backend.supportsStreamingTts()).toBe(true);
+		const chunks: TtsPcmChunk[] = [];
+		const res = await backend.synthesizeStream({
+			phrase: phrase("hi there"),
+			preset: preset(),
+			cancelSignal: { cancelled: false },
+			onChunk: (c) => {
+				chunks.push({ ...c, pcm: new Float32Array(c.pcm) });
+			},
+		});
+		expect(res.cancelled).toBe(false);
+		// fakeFfi emits one body chunk (ttsSamples) + one final tail.
+		expect(chunks.map((c) => c.isFinal)).toEqual([false, true]);
+		expect(chunks[0]?.pcm.length).toBe(16);
+		expect(chunks[0]?.sampleRate).toBe(24_000);
+		expect(chunks[1]?.pcm.length).toBe(0);
+	});
+
+	it("synthesizeStream collapses to one body chunk + tail on a non-streaming build", async () => {
+		const backend = new FfiOmniVoiceBackend({
+			ffi: fakeFfi("ignored", { ttsSamples: 9, ttsStreamSupported: false }),
+			ctx: 1n,
+			sampleRate: 24_000,
+		});
+		expect(backend.supportsStreamingTts()).toBe(false);
+		const chunks: TtsPcmChunk[] = [];
+		const res = await backend.synthesizeStream({
+			phrase: phrase("hi"),
+			preset: preset(),
+			cancelSignal: { cancelled: false },
+			onChunk: (c) => {
+				chunks.push({ ...c, pcm: new Float32Array(c.pcm) });
+			},
+		});
+		expect(res.cancelled).toBe(false);
+		expect(chunks.map((c) => c.isFinal)).toEqual([false, true]);
+		// Batch path writes `ttsSamples` (= 9) into the caller buffer.
+		expect(chunks[0]?.pcm.length).toBe(9);
+	});
+
+	it("synthesize routes through the streaming entry and concatenates chunks", async () => {
+		const backend = new FfiOmniVoiceBackend({
+			ffi: fakeFfi("ignored", { ttsSamples: 7, ttsStreamSupported: true }),
+			ctx: 1n,
+			sampleRate: 16_000,
+		});
+		const out = await backend.synthesize({
+			phrase: phrase("speak"),
+			preset: preset(),
+			cancelSignal: { cancelled: false },
+		});
+		expect(out.pcm.length).toBe(7);
+		expect(out.sampleRate).toBe(16_000);
+		expect(out.phraseId).toBe(1);
+	});
+
+	it("passes NULL for the default speaker preset so OmniVoice uses bundle defaults", async () => {
+		const speakerIds: Array<string | null> = [];
+		const base = fakeFfi("ignored", {
+			ttsSamples: 4,
+			ttsStreamSupported: true,
+		});
+		const backend = new FfiOmniVoiceBackend({
+			ffi: {
+				...base,
+				ttsSynthesizeStream: (args) => {
+					speakerIds.push(args.speakerPresetId);
+					return base.ttsSynthesizeStream(args);
+				},
+			},
+			ctx: 1n,
+			sampleRate: 24_000,
+		});
+
+		await backend.synthesize({
+			phrase: phrase("hello"),
+			preset: preset(),
+			cancelSignal: { cancelled: false },
+		});
+
+		expect(speakerIds).toEqual(["default"]);
+	});
+
+	it("preserves non-default speaker preset ids for multi-voice bundles", async () => {
+		const speakerIds: Array<string | null> = [];
+		const base = fakeFfi("ignored", {
+			ttsSamples: 4,
+			ttsStreamSupported: false,
+		});
+		const backend = new FfiOmniVoiceBackend({
+			ffi: {
+				...base,
+				ttsSynthesize: (args) => {
+					speakerIds.push(args.speakerPresetId);
+					return base.ttsSynthesize(args);
+				},
+			},
+			ctx: 1n,
+			sampleRate: 24_000,
+		});
+
+		await backend.synthesize({
+			phrase: phrase("hello"),
+			preset: { ...preset(), voiceId: "narrator" },
+			cancelSignal: { cancelled: false },
+		});
+
+		expect(speakerIds).toEqual(["narrator"]);
+	});
+
+	it("batch transcribe uses the fused batch ABI with the original sample rate", async () => {
+		const seen: Array<{ sampleRateHz: number; samples: number }> = [];
+		const base = fakeFfi("ignored", {
+			ttsSamples: 4,
+			asrStreamSupported: true,
+		});
+		const backend = new FfiOmniVoiceBackend({
+			ffi: {
+				...base,
+				asrTranscribe: (args) => {
+					seen.push({
+						sampleRateHz: args.sampleRateHz,
+						samples: args.pcm.length,
+					});
+					return "Hello, say hello back.";
+				},
+			},
+			ctx: 1n,
+			sampleRate: 24_000,
+		});
+
+		const transcript = await backend.transcribe({
+			pcm: new Float32Array(24_000),
+			sampleRate: 24_000,
+		});
+
+		expect(transcript).toBe("Hello, say hello back.");
+		expect(seen).toEqual([{ sampleRateHz: 24_000, samples: 24_000 }]);
+	});
+
+	it("a pre-set cancelSignal short-circuits synthesizeStream before the body chunk", async () => {
+		const backend = new FfiOmniVoiceBackend({
+			ffi: fakeFfi("ignored", { ttsSamples: 32, ttsStreamSupported: true }),
+			ctx: 1n,
+		});
+		const chunks: TtsPcmChunk[] = [];
+		const res = await backend.synthesizeStream({
+			phrase: phrase("hello"),
+			preset: preset(),
+			cancelSignal: { cancelled: true },
+			onChunk: (c) => {
+				chunks.push(c);
+			},
+		});
+		expect(res.cancelled).toBe(true);
+		// The fake always fires the final tail; the body chunk is the one we
+		// expect to be skipped — but the fake emits it then we return true,
+		// so at most a final tail is observed with isFinal true.
+		expect(chunks.every((c) => c.isFinal)).toBe(true);
+	});
+
+	it("cancelTts is callable on the FFI backend", () => {
+		const backend = new FfiOmniVoiceBackend({
+			ffi: fakeFfi("x", { ttsStreamSupported: true }),
+			ctx: 1n,
+		});
+		expect(() => backend.cancelTts()).not.toThrow();
+	});
+});
+
+describe("nativeRejectedRangeToRollbackRange", () => {
+	it("converts native half-open verifier ranges to inclusive rollback ranges", () => {
+		expect(
+			nativeRejectedRangeToRollbackRange({ rejectedFrom: 3, rejectedTo: 7 }),
+		).toEqual({ fromIndex: 3, toIndex: 6 });
+	});
+
+	it("ignores empty and absent native verifier ranges", () => {
+		expect(
+			nativeRejectedRangeToRollbackRange({ rejectedFrom: -1, rejectedTo: -1 }),
+		).toBeNull();
+		expect(
+			nativeRejectedRangeToRollbackRange({ rejectedFrom: 5, rejectedTo: 5 }),
+		).toBeNull();
+	});
+});
+
+describe("StubOmniVoiceBackend — streaming seam", () => {
+	it("implements StreamingTtsBackend and emits a fixed number of chunks + final tail", async () => {
+		const backend = new StubOmniVoiceBackend(24_000);
+		expect(isStreamingTtsBackend(backend)).toBe(true);
+		const chunks: TtsPcmChunk[] = [];
+		const res = await backend.synthesizeStream({
+			phrase: phrase("one sec"),
+			preset: preset(),
+			cancelSignal: { cancelled: false },
+			onChunk: (c) => {
+				chunks.push(c);
+			},
+		});
+		expect(res.cancelled).toBe(false);
+		expect(chunks.length).toBeGreaterThanOrEqual(2);
+		expect(chunks.at(-1)?.isFinal).toBe(true);
+		// Every non-final chunk carries some PCM.
+		for (const c of chunks.slice(0, -1)) {
+			expect(c.isFinal).toBe(false);
+			expect(c.pcm.length).toBeGreaterThan(0);
+		}
+		expect(backend.streamCalls).toBe(1);
+	});
+
+	it("honours a mid-stream cancel via onChunk returning true", async () => {
+		const backend = new StubOmniVoiceBackend(24_000);
+		let n = 0;
+		const res = await backend.synthesizeStream({
+			phrase: phrase("got it"),
+			preset: preset(),
+			cancelSignal: { cancelled: false },
+			onChunk: () => {
+				n += 1;
+				return n === 1; // cancel after the first body chunk
+			},
+		});
+		expect(res.cancelled).toBe(true);
+	});
+});
+
+describe("EngineVoiceBridge direct synthesis guard", () => {
+	let bundleRoot: string;
+
+	beforeEach(() => {
+		bundleRoot = mkdtempSync(path.join(tmpdir(), "eliza-engine-bridge-"));
+		writePresetBundle(bundleRoot);
+	});
+
+	afterEach(() => {
+		rmSync(bundleRoot, { recursive: true, force: true });
+	});
+
+	it("rejects direct WAV synthesis on the silent backend", async () => {
+		const bridge = EngineVoiceBridge.start({
+			bundleRoot,
+			useFfiBackend: false,
+			lifecycleLoaders: lifecycleLoadersOk(),
+		});
+		await bridge.arm();
+
+		await expect(bridge.synthesizeTextToWav("hello")).rejects.toMatchObject({
+			code: "missing-fused-build",
+		});
+	});
+
+	it("routes one-shot transcription through the backend batch ABI without resampling first", async () => {
+		let observedSampleRate = 0;
+		let observedSamples = 0;
+		const backend = {
+			async synthesize() {
+				return {
+					phraseId: 0,
+					fromIndex: 0,
+					toIndex: 0,
+					pcm: new Float32Array(1),
+					sampleRate: 24_000,
+				};
+			},
+			async transcribe(args: { pcm: Float32Array; sampleRate: number }) {
+				observedSampleRate = args.sampleRate;
+				observedSamples = args.pcm.length;
+				return "Hello, say hello back.";
+			},
+		} as OmniVoiceBackend & {
+			transcribe(args: {
+				pcm: Float32Array;
+				sampleRate: number;
+			}): Promise<string>;
+		};
+		const bridge = EngineVoiceBridge.start({
+			bundleRoot,
+			useFfiBackend: false,
+			lifecycleLoaders: lifecycleLoadersOk(),
+			backendOverride: backend,
+		});
+		await bridge.arm();
+
+		const pcm = new Float32Array(24_000);
+		const transcript = await bridge.transcribePcm({
+			pcm,
+			sampleRate: 24_000,
+		});
+
+		expect(transcript).toBe("Hello, say hello back.");
+		expect(observedSampleRate).toBe(24_000);
+		expect(observedSamples).toBe(24_000);
+	});
+});