@runtypelabs/persona 4.27.0 → 4.28.1

package/dist/forms-ui.d.cts

@@ -3281,9 +3281,8 @@ type WebMcpConfirmInfo = {
     };
     /**
      * Why the confirm was requested. Currently always `'gate'`: the default
-     * confirm-by-default gate that fires before every `webmcp:*` call. (The
-     * `@mcp-b/webmcp-polyfill` owns the spec's `requestUserInteraction` callback
-     * internally, so Persona no longer surfaces a nested in-tool confirm.)
+     * confirm-by-default gate that fires before every `webmcp:*` call. Tool
+     * callbacks on v6 receive an AbortSignal, not a nested confirmation API.
      */
     reason: 'gate';
 };
@@ -7294,6 +7293,13 @@ type VoiceDelegationRequest = {
         role: string;
         content: unknown;
     }>;
+    /**
+     * Set when the server streams delegated answers (`delegation_stream`): called
+     * with each speakable piece of the turn's answer, in order, while it renders.
+     * The pieces, concatenated, are a prefix of the result's `text`; the result
+     * says how much of it with `streamedChars`.
+     */
+    stream?: (text: string) => void;
 };
 /**
  * How a delegated turn ended, or that it waits on an approval (contract
@@ -7324,6 +7330,12 @@ type VoiceDelegationResult = {
      * @default true
      */
     inChat?: boolean;
+    /**
+     * How many leading characters of `text` already went out through
+     * `request.stream` (the rest, such as an approval script, is unstreamed).
+     * Omitted or 0: nothing was streamed.
+     */
+    streamedChars?: number;
     /**
      * Set when the turn parked on approvals (`text` then asks for the decision).
      * Resolves with the terminal result once the visitor decides (or the
@@ -9541,8 +9553,11 @@ type AgentWidgetConfig = {
     /**
      * WebMCP: consume page-registered tools (`document.modelContext.registerTool`).
      * When `enabled`, the widget installs `@mcp-b/webmcp-polyfill`, snapshots the
-     * registry on every dispatch, ships it as `clientTools[]`, and executes
-     * returned `webmcp:*` tool calls with confirm-by-default gating.
+     * current document's registry on every dispatch, ships it as `clientTools[]`,
+     * and executes returned `webmcp:*` calls with confirm-by-default gating.
+     * Supports host-installed v5 JSON-string and v6 object-input contracts.
+     * The automatic fallback stays on v5 to preserve existing browser support
+     * and callback-result behavior.
      *
      * Server-side policy on the chat surface is the source of truth: these
      * fields layer on top.
@@ -10507,6 +10522,12 @@ type DispatchOptions = {
      * `submitMode: "interrupt"` so the server cancels the prior run.
      */
     interrupt?: boolean;
+    /**
+     * Client-token only: a voice model reads the reply aloud (a delegated voice
+     * turn). Sends `voice: { spoken: true }` so the server asks for a speakable
+     * answer.
+     */
+    voiceSpoken?: boolean;
 };
 type SSEHandler = (event: AgentWidgetEvent) => void;
 type SSEEventCallback = (eventType: string, payload: unknown) => void;

package/dist/forms-ui.d.ts

@@ -3281,9 +3281,8 @@ type WebMcpConfirmInfo = {
     };
     /**
      * Why the confirm was requested. Currently always `'gate'`: the default
-     * confirm-by-default gate that fires before every `webmcp:*` call. (The
-     * `@mcp-b/webmcp-polyfill` owns the spec's `requestUserInteraction` callback
-     * internally, so Persona no longer surfaces a nested in-tool confirm.)
+     * confirm-by-default gate that fires before every `webmcp:*` call. Tool
+     * callbacks on v6 receive an AbortSignal, not a nested confirmation API.
      */
     reason: 'gate';
 };
@@ -7294,6 +7293,13 @@ type VoiceDelegationRequest = {
         role: string;
         content: unknown;
     }>;
+    /**
+     * Set when the server streams delegated answers (`delegation_stream`): called
+     * with each speakable piece of the turn's answer, in order, while it renders.
+     * The pieces, concatenated, are a prefix of the result's `text`; the result
+     * says how much of it with `streamedChars`.
+     */
+    stream?: (text: string) => void;
 };
 /**
  * How a delegated turn ended, or that it waits on an approval (contract
@@ -7324,6 +7330,12 @@ type VoiceDelegationResult = {
      * @default true
      */
     inChat?: boolean;
+    /**
+     * How many leading characters of `text` already went out through
+     * `request.stream` (the rest, such as an approval script, is unstreamed).
+     * Omitted or 0: nothing was streamed.
+     */
+    streamedChars?: number;
     /**
      * Set when the turn parked on approvals (`text` then asks for the decision).
      * Resolves with the terminal result once the visitor decides (or the
@@ -9541,8 +9553,11 @@ type AgentWidgetConfig = {
     /**
      * WebMCP: consume page-registered tools (`document.modelContext.registerTool`).
      * When `enabled`, the widget installs `@mcp-b/webmcp-polyfill`, snapshots the
-     * registry on every dispatch, ships it as `clientTools[]`, and executes
-     * returned `webmcp:*` tool calls with confirm-by-default gating.
+     * current document's registry on every dispatch, ships it as `clientTools[]`,
+     * and executes returned `webmcp:*` calls with confirm-by-default gating.
+     * Supports host-installed v5 JSON-string and v6 object-input contracts.
+     * The automatic fallback stays on v5 to preserve existing browser support
+     * and callback-result behavior.
      *
      * Server-side policy on the chat surface is the source of truth: these
      * fields layer on top.
@@ -10507,6 +10522,12 @@ type DispatchOptions = {
      * `submitMode: "interrupt"` so the server cancels the prior run.
      */
     interrupt?: boolean;
+    /**
+     * Client-token only: a voice model reads the reply aloud (a delegated voice
+     * turn). Sends `voice: { spoken: true }` so the server asks for a speakable
+     * answer.
+     */
+    voiceSpoken?: boolean;
 };
 type SSEHandler = (event: AgentWidgetEvent) => void;
 type SSEEventCallback = (eventType: string, payload: unknown) => void;