@runtypelabs/persona 3.9.2 → 3.10.1

package/dist/index.d.cts

@@ -1176,12 +1176,71 @@ type AgentWidgetScrollToBottomFeature = {
      */
     label?: string;
 };
+type AgentWidgetToolCallCollapsedMode = "tool-call" | "tool-name" | "tool-preview";
+type AgentWidgetToolCallDisplayFeature = {
+    /**
+     * Controls what collapsed tool call rows show in their header/summary area.
+     * @default "tool-call"
+     */
+    collapsedMode?: AgentWidgetToolCallCollapsedMode;
+    /**
+     * When true, active collapsed tool calls can render a lightweight preview block.
+     * @default false
+     */
+    activePreview?: boolean;
+    /**
+     * Optional CSS min-height applied to active collapsed tool call rows.
+     */
+    activeMinHeight?: string;
+    /**
+     * Maximum preview lines shown for collapsed active tool calls.
+     * @default 3
+     */
+    previewMaxLines?: number;
+    /**
+     * When true, consecutive tool call rows can be visually grouped.
+     * @default false
+     */
+    grouped?: boolean;
+    /**
+     * When false, tool call bubbles show only the collapsed summary with no
+     * expand/collapse toggle. Users see tool awareness without full details.
+     * @default true
+     */
+    expandable?: boolean;
+};
+type AgentWidgetReasoningDisplayFeature = {
+    /**
+     * When true, active collapsed reasoning rows can render a lightweight preview block.
+     * @default false
+     */
+    activePreview?: boolean;
+    /**
+     * Optional CSS min-height applied to active collapsed reasoning rows.
+     */
+    activeMinHeight?: string;
+    /**
+     * Maximum preview lines shown for collapsed active reasoning rows.
+     * @default 3
+     */
+    previewMaxLines?: number;
+    /**
+     * When false, reasoning bubbles show only the collapsed summary with no
+     * expand/collapse toggle. Users see reasoning awareness without full details.
+     * @default true
+     */
+    expandable?: boolean;
+};
 type AgentWidgetFeatureFlags = {
     showReasoning?: boolean;
     showToolCalls?: boolean;
     showEventStreamToggle?: boolean;
     /** Shared transcript + event stream scroll-to-bottom affordance. */
     scrollToBottom?: AgentWidgetScrollToBottomFeature;
+    /** Collapsed transcript behavior for tool call rows. */
+    toolCallDisplay?: AgentWidgetToolCallDisplayFeature;
+    /** Collapsed transcript behavior for reasoning rows. */
+    reasoningDisplay?: AgentWidgetReasoningDisplayFeature;
     /** Configuration for the Event Stream inspector view */
     eventStream?: EventStreamConfig;
     /** Optional artifact sidebar (split pane / mobile drawer) */
@@ -1746,6 +1805,65 @@ type AgentWidgetToolCallConfig = {
     codeBlockTextColor?: string;
     toggleTextColor?: string;
     labelTextColor?: string;
+    /**
+     * Override the collapsed summary row content for a tool call bubble.
+     * Return `null` to fall back to the built-in summary for the active display mode.
+     */
+    renderCollapsedSummary?: (context: {
+        message: AgentWidgetMessage;
+        toolCall: AgentWidgetToolCall;
+        defaultSummary: string;
+        previewText: string;
+        collapsedMode: AgentWidgetToolCallCollapsedMode;
+        isActive: boolean;
+        config: AgentWidgetConfig;
+    }) => HTMLElement | string | null;
+    /**
+     * Override the lightweight collapsed preview content shown for active tool rows.
+     * Return `null` to fall back to the built-in preview text.
+     */
+    renderCollapsedPreview?: (context: {
+        message: AgentWidgetMessage;
+        toolCall: AgentWidgetToolCall;
+        defaultPreview: string;
+        isActive: boolean;
+        config: AgentWidgetConfig;
+    }) => HTMLElement | string | null;
+    /**
+     * Override the summary content for grouped consecutive tool-call containers.
+     * Return `null` to fall back to the built-in `Called [x] tools` summary.
+     */
+    renderGroupedSummary?: (context: {
+        messages: AgentWidgetMessage[];
+        toolCalls: AgentWidgetToolCall[];
+        defaultSummary: string;
+        config: AgentWidgetConfig;
+    }) => HTMLElement | string | null;
+};
+type AgentWidgetReasoningConfig = {
+    /**
+     * Override the collapsed summary row content for a reasoning bubble.
+     * Return `null` to fall back to the built-in summary.
+     */
+    renderCollapsedSummary?: (context: {
+        message: AgentWidgetMessage;
+        reasoning: AgentWidgetReasoning;
+        defaultSummary: string;
+        previewText: string;
+        isActive: boolean;
+        config: AgentWidgetConfig;
+    }) => HTMLElement | string | null;
+    /**
+     * Override the lightweight collapsed preview content shown for active reasoning rows.
+     * Return `null` to fall back to the built-in preview text.
+     */
+    renderCollapsedPreview?: (context: {
+        message: AgentWidgetMessage;
+        reasoning: AgentWidgetReasoning;
+        defaultPreview: string;
+        isActive: boolean;
+        config: AgentWidgetConfig;
+    }) => HTMLElement | string | null;
 };
 type AgentWidgetSuggestionChipsConfig = {
     fontFamily?: "sans-serif" | "serif" | "mono";
@@ -2461,6 +2579,35 @@ type AgentWidgetAttachmentsConfig = {
      * Callback when a file is rejected (wrong type or too large).
      */
     onFileRejected?: (file: File, reason: 'type' | 'size' | 'count') => void;
+    /**
+     * Customize the drag-and-drop overlay that appears when files are dragged over the widget.
+     */
+    dropOverlay?: {
+        /** Background color/value of the overlay. @default 'rgba(59, 130, 246, 0.08)' */
+        background?: string;
+        /** Backdrop blur applied behind the overlay (CSS value). @default '8px' */
+        backdropBlur?: string;
+        /** Border style shown during drag. @default '2px dashed rgba(59, 130, 246, 0.4)' */
+        border?: string;
+        /** Border radius of the overlay. @default 'inherit' */
+        borderRadius?: string;
+        /** Inset/margin pulling the overlay away from the container edges (CSS value). @default '0' */
+        inset?: string;
+        /** Lucide icon name displayed in the center. @default 'upload' */
+        iconName?: string;
+        /** Icon size (CSS value). @default '48px' */
+        iconSize?: string;
+        /** Icon stroke color. @default 'rgba(59, 130, 246, 0.6)' */
+        iconColor?: string;
+        /** Icon stroke width. @default 0.5 */
+        iconStrokeWidth?: number;
+        /** Optional label text shown below the icon. */
+        label?: string;
+        /** Label font size. @default '0.875rem' */
+        labelSize?: string;
+        /** Label color. @default 'rgba(59, 130, 246, 0.8)' */
+        labelColor?: string;
+    };
 };
 /**
  * Configuration for persisting widget state across page navigations.
@@ -2852,6 +2999,7 @@ type AgentWidgetConfig = {
      */
     textToSpeech?: TextToSpeechConfig;
     toolCall?: AgentWidgetToolCallConfig;
+    reasoning?: AgentWidgetReasoningConfig;
     /**
      * Configuration for tool approval bubbles.
      * Set to `false` to disable built-in approval handling entirely.

package/dist/index.d.ts

@@ -1176,12 +1176,71 @@ type AgentWidgetScrollToBottomFeature = {
      */
     label?: string;
 };
+type AgentWidgetToolCallCollapsedMode = "tool-call" | "tool-name" | "tool-preview";
+type AgentWidgetToolCallDisplayFeature = {
+    /**
+     * Controls what collapsed tool call rows show in their header/summary area.
+     * @default "tool-call"
+     */
+    collapsedMode?: AgentWidgetToolCallCollapsedMode;
+    /**
+     * When true, active collapsed tool calls can render a lightweight preview block.
+     * @default false
+     */
+    activePreview?: boolean;
+    /**
+     * Optional CSS min-height applied to active collapsed tool call rows.
+     */
+    activeMinHeight?: string;
+    /**
+     * Maximum preview lines shown for collapsed active tool calls.
+     * @default 3
+     */
+    previewMaxLines?: number;
+    /**
+     * When true, consecutive tool call rows can be visually grouped.
+     * @default false
+     */
+    grouped?: boolean;
+    /**
+     * When false, tool call bubbles show only the collapsed summary with no
+     * expand/collapse toggle. Users see tool awareness without full details.
+     * @default true
+     */
+    expandable?: boolean;
+};
+type AgentWidgetReasoningDisplayFeature = {
+    /**
+     * When true, active collapsed reasoning rows can render a lightweight preview block.
+     * @default false
+     */
+    activePreview?: boolean;
+    /**
+     * Optional CSS min-height applied to active collapsed reasoning rows.
+     */
+    activeMinHeight?: string;
+    /**
+     * Maximum preview lines shown for collapsed active reasoning rows.
+     * @default 3
+     */
+    previewMaxLines?: number;
+    /**
+     * When false, reasoning bubbles show only the collapsed summary with no
+     * expand/collapse toggle. Users see reasoning awareness without full details.
+     * @default true
+     */
+    expandable?: boolean;
+};
 type AgentWidgetFeatureFlags = {
     showReasoning?: boolean;
     showToolCalls?: boolean;
     showEventStreamToggle?: boolean;
     /** Shared transcript + event stream scroll-to-bottom affordance. */
     scrollToBottom?: AgentWidgetScrollToBottomFeature;
+    /** Collapsed transcript behavior for tool call rows. */
+    toolCallDisplay?: AgentWidgetToolCallDisplayFeature;
+    /** Collapsed transcript behavior for reasoning rows. */
+    reasoningDisplay?: AgentWidgetReasoningDisplayFeature;
     /** Configuration for the Event Stream inspector view */
     eventStream?: EventStreamConfig;
     /** Optional artifact sidebar (split pane / mobile drawer) */
@@ -1746,6 +1805,65 @@ type AgentWidgetToolCallConfig = {
     codeBlockTextColor?: string;
     toggleTextColor?: string;
     labelTextColor?: string;
+    /**
+     * Override the collapsed summary row content for a tool call bubble.
+     * Return `null` to fall back to the built-in summary for the active display mode.
+     */
+    renderCollapsedSummary?: (context: {
+        message: AgentWidgetMessage;
+        toolCall: AgentWidgetToolCall;
+        defaultSummary: string;
+        previewText: string;
+        collapsedMode: AgentWidgetToolCallCollapsedMode;
+        isActive: boolean;
+        config: AgentWidgetConfig;
+    }) => HTMLElement | string | null;
+    /**
+     * Override the lightweight collapsed preview content shown for active tool rows.
+     * Return `null` to fall back to the built-in preview text.
+     */
+    renderCollapsedPreview?: (context: {
+        message: AgentWidgetMessage;
+        toolCall: AgentWidgetToolCall;
+        defaultPreview: string;
+        isActive: boolean;
+        config: AgentWidgetConfig;
+    }) => HTMLElement | string | null;
+    /**
+     * Override the summary content for grouped consecutive tool-call containers.
+     * Return `null` to fall back to the built-in `Called [x] tools` summary.
+     */
+    renderGroupedSummary?: (context: {
+        messages: AgentWidgetMessage[];
+        toolCalls: AgentWidgetToolCall[];
+        defaultSummary: string;
+        config: AgentWidgetConfig;
+    }) => HTMLElement | string | null;
+};
+type AgentWidgetReasoningConfig = {
+    /**
+     * Override the collapsed summary row content for a reasoning bubble.
+     * Return `null` to fall back to the built-in summary.
+     */
+    renderCollapsedSummary?: (context: {
+        message: AgentWidgetMessage;
+        reasoning: AgentWidgetReasoning;
+        defaultSummary: string;
+        previewText: string;
+        isActive: boolean;
+        config: AgentWidgetConfig;
+    }) => HTMLElement | string | null;
+    /**
+     * Override the lightweight collapsed preview content shown for active reasoning rows.
+     * Return `null` to fall back to the built-in preview text.
+     */
+    renderCollapsedPreview?: (context: {
+        message: AgentWidgetMessage;
+        reasoning: AgentWidgetReasoning;
+        defaultPreview: string;
+        isActive: boolean;
+        config: AgentWidgetConfig;
+    }) => HTMLElement | string | null;
 };
 type AgentWidgetSuggestionChipsConfig = {
     fontFamily?: "sans-serif" | "serif" | "mono";
@@ -2461,6 +2579,35 @@ type AgentWidgetAttachmentsConfig = {
      * Callback when a file is rejected (wrong type or too large).
      */
     onFileRejected?: (file: File, reason: 'type' | 'size' | 'count') => void;
+    /**
+     * Customize the drag-and-drop overlay that appears when files are dragged over the widget.
+     */
+    dropOverlay?: {
+        /** Background color/value of the overlay. @default 'rgba(59, 130, 246, 0.08)' */
+        background?: string;
+        /** Backdrop blur applied behind the overlay (CSS value). @default '8px' */
+        backdropBlur?: string;
+        /** Border style shown during drag. @default '2px dashed rgba(59, 130, 246, 0.4)' */
+        border?: string;
+        /** Border radius of the overlay. @default 'inherit' */
+        borderRadius?: string;
+        /** Inset/margin pulling the overlay away from the container edges (CSS value). @default '0' */
+        inset?: string;
+        /** Lucide icon name displayed in the center. @default 'upload' */
+        iconName?: string;
+        /** Icon size (CSS value). @default '48px' */
+        iconSize?: string;
+        /** Icon stroke color. @default 'rgba(59, 130, 246, 0.6)' */
+        iconColor?: string;
+        /** Icon stroke width. @default 0.5 */
+        iconStrokeWidth?: number;
+        /** Optional label text shown below the icon. */
+        label?: string;
+        /** Label font size. @default '0.875rem' */
+        labelSize?: string;
+        /** Label color. @default 'rgba(59, 130, 246, 0.8)' */
+        labelColor?: string;
+    };
 };
 /**
  * Configuration for persisting widget state across page navigations.
@@ -2852,6 +2999,7 @@ type AgentWidgetConfig = {
      */
     textToSpeech?: TextToSpeechConfig;
     toolCall?: AgentWidgetToolCallConfig;
+    reasoning?: AgentWidgetReasoningConfig;
     /**
      * Configuration for tool approval bubbles.
      * Set to `false` to disable built-in approval handling entirely.