@runtypelabs/persona 3.30.0 → 3.31.0

package/dist/index.d.cts

@@ -921,6 +921,7 @@ type RuntypeAgentSSEEvent = {
     };
     iteration?: number;
     parameters?: Record<string, unknown>;
+    reason?: string;
     seq: number;
     startedAt: string;
     timeout: number;
@@ -1192,6 +1193,7 @@ type RuntypeFlowSSEEvent = {
     when: string;
 } | {
     executionId?: string;
+    reason?: string;
     seq?: number;
     type: "step_await";
     [key: string]: unknown;
@@ -1470,6 +1472,7 @@ type RuntypeDispatchSSEEvent = {
     };
     iteration?: number;
     parameters?: Record<string, unknown>;
+    reason?: string;
     seq: number;
     startedAt: string;
     timeout: number;
@@ -1740,6 +1743,7 @@ type RuntypeDispatchSSEEvent = {
     when: string;
 } | {
     executionId?: string;
+    reason?: string;
     seq?: number;
     type: "step_await";
     [key: string]: unknown;
@@ -2695,6 +2699,29 @@ type AgentWidgetArtifactsFeature = {
         defaultRenderer: () => HTMLElement;
     }) => HTMLElement | null;
 };
+/**
+ * How the transcript scrolls while an assistant response streams in.
+ *
+ * - `"follow"` (default): keep the newest content pinned to the bottom of the
+ *   viewport, pausing when the user scrolls up and resuming when they return
+ *   to the bottom.
+ * - `"anchor-top"`: on send, scroll the user's message near the top of the
+ *   viewport and hold it there while the response streams in beneath it
+ *   (ChatGPT-style). The transcript never auto-scrolls during streaming.
+ * - `"none"`: never auto-scroll; the scroll-to-bottom affordance is the only
+ *   way back to the latest content.
+ */
+type AgentWidgetScrollMode = "follow" | "anchor-top" | "none";
+type AgentWidgetScrollBehaviorFeature = {
+    /** Scroll behavior during streamed responses. @default "follow" */
+    mode?: AgentWidgetScrollMode;
+    /**
+     * Gap (px) kept between the anchored user message and the top of the
+     * viewport in `"anchor-top"` mode.
+     * @default 16
+     */
+    anchorTopOffset?: number;
+};
 type AgentWidgetScrollToBottomFeature = {
     /**
      * When true, Persona shows a scroll-to-bottom affordance when the user breaks
@@ -2958,6 +2985,8 @@ type AgentWidgetFeatureFlags = {
     composerHistory?: boolean;
     /** Shared transcript + event stream scroll-to-bottom affordance. */
     scrollToBottom?: AgentWidgetScrollToBottomFeature;
+    /** Transcript scroll behavior during streamed responses. */
+    scrollBehavior?: AgentWidgetScrollBehaviorFeature;
     /** Collapsed transcript behavior for tool call rows. */
     toolCallDisplay?: AgentWidgetToolCallDisplayFeature;
     /** Collapsed transcript behavior for reasoning rows. */
@@ -3728,6 +3757,16 @@ type AgentWidgetApprovalConfig = {
     approveLabel?: string;
     /** Label for the deny button */
     denyLabel?: string;
+    /**
+     * Color for the agent-authored reason line (the agent's per-call
+     * justification, shown attributed below the summary when present).
+     */
+    reasonColor?: string;
+    /**
+     * Label prefix for the agent-authored reason line.
+     * Defaults to "Agent's stated reason:".
+     */
+    reasonLabel?: string;
     /**
      * How the technical details (the tool's agent-facing description and the
      * raw parameters JSON) are presented:
@@ -3753,6 +3792,12 @@ type AgentWidgetApprovalConfig = {
         description: string;
         parameters?: unknown;
         displayTitle?: string;
+        /**
+         * Agent-authored justification for this specific call, when the agent
+         * provided one. It is the agent's own claim — if you fold it into the
+         * summary, keep it attributed to the agent.
+         */
+        reason?: string;
     }) => string | undefined;
     /**
      * Custom handler for approval decisions.
@@ -5627,6 +5672,13 @@ type AgentWidgetApproval = {
     toolName: string;
     toolType?: string;
     description: string;
+    /**
+     * Agent-authored justification for this specific call (the agent's own
+     * claim about its intent, extracted server-side from the reserved
+     * `_approvalReason` parameter). Render it attributed to the agent and as
+     * plain text — it is approver context, not a system statement.
+     */
+    reason?: string;
     parameters?: unknown;
     resolvedAt?: number;
 };

package/dist/index.d.ts

@@ -921,6 +921,7 @@ type RuntypeAgentSSEEvent = {
     };
     iteration?: number;
     parameters?: Record<string, unknown>;
+    reason?: string;
     seq: number;
     startedAt: string;
     timeout: number;
@@ -1192,6 +1193,7 @@ type RuntypeFlowSSEEvent = {
     when: string;
 } | {
     executionId?: string;
+    reason?: string;
     seq?: number;
     type: "step_await";
     [key: string]: unknown;
@@ -1470,6 +1472,7 @@ type RuntypeDispatchSSEEvent = {
     };
     iteration?: number;
     parameters?: Record<string, unknown>;
+    reason?: string;
     seq: number;
     startedAt: string;
     timeout: number;
@@ -1740,6 +1743,7 @@ type RuntypeDispatchSSEEvent = {
     when: string;
 } | {
     executionId?: string;
+    reason?: string;
     seq?: number;
     type: "step_await";
     [key: string]: unknown;
@@ -2695,6 +2699,29 @@ type AgentWidgetArtifactsFeature = {
         defaultRenderer: () => HTMLElement;
     }) => HTMLElement | null;
 };
+/**
+ * How the transcript scrolls while an assistant response streams in.
+ *
+ * - `"follow"` (default): keep the newest content pinned to the bottom of the
+ *   viewport, pausing when the user scrolls up and resuming when they return
+ *   to the bottom.
+ * - `"anchor-top"`: on send, scroll the user's message near the top of the
+ *   viewport and hold it there while the response streams in beneath it
+ *   (ChatGPT-style). The transcript never auto-scrolls during streaming.
+ * - `"none"`: never auto-scroll; the scroll-to-bottom affordance is the only
+ *   way back to the latest content.
+ */
+type AgentWidgetScrollMode = "follow" | "anchor-top" | "none";
+type AgentWidgetScrollBehaviorFeature = {
+    /** Scroll behavior during streamed responses. @default "follow" */
+    mode?: AgentWidgetScrollMode;
+    /**
+     * Gap (px) kept between the anchored user message and the top of the
+     * viewport in `"anchor-top"` mode.
+     * @default 16
+     */
+    anchorTopOffset?: number;
+};
 type AgentWidgetScrollToBottomFeature = {
     /**
      * When true, Persona shows a scroll-to-bottom affordance when the user breaks
@@ -2958,6 +2985,8 @@ type AgentWidgetFeatureFlags = {
     composerHistory?: boolean;
     /** Shared transcript + event stream scroll-to-bottom affordance. */
     scrollToBottom?: AgentWidgetScrollToBottomFeature;
+    /** Transcript scroll behavior during streamed responses. */
+    scrollBehavior?: AgentWidgetScrollBehaviorFeature;
     /** Collapsed transcript behavior for tool call rows. */
     toolCallDisplay?: AgentWidgetToolCallDisplayFeature;
     /** Collapsed transcript behavior for reasoning rows. */
@@ -3728,6 +3757,16 @@ type AgentWidgetApprovalConfig = {
     approveLabel?: string;
     /** Label for the deny button */
     denyLabel?: string;
+    /**
+     * Color for the agent-authored reason line (the agent's per-call
+     * justification, shown attributed below the summary when present).
+     */
+    reasonColor?: string;
+    /**
+     * Label prefix for the agent-authored reason line.
+     * Defaults to "Agent's stated reason:".
+     */
+    reasonLabel?: string;
     /**
      * How the technical details (the tool's agent-facing description and the
      * raw parameters JSON) are presented:
@@ -3753,6 +3792,12 @@ type AgentWidgetApprovalConfig = {
         description: string;
         parameters?: unknown;
         displayTitle?: string;
+        /**
+         * Agent-authored justification for this specific call, when the agent
+         * provided one. It is the agent's own claim — if you fold it into the
+         * summary, keep it attributed to the agent.
+         */
+        reason?: string;
     }) => string | undefined;
     /**
      * Custom handler for approval decisions.
@@ -5627,6 +5672,13 @@ type AgentWidgetApproval = {
     toolName: string;
     toolType?: string;
     description: string;
+    /**
+     * Agent-authored justification for this specific call (the agent's own
+     * claim about its intent, extracted server-side from the reserved
+     * `_approvalReason` parameter). Render it attributed to the agent and as
+     * plain text — it is approver context, not a system statement.
+     */
+    reason?: string;
     parameters?: unknown;
     resolvedAt?: number;
 };