@volley/recognition-client-sdk 0.1.384 → 0.1.417

package/dist/index.bundled.d.ts

@@ -218,7 +218,8 @@ declare enum RecognitionResultTypeV1 {
     FUNCTION_CALL = "FunctionCall",
     METADATA = "Metadata",
     ERROR = "Error",
-    CLIENT_CONTROL_MESSAGE = "ClientControlMessage"
+    CLIENT_CONTROL_MESSAGE = "ClientControlMessage",
+    AUDIO_METRICS = "AudioMetrics"
 }
 /**
  * Transcription result V1 - contains transcript message
@@ -293,6 +294,18 @@ declare const FunctionCallResultSchemaV1: z.ZodObject<{
     functionArgJson: string;
 }>;
 type FunctionCallResultV1 = z.infer<typeof FunctionCallResultSchemaV1>;
+/**
+ * Transcript outcome type - categorizes final transcript state
+ * Used in Metadata schema. Maps 1:1 with Datadog metrics:
+ * - WITH_CONTENT → recog.client.websocket.transcript.final_with_content
+ * - EMPTY → recog.client.websocket.transcript.final_empty
+ * - NEVER_SENT → derived from sessions.streamed - final_with_content - final_empty
+ */
+declare enum TranscriptOutcomeType {
+    WITH_CONTENT = "with_content",
+    EMPTY = "empty",
+    NEVER_SENT = "never_sent"
+}
 /**
  * Metadata result V1 - contains metadata, timing information, and ASR config
  * Sent when the provider connection closes to provide final timing metrics and config
@@ -312,6 +325,7 @@ declare const MetadataResultSchemaV1: z.ZodObject<{
     apiType: z.ZodOptional<z.ZodNativeEnum<typeof ASRApiType>>;
     asrConfig: z.ZodOptional<z.ZodString>;
     rawAsrMetadata: z.ZodOptional<z.ZodString>;
+    transcriptOutcome: z.ZodOptional<z.ZodNativeEnum<typeof TranscriptOutcomeType>>;
 }, "strip", z.ZodTypeAny, {
     type: RecognitionResultTypeV1.METADATA;
     audioUtteranceId: string;
@@ -326,6 +340,7 @@ declare const MetadataResultSchemaV1: z.ZodObject<{
     apiType?: ASRApiType | undefined;
     asrConfig?: string | undefined;
     rawAsrMetadata?: string | undefined;
+    transcriptOutcome?: TranscriptOutcomeType | undefined;
 }, {
     type: RecognitionResultTypeV1.METADATA;
     audioUtteranceId: string;
@@ -340,6 +355,7 @@ declare const MetadataResultSchemaV1: z.ZodObject<{
     apiType?: ASRApiType | undefined;
     asrConfig?: string | undefined;
     rawAsrMetadata?: string | undefined;
+    transcriptOutcome?: TranscriptOutcomeType | undefined;
 }>;
 type MetadataResultV1 = z.infer<typeof MetadataResultSchemaV1>;
 /**
@@ -405,11 +421,11 @@ declare enum ClientControlActionV1 {
  * These are system configuration issues, not user-facing
  */
 declare const AuthenticationExceptionSchema: z.ZodObject<{
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.AUTHENTICATION_ERROR>;
     isImmediatelyAvailable: z.ZodLiteral<false>;
@@ -419,10 +435,10 @@ declare const AuthenticationExceptionSchema: z.ZodObject<{
     message: string;
     errorType: ErrorTypeV1.AUTHENTICATION_ERROR;
     isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     service?: string | undefined;
     authMethod?: string | undefined;
@@ -430,10 +446,10 @@ declare const AuthenticationExceptionSchema: z.ZodObject<{
     message: string;
     errorType: ErrorTypeV1.AUTHENTICATION_ERROR;
     isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     service?: string | undefined;
     authMethod?: string | undefined;
@@ -445,11 +461,11 @@ type AuthenticationException = z.infer<typeof AuthenticationExceptionSchema>;
  * User provided invalid input - can show them what's wrong
  */
 declare const ValidationExceptionSchema: z.ZodObject<{
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.VALIDATION_ERROR>;
     isImmediatelyAvailable: z.ZodLiteral<true>;
@@ -460,10 +476,10 @@ declare const ValidationExceptionSchema: z.ZodObject<{
     message: string;
     errorType: ErrorTypeV1.VALIDATION_ERROR;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     field?: string | undefined;
     expected?: string | undefined;
@@ -472,10 +488,10 @@ declare const ValidationExceptionSchema: z.ZodObject<{
     message: string;
     errorType: ErrorTypeV1.VALIDATION_ERROR;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     field?: string | undefined;
     expected?: string | undefined;
@@ -490,8 +506,8 @@ type ValidationException = z.infer<typeof ValidationExceptionSchema>;
 declare const ProviderExceptionSchema: z.ZodObject<{
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.PROVIDER_ERROR>;
     isImmediatelyAvailable: z.ZodLiteral<false>;
@@ -503,8 +519,8 @@ declare const ProviderExceptionSchema: z.ZodObject<{
     errorType: ErrorTypeV1.PROVIDER_ERROR;
     isImmediatelyAvailable: false;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     provider?: string | undefined;
     providerErrorCode?: string | number | undefined;
@@ -514,8 +530,8 @@ declare const ProviderExceptionSchema: z.ZodObject<{
     errorType: ErrorTypeV1.PROVIDER_ERROR;
     isImmediatelyAvailable: false;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     provider?: string | undefined;
     providerErrorCode?: string | number | undefined;
@@ -528,11 +544,11 @@ type ProviderException = z.infer<typeof ProviderExceptionSchema>;
  * Request took too long - user should try again
  */
 declare const TimeoutExceptionSchema: z.ZodObject<{
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.TIMEOUT_ERROR>;
     isImmediatelyAvailable: z.ZodLiteral<true>;
@@ -542,10 +558,10 @@ declare const TimeoutExceptionSchema: z.ZodObject<{
     message: string;
     errorType: ErrorTypeV1.TIMEOUT_ERROR;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     timeoutMs?: number | undefined;
     operation?: string | undefined;
@@ -553,10 +569,10 @@ declare const TimeoutExceptionSchema: z.ZodObject<{
     message: string;
     errorType: ErrorTypeV1.TIMEOUT_ERROR;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     timeoutMs?: number | undefined;
     operation?: string | undefined;
@@ -568,11 +584,11 @@ type TimeoutException = z.infer<typeof TimeoutExceptionSchema>;
  * Rate limit or quota exceeded - user should wait
  */
 declare const QuotaExceededExceptionSchema: z.ZodObject<{
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.QUOTA_EXCEEDED>;
     isImmediatelyAvailable: z.ZodLiteral<true>;
@@ -583,10 +599,10 @@ declare const QuotaExceededExceptionSchema: z.ZodObject<{
     message: string;
     errorType: ErrorTypeV1.QUOTA_EXCEEDED;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     quotaType?: string | undefined;
     resetAt?: number | undefined;
@@ -595,10 +611,10 @@ declare const QuotaExceededExceptionSchema: z.ZodObject<{
     message: string;
     errorType: ErrorTypeV1.QUOTA_EXCEEDED;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     quotaType?: string | undefined;
     resetAt?: number | undefined;
@@ -611,11 +627,11 @@ type QuotaExceededException = z.infer<typeof QuotaExceededExceptionSchema>;
  * Connection establishment or network failure - user should check network or retry
  */
 declare const ConnectionExceptionSchema: z.ZodObject<{
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.CONNECTION_ERROR>;
     isImmediatelyAvailable: z.ZodLiteral<true>;
@@ -626,10 +642,10 @@ declare const ConnectionExceptionSchema: z.ZodObject<{
     message: string;
     errorType: ErrorTypeV1.CONNECTION_ERROR;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     attempts?: number | undefined;
     url?: string | undefined;
@@ -638,10 +654,10 @@ declare const ConnectionExceptionSchema: z.ZodObject<{
     message: string;
     errorType: ErrorTypeV1.CONNECTION_ERROR;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     attempts?: number | undefined;
     url?: string | undefined;
@@ -654,11 +670,11 @@ type ConnectionException = z.infer<typeof ConnectionExceptionSchema>;
  * Unexpected error - needs investigation
  */
 declare const UnknownExceptionSchema: z.ZodObject<{
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.UNKNOWN_ERROR>;
     isImmediatelyAvailable: z.ZodLiteral<false>;
@@ -668,10 +684,10 @@ declare const UnknownExceptionSchema: z.ZodObject<{
     message: string;
     errorType: ErrorTypeV1.UNKNOWN_ERROR;
     isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     stack?: string | undefined;
     context?: Record<string, unknown> | undefined;
@@ -679,10 +695,10 @@ declare const UnknownExceptionSchema: z.ZodObject<{
     message: string;
     errorType: ErrorTypeV1.UNKNOWN_ERROR;
     isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     stack?: string | undefined;
     context?: Record<string, unknown> | undefined;
@@ -693,11 +709,11 @@ type UnknownException = z.infer<typeof UnknownExceptionSchema>;
  * Use this for type-safe error handling
  */
 declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [z.ZodObject<{
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.AUTHENTICATION_ERROR>;
     isImmediatelyAvailable: z.ZodLiteral<false>;
@@ -707,10 +723,10 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     message: string;
     errorType: ErrorTypeV1.AUTHENTICATION_ERROR;
     isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     service?: string | undefined;
     authMethod?: string | undefined;
@@ -718,19 +734,19 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     message: string;
     errorType: ErrorTypeV1.AUTHENTICATION_ERROR;
     isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     service?: string | undefined;
     authMethod?: string | undefined;
 }>, z.ZodObject<{
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.VALIDATION_ERROR>;
     isImmediatelyAvailable: z.ZodLiteral<true>;
@@ -741,10 +757,10 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     message: string;
     errorType: ErrorTypeV1.VALIDATION_ERROR;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     field?: string | undefined;
     expected?: string | undefined;
@@ -753,10 +769,10 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     message: string;
     errorType: ErrorTypeV1.VALIDATION_ERROR;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     field?: string | undefined;
     expected?: string | undefined;
@@ -764,8 +780,8 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
 }>, z.ZodObject<{
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.PROVIDER_ERROR>;
     isImmediatelyAvailable: z.ZodLiteral<false>;
@@ -777,8 +793,8 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     errorType: ErrorTypeV1.PROVIDER_ERROR;
     isImmediatelyAvailable: false;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     provider?: string | undefined;
     providerErrorCode?: string | number | undefined;
@@ -788,18 +804,18 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     errorType: ErrorTypeV1.PROVIDER_ERROR;
     isImmediatelyAvailable: false;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     provider?: string | undefined;
     providerErrorCode?: string | number | undefined;
     isTransient?: boolean | undefined;
 }>, z.ZodObject<{
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.TIMEOUT_ERROR>;
     isImmediatelyAvailable: z.ZodLiteral<true>;
@@ -809,10 +825,10 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     message: string;
     errorType: ErrorTypeV1.TIMEOUT_ERROR;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     timeoutMs?: number | undefined;
     operation?: string | undefined;
@@ -820,19 +836,19 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     message: string;
     errorType: ErrorTypeV1.TIMEOUT_ERROR;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     timeoutMs?: number | undefined;
     operation?: string | undefined;
 }>, z.ZodObject<{
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.QUOTA_EXCEEDED>;
     isImmediatelyAvailable: z.ZodLiteral<true>;
@@ -843,10 +859,10 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     message: string;
     errorType: ErrorTypeV1.QUOTA_EXCEEDED;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     quotaType?: string | undefined;
     resetAt?: number | undefined;
@@ -855,20 +871,20 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     message: string;
     errorType: ErrorTypeV1.QUOTA_EXCEEDED;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     quotaType?: string | undefined;
     resetAt?: number | undefined;
     retryAfterSeconds?: number | undefined;
 }>, z.ZodObject<{
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.CONNECTION_ERROR>;
     isImmediatelyAvailable: z.ZodLiteral<true>;
@@ -879,10 +895,10 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     message: string;
     errorType: ErrorTypeV1.CONNECTION_ERROR;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     attempts?: number | undefined;
     url?: string | undefined;
@@ -891,20 +907,20 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     message: string;
     errorType: ErrorTypeV1.CONNECTION_ERROR;
     isImmediatelyAvailable: true;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     attempts?: number | undefined;
     url?: string | undefined;
     underlyingError?: string | undefined;
 }>, z.ZodObject<{
-    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     message: z.ZodString;
-    audioUtteranceId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodNativeEnum<typeof RecognitionProvider>>;
     description: z.ZodOptional<z.ZodString>;
+    audioUtteranceId: z.ZodOptional<z.ZodString>;
     timestamp: z.ZodOptional<z.ZodNumber>;
     errorType: z.ZodLiteral<ErrorTypeV1.UNKNOWN_ERROR>;
     isImmediatelyAvailable: z.ZodLiteral<false>;
@@ -914,10 +930,10 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     message: string;
     errorType: ErrorTypeV1.UNKNOWN_ERROR;
     isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     stack?: string | undefined;
     context?: Record<string, unknown> | undefined;
@@ -925,10 +941,10 @@ declare const RecognitionExceptionSchema: z.ZodDiscriminatedUnion<"errorType", [
     message: string;
     errorType: ErrorTypeV1.UNKNOWN_ERROR;
     isImmediatelyAvailable: false;
-    provider?: RecognitionProvider | undefined;
     code?: string | number | undefined;
-    audioUtteranceId?: string | undefined;
+    provider?: RecognitionProvider | undefined;
     description?: string | undefined;
+    audioUtteranceId?: string | undefined;
     timestamp?: number | undefined;
     stack?: string | undefined;
     context?: Record<string, unknown> | undefined;
@@ -1520,6 +1536,12 @@ interface IRecognitionClientConfig {
     asrRequestConfig?: ASRRequestConfig;
     /** Game context for improved recognition accuracy */
     gameContext?: GameContextV1;
+    /**
+     * Game ID for tracking and routing purposes (optional)
+     * If provided, this is added to the WebSocket URL as a query parameter.
+     * If gameContext is also provided, this takes precedence over gameContext.gameId.
+     */
+    gameId?: string;
     /** Audio utterance ID (optional) - if not provided, a UUID v4 will be generated */
     audioUtteranceId?: string;
     /** Callback URLs for server-side notifications with optional message type filtering (optional)
@@ -1885,6 +1907,11 @@ declare class ConfigBuilder {
      * Set game context
      */
     gameContext(context: GameContextV1): this;
+    /**
+     * Set game ID directly (takes precedence over gameContext.gameId)
+     * Use this when you only need to identify the game without full context.
+     */
+    gameId(id: string): this;
     /**
      * Set audio utterance ID
      */
@@ -2237,6 +2264,7 @@ declare class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognitio
     private stateChangeCallback;
     private expectedUuid;
     private logger;
+    private lastSentTerminalUuid;
     constructor(config: SimplifiedVGFClientConfig);
     connect(): Promise<void>;
     sendAudio(audioData: ArrayBuffer | ArrayBufferView | Blob): void;
@@ -2251,6 +2279,7 @@ declare class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognitio
     isTranscriptionFinished(): boolean;
     isBufferOverflowing(): boolean;
     getVGFState(): RecognitionState;
+    private isTerminalStatus;
     private notifyStateChange;
 }
 /**