@volley/recognition-client-sdk 0.1.803 → 0.1.806

package/dist/recognition-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recognition-client.d.ts","sourceRoot":"","sources":["../src/recognition-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recognition-client.d.ts","sourceRoot":"","sources":["../src/recognition-client.ts"],"names":[],"mappings":"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"}

package/dist/recognition-client.types.d.ts

@@ -4,7 +4,7 @@
  * Type definitions and interfaces for the recognition client SDK.
  * These interfaces enable dependency injection, testing, and alternative implementations.
  */
-import { TranscriptionResultV1, FunctionCallResultV1, MetadataResultV1, ErrorResultV1, SessionConfiguredV1, AudioMetricsResultV1, ASRRequestConfig, GameContextV1, Stage } from '@recog/shared-types';
+import { TranscriptionResultV1, FunctionCallResultV1, MetadataResultV1, ErrorResultV1, SessionConfiguredV1, AudioMetricsResultV1, ASRRequestConfig, GameContextV1, Stage, MicrophoneSourceType } from '@recog/shared-types';
 /**
  * Client connection state enum
  * Represents the various states a recognition client can be in during its lifecycle
@@ -91,6 +91,14 @@ export interface IRecognitionClientConfig {
     accountId?: string;
     /** Question answer identifier for tracking Q&A sessions (optional and tracking purpose only) */
     questionAnswerId?: string;
+    /** Client identifier for downstream tracking/audio-labeling (optional and tracking purpose only) */
+    clientId?: string;
+    /**
+     * Client audio capture path (optional). Accepts the {@link MicrophoneSourceType}
+     * enum or its string value ('web' | 'native'). Defaults to 'web' on the server
+     * when omitted. The service normalizes this to the enum at the boundary.
+     */
+    microphoneSourceType?: MicrophoneSourceType | string;
     /** Platform for audio recording device (optional, e.g., 'ios', 'android', 'web', 'unity') */
     platform?: string;
     /** Experiment cohort (optional). Defaults to 'control' if not provided. */

package/dist/recognition-client.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recognition-client.types.d.ts","sourceRoot":"","sources":["../src/recognition-client.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recognition-client.types.d.ts","sourceRoot":"","sources":["../src/recognition-client.types.ts"],"names":[],"mappings":"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"}

package/dist/simplified-vgf-recognition-client.d.ts

@@ -9,6 +9,7 @@
  */
 import { RecognitionState } from './vgf-recognition-state.js';
 import { IRecognitionClient, IRecognitionClientConfig, IRecognitionClientStats, ClientState } from './recognition-client.types.js';
+import { ConfigBuilder } from './config-builder.js';
 import { type GameContextV1 } from '@recog/shared-types';
 /**
  * Configuration for SimplifiedVGFRecognitionClient
@@ -84,6 +85,40 @@ export declare class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRec
     getVGFState(): RecognitionState;
     private notifyStateChange;
 }
+/**
+ * Fluent builder for {@link SimplifiedVGFClientConfig}.
+ *
+ * Extends {@link ConfigBuilder} with the two VGF-specific fields
+ * (`onStateChange`, `initialState`) so the simplified client has the same
+ * builder ergonomics as the base RealTimeTwoWayWebSocketRecognitionClient.
+ *
+ * Example:
+ * ```typescript
+ * import { STAGES, RecognitionProvider } from '@recog/shared-types';
+ *
+ * const config = new SimplifiedVGFConfigBuilder()
+ *   .stage(STAGES.STAGING)
+ *   .asrRequestConfig({ provider: RecognitionProvider.DEEPGRAM, language: 'en' })
+ *   .onStateChange((state) => setVGFState(state))
+ *   .build();
+ * ```
+ */
+export declare class SimplifiedVGFConfigBuilder extends ConfigBuilder {
+    private vgfConfig;
+    /**
+     * Set the VGF state-change callback, fired whenever the VGF state updates.
+     */
+    onStateChange(callback: (state: RecognitionState) => void): this;
+    /**
+     * Set the initial VGF state to restore from a previous session.
+     * The audioUtteranceId is extracted from it when valid.
+     */
+    initialState(state: RecognitionState): this;
+    /**
+     * Build the SimplifiedVGFClientConfig (base fields + VGF fields).
+     */
+    build(): SimplifiedVGFClientConfig;
+}
 /**
  * Factory function for creating simplified client
  * Usage examples:
@@ -128,4 +163,22 @@ export declare class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRec
  * // VGF state automatically updates based on transcription results
  */
 export declare function createSimplifiedVGFClient(config: SimplifiedVGFClientConfig): ISimplifiedVGFRecognitionClient;
+/**
+ * Create a simplified VGF client using the builder pattern.
+ *
+ * Mirror of `createClientWithBuilder` for the base client.
+ *
+ * Example:
+ * ```typescript
+ * import { STAGES, RecognitionProvider } from '@recog/shared-types';
+ *
+ * const client = createSimplifiedVGFClientWithBuilder((builder) =>
+ *   builder
+ *     .stage(STAGES.STAGING)
+ *     .asrRequestConfig({ provider: RecognitionProvider.DEEPGRAM, language: 'en' })
+ *     .onStateChange((state) => setVGFState(state))
+ * );
+ * ```
+ */
+export declare function createSimplifiedVGFClientWithBuilder(configure: (builder: SimplifiedVGFConfigBuilder) => SimplifiedVGFConfigBuilder): ISimplifiedVGFRecognitionClient;
 //# sourceMappingURL=simplified-vgf-recognition-client.d.ts.map

package/dist/simplified-vgf-recognition-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simplified-vgf-recognition-client.d.ts","sourceRoot":"","sources":["../src/simplified-vgf-recognition-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACH,gBAAgB,EAKnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,WAAW,EACd,MAAM,+BAA+B,CAAC;AAUvC,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,wBAAwB;IACvE;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAElD;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,+BAAgC,SAAQ,kBAAkB;IACvE;;;;OAIG;IACH,WAAW,IAAI,gBAAgB,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,8BAA+B,YAAW,+BAA+B;IAClF,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,mBAAmB,CAAkD;IAC7E,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,oBAAoB,CAAuB;gBAEvC,MAAM,EAAE,yBAAyB;IAoNvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI;IAKhE,uBAAuB,CACnB,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,EAC/C,gBAAgB,EAAE,MAAM,GACzB,IAAI;IAKP,eAAe,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI;IAOtE,QAAQ,IAAI,uBAAuB;IAInC;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAWtB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BpC,cAAc,IAAI,IAAI;IAiCtB,mBAAmB,IAAI,MAAM;IAI7B,MAAM,IAAI,MAAM;IAIhB,QAAQ,IAAI,WAAW;IAIvB,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,OAAO;IAIvB,UAAU,IAAI,OAAO;IAIrB,uBAAuB,IAAI,OAAO;IAIlC,mBAAmB,IAAI,OAAO;IAI9B,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAI7C,aAAa,IAAI,OAAO;IAMxB,WAAW,IAAI,gBAAgB;IAI/B,OAAO,CAAC,iBAAiB;CA8B5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,+BAA+B,CAE5G"}
+{"version":3,"file":"simplified-vgf-recognition-client.d.ts","sourceRoot":"","sources":["../src/simplified-vgf-recognition-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACH,gBAAgB,EAKnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,WAAW,EACd,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASpD,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,wBAAwB;IACvE;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAElD;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,+BAAgC,SAAQ,kBAAkB;IACvE;;;;OAIG;IACH,WAAW,IAAI,gBAAgB,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,8BAA+B,YAAW,+BAA+B;IAClF,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,mBAAmB,CAAkD;IAC7E,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,oBAAoB,CAAuB;gBAEvC,MAAM,EAAE,yBAAyB;IAoNvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI;IAKhE,uBAAuB,CACnB,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,EAC/C,gBAAgB,EAAE,MAAM,GACzB,IAAI;IAKP,eAAe,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI;IAOtE,QAAQ,IAAI,uBAAuB;IAInC;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAWtB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BpC,cAAc,IAAI,IAAI;IAiCtB,mBAAmB,IAAI,MAAM;IAI7B,MAAM,IAAI,MAAM;IAIhB,QAAQ,IAAI,WAAW;IAIvB,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,OAAO;IAIvB,UAAU,IAAI,OAAO;IAIrB,uBAAuB,IAAI,OAAO;IAIlC,mBAAmB,IAAI,OAAO;IAI9B,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAI7C,aAAa,IAAI,OAAO;IAMxB,WAAW,IAAI,gBAAgB;IAI/B,OAAO,CAAC,iBAAiB;CA8B5B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,0BAA2B,SAAQ,aAAa;IACzD,OAAO,CAAC,SAAS,CAAyE;IAE1F;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAKhE;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAK3C;;OAEG;IACM,KAAK,IAAI,yBAAyB;CAG9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,+BAA+B,CAE5G;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oCAAoC,CAChD,SAAS,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,0BAA0B,GAC/E,+BAA+B,CAIjC"}

package/dist/utils/url-builder.d.ts

@@ -2,7 +2,7 @@
  * URL Builder for Recognition Client
  * Handles WebSocket URL construction with query parameters
  */
-import type { GameContextV1, Stage } from '@recog/shared-types';
+import type { GameContextV1, Stage, MicrophoneSourceType } from '@recog/shared-types';
 import type { RecognitionCallbackUrl } from '../recognition-client.types.js';
 export interface UrlBuilderConfig {
     url?: string;
@@ -14,6 +14,8 @@ export interface UrlBuilderConfig {
     deviceId?: string;
     accountId?: string;
     questionAnswerId?: string;
+    clientId?: string;
+    microphoneSourceType?: MicrophoneSourceType | string;
     platform?: string;
     gameContext?: GameContextV1;
     /** Standalone gameId - takes precedence over gameContext.gameId if both provided */

package/dist/utils/url-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-builder.d.ts","sourceRoot":"","sources":["../../src/utils/url-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC3C,sDAAsD;IACtD,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAuElE"}
+{"version":3,"file":"url-builder.d.ts","sourceRoot":"","sources":["../../src/utils/url-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAAC;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC3C,sDAAsD;IACtD,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA6ElE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volley/recognition-client-sdk",
-  "version": "0.1.803",
+  "version": "0.1.806",
   "description": "Recognition Service TypeScript/Node.js Client SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -54,10 +54,10 @@
     "semantic-release": "25.0.1",
     "ts-jest": "29.2.5",
     "typescript": "5.1.6",
-    "@recog/shared-utils": "1.0.0",
-    "@recog/shared-types": "1.0.0",
     "@recog/shared-config": "1.0.0",
-    "@recog/websocket": "1.0.0"
+    "@recog/websocket": "1.0.0",
+    "@recog/shared-types": "1.0.0",
+    "@recog/shared-utils": "1.0.0"
   },
   "keywords": [
     "recognition",

package/src/config-builder.spec.ts

@@ -96,6 +96,20 @@ describe('ConfigBuilder', () => {
     expect(config.questionAnswerId).toBe('qa-xyz');
   });
 
+  it('should set clientId', () => {
+    const config = new ConfigBuilder()
+      .clientId('client-123')
+      .build();
+    expect(config.clientId).toBe('client-123');
+  });
+
+  it('should set microphoneSourceType', () => {
+    const config = new ConfigBuilder()
+      .microphoneSourceType('native')
+      .build();
+    expect(config.microphoneSourceType).toBe('native');
+  });
+
   it('should set platform', () => {
     const config = new ConfigBuilder()
       .platform('ios')

package/src/config-builder.ts

@@ -16,7 +16,8 @@ import type {
   SessionConfiguredV1,
   AudioMetricsResultV1,
   ErrorResultV1,
-  Stage
+  Stage,
+  MicrophoneSourceType
 } from '@recog/shared-types';
 
 /**
@@ -145,6 +146,23 @@ export class ConfigBuilder {
     return this;
   }
 
+  /**
+   * Set client ID (for downstream tracking/audio-labeling)
+   */
+  clientId(id: string): this {
+    this.config.clientId = id;
+    return this;
+  }
+
+  /**
+   * Set the client audio capture path (MicrophoneSourceType enum or 'web' | 'native' string).
+   * Defaults to 'web' on the server when omitted.
+   */
+  microphoneSourceType(source: MicrophoneSourceType | string): this {
+    this.config.microphoneSourceType = source;
+    return this;
+  }
+
   /**
    * Set platform
    */

package/src/index.ts

@@ -53,7 +53,9 @@ export {
 // Export VGF state management (new simplified interface)
 export {
   SimplifiedVGFRecognitionClient,
+  SimplifiedVGFConfigBuilder,
   createSimplifiedVGFClient,
+  createSimplifiedVGFClientWithBuilder,
   type ISimplifiedVGFRecognitionClient,
   type SimplifiedVGFClientConfig
 } from './simplified-vgf-recognition-client.js';
@@ -99,6 +101,7 @@ export {
   FinalTranscriptStability,
   createDefaultASRConfig,
   RecognitionProvider,
+  AssemblyAIModel,
   DeepgramModel,
   ElevenLabsModel,
   FireworksModel,
@@ -117,6 +120,9 @@ export {
   Language,
   SampleRate,
 
+  // Audio capture source
+  MicrophoneSourceType,
+
   // Stage/Environment types
   STAGES,
   type Stage

package/src/recognition-client.ts

@@ -197,6 +197,8 @@ export class RealTimeTwoWayWebSocketRecognitionClient
       ...(config.deviceId && { deviceId: config.deviceId }),
       ...(config.accountId && { accountId: config.accountId }),
       ...(config.questionAnswerId && { questionAnswerId: config.questionAnswerId }),
+      ...(config.clientId && { clientId: config.clientId }),
+      ...(config.microphoneSourceType && { microphoneSourceType: config.microphoneSourceType }),
       ...(config.platform && { platform: config.platform }),
       ...(config.gameContext && { gameContext: config.gameContext }),
       ...(config.gameId && { gameId: config.gameId }),

package/src/recognition-client.types.ts

@@ -14,7 +14,8 @@ import {
   AudioMetricsResultV1,
   ASRRequestConfig,
   GameContextV1,
-  Stage
+  Stage,
+  MicrophoneSourceType
 } from '@recog/shared-types';
 
 /**
@@ -126,6 +127,16 @@ export interface IRecognitionClientConfig {
   /** Question answer identifier for tracking Q&A sessions (optional and tracking purpose only) */
   questionAnswerId?: string;
 
+  /** Client identifier for downstream tracking/audio-labeling (optional and tracking purpose only) */
+  clientId?: string;
+
+  /**
+   * Client audio capture path (optional). Accepts the {@link MicrophoneSourceType}
+   * enum or its string value ('web' | 'native'). Defaults to 'web' on the server
+   * when omitted. The service normalizes this to the enum at the boundary.
+   */
+  microphoneSourceType?: MicrophoneSourceType | string;
+
   /** Platform for audio recording device (optional, e.g., 'ios', 'android', 'web', 'unity') */
   platform?: string;
 

package/src/simplified-vgf-recognition-client.spec.ts

@@ -2,7 +2,12 @@
  * Unit tests for SimplifiedVGFRecognitionClient
  */
 
-import { SimplifiedVGFRecognitionClient, createSimplifiedVGFClient } from './simplified-vgf-recognition-client.js';
+import {
+  SimplifiedVGFRecognitionClient,
+  SimplifiedVGFConfigBuilder,
+  createSimplifiedVGFClient,
+  createSimplifiedVGFClientWithBuilder
+} from './simplified-vgf-recognition-client.js';
 import { RealTimeTwoWayWebSocketRecognitionClient } from './recognition-client.js';
 import { ClientState } from './recognition-client.types.js';
 import { AudioEncoding, RecognitionContextTypeV1, RecognitionResultTypeV1 } from '@recog/shared-types';
@@ -1495,4 +1500,72 @@ describe('SimplifiedVGFRecognitionClient', () => {
       expect(stateChangeCallback).not.toHaveBeenCalled();
     });
   });
+
+  describe('SimplifiedVGFConfigBuilder', () => {
+    const asrConfig = {
+      provider: 'deepgram',
+      language: 'en',
+      sampleRate: 16000,
+      encoding: AudioEncoding.LINEAR16
+    };
+
+    it('should build a config containing both base and VGF-specific fields', () => {
+      const initialState: RecognitionState = {
+        audioUtteranceId: 'restore-123',
+        pendingTranscript: ''
+      };
+
+      const config = new SimplifiedVGFConfigBuilder()
+        .stage('staging')
+        .asrRequestConfig(asrConfig)
+        .onStateChange(stateChangeCallback)
+        .initialState(initialState)
+        .build();
+
+      // Base fields (inherited from ConfigBuilder)
+      expect(config.stage).toBe('staging');
+      expect(config.asrRequestConfig).toEqual(asrConfig);
+      // VGF-specific fields
+      expect(config.onStateChange).toBe(stateChangeCallback);
+      expect(config.initialState).toBe(initialState);
+    });
+
+    it('should allow VGF setters in any order relative to base setters', () => {
+      const config = new SimplifiedVGFConfigBuilder()
+        .onStateChange(stateChangeCallback)
+        .asrRequestConfig(asrConfig)
+        .build();
+
+      expect(config.onStateChange).toBe(stateChangeCallback);
+      expect(config.asrRequestConfig).toEqual(asrConfig);
+    });
+
+    it('should omit VGF fields when their setters are not called', () => {
+      const config = new SimplifiedVGFConfigBuilder()
+        .asrRequestConfig(asrConfig)
+        .build();
+
+      expect(config.onStateChange).toBeUndefined();
+      expect(config.initialState).toBeUndefined();
+    });
+  });
+
+  describe('createSimplifiedVGFClientWithBuilder', () => {
+    it('should create a SimplifiedVGFRecognitionClient with the built config', () => {
+      const client = createSimplifiedVGFClientWithBuilder((builder) =>
+        builder
+          .asrRequestConfig({
+            provider: 'deepgram',
+            language: 'en',
+            sampleRate: 16000,
+            encoding: AudioEncoding.LINEAR16
+          })
+          .onStateChange(stateChangeCallback)
+      );
+
+      expect(client).toBeInstanceOf(SimplifiedVGFRecognitionClient);
+      // VGF wiring is live: getVGFState() works on the constructed client
+      expect(client.getVGFState()).toBeDefined();
+    });
+  });
 });

package/src/simplified-vgf-recognition-client.ts

@@ -22,6 +22,7 @@ import {
     ClientState
 } from './recognition-client.types.js';
 import { RealTimeTwoWayWebSocketRecognitionClient } from './recognition-client.js';
+import { ConfigBuilder } from './config-builder.js';
 import {
     createVGFStateFromConfig,
     mapTranscriptionResultToState,
@@ -479,6 +480,52 @@ export class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognition
     }
 }
 
+/**
+ * Fluent builder for {@link SimplifiedVGFClientConfig}.
+ *
+ * Extends {@link ConfigBuilder} with the two VGF-specific fields
+ * (`onStateChange`, `initialState`) so the simplified client has the same
+ * builder ergonomics as the base RealTimeTwoWayWebSocketRecognitionClient.
+ *
+ * Example:
+ * ```typescript
+ * import { STAGES, RecognitionProvider } from '@recog/shared-types';
+ *
+ * const config = new SimplifiedVGFConfigBuilder()
+ *   .stage(STAGES.STAGING)
+ *   .asrRequestConfig({ provider: RecognitionProvider.DEEPGRAM, language: 'en' })
+ *   .onStateChange((state) => setVGFState(state))
+ *   .build();
+ * ```
+ */
+export class SimplifiedVGFConfigBuilder extends ConfigBuilder {
+    private vgfConfig: Pick<SimplifiedVGFClientConfig, 'onStateChange' | 'initialState'> = {};
+
+    /**
+     * Set the VGF state-change callback, fired whenever the VGF state updates.
+     */
+    onStateChange(callback: (state: RecognitionState) => void): this {
+        this.vgfConfig.onStateChange = callback;
+        return this;
+    }
+
+    /**
+     * Set the initial VGF state to restore from a previous session.
+     * The audioUtteranceId is extracted from it when valid.
+     */
+    initialState(state: RecognitionState): this {
+        this.vgfConfig.initialState = state;
+        return this;
+    }
+
+    /**
+     * Build the SimplifiedVGFClientConfig (base fields + VGF fields).
+     */
+    override build(): SimplifiedVGFClientConfig {
+        return { ...super.build(), ...this.vgfConfig };
+    }
+}
+
 /**
  * Factory function for creating simplified client
  * Usage examples:
@@ -525,3 +572,28 @@ export class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognition
 export function createSimplifiedVGFClient(config: SimplifiedVGFClientConfig): ISimplifiedVGFRecognitionClient {
     return new SimplifiedVGFRecognitionClient(config);
 }
+
+/**
+ * Create a simplified VGF client using the builder pattern.
+ *
+ * Mirror of `createClientWithBuilder` for the base client.
+ *
+ * Example:
+ * ```typescript
+ * import { STAGES, RecognitionProvider } from '@recog/shared-types';
+ *
+ * const client = createSimplifiedVGFClientWithBuilder((builder) =>
+ *   builder
+ *     .stage(STAGES.STAGING)
+ *     .asrRequestConfig({ provider: RecognitionProvider.DEEPGRAM, language: 'en' })
+ *     .onStateChange((state) => setVGFState(state))
+ * );
+ * ```
+ */
+export function createSimplifiedVGFClientWithBuilder(
+    configure: (builder: SimplifiedVGFConfigBuilder) => SimplifiedVGFConfigBuilder
+): ISimplifiedVGFRecognitionClient {
+    const builder = new SimplifiedVGFConfigBuilder();
+    const config = configure(builder).build();
+    return new SimplifiedVGFRecognitionClient(config);
+}

package/src/utils/url-builder.spec.ts

@@ -130,6 +130,24 @@ describe('buildWebSocketUrl', () => {
     expect(url).toContain('questionAnswerId=qa-xyz');
   });
 
+  it('should add clientId to query parameters', () => {
+    const config = {
+      ...baseConfig,
+      clientId: 'client-123'
+    };
+    const url = buildWebSocketUrl(config);
+    expect(url).toContain('clientId=client-123');
+  });
+
+  it('should add microphoneSourceType to query parameters', () => {
+    const config = {
+      ...baseConfig,
+      microphoneSourceType: 'native'
+    };
+    const url = buildWebSocketUrl(config);
+    expect(url).toContain('microphoneSourceType=native');
+  });
+
   it('should add platform to query parameters', () => {
     const config = {
       ...baseConfig,

package/src/utils/url-builder.ts

@@ -4,7 +4,7 @@
  */
 
 import { getRecognitionServiceBase } from '@recog/shared-config';
-import type { GameContextV1, Stage } from '@recog/shared-types';
+import type { GameContextV1, Stage, MicrophoneSourceType } from '@recog/shared-types';
 import type { RecognitionCallbackUrl } from '../recognition-client.types.js';
 
 export interface UrlBuilderConfig {
@@ -17,6 +17,8 @@ export interface UrlBuilderConfig {
   deviceId?: string;
   accountId?: string;
   questionAnswerId?: string;
+  clientId?: string;
+  microphoneSourceType?: MicrophoneSourceType | string;
   platform?: string;
   gameContext?: GameContextV1;
   /** Standalone gameId - takes precedence over gameContext.gameId if both provided */
@@ -77,6 +79,12 @@ export function buildWebSocketUrl(config: UrlBuilderConfig): string {
   if (config.questionAnswerId) {
     url.searchParams.set('questionAnswerId', config.questionAnswerId);
   }
+  if (config.clientId) {
+    url.searchParams.set('clientId', config.clientId);
+  }
+  if (config.microphoneSourceType) {
+    url.searchParams.set('microphoneSourceType', config.microphoneSourceType);
+  }
   if (config.platform) {
     url.searchParams.set('platform', config.platform);
   }