@runtypelabs/persona 4.21.1 → 4.22.1

package/src/components/tool-bubble.ts

@@ -1,4 +1,4 @@
-import { createElement } from "../utils/dom";
+import { createElement, createNode } from "../utils/dom";
 import { AgentWidgetMessage, AgentWidgetConfig } from "../types";
 import { formatUnknownValue, describeToolTitle, resolveToolHeaderText, computeToolElapsed, parseFormattedTemplate } from "../utils/formatting";
 import { appendCharSpans } from "../utils/tool-loading-animation";
@@ -73,7 +73,9 @@ const getToolSummaryText = (
   const tool = message.toolCall;
   const toolDisplayConfig = config?.features?.toolCallDisplay;
   const collapsedMode = toolDisplayConfig?.collapsedMode ?? "tool-call";
-  const previewText = getToolPreviewText(message, toolDisplayConfig?.previewMaxLines ?? 3);
+  const previewText = tool?.success === false
+    ? tool.error || "Tool failed"
+    : getToolPreviewText(message, toolDisplayConfig?.previewMaxLines ?? 3);
   const defaultSummary = tool ? describeToolTitle(tool) : "";
 
   if (!tool) {
@@ -96,6 +98,7 @@ const getToolSummaryText = (
     summary = resolveToolHeaderText(tool, toolCallConfig.completeTextTemplate, summary);
   }
 
+  if (tool.success === false) summary += " · Failed";
   return { summary, previewText, isActive };
 };
 
@@ -388,6 +391,14 @@ export const createToolBubble = (message: AgentWidgetMessage, config?: AgentWidg
     content.appendChild(logsBlock);
   }
 
+  if (tool.success === false) {
+    content.appendChild(createNode("div", {
+      className: "persona-text-sm persona-whitespace-pre-wrap",
+      text: tool.error || "Tool failed",
+      attrs: { "data-persona-tool-error": "" },
+    }));
+  }
+
   if (tool.status === "complete" && tool.result !== undefined) {
     const resultBlock = createElement("div", "persona-space-y-1");
     const resultLabel = createElement(

package/src/event-stream-view-bundle.test.ts

@@ -23,9 +23,9 @@ const RUNTIME_MARKERS = [
   "persona-event-stream-view",
   "persona-event-stream-list",
   // Capture/persistence runtime, moved into this chunk alongside the view:
-  // IndexedDB store (createObjectStore) and throughput tracker (flow_run_start).
+  // IndexedDB store (createObjectStore) and throughput tracker (visibleCharCount).
   "createObjectStore",
-  "flow_run_start",
+  "visibleCharCount",
 ];
 
 const SUBPATH = "@runtypelabs/persona/event-stream-view";

package/src/generated/runtype-openapi-contract.ts

@@ -70,6 +70,11 @@ export type RuntypeExecutionStreamEvent = ({
   iteration?: number;
   role: "user" | "assistant" | "system";
   seq: number;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   turnIndex?: number;
   type: "turn_start";
 }) | ({
@@ -104,12 +109,61 @@ export type RuntypeExecutionStreamEvent = ({
   role: "user" | "assistant" | "system";
   seq: number;
   stopReason?: "end_turn" | "max_tool_calls" | "length" | "content_filter" | "error" | "unknown";
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   tokens?: {
   input: number;
   output: number;
 };
   type: "turn_complete";
 }) | {
+  executionId: string;
+  id: string;
+  iteration?: number;
+  model?: string;
+  ordinal: number;
+  provider?: string;
+  seq: number;
+  startedAt?: string;
+  stepId?: string;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
+  turnId?: string;
+  type: "model_call_start";
+} | {
+  completedAt?: string;
+  cost?: number;
+  durationMs?: number;
+  executionId: string;
+  finishReason?: string;
+  id: string;
+  iteration?: number;
+  model?: string;
+  ordinal: number;
+  provider?: string;
+  responseModel?: string;
+  seq: number;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
+  success?: boolean;
+  tokens?: {
+  cacheRead?: number;
+  cacheWrite?: number;
+  input: number;
+  output: number;
+};
+  turnId?: string;
+  type: "model_call_complete";
+} | {
   executionId: string;
   id: string;
   index?: number;
@@ -118,6 +172,11 @@ export type RuntypeExecutionStreamEvent = ({
   seq: number;
   startedAt?: string;
   stepType?: string;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   totalSteps?: number;
   type: "step_start";
 } | ({
@@ -145,6 +204,11 @@ export type RuntypeExecutionStreamEvent = ({
   seq: number;
   stepType?: string;
   stopReason?: "end_turn" | "max_tool_calls" | "length" | "content_filter" | "error" | "unknown";
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   success?: boolean;
   tokensUsed?: number;
   type: "step_complete";
@@ -167,6 +231,11 @@ export type RuntypeExecutionStreamEvent = ({
   role?: "user" | "assistant" | "system";
   seq: number;
   stepId?: string;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   turnId?: string;
   type: "text_start";
 }) | {
@@ -174,11 +243,21 @@ export type RuntypeExecutionStreamEvent = ({
   executionId: string;
   id: string;
   seq: number;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   type: "text_delta";
 } | {
   executionId: string;
   id: string;
   seq: number;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   text?: string;
   type: "text_complete";
 } | ({
@@ -187,18 +266,33 @@ export type RuntypeExecutionStreamEvent = ({
   parentToolCallId?: string;
   scope?: "turn" | "loop";
   seq: number;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   type: "reasoning_start";
 }) | {
   delta: string;
   executionId: string;
   id: string;
   seq: number;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   type: "reasoning_delta";
 } | ({
   executionId: string;
   id: string;
   scope?: "turn" | "loop";
   seq: number;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   text?: string;
   type: "reasoning_complete";
 }) | ({
@@ -291,6 +385,11 @@ export type RuntypeExecutionStreamEvent = ({
   seq: number;
   startedAt?: string;
   stepId?: string;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   toolCallId: string;
   toolName: string;
   toolType: string;
@@ -299,6 +398,11 @@ export type RuntypeExecutionStreamEvent = ({
   delta: string;
   executionId: string;
   seq: number;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   toolCallId: string;
   type: "tool_input_delta";
 } | {
@@ -306,6 +410,11 @@ export type RuntypeExecutionStreamEvent = ({
   hiddenParameterNames?: Array<string>;
   parameters: Record<string, unknown>;
   seq: number;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   toolCallId: string;
   toolName?: string;
   type: "tool_input_complete";
@@ -323,6 +432,11 @@ export type RuntypeExecutionStreamEvent = ({
   result?: unknown;
   seq: number;
   stepId?: string;
+  subagent?: {
+  agentName?: string;
+  parentToolCallId?: string;
+  toolName: string;
+};
   success: boolean;
   toolCallId: string;
   toolCost?: number;
@@ -402,6 +516,19 @@ export type RuntypeExecutionStreamEvent = ({
   recoverable?: boolean;
   seq: number;
   type: "error";
+}) | ({
+  epoch: number;
+  executionId: string;
+  kind: "compaction";
+  outcome?: "ok" | "failed" | "gap" | "skipped";
+  phase: "start" | "complete";
+  reason: "threshold" | "overflow" | "manual" | "surface_policy" | "provider_mismatch";
+  seq: number;
+  strategy: "provider_native" | "summary";
+  tier: number;
+  tokensAfter?: number;
+  tokensBefore?: number;
+  type: "context_notice";
 }) | {
   executionId: string;
   seq: number;
@@ -432,12 +559,14 @@ export type RuntypeStopReasonKind = NonNullable<
 >;
 
 export type RuntypeClientInitRequest = {
+  durableRecovery?: boolean;
   flowId?: string;
   identityProof?: string;
   token: string;
   visitorHistory?: boolean;
   visitorToken?: string;
 } | {
+  durableRecovery?: boolean;
   flowId?: string;
   identityProof?: string;
   sessionId: string;
@@ -446,6 +575,7 @@ export type RuntypeClientInitRequest = {
   visitorToken?: string;
 } | {
   conversationId: string;
+  durableRecovery?: boolean;
   flowId?: string;
   identityProof?: string;
   token: string;
@@ -453,6 +583,7 @@ export type RuntypeClientInitRequest = {
   visitorToken: string;
 } | {
   conversationId: string;
+  durableRecovery?: boolean;
   flowId?: string;
   identityProof: string;
   token: string;
@@ -471,6 +602,10 @@ export type RuntypeClientInitResponse = {
 };
   conversationId: string;
   conversationRevision: string;
+  durableRecovery?: {
+  enabled: boolean;
+  join?: boolean;
+};
   expiresAt: string;
   flow?: {
   description?: string | null;
@@ -531,13 +666,14 @@ export type RuntypeClientChatRequest = {
 }>;
   metadata?: Record<string, unknown>;
   sessionId: string;
-  submitMode?: "normal" | "interrupt";
+  submitMode?: "normal" | "interrupt" | "join";
   turnId?: string;
 };
 
 export type RuntypeClientChatStreamEvent = RuntypeExecutionStreamEvent;
 
 export type RuntypeClientResumeRequest = {
+  after?: string;
   assistantMessageId?: string;
   clientTools?: Array<{
   description: string;

package/src/index-core.ts

@@ -1,5 +1,6 @@
 import {
   initAgentWidget as initAgentWidgetFn,
+  getAgentWidgetHandles as getAgentWidgetHandlesFn,
   type AgentWidgetInitHandle
 } from "./runtime/init";
 
@@ -326,6 +327,7 @@ export {
 } from "./suggest-replies-tool";
 
 export { initAgentWidgetFn as initAgentWidget };
+export { getAgentWidgetHandlesFn as getAgentWidgetHandles };
 export {
   createWidgetHostLayout,
   type WidgetHostLayout,

package/src/internal/runtype-history-provider.test.ts

@@ -128,7 +128,7 @@ describe('createRuntypeHistoryProvider', () => {
     fetchMock.mockImplementation((url: string) => {
       if (url.includes('/v1/client/init')) return initOk();
       return respond(200, {
-        conversation: {
+        ...{
           id: 'conv_1',
           title: 'Saved',
           targetId: 'flow_1',
@@ -182,7 +182,7 @@ describe('createRuntypeHistoryProvider', () => {
     fetchMock.mockImplementation((url: string) => {
       if (url.includes('/v1/client/init')) return initOk();
       return respond(200, {
-        conversation: { id: 'conv_1', title: 'Saved', targetId: null, messageCount: 1 },
+        id: 'conv_1', title: 'Saved', targetId: null, messageCount: 1,
         // No timestamps: the mapper must synthesize them under the boundary.
         messages: [{ id: 'old1', role: 'user', content: 'older', displayAvailable: true }],
         nextMessageCursor: null,

package/src/runtime/init.registry.test.ts

@@ -0,0 +1,56 @@
+// @vitest-environment jsdom
+
+/**
+ * `getAgentWidgetHandles()` registry: every `initAgentWidget()` mount is
+ * listed (oldest first) until its `destroy()`, so companions created after
+ * `persona:chat-ready` fired can still adopt a mounted widget.
+ */
+
+import { afterEach, describe, expect, it } from "vitest";
+
+import { getAgentWidgetHandles, initAgentWidget } from "./init";
+
+const mountHost = (id: string): HTMLElement => {
+  const host = document.createElement("div");
+  host.id = id;
+  document.body.appendChild(host);
+  return host;
+};
+
+const CONFIG = {
+  apiUrl: "https://api.example.com/chat",
+  launcher: { enabled: false },
+  persistState: false,
+};
+
+describe("getAgentWidgetHandles", () => {
+  afterEach(() => {
+    // Sweep any instances a failing assertion left behind.
+    for (const handle of getAgentWidgetHandles()) handle.destroy();
+    document.body.innerHTML = "";
+  });
+
+  it("lists mounted handles oldest-first and drops them on destroy", () => {
+    expect(getAgentWidgetHandles()).toEqual([]);
+
+    const first = initAgentWidget({ target: mountHost("reg-a"), config: CONFIG });
+    const second = initAgentWidget({ target: mountHost("reg-b"), config: CONFIG });
+
+    expect(getAgentWidgetHandles()).toEqual([first, second]);
+    expect(getAgentWidgetHandles().at(-1)).toBe(second);
+
+    second.destroy();
+    expect(getAgentWidgetHandles()).toEqual([first]);
+
+    first.destroy();
+    expect(getAgentWidgetHandles()).toEqual([]);
+  });
+
+  it("returns a copy, not the live registry", () => {
+    const handle = initAgentWidget({ target: mountHost("reg-c"), config: CONFIG });
+    const snapshot = getAgentWidgetHandles();
+    snapshot.length = 0;
+    expect(getAgentWidgetHandles()).toEqual([handle]);
+    handle.destroy();
+  });
+});

package/src/runtime/init.ts

@@ -46,6 +46,19 @@ const mountStyles = (root: ShadowRoot | HTMLElement, ownerDocument: Document) =>
 
 export type AgentWidgetInitHandle = AgentWidgetController & { host: HTMLElement };
 
+// Live handles for every mounted initAgentWidget() instance, oldest first.
+// `persona:chat-ready` is a one-shot broadcast and `windowKey` is opt-in, so
+// code that runs after a widget mounted previously had no way to reach it.
+// This registry closes that gap: late companions (selection toolbars, host
+// integrations) can adopt the most recent mount via
+// `getAgentWidgetHandles().at(-1)`. Handles deregister on destroy().
+const activeHandles: AgentWidgetInitHandle[] = [];
+
+/** Handles of all currently mounted widgets, oldest first. */
+export const getAgentWidgetHandles = (): AgentWidgetInitHandle[] => [
+  ...activeHandles,
+];
+
 export const initAgentWidget = (
   options: AgentWidgetInitOptions
 ): AgentWidgetInitHandle => {
@@ -154,6 +167,8 @@ export const initAgentWidget = (
     destroy() {
       destroyCurrentController();
       hostLayout.destroy();
+      const index = activeHandles.indexOf(handle);
+      if (index !== -1) activeHandles.splice(index, 1);
       if (options.windowKey && typeof window !== "undefined") {
         delete (window as any)[options.windowKey];
       }
@@ -175,6 +190,8 @@ export const initAgentWidget = (
     }
   }) as AgentWidgetInitHandle;
 
+  activeHandles.push(handle);
+
   if (options.windowKey && typeof window !== 'undefined') {
     (window as any)[options.windowKey] = handle;
   }

package/src/session-history.test.ts

@@ -302,7 +302,7 @@ function createRuntypeBackend() {
       const end = cursor ? Number(cursor) : conversation.messages.length;
       const start = Math.max(0, end - PAGE_SIZE);
       return respond(200, {
-        conversation: summarize(conversation),
+        ...summarize(conversation),
         messages: conversation.messages.slice(start, end),
         nextMessageCursor: start > 0 ? String(start) : null,
         conversationRevision: conversation.revision,

package/src/session.quote.test.ts

@@ -12,7 +12,7 @@ const streamResponse = () => {
     body: new ReadableStream({
       start(controller) {
         controller.enqueue(
-          encoder.encode('data: {"type":"flow_complete","success":true}\n\n')
+          encoder.encode('data: {"type":"execution_complete","success":true}\n\n')
         );
         controller.close();
       },

package/src/session.resubmit-from.test.ts

@@ -13,7 +13,7 @@ const streamResponse = () => {
     body: new ReadableStream({
       start(controller) {
         controller.enqueue(
-          encoder.encode('data: {"type":"flow_complete","success":true}\n\n')
+          encoder.encode('data: {"type":"execution_complete","success":true}\n\n')
         );
         controller.close();
       },

package/src/session.test.ts

@@ -538,7 +538,7 @@ describe('AgentWidgetSession.resolveAskUserQuestion', () => {
       const encoder = new TextEncoder();
       const stream = new ReadableStream({
         start(controller) {
-          controller.enqueue(encoder.encode('data: {"type":"flow_complete","success":true}\n\n'));
+          controller.enqueue(encoder.encode('data: {"type":"execution_complete","success":true}\n\n'));
           controller.close();
         },
       });
@@ -578,7 +578,7 @@ describe('AgentWidgetSession.resolveAskUserQuestion', () => {
       const encoder = new TextEncoder();
       const stream = new ReadableStream({
         start(controller) {
-          controller.enqueue(encoder.encode('data: {"type":"flow_complete","success":true}\n\n'));
+          controller.enqueue(encoder.encode('data: {"type":"execution_complete","success":true}\n\n'));
           controller.close();
         },
       });
@@ -614,7 +614,7 @@ describe('AgentWidgetSession.resolveAskUserQuestion', () => {
       const encoder = new TextEncoder();
       const stream = new ReadableStream({
         start(controller) {
-          controller.enqueue(encoder.encode('data: {"type":"flow_complete","success":true}\n\n'));
+          controller.enqueue(encoder.encode('data: {"type":"execution_complete","success":true}\n\n'));
           controller.close();
         },
       });
@@ -727,7 +727,7 @@ describe('AgentWidgetSession.resolveAskUserQuestion', () => {
     const encoder = new TextEncoder();
     const stream = new ReadableStream({
       start(controller) {
-        controller.enqueue(encoder.encode('data: {"type":"flow_complete","success":true}\n\n'));
+        controller.enqueue(encoder.encode('data: {"type":"execution_complete","success":true}\n\n'));
         controller.close();
       },
     });
@@ -807,7 +807,7 @@ describe('AgentWidgetSession.resolveApproval', () => {
     const encoder = new TextEncoder();
     const stream = new ReadableStream({
       start(controller) {
-        controller.enqueue(encoder.encode('data: {"type":"flow_complete","success":true}\n\n'));
+        controller.enqueue(encoder.encode('data: {"type":"execution_complete","success":true}\n\n'));
         controller.close();
       },
     });