@volley/recognition-client-sdk 0.1.670 → 0.1.707

package/dist/browser.bundled.d.ts

@@ -21,6 +21,7 @@ declare enum RecognitionProvider {
     MISTRAL_VOXTRAL = "mistral-voxtral",
     CARTESIA = "cartesia",
     DASHSCOPE = "dashscope",
+    BEDROCK = "bedrock",
     TEST_ASR_PROVIDER_QUOTA = "test-asr-provider-quota",
     TEST_ASR_STREAMING = "test-asr-streaming"
 }
@@ -119,6 +120,15 @@ declare enum DashScopeModel {
     QWEN3_ASR_FLASH_REALTIME_2602 = "qwen3-asr-flash-realtime-2026-02-10",
     QWEN3_ASR_FLASH_REALTIME = "qwen3-asr-flash-realtime"
 }
+/**
+ * AWS Bedrock batch transcription models
+ * Accessed via AWS Bedrock InvokeModelWithResponseStream
+ * @see https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-mistral.html
+ */
+declare enum BedrockModel {
+    VOXTRAL_MINI_3B_2507 = "mistral.voxtral-mini-3b-2507",
+    VOXTRAL_SMALL_24B_2507 = "mistral.voxtral-small-24b-2507"
+}
 /**
  * Self-serve vLLM batch transcription models
  * Backed by recognition-inference / RunPod `/transcribe`
@@ -129,7 +139,7 @@ declare enum SelfServeVllmModel {
 /**
  * Type alias for any model from any provider
  */
-type RecognitionModel = DeepgramModel | GoogleModel | FireworksModel | GladiaModel | ElevenLabsModel | OpenAIRealtimeModel | MistralVoxtralModel | CartesiaModel | DashScopeModel | SelfServeVllmModel | string;
+type RecognitionModel = DeepgramModel | GoogleModel | FireworksModel | GladiaModel | ElevenLabsModel | OpenAIRealtimeModel | MistralVoxtralModel | CartesiaModel | DashScopeModel | SelfServeVllmModel | BedrockModel | string;
 
 /**
  * Audio encoding types
@@ -264,7 +274,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
@@ -543,6 +554,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
@@ -1102,6 +1153,10 @@ 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';
+    /** Explicit major version for ASR config selection (e.g. 1, 3). Takes precedence over experimentCohort. */
+    experimentMajorVersion?: number;
     /** Callback when transcript is received */
     onTranscript?: (result: TranscriptionResultV1) => void;
     /**
@@ -1111,6 +1166,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,15 @@ export declare class ConfigBuilder {
      * Set platform
      */
     platform(platform: string): this;
+    /**
+     * Set experiment cohort (optional, defaults to 'control')
+     */
+    experimentCohort(cohort: 'treatment' | 'control'): this;
+    /**
+     * Set explicit major version for ASR config selection.
+     * Takes precedence over experimentCohort-based version resolution.
+     */
+    experimentMajorVersion(version: number): this;
     /**
      * Set transcript callback
      */
@@ -94,6 +103,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;;;OAGG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK7C;;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"}