@connekz/connekz-agent 2.2.1 → 2.4.0

package/dist/worklet-processor.js

@@ -1,5 +1,5 @@
 class WorkletProcessor extends AudioWorkletProcessor {
-    process(inputs, outputs, parameters) {
+    process(inputs) {
         const input = inputs[0];
         if (input.length > 0) {
             const data = input[0];

package/package.json

@@ -2,7 +2,7 @@
   "name": "@connekz/connekz-agent",
   "private": false,
   "type": "module",
-  "version": "2.2.1",
+  "version": "2.4.0",
   "description": "A package for Connekz clients to integrate Connekz Agent into their applications.",
   "main": "./dist/connekz-agent.umd.js",
   "module": "./dist/connekz-agent.es.js",

package/types.d.ts

@@ -28,6 +28,17 @@ export type ConnekzTranscript = {
   forcedDisplay?: boolean; // Whether force to display this message
 }
 
+/**
+ * A single message in the full conversation history returned by
+ * `connekzAgent.getConversation()`. Covers both voice and text turns.
+ */
+export type ConnekzConversationMessage = {
+  id?: string; // Server message id (absent for not-yet-persisted local messages)
+  role: 'user' | 'ai' | 'system';
+  message: string;
+  at: string; // ISO date string (message createdAt)
+}
+
 // Export types for consumers of the package
 export type ConnekzOptions = {
   clientId: string; // Client ID for the connekz instance
@@ -61,18 +72,30 @@ export type ConnectionQuality = {
 /**
  * Error codes for Connekz Agent errors.
  *
- * CNKZ_ERR_1001 - Unable to reach the Connekz server (wrong URL, server down, network issue)
- * CNKZ_ERR_1002 - Invalid client ID or client secret
- * CNKZ_ERR_1003 - Usage quota exceeded (out of tokens)
- * CNKZ_ERR_1004 - Weak network connection (voice unreliable)
+ * CNKZ_ERR_1001 - Unable to reach the Connekz server (wrong URL, server down, network/proxy issue).
+ *                 The agent keeps retrying automatically, walking a websocket → polling transport ladder.
+ * CNKZ_ERR_1002 - Invalid client ID or client secret. Not retried.
+ * CNKZ_ERR_1003 - Usage quota exceeded (out of tokens / connection limit). Not retried.
+ * CNKZ_ERR_1004 - Weak network connection (voice unreliable; text chat suggested)
  * CNKZ_ERR_1005 - Agent runtime error
+ * CNKZ_ERR_1006 - Browser is offline. Reconnects automatically when connectivity returns.
+ * CNKZ_ERR_1007 - Session/ephemeral token expired. Mint a fresh token server-side and re-initialize. Not retried.
+ * CNKZ_ERR_1008 - This page's origin is not in the instance's authorized domains list. Not retried.
+ * CNKZ_ERR_1009 - Browser unsupported (no realtime transport available at all). Not retried.
+ * CNKZ_ERR_1010 - Voice unsupported in this environment (insecure context, no mic API/hardware).
+ *                 Text chat continues to work.
  */
 export type ConnekzErrorCode =
   | 'CNKZ_ERR_1001'
   | 'CNKZ_ERR_1002'
   | 'CNKZ_ERR_1003'
   | 'CNKZ_ERR_1004'
-  | 'CNKZ_ERR_1005';
+  | 'CNKZ_ERR_1005'
+  | 'CNKZ_ERR_1006'
+  | 'CNKZ_ERR_1007'
+  | 'CNKZ_ERR_1008'
+  | 'CNKZ_ERR_1009'
+  | 'CNKZ_ERR_1010';
 
 export type ConnekzError = {
   code: ConnekzErrorCode;
@@ -80,6 +103,35 @@ export type ConnekzError = {
   timestamp: number;
 };
 
+/** Environment capability snapshot (see ConnekzSocketAPI.getDiagnostics). */
+export type ConnekzCapabilities = {
+  webSocket: boolean;
+  httpTransport: boolean;
+  secureContext: boolean;
+  online: boolean;
+  mediaDevices: boolean;
+  audioContext: boolean;
+  audioWorklet: boolean;
+  localStorage: boolean;
+};
+
+/**
+ * Connection internals snapshot for debugging and support tickets.
+ * `transportStrategy` is the ladder rung last attempted
+ * (websocket / polling-upgrade / polling-only); `activeTransport` is what
+ * engine.io is actually using when connected.
+ */
+export type ConnekzDiagnostics = {
+  connected: boolean;
+  connecting: boolean;
+  transportStrategy: string | null;
+  activeTransport: string | null;
+  attempts: number;
+  lastError: { code: ConnekzErrorCode; userMessage: string; devMessage: string; retryable?: boolean } | null;
+  capabilities: ConnekzCapabilities;
+  baseUrl: string;
+};
+
 // New: Subscription types
 export type Unsubscriber = () => void;
 export interface SocketSubscribeAPI {
@@ -103,6 +155,12 @@ export interface ConnekzSocketAPI {
   connect: (force?: boolean) => void;
   disconnect: () => void;
   cleanup: () => void;
+  /**
+   * Snapshot of connection internals: transport in use, attempt count, last
+   * classified error and environment capabilities. Include this in bug
+   * reports/support tickets for connection issues.
+   */
+  getDiagnostics: () => ConnekzDiagnostics;
   subscribe: SocketSubscribeAPI;
 }
 
@@ -122,6 +180,21 @@ export interface VoiceAgentAPI {
   stopCaptureTest: () => void;
   playCapturedAudio: () => void;
   toggleMic: () => void;
+  /**
+   * Returns the full conversation history for the current thread as a
+   * chronological snapshot (ascending by time). Includes BOTH voice and text
+   * turns — seeded from the server thread history and kept live as new messages
+   * arrive. Returns an empty array before any conversation exists.
+   *
+   * Typical use: call this inside an `onToolCall` handler (e.g. when a booking
+   * tool fires) to capture the transcript and forward it to your own backend.
+   */
+  getConversation: () => ConnekzConversationMessage[];
+  /**
+   * Returns the current chat thread id, or null before a thread is established.
+   * Useful for correlating a captured transcript with the server-side thread.
+   */
+  getThreadId: () => string | null;
   subscribe: AgentSubscribeAPI;
 }