@runtypelabs/persona 3.14.0 → 3.15.0

package/dist/theme-editor.cjs

@@ -15996,8 +15996,10 @@ var createAgentExperience = (mount, initialConfig, runtimeOptions) => {
       }
     });
   }
-  if (eventStreamBuffer) {
+  if (eventStreamBuffer || config.onSSEEvent) {
     session.setSSEEventCallback((type, payload) => {
+      var _a2;
+      (_a2 = config.onSSEEvent) == null ? void 0 : _a2.call(config, type, payload);
       eventStreamBuffer == null ? void 0 : eventStreamBuffer.push({
         id: `evt-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
         type,
@@ -16838,6 +16840,8 @@ var createAgentExperience = (mount, initialConfig, runtimeOptions) => {
           eventStreamStore.open().then(() => eventStreamBuffer == null ? void 0 : eventStreamBuffer.restore()).catch(() => {
           });
           session.setSSEEventCallback((type, payload) => {
+            var _a3;
+            (_a3 = config.onSSEEvent) == null ? void 0 : _a3.call(config, type, payload);
             eventStreamBuffer.push({
               id: `evt-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
               type,

package/dist/theme-editor.d.cts

@@ -3217,6 +3217,15 @@ type AgentWidgetConfig = {
      * ```
      */
     parseSSEEvent?: AgentWidgetSSEEventParser;
+    /**
+     * Called for every parsed SSE frame (after JSON parse), before native handling.
+     * Use for lightweight side effects (e.g. telemetry). Does not replace native
+     * streaming; pair with {@link parseSSEEvent} only when you need to override text mapping.
+     *
+     * When the event stream inspector is enabled, this runs in the same order as
+     * events are appended to the inspector buffer.
+     */
+    onSSEEvent?: (eventType: string, payload: unknown) => void;
     /**
      * Layout configuration for customizing widget appearance and structure.
      * Provides control over header, messages, and content slots.

package/dist/theme-editor.d.ts

@@ -3217,6 +3217,15 @@ type AgentWidgetConfig = {
      * ```
      */
     parseSSEEvent?: AgentWidgetSSEEventParser;
+    /**
+     * Called for every parsed SSE frame (after JSON parse), before native handling.
+     * Use for lightweight side effects (e.g. telemetry). Does not replace native
+     * streaming; pair with {@link parseSSEEvent} only when you need to override text mapping.
+     *
+     * When the event stream inspector is enabled, this runs in the same order as
+     * events are appended to the inspector buffer.
+     */
+    onSSEEvent?: (eventType: string, payload: unknown) => void;
     /**
      * Layout configuration for customizing widget appearance and structure.
      * Provides control over header, messages, and content slots.

package/dist/theme-editor.js

@@ -15887,8 +15887,10 @@ var createAgentExperience = (mount, initialConfig, runtimeOptions) => {
       }
     });
   }
-  if (eventStreamBuffer) {
+  if (eventStreamBuffer || config.onSSEEvent) {
     session.setSSEEventCallback((type, payload) => {
+      var _a2;
+      (_a2 = config.onSSEEvent) == null ? void 0 : _a2.call(config, type, payload);
       eventStreamBuffer == null ? void 0 : eventStreamBuffer.push({
         id: `evt-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
         type,
@@ -16729,6 +16731,8 @@ var createAgentExperience = (mount, initialConfig, runtimeOptions) => {
           eventStreamStore.open().then(() => eventStreamBuffer == null ? void 0 : eventStreamBuffer.restore()).catch(() => {
           });
           session.setSSEEventCallback((type, payload) => {
+            var _a3;
+            (_a3 = config.onSSEEvent) == null ? void 0 : _a3.call(config, type, payload);
             eventStreamBuffer.push({
               id: `evt-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
               type,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/persona",
-  "version": "3.14.0",
+  "version": "3.15.0",
   "description": "Themeable, pluggable streaming agent widget for websites, in plain JS with support for voice input and reasoning / tool output.",
   "type": "module",
   "main": "dist/index.cjs",

package/src/types.ts

@@ -2901,6 +2901,15 @@ export type AgentWidgetConfig = {
    * ```
    */
   parseSSEEvent?: AgentWidgetSSEEventParser;
+  /**
+   * Called for every parsed SSE frame (after JSON parse), before native handling.
+   * Use for lightweight side effects (e.g. telemetry). Does not replace native
+   * streaming; pair with {@link parseSSEEvent} only when you need to override text mapping.
+   *
+   * When the event stream inspector is enabled, this runs in the same order as
+   * events are appended to the inspector buffer.
+   */
+  onSSEEvent?: (eventType: string, payload: unknown) => void;
   /**
    * Layout configuration for customizing widget appearance and structure.
    * Provides control over header, messages, and content slots.

package/src/ui.ts

@@ -3118,9 +3118,10 @@ export const createAgentExperience = (
     });
   }
 
-  // Wire up event stream buffer to capture SSE events
-  if (eventStreamBuffer) {
+  // Wire up optional SSE tap (host) + event stream buffer to capture SSE events
+  if (eventStreamBuffer || config.onSSEEvent) {
     session.setSSEEventCallback((type: string, payload: unknown) => {
+      config.onSSEEvent?.(type, payload);
       eventStreamBuffer?.push({
         id: `evt-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
         type,
@@ -4187,8 +4188,9 @@ export const createAgentExperience = (
           eventStreamStore = new EventStreamStore(eventStreamDbName);
           eventStreamBuffer = new EventStreamBuffer(eventStreamMaxEvents, eventStreamStore);
           eventStreamStore.open().then(() => eventStreamBuffer?.restore()).catch(() => {});
-          // Register the SSE event callback
+          // Register the SSE event callback (host tap + buffer)
           session.setSSEEventCallback((type: string, payload: unknown) => {
+            config.onSSEEvent?.(type, payload);
             eventStreamBuffer!.push({
               id: `evt-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
               type,