@volley/recognition-client-sdk 0.1.622 → 0.1.689

package/dist/browser.bundled.d.ts

@@ -12,11 +12,14 @@ declare enum RecognitionProvider {
     DEEPGRAM = "deepgram",
     ELEVENLABS = "elevenlabs",
     FIREWORKS = "fireworks",
+    GLADIA = "gladia",
     GOOGLE = "google",
     GEMINI_BATCH = "gemini-batch",
     OPENAI_BATCH = "openai-batch",
+    SELF_SERVE_VLLM = "self-serve-vllm",
     OPENAI_REALTIME = "openai-realtime",
     MISTRAL_VOXTRAL = "mistral-voxtral",
+    CARTESIA = "cartesia",
     DASHSCOPE = "dashscope",
     TEST_ASR_PROVIDER_QUOTA = "test-asr-provider-quota",
     TEST_ASR_STREAMING = "test-asr-streaming"
@@ -67,6 +70,13 @@ declare enum FireworksModel {
     WHISPER_V3 = "whisper-v3",
     WHISPER_V3_TURBO = "whisper-v3-turbo"
 }
+/**
+ * Gladia Solaria realtime transcription models
+ * @see https://docs.gladia.io/api-reference/v2/live/init
+ */
+declare enum GladiaModel {
+    SOLARIA_1 = "solaria-1"
+}
 /**
  * ElevenLabs Scribe models for speech-to-text
  * @see https://elevenlabs.io/blog/introducing-scribe-v2-realtime
@@ -74,8 +84,7 @@ declare enum FireworksModel {
  * @see https://elevenlabs.io/docs/api-reference/speech-to-text/convert
  */
 declare enum ElevenLabsModel {
-    SCRIBE_V2_REALTIME = "scribe_v2_realtime",
-    SCRIBE_V1 = "scribe_v1"
+    SCRIBE_V2_REALTIME = "scribe_v2_realtime"
 }
 /**
  * OpenAI Realtime API transcription models
@@ -94,6 +103,14 @@ declare enum OpenAIRealtimeModel {
 declare enum MistralVoxtralModel {
     VOXTRAL_MINI_REALTIME_2602 = "voxtral-mini-transcribe-realtime-2602"
 }
+/**
+ * Cartesia Ink-Whisper Realtime transcription models
+ * @see https://docs.cartesia.ai/build-with-cartesia/stt-models
+ */
+declare enum CartesiaModel {
+    INK_WHISPER = "ink-whisper",
+    INK_WHISPER_20250604 = "ink-whisper-2025-06-04"
+}
 /**
  * DashScope Qwen-ASR Realtime transcription models
  * @see https://www.alibabacloud.com/help/en/model-studio/qwen-real-time-speech-recognition
@@ -102,10 +119,17 @@ declare enum DashScopeModel {
     QWEN3_ASR_FLASH_REALTIME_2602 = "qwen3-asr-flash-realtime-2026-02-10",
     QWEN3_ASR_FLASH_REALTIME = "qwen3-asr-flash-realtime"
 }
+/**
+ * Self-serve vLLM batch transcription models
+ * Backed by recognition-inference / RunPod `/transcribe`
+ */
+declare enum SelfServeVllmModel {
+    QWEN3_ASR_1_7B = "qwen3-asr-1.7b"
+}
 /**
  * Type alias for any model from any provider
  */
-type RecognitionModel = DeepgramModel | GoogleModel | FireworksModel | ElevenLabsModel | OpenAIRealtimeModel | MistralVoxtralModel | DashScopeModel | string;
+type RecognitionModel = DeepgramModel | GoogleModel | FireworksModel | GladiaModel | ElevenLabsModel | OpenAIRealtimeModel | MistralVoxtralModel | CartesiaModel | DashScopeModel | SelfServeVllmModel | string;
 
 /**
  * Audio encoding types
@@ -240,7 +264,8 @@ declare enum RecognitionResultTypeV1 {
     METADATA = "Metadata",
     ERROR = "Error",
     CLIENT_CONTROL_MESSAGE = "ClientControlMessage",
-    AUDIO_METRICS = "AudioMetrics"
+    AUDIO_METRICS = "AudioMetrics",
+    SESSION_CONFIGURED = "SessionConfigured"
 }
 /**
  * Transcription result V1 - contains transcript message
@@ -369,6 +394,8 @@ declare const MetadataResultSchemaV1: z.ZodObject<{
     rawAudioTimeMs: z.ZodOptional<z.ZodNumber>;
     costInUSD: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     apiType: z.ZodOptional<z.ZodNativeEnum<typeof ASRApiType>>;
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
     asrConfig: z.ZodOptional<z.ZodString>;
     rawAsrMetadata: z.ZodOptional<z.ZodString>;
     transcriptOutcome: z.ZodOptional<z.ZodNativeEnum<typeof TranscriptOutcomeType>>;
@@ -423,6 +450,8 @@ declare const MetadataResultSchemaV1: z.ZodObject<{
     rawAudioTimeMs?: number | undefined;
     costInUSD?: number | undefined;
     apiType?: ASRApiType | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
     asrConfig?: string | undefined;
     rawAsrMetadata?: string | undefined;
     transcriptOutcome?: TranscriptOutcomeType | undefined;
@@ -453,6 +482,8 @@ declare const MetadataResultSchemaV1: z.ZodObject<{
     rawAudioTimeMs?: number | undefined;
     costInUSD?: number | undefined;
     apiType?: ASRApiType | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
     asrConfig?: string | undefined;
     rawAsrMetadata?: string | undefined;
     transcriptOutcome?: TranscriptOutcomeType | undefined;
@@ -513,6 +544,46 @@ declare const ErrorResultSchemaV1: z.ZodObject<{
     description?: string | undefined;
 }>;
 type ErrorResultV1 = z.infer<typeof ErrorResultSchemaV1>;
+/**
+ * Session configured message V1 - sent after ASR provider is selected and configured
+ * Fires after circuit breaker checks pass and provider/model are finalized,
+ * before audio streaming begins. Contains the actual ASR config that will be used.
+ */
+declare const SessionConfiguredSchemaV1: z.ZodObject<{
+    type: z.ZodLiteral<RecognitionResultTypeV1.SESSION_CONFIGURED>;
+    audioUtteranceId: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    sampleRate: z.ZodOptional<z.ZodNumber>;
+    encoding: z.ZodOptional<z.ZodString>;
+    apiType: z.ZodOptional<z.ZodNativeEnum<typeof ASRApiType>>;
+    isFallback: z.ZodOptional<z.ZodBoolean>;
+    asrRequest: z.ZodOptional<z.ZodString>;
+    providerConfig: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: RecognitionResultTypeV1.SESSION_CONFIGURED;
+    audioUtteranceId: string;
+    provider?: string | undefined;
+    model?: string | undefined;
+    sampleRate?: number | undefined;
+    encoding?: string | undefined;
+    apiType?: ASRApiType | undefined;
+    isFallback?: boolean | undefined;
+    asrRequest?: string | undefined;
+    providerConfig?: string | undefined;
+}, {
+    type: RecognitionResultTypeV1.SESSION_CONFIGURED;
+    audioUtteranceId: string;
+    provider?: string | undefined;
+    model?: string | undefined;
+    sampleRate?: number | undefined;
+    encoding?: string | undefined;
+    apiType?: ASRApiType | undefined;
+    isFallback?: boolean | undefined;
+    asrRequest?: string | undefined;
+    providerConfig?: string | undefined;
+}>;
+type SessionConfiguredV1 = z.infer<typeof SessionConfiguredSchemaV1>;
 
 /**
  * Recognition Context Types V1
@@ -1072,6 +1143,8 @@ interface IRecognitionClientConfig {
     questionAnswerId?: string;
     /** Platform for audio recording device (optional, e.g., 'ios', 'android', 'web', 'unity') */
     platform?: string;
+    /** Experiment cohort (optional). Defaults to 'control' if not provided. */
+    experimentCohort?: 'treatment' | 'control';
     /** Callback when transcript is received */
     onTranscript?: (result: TranscriptionResultV1) => void;
     /**
@@ -1081,6 +1154,8 @@ interface IRecognitionClientConfig {
     onFunctionCall?: (result: FunctionCallResultV1) => void;
     /** Callback when metadata is received. Only once after transcription is complete.*/
     onMetadata?: (metadata: MetadataResultV1) => void;
+    /** Callback when session is configured with actual ASR provider/model (optional) */
+    onSessionConfigured?: (config: SessionConfiguredV1) => void;
     /** Callback when error occurs */
     onError?: (error: ErrorResultV1) => void;
     /** Callback when connected to WebSocket */

package/dist/config-builder.d.ts

@@ -4,7 +4,7 @@
  * Simple builder pattern for RealTimeTwoWayWebSocketRecognitionClientConfig
  */
 import type { RealTimeTwoWayWebSocketRecognitionClientConfig, RecognitionCallbackUrl } from './recognition-client.types.js';
-import type { ASRRequestConfig, GameContextV1, TranscriptionResultV1, MetadataResultV1, ErrorResultV1, Stage } from '@recog/shared-types';
+import type { ASRRequestConfig, GameContextV1, TranscriptionResultV1, MetadataResultV1, SessionConfiguredV1, ErrorResultV1, Stage } from '@recog/shared-types';
 /**
  * Builder for RealTimeTwoWayWebSocketRecognitionClientConfig
  *
@@ -86,6 +86,10 @@ export declare class ConfigBuilder {
      * Set platform
      */
     platform(platform: string): this;
+    /**
+     * Set experiment cohort (optional, defaults to 'control')
+     */
+    experimentCohort(cohort: 'treatment' | 'control'): this;
     /**
      * Set transcript callback
      */
@@ -94,6 +98,10 @@ export declare class ConfigBuilder {
      * Set metadata callback
      */
     onMetadata(callback: (metadata: MetadataResultV1) => void): this;
+    /**
+     * Set session configured callback (optional)
+     */
+    onSessionConfigured(callback: (config: SessionConfiguredV1) => void): this;
     /**
      * Set error callback
      */

package/dist/config-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-builder.d.ts","sourceRoot":"","sources":["../src/config-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,8CAA8C,EAC9C,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,KAAK,EACN,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA+D;IAE7E;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKtB;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAKhD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAKzC;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,sBAAsB,EAAE,GAAG,IAAI;IAKlD;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK1B;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,GAAG,IAAI;IAKrE;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAKhE;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAKvD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAKvC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAKtE;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3C;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKrC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAKvG;;OAEG;IACH,KAAK,IAAI,8CAA8C;CAGxD"}
+{"version":3,"file":"config-builder.d.ts","sourceRoot":"","sources":["../src/config-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,8CAA8C,EAC9C,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,KAAK,EACN,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA+D;IAE7E;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKtB;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAKhD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAKzC;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,sBAAsB,EAAE,GAAG,IAAI;IAKlD;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK1B;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI;IAKvD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,GAAG,IAAI;IAKrE;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAKhE;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAAG,IAAI;IAK1E;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAKvD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAKvC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAKtE;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3C;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKrC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAKvG;;OAEG;IACH,KAAK,IAAI,8CAA8C;CAGxD"}

package/dist/index.bundled.d.ts

@@ -12,11 +12,14 @@ declare enum RecognitionProvider {
     DEEPGRAM = "deepgram",
     ELEVENLABS = "elevenlabs",
     FIREWORKS = "fireworks",
+    GLADIA = "gladia",
     GOOGLE = "google",
     GEMINI_BATCH = "gemini-batch",
     OPENAI_BATCH = "openai-batch",
+    SELF_SERVE_VLLM = "self-serve-vllm",
     OPENAI_REALTIME = "openai-realtime",
     MISTRAL_VOXTRAL = "mistral-voxtral",
+    CARTESIA = "cartesia",
     DASHSCOPE = "dashscope",
     TEST_ASR_PROVIDER_QUOTA = "test-asr-provider-quota",
     TEST_ASR_STREAMING = "test-asr-streaming"
@@ -67,6 +70,13 @@ declare enum FireworksModel {
     WHISPER_V3 = "whisper-v3",
     WHISPER_V3_TURBO = "whisper-v3-turbo"
 }
+/**
+ * Gladia Solaria realtime transcription models
+ * @see https://docs.gladia.io/api-reference/v2/live/init
+ */
+declare enum GladiaModel {
+    SOLARIA_1 = "solaria-1"
+}
 /**
  * ElevenLabs Scribe models for speech-to-text
  * @see https://elevenlabs.io/blog/introducing-scribe-v2-realtime
@@ -74,8 +84,7 @@ declare enum FireworksModel {
  * @see https://elevenlabs.io/docs/api-reference/speech-to-text/convert
  */
 declare enum ElevenLabsModel {
-    SCRIBE_V2_REALTIME = "scribe_v2_realtime",
-    SCRIBE_V1 = "scribe_v1"
+    SCRIBE_V2_REALTIME = "scribe_v2_realtime"
 }
 /**
  * OpenAI Realtime API transcription models
@@ -94,6 +103,14 @@ declare enum OpenAIRealtimeModel {
 declare enum MistralVoxtralModel {
     VOXTRAL_MINI_REALTIME_2602 = "voxtral-mini-transcribe-realtime-2602"
 }
+/**
+ * Cartesia Ink-Whisper Realtime transcription models
+ * @see https://docs.cartesia.ai/build-with-cartesia/stt-models
+ */
+declare enum CartesiaModel {
+    INK_WHISPER = "ink-whisper",
+    INK_WHISPER_20250604 = "ink-whisper-2025-06-04"
+}
 /**
  * DashScope Qwen-ASR Realtime transcription models
  * @see https://www.alibabacloud.com/help/en/model-studio/qwen-real-time-speech-recognition
@@ -102,10 +119,17 @@ declare enum DashScopeModel {
     QWEN3_ASR_FLASH_REALTIME_2602 = "qwen3-asr-flash-realtime-2026-02-10",
     QWEN3_ASR_FLASH_REALTIME = "qwen3-asr-flash-realtime"
 }
+/**
+ * Self-serve vLLM batch transcription models
+ * Backed by recognition-inference / RunPod `/transcribe`
+ */
+declare enum SelfServeVllmModel {
+    QWEN3_ASR_1_7B = "qwen3-asr-1.7b"
+}
 /**
  * Type alias for any model from any provider
  */
-type RecognitionModel = DeepgramModel | GoogleModel | FireworksModel | ElevenLabsModel | OpenAIRealtimeModel | MistralVoxtralModel | DashScopeModel | string;
+type RecognitionModel = DeepgramModel | GoogleModel | FireworksModel | GladiaModel | ElevenLabsModel | OpenAIRealtimeModel | MistralVoxtralModel | CartesiaModel | DashScopeModel | SelfServeVllmModel | string;
 
 /**
  * Audio encoding types
@@ -240,7 +264,8 @@ declare enum RecognitionResultTypeV1 {
     METADATA = "Metadata",
     ERROR = "Error",
     CLIENT_CONTROL_MESSAGE = "ClientControlMessage",
-    AUDIO_METRICS = "AudioMetrics"
+    AUDIO_METRICS = "AudioMetrics",
+    SESSION_CONFIGURED = "SessionConfigured"
 }
 /**
  * Transcription result V1 - contains transcript message
@@ -369,6 +394,8 @@ declare const MetadataResultSchemaV1: z.ZodObject<{
     rawAudioTimeMs: z.ZodOptional<z.ZodNumber>;
     costInUSD: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     apiType: z.ZodOptional<z.ZodNativeEnum<typeof ASRApiType>>;
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
     asrConfig: z.ZodOptional<z.ZodString>;
     rawAsrMetadata: z.ZodOptional<z.ZodString>;
     transcriptOutcome: z.ZodOptional<z.ZodNativeEnum<typeof TranscriptOutcomeType>>;
@@ -423,6 +450,8 @@ declare const MetadataResultSchemaV1: z.ZodObject<{
     rawAudioTimeMs?: number | undefined;
     costInUSD?: number | undefined;
     apiType?: ASRApiType | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
     asrConfig?: string | undefined;
     rawAsrMetadata?: string | undefined;
     transcriptOutcome?: TranscriptOutcomeType | undefined;
@@ -453,6 +482,8 @@ declare const MetadataResultSchemaV1: z.ZodObject<{
     rawAudioTimeMs?: number | undefined;
     costInUSD?: number | undefined;
     apiType?: ASRApiType | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
     asrConfig?: string | undefined;
     rawAsrMetadata?: string | undefined;
     transcriptOutcome?: TranscriptOutcomeType | undefined;
@@ -522,6 +553,46 @@ declare enum ClientControlActionV1 {
     READY_FOR_UPLOADING_RECORDING = "ready_for_uploading_recording",
     STOP_RECORDING = "stop_recording"
 }
+/**
+ * Session configured message V1 - sent after ASR provider is selected and configured
+ * Fires after circuit breaker checks pass and provider/model are finalized,
+ * before audio streaming begins. Contains the actual ASR config that will be used.
+ */
+declare const SessionConfiguredSchemaV1: z.ZodObject<{
+    type: z.ZodLiteral<RecognitionResultTypeV1.SESSION_CONFIGURED>;
+    audioUtteranceId: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    sampleRate: z.ZodOptional<z.ZodNumber>;
+    encoding: z.ZodOptional<z.ZodString>;
+    apiType: z.ZodOptional<z.ZodNativeEnum<typeof ASRApiType>>;
+    isFallback: z.ZodOptional<z.ZodBoolean>;
+    asrRequest: z.ZodOptional<z.ZodString>;
+    providerConfig: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: RecognitionResultTypeV1.SESSION_CONFIGURED;
+    audioUtteranceId: string;
+    provider?: string | undefined;
+    model?: string | undefined;
+    sampleRate?: number | undefined;
+    encoding?: string | undefined;
+    apiType?: ASRApiType | undefined;
+    isFallback?: boolean | undefined;
+    asrRequest?: string | undefined;
+    providerConfig?: string | undefined;
+}, {
+    type: RecognitionResultTypeV1.SESSION_CONFIGURED;
+    audioUtteranceId: string;
+    provider?: string | undefined;
+    model?: string | undefined;
+    sampleRate?: number | undefined;
+    encoding?: string | undefined;
+    apiType?: ASRApiType | undefined;
+    isFallback?: boolean | undefined;
+    asrRequest?: string | undefined;
+    providerConfig?: string | undefined;
+}>;
+type SessionConfiguredV1 = z.infer<typeof SessionConfiguredSchemaV1>;
 
 /**
  * Error Exception Types
@@ -1832,6 +1903,8 @@ interface IRecognitionClientConfig {
     questionAnswerId?: string;
     /** Platform for audio recording device (optional, e.g., 'ios', 'android', 'web', 'unity') */
     platform?: string;
+    /** Experiment cohort (optional). Defaults to 'control' if not provided. */
+    experimentCohort?: 'treatment' | 'control';
     /** Callback when transcript is received */
     onTranscript?: (result: TranscriptionResultV1) => void;
     /**
@@ -1841,6 +1914,8 @@ interface IRecognitionClientConfig {
     onFunctionCall?: (result: FunctionCallResultV1) => void;
     /** Callback when metadata is received. Only once after transcription is complete.*/
     onMetadata?: (metadata: MetadataResultV1) => void;
+    /** Callback when session is configured with actual ASR provider/model (optional) */
+    onSessionConfigured?: (config: SessionConfiguredV1) => void;
     /** Callback when error occurs */
     onError?: (error: ErrorResultV1) => void;
     /** Callback when connected to WebSocket */
@@ -2267,6 +2342,10 @@ declare class ConfigBuilder {
      * Set platform
      */
     platform(platform: string): this;
+    /**
+     * Set experiment cohort (optional, defaults to 'control')
+     */
+    experimentCohort(cohort: 'treatment' | 'control'): this;
     /**
      * Set transcript callback
      */
@@ -2275,6 +2354,10 @@ declare class ConfigBuilder {
      * Set metadata callback
      */
     onMetadata(callback: (metadata: MetadataResultV1) => void): this;
+    /**
+     * Set session configured callback (optional)
+     */
+    onSessionConfigured(callback: (config: SessionConfiguredV1) => void): this;
     /**
      * Set error callback
      */
@@ -2737,5 +2820,5 @@ declare function getRecognitionConductorHttpBase(stage?: Stage | string | null |
 declare function getRecognitionConductorWsBase(stage?: Stage | string | null | undefined): string;
 declare function getRecognitionConductorHost(stage?: Stage | string | null | undefined): string;
 
-export { AudioEncoding, ClientControlActionV1, ClientState, ConfigBuilder, ConnectionError, ControlSignalTypeV1 as ControlSignal, ControlSignalTypeV1, DashScopeModel, DeepgramModel, ElevenLabsModel, ErrorTypeV1, FinalTranscriptStability, FireworksModel, GeminiModel, GoogleModel, Language, MistralVoxtralModel, OpenAIModel, OpenAIRealtimeModel, RECOGNITION_CONDUCTOR_BASES, RECOGNITION_SERVICE_BASES, RealTimeTwoWayWebSocketRecognitionClient, RecognitionContextTypeV1, RecognitionError, RecognitionProvider, RecognitionResultTypeV1, RecognitionVGFStateSchema, RecordingStatus, STAGES, SampleRate, SimplifiedVGFRecognitionClient, TimeoutError, TranscriptionStatus, ValidationError, createClient, createClientWithBuilder, createDefaultASRConfig, createInitialRecognitionState, createSimplifiedVGFClient, getRecognitionConductorBase, getRecognitionConductorHost, getRecognitionConductorHttpBase, getRecognitionConductorWsBase, getRecognitionServiceBase, getRecognitionServiceHost, getRecognitionServiceHttpBase, getRecognitionServiceWsBase, getUserFriendlyMessage, isExceptionImmediatelyAvailable, isNormalDisconnection, isValidRecordingStatusTransition, normalizeStage, resetRecognitionVGFState };
+export { AudioEncoding, CartesiaModel, ClientControlActionV1, ClientState, ConfigBuilder, ConnectionError, ControlSignalTypeV1 as ControlSignal, ControlSignalTypeV1, DashScopeModel, DeepgramModel, ElevenLabsModel, ErrorTypeV1, FinalTranscriptStability, FireworksModel, GeminiModel, GladiaModel, GoogleModel, Language, MistralVoxtralModel, OpenAIModel, OpenAIRealtimeModel, RECOGNITION_CONDUCTOR_BASES, RECOGNITION_SERVICE_BASES, RealTimeTwoWayWebSocketRecognitionClient, RecognitionContextTypeV1, RecognitionError, RecognitionProvider, RecognitionResultTypeV1, RecognitionVGFStateSchema, RecordingStatus, STAGES, SampleRate, SelfServeVllmModel, SimplifiedVGFRecognitionClient, TimeoutError, TranscriptionStatus, ValidationError, createClient, createClientWithBuilder, createDefaultASRConfig, createInitialRecognitionState, createSimplifiedVGFClient, getRecognitionConductorBase, getRecognitionConductorHost, getRecognitionConductorHttpBase, getRecognitionConductorWsBase, getRecognitionServiceBase, getRecognitionServiceHost, getRecognitionServiceHttpBase, getRecognitionServiceWsBase, getUserFriendlyMessage, isExceptionImmediatelyAvailable, isNormalDisconnection, isValidRecordingStatusTransition, normalizeStage, resetRecognitionVGFState };
 export type { ASRRequestConfig, ASRRequestV1, AuthenticationException, ConnectionException, ErrorResultV1, FunctionCallResultV1, GameContextV1, IRecognitionClient, IRecognitionClientConfig, IRecognitionClientStats, ISimplifiedVGFRecognitionClient, MetadataResultV1, ProviderException, QuotaExceededException, RealTimeTwoWayWebSocketRecognitionClientConfig, RecognitionCallbackUrl, RecognitionException, RecognitionState, RecordingStatusType, SimplifiedVGFClientConfig, SlotMap, Stage, TimeoutException, TranscriptionResult, TranscriptionResultV1, TranscriptionStatusType, UnknownException, ValidationException };

package/dist/index.d.ts

@@ -11,6 +11,6 @@ export { type RecognitionState, RecognitionVGFStateSchema, RecordingStatus, Tran
 export { resetRecognitionVGFState } from './vgf-recognition-mapper.js';
 export { AudioEncoding } from '@recog/websocket';
 export { type GameContextV1, type SlotMap, RecognitionContextTypeV1, ControlSignalTypeV1, ControlSignalTypeV1 as ControlSignal, // Alias for backward compatibility
-type TranscriptionResultV1, type FunctionCallResultV1, type MetadataResultV1, type ErrorResultV1, RecognitionResultTypeV1, ClientControlActionV1, type ASRRequestConfig, type ASRRequestV1, FinalTranscriptStability, createDefaultASRConfig, RecognitionProvider, DeepgramModel, ElevenLabsModel, FireworksModel, GoogleModel, GeminiModel, OpenAIModel, OpenAIRealtimeModel, MistralVoxtralModel, DashScopeModel, Language, SampleRate, STAGES, type Stage } from '@recog/shared-types';
+type TranscriptionResultV1, type FunctionCallResultV1, type MetadataResultV1, type ErrorResultV1, RecognitionResultTypeV1, ClientControlActionV1, type ASRRequestConfig, type ASRRequestV1, FinalTranscriptStability, createDefaultASRConfig, RecognitionProvider, DeepgramModel, ElevenLabsModel, FireworksModel, GladiaModel, GoogleModel, GeminiModel, OpenAIModel, SelfServeVllmModel, OpenAIRealtimeModel, MistralVoxtralModel, CartesiaModel, DashScopeModel, Language, SampleRate, STAGES, type Stage } from '@recog/shared-types';
 export { getRecognitionServiceBase, getRecognitionServiceHttpBase, getRecognitionServiceWsBase, getRecognitionServiceHost, getRecognitionConductorBase, getRecognitionConductorHttpBase, getRecognitionConductorWsBase, getRecognitionConductorHost, normalizeStage, RECOGNITION_SERVICE_BASES, RECOGNITION_CONDUCTOR_BASES } from '@recog/shared-config';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wCAAwC,EACxC,KAAK,8CAA8C,EACnD,KAAK,mBAAmB,EACxB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,WAAW,EACZ,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGrE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC/B,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EACL,KAAK,gBAAgB,EACrB,yBAAyB,EACzB,eAAe,EACf,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,gCAAgC,EACjC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,IAAI,aAAa,EAAG,mCAAmC;AAG1E,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,uBAAuB,EACvB,qBAAqB,EAGrB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,cAAc,EACd,WAAW,EACX,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,QAAQ,EACR,UAAU,EAGV,MAAM,EACN,KAAK,KAAK,EACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,EAC3B,yBAAyB,EACzB,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,EAC3B,cAAc,EACd,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wCAAwC,EACxC,KAAK,8CAA8C,EACnD,KAAK,mBAAmB,EACxB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,WAAW,EACZ,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGrE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC/B,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EACL,KAAK,gBAAgB,EACrB,yBAAyB,EACzB,eAAe,EACf,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,gCAAgC,EACjC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,IAAI,aAAa,EAAG,mCAAmC;AAG1E,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,uBAAuB,EACvB,qBAAqB,EAGrB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,cAAc,EACd,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,QAAQ,EACR,UAAU,EAGV,MAAM,EACN,KAAK,KAAK,EACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,EAC3B,yBAAyB,EACzB,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,EAC3B,cAAc,EACd,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,sBAAsB,CAAC"}