@moolam/bindings-speech 1.0.0

package/dist/voice_rtt_proof.d.ts

@@ -0,0 +1,112 @@
+/**
+ * NFR-07 voice RTT proof: final transcript timestamp → first TTS audio chunk.
+ *
+ * Uses real performance.now() wall clocks on the measurement path (not mocked
+ * clocks alone). Absolute ceiling from PRD_MATRIX (≤2500ms p95) plus relative
+ * regression vs a recorded device-profile baseline.
+ */
+import { type LocalTtsNativeBackend } from "./tts_binding.js";
+export declare const NFR_07_ID: "NFR-07";
+export declare const NFR_07_BUDGET_P95_MS = 2500;
+export declare const DEFAULT_VOICE_RTT_DEVICE_PROFILE: string;
+export declare const DEFAULT_VOICE_RTT_BASELINE: string;
+export type VoiceRttDeviceProfile = {
+    schemaVersion: string;
+    profileId: string;
+    platform: string;
+    hardwareClass: string;
+    nfr: {
+        nfrId: typeof NFR_07_ID;
+        metric: "final_transcript_to_first_audio";
+        voiceRttP95Ms: number;
+    };
+    description?: string;
+};
+export type VoiceRttBaseline = {
+    schemaVersion: string;
+    nfrId: typeof NFR_07_ID;
+    metric: "final_transcript_to_first_audio";
+    deviceProfileId: string;
+    p95Ms: number;
+    tolerancePercent: number;
+    sampleCount: number;
+    warmupCount: number;
+    notes?: string;
+    recordedAt?: string;
+};
+export type VoiceRttSample = {
+    latencyMs: number;
+    utteranceId: string;
+};
+export type VoiceRttProofResult = {
+    nfrId: typeof NFR_07_ID;
+    metric: "final_transcript_to_first_audio";
+    outcome: "pass" | "fail";
+    ok: boolean;
+    measuredP95Ms: number;
+    budgetP95Ms: number;
+    baselineP95Ms: number;
+    allowedRelativeP95Ms: number;
+    absoluteOk: boolean;
+    relativeOk: boolean;
+    sampleCount: number;
+    samplesMs: number[];
+    deviceProfileId: string;
+    subjectId: string;
+    deviceId: string;
+    clock: "performance.now";
+    failures: string[];
+    policy: "absolute-ceiling-plus-relative-baseline";
+};
+export type RunVoiceRttProofOptions = {
+    subjectId: string;
+    deviceId: string;
+    deviceProfilePath?: string;
+    baselinePath?: string;
+    utteranceId?: string;
+    sampleCount?: number;
+    warmupCount?: number;
+    /** Real delay before first TTS chunk (seeded red / prove). */
+    injectFirstAudioDelayMs?: number;
+    /** Override absolute budget (tests). */
+    budgetP95Ms?: number;
+    /** Override baseline p95 (tests). */
+    baselineP95Ms?: number;
+    tolerancePercent?: number;
+    language?: string;
+};
+/** Percentile (nearest-rank) over ascending samples. */
+export declare function percentileMs(samples: readonly number[], p: number): number;
+export declare function loadVoiceRttDeviceProfile(profilePath?: string): VoiceRttDeviceProfile;
+export declare function loadVoiceRttBaseline(baselinePath?: string): VoiceRttBaseline;
+/**
+ * Wrap a TTS backend to delay the first audio chunk with a real timer
+ * (seeded red for NFR-07). Uses setTimeout — not a mocked clock.
+ */
+export declare function createDelayedFirstAudioTtsBackend(delayMs: number, inner?: LocalTtsNativeBackend): LocalTtsNativeBackend;
+export declare function evaluateVoiceRttGates(args: {
+    measuredP95Ms: number;
+    budgetP95Ms: number;
+    baselineP95Ms: number;
+    tolerancePercent: number;
+}): {
+    absoluteOk: boolean;
+    relativeOk: boolean;
+    allowedRelativeP95Ms: number;
+    failures: string[];
+};
+/**
+ * One sample: STT until final → clock → TTS until first audio chunk → clock.
+ */
+export declare function measureOneVoiceRttSample(args: {
+    subjectId: string;
+    deviceId: string;
+    utteranceId: string;
+    language: string;
+    injectFirstAudioDelayMs?: number;
+}): Promise<VoiceRttSample>;
+/**
+ * Run NFR-07 voice RTT proof on the recorded mid-range device profile.
+ */
+export declare function runVoiceRttProof(options: RunVoiceRttProofOptions): Promise<VoiceRttProofResult>;
+//# sourceMappingURL=voice_rtt_proof.d.ts.map

package/dist/voice_rtt_proof.d.ts.map

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

package/dist/voice_rtt_proof.js

@@ -0,0 +1,241 @@
+/**
+ * NFR-07 voice RTT proof: final transcript timestamp → first TTS audio chunk.
+ *
+ * Uses real performance.now() wall clocks on the measurement path (not mocked
+ * clocks alone). Absolute ceiling from PRD_MATRIX (≤2500ms p95) plus relative
+ * regression vs a recorded device-profile baseline.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { collectTranscriptSegments } from "@moolam/contract-conformance";
+import { indicFixtureAsAudioStream, loadIndicUtteranceFixture, loadWhisperCppSpeech, } from "./stt_binding.js";
+import { createInProcessLocalTtsBackend, loadLocalTts, } from "./tts_binding.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PACKAGE_ROOT = path.resolve(__dirname, "..");
+export const NFR_07_ID = "NFR-07";
+export const NFR_07_BUDGET_P95_MS = 2500;
+export const DEFAULT_VOICE_RTT_DEVICE_PROFILE = path.join(PACKAGE_ROOT, "certification", "device-profiles", "mid-range-android.json");
+export const DEFAULT_VOICE_RTT_BASELINE = path.join(PACKAGE_ROOT, "certification", "voice-rtt.baseline.json");
+function nowMs() {
+    return performance.now();
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Percentile (nearest-rank) over ascending samples. */
+export function percentileMs(samples, p) {
+    if (samples.length === 0)
+        return Number.NaN;
+    const sorted = [...samples].sort((a, b) => a - b);
+    const rank = Math.min(sorted.length - 1, Math.max(0, Math.ceil((p / 100) * sorted.length) - 1));
+    return sorted[rank];
+}
+export function loadVoiceRttDeviceProfile(profilePath = DEFAULT_VOICE_RTT_DEVICE_PROFILE) {
+    if (!existsSync(profilePath)) {
+        throw new Error(`voice RTT device profile missing at ${profilePath}`);
+    }
+    const raw = JSON.parse(readFileSync(profilePath, "utf8"));
+    if (typeof raw.schemaVersion !== "string" ||
+        typeof raw.profileId !== "string" ||
+        raw.nfr?.nfrId !== NFR_07_ID ||
+        raw.nfr.metric !== "final_transcript_to_first_audio" ||
+        typeof raw.nfr.voiceRttP95Ms !== "number" ||
+        !(raw.nfr.voiceRttP95Ms > 0)) {
+        throw new Error("voice RTT device profile must declare NFR-07 final_transcript_to_first_audio budget");
+    }
+    return {
+        schemaVersion: raw.schemaVersion,
+        profileId: raw.profileId,
+        platform: typeof raw.platform === "string" ? raw.platform : "android",
+        hardwareClass: typeof raw.hardwareClass === "string" ? raw.hardwareClass : "mid-range",
+        nfr: {
+            nfrId: NFR_07_ID,
+            metric: "final_transcript_to_first_audio",
+            voiceRttP95Ms: raw.nfr.voiceRttP95Ms,
+        },
+        ...(typeof raw.description === "string"
+            ? { description: raw.description }
+            : {}),
+    };
+}
+export function loadVoiceRttBaseline(baselinePath = DEFAULT_VOICE_RTT_BASELINE) {
+    if (!existsSync(baselinePath)) {
+        throw new Error(`voice RTT baseline missing at ${baselinePath}`);
+    }
+    const raw = JSON.parse(readFileSync(baselinePath, "utf8"));
+    if (typeof raw.schemaVersion !== "string" ||
+        raw.nfrId !== NFR_07_ID ||
+        raw.metric !== "final_transcript_to_first_audio" ||
+        typeof raw.deviceProfileId !== "string" ||
+        typeof raw.p95Ms !== "number" ||
+        !(raw.p95Ms > 0) ||
+        typeof raw.tolerancePercent !== "number" ||
+        !(raw.tolerancePercent >= 0) ||
+        typeof raw.sampleCount !== "number" ||
+        !(raw.sampleCount > 0)) {
+        throw new Error("voice RTT baseline must declare NFR-07 p95Ms, tolerancePercent, sampleCount");
+    }
+    return {
+        schemaVersion: raw.schemaVersion,
+        nfrId: NFR_07_ID,
+        metric: "final_transcript_to_first_audio",
+        deviceProfileId: raw.deviceProfileId,
+        p95Ms: raw.p95Ms,
+        tolerancePercent: raw.tolerancePercent,
+        sampleCount: Math.min(64, Math.floor(raw.sampleCount)),
+        warmupCount: typeof raw.warmupCount === "number" && raw.warmupCount >= 0
+            ? Math.min(16, Math.floor(raw.warmupCount))
+            : 2,
+        ...(typeof raw.notes === "string" ? { notes: raw.notes } : {}),
+        ...(typeof raw.recordedAt === "string" ? { recordedAt: raw.recordedAt } : {}),
+    };
+}
+/**
+ * Wrap a TTS backend to delay the first audio chunk with a real timer
+ * (seeded red for NFR-07). Uses setTimeout — not a mocked clock.
+ */
+export function createDelayedFirstAudioTtsBackend(delayMs, inner = createInProcessLocalTtsBackend()) {
+    const ms = Math.max(0, delayMs);
+    return {
+        kind: inner.kind,
+        load: (modelId) => inner.load(modelId),
+        unload: (handle) => inner.unload(handle),
+        async synthesize(handle, params) {
+            if (ms > 0)
+                await sleep(ms);
+            return inner.synthesize(handle, params);
+        },
+    };
+}
+export function evaluateVoiceRttGates(args) {
+    const failures = [];
+    const absoluteOk = Number.isFinite(args.measuredP95Ms) &&
+        args.measuredP95Ms <= args.budgetP95Ms;
+    if (!absoluteOk) {
+        failures.push(`NFR-07 absolute: p95 ${args.measuredP95Ms.toFixed(3)}ms > budget ${args.budgetP95Ms}ms`);
+    }
+    const allowedRelativeP95Ms = args.baselineP95Ms * (1 + args.tolerancePercent / 100);
+    const relativeOk = Number.isFinite(args.measuredP95Ms) &&
+        args.measuredP95Ms <= allowedRelativeP95Ms;
+    if (!relativeOk) {
+        failures.push(`NFR-07 relative: p95 ${args.measuredP95Ms.toFixed(3)}ms > allowed ${allowedRelativeP95Ms.toFixed(3)}ms (baseline ${args.baselineP95Ms}ms + ${args.tolerancePercent}%)`);
+    }
+    return { absoluteOk, relativeOk, allowedRelativeP95Ms, failures };
+}
+/**
+ * One sample: STT until final → clock → TTS until first audio chunk → clock.
+ */
+export async function measureOneVoiceRttSample(args) {
+    const fixture = loadIndicUtteranceFixture(args.utteranceId);
+    const stt = await loadWhisperCppSpeech({
+        subjectId: args.subjectId,
+        deviceId: args.deviceId,
+    });
+    const tts = await loadLocalTts({
+        subjectId: args.subjectId,
+        deviceId: args.deviceId,
+        ...(args.injectFirstAudioDelayMs && args.injectFirstAudioDelayMs > 0
+            ? {
+                backend: createDelayedFirstAudioTtsBackend(args.injectFirstAudioDelayMs),
+            }
+            : {}),
+    });
+    try {
+        let tFinal;
+        let finalText = "";
+        for await (const seg of stt.transcribe(indicFixtureAsAudioStream(fixture))) {
+            if (!seg.isFinal)
+                continue;
+            tFinal = nowMs();
+            finalText = seg.text.trim() || "voice.rtt.probe";
+            break;
+        }
+        if (tFinal === undefined) {
+            // Fallback collect if stream ended without early break
+            const segs = await collectTranscriptSegments(stt.transcribe(indicFixtureAsAudioStream(fixture)));
+            const final = [...segs].reverse().find((s) => s.isFinal);
+            if (!final) {
+                throw new Error(`voice RTT: no final transcript for ${args.utteranceId}`);
+            }
+            tFinal = nowMs();
+            finalText = final.text.trim() || "voice.rtt.probe";
+        }
+        let tFirst;
+        for await (const chunk of tts.synthesize(finalText, {
+            language: args.language,
+        })) {
+            if (chunk.data.byteLength > 0) {
+                tFirst = nowMs();
+                break;
+            }
+        }
+        if (tFirst === undefined) {
+            throw new Error("voice RTT: synthesize yielded no audio chunks");
+        }
+        const latencyMs = Math.max(0, tFirst - tFinal);
+        return { latencyMs, utteranceId: args.utteranceId };
+    }
+    finally {
+        await Promise.all([stt.unload(), tts.unload()]);
+    }
+}
+/**
+ * Run NFR-07 voice RTT proof on the recorded mid-range device profile.
+ */
+export async function runVoiceRttProof(options) {
+    const deviceProfile = loadVoiceRttDeviceProfile(options.deviceProfilePath ?? DEFAULT_VOICE_RTT_DEVICE_PROFILE);
+    const baseline = loadVoiceRttBaseline(options.baselinePath ?? DEFAULT_VOICE_RTT_BASELINE);
+    const budgetP95Ms = options.budgetP95Ms ?? deviceProfile.nfr.voiceRttP95Ms ?? NFR_07_BUDGET_P95_MS;
+    const baselineP95Ms = options.baselineP95Ms ?? baseline.p95Ms;
+    const tolerancePercent = options.tolerancePercent ?? baseline.tolerancePercent;
+    const sampleCount = Math.min(64, Math.max(1, options.sampleCount ?? baseline.sampleCount));
+    const warmupCount = Math.min(16, Math.max(0, options.warmupCount ?? baseline.warmupCount));
+    const utteranceId = options.utteranceId ?? "hi-greeting";
+    const language = options.language ?? "hi-IN";
+    const measured = [];
+    const total = warmupCount + sampleCount;
+    for (let i = 0; i < total; i++) {
+        const sample = await measureOneVoiceRttSample({
+            subjectId: `${options.subjectId}.rtt.${i}`,
+            deviceId: options.deviceId,
+            utteranceId,
+            language,
+            ...(options.injectFirstAudioDelayMs !== undefined
+                ? { injectFirstAudioDelayMs: options.injectFirstAudioDelayMs }
+                : {}),
+        });
+        if (i >= warmupCount) {
+            measured.push(sample.latencyMs);
+        }
+    }
+    const measuredP95Ms = percentileMs(measured, 95);
+    const gates = evaluateVoiceRttGates({
+        measuredP95Ms,
+        budgetP95Ms,
+        baselineP95Ms,
+        tolerancePercent,
+    });
+    const ok = gates.absoluteOk && gates.relativeOk;
+    return {
+        nfrId: NFR_07_ID,
+        metric: "final_transcript_to_first_audio",
+        outcome: ok ? "pass" : "fail",
+        ok,
+        measuredP95Ms,
+        budgetP95Ms,
+        baselineP95Ms,
+        allowedRelativeP95Ms: gates.allowedRelativeP95Ms,
+        absoluteOk: gates.absoluteOk,
+        relativeOk: gates.relativeOk,
+        sampleCount: measured.length,
+        samplesMs: measured.map((m) => Number(m.toFixed(3))),
+        deviceProfileId: deviceProfile.profileId,
+        subjectId: options.subjectId,
+        deviceId: options.deviceId,
+        clock: "performance.now",
+        failures: gates.failures,
+        policy: "absolute-ceiling-plus-relative-baseline",
+    };
+}
+//# sourceMappingURL=voice_rtt_proof.js.map

package/dist/voice_rtt_proof.js.map

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

package/dist/whisper_ffi.d.ts

@@ -0,0 +1,44 @@
+/**
+ * whisper.cpp-class FFI / native addon seam.
+ *
+ * Production hosts inject a real whisper.cpp (or compatible) addon.
+ * CI uses {@link createInProcessWhisperCppBackend} so SpeechInterface
+ * stays tested without linking libwhisper on every runner.
+ */
+export type WhisperCppNativeHandle = {
+    readonly id: string;
+};
+export type WhisperCppTranscribeNativeParams = {
+    /** Concatenated PCM (or metadata probe bytes) for the utterance. */
+    pcm: Uint8Array;
+    sampleRateHz: number;
+    /** Duration estimate in ms (from PCM length or caller). */
+    durationMs: number;
+    /** BCP-47 hint; backend may ignore when auto-detecting. */
+    languageHint?: string;
+    /** Languages the loaded model actually supports. */
+    supportedLanguages: readonly string[];
+    signal?: AbortSignal;
+};
+export type WhisperCppTranscribeNativeResult = {
+    /** Interim hypothesis text (may equal final for short utterances). */
+    partialText: string;
+    finalText: string;
+    language: string;
+    confidence: number;
+    startMs: number;
+    endMs: number;
+};
+export type WhisperCppNativeBackend = {
+    readonly kind: "in-process" | "native-addon";
+    load(modelId: string): Promise<WhisperCppNativeHandle>;
+    unload(handle: WhisperCppNativeHandle): Promise<void>;
+    transcribe(handle: WhisperCppNativeHandle, params: WhisperCppTranscribeNativeParams): Promise<WhisperCppTranscribeNativeResult>;
+};
+/**
+ * In-process whisper.cpp-class stand-in for CI / unit tests.
+ * Emits non-empty hypotheses for code-switched and short probes without
+ * crashing segmentation.
+ */
+export declare function createInProcessWhisperCppBackend(): WhisperCppNativeBackend;
+//# sourceMappingURL=whisper_ffi.d.ts.map

package/dist/whisper_ffi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper_ffi.d.ts","sourceRoot":"","sources":["../src/whisper_ffi.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,sBAAsB,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,MAAM,MAAM,gCAAgC,GAAG;IAC7C,oEAAoE;IACpE,GAAG,EAAE,UAAU,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACvD,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,UAAU,CACR,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,gCAAgC,GACvC,OAAO,CAAC,gCAAgC,CAAC,CAAC;CAC9C,CAAC;AAeF;;;;GAIG;AACH,wBAAgB,gCAAgC,IAAI,uBAAuB,CAuF1E"}

package/dist/whisper_ffi.js

@@ -0,0 +1,104 @@
+/**
+ * whisper.cpp-class FFI / native addon seam.
+ *
+ * Production hosts inject a real whisper.cpp (or compatible) addon.
+ * CI uses {@link createInProcessWhisperCppBackend} so SpeechInterface
+ * stays tested without linking libwhisper on every runner.
+ */
+const DEVANAGARI = /[\u0900-\u097F]/u;
+const TAMIL = /[\u0B80-\u0BFF]/u;
+const LATIN_WORD = /[A-Za-z]{2,}/;
+function decodeProbeText(pcm) {
+    try {
+        return new TextDecoder("utf-8", { fatal: false }).decode(pcm);
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * In-process whisper.cpp-class stand-in for CI / unit tests.
+ * Emits non-empty hypotheses for code-switched and short probes without
+ * crashing segmentation.
+ */
+export function createInProcessWhisperCppBackend() {
+    let seq = 0;
+    return {
+        kind: "in-process",
+        async load(modelId) {
+            if (!modelId.trim()) {
+                throw new Error("whisper model id is required");
+            }
+            seq += 1;
+            return { id: `whisper-inproc-${seq}` };
+        },
+        async unload(_handle) {
+            /* no-op */
+        },
+        async transcribe(_handle, params) {
+            if (params.signal?.aborted) {
+                throw new Error("whisper transcribe aborted");
+            }
+            const langs = params.supportedLanguages.filter((l) => l.trim().length > 0);
+            if (langs.length === 0) {
+                throw new Error("supportedLanguages empty at native seam");
+            }
+            const fallback = langs[0];
+            const hint = params.languageHint && langs.includes(params.languageHint)
+                ? params.languageHint
+                : fallback;
+            const probe = decodeProbeText(params.pcm);
+            const noisyClassroom = /NOISE:classroom/i.test(probe);
+            const hasIndic = DEVANAGARI.test(probe);
+            const hasTamil = TAMIL.test(probe);
+            const hasLatin = LATIN_WORD.test(probe);
+            const codeSwitched = (hasIndic || hasTamil) && hasLatin;
+            let language = hint;
+            if (codeSwitched) {
+                language = langs.includes("hi-IN")
+                    ? "hi-IN"
+                    : langs.find((l) => l.startsWith("hi")) ?? hint;
+            }
+            else if (hasTamil) {
+                language =
+                    langs.find((l) => l.startsWith("ta")) ?? hint;
+            }
+            else if (hasIndic) {
+                language =
+                    langs.find((l) => l.startsWith("hi")) ?? hint;
+            }
+            else if (hasLatin) {
+                language =
+                    langs.find((l) => l.startsWith("en")) ?? hint;
+            }
+            const durationMs = Math.max(0, params.durationMs);
+            const endMs = Math.max(durationMs, 1);
+            // Short utterances still get a hypothesis; never empty final.
+            // Strip noise marker from hypothesis text — never treat marker as learner content.
+            const cleaned = probe.replace(/NOISE:classroom\s*/gi, "").trim();
+            const base = cleaned.length > 0
+                ? cleaned.slice(0, 120)
+                : durationMs < 200
+                    ? "…"
+                    : "utterance";
+            const partialText = codeSwitched
+                ? `${base.slice(0, Math.max(1, Math.floor(base.length / 2)))}…`
+                : `${base.slice(0, Math.max(1, Math.min(base.length, 24)))}`;
+            const finalText = codeSwitched ? `${base} [code-switched]` : base;
+            // Classroom ambient noise → confidence spike-down (FP-002 regression lock).
+            let confidence = codeSwitched ? 0.72 : 0.9;
+            if (noisyClassroom) {
+                confidence = Math.min(confidence, 0.35);
+            }
+            return {
+                partialText: partialText.length > 0 ? partialText : "…",
+                finalText: finalText.length > 0 ? finalText : "…",
+                language,
+                confidence,
+                startMs: 0,
+                endMs,
+            };
+        },
+    };
+}
+//# sourceMappingURL=whisper_ffi.js.map

package/dist/whisper_ffi.js.map

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

package/fixtures/indic/catalog.json

@@ -0,0 +1,75 @@
+{
+  "schemaVersion": "bindings-speech.indic-utterances.v1",
+  "sampleRateHz": 16000,
+  "pcmEncoding": "s16le-mono",
+  "description": "Committed Indic + English + code-switched Hindi/English STT audio fixtures (PCM s16le mono @ 16kHz). A short UTF-8 probe is embedded at the PCM head for the whisper.cpp-class in-process seam; production backends decode acoustics and ignore the prefix.",
+  "utterances": [
+    {
+      "id": "hi-greeting",
+      "kind": "indic-mono",
+      "language": "hi-IN",
+      "durationMs": 600,
+      "sampleRateHz": 16000,
+      "pcmRelpath": "audio/hi-greeting.pcm",
+      "byteLength": 19200,
+      "containsCodeSwitch": false,
+      "expectedLanguage": "hi-IN"
+    },
+    {
+      "id": "en-classroom",
+      "kind": "english-mono",
+      "language": "en-IN",
+      "durationMs": 700,
+      "sampleRateHz": 16000,
+      "pcmRelpath": "audio/en-classroom.pcm",
+      "byteLength": 22400,
+      "containsCodeSwitch": false,
+      "expectedLanguage": "en-IN"
+    },
+    {
+      "id": "ta-greeting",
+      "kind": "indic-mono",
+      "language": "ta-IN",
+      "durationMs": 650,
+      "sampleRateHz": 16000,
+      "pcmRelpath": "audio/ta-greeting.pcm",
+      "byteLength": 20800,
+      "containsCodeSwitch": false,
+      "expectedLanguage": "ta-IN"
+    },
+    {
+      "id": "hi-en-codeswitch",
+      "kind": "code-switched",
+      "language": "hi-IN",
+      "durationMs": 900,
+      "sampleRateHz": 16000,
+      "pcmRelpath": "audio/hi-en-codeswitch.pcm",
+      "byteLength": 28800,
+      "containsCodeSwitch": true,
+      "expectedLanguage": "hi-IN"
+    },
+    {
+      "id": "short-hi",
+      "kind": "short-utterance",
+      "language": "hi-IN",
+      "durationMs": 120,
+      "sampleRateHz": 16000,
+      "pcmRelpath": "audio/short-hi.pcm",
+      "byteLength": 3840,
+      "containsCodeSwitch": false,
+      "expectedLanguage": "hi-IN"
+    },
+    {
+      "id": "hi-classroom-noise",
+      "kind": "indic-classroom-noise",
+      "language": "hi-IN",
+      "durationMs": 900,
+      "sampleRateHz": 16000,
+      "pcmRelpath": "audio/hi-classroom-noise.pcm",
+      "byteLength": 28800,
+      "containsCodeSwitch": true,
+      "expectedLanguage": "hi-IN",
+      "ambientNoise": true
+    }
+  ]
+}

package/fixtures/indic/supported-languages.json

@@ -0,0 +1,8 @@
+{
+  "schemaVersion": "bindings-speech.indic-languages.v1",
+  "engine": "whisper.cpp-class",
+  "pinnedRevision": "whisper.cpp-class-v1",
+  "description": "BCP-47 languages actually supported by the acoustic+language models for the Indic STT fixture pack. Load declares this set as SpeechInterface.supportedLanguages — never aspirational.",
+  "languages": ["hi-IN", "en-IN", "ta-IN"],
+  "fallbackLanguage": "en-IN"
+}