@agentforge-io/chat-sdk 2.6.0 → 3.0.0

package/dist/react.d.ts

@@ -181,6 +181,22 @@ export interface ChatWidgetProps {
      * once `agent_loaded` has fired internally.
      */
     handleRef?: React.MutableRefObject<ChatWidgetHandle | null>;
+    /**
+     * Optional observer adapter. When supplied, the SDK boots it once the
+     * conversation id is known (first user message) and flushes captured
+     * DOM/WebMCP events to the AgentForge ingestion endpoint after every
+     * turn + on page unload. The adapter is a duck-typed contract — see
+     * `ObserverAdapterLike` — so the `@agentforge-io/observer` package
+     * stays an optional peer dep. Hosts that don't ship observer can
+     * omit this and chat behaves identically.
+     *
+     * Wire this from preview / playground pages where the operator
+     * wants to inspect what visitors do, or from production embeds
+     * where the agent's `observerEnabled` is true. The server-side
+     * agent config determines whether ingestion actually persists;
+     * the client-side adapter just captures.
+     */
+    observer?: import('./observer').ObserverAdapterLike;
 }
 /** Imperative surface exposed via ChatWidgetProps.handleRef. Narrow
  *  on purpose — hosts get a verb, not the whole session. */

package/dist/react.js

@@ -228,7 +228,7 @@ function fallbackCopy(ctx) {
  * SDK event. Consumers don't need to read `session.getState()` themselves.
  */
 function ChatWidget(props) {
-    const { token, apiBaseUrl, inline = false, position, browserSessionId, resumeConversationId, onConversationStart, stream, className, style, onApprovalDecision, readOnlyApprovals = false, variant = 'card', greeting, personaName, shortcuts, onShortcutClick, inputPlaceholder, members, composerLeftSlot, handleRef, } = props;
+    const { token, apiBaseUrl, inline = false, position, browserSessionId, resumeConversationId, onConversationStart, stream, className, style, onApprovalDecision, readOnlyApprovals = false, variant = 'card', greeting, personaName, shortcuts, onShortcutClick, inputPlaceholder, members, composerLeftSlot, handleRef, observer, } = props;
     // Build a lookup so MessageBubble can resolve actingAgentId → identity
     // in O(1) per render without re-walking the members array. Stable
     // identity per `members` prop change.
@@ -309,6 +309,12 @@ function ChatWidget(props) {
     // updates to it are ignored — the SDK already owns the live
     // conversation id internally via session.state.conversationId.
     const resumeRef = (0, react_1.useRef)(resumeConversationId);
+    // Same rationale as `resumeRef` above — the observer adapter is
+    // captured at mount so a parent re-render with a new (but equivalent)
+    // adapter identity doesn't tear down the live ChatSession mid-
+    // conversation. Hosts that need to swap observers should remount
+    // the widget (e.g. via a `key` prop).
+    const observerRef = (0, react_1.useRef)(observer);
     (0, react_1.useEffect)(() => {
         let cancelled = false;
         const s = new session_1.ChatSession({
@@ -317,6 +323,7 @@ function ChatWidget(props) {
             browserSessionId,
             resumeConversationId: resumeRef.current,
             stream,
+            observer: observerRef.current,
         });
         setSession(s);
         setMessages([]);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agentforge-io/chat-sdk",
-  "version": "2.6.0",
-  "description": "Framework-free chat session SDK for AgentForge public chat tokens. Headless — no DOM. Drop into any frontend (React, Vue, Svelte, vanilla) and listen for events.",
+  "version": "3.0.0",
+  "description": "Framework-free chat session SDK for AgentForge public chat tokens. Headless \u2014 no DOM. Drop into any frontend (React, Vue, Svelte, vanilla) and listen for events.",
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -37,4 +37,4 @@
     "react": "^18.3.1",
     "typescript": "^5.0.0"
   }
-}
+}