@connekz/connekz-agent 2.0.0 → 2.3.2

package/package.json

@@ -2,7 +2,7 @@
   "name": "@connekz/connekz-agent",
   "private": false,
   "type": "module",
-  "version": "2.0.0",
+  "version": "2.3.2",
   "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",
@@ -22,8 +22,7 @@
       },
       "import": "./dist/connekz-agent.es.js",
       "require": "./dist/connekz-agent.umd.js"
-    },
-    "./connekz-agent.css": "./dist/connekz-agent.css"
+    }
   },
   "scripts": {
     "dev": "vite",

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
@@ -88,11 +99,11 @@ export interface SocketSubscribeAPI {
 }
 
 export interface AgentSubscribeAPI {
-  onAgentStatusChange: (cb: (value: VoiceAgentStatus) => void) => Unsubscriber;
+  onAgentStatusChange: (cb: (value: ConnekzAgentStatus) => void) => Unsubscriber;
   onMicStatusChange: (cb: (value: 'active' | 'muted') => void) => Unsubscriber;
   onUserWaveformUpdate: (cb: (value: number) => void) => Unsubscriber;
   onAgentWaveformUpdate: (cb: (value: number) => void) => Unsubscriber;
-  onTranscriptUpdate: (cb: (value: readonly ConnekzConversation[]) => void) => Unsubscriber;
+  onTranscriptUpdate: (cb: (value: readonly ConnekzTranscript[]) => void) => Unsubscriber;
   onToolCall: (cb: (payload: ConnekzToolCallPayload) => Promise<string>) => Unsubscriber;
   onConnectionQualityChange: (cb: (value: ConnectionQuality) => void) => Unsubscriber;
   onError: (cb: (value: ConnekzError) => void) => Unsubscriber;
@@ -110,12 +121,33 @@ export interface ConnekzSocketAPI {
 export interface VoiceAgentAPI {
   startAgent: () => Promise<void>;
   stopAgent: () => void;
-  makeSleep: () => void;
   injectMessage: (messageText: string) => void;
+  /**
+   * Load on-demand memories/tools (created with Load Mode "On-Demand" in the
+   * portal) into the current session by slug. Calling again replaces the
+   * previous set; an empty array clears all on-demand items. Safe to call
+   * before startAgent() — pending slugs apply when the session starts.
+   */
+  setSessionTools: (slugs: string[]) => void;
   startCaptureTest: () => void;
   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;
 }