@runtypelabs/persona 3.13.0 → 3.15.0

package/dist/theme-editor.cjs

@@ -4329,7 +4329,7 @@ var AgentWidgetClient = class {
     }
   }
   async streamResponse(body, onEvent, assistantMessageId) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa, _ba, _ca, _da, _ea, _fa, _ga, _ha, _ia, _ja, _ka, _la, _ma, _na, _oa, _pa, _qa, _ra, _sa, _ta, _ua, _va, _wa, _xa, _ya, _za, _Aa, _Ba, _Ca, _Da, _Ea, _Fa, _Ga, _Ha, _Ia, _Ja, _Ka, _La, _Ma, _Na, _Oa, _Pa, _Qa, _Ra, _Sa, _Ta, _Ua, _Va, _Wa, _Xa, _Ya, _Za, __a, _$a, _ab, _bb, _cb, _db, _eb, _fb, _gb, _hb, _ib, _jb, _kb, _lb;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa, _ba, _ca, _da, _ea, _fa, _ga, _ha, _ia, _ja, _ka, _la, _ma, _na, _oa, _pa, _qa, _ra, _sa, _ta, _ua, _va, _wa, _xa, _ya, _za, _Aa, _Ba, _Ca, _Da, _Ea, _Fa, _Ga, _Ha, _Ia, _Ja, _Ka, _La, _Ma, _Na, _Oa, _Pa, _Qa, _Ra, _Sa, _Ta, _Ua, _Va, _Wa, _Xa, _Ya, _Za, __a, _$a, _ab, _bb, _cb, _db, _eb, _fb, _gb, _hb, _ib, _jb, _kb, _lb, _mb, _nb;
     const reader = body.getReader();
     const decoder = new TextDecoder();
     let buffer = "";
@@ -5620,11 +5620,34 @@ var AgentWidgetClient = class {
           streamParsers.delete(id);
           rawContentBuffers.delete(id);
           seqChunkBuffers.delete(id);
-        } else if (payloadType === "error" && payload.error) {
-          onEvent({
-            type: "error",
-            error: payload.error instanceof Error ? payload.error : new Error(String(payload.error))
-          });
+        } else if (payloadType === "error" || payloadType === "step_error" || payloadType === "dispatch_error" || payloadType === "flow_error") {
+          let resolvedError = null;
+          if (payload.error instanceof Error) {
+            resolvedError = payload.error;
+          } else if (payloadType === "dispatch_error") {
+            const msg = (_mb = payload.message) != null ? _mb : payload.error;
+            if (msg != null && msg !== "") {
+              resolvedError = new Error(String(msg));
+            }
+          } else if (payloadType === "step_error" || payloadType === "flow_error") {
+            const e = payload.error;
+            if (typeof e === "string" && e !== "") {
+              resolvedError = new Error(e);
+            } else if (e != null && typeof e === "object" && "message" in e) {
+              resolvedError = new Error(String((_nb = e.message) != null ? _nb : e));
+            }
+          } else if (payloadType === "error" && payload.error != null && payload.error !== "") {
+            resolvedError = new Error(String(payload.error));
+          }
+          if (resolvedError) {
+            onEvent({ type: "error", error: resolvedError });
+            const finalMsg = assistantMessage;
+            if (finalMsg && finalMsg.streaming) {
+              finalMsg.streaming = false;
+              emitMessage(finalMsg);
+            }
+            onEvent({ type: "status", status: "idle" });
+          }
         }
       }
     }
@@ -15973,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,
@@ -16815,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

@@ -4220,7 +4220,7 @@ var AgentWidgetClient = class {
     }
   }
   async streamResponse(body, onEvent, assistantMessageId) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa, _ba, _ca, _da, _ea, _fa, _ga, _ha, _ia, _ja, _ka, _la, _ma, _na, _oa, _pa, _qa, _ra, _sa, _ta, _ua, _va, _wa, _xa, _ya, _za, _Aa, _Ba, _Ca, _Da, _Ea, _Fa, _Ga, _Ha, _Ia, _Ja, _Ka, _La, _Ma, _Na, _Oa, _Pa, _Qa, _Ra, _Sa, _Ta, _Ua, _Va, _Wa, _Xa, _Ya, _Za, __a, _$a, _ab, _bb, _cb, _db, _eb, _fb, _gb, _hb, _ib, _jb, _kb, _lb;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa, _ba, _ca, _da, _ea, _fa, _ga, _ha, _ia, _ja, _ka, _la, _ma, _na, _oa, _pa, _qa, _ra, _sa, _ta, _ua, _va, _wa, _xa, _ya, _za, _Aa, _Ba, _Ca, _Da, _Ea, _Fa, _Ga, _Ha, _Ia, _Ja, _Ka, _La, _Ma, _Na, _Oa, _Pa, _Qa, _Ra, _Sa, _Ta, _Ua, _Va, _Wa, _Xa, _Ya, _Za, __a, _$a, _ab, _bb, _cb, _db, _eb, _fb, _gb, _hb, _ib, _jb, _kb, _lb, _mb, _nb;
     const reader = body.getReader();
     const decoder = new TextDecoder();
     let buffer = "";
@@ -5511,11 +5511,34 @@ var AgentWidgetClient = class {
           streamParsers.delete(id);
           rawContentBuffers.delete(id);
           seqChunkBuffers.delete(id);
-        } else if (payloadType === "error" && payload.error) {
-          onEvent({
-            type: "error",
-            error: payload.error instanceof Error ? payload.error : new Error(String(payload.error))
-          });
+        } else if (payloadType === "error" || payloadType === "step_error" || payloadType === "dispatch_error" || payloadType === "flow_error") {
+          let resolvedError = null;
+          if (payload.error instanceof Error) {
+            resolvedError = payload.error;
+          } else if (payloadType === "dispatch_error") {
+            const msg = (_mb = payload.message) != null ? _mb : payload.error;
+            if (msg != null && msg !== "") {
+              resolvedError = new Error(String(msg));
+            }
+          } else if (payloadType === "step_error" || payloadType === "flow_error") {
+            const e = payload.error;
+            if (typeof e === "string" && e !== "") {
+              resolvedError = new Error(e);
+            } else if (e != null && typeof e === "object" && "message" in e) {
+              resolvedError = new Error(String((_nb = e.message) != null ? _nb : e));
+            }
+          } else if (payloadType === "error" && payload.error != null && payload.error !== "") {
+            resolvedError = new Error(String(payload.error));
+          }
+          if (resolvedError) {
+            onEvent({ type: "error", error: resolvedError });
+            const finalMsg = assistantMessage;
+            if (finalMsg && finalMsg.streaming) {
+              finalMsg.streaming = false;
+              emitMessage(finalMsg);
+            }
+            onEvent({ type: "status", status: "idle" });
+          }
         }
       }
     }
@@ -15864,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,
@@ -16706,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.13.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/client.test.ts

@@ -1121,6 +1121,70 @@ describe('AgentWidgetClient - Agent Event Streaming', () => {
     }
   });
 
+  it('should emit error and finalize streaming on step_error', async () => {
+    const events: AgentWidgetEvent[] = [];
+
+    global.fetch = createAgentStreamFetch([
+      'data: {"type":"flow_start","flowId":"f1","flowName":"Test","totalSteps":1}\n\n',
+      'data: {"type":"step_delta","id":"s1","name":"Prompt","executionType":"prompt","text":"partial"}\n\n',
+      sseEvent('step_error', { error: 'step blew up', seq: 3 }),
+    ]);
+
+    const client = new AgentWidgetClient({
+      apiUrl: 'http://localhost:8000',
+      agent: { name: 'Test', model: 'openai:gpt-4o-mini', systemPrompt: 'test' },
+    });
+
+    await client.dispatch(
+      { messages: [{ id: 'usr_1', role: 'user', content: 'Hi', createdAt: new Date().toISOString() }] },
+      (event) => events.push(event)
+    );
+
+    const errorEvents = events.filter(e => e.type === 'error');
+    expect(errorEvents.length).toBe(1);
+    if (errorEvents[0].type === 'error') {
+      expect(errorEvents[0].error.message).toBe('step blew up');
+    }
+
+    const statusIdle = events.filter(e => e.type === 'status' && e.status === 'idle');
+    expect(statusIdle.length).toBeGreaterThanOrEqual(1);
+
+    const messageEvents = events.filter(e => e.type === 'message');
+    const lastAssistant = [...messageEvents]
+      .reverse()
+      .find(e => e.type === 'message' && e.message.role === 'assistant' && !e.message.variant);
+    expect(lastAssistant?.type === 'message' && lastAssistant.message.streaming).toBe(false);
+  });
+
+  it('should emit error and finalize streaming on dispatch_error (message only)', async () => {
+    const events: AgentWidgetEvent[] = [];
+
+    global.fetch = createAgentStreamFetch([
+      'data: {"type":"flow_start","flowId":"f1","flowName":"Test","totalSteps":1}\n\n',
+      'data: {"type":"step_delta","id":"s1","name":"Prompt","executionType":"prompt","text":"x"}\n\n',
+      sseEvent('dispatch_error', { message: 'bad config', seq: 2 }),
+    ]);
+
+    const client = new AgentWidgetClient({
+      apiUrl: 'http://localhost:8000',
+      agent: { name: 'Test', model: 'openai:gpt-4o-mini', systemPrompt: 'test' },
+    });
+
+    await client.dispatch(
+      { messages: [{ id: 'usr_1', role: 'user', content: 'Hi', createdAt: new Date().toISOString() }] },
+      (event) => events.push(event)
+    );
+
+    const errorEvents = events.filter(e => e.type === 'error');
+    expect(errorEvents.length).toBe(1);
+    if (errorEvents[0].type === 'error') {
+      expect(errorEvents[0].error.message).toBe('bad config');
+    }
+
+    const statusIdle = events.filter(e => e.type === 'status' && e.status === 'idle');
+    expect(statusIdle.length).toBeGreaterThanOrEqual(1);
+  });
+
   it('should handle agent reflection events', async () => {
     const events: AgentWidgetEvent[] = [];
     const execId = 'exec_test_7';

package/src/client.ts

@@ -2592,14 +2592,43 @@ export class AgentWidgetClient {
           streamParsers.delete(id);
           rawContentBuffers.delete(id);
           seqChunkBuffers.delete(id);
-        } else if (payloadType === "error" && payload.error) {
-          onEvent({
-            type: "error",
-            error:
-              payload.error instanceof Error
-                ? payload.error
-                : new Error(String(payload.error))
-          });
+        } else if (
+          payloadType === "error" ||
+          payloadType === "step_error" ||
+          payloadType === "dispatch_error" ||
+          payloadType === "flow_error"
+        ) {
+          let resolvedError: Error | null = null;
+          if (payload.error instanceof Error) {
+            resolvedError = payload.error;
+          } else if (payloadType === "dispatch_error") {
+            const msg = payload.message ?? payload.error;
+            if (msg != null && msg !== "") {
+              resolvedError = new Error(String(msg));
+            }
+          } else if (
+            payloadType === "step_error" ||
+            payloadType === "flow_error"
+          ) {
+            const e = payload.error;
+            if (typeof e === "string" && e !== "") {
+              resolvedError = new Error(e);
+            } else if (e != null && typeof e === "object" && "message" in e) {
+              resolvedError = new Error(String((e as { message?: unknown }).message ?? e));
+            }
+          } else if (payloadType === "error" && payload.error != null && payload.error !== "") {
+            resolvedError = new Error(String(payload.error));
+          }
+
+          if (resolvedError) {
+            onEvent({ type: "error", error: resolvedError });
+            const finalMsg = assistantMessage as AgentWidgetMessage | null;
+            if (finalMsg && finalMsg.streaming) {
+              finalMsg.streaming = false;
+              emitMessage(finalMsg);
+            }
+            onEvent({ type: "status", status: "idle" });
+          }
         }
       }
     }

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,