@volley/recognition-client-sdk 0.1.297 → 0.1.381

package/dist/recognition-client.d.ts

@@ -100,6 +100,10 @@ export declare class RealTimeTwoWayWebSocketRecognitionClient extends WebSocketA
     getStats(): IRecognitionClientStats;
     protected onConnected(): void;
     protected onDisconnected(code: number, reason: string): void;
+    /**
+     * Get human-readable description for WebSocket close code
+     */
+    private getCloseCodeDescription;
     protected onError(error: Event): void;
     protected onMessage(msg: {
         v: number;

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

@@ -1 +1 @@
-{"version":3,"file":"recognition-client.d.ts","sourceRoot":"","sources":["../src/recognition-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAML,KAAK,qBAAqB,EAS3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,8CAA8C,EAE/C,MAAM,+BAA+B,CAAC;AAUvC;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AAgCD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAGxD,YAAY,EAAE,8CAA8C,EAAE,MAAM,+BAA+B,CAAC;AAgCpG;;;;;GAKG;AACH,qBAAa,wCACX,SAAQ,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAC7C,YAAW,kBAAkB;IAE7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAK;IAE7C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,iBAAiB,CAA4B;IAGrD,OAAO,CAAC,iBAAiB,CAAS;IAGlC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,qBAAqB,CAAO;IACpC,OAAO,CAAC,iBAAiB,CAAK;gBAElB,MAAM,EAAE,8CAA8C;IA8ElE;;;;;;OAMG;IACH,OAAO,CAAC,GAAG;IAWX;;;OAGG;IACH,OAAO,CAAC,OAAO;IAmBA,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BvC;;;OAGG;YACW,gBAAgB;IAkIrB,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI;IAiBzE,OAAO,CAAC,iBAAiB;IAsCnB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCpC,cAAc,IAAI,IAAI;IAwBtB,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,QAAQ,IAAI,uBAAuB;IAgBnC,SAAS,CAAC,WAAW,IAAI,IAAI;IAiE7B,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAqB5D,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;cAYlB,SAAS,CAAC,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI;IAQ/E;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;;OAGG;IACH,OAAO,CAAC,YAAY;CAuBrB"}
+{"version":3,"file":"recognition-client.d.ts","sourceRoot":"","sources":["../src/recognition-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAML,KAAK,qBAAqB,EAS3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,8CAA8C,EAE/C,MAAM,+BAA+B,CAAC;AAUvC;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AAgCD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAGxD,YAAY,EAAE,8CAA8C,EAAE,MAAM,+BAA+B,CAAC;AAgCpG;;;;;GAKG;AACH,qBAAa,wCACX,SAAQ,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAC7C,YAAW,kBAAkB;IAE7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAK;IAE7C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,iBAAiB,CAA4B;IAGrD,OAAO,CAAC,iBAAiB,CAAS;IAGlC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,qBAAqB,CAAO;IACpC,OAAO,CAAC,iBAAiB,CAAK;gBAElB,MAAM,EAAE,8CAA8C;IA8ElE;;;;;;OAMG;IACH,OAAO,CAAC,GAAG;IAWX;;;OAGG;IACH,OAAO,CAAC,OAAO;IAmBA,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BvC;;;OAGG;YACW,gBAAgB;IAkIrB,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI;IAiBzE,OAAO,CAAC,iBAAiB;IAsCnB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCpC,cAAc,IAAI,IAAI;IAwBtB,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,QAAQ,IAAI,uBAAuB;IAgBnC,SAAS,CAAC,WAAW,IAAI,IAAI;IAiE7B,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA8C5D;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwB/B,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;cAYlB,SAAS,CAAC,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI;IAQ/E;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;;OAGG;IACH,OAAO,CAAC,YAAY;CAuBrB"}

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

@@ -111,6 +111,8 @@ export declare class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRec
     private state;
     private isRecordingAudio;
     private stateChangeCallback;
+    private expectedUuid;
+    private logger;
     constructor(config: SimplifiedVGFClientConfig);
     connect(): Promise<void>;
     sendAudio(audioData: ArrayBuffer | ArrayBufferView | Blob): void;

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,EAGnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEH,wBAAwB,EACxB,WAAW,EACd,MAAM,+BAA+B,CAAC;AAWvC;;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;;;;;GAKG;AACH,MAAM,WAAW,+BAA+B;IAE5C;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,IAAI,IAAI,CAAC;IAGvB;;;OAGG;IACH,WAAW,IAAI,gBAAgB,CAAC;IAGhC;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC;IAExB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC;IAEtB;;OAEG;IACH,uBAAuB,IAAI,OAAO,CAAC;IAEnC;;OAEG;IACH,mBAAmB,IAAI,OAAO,CAAC;IAG/B;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAAC;IAE9B;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,IAAI,WAAW,CAAC;CAE3B;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;gBAEjE,MAAM,EAAE,yBAAyB;IAqIvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI;IAc1D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC,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;IAM9B,WAAW,IAAI,gBAAgB;IAI/B,OAAO,CAAC,iBAAiB;CAK5B;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,EAGnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEH,wBAAwB,EACxB,WAAW,EACd,MAAM,+BAA+B,CAAC;AAWvC;;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;;;;;GAKG;AACH,MAAM,WAAW,+BAA+B;IAE5C;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,IAAI,IAAI,CAAC;IAGvB;;;OAGG;IACH,WAAW,IAAI,gBAAgB,CAAC;IAGhC;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC;IAExB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC;IAEtB;;OAEG;IACH,uBAAuB,IAAI,OAAO,CAAC;IAEnC;;OAEG;IACH,mBAAmB,IAAI,OAAO,CAAC;IAG/B;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAAC;IAE9B;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,IAAI,WAAW,CAAC;CAE3B;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;gBAEvC,MAAM,EAAE,yBAAyB;IA0LvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI;IAc1D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC,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;IAM9B,WAAW,IAAI,gBAAgB;IAI/B,OAAO,CAAC,iBAAiB;CAM5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,+BAA+B,CAE5G"}

package/dist/vgf-recognition-state.d.ts

@@ -28,6 +28,7 @@ export declare const RecognitionVGFStateSchema: z.ZodObject<{
     functionCallConfidence: z.ZodOptional<z.ZodNumber>;
     finalFunctionCallTimestamp: z.ZodOptional<z.ZodString>;
     promptSlotMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+    recognitionActionProcessingState: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     audioUtteranceId: string;
     pendingTranscript: string;
@@ -44,6 +45,7 @@ export declare const RecognitionVGFStateSchema: z.ZodObject<{
     functionCallConfidence?: number | undefined;
     finalFunctionCallTimestamp?: string | undefined;
     promptSlotMap?: Record<string, string[]> | undefined;
+    recognitionActionProcessingState?: string | undefined;
 }, {
     audioUtteranceId: string;
     startRecordingStatus?: string | undefined;
@@ -60,6 +62,7 @@ export declare const RecognitionVGFStateSchema: z.ZodObject<{
     functionCallConfidence?: number | undefined;
     finalFunctionCallTimestamp?: string | undefined;
     promptSlotMap?: Record<string, string[]> | undefined;
+    recognitionActionProcessingState?: string | undefined;
 }>;
 export type RecognitionState = z.infer<typeof RecognitionVGFStateSchema>;
 export declare const RecordingStatus: {
@@ -77,6 +80,12 @@ export declare const TranscriptionStatus: {
     readonly ERROR: "ERROR";
 };
 export type TranscriptionStatusType = typeof TranscriptionStatus[keyof typeof TranscriptionStatus];
+export declare const RecognitionActionProcessingState: {
+    readonly NOT_STARTED: "NOT_STARTED";
+    readonly IN_PROGRESS: "IN_PROGRESS";
+    readonly COMPLETED: "COMPLETED";
+};
+export type RecognitionActionProcessingStateType = typeof RecognitionActionProcessingState[keyof typeof RecognitionActionProcessingState];
 export declare function createInitialRecognitionState(audioUtteranceId: string): RecognitionState;
 export declare function isValidRecordingStatusTransition(from: string | undefined, to: string): boolean;
 //# sourceMappingURL=vgf-recognition-state.d.ts.map

package/dist/vgf-recognition-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vgf-recognition-state.d.ts","sourceRoot":"","sources":["../src/vgf-recognition-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BpC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAGxE,eAAO,MAAM,eAAe;;;;;CAKlB,CAAA;AAEV,MAAM,MAAM,mBAAmB,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAA;AAEtF,eAAO,MAAM,mBAAmB;;;;;;CAMtB,CAAA;AAEV,MAAM,MAAM,uBAAuB,GAAG,OAAO,mBAAmB,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAA;AAGlG,wBAAgB,6BAA6B,CAAC,gBAAgB,EAAE,MAAM,GAAG,gBAAgB,CAOxF;AAGD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAa9F"}
+{"version":3,"file":"vgf-recognition-state.d.ts","sourceRoot":"","sources":["../src/vgf-recognition-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BpC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAGxE,eAAO,MAAM,eAAe;;;;;CAKlB,CAAA;AAEV,MAAM,MAAM,mBAAmB,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAA;AAEtF,eAAO,MAAM,mBAAmB;;;;;;CAMtB,CAAA;AAEV,MAAM,MAAM,uBAAuB,GAAG,OAAO,mBAAmB,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAA;AAElG,eAAO,MAAM,gCAAgC;;;;CAInC,CAAA;AAEV,MAAM,MAAM,oCAAoC,GAAG,OAAO,gCAAgC,CAAC,MAAM,OAAO,gCAAgC,CAAC,CAAA;AAGzI,wBAAgB,6BAA6B,CAAC,gBAAgB,EAAE,MAAM,GAAG,gBAAgB,CAQxF;AAGD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAa9F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volley/recognition-client-sdk",
-  "version": "0.1.297",
+  "version": "0.1.381",
   "description": "Recognition Service TypeScript/Node.js Client SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -31,33 +31,33 @@
     "provenance": true
   },
   "dependencies": {
-    "uuid": "^11.0.0",
+    "uuid": "11.0.0",
     "ws": "8.18.3",
-    "zod": "~3.22.4"
+    "zod": "3.22.4"
   },
   "devDependencies": {
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/commit-analyzer": "^13.0.1",
-    "@semantic-release/exec": "^7.1.0",
-    "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^12.0.0",
-    "@semantic-release/npm": "^13.1.1",
-    "@semantic-release/release-notes-generator": "^14.1.0",
-    "@types/jest": "^30.0.0",
-    "@types/node": "^20.4.5",
-    "@types/uuid": "^10.0.0",
-    "@types/ws": "^8.5.5",
-    "esbuild": "^0.25.0",
-    "jest": "^29.6.1",
-    "rollup": "^4.52.5",
-    "rollup-plugin-dts": "^6.2.3",
-    "semantic-release": "^25.0.1",
-    "ts-jest": "^29.4.5",
-    "typescript": "^5.1.6",
-    "@recog/shared-types": "1.0.0",
+    "@semantic-release/changelog": "6.0.3",
+    "@semantic-release/commit-analyzer": "13.0.1",
+    "@semantic-release/exec": "7.1.0",
+    "@semantic-release/git": "10.0.1",
+    "@semantic-release/github": "12.0.0",
+    "@semantic-release/npm": "13.1.1",
+    "@semantic-release/release-notes-generator": "14.1.0",
+    "@types/jest": "30.0.0",
+    "@types/node": "20.4.5",
+    "@types/uuid": "10.0.0",
+    "@types/ws": "8.5.5",
+    "esbuild": "0.25.0",
+    "jest": "29.6.1",
+    "rollup": "4.52.5",
+    "rollup-plugin-dts": "6.2.3",
+    "semantic-release": "25.0.1",
+    "ts-jest": "29.4.5",
+    "typescript": "5.1.6",
+    "@recog/shared-config": "1.0.0",
     "@recog/websocket": "1.0.0",
     "@recog/shared-utils": "1.0.0",
-    "@recog/shared-config": "1.0.0"
+    "@recog/shared-types": "1.0.0"
   },
   "keywords": [
     "recognition",

package/src/index.ts

@@ -96,6 +96,8 @@ export {
   createDefaultASRConfig,
   RecognitionProvider,
   DeepgramModel,
+  ElevenLabsModel,
+  FireworksModel,
   GoogleModel,
   GeminiModel,
   OpenAIModel,

package/src/recognition-client.ts

@@ -682,7 +682,20 @@ export class RealTimeTwoWayWebSocketRecognitionClient
   }
 
   protected onDisconnected(code: number, reason: string): void {
-    this.log('debug', 'WebSocket disconnected', { code, reason, previousState: this.state });
+    // DIAGNOSTIC: Enhanced logging for disconnections
+    const closeCodeDescription = this.getCloseCodeDescription(code);
+    const is1006 = code === 1006;
+
+    this.log('debug', '[DIAGNOSTIC] WebSocket disconnected', {
+      code,
+      codeDescription: closeCodeDescription,
+      reason: reason || '(empty)',
+      previousState: this.state,
+      is1006Abnormal: is1006,
+      audioChunksSent: this.audioChunksSent,
+      audioBytesSent: this.audioBytesSent,
+      bufferStats: this.audioBuffer.getStats()
+    });
 
     // Update state based on disconnection type
     if (this.state === ClientState.STOPPING) {
@@ -692,7 +705,19 @@ export class RealTimeTwoWayWebSocketRecognitionClient
       this.state === ClientState.READY ||
       this.state === ClientState.CONNECTING
     ) {
-      this.log('error', 'Unexpected disconnection', { code, reason });
+      this.log('error', '[DIAGNOSTIC] Unexpected disconnection', {
+        code,
+        codeDescription: closeCodeDescription,
+        reason: reason || '(empty)',
+        is1006: is1006,
+        possibleCauses: is1006 ? [
+          'Network connection lost',
+          'Server process crashed',
+          'Provider (Deepgram/AssemblyAI) WebSocket closed abnormally',
+          'Firewall/proxy terminated connection',
+          'Browser/tab suspended (mobile)'
+        ] : []
+      });
       this.state = ClientState.FAILED;
     }
 
@@ -702,6 +727,33 @@ export class RealTimeTwoWayWebSocketRecognitionClient
     this.config.onDisconnected(code, reason);
   }
 
+  /**
+   * Get human-readable description for WebSocket close code
+   */
+  private getCloseCodeDescription(code: number): string {
+    const descriptions: Record<number, string> = {
+      1000: 'Normal Closure',
+      1001: 'Going Away',
+      1002: 'Protocol Error',
+      1003: 'Unsupported Data',
+      1005: 'No Status Received',
+      1006: 'Abnormal Closure (no close frame received)',
+      1007: 'Invalid Frame Payload',
+      1008: 'Policy Violation',
+      1009: 'Message Too Big',
+      1010: 'Mandatory Extension',
+      1011: 'Internal Server Error',
+      1012: 'Service Restart',
+      1013: 'Try Again Later',
+      4000: 'Auth Required',
+      4001: 'Auth Failed',
+      4002: 'Rate Limit Exceeded',
+      4003: 'Invalid Session',
+      4004: 'Session Expired'
+    };
+    return descriptions[code] || `Unknown (${code})`;
+  }
+
   protected onError(error: Event): void {
     this.state = ClientState.FAILED;
 

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

@@ -65,6 +65,65 @@ describe('SimplifiedVGFRecognitionClient', () => {
       expect(state.pendingTranscript).toBe('');
     });
 
+    it('should generate new UUID when initial state has no audioUtteranceId', () => {
+      const initialState: RecognitionState = {
+        // No audioUtteranceId provided
+        startRecordingStatus: RecordingStatus.READY,
+        transcriptionStatus: TranscriptionStatus.NOT_STARTED,
+        pendingTranscript: ''
+      } as RecognitionState;
+
+      simplifiedClient = new SimplifiedVGFRecognitionClient({
+        initialState,
+        asrRequestConfig: {
+          provider: 'deepgram',
+          language: 'en',
+          sampleRate: 16000,
+          encoding: AudioEncoding.LINEAR16
+        },
+        onStateChange: stateChangeCallback
+      });
+
+      const state = simplifiedClient.getVGFState();
+      // Should have generated a new UUID
+      expect(state.audioUtteranceId).toBeDefined();
+      expect(state.audioUtteranceId).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
+      // Should preserve other fields
+      expect(state.startRecordingStatus).toBe(RecordingStatus.READY);
+      expect(state.transcriptionStatus).toBe(TranscriptionStatus.NOT_STARTED);
+
+      // onStateChange should be called with the new UUID
+      expect(stateChangeCallback).toHaveBeenCalledTimes(1);
+      const callbackState = stateChangeCallback.mock.calls[0][0];
+      expect(callbackState.audioUtteranceId).toBe(state.audioUtteranceId);
+    });
+
+    it('should generate new UUID when initial state has empty audioUtteranceId', () => {
+      const initialState: RecognitionState = {
+        audioUtteranceId: '',  // Empty UUID
+        startRecordingStatus: RecordingStatus.READY,
+        transcriptionStatus: TranscriptionStatus.NOT_STARTED,
+        pendingTranscript: ''
+      };
+
+      simplifiedClient = new SimplifiedVGFRecognitionClient({
+        initialState,
+        asrRequestConfig: {
+          provider: 'deepgram',
+          language: 'en',
+          sampleRate: 16000,
+          encoding: AudioEncoding.LINEAR16
+        },
+        onStateChange: stateChangeCallback
+      });
+
+      const state = simplifiedClient.getVGFState();
+      // Should have generated a new UUID
+      expect(state.audioUtteranceId).toBeDefined();
+      expect(state.audioUtteranceId).not.toBe('');
+      expect(state.audioUtteranceId).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
+    });
+
     it('should accept initial state and use its audioUtteranceId', () => {
       const initialState: RecognitionState = {
         audioUtteranceId: 'existing-session-id',
@@ -229,8 +288,11 @@ describe('SimplifiedVGFRecognitionClient', () => {
     });
 
     it('should handle metadata and mark recording as finished', () => {
+      // Get the actual UUID from the client
+      const actualUuid = simplifiedClient.getVGFState().audioUtteranceId;
+
       const metadata = {
-        audioUtteranceId: 'test-uuid',
+        audioUtteranceId: actualUuid,
         duration: 5000
       };
 
@@ -387,9 +449,22 @@ describe('SimplifiedVGFRecognitionClient', () => {
 
   describe('Thin Layer Verification', () => {
     it('should pass transcript result directly to mapper without modification', () => {
+      simplifiedClient = new SimplifiedVGFRecognitionClient({
+        asrRequestConfig: {
+          provider: 'deepgram',
+          language: 'en',
+          sampleRate: 16000,
+          encoding: AudioEncoding.LINEAR16
+        },
+        onStateChange: stateChangeCallback
+      });
+
+      // Get actual UUID from client
+      const actualUuid = simplifiedClient.getVGFState().audioUtteranceId;
+
       const transcriptResult = {
         type: 'Transcription',
-        audioUtteranceId: 'test-123',
+        audioUtteranceId: actualUuid,
         finalTranscript: 'Final text',
         pendingTranscript: 'Pending text',
         finalTranscriptConfidence: 0.99,
@@ -401,16 +476,6 @@ describe('SimplifiedVGFRecognitionClient', () => {
         extraField: 'should be ignored by VGF state'
       };
 
-      simplifiedClient = new SimplifiedVGFRecognitionClient({
-        asrRequestConfig: {
-          provider: 'deepgram',
-          language: 'en',
-          sampleRate: 16000,
-          encoding: AudioEncoding.LINEAR16
-        },
-        onStateChange: stateChangeCallback
-      });
-
       const constructorCall = (RealTimeTwoWayWebSocketRecognitionClient as jest.MockedClass<typeof RealTimeTwoWayWebSocketRecognitionClient>).mock.calls[0]?.[0];
       const wrappedCallback = constructorCall?.onTranscript;
       if (!wrappedCallback) throw new Error('onTranscript callback not found');
@@ -1049,4 +1114,221 @@ describe('SimplifiedVGFRecognitionClient', () => {
       });
     });
   });
+
+  describe('UUID Change Detection', () => {
+    it('should skip onStateChange callback when UUID changes by default', () => {
+      // Create client with initial state
+      const initialState: RecognitionState = {
+        audioUtteranceId: 'session-123',
+        startRecordingStatus: RecordingStatus.READY,
+        transcriptionStatus: TranscriptionStatus.NOT_STARTED,
+        pendingTranscript: ''
+      };
+
+      simplifiedClient = new SimplifiedVGFRecognitionClient({
+        initialState,
+        asrRequestConfig: {
+          provider: 'deepgram',
+          language: 'en',
+          sampleRate: 16000,
+          encoding: AudioEncoding.LINEAR16
+        },
+        onStateChange: stateChangeCallback
+      });
+
+      // Get the callbacks that were passed to the underlying client
+      const constructorCalls = (RealTimeTwoWayWebSocketRecognitionClient as jest.MockedClass<typeof RealTimeTwoWayWebSocketRecognitionClient>).mock.calls;
+      const clientConfig = constructorCalls[0]?.[0];
+      const onTranscriptCallback = clientConfig?.onTranscript;
+
+      // Simulate transcript with a different UUID (stale callback from previous session)
+      onTranscriptCallback?.({
+        type: 'transcript',
+        is_finished: false,
+        pendingTranscript: 'test transcript',
+        audioUtteranceId: 'different-uuid-456' // Different UUID
+      } as any);
+
+      // State should NOT be updated - callback should be skipped
+      expect(stateChangeCallback).not.toHaveBeenCalled();
+
+      // Internal state should still have original UUID
+      const state = simplifiedClient.getVGFState();
+      expect(state.audioUtteranceId).toBe('session-123');
+      expect(state.pendingTranscript).toBe(''); // Not updated
+    });
+
+
+    it('should process callbacks with matching UUID', () => {
+      // Create client with initial state
+      const initialState: RecognitionState = {
+        audioUtteranceId: 'session-123',
+        startRecordingStatus: RecordingStatus.READY,
+        transcriptionStatus: TranscriptionStatus.NOT_STARTED,
+        pendingTranscript: ''
+      };
+
+      simplifiedClient = new SimplifiedVGFRecognitionClient({
+        initialState,
+        asrRequestConfig: {
+          provider: 'deepgram',
+          language: 'en',
+          sampleRate: 16000,
+          encoding: AudioEncoding.LINEAR16
+        },
+        onStateChange: stateChangeCallback
+      });
+
+      // Get the callbacks that were passed to the underlying client
+      const constructorCalls = (RealTimeTwoWayWebSocketRecognitionClient as jest.MockedClass<typeof RealTimeTwoWayWebSocketRecognitionClient>).mock.calls;
+      const clientConfig = constructorCalls[0]?.[0];
+      const onTranscriptCallback = clientConfig?.onTranscript;
+
+      // Simulate transcript with matching UUID
+      onTranscriptCallback?.({
+        type: 'transcript',
+        is_finished: false,
+        pendingTranscript: 'test transcript',
+        audioUtteranceId: 'session-123' // Same UUID
+      } as any);
+
+      // State should be updated normally
+      expect(stateChangeCallback).toHaveBeenCalledTimes(1);
+      const updatedState = stateChangeCallback.mock.calls[0][0];
+      expect(updatedState.audioUtteranceId).toBe('session-123');
+      expect(updatedState.pendingTranscript).toBe('test transcript');
+    });
+
+    it('should skip metadata callback with different UUID', () => {
+      // Create client with initial state
+      const initialState: RecognitionState = {
+        audioUtteranceId: 'session-123',
+        startRecordingStatus: RecordingStatus.READY,
+        transcriptionStatus: TranscriptionStatus.NOT_STARTED,
+        pendingTranscript: ''
+      };
+
+      simplifiedClient = new SimplifiedVGFRecognitionClient({
+        initialState,
+        asrRequestConfig: {
+          provider: 'deepgram',
+          language: 'en',
+          sampleRate: 16000,
+          encoding: AudioEncoding.LINEAR16
+        },
+        onStateChange: stateChangeCallback
+      });
+
+      // Get the metadata callback
+      const constructorCalls = (RealTimeTwoWayWebSocketRecognitionClient as jest.MockedClass<typeof RealTimeTwoWayWebSocketRecognitionClient>).mock.calls;
+      const clientConfig = constructorCalls[0]?.[0];
+      const onMetadataCallback = clientConfig?.onMetadata;
+
+      // Simulate metadata with different UUID
+      onMetadataCallback?.({
+        type: 'metadata',
+        event: 'recording_stopped',
+        audioUtteranceId: 'different-uuid-456'
+      } as any);
+
+      // Callback should be skipped
+      expect(stateChangeCallback).not.toHaveBeenCalled();
+    });
+
+    it('should skip error callback with different UUID', () => {
+      // Create client with initial state
+      const initialState: RecognitionState = {
+        audioUtteranceId: 'session-123',
+        startRecordingStatus: RecordingStatus.READY,
+        transcriptionStatus: TranscriptionStatus.NOT_STARTED,
+        pendingTranscript: ''
+      };
+
+      simplifiedClient = new SimplifiedVGFRecognitionClient({
+        initialState,
+        asrRequestConfig: {
+          provider: 'deepgram',
+          language: 'en',
+          sampleRate: 16000,
+          encoding: AudioEncoding.LINEAR16
+        },
+        onStateChange: stateChangeCallback
+      });
+
+      // Get the error callback
+      const constructorCalls = (RealTimeTwoWayWebSocketRecognitionClient as jest.MockedClass<typeof RealTimeTwoWayWebSocketRecognitionClient>).mock.calls;
+      const clientConfig = constructorCalls[0]?.[0];
+      const onErrorCallback = clientConfig?.onError;
+
+      // Simulate error with different UUID
+      onErrorCallback?.({
+        type: 'error',
+        error: 'test error',
+        audioUtteranceId: 'different-uuid-456'
+      } as any);
+
+      // Callback should be skipped
+      expect(stateChangeCallback).not.toHaveBeenCalled();
+    });
+
+    it('should track UUID after terminal state regeneration', () => {
+      // Create client with terminal initial state (forces UUID regeneration)
+      const initialState: RecognitionState = {
+        audioUtteranceId: 'old-session-123',
+        startRecordingStatus: RecordingStatus.FINISHED,
+        transcriptionStatus: TranscriptionStatus.FINALIZED, // Terminal state
+        pendingTranscript: '',
+        finalTranscript: 'Previous transcript'
+      };
+
+      simplifiedClient = new SimplifiedVGFRecognitionClient({
+        initialState,
+        asrRequestConfig: {
+          provider: 'deepgram',
+          language: 'en',
+          sampleRate: 16000,
+          encoding: AudioEncoding.LINEAR16
+        },
+        onStateChange: stateChangeCallback
+      });
+
+      // Get the new UUID that was generated
+      const newState = simplifiedClient.getVGFState();
+      const newUuid = newState.audioUtteranceId;
+      expect(newUuid).not.toBe('old-session-123');
+
+      // Get the transcript callback
+      const constructorCalls = (RealTimeTwoWayWebSocketRecognitionClient as jest.MockedClass<typeof RealTimeTwoWayWebSocketRecognitionClient>).mock.calls;
+      const clientConfig = constructorCalls[0]?.[0];
+      const onTranscriptCallback = clientConfig?.onTranscript;
+
+      // Clear initial state change callback from UUID regeneration
+      jest.clearAllMocks();
+
+      // Simulate transcript with the NEW UUID
+      onTranscriptCallback?.({
+        type: 'transcript',
+        is_finished: false,
+        pendingTranscript: 'new transcript',
+        audioUtteranceId: newUuid // New UUID
+      } as any);
+
+      // Should process normally with new UUID
+      expect(stateChangeCallback).toHaveBeenCalledTimes(1);
+      const updatedState = stateChangeCallback.mock.calls[0][0];
+      expect(updatedState.pendingTranscript).toBe('new transcript');
+
+      // Simulate transcript with OLD UUID (stale callback)
+      jest.clearAllMocks();
+      onTranscriptCallback?.({
+        type: 'transcript',
+        is_finished: false,
+        pendingTranscript: 'stale transcript',
+        audioUtteranceId: 'old-session-123' // Old UUID
+      } as any);
+
+      // Should skip callback with old UUID
+      expect(stateChangeCallback).not.toHaveBeenCalled();
+    });
+  });
 });