@runtypelabs/persona 4.21.1 → 4.22.0

package/dist/theme-editor.d.cts

@@ -25,7 +25,11 @@ interface ColorPalette {
     warning: ColorShade;
     error: ColorShade;
     info: ColorShade;
-    [key: string]: ColorShade;
+    /** Event-stream tool badge family. */
+    purple?: ColorShade;
+    /** Event-stream agent badge family. */
+    teal?: ColorShade;
+    [key: string]: ColorShade | undefined;
 }
 interface SpacingScale {
     0: string;
@@ -597,6 +601,38 @@ interface ToolBubbleTokens {
 interface ReasoningBubbleTokens {
     shadow: string;
 }
+/** One event-stream badge chip: fill + text pair. The chip border derives
+ * from `foreground` at ~31% alpha. */
+interface EventStreamBadgePairTokens {
+    background: TokenReference<'color'>;
+    foreground: TokenReference<'color'>;
+}
+/**
+ * Event-stream inspector badge chips (`features.eventStream`), one pair per
+ * unified event family. Materialized into every theme and emitted as
+ * `--persona-event-badge-<family>-{bg,fg}`, with scheme-appropriate defaults:
+ * light themes pair a 100-tone fill with a 700-tone text, the built-in dark
+ * layer flips to a 900-tone fill with a 300-tone text. `badge.default` colors
+ * event types no family matches.
+ */
+interface EventStreamTokens {
+    badge: {
+        /** `flow_*` events. */
+        flow: EventStreamBadgePairTokens;
+        /** `step_*` events. */
+        step: EventStreamBadgePairTokens;
+        /** `reasoning_*` events. */
+        reasoning: EventStreamBadgePairTokens;
+        /** `tool_*` events. */
+        tool: EventStreamBadgePairTokens;
+        /** `agent_*` events. */
+        agent: EventStreamBadgePairTokens;
+        /** `error` / `execution_error` events. */
+        error: EventStreamBadgePairTokens;
+        /** Any event type no other family matches. */
+        default: EventStreamBadgePairTokens;
+    };
+}
 /** Scrollbar appearance shared by every scroller in the widget. */
 interface ScrollbarTokens {
     /** Thumb color. @default semantic.colors.border */
@@ -945,6 +981,8 @@ interface ComponentTokens {
     attachment: AttachmentTokens;
     toolBubble: ToolBubbleTokens;
     reasoningBubble: ReasoningBubbleTokens;
+    /** Event-stream inspector badge chips. */
+    eventStream?: EventStreamTokens;
     composer: ComposerChromeTokens;
     /** Shared motion timing for composer chrome animation. */
     motion?: MotionTokens;
@@ -2919,6 +2957,14 @@ type ClientToolDefinition = {
         readOnlyHint?: boolean;
         untrustedContentHint?: boolean;
     };
+    /**
+     * Hoisted copy of `annotations.untrustedContentHint`. This is the field the
+     * server actually acts on (`InlineClientToolSchema`): it spotlights the
+     * tool's output before the model reads it, so instructions embedded in
+     * page-provided content (reviews, comments, emails) are not treated as
+     * instructions. `annotations` itself is trace/dashboard metadata only.
+     */
+    untrustedContentHint?: boolean;
 };
 /**
  * Information passed to the confirm-bubble handler before a `webmcp:*` tool
@@ -4110,6 +4156,16 @@ type AgentWidgetToolCallDisplayFeature = {
      * @default "stack"
      */
     groupedMode?: "stack" | "summary";
+    /**
+     * What happens to a tool call row once it completes.
+     *
+     * - `"kept"` (default): the finished row stays in the transcript.
+     * - `"removed"`: no row is rendered at all, so the transcript gap closes with
+     *   it. The tool call stays on the message and in `getMessages()`.
+     *
+     * @default "kept"
+     */
+    completedVisibility?: AgentWidgetToolCallCompletedVisibility;
     /**
      * When false, tool call bubbles show only the collapsed summary with no
      * expand/collapse toggle. Users see tool awareness without full details.
@@ -4127,6 +4183,8 @@ type AgentWidgetToolCallDisplayFeature = {
      */
     loadingAnimation?: AgentWidgetToolCallLoadingAnimation;
 };
+/** See `features.toolCallDisplay.completedVisibility`. */
+type AgentWidgetToolCallCompletedVisibility = "kept" | "removed";
 type AgentWidgetReasoningDisplayFeature = {
     /**
      * When true, active collapsed reasoning rows can render a lightweight preview block.
@@ -4172,13 +4230,26 @@ type AgentWidgetReasoningDisplayFeature = {
      * - `"kept"` (default): the finished row stays in the transcript.
      * - `"removed"`: no row is rendered at all, so the transcript gap closes with
      *   it. The reasoning text stays on the message and in `getMessages()`.
+     * - `"removed-when-short"`: behaves as `"removed"` when the completed trace
+     *   is short (see `shortThinkThreshold`), and as `"kept"` otherwise.
      *
      * @default "kept"
      */
     completedVisibility?: AgentWidgetReasoningCompletedVisibility;
+    /**
+     * Thresholds used by `completedVisibility: "removed-when-short"` to decide
+     * whether a completed trace counts as short. Duration is checked first when
+     * the reasoning reports one; the character count is a fallback for traces
+     * with no reported duration.
+     * @default { durationMs: 15000, chars: 1200 }
+     */
+    shortThinkThreshold?: {
+        durationMs?: number;
+        chars?: number;
+    };
 };
 /** See `features.reasoningDisplay.completedVisibility`. */
-type AgentWidgetReasoningCompletedVisibility = "kept" | "removed";
+type AgentWidgetReasoningCompletedVisibility = "kept" | "removed" | "removed-when-short";
 /**
  * Reveal animation applied to assistant message text while it is streaming.
  *

package/dist/theme-editor.d.ts

@@ -25,7 +25,11 @@ interface ColorPalette {
     warning: ColorShade;
     error: ColorShade;
     info: ColorShade;
-    [key: string]: ColorShade;
+    /** Event-stream tool badge family. */
+    purple?: ColorShade;
+    /** Event-stream agent badge family. */
+    teal?: ColorShade;
+    [key: string]: ColorShade | undefined;
 }
 interface SpacingScale {
     0: string;
@@ -597,6 +601,38 @@ interface ToolBubbleTokens {
 interface ReasoningBubbleTokens {
     shadow: string;
 }
+/** One event-stream badge chip: fill + text pair. The chip border derives
+ * from `foreground` at ~31% alpha. */
+interface EventStreamBadgePairTokens {
+    background: TokenReference<'color'>;
+    foreground: TokenReference<'color'>;
+}
+/**
+ * Event-stream inspector badge chips (`features.eventStream`), one pair per
+ * unified event family. Materialized into every theme and emitted as
+ * `--persona-event-badge-<family>-{bg,fg}`, with scheme-appropriate defaults:
+ * light themes pair a 100-tone fill with a 700-tone text, the built-in dark
+ * layer flips to a 900-tone fill with a 300-tone text. `badge.default` colors
+ * event types no family matches.
+ */
+interface EventStreamTokens {
+    badge: {
+        /** `flow_*` events. */
+        flow: EventStreamBadgePairTokens;
+        /** `step_*` events. */
+        step: EventStreamBadgePairTokens;
+        /** `reasoning_*` events. */
+        reasoning: EventStreamBadgePairTokens;
+        /** `tool_*` events. */
+        tool: EventStreamBadgePairTokens;
+        /** `agent_*` events. */
+        agent: EventStreamBadgePairTokens;
+        /** `error` / `execution_error` events. */
+        error: EventStreamBadgePairTokens;
+        /** Any event type no other family matches. */
+        default: EventStreamBadgePairTokens;
+    };
+}
 /** Scrollbar appearance shared by every scroller in the widget. */
 interface ScrollbarTokens {
     /** Thumb color. @default semantic.colors.border */
@@ -945,6 +981,8 @@ interface ComponentTokens {
     attachment: AttachmentTokens;
     toolBubble: ToolBubbleTokens;
     reasoningBubble: ReasoningBubbleTokens;
+    /** Event-stream inspector badge chips. */
+    eventStream?: EventStreamTokens;
     composer: ComposerChromeTokens;
     /** Shared motion timing for composer chrome animation. */
     motion?: MotionTokens;
@@ -2919,6 +2957,14 @@ type ClientToolDefinition = {
         readOnlyHint?: boolean;
         untrustedContentHint?: boolean;
     };
+    /**
+     * Hoisted copy of `annotations.untrustedContentHint`. This is the field the
+     * server actually acts on (`InlineClientToolSchema`): it spotlights the
+     * tool's output before the model reads it, so instructions embedded in
+     * page-provided content (reviews, comments, emails) are not treated as
+     * instructions. `annotations` itself is trace/dashboard metadata only.
+     */
+    untrustedContentHint?: boolean;
 };
 /**
  * Information passed to the confirm-bubble handler before a `webmcp:*` tool
@@ -4110,6 +4156,16 @@ type AgentWidgetToolCallDisplayFeature = {
      * @default "stack"
      */
     groupedMode?: "stack" | "summary";
+    /**
+     * What happens to a tool call row once it completes.
+     *
+     * - `"kept"` (default): the finished row stays in the transcript.
+     * - `"removed"`: no row is rendered at all, so the transcript gap closes with
+     *   it. The tool call stays on the message and in `getMessages()`.
+     *
+     * @default "kept"
+     */
+    completedVisibility?: AgentWidgetToolCallCompletedVisibility;
     /**
      * When false, tool call bubbles show only the collapsed summary with no
      * expand/collapse toggle. Users see tool awareness without full details.
@@ -4127,6 +4183,8 @@ type AgentWidgetToolCallDisplayFeature = {
      */
     loadingAnimation?: AgentWidgetToolCallLoadingAnimation;
 };
+/** See `features.toolCallDisplay.completedVisibility`. */
+type AgentWidgetToolCallCompletedVisibility = "kept" | "removed";
 type AgentWidgetReasoningDisplayFeature = {
     /**
      * When true, active collapsed reasoning rows can render a lightweight preview block.
@@ -4172,13 +4230,26 @@ type AgentWidgetReasoningDisplayFeature = {
      * - `"kept"` (default): the finished row stays in the transcript.
      * - `"removed"`: no row is rendered at all, so the transcript gap closes with
      *   it. The reasoning text stays on the message and in `getMessages()`.
+     * - `"removed-when-short"`: behaves as `"removed"` when the completed trace
+     *   is short (see `shortThinkThreshold`), and as `"kept"` otherwise.
      *
      * @default "kept"
      */
     completedVisibility?: AgentWidgetReasoningCompletedVisibility;
+    /**
+     * Thresholds used by `completedVisibility: "removed-when-short"` to decide
+     * whether a completed trace counts as short. Duration is checked first when
+     * the reasoning reports one; the character count is a fallback for traces
+     * with no reported duration.
+     * @default { durationMs: 15000, chars: 1200 }
+     */
+    shortThinkThreshold?: {
+        durationMs?: number;
+        chars?: number;
+    };
 };
 /** See `features.reasoningDisplay.completedVisibility`. */
-type AgentWidgetReasoningCompletedVisibility = "kept" | "removed";
+type AgentWidgetReasoningCompletedVisibility = "kept" | "removed" | "removed-when-short";
 /**
  * Reveal animation applied to assistant message text while it is streaming.
  *