@runtypelabs/persona 3.25.0 → 3.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/persona",
-  "version": "3.25.0",
+  "version": "3.27.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",
@@ -99,7 +99,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "rimraf dist && pnpm run build:styles && pnpm run build:client && pnpm run build:installer && pnpm run build:theme-ref && pnpm run build:theme-editor && pnpm run build:testing && pnpm run build:smart-dom-reader && pnpm run build:animations",
+    "build": "rimraf dist && pnpm run build:styles && pnpm run build:client && pnpm run build:installer && pnpm run build:launcher && pnpm run build:theme-ref && pnpm run build:theme-editor && pnpm run build:testing && pnpm run build:smart-dom-reader && pnpm run build:animations",
     "build:theme-editor": "tsup src/theme-editor.ts --format esm,cjs --minify --dts --out-dir dist --no-splitting",
     "build:testing": "tsup src/testing.ts --format esm,cjs --minify --dts --out-dir dist --no-splitting",
     "build:smart-dom-reader": "tsup src/smart-dom-reader.ts --format esm,cjs --minify --dts --out-dir dist --no-splitting",
@@ -108,11 +108,15 @@
     "build:styles": "node -e \"const fs=require('fs');fs.mkdirSync('dist',{recursive:true});fs.copyFileSync('src/styles/widget.css','dist/widget.css');\"",
     "build:client": "tsup src/index.ts --format esm,cjs --minify --sourcemap --splitting false --dts --loader \".css=text\" && tsup src/index-global.ts --format iife --global-name AgentWidget --minify --sourcemap --splitting false --out-dir dist --loader \".css=text\" && node -e \"const fs=require('fs');for(const ext of ['.global.js','.global.js.map']){const from='dist/index-global'+ext;if(fs.existsSync(from))fs.renameSync(from,'dist/index'+ext);}\"",
     "build:installer": "tsup src/install.ts --format iife --global-name SiteAgentInstaller --out-dir dist --minify --sourcemap --no-splitting",
+    "build:launcher": "tsup src/launcher-global.ts --format iife --global-name AgentWidgetLauncher --minify --sourcemap --splitting false --out-dir dist && node -e \"const fs=require('fs');for(const ext of ['.global.js','.global.js.map']){const from='dist/launcher-global'+ext;if(fs.existsSync(from))fs.renameSync(from,'dist/launcher'+ext);}\"",
     "lint": "eslint . --ext .ts",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "pnpm run check:runtype-types && tsc --noEmit",
     "test": "vitest",
     "test:ui": "vitest --ui",
     "test:run": "vitest run",
-    "size": "size-limit"
+    "size": "size-limit",
+    "fetch:runtype-openapi": "node scripts/fetch-runtype-openapi.mjs",
+    "generate:runtype-types": "pnpm run fetch:runtype-openapi && node scripts/generate-runtype-openapi-types.mjs",
+    "check:runtype-types": "pnpm run fetch:runtype-openapi && node scripts/generate-runtype-openapi-types.mjs --check"
   }
 }

package/src/client.test.ts

@@ -1633,6 +1633,55 @@ describe('AgentWidgetClient - partId Text/Tool Interleaving', () => {
     expect(seqTool).toBeLessThan(seq1);
   });
 
+  it('should not emit a whitespace-only assistant bubble before a leading tool call', async () => {
+    const events: AgentWidgetEvent[] = [];
+
+    const encoder = new TextEncoder();
+    global.fetch = vi.fn().mockImplementation(async () => {
+      const stream = new ReadableStream({
+        start(controller) {
+          const e = (eventType: string, data: Record<string, unknown>) =>
+            controller.enqueue(encoder.encode(`event: ${eventType}\ndata: ${JSON.stringify({ type: eventType, ...data })}\n\n`));
+
+          e('flow_start', { flowId: 'f1', flowName: 'Test', totalSteps: 1 });
+          e('step_start', { id: 's1', name: 'Prompt', stepType: 'prompt', index: 1, totalSteps: 1 });
+          // Tool UI is the first meaningful output. Some providers still emit
+          // newline-only text lifecycle events around the tool boundary; those
+          // must not become an empty assistant message bubble.
+          e('tool_start', { toolId: 'tc_1', name: 'add_to_cart', toolType: 'local', sequenceIndex: 4 });
+          e('text_start', { partId: 'text_0', messageId: 'msg_s1', seq: 1 });
+          e('step_delta', { id: 's1', text: '\n', partId: 'text_0', messageId: 'msg_s1', seq: 2 });
+          e('text_end', { partId: 'text_0', messageId: 'msg_s1', seq: 3 });
+          e('tool_complete', { toolId: 'tc_1', name: 'add_to_cart', success: true, completedAt: new Date().toISOString(), executionTime: 20, sequenceIndex: 5 });
+          e('flow_complete', { success: true });
+          controller.close();
+        }
+      });
+      return { ok: true, body: stream };
+    });
+
+    const client = new AgentWidgetClient({ apiUrl: 'http://localhost:8000' });
+    await client.dispatch(
+      { messages: [{ id: 'usr_1', role: 'user', content: 'Add to cart', createdAt: new Date().toISOString() }] },
+      (event) => events.push(event)
+    );
+
+    const messageEvents = events.filter(e => e.type === 'message');
+    const messagesById = new Map<string, AgentWidgetMessage>();
+    for (const event of messageEvents) {
+      if (event.type === 'message') messagesById.set(event.message.id, event.message);
+    }
+
+    const allMessages = Array.from(messagesById.values());
+    const assistantTexts = allMessages.filter(m => m.role === 'assistant' && !m.variant);
+    const toolMsgs = allMessages.filter(m => m.variant === 'tool');
+
+    expect(assistantTexts).toHaveLength(0);
+    expect(toolMsgs).toHaveLength(1);
+    expect(toolMsgs[0].toolCall?.name).toBe('add_to_cart');
+    expect(toolMsgs[0].toolCall?.status).toBe('complete');
+  });
+
   it('should not split when partId is absent (backward compatible)', async () => {
     const events: AgentWidgetEvent[] = [];
 
@@ -3097,7 +3146,7 @@ describe('AgentWidgetClient.resumeFlow', () => {
 
     const client = new AgentWidgetClient({
       clientToken: 'ct_live_demo',
-      apiUrl: 'https://api.runtype-staging.com',
+      apiUrl: 'https://api.runtype.com',
     });
     // Simulate an initialized client session (resumeFlow reads sessionId off it).
     (client as unknown as { clientSession: { sessionId: string; expiresAt: Date } }).clientSession = {
@@ -3108,7 +3157,7 @@ describe('AgentWidgetClient.resumeFlow', () => {
     await client.resumeFlow('exec_xyz', { toolu_A: { ok: true } });
 
     // Session-authed sibling of /v1/client/chat — no Bearer key, sessionId in body.
-    expect(capturedUrl).toBe('https://api.runtype-staging.com/v1/client/resume');
+    expect(capturedUrl).toBe('https://api.runtype.com/v1/client/resume');
     expect(capturedBody).toEqual({
       executionId: 'exec_xyz',
       toolOutputs: { toolu_A: { ok: true } },
@@ -3127,7 +3176,7 @@ describe('AgentWidgetClient.resumeFlow', () => {
 
     const client = new AgentWidgetClient({
       clientToken: 'ct_live_demo',
-      apiUrl: 'https://api.runtype-staging.com/v1/dispatch',
+      apiUrl: 'https://api.runtype.com/v1/dispatch',
     });
     // A live session so initSession() short-circuits instead of fetching /init.
     (client as unknown as { clientSession: { sessionId: string; expiresAt: Date } }).clientSession = {
@@ -3136,7 +3185,7 @@ describe('AgentWidgetClient.resumeFlow', () => {
     };
     await client.resumeFlow('exec_abc', {});
 
-    expect(capturedUrl).toBe('https://api.runtype-staging.com/v1/client/resume');
+    expect(capturedUrl).toBe('https://api.runtype.com/v1/client/resume');
   });
 
   it('refreshes the session via initSession() before resuming when stale (BugBot r3367875360)', async () => {
@@ -3148,7 +3197,7 @@ describe('AgentWidgetClient.resumeFlow', () => {
 
     const client = new AgentWidgetClient({
       clientToken: 'ct_live_demo',
-      apiUrl: 'https://api.runtype-staging.com',
+      apiUrl: 'https://api.runtype.com',
     });
     // A stale session that has already expired — a long WebMCP approval wait can
     // outlive it, so resumeFlow must not trust this.clientSession directly.
@@ -3797,7 +3846,7 @@ describe('AgentWidgetClient - diff-only clientTools (client-token)', () => {
   function makeClient(tools: unknown[]) {
     const client = new AgentWidgetClient({
       clientToken: 'ct_live_demo',
-      apiUrl: 'https://api.runtype-staging.com',
+      apiUrl: 'https://api.runtype.com',
     });
     (client as unknown as { clientSession: { sessionId: string; expiresAt: Date } }).clientSession = {
       sessionId: 'cs_diff_1',
@@ -3855,7 +3904,7 @@ describe('AgentWidgetClient - diff-only clientTools (client-token)', () => {
     const live = [...TOOLS];
     const client = new AgentWidgetClient({
       clientToken: 'ct_live_demo',
-      apiUrl: 'https://api.runtype-staging.com',
+      apiUrl: 'https://api.runtype.com',
     });
     (client as unknown as { clientSession: { sessionId: string; expiresAt: Date } }).clientSession = {
       sessionId: 'cs_diff_1',
@@ -3882,7 +3931,7 @@ describe('AgentWidgetClient - diff-only clientTools (client-token)', () => {
     ];
     const client = new AgentWidgetClient({
       clientToken: 'ct_live_demo',
-      apiUrl: 'https://api.runtype-staging.com',
+      apiUrl: 'https://api.runtype.com',
     });
     (client as unknown as { clientSession: { sessionId: string; expiresAt: Date } }).clientSession = {
       sessionId: 'cs_diff_1',
@@ -3978,7 +4027,7 @@ describe('AgentWidgetClient - diff-only clientTools (client-token)', () => {
     });
     const client = new AgentWidgetClient({
       clientToken: 'ct_live_demo',
-      apiUrl: 'https://api.runtype-staging.com',
+      apiUrl: 'https://api.runtype.com',
     });
     // Pre-seed a stale fingerprint bound to a prior session (no live session, so
     // initSession() takes the mint path and fetches /client/init).

package/src/client.ts

@@ -1297,7 +1297,25 @@ export class AgentWidgetClient {
       };
     };
 
+    const shouldEmitMessage = (msg: AgentWidgetMessage): boolean => {
+      if (msg.role !== "assistant" || msg.variant) return true;
+
+      const hasContentParts =
+        Array.isArray(msg.contentParts) && msg.contentParts.length > 0;
+      const hasRawContent =
+        typeof msg.rawContent === "string" && msg.rawContent.trim() !== "";
+      const hasVisibleText =
+        typeof msg.content === "string" && msg.content.trim() !== "";
+
+      // Do not surface assistant text bubbles that only contain whitespace.
+      // Some providers emit newline-only text parts around a leading tool call;
+      // rendering those as normal messages creates an empty bubble above the
+      // tool card. Keep media/component/stop-reason messages renderable.
+      return hasVisibleText || hasContentParts || hasRawContent || Boolean(msg.stopReason);
+    };
+
     const emitMessage = (msg: AgentWidgetMessage) => {
+      if (!shouldEmitMessage(msg)) return;
       onEvent({
         type: "message",
         message: cloneMessage(msg)