@connekz/connekz-agent 2.2.1 → 2.3.2

package/CHANGELOG.md

@@ -1,3 +1,37 @@
+## [2.3.2] - 2026-07-14 (Patch Release)
+
+### Added
+
+### Changed
+
+### Fixed
+
+### Security
+
+## [2.3.1] - 2026-07-14 (Patch Release)
+
+### Added
+
+### Changed
+
+### Fixed
+
+### Security
+
+## [2.3.0] - 2026-07-14 (Minor Release)
+
+### Added
+
+- `connekzAgent.getConversation()` — returns the full conversation history for the current thread as a chronological `ConnekzConversationMessage[]` (`{ id?, role: 'user' | 'ai' | 'system', message, at }`). Includes BOTH voice and text turns, seeded from the server thread history and kept live. Intended to be called inside an `onToolCall` handler (e.g. when a booking tool fires) to capture the transcript and forward it to your own backend.
+- `connekzAgent.getThreadId()` — returns the current chat thread id (or `null` before a thread is established) for correlating a captured transcript with the server-side thread.
+- New exported type `ConnekzConversationMessage`.
+
+### Changed
+
+### Fixed
+
+### Security
+
 ## [2.2.1] - 2026-07-10 (Patch Release)
 
 ### Added

package/README.md

@@ -83,6 +83,33 @@ to clean up resources and unmount components.
   connekzAgent.stopCaptureTest(); // Stop audio capture test
   connekzAgent.playCapturedAudio(); // Playback captured audio test
   ````
+- Conversation History:
+  ````typescript
+  // Full conversation for the current thread — both voice AND text turns,
+  // seeded from server history and kept live. Chronological snapshot.
+  const history = connekzAgent.getConversation();
+  // -> ConnekzConversationMessage[]: { id?, role: 'user' | 'ai' | 'system', message, at }[]
+
+  // Current chat thread id (null before a thread is established).
+  const threadId = connekzAgent.getThreadId();
+  ````
+  Typical use — capture the transcript when a tool fires (e.g. a booking) and
+  forward it to your own backend:
+  ````typescript
+  connekzAgent.subscribe.onToolCall(async (tool) => {
+    if (tool.name === 'book_meeting') {
+      const transcript = connekzAgent.getConversation();
+      const threadId = connekzAgent.getThreadId();
+      await fetch('/api/bookings', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ booking: tool.arguments, threadId, transcript }),
+      });
+      return 'Booking captured';
+    }
+    return 'Unknown tool';
+  });
+  ````
 
 ## Subscriptions
 Subscribe to events for realtime updates: