@runtypelabs/persona 4.19.0 → 4.21.0

package/dist/theme-editor-preview.d.cts

@@ -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;
 }) | ({
@@ -2938,6 +2981,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';
 };
 /**
  * The coordinates needed to resume a durable agent turn after the SSE
@@ -5860,6 +5919,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.
  *
@@ -5875,6 +5943,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;
@@ -6021,6 +6096,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.
@@ -6030,6 +6114,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.
@@ -7348,6 +7438,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 */

package/dist/theme-editor-preview.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;
 }) | ({
@@ -2938,6 +2981,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';
 };
 /**
  * The coordinates needed to resume a durable agent turn after the SSE
@@ -5860,6 +5919,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.
  *
@@ -5875,6 +5943,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;
@@ -6021,6 +6096,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.
@@ -6030,6 +6114,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.
@@ -7348,6 +7438,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 */