@kuralle-syrinx/silero-vad 4.4.1 → 4.5.0

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import type { PipelineBus } from "@kuralle-syrinx/core";
+import { type PluginConfig, type VoicePlugin } from "@kuralle-syrinx/core";
+export declare class SileroVADPlugin implements VoicePlugin {
+    private bus;
+    private session;
+    private ort;
+    private state;
+    private context;
+    private readonly windows;
+    private machine;
+    private sampleRate;
+    private disposers;
+    initialize(bus: PipelineBus, config: PluginConfig): Promise<void>;
+    processAudio(audio: Uint8Array, contextId: string): Promise<void>;
+    close(): Promise<void>;
+    private runModel;
+    private resetModelState;
+    private emitError;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAGL,KAAK,YAAY,EAEjB,KAAK,WAAW,EAGjB,MAAM,sBAAsB,CAAC;AAc9B,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,SAAS,CAAyB;IAEpC,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjE,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YASd,QAAQ;IA4BtB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,SAAS;CAYlB"}

package/dist/index.js

@@ -0,0 +1,117 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Silero VAD Plugin (Node, onnxruntime-node)
+//
+// Runs the Silero ONNX model locally and emits VAD packets through PipelineBus.
+// All turn/state decisions live in the shared SileroVadStateMachine
+// (vad-state-machine.ts) — this file only owns the Node-specific ONNX runtime
+// and on-disk model loading. The Workers variant (workers.ts) shares the same
+// machine with onnxruntime-web, so the two can never drift again.
+import { fileURLToPath } from "node:url";
+import { ErrorCategory, Route, isRecoverable, optionalStringConfig, } from "@kuralle-syrinx/core";
+import { CONTEXT_SAMPLES_16K, Pcm16WindowBuffer, SileroVadStateMachine, readVadTuning, } from "./vad-state-machine.js";
+const DEFAULT_MODEL_PATH = fileURLToPath(new URL("../models/silero_vad.onnx", import.meta.url));
+const DEFAULT_SAMPLE_RATE = 16000;
+export class SileroVADPlugin {
+    bus = null;
+    session = null;
+    ort = null;
+    state = new Float32Array(2 * 1 * 128);
+    context = new Float32Array(CONTEXT_SAMPLES_16K);
+    windows = new Pcm16WindowBuffer();
+    machine = null;
+    sampleRate = DEFAULT_SAMPLE_RATE;
+    disposers = [];
+    async initialize(bus, config) {
+        this.bus = bus;
+        this.sampleRate = readSampleRate(config);
+        this.machine = new SileroVadStateMachine(bus, readVadTuning(config), () => this.resetModelState());
+        const modelPath = optionalStringConfig(config, "model_path") ?? DEFAULT_MODEL_PATH;
+        this.ort = await import("onnxruntime-node");
+        this.session = await this.ort.InferenceSession.create(modelPath, {
+            executionProviders: ["cpu"],
+            interOpNumThreads: 1,
+            intraOpNumThreads: 1,
+        });
+        this.resetModelState();
+        this.machine.noteModelReset();
+        this.disposers.push(bus.on("vad.audio", async (pkt) => {
+            const audioPkt = pkt;
+            await this.processAudio(audioPkt.audio, audioPkt.contextId);
+        }));
+    }
+    async processAudio(audio, contextId) {
+        if (!this.bus || !this.session || !this.ort || !this.machine)
+            return;
+        if (audio.byteLength % 2 !== 0) {
+            this.emitError(contextId, new Error("VAD audio must be 16-bit PCM with even byte length"));
+            return;
+        }
+        // Offset-safe: inbound PCM is often a Uint8Array view into a pooled Node
+        // Buffer at an ODD byteOffset — the shared buffer reads via DataView.
+        this.windows.push(audio);
+        for (let window = this.windows.next(); window; window = this.windows.next()) {
+            const confidence = await this.runModel(window, contextId);
+            this.machine.observe(confidence, contextId);
+        }
+    }
+    async close() {
+        for (const dispose of this.disposers.splice(0))
+            dispose();
+        this.bus = null;
+        this.session = null;
+        this.ort = null;
+        this.windows.clear();
+        this.resetModelState();
+    }
+    async runModel(window, contextId) {
+        if (!this.session || !this.ort)
+            return 0;
+        const input = new Float32Array(CONTEXT_SAMPLES_16K + window.length);
+        input.set(this.context, 0);
+        input.set(window, CONTEXT_SAMPLES_16K);
+        try {
+            const output = await this.session.run({
+                input: new this.ort.Tensor("float32", input, [1, input.length]),
+                state: new this.ort.Tensor("float32", this.state, [2, 1, 128]),
+                sr: new this.ort.Tensor("int64", BigInt64Array.from([BigInt(this.sampleRate)]), []),
+            });
+            const probability = output["output"]?.data?.[0];
+            const nextState = output["stateN"]?.data;
+            if (nextState instanceof Float32Array) {
+                this.state = new Float32Array(nextState);
+            }
+            this.context = input.slice(-CONTEXT_SAMPLES_16K);
+            return typeof probability === "number" ? probability : 0;
+        }
+        catch (err) {
+            this.emitError(contextId, err instanceof Error ? err : new Error(String(err)));
+            return 0;
+        }
+    }
+    resetModelState() {
+        this.state = new Float32Array(2 * 1 * 128);
+        this.context = new Float32Array(CONTEXT_SAMPLES_16K);
+    }
+    emitError(contextId, err) {
+        const packet = {
+            kind: "vad.error",
+            contextId,
+            timestampMs: Date.now(),
+            component: "vad",
+            category: ErrorCategory.InvalidInput,
+            cause: err,
+            isRecoverable: isRecoverable(ErrorCategory.InvalidInput),
+        };
+        this.bus?.push(Route.Critical, packet);
+    }
+}
+function readSampleRate(config) {
+    const value = config["sample_rate"];
+    const sampleRate = typeof value === "number" && Number.isFinite(value) ? value : DEFAULT_SAMPLE_RATE;
+    if (sampleRate !== 16000) {
+        throw new Error(`SileroVADPlugin requires 16 kHz PCM input, got ${String(sampleRate)} Hz`);
+    }
+    return sampleRate;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/vad-state-machine.d.ts

@@ -0,0 +1,37 @@
+import { type PipelineBus, type PluginConfig } from "@kuralle-syrinx/core";
+export declare const WINDOW_SAMPLES_16K = 512;
+export declare const CONTEXT_SAMPLES_16K = 64;
+export interface VadTuning {
+    readonly confidenceThreshold: number;
+    readonly minSilenceDurationMs: number;
+    readonly speechPadMs: number;
+    readonly speechStartDurationMs: number;
+    readonly speakingStateResetIntervalMs: number;
+}
+export declare function readVadTuning(config: PluginConfig): VadTuning;
+/** Accumulates inbound PCM16 bytes and yields normalized 512-sample model windows. */
+export declare class Pcm16WindowBuffer {
+    private pendingSamples;
+    push(audio: Uint8Array): void;
+    next(): Float32Array | null;
+    clear(): void;
+}
+export declare class SileroVadStateMachine {
+    private readonly bus;
+    private readonly tuning;
+    /** Zero the runtime's model state/context tensors; the machine owns when. */
+    private readonly onModelReset;
+    private vadState;
+    private speechFrames;
+    private silenceFrames;
+    private stoppingSpikeFrames;
+    private lastResetMs;
+    constructor(bus: PipelineBus, tuning: VadTuning, 
+    /** Zero the runtime's model state/context tensors; the machine owns when. */
+    onModelReset: () => void);
+    noteModelReset(): void;
+    observe(confidence: number, contextId: string): void;
+    private promoteStartingToSpeakingIfReady;
+    private emitSpeechActivity;
+}
+//# sourceMappingURL=vad-state-machine.d.ts.map

package/dist/vad-state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vad-state-machine.d.ts","sourceRoot":"","sources":["../src/vad-state-machine.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAIlB,MAAM,sBAAsB,CAAC;AAG9B,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAMtC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;CAC/C;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAQ7D;AAED,sFAAsF;AACtF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,cAAc,CAAgB;IAEtC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAO7B,IAAI,IAAI,YAAY,GAAG,IAAI;IAS3B,KAAK,IAAI,IAAI;CAGd;AAED,qBAAa,qBAAqB;IAQ9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,YAAY;IAV/B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,WAAW,CAAc;gBAGd,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,SAAS;IAClC,6EAA6E;IAC5D,YAAY,EAAE,MAAM,IAAI;IAG3C,cAAc,IAAI,IAAI;IAItB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAuGpD,OAAO,CAAC,gCAAgC;IA6BxC,OAAO,CAAC,kBAAkB;CAS3B"}

package/dist/vad-state-machine.js

@@ -0,0 +1,202 @@
+// SPDX-License-Identifier: MIT
+//
+// Shared Silero VAD turn state machine + PCM windowing — the single source of
+// truth for both the Node (onnxruntime-node) and Workers (onnxruntime-web)
+// plugins. The two runtimes differ only in how the ONNX session is created and
+// where the model bytes come from; everything that decides "is the user
+// speaking" lives here so the variants can never drift again (v2.1.0 shipped
+// the telephony saturation hardening in the Node copy only).
+import { Route, } from "@kuralle-syrinx/core";
+import { pcm16BytesToSamples } from "@kuralle-syrinx/core/audio";
+export const WINDOW_SAMPLES_16K = 512;
+export const CONTEXT_SAMPLES_16K = 64;
+const QUIET_MODEL_RESET_INTERVAL_MS = 5000;
+export function readVadTuning(config) {
+    return {
+        confidenceThreshold: readNumber(config, "threshold", 0.5),
+        minSilenceDurationMs: readNumber(config, "min_silence_duration_ms", 200),
+        speechPadMs: readNumber(config, "speech_pad_ms", 80),
+        speechStartDurationMs: readNumber(config, "speech_start_duration_ms", 32),
+        speakingStateResetIntervalMs: readNumber(config, "speaking_state_reset_interval_ms", 12_000),
+    };
+}
+/** Accumulates inbound PCM16 bytes and yields normalized 512-sample model windows. */
+export class Pcm16WindowBuffer {
+    pendingSamples = [];
+    push(audio) {
+        const samples = pcm16BytesToSamples(audio);
+        for (let i = 0; i < samples.length; i += 1) {
+            this.pendingSamples.push(samples[i] / 32768);
+        }
+    }
+    next() {
+        if (this.pendingSamples.length < WINDOW_SAMPLES_16K)
+            return null;
+        const window = new Float32Array(WINDOW_SAMPLES_16K);
+        for (let i = 0; i < WINDOW_SAMPLES_16K; i += 1) {
+            window[i] = this.pendingSamples.shift();
+        }
+        return window;
+    }
+    clear() {
+        this.pendingSamples = [];
+    }
+}
+export class SileroVadStateMachine {
+    bus;
+    tuning;
+    onModelReset;
+    vadState = "quiet";
+    speechFrames = 0;
+    silenceFrames = 0;
+    stoppingSpikeFrames = 0;
+    lastResetMs = Date.now();
+    constructor(bus, tuning, 
+    /** Zero the runtime's model state/context tensors; the machine owns when. */
+    onModelReset) {
+        this.bus = bus;
+        this.tuning = tuning;
+        this.onModelReset = onModelReset;
+    }
+    noteModelReset() {
+        this.lastResetMs = Date.now();
+    }
+    observe(confidence, contextId) {
+        const now = Date.now();
+        // Long-quiet model reset: keep the LSTM fresh between utterances.
+        if (this.vadState === "quiet" && now - this.lastResetMs >= QUIET_MODEL_RESET_INTERVAL_MS) {
+            this.onModelReset();
+            this.lastResetMs = now;
+        }
+        const isSpeech = confidence >= this.tuning.confidenceThreshold;
+        const silenceFrameTarget = Math.max(1, Math.ceil(this.tuning.minSilenceDurationMs / 32));
+        switch (this.vadState) {
+            case "quiet":
+                if (isSpeech) {
+                    this.vadState = "starting";
+                    this.speechFrames = 1;
+                    this.promoteStartingToSpeakingIfReady(confidence, contextId, now);
+                }
+                break;
+            case "starting":
+                if (isSpeech) {
+                    if (!this.promoteStartingToSpeakingIfReady(confidence, contextId, now)) {
+                        this.speechFrames += 1;
+                        this.promoteStartingToSpeakingIfReady(confidence, contextId, now);
+                    }
+                }
+                else {
+                    this.vadState = "quiet";
+                    this.speechFrames = 0;
+                }
+                break;
+            case "speaking":
+                if (isSpeech) {
+                    // Silero v5 LSTM state saturates on long continuous segments
+                    // (telephony monologues): confidence then flaps high through genuine
+                    // silence and the end never fires. Periodically reset model state
+                    // mid-speech; the spike debounce in "stopping" makes the brief
+                    // post-reset confidence dip harmless for real speech.
+                    if (now - this.lastResetMs >= this.tuning.speakingStateResetIntervalMs) {
+                        this.onModelReset();
+                        this.lastResetMs = now;
+                        this.bus.push(Route.Main, {
+                            kind: "metric.conversation",
+                            contextId,
+                            timestampMs: now,
+                            name: "vad.state_reset_in_speech",
+                            value: "1",
+                        });
+                    }
+                    this.emitSpeechActivity(contextId, now);
+                }
+                else {
+                    this.vadState = "stopping";
+                    this.silenceFrames = 1;
+                    this.stoppingSpikeFrames = 0;
+                }
+                break;
+            case "stopping":
+                if (isSpeech) {
+                    // Single-frame confidence spikes are a known Silero failure mode on
+                    // long telephony segments (state saturation flaps high through real
+                    // silence). Require sustained speech to leave "stopping" so one
+                    // spike cannot reset the silence countdown forever.
+                    this.stoppingSpikeFrames += 1;
+                    if (this.stoppingSpikeFrames >= 2) {
+                        this.vadState = "speaking";
+                        this.silenceFrames = 0;
+                        this.stoppingSpikeFrames = 0;
+                        this.emitSpeechActivity(contextId, now);
+                    }
+                    break;
+                }
+                this.stoppingSpikeFrames = 0;
+                this.silenceFrames += 1;
+                if (this.silenceFrames * 32 < this.tuning.minSilenceDurationMs + this.tuning.speechPadMs)
+                    break;
+                if (this.silenceFrames < silenceFrameTarget)
+                    break;
+                {
+                    const hangoverMs = this.silenceFrames * 32;
+                    this.vadState = "quiet";
+                    this.silenceFrames = 0;
+                    this.speechFrames = 0;
+                    this.stoppingSpikeFrames = 0;
+                    const ended = {
+                        kind: "vad.speech_ended",
+                        contextId,
+                        timestampMs: now,
+                    };
+                    this.bus.push(Route.Main, ended);
+                    this.bus.push(Route.Main, {
+                        kind: "metric.conversation",
+                        contextId,
+                        timestampMs: now,
+                        name: "vad.stop_hangover_ms",
+                        value: String(hangoverMs),
+                    });
+                }
+                break;
+        }
+    }
+    promoteStartingToSpeakingIfReady(confidence, contextId, now) {
+        if (this.vadState !== "starting")
+            return false;
+        if (this.speechFrames * 32 < this.tuning.speechStartDurationMs)
+            return false;
+        const startDelayMs = this.speechFrames * 32;
+        this.vadState = "speaking";
+        this.speechFrames = 0;
+        const started = {
+            kind: "vad.speech_started",
+            contextId,
+            timestampMs: now,
+            confidence,
+        };
+        this.bus.push(Route.Main, started);
+        this.bus.push(Route.Main, {
+            kind: "metric.conversation",
+            contextId,
+            timestampMs: now,
+            name: "vad.start_delay_ms",
+            value: String(startDelayMs),
+        });
+        this.emitSpeechActivity(contextId, now);
+        return true;
+    }
+    emitSpeechActivity(contextId, now) {
+        const activity = {
+            kind: "vad.speech_activity",
+            contextId,
+            timestampMs: now,
+            isAsync: true,
+        };
+        this.bus.push(Route.Main, activity);
+    }
+}
+function readNumber(config, key, fallback) {
+    const value = config[key];
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+//# sourceMappingURL=vad-state-machine.js.map

package/dist/vad-state-machine.js.map

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

package/dist/workers.d.ts

@@ -0,0 +1,20 @@
+import type { PipelineBus } from "@kuralle-syrinx/core";
+import { type PluginConfig, type VoicePlugin } from "@kuralle-syrinx/core";
+export declare class SileroVADPlugin implements VoicePlugin {
+    private bus;
+    private session;
+    private ort;
+    private state;
+    private context;
+    private readonly windows;
+    private machine;
+    private sampleRate;
+    private disposers;
+    initialize(bus: PipelineBus, config: PluginConfig): Promise<void>;
+    processAudio(audio: Uint8Array, contextId: string): Promise<void>;
+    close(): Promise<void>;
+    private runModel;
+    private resetModelState;
+    private emitError;
+}
+//# sourceMappingURL=workers.d.ts.map

package/dist/workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../src/workers.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAGL,KAAK,YAAY,EAEjB,KAAK,WAAW,EAGjB,MAAM,sBAAsB,CAAC;AAa9B,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,SAAS,CAAyB;IAEpC,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjE,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YASd,QAAQ;IA4BtB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,SAAS;CAYlB"}

package/dist/workers.js

@@ -0,0 +1,124 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Silero VAD Plugin (Cloudflare Workers, onnxruntime-web)
+//
+// Same plugin as ./index.ts but for workerd: WASM execution provider and model
+// bytes supplied via `model_bytes` or fetched from `model_url` (no filesystem).
+// All turn/state decisions live in the shared SileroVadStateMachine
+// (vad-state-machine.ts), so the Node and Workers variants can never drift.
+import { ErrorCategory, Route, isRecoverable, optionalStringConfig, } from "@kuralle-syrinx/core";
+import { CONTEXT_SAMPLES_16K, Pcm16WindowBuffer, SileroVadStateMachine, readVadTuning, } from "./vad-state-machine.js";
+const DEFAULT_SAMPLE_RATE = 16000;
+export class SileroVADPlugin {
+    bus = null;
+    session = null;
+    ort = null;
+    state = new Float32Array(2 * 1 * 128);
+    context = new Float32Array(CONTEXT_SAMPLES_16K);
+    windows = new Pcm16WindowBuffer();
+    machine = null;
+    sampleRate = DEFAULT_SAMPLE_RATE;
+    disposers = [];
+    async initialize(bus, config) {
+        this.bus = bus;
+        this.sampleRate = readSampleRate(config);
+        this.machine = new SileroVadStateMachine(bus, readVadTuning(config), () => this.resetModelState());
+        this.ort = await import("onnxruntime-web");
+        this.session = await this.ort.InferenceSession.create(await readModelBytes(config), {
+            executionProviders: ["wasm"],
+        });
+        this.resetModelState();
+        this.machine.noteModelReset();
+        this.disposers.push(bus.on("vad.audio", async (pkt) => {
+            const audioPkt = pkt;
+            await this.processAudio(audioPkt.audio, audioPkt.contextId);
+        }));
+    }
+    async processAudio(audio, contextId) {
+        if (!this.bus || !this.session || !this.ort || !this.machine)
+            return;
+        if (audio.byteLength % 2 !== 0) {
+            this.emitError(contextId, new Error("VAD audio must be 16-bit PCM with even byte length"));
+            return;
+        }
+        this.windows.push(audio);
+        for (let window = this.windows.next(); window; window = this.windows.next()) {
+            const confidence = await this.runModel(window, contextId);
+            this.machine.observe(confidence, contextId);
+        }
+    }
+    async close() {
+        for (const dispose of this.disposers.splice(0))
+            dispose();
+        this.bus = null;
+        this.session = null;
+        this.ort = null;
+        this.windows.clear();
+        this.resetModelState();
+    }
+    async runModel(window, contextId) {
+        if (!this.session || !this.ort)
+            return 0;
+        const input = new Float32Array(CONTEXT_SAMPLES_16K + window.length);
+        input.set(this.context, 0);
+        input.set(window, CONTEXT_SAMPLES_16K);
+        try {
+            const output = await this.session.run({
+                input: new this.ort.Tensor("float32", input, [1, input.length]),
+                state: new this.ort.Tensor("float32", this.state, [2, 1, 128]),
+                sr: new this.ort.Tensor("int64", BigInt64Array.from([BigInt(this.sampleRate)]), []),
+            });
+            const probability = output["output"]?.data?.[0];
+            const nextState = output["stateN"]?.data;
+            if (nextState instanceof Float32Array) {
+                this.state = new Float32Array(nextState);
+            }
+            this.context = input.slice(-CONTEXT_SAMPLES_16K);
+            return typeof probability === "number" ? probability : 0;
+        }
+        catch (err) {
+            this.emitError(contextId, err instanceof Error ? err : new Error(String(err)));
+            return 0;
+        }
+    }
+    resetModelState() {
+        this.state = new Float32Array(2 * 1 * 128);
+        this.context = new Float32Array(CONTEXT_SAMPLES_16K);
+    }
+    emitError(contextId, err) {
+        const packet = {
+            kind: "vad.error",
+            contextId,
+            timestampMs: Date.now(),
+            component: "vad",
+            category: ErrorCategory.InvalidInput,
+            cause: err,
+            isRecoverable: isRecoverable(ErrorCategory.InvalidInput),
+        };
+        this.bus?.push(Route.Critical, packet);
+    }
+}
+async function readModelBytes(config) {
+    const bytes = config["model_bytes"];
+    if (bytes instanceof Uint8Array)
+        return bytes;
+    if (bytes instanceof ArrayBuffer)
+        return new Uint8Array(bytes);
+    const modelUrl = optionalStringConfig(config, "model_url");
+    if (!modelUrl) {
+        throw new Error("SileroVADPlugin on Workers requires model_bytes or model_url");
+    }
+    const response = await fetch(modelUrl);
+    if (!response.ok)
+        throw new Error(`Failed to fetch Silero model: ${String(response.status)}`);
+    return new Uint8Array(await response.arrayBuffer());
+}
+function readSampleRate(config) {
+    const value = config["sample_rate"];
+    const sampleRate = typeof value === "number" && Number.isFinite(value) ? value : DEFAULT_SAMPLE_RATE;
+    if (sampleRate !== 16000) {
+        throw new Error(`SileroVADPlugin requires 16 kHz PCM input, got ${String(sampleRate)} Hz`);
+    }
+    return sampleRate;
+}
+//# sourceMappingURL=workers.js.map

package/dist/workers.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuralle-syrinx/silero-vad",
-  "version": "4.4.1",
+  "version": "4.5.0",
   "private": false,
   "description": "Silero VAD plugin for Syrinx — ONNX voice activity detection for Node and Workers",
   "keywords": [
@@ -23,23 +23,36 @@
     "url": "https://github.com/kuralle/syrinx/issues"
   },
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./workers": "./src/workers.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./workers": {
+      "types": "./dist/workers.d.ts",
+      "default": "./dist/workers.js"
+    }
   },
   "dependencies": {
     "onnxruntime-node": "1.24.3",
     "onnxruntime-web": "1.24.3",
-    "@kuralle-syrinx/core": "4.4.1"
+    "@kuralle-syrinx/core": "4.5.0"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "typescript": "^5.7.0",
     "vitest": "^3.2.6"
   },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "test": "vitest run",
+    "build": "tsc -p tsconfig.build.json"
   }
 }

package/src/index.test.ts

@@ -0,0 +1,329 @@
+// SPDX-License-Identifier: MIT
+
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import type { PipelineBus } from "@kuralle-syrinx/core";
+
+import { SileroVADPlugin } from "./index.js";
+
+// Shared mutable state that the vi.mock factory can close over via vi.hoisted.
+const mockControl = vi.hoisted(() => ({
+  confidence: 0.9,
+  stateCallArgs: [] as Float32Array[],
+}));
+
+vi.mock("onnxruntime-node", () => {
+  // Minimal Tensor stand-in — stores data so session.run() can read it back.
+  function MockTensor(
+    this: { data: unknown },
+    _type: string,
+    data: unknown,
+    _shape: unknown,
+  ) {
+    this.data = data;
+  }
+
+  const run = vi.fn(async (inputs: Record<string, { data: unknown }>) => {
+    const state = inputs["state"]?.data;
+    if (state instanceof Float32Array) {
+      mockControl.stateCallArgs.push(new Float32Array(state));
+    }
+    // Return a distinctive non-zero state so a subsequent reset is detectable.
+    return {
+      output: { data: [mockControl.confidence] },
+      stateN: { data: new Float32Array(2 * 1 * 128).fill(0.5) },
+    };
+  });
+
+  return {
+    InferenceSession: { create: vi.fn(async () => ({ run })) },
+    Tensor: MockTensor,
+  };
+});
+
+// ── helpers ────────────────────────────────────────────────────────────────
+
+function makeBus(): { bus: PipelineBus; emitted: Array<{ kind: string }> } {
+  const emitted: Array<{ kind: string }> = [];
+  const bus = {
+    push(_route: unknown, pkt: unknown) {
+      emitted.push(pkt as { kind: string });
+    },
+    on(_event: string, _handler: unknown) {
+      return () => {};
+    },
+  } as unknown as PipelineBus;
+  return { bus, emitted };
+}
+
+/** 512-sample (32 ms) silent PCM frame — value irrelevant since model is mocked. */
+function makePcmFrame(): Uint8Array {
+  return new Uint8Array(512 * 2);
+}
+
+async function initPlugin(
+  bus: PipelineBus,
+  config: Record<string, unknown> = {},
+): Promise<SileroVADPlugin> {
+  const plugin = new SileroVADPlugin();
+  await plugin.initialize(bus, { model_path: "/dev/null", ...config });
+  return plugin;
+}
+
+function countKind(emitted: Array<{ kind: string }>, kind: string): number {
+  return emitted.filter((p) => p.kind === kind).length;
+}
+
+function metricValue(
+  emitted: Array<{ kind: string; name?: string; value?: string }>,
+  name: string,
+): string | undefined {
+  return emitted.find((p) => p.kind === "metric.conversation" && p.name === name)?.value;
+}
+
+// ── tests ──────────────────────────────────────────────────────────────────
+
+describe("SileroVADPlugin — G11: periodic state reset gating", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+    vi.setSystemTime(0);
+    mockControl.confidence = 0.9;
+    mockControl.stateCallArgs.length = 0;
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it("does not reset model state mid-speech when the 5 s timer elapses", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus);
+
+    // Frame 1 (T=0): confidence=0.9 → speech_started, vadState=speaking.
+    // stateCallArgs[0] = all-zeros (initial state).
+    await plugin.processAudio(makePcmFrame(), "ctx-1");
+    expect(emitted.some((p) => p.kind === "vad.speech_started")).toBe(true);
+
+    // Advance past the 5 s reset boundary while still speaking.
+    vi.setSystemTime(6000);
+
+    // Frame 2 (T=6000): fix must skip the reset because vadState=speaking.
+    // stateCallArgs[1] = [0.5...] (state updated by frame 1 output).
+    // After this call, state stays [0.5...] (no reset).
+    await plugin.processAudio(makePcmFrame(), "ctx-1");
+
+    // Frame 3 (T=6000): if a reset had fired after frame 2, this call would
+    // receive all-zero state.  With the fix it receives the non-zero value.
+    await plugin.processAudio(makePcmFrame(), "ctx-1");
+
+    expect(emitted.some((p) => p.kind === "vad.speech_ended")).toBe(false);
+
+    // State entering frame 3 must still carry the non-zero value from the mock
+    // (0.5), proving no mid-speech reset occurred.
+    const stateAtFrame3 = mockControl.stateCallArgs[2];
+    expect(stateAtFrame3).toBeDefined();
+    expect(stateAtFrame3!.some((v) => v !== 0)).toBe(true);
+
+    await plugin.close();
+  });
+
+  it("resets model state at the 5 s boundary once speech has ended", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus);
+
+    // Frame 1 (T=0): speech starts.
+    mockControl.confidence = 0.9;
+    await plugin.processAudio(makePcmFrame(), "ctx-2");
+    expect(emitted.some((p) => p.kind === "vad.speech_started")).toBe(true);
+
+    // Switch to silence. silenceFrameTarget = ceil(200/32) = 7; speech ends when
+    // silenceFrames*32 >= minSilenceDurationMs(200) + speechPadMs(80) = 280 ms,
+    // i.e. after 9 consecutive silence frames (9*32=288 >= 280).
+    mockControl.confidence = 0.1;
+    for (let i = 0; i < 9; i++) {
+      await plugin.processAudio(makePcmFrame(), "ctx-2");
+    }
+    expect(emitted.some((p) => p.kind === "vad.speech_ended")).toBe(true);
+
+    // Time has not advanced yet; no reset should have fired (0 - 0 < 5000).
+    // Now advance past the reset window.
+    vi.setSystemTime(6000);
+
+    // Frame at T=6000 (not speaking): reset fires after this run call.
+    await plugin.processAudio(makePcmFrame(), "ctx-2");
+
+    // One more frame: should receive all-zero state because the reset zeroed it.
+    await plugin.processAudio(makePcmFrame(), "ctx-2");
+
+    const lastStateArg = mockControl.stateCallArgs.at(-1);
+    expect(lastStateArg).toBeDefined();
+    expect(lastStateArg!.every((v) => v === 0)).toBe(true);
+
+    await plugin.close();
+  });
+});
+
+describe("SileroVADPlugin — four-state VAD (VE-02)", () => {
+  beforeEach(() => {
+    mockControl.confidence = 0.9;
+    mockControl.stateCallArgs.length = 0;
+  });
+
+  it("vad_flap_rejected: sub-threshold speech burst does not emit speech_started", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus, { speech_start_duration_ms: 96 });
+
+    mockControl.confidence = 0.9;
+    await plugin.processAudio(makePcmFrame(), "ctx-flap");
+
+    mockControl.confidence = 0.1;
+    await plugin.processAudio(makePcmFrame(), "ctx-flap");
+
+    expect(countKind(emitted, "vad.speech_started")).toBe(0);
+    expect(metricValue(emitted, "vad.start_delay_ms")).toBeUndefined();
+
+    await plugin.close();
+  });
+
+  it("vad_full_cycle: sustained speech then silence emits one start and one end", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus);
+
+    mockControl.confidence = 0.9;
+    for (let i = 0; i < 4; i++) {
+      await plugin.processAudio(makePcmFrame(), "ctx-cycle");
+    }
+    expect(countKind(emitted, "vad.speech_started")).toBe(1);
+    expect(metricValue(emitted, "vad.start_delay_ms")).toBe("32");
+
+    mockControl.confidence = 0.1;
+    for (let i = 0; i < 9; i++) {
+      await plugin.processAudio(makePcmFrame(), "ctx-cycle");
+    }
+    expect(countKind(emitted, "vad.speech_ended")).toBe(1);
+    expect(metricValue(emitted, "vad.stop_hangover_ms")).toBe("288");
+
+    await plugin.close();
+  });
+
+  it("vad_resume_no_end: brief silence dip during speech does not emit speech_ended", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus);
+
+    mockControl.confidence = 0.9;
+    await plugin.processAudio(makePcmFrame(), "ctx-resume");
+    expect(countKind(emitted, "vad.speech_started")).toBe(1);
+
+    mockControl.confidence = 0.1;
+    for (let i = 0; i < 3; i++) {
+      await plugin.processAudio(makePcmFrame(), "ctx-resume");
+    }
+    expect(countKind(emitted, "vad.speech_ended")).toBe(0);
+
+    mockControl.confidence = 0.9;
+    await plugin.processAudio(makePcmFrame(), "ctx-resume");
+    expect(countKind(emitted, "vad.speech_ended")).toBe(0);
+    expect(countKind(emitted, "vad.speech_started")).toBe(1);
+
+    await plugin.close();
+  });
+
+  it("default speech_start_duration_ms emits speech_started on the first speech frame", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus);
+
+    mockControl.confidence = 0.9;
+    await plugin.processAudio(makePcmFrame(), "ctx-default");
+
+    expect(countKind(emitted, "vad.speech_started")).toBe(1);
+    expect(metricValue(emitted, "vad.start_delay_ms")).toBe("32");
+
+    await plugin.close();
+  });
+});
+
+describe("SileroVADPlugin — odd byteOffset PCM (browser buffer alignment)", () => {
+  beforeEach(() => {
+    mockControl.confidence = 0.9;
+    mockControl.stateCallArgs.length = 0;
+  });
+
+  it("processes a PCM frame whose byteOffset is odd without throwing", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus);
+
+    // Inbound browser PCM is frequently a Uint8Array view into a pooled Node
+    // Buffer at an ODD byteOffset. `new Int16Array(buffer, oddOffset, …)` throws
+    // "start offset of Int16Array should be a multiple of 2" — this reproduces it.
+    const backing = new Uint8Array(512 * 2 + 1);
+    const oddOffsetFrame = backing.subarray(1); // byteOffset 1 (odd), even length
+    expect(oddOffsetFrame.byteOffset % 2).toBe(1);
+
+    await expect(plugin.processAudio(oddOffsetFrame, "ctx-odd")).resolves.toBeUndefined();
+    expect(emitted.some((p) => p.kind === "vad.error")).toBe(false);
+    // Reached the model and emitted a VAD verdict — proof the frame was processed.
+    expect(emitted.some((p) => p.kind === "vad.speech_started")).toBe(true);
+
+    await plugin.close();
+  });
+});
+
+describe("SileroVADPlugin — telephony saturation hardening", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+    vi.setSystemTime(0);
+    mockControl.confidence = 0.9;
+    mockControl.stateCallArgs.length = 0;
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  async function frame(plugin: SileroVADPlugin, confidence: number): Promise<void> {
+    mockControl.confidence = confidence;
+    await plugin.processAudio(makePcmFrame(), "ctx-flap");
+  }
+
+  it("absorbs single-frame confidence spikes during stopping so speech still ends", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus);
+
+    await frame(plugin, 0.9); // speech_started → speaking
+    expect(countKind(emitted, "vad.speech_started")).toBe(1);
+
+    // Saturation flap: real silence with an isolated spike in the middle.
+    for (const confidence of [0.2, 0.2, 0.2, 0.2, 0.9, 0.2, 0.2, 0.2, 0.2, 0.2]) {
+      await frame(plugin, confidence);
+    }
+
+    expect(countKind(emitted, "vad.speech_ended")).toBe(1);
+    expect(metricValue(emitted, "vad.stop_hangover_ms")).toBeDefined();
+  });
+
+  it("two consecutive speech frames during stopping resume speaking (real speech is unaffected)", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus);
+
+    await frame(plugin, 0.9); // speaking
+    for (const confidence of [0.2, 0.2, 0.2]) await frame(plugin, confidence); // stopping
+    for (const confidence of [0.9, 0.9]) await frame(plugin, confidence); // sustained speech → resume
+    expect(countKind(emitted, "vad.speech_ended")).toBe(0);
+
+    for (let i = 0; i < 9; i += 1) await frame(plugin, 0.2); // genuine end
+    expect(countKind(emitted, "vad.speech_ended")).toBe(1);
+  });
+
+  it("resets model state during prolonged continuous speech (saturation guard)", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus);
+
+    await frame(plugin, 0.9); // speaking, state seeded
+    vi.setSystemTime(13_000); // past speaking_state_reset_interval_ms (12 s)
+    await frame(plugin, 0.9); // reset fires after this frame's inference
+    await frame(plugin, 0.9); // this inference must receive the zeroed state
+
+    expect(metricValue(emitted, "vad.state_reset_in_speech")).toBe("1");
+    const stateForThirdFrame = mockControl.stateCallArgs[2]!;
+    expect(stateForThirdFrame.every((value) => value === 0)).toBe(true);
+  });
+});

package/src/workers.test.ts

@@ -0,0 +1,124 @@
+// SPDX-License-Identifier: MIT
+
+import { beforeEach, afterEach, describe, expect, it, vi } from "vitest";
+import type { PipelineBus } from "@kuralle-syrinx/core";
+
+import { SileroVADPlugin } from "./workers.js";
+
+const mockControl = vi.hoisted(() => ({
+  confidence: 0.9,
+  stateCallArgs: [] as Float32Array[],
+}));
+
+vi.mock("onnxruntime-web", () => {
+  function MockTensor(this: { data: unknown }, _type: string, data: unknown, _shape: unknown) {
+    this.data = data;
+  }
+  const run = vi.fn(async (inputs: Record<string, { data: unknown }>) => {
+    const state = inputs["state"]?.data;
+    if (state instanceof Float32Array) {
+      mockControl.stateCallArgs.push(new Float32Array(state));
+    }
+    return {
+      output: { data: [mockControl.confidence] },
+      stateN: { data: new Float32Array(2 * 1 * 128).fill(0.5) },
+    };
+  });
+  return {
+    InferenceSession: { create: vi.fn(async () => ({ run })) },
+    Tensor: MockTensor,
+  };
+});
+
+function makeBus(): { bus: PipelineBus; emitted: Array<{ kind: string }> } {
+  const emitted: Array<{ kind: string }> = [];
+  const bus = {
+    push(_route: unknown, pkt: unknown) {
+      emitted.push(pkt as { kind: string });
+    },
+    on(_event: string, _handler: unknown) {
+      return () => {};
+    },
+  } as unknown as PipelineBus;
+  return { bus, emitted };
+}
+
+function makePcmFrame(): Uint8Array {
+  return new Uint8Array(512 * 2);
+}
+
+async function initPlugin(bus: PipelineBus, config: Record<string, unknown> = {}): Promise<SileroVADPlugin> {
+  const plugin = new SileroVADPlugin();
+  await plugin.initialize(bus, { model_bytes: new Uint8Array(8), ...config });
+  return plugin;
+}
+
+function countKind(emitted: Array<{ kind: string }>, kind: string): number {
+  return emitted.filter((p) => p.kind === kind).length;
+}
+
+function metricValue(
+  emitted: Array<{ kind: string; name?: string; value?: string }>,
+  name: string,
+): string | undefined {
+  return emitted.find((p) => p.kind === "metric.conversation" && p.name === name)?.value;
+}
+
+describe("SileroVADPlugin (Workers) — shared state machine parity", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+    vi.setSystemTime(0);
+    mockControl.confidence = 0.9;
+    mockControl.stateCallArgs.length = 0;
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  async function frame(plugin: SileroVADPlugin, confidence: number): Promise<void> {
+    mockControl.confidence = confidence;
+    await plugin.processAudio(makePcmFrame(), "ctx-w");
+  }
+
+  it("absorbs single-frame confidence spikes during stopping so speech still ends", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus);
+
+    await frame(plugin, 0.9);
+    expect(countKind(emitted, "vad.speech_started")).toBe(1);
+
+    for (const confidence of [0.2, 0.2, 0.2, 0.2, 0.9, 0.2, 0.2, 0.2, 0.2, 0.2]) {
+      await frame(plugin, confidence);
+    }
+
+    expect(countKind(emitted, "vad.speech_ended")).toBe(1);
+    expect(metricValue(emitted, "vad.stop_hangover_ms")).toBeDefined();
+  });
+
+  it("resets model state during prolonged continuous speech (saturation guard)", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus);
+
+    await frame(plugin, 0.9);
+    vi.setSystemTime(13_000);
+    await frame(plugin, 0.9);
+    await frame(plugin, 0.9);
+
+    expect(metricValue(emitted, "vad.state_reset_in_speech")).toBe("1");
+    expect(mockControl.stateCallArgs[2]!.every((value) => value === 0)).toBe(true);
+  });
+
+  it("two consecutive speech frames during stopping resume speaking", async () => {
+    const { bus, emitted } = makeBus();
+    const plugin = await initPlugin(bus);
+
+    await frame(plugin, 0.9);
+    for (const confidence of [0.2, 0.2, 0.2]) await frame(plugin, confidence);
+    for (const confidence of [0.9, 0.9]) await frame(plugin, confidence);
+    expect(countKind(emitted, "vad.speech_ended")).toBe(0);
+
+    for (let i = 0; i < 9; i += 1) await frame(plugin, 0.2);
+    expect(countKind(emitted, "vad.speech_ended")).toBe(1);
+  });
+});