@runtypelabs/persona 4.19.0 → 4.21.0

package/dist/forms-ui.d.ts

@@ -1224,27 +1224,66 @@ interface ComposerSegmentedTokens {
     itemPadding?: string;
 }
 /**
- * Model picker popover (`composer.modelPicker.presentation: "popover"`).
+ * Model picker chrome (`composer.models`).
+ *
+ * The surface keys (`background`, `hoverBackground`, `borderColor`,
+ * `borderRadius`, `labelColor`) style the CLOSED control, so the native
+ * `<select>` and the `presentation: "popover"` trigger share one vocabulary.
+ * The `menu*`, `rowHoverBackground`, and `descriptionColor` keys style the
+ * popover panel and are inert under the native select, as is `suffixColor`,
+ * which a `<select>` cannot carry either.
  *
  * Every key is optional and unset ones emit nothing: the stylesheet's `var()`
  * fallbacks own the default look, which derives from the surface and ghost
- * button tokens. Inert under the native `<select>` presentation, except
- * `suffixColor`, which the native control cannot carry either.
+ * button tokens.
  */
 interface ComposerModelPickerTokens {
+    /** Closed control fill. @default the ghost button fill (transparent) */
+    background?: TokenReference<'color'>;
+    /** Closed control fill under hover. @default the ghost hover wash */
+    hoverBackground?: TokenReference<'color'>;
+    /**
+     * Closed control outline, drawn as a 1px inset ring so setting it never
+     * resizes the control. @default none
+     */
+    borderColor?: TokenReference<'color'>;
+    /** Closed control corner radius. @default the ghost button radius */
+    borderRadius?: TokenReference<'radius'>;
     /** Panel fill behind the rows. @default semantic.colors.surface */
     menuBackground?: TokenReference<'color'>;
     /** Panel corner radius. @default palette.radius.lg */
     menuBorderRadius?: TokenReference<'radius'>;
     /** Row fill under hover and the focused option. @default the ghost hover wash */
     rowHoverBackground?: TokenReference<'color'>;
-    /** Row label and closed-control label color. @default inherited text */
+    /**
+     * Row label color, plus the closed control's text and chevron in both
+     * presentations. @default the ghost button foreground
+     */
     labelColor?: TokenReference<'color'>;
     /** Second line under a row label. @default semantic.colors.textMuted */
     descriptionColor?: TokenReference<'color'>;
     /** `composer.modelPicker.suffix` on the closed control. @default semantic.colors.textMuted */
     suffixColor?: TokenReference<'color'>;
 }
+/**
+ * Composer overflow `+` menu panel (`composer.actionOverflow`).
+ *
+ * Every key is optional and unset ones emit nothing: the stylesheet's `var()`
+ * fallbacks own the default look. The panel is portaled outside the themed
+ * mount, so the menu forwards the configured values onto it when it opens.
+ */
+interface ComposerOverflowMenuTokens {
+    /** Panel fill behind the rows. @default semantic.colors.surface */
+    background?: TokenReference<'color'>;
+    /** Panel border color. @default semantic.colors.border */
+    borderColor?: TokenReference<'color'>;
+    /** Panel corner radius. @default palette.radius.lg */
+    borderRadius?: TokenReference<'radius'>;
+    /** Row text and glyph color. @default semantic.colors.text */
+    foreground?: TokenReference<'color'>;
+    /** Panel elevation (raw CSS box-shadow, `none` allowed). @default palette.shadows.md */
+    shadow?: string;
+}
 /** Composer (message input) chrome. */
 interface ComposerChromeTokens {
     /** Box-shadow on the composer form (raw CSS, e.g. `none`). */
@@ -1279,8 +1318,10 @@ interface ComposerChromeTokens {
     overlayBand?: string;
     /** Segmented mode-group track. */
     segmented?: ComposerSegmentedTokens;
-    /** Model picker popover chrome. */
+    /** Model picker chrome (closed control plus popover panel). */
     modelPicker?: ComposerModelPickerTokens;
+    /** Overflow `+` menu panel chrome. */
+    overflowMenu?: ComposerOverflowMenuTokens;
 }
 /**
  * Motion timing shared by every composer animation.
@@ -1603,8 +1644,10 @@ type RuntypeExecutionStreamEvent = ({
         message: string;
     };
     executionId: string;
+    finalOutput?: string;
     kind: "agent" | "flow";
     seq: number;
+    stopReason?: string;
     type: "execution_error";
     upgradeUrl?: string;
 }) | ({
@@ -3024,6 +3067,22 @@ type AgentWidgetWebMcpConfig = {
      * `window.confirm` fallback only applies when no widget UI is attached.
      */
     onConfirm?: WebMcpConfirmHandler;
+    /**
+     * How the widget runs the `webmcp:*` calls of ONE turn when the model emits
+     * several at once.
+     *
+     * - `'parallel'` (default): every call executes concurrently and a gated
+     *   sibling's approval never blocks another's execution. Right for
+     *   independent, order-insensitive tools (catalog lookups, add-to-cart).
+     * - `'sequential'`: calls execute one at a time, in the order the model
+     *   emitted them; the next starts only after the previous one settles
+     *   (including its approval bubble). Use this when the page tools share
+     *   mutable state that concurrent execution would interleave, e.g. a
+     *   canvas where every stroke selects a color/tool before drawing.
+     *
+     * Either way, all outputs still return to the server in a single `/resume`.
+     */
+    execution?: 'parallel' | 'sequential';
 };
 /**
  * Agent execution state tracking.
@@ -5829,6 +5888,15 @@ type ComposerActionPlacement = "start" | "end";
  * it, `"overflow"` and `"auto"` both render in the bar.
  */
 type ComposerActionPresentation = "bar" | "overflow" | "auto";
+/**
+ * When a composer action is mounted, as a function of the draft.
+ *
+ * - `"always"` (default): the control is always mounted.
+ * - `"when-empty"`: hidden as soon as the draft holds text or an attachment,
+ *   and while a response streams.
+ * - `"when-text"`: the inverse, on the same draft state the send control reads.
+ */
+type ComposerActionVisibility = "always" | "when-empty" | "when-text";
 /**
  * Fields shared by every composer action.
  *
@@ -5844,6 +5912,13 @@ type ComposerActionBase = {
     presentation?: ComposerActionPresentation;
     order?: number;
     visible?: boolean | ((state: Readonly<ComposerState>) => boolean);
+    /**
+     * Draft-driven visibility, on the same state `sendButton.visibility` reads.
+     * Hidden removes the control from layout and tab order. Combined with
+     * `visible`: both must pass.
+     * @default "always"
+     */
+    visibility?: ComposerActionVisibility;
     disabled?: boolean | ((state: Readonly<ComposerState>) => boolean);
     /** Disable while a response streams, through the composer's own mechanism. */
     disableWhenStreaming?: boolean;
@@ -5990,6 +6065,15 @@ type ComposerMode = {
  *   row, never in the overflow menu.
  */
 type ComposerModeGroupPresentation = "buttons" | "segmented";
+/**
+ * Whether a group's active modes also render as removable chips.
+ *
+ * - `"auto"` (default): one chip per active mode, except under `"segmented"`
+ *   presentation, where the track already shows the state.
+ * - `"hidden"`: no chips for this group under any presentation. The pressed bar
+ *   button carries the state, and deselection stays on the button.
+ */
+type ComposerModeChipVisibility = "auto" | "hidden";
 /**
  * Selection policy for a set of modes. `"single"` deselects siblings when one
  * is chosen; `"multiple"` toggles independently.
@@ -5999,6 +6083,12 @@ type ComposerModeGroup = {
     selection: "single" | "multiple";
     /** @default "buttons" */
     presentation?: ComposerModeGroupPresentation;
+    /**
+     * Chip row policy for this group's active modes. The chip row itself is
+     * derived from its children, so a group with no other chips leaves no gap.
+     * @default "auto"
+     */
+    chipVisibility?: ComposerModeChipVisibility;
     /**
      * Accessible name for a segmented track. With it the track is a labelled
      * `role="group"`; without it the segments stand on their own names.
@@ -7353,6 +7443,10 @@ type ClientSession = {
     targetId?: string;
     /** Opaque change token; differs whenever the conversation transcript mutated. */
     conversationRevision?: string;
+    /** Server-negotiated durable reconnect support for this client-token session. */
+    durableRecovery?: {
+        enabled: boolean;
+    };
     /** Visitor grant backing history. `token` appears only at mint. */
     visitor?: ClientVisitorGrant;
     /** Configuration from the server */
@@ -7452,6 +7546,17 @@ interface WidgetHistoryInternals {
     /** Persist the revision beside the active conversation id (internal only). */
     setStoredConversationRevision?: (revision: string | null) => void;
     getStoredConversationRevision?: () => string | null;
+    /** Internal client-token durable resume handle, persisted with widget state. */
+    setStoredResumableHandle?: (handle: {
+        executionId: string;
+        after: string;
+    } | null) => void;
+    getStoredResumableHandle?: () => {
+        executionId: string;
+        after: string;
+    } | null;
+    /** True only while Persona owns a persisted client-token recovery attempt. */
+    shouldResumeDurableConversation?: () => boolean;
     /** "Show earlier messages" cursor for the persisted transcript. */
     setStoredMessageCursor?: (cursor: string | null) => void;
     getStoredMessageCursor?: () => string | null;
@@ -9834,6 +9939,12 @@ declare class AgentWidgetClient {
      * Get the current client session (if any)
      */
     getClientSession(): ClientSession | null;
+    /** Persona's built-in reconnect transport for client-token sessions. */
+    reconnectClientTokenStream(ctx: {
+        executionId: string;
+        after: string;
+        signal: AbortSignal;
+    }): Promise<Response>;
     /**
      * Initialize session for client token mode.
      * Called automatically on first message if not already initialized.
@@ -10148,6 +10259,7 @@ declare class AgentWidgetClient {
     resumeFlow(executionId: string, toolOutputs: Record<string, unknown>, options?: {
         streamResponse?: boolean;
         signal?: AbortSignal;
+        after?: string;
     }): Promise<Response>;
     /**
      * The opt-in structured mention channel: the MOST RECENT user turn's
@@ -10998,10 +11110,12 @@ declare class AgentWidgetSession {
     /**
      * Resolve one or more parallel local-tool awaits sharing one paused
      * executionId with a SINGLE `/resume` (core#3878); `resolveWebMcpToolCall`
-     * delegates size-1 resolves here after its guards. Each call is executed
-     * against the page registry concurrently: every gated call renders its own
-     * native approval bubble, and a sibling's confirm Promise never blocks
-     * another's execution. Outputs are keyed by per-call `webMcpToolCallId`
+     * delegates size-1 resolves here after its guards. By default each call is
+     * executed against the page registry concurrently: every gated call renders
+     * its own native approval bubble, and a sibling's confirm Promise never
+     * blocks another's execution. With `webmcp.execution: "sequential"` the
+     * calls run one at a time in emission order instead (see the config docs
+     * for when that matters). Outputs are keyed by per-call `webMcpToolCallId`
      * (server prefers it over tool name; name-keying remains the fallback for
      * legacy single/distinct-tool turns), so two calls to the SAME tool no longer
      * collide. The server is tolerant: any call we omit (declined-after-abort,

package/dist/history-view.d.cts

@@ -86,8 +86,10 @@ type RuntypeExecutionStreamEvent = ({
         message: string;
     };
     executionId: string;
+    finalOutput?: string;
     kind: "agent" | "flow";
     seq: number;
+    stopReason?: string;
     type: "execution_error";
     upgradeUrl?: string;
 }) | ({

package/dist/history-view.d.ts

@@ -86,8 +86,10 @@ type RuntypeExecutionStreamEvent = ({
         message: string;
     };
     executionId: string;
+    finalOutput?: string;
     kind: "agent" | "flow";
     seq: number;
+    stopReason?: string;
     type: "execution_error";
     upgradeUrl?: string;
 }) | ({