@kuralle-syrinx/google 4.4.0 → 4.5.0

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import { type PipelineBus, type PluginConfig, type VoicePlugin } from "@kuralle-syrinx/core";
+import type { SocketFactory } from "@kuralle-syrinx/ws";
+export declare class GoogleSTTPlugin implements VoicePlugin {
+    private readonly socketFactory?;
+    readonly endpointingCapability: {
+        owner: "provider_stt";
+        disableConfig: {
+            emit_eos_on_final: boolean;
+        };
+    };
+    constructor(socketFactory?: SocketFactory | undefined);
+    private session;
+    initialize(bus: PipelineBus, config: PluginConfig): Promise<void>;
+    close(): Promise<void>;
+}
+//# 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":"AAWA,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAsEpE,qBAAa,eAAgB,YAAW,WAAW;IAQrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAP3C,QAAQ,CAAC,qBAAqB;;;;;MAK5B;gBAE2B,aAAa,CAAC,EAAE,aAAa,YAAA;IAE1D,OAAO,CAAC,OAAO,CAAoC;IAE7C,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA+EjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/index.js

@@ -0,0 +1,208 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Google Cloud Speech-to-Text Plugin
+//
+// Uses Google Cloud Speech-to-Text v2 REST API for streaming recognition.
+// Wire protocol + lifecycle live in @kuralle-syrinx/stt-core; this file is
+// the Google connect/config/decode surface only.
+//
+// Reference: Rapida transformer/google/stt.go (GCP Speech-to-Text v2 API)
+// Reference: https://cloud.google.com/speech-to-text/v2/docs/streaming-recognize
+import { Route, assertAudioFormat, optionalStringConfig, readProviderRetryConfig, requireStringConfig, } from "@kuralle-syrinx/core";
+import { defaultNodeSocketFactory, startStreamingSttSession, } from "@kuralle-syrinx/stt-core";
+class GoogleSttWireProtocol {
+    configMsg;
+    confidenceThreshold;
+    onMetric;
+    constructor(configMsg, confidenceThreshold, onMetric) {
+        this.configMsg = configMsg;
+        this.confidenceThreshold = confidenceThreshold;
+        this.onMetric = onMetric;
+    }
+    onOpen() {
+        return [JSON.stringify(this.configMsg)];
+    }
+    encodeFinalize(_contextId) {
+        return [];
+    }
+    decode(data, _isBinary) {
+        if (typeof data !== "string")
+            return [];
+        let msg;
+        try {
+            msg = JSON.parse(data);
+        }
+        catch {
+            // Provider keepalives or malformed transient messages are ignored.
+            return [];
+        }
+        const results = msg.results;
+        if (!Array.isArray(results) || results.length === 0)
+            return [];
+        const events = [];
+        for (const result of results) {
+            const r = result;
+            const alt = r.alternatives?.[0];
+            if (!alt?.transcript)
+                continue;
+            const text = String(alt.transcript).trim();
+            if (!text)
+                continue;
+            const confidence = alt.confidence ?? 0;
+            if (this.confidenceThreshold > 0 && confidence < this.confidenceThreshold) {
+                this.onMetric("stt_low_confidence", String(confidence));
+                continue;
+            }
+            if (r.isFinal === true) {
+                const audioSeconds = parseDurationSeconds(r.resultEndOffset ?? r.resultEndTime);
+                events.push({
+                    type: "final",
+                    contextId: "",
+                    text,
+                    confidence,
+                    speechFinal: true,
+                    ...(audioSeconds !== null && audioSeconds > 0 ? { audioSeconds } : {}),
+                });
+            }
+            else {
+                events.push({ type: "interim", contextId: "", text });
+            }
+        }
+        return events;
+    }
+}
+export class GoogleSTTPlugin {
+    socketFactory;
+    endpointingCapability = {
+        owner: "provider_stt",
+        disableConfig: {
+            emit_eos_on_final: false,
+        },
+    };
+    constructor(socketFactory) {
+        this.socketFactory = socketFactory;
+    }
+    session = null;
+    async initialize(bus, config) {
+        const apiKey = requireStringConfig(config, "api_key");
+        const projectId = requireStringConfig(config, "project_id");
+        const languageCode = optionalStringConfig(config, "language") ?? "en-US";
+        const languageCodes = readStringList(config["language_codes"]) ?? [languageCode];
+        const model = optionalStringConfig(config, "model") ?? "latest_long";
+        const endpointUrl = optionalStringConfig(config, "endpoint_url");
+        const location = optionalStringConfig(config, "location") ?? "global";
+        const recognizerId = optionalStringConfig(config, "recognizer") ?? "_";
+        const sampleRate = config["sample_rate"] ?? 16000;
+        const encoding = optionalStringConfig(config, "encoding") ?? "LINEAR16";
+        const audioChannelCount = typeof config["channels"] === "number" && Number.isFinite(config["channels"])
+            ? Math.max(1, Math.floor(config["channels"]))
+            : 1;
+        const enableAutomaticPunctuation = config["enable_automatic_punctuation"] ?? true;
+        const enableWordConfidence = config["enable_word_confidence"] ?? true;
+        const interimResults = config["interim_results"] ?? true;
+        const recognitionFeatures = readPlainObject(config["recognition_features"]);
+        const streamingFeatures = readPlainObject(config["streaming_features"]);
+        const confidenceThreshold = config["confidence_threshold"] ?? 0;
+        const emitEosOnFinal = config["emit_eos_on_final"] ?? true;
+        const recognizerPath = `projects/${projectId}/locations/${location}/recognizers/${recognizerId}`;
+        const audioFormat = {
+            encoding: "pcm_s16le",
+            sampleRateHz: sampleRate,
+            channels: 1,
+        };
+        assertAudioFormat(audioFormat);
+        const configMsg = {
+            recognizer: recognizerPath,
+            streamingConfig: {
+                config: {
+                    explicitDecodingConfig: {
+                        encoding,
+                        sampleRateHertz: sampleRate,
+                        audioChannelCount,
+                    },
+                    languageCodes,
+                    model,
+                    features: {
+                        enableAutomaticPunctuation,
+                        enableWordConfidence,
+                        ...recognitionFeatures,
+                    },
+                },
+                streamingFeatures: {
+                    interimResults,
+                    ...streamingFeatures,
+                },
+            },
+        };
+        this.session = await startStreamingSttSession(bus, {
+            protocol: new GoogleSttWireProtocol(configMsg, confidenceThreshold, (name, value) => {
+                bus.push(Route.Background, {
+                    kind: "metric.conversation",
+                    contextId: "",
+                    timestampMs: Date.now(),
+                    name,
+                    value,
+                });
+            }),
+            provider: { name: "google", model, region: "global" },
+            format: audioFormat,
+            language: languageCode,
+            emitEosOnFinal,
+            url: () => endpointUrl ??
+                `wss://speech.googleapis.com/v2/${recognizerPath}:streamingRecognize?key=${apiKey}`,
+            socketFactory: this.socketFactory ?? (await defaultNodeSocketFactory()),
+            retry: readProviderRetryConfig(config),
+            replayBufferSize: config["replay_buffer_size"] ?? 64,
+            metricPrefix: "stt.google",
+        });
+    }
+    async close() {
+        await this.session?.dispose();
+        this.session = null;
+    }
+}
+/** Parse Google protobuf Duration JSON (`"1.250s"` or `{seconds,nanos}`) → seconds, or null. */
+function parseDurationSeconds(value) {
+    if (typeof value === "number" && Number.isFinite(value) && value >= 0)
+        return value;
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed.endsWith("s")) {
+            const n = Number(trimmed.slice(0, -1));
+            return Number.isFinite(n) && n >= 0 ? n : null;
+        }
+        const n = Number(trimmed);
+        return Number.isFinite(n) && n >= 0 ? n : null;
+    }
+    if (value && typeof value === "object") {
+        const obj = value;
+        const seconds = typeof obj.seconds === "number"
+            ? obj.seconds
+            : typeof obj.seconds === "string"
+                ? Number(obj.seconds)
+                : 0;
+        const nanos = typeof obj.nanos === "number"
+            ? obj.nanos
+            : typeof obj.nanos === "string"
+                ? Number(obj.nanos)
+                : 0;
+        if (!Number.isFinite(seconds) || !Number.isFinite(nanos))
+            return null;
+        const total = seconds + nanos / 1e9;
+        return total >= 0 ? total : null;
+    }
+    return null;
+}
+function readPlainObject(value) {
+    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+        return value;
+    }
+    return undefined;
+}
+function readStringList(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const list = value.filter((item) => typeof item === "string" && item.length > 0);
+    return list.length > 0 ? list : undefined;
+}
+//# 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuralle-syrinx/google",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "private": false,
   "description": "Google Cloud Speech-to-Text v2 STT adapter for Syrinx",
   "keywords": [
@@ -22,21 +22,28 @@
     "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",
   "dependencies": {
     "ws": "^8.21.0",
-    "@kuralle-syrinx/core": "4.4.0",
-    "@kuralle-syrinx/stt-core": "4.4.0",
-    "@kuralle-syrinx/ws": "4.4.0"
+    "@kuralle-syrinx/core": "4.5.0",
+    "@kuralle-syrinx/stt-core": "4.5.0",
+    "@kuralle-syrinx/ws": "4.5.0"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "@types/ws": "^8.5.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,528 @@
+// SPDX-License-Identifier: MIT
+
+import { afterEach, describe, expect, it } from "vitest";
+import { WebSocketServer, type WebSocket } from "ws";
+import {
+  PipelineBusImpl,
+  Route,
+  type SttErrorPacket,
+  type SttInterimPacket,
+  type SttResultPacket,
+  type EndOfSpeechPacket,
+  type UsageRecordedPacket,
+} from "@kuralle-syrinx/core";
+import { GoogleSTTPlugin } from "./index.js";
+
+let servers: WebSocketServer[] = [];
+
+afterEach(async () => {
+  await Promise.all(
+    servers.splice(0).map(
+      (server) =>
+        new Promise<void>((resolve) => {
+          for (const client of server.clients) client.terminate();
+          server.close(() => resolve());
+        }),
+    ),
+  );
+});
+
+async function createLocalServer(onConnection: (socket: WebSocket) => void): Promise<string> {
+  const server = await new Promise<WebSocketServer>((resolve) => {
+    let nextServer: WebSocketServer;
+    nextServer = new WebSocketServer({ port: 0 }, () => {
+      resolve(nextServer);
+    });
+  });
+  servers.push(server);
+  server.on("connection", onConnection);
+  const address = server.address();
+  if (!address || typeof address === "string") throw new Error("Expected TCP server address");
+  return `ws://127.0.0.1:${address.port}`;
+}
+
+function startBus(bus: PipelineBusImpl): Promise<void> {
+  const started = bus.start();
+  return started;
+}
+
+describe("GoogleSTTPlugin", () => {
+  it("pushes interim and final packets from Google streaming responses", async () => {
+    const endpointUrl = await createLocalServer((socket) => {
+      socket.once("message", () => {
+        socket.send(JSON.stringify({
+          results: [{
+            isFinal: false,
+            alternatives: [{ transcript: "hello", confidence: 0.7 }],
+          }],
+        }));
+        socket.send(JSON.stringify({
+          results: [{
+            isFinal: true,
+            alternatives: [{ transcript: "hello world", confidence: 0.95 }],
+          }],
+        }));
+      });
+    });
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new GoogleSTTPlugin();
+    const interims: SttInterimPacket[] = [];
+    const finals: SttResultPacket[] = [];
+    bus.on("stt.interim", (pkt) => {
+      interims.push(pkt as SttInterimPacket);
+    });
+    bus.on("stt.result", (pkt) => {
+      finals.push(pkt as SttResultPacket);
+    });
+
+    await plugin.initialize(bus, {
+      api_key: "test",
+      project_id: "test-project",
+      endpoint_url: endpointUrl,
+    });
+    bus.push(Route.Main, {
+      kind: "stt.audio",
+      contextId: "turn-1",
+      timestampMs: Date.now(),
+      audio: new Uint8Array([1, 2, 3, 4]),
+    });
+    await new Promise((resolve) => setTimeout(resolve, 30));
+
+    expect(interims).toEqual([
+      expect.objectContaining({ kind: "stt.interim", contextId: "turn-1", text: "hello" }),
+    ]);
+    expect(finals).toEqual([
+      expect.objectContaining({
+        kind: "stt.result",
+        contextId: "turn-1",
+        text: "hello world",
+        confidence: 0.95,
+        language: "en-US",
+      }),
+    ]);
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("reconnects after a recoverable socket close before sending later audio", async () => {
+    let connections = 0;
+    const receivedFrames: Array<{ connection: number; kind: "config" | "audio"; payload: unknown }> = [];
+    const endpointUrl = await createLocalServer((socket) => {
+      connections++;
+      const connection = connections;
+      if (connections === 1) {
+        socket.close();
+        return;
+      }
+      socket.on("message", (data, isBinary) => {
+        if (isBinary) {
+          receivedFrames.push({ connection, kind: "audio", payload: Buffer.from(data as Buffer) });
+        } else {
+          receivedFrames.push({ connection, kind: "config", payload: JSON.parse(data.toString()) });
+        }
+      });
+    });
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new GoogleSTTPlugin();
+
+    await plugin.initialize(bus, {
+      api_key: "test",
+      project_id: "test-project",
+      endpoint_url: endpointUrl,
+      retry_base_delay_ms: 1,
+      retry_max_delay_ms: 1,
+    });
+    await new Promise((resolve) => setTimeout(resolve, 30));
+    bus.push(Route.Main, {
+      kind: "stt.audio",
+      contextId: "turn-1",
+      timestampMs: Date.now(),
+      audio: new Uint8Array([9, 8, 7, 6]),
+    });
+    await new Promise((resolve) => setTimeout(resolve, 50));
+
+    expect(connections).toBeGreaterThanOrEqual(2);
+    expect(receivedFrames).toEqual([
+      expect.objectContaining({ connection: 2, kind: "config" }),
+      expect.objectContaining({ connection: 2, kind: "audio", payload: Buffer.from([9, 8, 7, 6]) }),
+    ]);
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("uses configured sample_rate in the audio contract and Google decoding config", async () => {
+    const configs: any[] = [];
+    const endpointUrl = await createLocalServer((socket) => {
+      socket.on("message", (data, isBinary) => {
+        if (!isBinary) configs.push(JSON.parse(data.toString()));
+      });
+    });
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new GoogleSTTPlugin();
+
+    await plugin.initialize(bus, {
+      api_key: "test",
+      project_id: "test-project",
+      endpoint_url: endpointUrl,
+      sample_rate: 8000,
+    });
+    await new Promise((resolve) => setTimeout(resolve, 20));
+
+    expect(configs[0]?.streamingConfig?.config?.explicitDecodingConfig?.sampleRateHertz).toBe(8000);
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("emits usage.recorded with stage stt from tracked audio bytes on final", async () => {
+    const endpointUrl = await createLocalServer((socket) => {
+      socket.once("message", () => {
+        socket.send(JSON.stringify({
+          results: [{
+            isFinal: true,
+            alternatives: [{ transcript: "hello world", confidence: 0.95 }],
+          }],
+        }));
+      });
+    });
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new GoogleSTTPlugin();
+    const usage: UsageRecordedPacket[] = [];
+    bus.on("usage.recorded", (pkt) => {
+      usage.push(pkt as UsageRecordedPacket);
+    });
+
+    // 640 bytes pcm_s16le @ 16kHz = 640 / 2 / 16000 = 0.02 s
+    const audio = new Uint8Array(640);
+    await plugin.initialize(bus, {
+      api_key: "test",
+      project_id: "test-project",
+      endpoint_url: endpointUrl,
+      sample_rate: 16000,
+      model: "latest_long",
+    });
+    bus.push(Route.Main, {
+      kind: "stt.audio",
+      contextId: "turn-usage",
+      timestampMs: Date.now(),
+      audio,
+    });
+    await new Promise((resolve) => setTimeout(resolve, 40));
+
+    expect(usage).toEqual([
+      expect.objectContaining({
+        kind: "usage.recorded",
+        contextId: "turn-usage",
+        stage: "stt",
+        provider: "google",
+        model: "latest_long",
+        audioSeconds: 0.02,
+      }),
+    ]);
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("prefers resultEndOffset for audioSeconds when present", async () => {
+    const endpointUrl = await createLocalServer((socket) => {
+      socket.once("message", () => {
+        socket.send(JSON.stringify({
+          results: [{
+            isFinal: true,
+            resultEndOffset: "1.250s",
+            alternatives: [{ transcript: "hello world", confidence: 0.95 }],
+          }],
+        }));
+      });
+    });
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new GoogleSTTPlugin();
+    const usage: UsageRecordedPacket[] = [];
+    bus.on("usage.recorded", (pkt) => {
+      usage.push(pkt as UsageRecordedPacket);
+    });
+
+    await plugin.initialize(bus, {
+      api_key: "test",
+      project_id: "test-project",
+      endpoint_url: endpointUrl,
+      model: "latest_long",
+    });
+    bus.push(Route.Main, {
+      kind: "stt.audio",
+      contextId: "turn-offset",
+      timestampMs: Date.now(),
+      audio: new Uint8Array(640),
+    });
+    await new Promise((resolve) => setTimeout(resolve, 40));
+
+    expect(usage).toEqual([
+      expect.objectContaining({
+        kind: "usage.recorded",
+        contextId: "turn-offset",
+        stage: "stt",
+        provider: "google",
+        model: "latest_long",
+        audioSeconds: 1.25,
+      }),
+    ]);
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("emits usage.recorded even when emit_eos_on_final is false", async () => {
+    const endpointUrl = await createLocalServer((socket) => {
+      socket.once("message", () => {
+        socket.send(JSON.stringify({
+          results: [{
+            isFinal: true,
+            alternatives: [{ transcript: "account number please", confidence: 0.95 }],
+          }],
+        }));
+      });
+    });
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new GoogleSTTPlugin();
+    const usage: UsageRecordedPacket[] = [];
+    bus.on("usage.recorded", (pkt) => {
+      usage.push(pkt as UsageRecordedPacket);
+    });
+
+    const audio = new Uint8Array(640);
+    await plugin.initialize(bus, {
+      api_key: "test",
+      project_id: "test-project",
+      endpoint_url: endpointUrl,
+      sample_rate: 16000,
+      model: "latest_long",
+      emit_eos_on_final: false,
+    });
+    bus.push(Route.Main, {
+      kind: "stt.audio",
+      contextId: "turn-smartturn",
+      timestampMs: Date.now(),
+      audio,
+    });
+    await new Promise((resolve) => setTimeout(resolve, 40));
+
+    expect(usage).toEqual([
+      expect.objectContaining({
+        kind: "usage.recorded",
+        contextId: "turn-smartturn",
+        stage: "stt",
+        provider: "google",
+        model: "latest_long",
+        audioSeconds: 0.02,
+      }),
+    ]);
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("suppresses EOS when Smart Turn ownership disables provider finalization", async () => {
+    const endpointUrl = await createLocalServer((socket) => {
+      socket.once("message", () => {
+        socket.send(JSON.stringify({
+          results: [{
+            isFinal: true,
+            alternatives: [{ transcript: "hello world", confidence: 0.95 }],
+          }],
+        }));
+      });
+    });
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new GoogleSTTPlugin();
+    const finals: SttResultPacket[] = [];
+    const eos: EndOfSpeechPacket[] = [];
+    bus.on("stt.result", (pkt) => {
+      finals.push(pkt as SttResultPacket);
+    });
+    bus.on("eos.turn_complete", (pkt) => {
+      eos.push(pkt as EndOfSpeechPacket);
+    });
+
+    await plugin.initialize(bus, {
+      api_key: "test",
+      project_id: "test-project",
+      endpoint_url: endpointUrl,
+      emit_eos_on_final: false,
+    });
+    bus.push(Route.Main, {
+      kind: "stt.audio",
+      contextId: "turn-no-eos",
+      timestampMs: Date.now(),
+      audio: new Uint8Array([1, 2, 3, 4]),
+    });
+    await new Promise((resolve) => setTimeout(resolve, 30));
+
+    expect(finals).toHaveLength(1);
+    expect(eos).toEqual([]);
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("emits stt.error for odd-length PCM16 without throwing into the bus pump", async () => {
+    const receivedAudio: Buffer[] = [];
+    const endpointUrl = await createLocalServer((socket) => {
+      socket.on("message", (data, isBinary) => {
+        if (isBinary) receivedAudio.push(data as Buffer);
+      });
+    });
+    const bus = new PipelineBusImpl();
+    const started = startBus(bus);
+    const plugin = new GoogleSTTPlugin();
+    const errors: SttErrorPacket[] = [];
+    bus.on("stt.error", (pkt) => {
+      errors.push(pkt as SttErrorPacket);
+    });
+
+    await plugin.initialize(bus, {
+      api_key: "test",
+      project_id: "test-project",
+      endpoint_url: endpointUrl,
+    });
+    bus.push(Route.Main, {
+      kind: "stt.audio",
+      contextId: "turn-bad",
+      timestampMs: Date.now(),
+      audio: new Uint8Array([1, 2, 3]),
+    });
+    await new Promise((resolve) => setTimeout(resolve, 30));
+
+    expect(errors).toEqual([
+      expect.objectContaining({
+        kind: "stt.error",
+        contextId: "turn-bad",
+        component: "stt",
+        cause: expect.objectContaining({
+          message: expect.stringMatching(/even number of bytes/i),
+        }),
+      }),
+    ]);
+    expect(receivedAudio).toEqual([]);
+
+    await plugin.close();
+    bus.stop();
+    await started;
+  });
+
+  it("defaults recognition config knobs and allows overrides + feature passthrough", async () => {
+    const configs: any[] = [];
+    const endpointUrl = await createLocalServer((socket) => {
+      socket.on("message", (data, isBinary) => {
+        if (!isBinary) configs.push(JSON.parse(data.toString()));
+      });
+    });
+
+    const busDefault = new PipelineBusImpl();
+    const startedDefault = startBus(busDefault);
+    const pluginDefault = new GoogleSTTPlugin();
+    await pluginDefault.initialize(busDefault, {
+      api_key: "test",
+      project_id: "test-project",
+      endpoint_url: endpointUrl,
+    });
+    await new Promise((resolve) => setTimeout(resolve, 20));
+    await pluginDefault.close();
+    busDefault.stop();
+    await startedDefault;
+
+    expect(configs[0]).toEqual({
+      recognizer: "projects/test-project/locations/global/recognizers/_",
+      streamingConfig: {
+        config: {
+          explicitDecodingConfig: {
+            encoding: "LINEAR16",
+            sampleRateHertz: 16000,
+            audioChannelCount: 1,
+          },
+          languageCodes: ["en-US"],
+          model: "latest_long",
+          features: {
+            enableAutomaticPunctuation: true,
+            enableWordConfidence: true,
+          },
+        },
+        streamingFeatures: {
+          interimResults: true,
+        },
+      },
+    });
+
+    const busOverride = new PipelineBusImpl();
+    const startedOverride = startBus(busOverride);
+    const pluginOverride = new GoogleSTTPlugin();
+    await pluginOverride.initialize(busOverride, {
+      api_key: "test",
+      project_id: "my-proj",
+      endpoint_url: endpointUrl,
+      location: "us-central1",
+      recognizer: "phone",
+      model: "chirp_2",
+      language: "es-ES",
+      language_codes: ["es-ES", "en-US"],
+      sample_rate: 8000,
+      encoding: "MULAW",
+      channels: 1,
+      enable_automatic_punctuation: false,
+      enable_word_confidence: false,
+      interim_results: false,
+      recognition_features: {
+        profanityFilter: true,
+        enableWordTimeOffsets: true,
+      },
+      streaming_features: {
+        enableVoiceActivityEvents: true,
+      },
+    });
+    await new Promise((resolve) => setTimeout(resolve, 20));
+    await pluginOverride.close();
+    busOverride.stop();
+    await startedOverride;
+
+    expect(configs[1]).toEqual({
+      recognizer: "projects/my-proj/locations/us-central1/recognizers/phone",
+      streamingConfig: {
+        config: {
+          explicitDecodingConfig: {
+            encoding: "MULAW",
+            sampleRateHertz: 8000,
+            audioChannelCount: 1,
+          },
+          languageCodes: ["es-ES", "en-US"],
+          model: "chirp_2",
+          features: {
+            enableAutomaticPunctuation: false,
+            enableWordConfidence: false,
+            profanityFilter: true,
+            enableWordTimeOffsets: true,
+          },
+        },
+        streamingFeatures: {
+          interimResults: false,
+          enableVoiceActivityEvents: true,
+        },
+      },
+    });
+  });
+});