@runtypelabs/persona 4.21.1 → 4.22.1

package/dist/history-view.d.cts

@@ -98,6 +98,11 @@ type RuntypeExecutionStreamEvent = ({
     iteration?: number;
     role: "user" | "assistant" | "system";
     seq: number;
+    subagent?: {
+        agentName?: string;
+        parentToolCallId?: string;
+        toolName: string;
+    };
     turnIndex?: number;
     type: "turn_start";
 }) | ({
@@ -132,12 +137,61 @@ 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;
@@ -146,6 +200,11 @@ type RuntypeExecutionStreamEvent = ({
     seq: number;
     startedAt?: string;
     stepType?: string;
+    subagent?: {
+        agentName?: string;
+        parentToolCallId?: string;
+        toolName: string;
+    };
     totalSteps?: number;
     type: "step_start";
 } | ({
@@ -173,6 +232,11 @@ 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";
@@ -195,6 +259,11 @@ type RuntypeExecutionStreamEvent = ({
     role?: "user" | "assistant" | "system";
     seq: number;
     stepId?: string;
+    subagent?: {
+        agentName?: string;
+        parentToolCallId?: string;
+        toolName: string;
+    };
     turnId?: string;
     type: "text_start";
 }) | {
@@ -202,11 +271,21 @@ 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";
 } | ({
@@ -215,18 +294,33 @@ 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";
 }) | ({
@@ -319,6 +413,11 @@ type RuntypeExecutionStreamEvent = ({
     seq: number;
     startedAt?: string;
     stepId?: string;
+    subagent?: {
+        agentName?: string;
+        parentToolCallId?: string;
+        toolName: string;
+    };
     toolCallId: string;
     toolName: string;
     toolType: string;
@@ -327,6 +426,11 @@ type RuntypeExecutionStreamEvent = ({
     delta: string;
     executionId: string;
     seq: number;
+    subagent?: {
+        agentName?: string;
+        parentToolCallId?: string;
+        toolName: string;
+    };
     toolCallId: string;
     type: "tool_input_delta";
 } | {
@@ -334,6 +438,11 @@ 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";
@@ -351,6 +460,11 @@ type RuntypeExecutionStreamEvent = ({
     result?: unknown;
     seq: number;
     stepId?: string;
+    subagent?: {
+        agentName?: string;
+        parentToolCallId?: string;
+        toolName: string;
+    };
     success: boolean;
     toolCallId: string;
     toolCost?: number;
@@ -430,6 +544,19 @@ 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;
@@ -641,15 +768,15 @@ type AgentMessageMetadata = {
      */
     parentStepId?: string;
     /**
-     * Set to `true` on a tool-variant message produced from a `step_await`
+     * Set to `true` on a tool-variant message produced from an `await`
      * event (`awaitReason: "local_tool_required"`). Signals to UI code that
      * the tool call is a LOCAL tool and the server is paused waiting for a
      * `POST /v1/dispatch/resume` with the user's answer keyed by tool name.
      */
     awaitingLocalTool?: boolean;
     /**
-     * The provider per-call id (`toolu_…`) carried on the `step_await` /
-     * `flow_await` events for a LOCAL tool (core#3878). Present only when the
+     * The provider per-call id (`toolu_…`) carried on the `await`
+     * event for a LOCAL tool (core#3878). Present only when the
      * server emits it. Two PARALLEL calls to the same tool in one turn share a
      * `toolName` (and a collapsed `toolId`) but get DISTINCT `webMcpToolCallId`s,
      * so this is the key the widget batches a single `/resume` on: preferred
@@ -959,7 +1086,7 @@ type AgentWidgetReasoning = {
     /**
      * Reasoning channel scope (wire spec). `"turn"` is ordinary per-turn
      * thinking; `"loop"` is a cross-iteration agent reflection (the fold that
-     * replaced the legacy `agent_reflection` event). Absent for legacy streams.
+     * replaced the legacy `agent_reflection` event). Optional when the stream does not specify a scope.
      */
     scope?: "turn" | "loop";
     startedAt?: number;
@@ -973,6 +1100,9 @@ type AgentWidgetToolCall = {
     args?: unknown;
     chunks?: string[];
     result?: unknown;
+    /** Whether the tool succeeded; failure does not necessarily end the execution. */
+    success?: boolean;
+    error?: string;
     duration?: number;
     startedAt?: number;
     completedAt?: number;
@@ -1003,7 +1133,7 @@ type AgentWidgetApproval = {
 type AgentWidgetMessageVariant = "assistant" | "reasoning" | "tool" | "approval";
 /**
  * Per-turn / per-step stop reason emitted by the runtime on
- * `agent_turn_complete` and `step_complete` SSE events. The vocabulary is
+ * `turn_complete` and `step_complete` SSE events. The vocabulary is
  * owned by the upstream Runtype API: do not extend without coordination.
  *
  * - `end_turn`: natural completion (no affordance needed)
@@ -1134,7 +1264,7 @@ type AgentWidgetMessage = {
      */
     agentMetadata?: AgentMessageMetadata;
     /**
-     * Per-turn stop reason reported by the runtime on `agent_turn_complete`
+     * Per-turn stop reason reported by the runtime on `turn_complete`
      * (agent-loop path) or the last `step_complete` for a prompt step
      * (dispatch / flow path). Absent when the API did not report a value.
      *

package/dist/history-view.d.ts

@@ -98,6 +98,11 @@ type RuntypeExecutionStreamEvent = ({
     iteration?: number;
     role: "user" | "assistant" | "system";
     seq: number;
+    subagent?: {
+        agentName?: string;
+        parentToolCallId?: string;
+        toolName: string;
+    };
     turnIndex?: number;
     type: "turn_start";
 }) | ({
@@ -132,12 +137,61 @@ 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;
@@ -146,6 +200,11 @@ type RuntypeExecutionStreamEvent = ({
     seq: number;
     startedAt?: string;
     stepType?: string;
+    subagent?: {
+        agentName?: string;
+        parentToolCallId?: string;
+        toolName: string;
+    };
     totalSteps?: number;
     type: "step_start";
 } | ({
@@ -173,6 +232,11 @@ 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";
@@ -195,6 +259,11 @@ type RuntypeExecutionStreamEvent = ({
     role?: "user" | "assistant" | "system";
     seq: number;
     stepId?: string;
+    subagent?: {
+        agentName?: string;
+        parentToolCallId?: string;
+        toolName: string;
+    };
     turnId?: string;
     type: "text_start";
 }) | {
@@ -202,11 +271,21 @@ 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";
 } | ({
@@ -215,18 +294,33 @@ 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";
 }) | ({
@@ -319,6 +413,11 @@ type RuntypeExecutionStreamEvent = ({
     seq: number;
     startedAt?: string;
     stepId?: string;
+    subagent?: {
+        agentName?: string;
+        parentToolCallId?: string;
+        toolName: string;
+    };
     toolCallId: string;
     toolName: string;
     toolType: string;
@@ -327,6 +426,11 @@ type RuntypeExecutionStreamEvent = ({
     delta: string;
     executionId: string;
     seq: number;
+    subagent?: {
+        agentName?: string;
+        parentToolCallId?: string;
+        toolName: string;
+    };
     toolCallId: string;
     type: "tool_input_delta";
 } | {
@@ -334,6 +438,11 @@ 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";
@@ -351,6 +460,11 @@ type RuntypeExecutionStreamEvent = ({
     result?: unknown;
     seq: number;
     stepId?: string;
+    subagent?: {
+        agentName?: string;
+        parentToolCallId?: string;
+        toolName: string;
+    };
     success: boolean;
     toolCallId: string;
     toolCost?: number;
@@ -430,6 +544,19 @@ 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;
@@ -641,15 +768,15 @@ type AgentMessageMetadata = {
      */
     parentStepId?: string;
     /**
-     * Set to `true` on a tool-variant message produced from a `step_await`
+     * Set to `true` on a tool-variant message produced from an `await`
      * event (`awaitReason: "local_tool_required"`). Signals to UI code that
      * the tool call is a LOCAL tool and the server is paused waiting for a
      * `POST /v1/dispatch/resume` with the user's answer keyed by tool name.
      */
     awaitingLocalTool?: boolean;
     /**
-     * The provider per-call id (`toolu_…`) carried on the `step_await` /
-     * `flow_await` events for a LOCAL tool (core#3878). Present only when the
+     * The provider per-call id (`toolu_…`) carried on the `await`
+     * event for a LOCAL tool (core#3878). Present only when the
      * server emits it. Two PARALLEL calls to the same tool in one turn share a
      * `toolName` (and a collapsed `toolId`) but get DISTINCT `webMcpToolCallId`s,
      * so this is the key the widget batches a single `/resume` on: preferred
@@ -959,7 +1086,7 @@ type AgentWidgetReasoning = {
     /**
      * Reasoning channel scope (wire spec). `"turn"` is ordinary per-turn
      * thinking; `"loop"` is a cross-iteration agent reflection (the fold that
-     * replaced the legacy `agent_reflection` event). Absent for legacy streams.
+     * replaced the legacy `agent_reflection` event). Optional when the stream does not specify a scope.
      */
     scope?: "turn" | "loop";
     startedAt?: number;
@@ -973,6 +1100,9 @@ type AgentWidgetToolCall = {
     args?: unknown;
     chunks?: string[];
     result?: unknown;
+    /** Whether the tool succeeded; failure does not necessarily end the execution. */
+    success?: boolean;
+    error?: string;
     duration?: number;
     startedAt?: number;
     completedAt?: number;
@@ -1003,7 +1133,7 @@ type AgentWidgetApproval = {
 type AgentWidgetMessageVariant = "assistant" | "reasoning" | "tool" | "approval";
 /**
  * Per-turn / per-step stop reason emitted by the runtime on
- * `agent_turn_complete` and `step_complete` SSE events. The vocabulary is
+ * `turn_complete` and `step_complete` SSE events. The vocabulary is
  * owned by the upstream Runtype API: do not extend without coordination.
  *
  * - `end_turn`: natural completion (no affordance needed)
@@ -1134,7 +1264,7 @@ type AgentWidgetMessage = {
      */
     agentMetadata?: AgentMessageMetadata;
     /**
-     * Per-turn stop reason reported by the runtime on `agent_turn_complete`
+     * Per-turn stop reason reported by the runtime on `turn_complete`
      * (agent-loop path) or the last `step_complete` for a prompt step
      * (dispatch / flow path). Absent when the API did not report a value.
      *