@runtypelabs/persona 3.26.0 → 3.27.0

package/dist/theme-editor.d.ts

@@ -701,6 +701,556 @@ interface AgentWidgetPlugin {
     onUnregister?: () => void;
 }
 
+type RuntypeAgentSSEEvent = {
+    agentId: string;
+    agentName: string;
+    config?: {
+        enableReflection?: boolean;
+        model?: string;
+    };
+    executionId: string;
+    maxTurns: number;
+    seq: number;
+    startedAt: string;
+    type: "agent_start";
+} | {
+    executionId: string;
+    iteration: number;
+    maxTurns: number;
+    seq: number;
+    startedAt: string;
+    totalCost?: number;
+    type: "agent_iteration_start";
+} | ({
+    executionId: string;
+    iteration: number;
+    role: "user" | "assistant" | "system";
+    seq: number;
+    turnId: string;
+    turnIndex: number;
+    type: "agent_turn_start";
+}) | ({
+    contentType: "text" | "thinking" | "tool_input";
+    delta: string;
+    executionId: string;
+    iteration: number;
+    seq: number;
+    turnId: string;
+    type: "agent_turn_delta";
+}) | ({
+    completedAt: string;
+    content?: string;
+    cost?: number;
+    estimatedContextBreakdown?: {
+        categories: Record<string, {
+            chars: number;
+            estimatedTokens: number;
+        }>;
+        contextWindowSize?: number;
+        estimatedTotalTokens: number;
+        estimatedUtilizationPercent?: number;
+    };
+    executionId: string;
+    iteration: number;
+    role: "user" | "assistant" | "system";
+    seq: number;
+    stopReason?: "end_turn" | "max_tool_calls" | "length" | "content_filter" | "error" | "unknown";
+    tokens?: {
+        input: number;
+        output: number;
+    };
+    turnId: string;
+    type: "agent_turn_complete";
+}) | ({
+    executionId: string;
+    iteration: number;
+    origin?: "webmcp" | "sdk";
+    pageOrigin?: string;
+    parameters?: Record<string, unknown>;
+    seq: number;
+    toolCallId: string;
+    toolName: string;
+    toolType: "flow" | "mcp" | "builtin" | "custom" | "external" | "advisor" | "subagent" | "local";
+    type: "agent_tool_start";
+}) | {
+    delta: string;
+    executionId: string;
+    iteration: number;
+    seq: number;
+    toolCallId: string;
+    type: "agent_tool_delta";
+} | {
+    delta: string;
+    executionId: string;
+    iteration: number;
+    seq: number;
+    toolCallId: string;
+    type: "agent_tool_input_delta";
+} | {
+    executionId: string;
+    hiddenParameterNames?: Array<string>;
+    iteration: number;
+    parameters: Record<string, unknown>;
+    seq: number;
+    toolCallId: string;
+    toolName: string;
+    type: "agent_tool_input_complete";
+} | {
+    executionId: string;
+    executionTime?: number;
+    iteration: number;
+    result?: unknown;
+    seq: number;
+    success: boolean;
+    toolCallId: string;
+    toolName: string;
+    type: "agent_tool_complete";
+} | ({
+    executionId?: string;
+    iteration: number;
+    media: Array<({
+        annotations?: {
+            audience?: Array<"user" | "assistant">;
+        };
+        data: string;
+        mediaType: string;
+        type: "media";
+    }) | ({
+        annotations?: {
+            audience?: Array<"user" | "assistant">;
+        };
+        mediaType?: string;
+        type: "image-url";
+        url: string;
+    }) | ({
+        annotations?: {
+            audience?: Array<"user" | "assistant">;
+        };
+        mediaType: string;
+        type: "file-url";
+        url: string;
+    })>;
+    seq?: number;
+    toolCallId: string;
+    toolName: string;
+    type: "agent_media";
+}) | {
+    approvalId: string;
+    description: string;
+    executionId: string;
+    externalAgent?: {
+        contextId?: string;
+        taskId?: string;
+    };
+    iteration?: number;
+    parameters?: Record<string, unknown>;
+    seq: number;
+    startedAt: string;
+    timeout: number;
+    toolCallId: string;
+    toolName: string;
+    toolType: string;
+    type: "agent_approval_start";
+} | ({
+    approvalId: string;
+    completedAt: string;
+    decision: "approved" | "denied" | "timeout";
+    executionId: string;
+    resolvedBy: "user" | "system";
+    seq: number;
+    type: "agent_approval_complete";
+}) | ({
+    awaitedAt: string;
+    executionId: string;
+    origin?: "webmcp" | "sdk";
+    pageOrigin?: string;
+    parameters?: Record<string, unknown>;
+    seq: number;
+    toolCallId?: string;
+    toolId: string;
+    toolName: string;
+    type: "agent_await";
+}) | {
+    completedAt: string;
+    cost?: number;
+    duration?: number;
+    estimatedContextBreakdown?: {
+        categories: Record<string, {
+            chars: number;
+            estimatedTokens: number;
+        }>;
+        contextWindowSize?: number;
+        estimatedTotalTokens: number;
+        estimatedUtilizationPercent?: number;
+    };
+    executionId: string;
+    iteration: number;
+    output?: string;
+    runningTotalCost?: number;
+    seq: number;
+    stopConditionMet: boolean;
+    tokens?: {
+        input: number;
+        output: number;
+    };
+    toolCallsMade: number;
+    type: "agent_iteration_complete";
+} | {
+    executionId: string;
+    iteration: number;
+    reflection?: string;
+    seq: number;
+    type: "agent_reflection";
+} | {
+    activatedCapabilities: Array<string>;
+    executionId: string;
+    iteration: number;
+    seq: number;
+    skill: string;
+    toolCallId: string;
+    type: "agent_skill_loaded";
+} | ({
+    executionId: string;
+    iteration: number;
+    outcome: "pending_approval" | "auto_published";
+    proposalId?: string;
+    seq: number;
+    skill: string;
+    toolCallId: string;
+    type: "agent_skill_proposed";
+}) | ({
+    agentId: string;
+    completedAt: string;
+    duration?: number;
+    error?: string;
+    executionId: string;
+    externalAgent?: {
+        contextId?: string;
+        taskId?: string;
+    };
+    finalOutput?: string;
+    iterations: number;
+    seq: number;
+    stopReason: "complete" | "end_turn" | "max_turns" | "max_cost" | "timeout" | "error";
+    success: boolean;
+    totalCost?: number;
+    totalTokens?: {
+        input: number;
+        output: number;
+    };
+    type: "agent_complete";
+}) | {
+    error: {
+        code: string;
+        details?: Record<string, unknown>;
+        message: string;
+    };
+    executionId: string;
+    iteration?: number;
+    recoverable: boolean;
+    seq: number;
+    type: "agent_error";
+} | {
+    executionId: string;
+    seq: number;
+    timestamp: string;
+    type: "agent_ping";
+};
+type RuntypeFlowSSEEvent = {
+    executionContext?: Record<string, unknown>;
+    executionId?: string;
+    flowId: string;
+    flowName?: string;
+    input?: unknown;
+    seq?: number;
+    source?: string;
+    startedAt: string;
+    toolContext?: {
+        executionId: string;
+        stepId: string;
+        toolId: string;
+    };
+    totalSteps?: number;
+    type: "flow_start";
+} | {
+    completedAt?: string;
+    completedSteps?: number;
+    duration?: number;
+    executionContext?: Record<string, unknown>;
+    executionId?: string;
+    executionTime?: number;
+    failedSteps?: number;
+    finalOutput?: string;
+    flowId?: string;
+    output?: unknown;
+    seq?: number;
+    source?: string;
+    success?: boolean;
+    successfulSteps?: number;
+    toolContext?: {
+        executionId: string;
+        stepId: string;
+        toolId: string;
+    };
+    totalSteps?: number;
+    totalTokensUsed?: number;
+    type: "flow_complete";
+} | ({
+    code?: string;
+    error: string | {
+        code: string;
+        message: string;
+        stepId?: string;
+        stepType?: string;
+    };
+    executionId?: string;
+    executionTime?: number;
+    flowId?: string;
+    seq?: number;
+    timestamp?: string;
+    toolContext?: {
+        executionId: string;
+        stepId: string;
+        toolId: string;
+    };
+    type: "flow_error";
+    upgradeUrl?: string;
+}) | ({
+    awaitedAt: string;
+    executionId?: string;
+    flowId: string;
+    origin?: "webmcp" | "sdk";
+    pageOrigin?: string;
+    parameters?: Record<string, unknown>;
+    seq?: number;
+    toolCallId?: string;
+    toolId?: string;
+    toolName?: string;
+    type: "flow_await";
+}) | {
+    estimatedTokens?: number;
+    executionId?: string;
+    id?: string;
+    index?: number;
+    name?: string;
+    seq?: number;
+    startedAt: string;
+    stepId?: string;
+    stepName?: string;
+    stepType?: string;
+    toolContext?: {
+        executionId: string;
+        stepId: string;
+        toolId: string;
+    };
+    totalSteps?: number;
+    type: "step_start";
+} | {
+    delta?: string;
+    executionId?: string;
+    id?: string;
+    messageId?: string;
+    partId?: string;
+    seq?: number;
+    text?: string;
+    toolContext?: {
+        executionId: string;
+        stepId: string;
+        toolId: string;
+    };
+    toolId?: string;
+    type: "step_delta";
+} | ({
+    completedAt?: string;
+    duration?: number;
+    durationMs?: number;
+    error?: string;
+    executionId?: string;
+    executionTime?: number;
+    id?: string;
+    index?: number;
+    name?: string;
+    output?: unknown;
+    result?: unknown;
+    seq?: number;
+    stepId?: string;
+    stepName?: string;
+    stepType?: string;
+    stopReason?: "end_turn" | "max_tool_calls" | "length" | "content_filter" | "error" | "unknown";
+    success?: boolean;
+    tokensUsed?: number;
+    toolContext?: {
+        executionId: string;
+        stepId: string;
+        toolId: string;
+    };
+    type: "step_complete";
+}) | {
+    error: string;
+    executionId?: string;
+    executionTime?: number;
+    id?: string;
+    index?: number;
+    name?: string;
+    seq?: number;
+    stepType?: string;
+    type: "step_error";
+} | {
+    error?: string;
+    executionId?: string;
+    id: string;
+    index?: number;
+    name?: string;
+    seq?: number;
+    skippedAt: string;
+    stepType: string;
+    totalSteps: number;
+    type: "step_skip";
+    when: string;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "step_await";
+    [key: string]: unknown;
+} | ({
+    agentContext?: {
+        executionId: string;
+        iteration: number;
+        seq: number;
+    };
+    executionId?: string;
+    hiddenParameterNames?: Array<string>;
+    name?: string;
+    parameters?: Record<string, unknown>;
+    providerOptions?: Record<string, unknown>;
+    seq?: number;
+    startedAt?: string;
+    stepId?: string;
+    toolCallId?: string;
+    toolId?: string;
+    toolName?: string;
+    toolType: "flow" | "mcp" | "builtin" | "custom" | "external" | "advisor" | "subagent" | "local";
+    type: "tool_start";
+    [key: string]: unknown;
+}) | {
+    delta?: string;
+    executionId?: string;
+    seq?: number;
+    toolId?: string;
+    type: "tool_delta";
+    [key: string]: unknown;
+} | {
+    delta: string;
+    executionId?: string;
+    seq?: number;
+    stepId?: string;
+    toolCallId?: string;
+    toolId?: string;
+    type: "tool_input_delta";
+} | {
+    executionId?: string;
+    hiddenParameterNames?: Array<string>;
+    parameters: Record<string, unknown>;
+    providerOptions?: Record<string, unknown>;
+    seq?: number;
+    stepId?: string;
+    toolCallId?: string;
+    toolId?: string;
+    toolName?: string;
+    type: "tool_input_complete";
+} | {
+    agentContext?: {
+        executionId: string;
+        iteration: number;
+        seq: number;
+    };
+    completedAt?: string;
+    error?: string;
+    executionId?: string;
+    executionTime?: number;
+    name?: string;
+    result?: unknown;
+    seq?: number;
+    stepId?: string;
+    success: boolean;
+    toolCallId?: string;
+    toolCost?: number;
+    toolId?: string;
+    toolName?: string;
+    type: "tool_complete";
+} | {
+    agentContext?: {
+        executionId: string;
+        iteration: number;
+        seq: number;
+    };
+    error: string;
+    executionId?: string;
+    executionTime?: number;
+    failedAt?: string;
+    name: string;
+    seq?: number;
+    toolId: string;
+    type: "tool_error";
+} | {
+    executionId?: string;
+    id: string;
+    seq?: number;
+    text: string;
+    type: "chunk";
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "text_start";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "text_end";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "reason_start";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "reason_delta";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "reason_complete";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "source";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "fallback_start";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "fallback_complete";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "fallback_exhausted";
+    [key: string]: unknown;
+};
+type RuntypeStreamEventOf<U, T extends string> = Extract<U, {
+    type: T;
+}>;
+type RuntypeAgentTurnCompleteEvent = RuntypeStreamEventOf<RuntypeAgentSSEEvent, "agent_turn_complete">;
+type RuntypeStepCompleteEvent = RuntypeStreamEventOf<RuntypeFlowSSEEvent, "step_complete">;
+type RuntypeStopReasonKind = NonNullable<RuntypeAgentTurnCompleteEvent["stopReason"] | RuntypeStepCompleteEvent["stopReason"]>;
+
 /**
  * Text content part for multi-modal messages
  */
@@ -4103,7 +4653,7 @@ type AgentWidgetMessageVariant = "assistant" | "reasoning" | "tool" | "approval"
  *
  * Absent (`undefined`) means "not reported" — distinct from `'unknown'`.
  */
-type StopReasonKind = 'end_turn' | 'max_tool_calls' | 'length' | 'content_filter' | 'error' | 'unknown';
+type StopReasonKind = RuntypeStopReasonKind;
 /**
  * Represents a message in the chat conversation.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/persona",
-  "version": "3.26.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

@@ -3146,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 = {
@@ -3157,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 } },
@@ -3176,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 = {
@@ -3185,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 () => {
@@ -3197,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.
@@ -3846,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',
@@ -3904,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',
@@ -3931,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',
@@ -4027,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).