dvgateway-adapters 1.9.12 → 1.9.15

package/README.md

@@ -14,6 +14,7 @@ npm install dvgateway-sdk dvgateway-adapters
 |------|--------|--------|
 | STT | `DeepgramAdapter` | Deepgram Nova-3 |
 | STT | `GoogleChirp3Adapter` | Google Cloud STT Chirp 3 |
+| STT | `RtzrSttAdapter` | 리턴제로 sommers_ko (한국어 전화 음성) |
 | TTS | `ElevenLabsAdapter` | ElevenLabs Flash v2.5 |
 | TTS | `OpenAITtsAdapter` | OpenAI gpt-4o-mini-tts |
 | TTS | `GeminiTtsAdapter` | Google Gemini TTS |

package/dist/index.d.ts

@@ -26,6 +26,8 @@ export { DeepgramAdapter } from './stt/deepgram.js';
 export type { DeepgramAdapterOptions } from './stt/deepgram.js';
 export { GoogleChirp3Adapter } from './stt/google-chirp3.js';
 export type { GoogleChirp3AdapterOptions } from './stt/google-chirp3.js';
+export { RtzrSttAdapter } from './stt/rtzr.js';
+export type { RtzrSttAdapterOptions } from './stt/rtzr.js';
 export type { HumanVoiceOptions, SttOptions, TtsOptions, } from 'dvgateway-sdk';
 export { HUMAN_VOICE_DEFAULTS_KO, HUMAN_VOICE_DEFAULTS_EN, } from 'dvgateway-sdk';
 export { ElevenLabsAdapter, ELEVENLABS_KOREAN_VOICES } from './tts/elevenlabs.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAmB,mBAAmB,CAAC;AACjE,YAAY,EAAE,sBAAsB,EAAE,MAAO,mBAAmB,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAe,wBAAwB,CAAC;AACtE,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGzE,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,UAAU,GACX,MAA4C,eAAe,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAA4C,eAAe,CAAC;AAG7D,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAClF,YAAY,EAAE,wBAAwB,EAAE,MAAoB,qBAAqB,CAAC;AAElF,OAAO,EAAE,gBAAgB,EAAE,MAAsB,qBAAqB,CAAC;AACvE,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,cAAc,GACf,MAAgD,qBAAqB,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAsB,qBAAqB,CAAC;AACvE,YAAY,EACV,uBAAuB,EACvB,WAAW,GACZ,MAAgD,qBAAqB,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,cAAc,GACf,MAAgD,qBAAqB,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,cAAc,GACf,MAAgD,wBAAwB,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,uBAAuB,EAAE,MAAU,oBAAoB,CAAC;AAEtE,OAAO,EAAE,gBAAgB,EAAE,MAAsB,qBAAqB,CAAC;AACvE,YAAY,EAAE,uBAAuB,EAAE,MAAU,qBAAqB,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAwB,kBAAkB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAY,kBAAkB,CAAC;AAGpE,OAAO,EAAE,qBAAqB,EAAE,MAAiB,+BAA+B,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC9H,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,YAAY,EACZ,qBAAqB,GACtB,MAAgD,wBAAwB,CAAC;AAC1E,YAAY,EACV,4BAA4B,EAC5B,mBAAmB,EACnB,+BAA+B,EAC/B,kCAAkC,EAClC,qBAAqB,GACtB,MAAgD,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAmB,mBAAmB,CAAC;AACjE,YAAY,EAAE,sBAAsB,EAAE,MAAO,mBAAmB,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAe,wBAAwB,CAAC;AACtE,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAoB,eAAe,CAAC;AAC7D,YAAY,EAAE,qBAAqB,EAAE,MAAQ,eAAe,CAAC;AAG7D,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,UAAU,GACX,MAA4C,eAAe,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAA4C,eAAe,CAAC;AAG7D,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAClF,YAAY,EAAE,wBAAwB,EAAE,MAAoB,qBAAqB,CAAC;AAElF,OAAO,EAAE,gBAAgB,EAAE,MAAsB,qBAAqB,CAAC;AACvE,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,cAAc,GACf,MAAgD,qBAAqB,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAsB,qBAAqB,CAAC;AACvE,YAAY,EACV,uBAAuB,EACvB,WAAW,GACZ,MAAgD,qBAAqB,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,cAAc,GACf,MAAgD,qBAAqB,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,cAAc,GACf,MAAgD,wBAAwB,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,uBAAuB,EAAE,MAAU,oBAAoB,CAAC;AAEtE,OAAO,EAAE,gBAAgB,EAAE,MAAsB,qBAAqB,CAAC;AACvE,YAAY,EAAE,uBAAuB,EAAE,MAAU,qBAAqB,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAwB,kBAAkB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAY,kBAAkB,CAAC;AAGpE,OAAO,EAAE,qBAAqB,EAAE,MAAiB,+BAA+B,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC9H,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,YAAY,EACZ,qBAAqB,GACtB,MAAgD,wBAAwB,CAAC;AAC1E,YAAY,EACV,4BAA4B,EAC5B,mBAAmB,EACnB,+BAA+B,EAC/B,kCAAkC,EAClC,qBAAqB,GACtB,MAAgD,+BAA+B,CAAC"}

package/dist/index.js

@@ -25,6 +25,7 @@
 // ── STT (Speech-to-Text) ──────────────────────────────────────────────────────
 export { DeepgramAdapter } from './stt/deepgram.js';
 export { GoogleChirp3Adapter } from './stt/google-chirp3.js';
+export { RtzrSttAdapter } from './stt/rtzr.js';
 export { HUMAN_VOICE_DEFAULTS_KO, HUMAN_VOICE_DEFAULTS_EN, } from 'dvgateway-sdk';
 // ── TTS (Text-to-Speech) ─────────────────────────────────────────────────────
 export { ElevenLabsAdapter, ELEVENLABS_KOREAN_VOICES } from './tts/elevenlabs.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAmB,mBAAmB,CAAC;AAGjE,OAAO,EAAE,mBAAmB,EAAE,MAAe,wBAAwB,CAAC;AAStE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAA4C,eAAe,CAAC;AAE7D,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAGlF,OAAO,EAAE,gBAAgB,EAAE,MAAsB,qBAAqB,CAAC;AAOvE,OAAO,EAAE,gBAAgB,EAAE,MAAsB,qBAAqB,CAAC;AAMvE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAO1E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAO5E,gFAAgF;AAChF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,MAAsB,qBAAqB,CAAC;AAGvE,OAAO,EAAE,cAAc,EAAE,MAAwB,kBAAkB,CAAC;AAGpE,iFAAiF;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAiB,+BAA+B,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAmB,mBAAmB,CAAC;AAGjE,OAAO,EAAE,mBAAmB,EAAE,MAAe,wBAAwB,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,MAAoB,eAAe,CAAC;AAS7D,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAA4C,eAAe,CAAC;AAE7D,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAGlF,OAAO,EAAE,gBAAgB,EAAE,MAAsB,qBAAqB,CAAC;AAOvE,OAAO,EAAE,gBAAgB,EAAE,MAAsB,qBAAqB,CAAC;AAMvE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAO1E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAO5E,gFAAgF;AAChF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,MAAsB,qBAAqB,CAAC;AAGvE,OAAO,EAAE,cAAc,EAAE,MAAwB,kBAAkB,CAAC;AAGpE,iFAAiF;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAiB,+BAA+B,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/stt/index.d.ts

@@ -4,4 +4,6 @@ export { GoogleChirp3Adapter } from './google-chirp3.js';
 export type { GoogleChirp3AdapterOptions } from './google-chirp3.js';
 export { OpenAISttAdapter } from './openai-stt.js';
 export type { OpenAISttAdapterOptions } from './openai-stt.js';
+export { RtzrSttAdapter, rtzrKeywords } from './rtzr.js';
+export type { RtzrSttAdapterOptions } from './rtzr.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/stt/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stt/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stt/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}

package/dist/stt/index.js

@@ -2,4 +2,5 @@
 export { DeepgramAdapter } from './deepgram.js';
 export { GoogleChirp3Adapter } from './google-chirp3.js';
 export { OpenAISttAdapter } from './openai-stt.js';
+export { RtzrSttAdapter, rtzrKeywords } from './rtzr.js';
 //# sourceMappingURL=index.js.map

package/dist/stt/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stt/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stt/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/stt/rtzr.d.ts

@@ -0,0 +1,80 @@
+/**
+ * ReturnZero (RTZR) STT Adapter — Korean telephony streaming STT.
+ *
+ * Streams 16kHz slin16 PCM to RTZR's WebSocket API and fires onTranscript for
+ * partial (isFinal=false) and final (isFinal=true) results.
+ *
+ * Why: in our 2026-10-14 comparison (synthetic phone audio, AWS Seoul) RTZR
+ * caught more Korean addresses and phone numbers than Deepgram Nova-3 and
+ * connected in ~14ms from Korea; its final result arrived ~90ms later because
+ * the server waits for its own end-of-speech (EPD). Call `finalize()` at your
+ * own end-of-turn to get the final result immediately (RTZR blog: p50
+ * 702ms → 24ms).
+ *
+ * Protocol (developers.rtzr.ai, checked 2026-10-14):
+ *   POST https://openapi.vito.ai/v1/authenticate (form: client_id, client_secret)
+ *     → { access_token } — valid 6 hours
+ *   wss://openapi.vito.ai/v1/transcribe:streaming?sample_rate=16000&encoding=LINEAR16&…
+ *     Authorization: Bearer <token>
+ *   send: binary raw PCM · text {"type":"Finalize"} · text "EOS" (end of stream)
+ *   recv: { seq, start_at, duration, final, alternatives: [{ text, confidence }] }
+ *   The server drops a connection that sends no audio for 60s.
+ *
+ * Keywords: Hangul syllables and spaces only, ≤20 chars each, ≤100 words
+ * (sommers_ko only). Anything else makes the handshake fail (HTTP 400), so
+ * this adapter drops it and logs only the count.
+ *
+ * @since SDK 1.9.13
+ */
+import type { SttAdapter, AudioChunk, TranscriptResult } from 'dvgateway-sdk';
+export interface RtzrSttAdapterOptions {
+    /** RTZR console client ID */
+    clientId: string;
+    /** RTZR console client secret */
+    clientSecret: string;
+    /** Language code (default: "ko"). "ja" → sommers_ja, others → whisper */
+    language?: string;
+    /** Model override (default: derived from language — sommers_ko) */
+    model?: string;
+    /** "CALL" (phone, default) or "MEETING" (far-field) */
+    domain?: 'CALL' | 'MEETING';
+    /** Inverse text normalization — "공일공" → "010" (default: true) */
+    useItn?: boolean;
+    /** Remove fillers like "음", "어" (default: false) */
+    useDisfluencyFilter?: boolean;
+    /** Mask profanity (default: false) */
+    useProfanityFilter?: boolean;
+    /** Add punctuation (default: false) */
+    usePunctuation?: boolean;
+    /** Keyword boosting: "word" or "word:score" (Hangul only) */
+    keywords?: string[];
+    /** Override API base (tests) */
+    authUrl?: string;
+    streamUrl?: string;
+}
+/** Keep only keywords RTZR accepts (Hangul + spaces, optional ":score"). */
+export declare function rtzrKeywords(terms: readonly string[]): {
+    kept: string[];
+    dropped: number;
+};
+export declare class RtzrSttAdapter implements SttAdapter {
+    private readonly opts;
+    private transcriptHandler;
+    private ws;
+    private stopped;
+    private linkedId;
+    constructor(opts: RtzrSttAdapterOptions);
+    onTranscript(handler: (result: TranscriptResult) => void): void;
+    startStream(linkedId: string, audioStream: AsyncIterable<AudioChunk>): Promise<void>;
+    /** Ask the server to finalize the current utterance now (connection stays open). */
+    finalize(): void;
+    stop(): Promise<void>;
+    /** Query string for the streaming endpoint (exported for tests). */
+    buildQuery(): URLSearchParams;
+    private token;
+    private connect;
+    private dial;
+    private pipeAudio;
+    private handleMessage;
+}
+//# sourceMappingURL=rtzr.d.ts.map

package/dist/stt/rtzr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtzr.d.ts","sourceRoot":"","sources":["../../src/stt/rtzr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAG9E,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,uCAAuC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAkB1F;AAID,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqE;IAC1F,OAAO,CAAC,iBAAiB,CAAqD;IAC9E,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAM;gBAEV,IAAI,EAAE,qBAAqB;IAuBvC,YAAY,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAIzD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1F,oFAAoF;IACpF,QAAQ,IAAI,IAAI;IAMV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,oEAAoE;IACpE,UAAU,IAAI,eAAe;YAsBf,KAAK;YAgBL,OAAO;IAerB,OAAO,CAAC,IAAI;YAaE,SAAS;IAOvB,OAAO,CAAC,aAAa;CAmBtB"}

package/dist/stt/rtzr.js

@@ -0,0 +1,217 @@
+/**
+ * ReturnZero (RTZR) STT Adapter — Korean telephony streaming STT.
+ *
+ * Streams 16kHz slin16 PCM to RTZR's WebSocket API and fires onTranscript for
+ * partial (isFinal=false) and final (isFinal=true) results.
+ *
+ * Why: in our 2026-10-14 comparison (synthetic phone audio, AWS Seoul) RTZR
+ * caught more Korean addresses and phone numbers than Deepgram Nova-3 and
+ * connected in ~14ms from Korea; its final result arrived ~90ms later because
+ * the server waits for its own end-of-speech (EPD). Call `finalize()` at your
+ * own end-of-turn to get the final result immediately (RTZR blog: p50
+ * 702ms → 24ms).
+ *
+ * Protocol (developers.rtzr.ai, checked 2026-10-14):
+ *   POST https://openapi.vito.ai/v1/authenticate (form: client_id, client_secret)
+ *     → { access_token } — valid 6 hours
+ *   wss://openapi.vito.ai/v1/transcribe:streaming?sample_rate=16000&encoding=LINEAR16&…
+ *     Authorization: Bearer <token>
+ *   send: binary raw PCM · text {"type":"Finalize"} · text "EOS" (end of stream)
+ *   recv: { seq, start_at, duration, final, alternatives: [{ text, confidence }] }
+ *   The server drops a connection that sends no audio for 60s.
+ *
+ * Keywords: Hangul syllables and spaces only, ≤20 chars each, ≤100 words
+ * (sommers_ko only). Anything else makes the handshake fail (HTTP 400), so
+ * this adapter drops it and logs only the count.
+ *
+ * @since SDK 1.9.13
+ */
+import WebSocket from 'ws';
+import { float32ToSlin16 } from 'dvgateway-sdk';
+const AUTH_URL = 'https://openapi.vito.ai/v1/authenticate';
+const STREAM_URL = 'wss://openapi.vito.ai/v1/transcribe:streaming';
+const TOKEN_REUSE_MS = 5 * 60 * 60 * 1000; // token lives 6h
+const KEYWORD_MAX = 100;
+const KEYWORD_MAX_LEN = 20;
+/** Keep only keywords RTZR accepts (Hangul + spaces, optional ":score"). */
+export function rtzrKeywords(terms) {
+    const kept = [];
+    const seen = new Set();
+    let dropped = 0;
+    for (const raw of terms) {
+        const t = raw.trim();
+        if (!t || seen.has(t))
+            continue;
+        const [word = '', score] = t.split(':', 2);
+        const wordOk = word.length > 0 && [...word].length <= KEYWORD_MAX_LEN && /^[가-힣 ]+$/.test(word);
+        const scoreOk = score === undefined || (/^-?\d+(\.\d+)?$/.test(score) && Math.abs(Number(score)) <= 5);
+        if (!wordOk || !scoreOk || kept.length >= KEYWORD_MAX) {
+            dropped++;
+            continue;
+        }
+        seen.add(t);
+        kept.push(t);
+    }
+    return { kept, dropped };
+}
+const tokenCache = new Map();
+export class RtzrSttAdapter {
+    opts;
+    transcriptHandler = null;
+    ws = null;
+    stopped = false;
+    linkedId = '';
+    constructor(opts) {
+        if (!opts.clientId || !opts.clientSecret) {
+            throw new Error('RtzrSttAdapter: clientId and clientSecret are required');
+        }
+        const language = opts.language ?? 'ko';
+        const model = opts.model
+            ?? (language.startsWith('ja') ? 'sommers_ja' : language.startsWith('ko') ? 'sommers_ko' : 'whisper');
+        this.opts = {
+            clientId: opts.clientId,
+            clientSecret: opts.clientSecret,
+            language,
+            model,
+            domain: opts.domain ?? 'CALL',
+            useItn: opts.useItn ?? true,
+            useDisfluencyFilter: opts.useDisfluencyFilter ?? false,
+            useProfanityFilter: opts.useProfanityFilter ?? false,
+            usePunctuation: opts.usePunctuation ?? false,
+            keywords: opts.keywords ?? [],
+            authUrl: opts.authUrl ?? AUTH_URL,
+            streamUrl: opts.streamUrl ?? STREAM_URL,
+        };
+    }
+    onTranscript(handler) {
+        this.transcriptHandler = handler;
+    }
+    async startStream(linkedId, audioStream) {
+        this.stopped = false;
+        this.linkedId = linkedId;
+        this.ws = await this.connect();
+        void this.pipeAudio(audioStream);
+        await new Promise((resolve) => {
+            this.ws?.once('close', () => resolve());
+            const t = setInterval(() => {
+                if (this.stopped) {
+                    clearInterval(t);
+                    resolve();
+                }
+            }, 100);
+        });
+    }
+    /** Ask the server to finalize the current utterance now (connection stays open). */
+    finalize() {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify({ type: 'Finalize' }));
+        }
+    }
+    async stop() {
+        this.stopped = true;
+        const ws = this.ws;
+        this.ws = null;
+        if (ws && ws.readyState === WebSocket.OPEN) {
+            ws.send('EOS');
+            setTimeout(() => ws.close(1000, 'stop'), 200);
+        }
+    }
+    /** Query string for the streaming endpoint (exported for tests). */
+    buildQuery() {
+        const q = new URLSearchParams({
+            sample_rate: '16000',
+            encoding: 'LINEAR16',
+            model_name: this.opts.model,
+            domain: this.opts.domain,
+            use_itn: String(this.opts.useItn),
+            use_disfluency_filter: String(this.opts.useDisfluencyFilter),
+            use_profanity_filter: String(this.opts.useProfanityFilter),
+            use_punctuation: String(this.opts.usePunctuation),
+        });
+        if (this.opts.model === 'whisper')
+            q.set('language', this.opts.language);
+        const { kept, dropped } = rtzrKeywords(this.opts.keywords);
+        if (dropped > 0) {
+            process.stderr.write(`[RtzrSttAdapter] ${dropped} keyword(s) dropped (Hangul only, ≤20 chars, ≤100)\n`);
+        }
+        if (kept.length > 0 && (this.opts.model === 'sommers_ko' || (this.opts.model === 'whisper' && this.opts.language.startsWith('ko')))) {
+            q.set('keywords', kept.join(','));
+        }
+        return q;
+    }
+    async token(fresh) {
+        const cached = tokenCache.get(this.opts.clientId);
+        if (cached && !fresh && Date.now() - cached.at < TOKEN_REUSE_MS)
+            return cached.token;
+        const res = await fetch(this.opts.authUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: new URLSearchParams({ client_id: this.opts.clientId, client_secret: this.opts.clientSecret }).toString(),
+        });
+        const body = await res.text();
+        if (!res.ok)
+            throw new Error(`RTZR auth HTTP ${res.status}: ${body.slice(0, 120)}`);
+        const token = JSON.parse(body).access_token;
+        if (!token)
+            throw new Error('RTZR auth response has no access_token');
+        tokenCache.set(this.opts.clientId, { token, at: Date.now() });
+        return token;
+    }
+    async connect() {
+        const url = `${this.opts.streamUrl}?${this.buildQuery().toString()}`;
+        for (let attempt = 0; attempt < 2; attempt++) {
+            const token = await this.token(attempt > 0);
+            try {
+                return await this.dial(url, token);
+            }
+            catch (err) {
+                // 401 = token revoked/expired elsewhere — retry once with a fresh token.
+                if (attempt === 0 && err instanceof Error && err.message.includes('401'))
+                    continue;
+                throw err;
+            }
+        }
+        throw new Error('RTZR connect: unauthorized');
+    }
+    dial(url, token) {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(url, { headers: { Authorization: `Bearer ${token}` } });
+            ws.once('unexpected-response', (_req, res) => reject(new Error(`RTZR connect HTTP ${res.statusCode}`)));
+            ws.once('error', reject);
+            ws.once('open', () => {
+                ws.on('message', (data) => this.handleMessage(data));
+                ws.on('error', (err) => process.stderr.write(`[RtzrSttAdapter] WebSocket error: ${err.message}\n`));
+                resolve(ws);
+            });
+        });
+    }
+    async pipeAudio(audioStream) {
+        for await (const chunk of audioStream) {
+            if (this.stopped || !this.ws || this.ws.readyState !== WebSocket.OPEN)
+                break;
+            this.ws.send(float32ToSlin16(chunk.samples));
+        }
+    }
+    handleMessage(data) {
+        let msg;
+        try {
+            msg = JSON.parse(data.toString());
+        }
+        catch {
+            return;
+        }
+        const alt = msg.alternatives?.[0];
+        const text = alt?.text?.trim();
+        if (!text)
+            return;
+        this.transcriptHandler?.({
+            linkedId: this.linkedId,
+            text,
+            isFinal: msg.final === true,
+            ...(typeof alt?.confidence === 'number' ? { confidence: alt.confidence } : {}),
+            language: this.opts.language,
+            timestampMs: Date.now(),
+        });
+    }
+}
+//# sourceMappingURL=rtzr.js.map

package/dist/stt/rtzr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtzr.js","sourceRoot":"","sources":["../../src/stt/rtzr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA4BhD,MAAM,QAAQ,GAAG,yCAAyC,CAAC;AAC3D,MAAM,UAAU,GAAG,+CAA+C,CAAC;AACnE,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,iBAAiB;AAC5D,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QAChC,MAAM,CAAC,IAAI,GAAG,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,IAAI,eAAe,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChG,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvG,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,IAAI,WAAW,EAAE,CAAC;YACtD,OAAO,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyC,CAAC;AAEpE,MAAM,OAAO,cAAc;IACR,IAAI,CAAqE;IAClF,iBAAiB,GAAgD,IAAI,CAAC;IACtE,EAAE,GAAqB,IAAI,CAAC;IAC5B,OAAO,GAAG,KAAK,CAAC;IAChB,QAAQ,GAAG,EAAE,CAAC;IAEtB,YAAY,IAA2B;QACrC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK;eACnB,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACvG,IAAI,CAAC,IAAI,GAAG;YACV,QAAQ,EAAa,IAAI,CAAC,QAAQ;YAClC,YAAY,EAAS,IAAI,CAAC,YAAY;YACtC,QAAQ;YACR,KAAK;YACL,MAAM,EAAe,IAAI,CAAC,MAAM,IAAI,MAAM;YAC1C,MAAM,EAAe,IAAI,CAAC,MAAM,IAAI,IAAI;YACxC,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,IAAI,KAAK;YACtD,kBAAkB,EAAG,IAAI,CAAC,kBAAkB,IAAI,KAAK;YACrD,cAAc,EAAO,IAAI,CAAC,cAAc,IAAI,KAAK;YACjD,QAAQ,EAAa,IAAI,CAAC,QAAQ,IAAI,EAAE;YACxC,OAAO,EAAc,IAAI,CAAC,OAAO,IAAI,QAAQ;YAC7C,SAAS,EAAY,IAAI,CAAC,SAAS,IAAI,UAAU;SAClD,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,OAA2C;QACtD,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,WAAsC;QACxE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,KAAK,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACxC,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE;gBACzB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACjB,aAAa,CAAC,CAAC,CAAC,CAAC;oBACjB,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oFAAoF;IACpF,QAAQ;QACN,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACrD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACf,IAAI,EAAE,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAC3C,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACf,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,oEAAoE;IACpE,UAAU;QACR,MAAM,CAAC,GAAG,IAAI,eAAe,CAAC;YAC5B,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,UAAU;YACpB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;YAC3B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;YACxB,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YACjC,qBAAqB,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC;YAC5D,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC;YAC1D,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC;SAClD,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3D,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,sDAAsD,CAAC,CAAC;QAC1G,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACpI,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,KAAc;QAChC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,MAAM,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,EAAE,GAAG,cAAc;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC;QACrF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACzC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;YAChE,IAAI,EAAE,IAAI,eAAe,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,QAAQ,EAAE;SAC/G,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACpF,MAAM,KAAK,GAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAA+B,CAAC,YAAY,CAAC;QAC3E,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACtE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;QACrE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YAC5C,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,yEAAyE;gBACzE,IAAI,OAAO,KAAK,CAAC,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAAE,SAAS;gBACnF,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAEO,IAAI,CAAC,GAAW,EAAE,KAAa;QACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACjF,EAAE,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;YACxG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACzB,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;gBACnB,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;gBACxE,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;gBACpG,OAAO,CAAC,EAAE,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,WAAsC;QAC5D,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;gBAAE,MAAM;YAC7E,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,IAAuB;QAC3C,IAAI,GAAsF,CAAC;QAC3F,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI;YACJ,OAAO,EAAE,GAAG,CAAC,KAAK,KAAK,IAAI;YAC3B,GAAG,CAAC,OAAO,GAAG,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;YAC5B,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;SACxB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/stt/rtzr.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rtzr.test.d.ts.map

package/dist/stt/rtzr.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtzr.test.d.ts","sourceRoot":"","sources":["../../src/stt/rtzr.test.ts"],"names":[],"mappings":""}

package/dist/stt/rtzr.test.js

@@ -0,0 +1,102 @@
+/**
+ * RtzrSttAdapter — keyword rules, query building, and a full stream against
+ * local fake auth + WebSocket servers (no network).
+ */
+import http from 'http';
+import { WebSocketServer } from 'ws';
+import { RtzrSttAdapter, rtzrKeywords } from './rtzr.js';
+describe('rtzrKeywords', () => {
+    it('keeps Hangul words (with optional score) and drops the rest', () => {
+        const { kept, dropped } = rtzrKeywords(['선불', '착불:3.5', '선불', 'STT', '1톤', '가'.repeat(21), '다마스:9']);
+        expect(kept).toEqual(['선불', '착불:3.5']);
+        expect(dropped).toBe(4);
+    });
+    it('caps at 100 words', () => {
+        const many = Array.from({ length: 120 }, (_, i) => String.fromCharCode(0xac00 + i));
+        expect(rtzrKeywords(many).kept).toHaveLength(100);
+    });
+});
+describe('RtzrSttAdapter.buildQuery', () => {
+    it('uses the Korean phone model with ITN and only valid keywords', () => {
+        const a = new RtzrSttAdapter({ clientId: 'i', clientSecret: 's', keywords: ['선불', 'STT'] });
+        const q = a.buildQuery();
+        expect(q.get('model_name')).toBe('sommers_ko');
+        expect(q.get('domain')).toBe('CALL');
+        expect(q.get('use_itn')).toBe('true');
+        expect(q.get('sample_rate')).toBe('16000');
+        expect(q.get('keywords')).toBe('선불');
+    });
+    it('does not send keywords to sommers_ja', () => {
+        const q = new RtzrSttAdapter({ clientId: 'i', clientSecret: 's', language: 'ja', keywords: ['선불'] }).buildQuery();
+        expect(q.get('model_name')).toBe('sommers_ja');
+        expect(q.get('keywords')).toBeNull();
+    });
+    it('requires credentials', () => {
+        expect(() => new RtzrSttAdapter({ clientId: '', clientSecret: 's' })).toThrow();
+    });
+});
+async function* oneSecondOfAudio() {
+    for (let i = 0; i < 5; i++) {
+        yield { linkedId: 'L1', dir: 'in', samples: new Float32Array(320), sampleRate: 16000, durationMs: 20, timestampMs: i * 20 };
+        await new Promise((r) => setTimeout(r, 5));
+    }
+}
+describe('RtzrSttAdapter stream', () => {
+    it('authenticates, streams PCM, emits partial + final, and sends EOS on stop', async () => {
+        let auth = '';
+        let gotEOS = false;
+        let gotFinalize = false;
+        const authServer = http.createServer((req, res) => {
+            let body = '';
+            req.on('data', (c) => (body += c));
+            req.on('end', () => {
+                const p = new URLSearchParams(body);
+                res.end(JSON.stringify({ access_token: p.get('client_id') === 'cid' ? 'tok1' : '' }));
+            });
+        });
+        await new Promise((r) => authServer.listen(0, r));
+        const wss = new WebSocketServer({ port: 0 });
+        await new Promise((r) => wss.once('listening', () => r()));
+        wss.on('connection', (ws, req) => {
+            auth = req.headers.authorization ?? '';
+            let frames = 0;
+            ws.on('message', (data, isBinary) => {
+                if (!isBinary) {
+                    const s = data.toString();
+                    if (s === 'EOS')
+                        gotEOS = true;
+                    if (s.includes('Finalize'))
+                        gotFinalize = true;
+                    return;
+                }
+                if (++frames === 2) {
+                    ws.send(JSON.stringify({ seq: 0, final: false, alternatives: [{ text: '선' }] }));
+                    ws.send(JSON.stringify({ seq: 0, final: true, alternatives: [{ text: '선불', confidence: 0.9 }] }));
+                }
+            });
+        });
+        const results = [];
+        const a = new RtzrSttAdapter({
+            clientId: 'cid',
+            clientSecret: 'sec',
+            authUrl: `http://127.0.0.1:${authServer.address().port}`,
+            streamUrl: `ws://127.0.0.1:${wss.address().port}`,
+        });
+        a.onTranscript((r) => results.push(r));
+        const done = a.startStream('L1', oneSecondOfAudio());
+        await new Promise((r) => setTimeout(r, 300));
+        a.finalize();
+        await new Promise((r) => setTimeout(r, 50));
+        await a.stop();
+        await done;
+        await new Promise((r) => setTimeout(r, 300));
+        expect(auth).toBe('Bearer tok1');
+        expect(results.map((r) => [r.text, r.isFinal])).toEqual([['선', false], ['선불', true]]);
+        expect(results[1]?.linkedId).toBe('L1');
+        expect(gotFinalize).toBe(true);
+        expect(gotEOS).toBe(true);
+        wss.close();
+        authServer.close();
+    });
+});
+//# sourceMappingURL=rtzr.test.js.map

package/dist/stt/rtzr.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dvgateway-adapters",
-  "version": "1.9.12",
+  "version": "1.9.15",
   "description": "AI service adapters for DVGateway SDK (Deepgram, ElevenLabs, Anthropic, OpenAI, OpenAI Realtime, OpenAI GPT-Live, Gemini Live)",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,6 +42,8 @@
   "keywords": [
     "dvgateway",
     "deepgram",
+    "rtzr",
+    "returnzero",
     "elevenlabs",
     "anthropic",
     "openai",