@runtypelabs/persona 4.26.1 → 4.28.0

package/dist/index.d.cts

@@ -7580,6 +7580,11 @@ interface VoiceProvider {
     setSessionBridge?(bridge: VoiceSessionBridge): void;
     /** The AI-disclosure notice for the live call, if one should show (speech-to-speech). */
     getDisclosure?(): string | null;
+    /**
+     * Status-line text for the call, returned once: why the server ended it
+     * (`session_end`) or that it is reconnecting. `null` when there is none.
+     */
+    takeNotice?(): string | null;
 }
 /** Metadata on a {@link VoiceProvider.onTranscript} update. */
 type VoiceTranscriptMetadata = {
@@ -7611,6 +7616,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
@@ -7641,6 +7653,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
@@ -8553,6 +8571,14 @@ type ClientChatRequest = {
     turnId?: RuntypeClientChatRequest['turnId'];
     /** Whether this turn should interrupt a prior in-flight response (from Core public OpenAPI). */
     submitMode?: RuntypeClientChatRequest['submitMode'];
+    /**
+     * Spoken-reply hint, set on a delegated voice turn whose reply a voice model
+     * reads aloud: the server asks the agent for a speakable answer (the direct
+     * answer first, in plain sentences). Not persisted into history.
+     */
+    voice?: {
+        spoken: true;
+    };
 };
 /**
  * Feedback types supported by the API
@@ -11017,6 +11043,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;
@@ -11442,6 +11474,8 @@ declare class AgentWidgetSession {
      * Get current voice status
      */
     getVoiceStatus(): VoiceStatus;
+    /** The voice call's pending status-line notice (why it ended, or reconnecting), once. */
+    getVoiceNotice(): string | null;
     /** The live call's AI-disclosure notice, if it shows one. */
     getVoiceDisclosure(): string | null;
     /**

package/dist/index.d.ts

@@ -7580,6 +7580,11 @@ interface VoiceProvider {
     setSessionBridge?(bridge: VoiceSessionBridge): void;
     /** The AI-disclosure notice for the live call, if one should show (speech-to-speech). */
     getDisclosure?(): string | null;
+    /**
+     * Status-line text for the call, returned once: why the server ended it
+     * (`session_end`) or that it is reconnecting. `null` when there is none.
+     */
+    takeNotice?(): string | null;
 }
 /** Metadata on a {@link VoiceProvider.onTranscript} update. */
 type VoiceTranscriptMetadata = {
@@ -7611,6 +7616,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
@@ -7641,6 +7653,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
@@ -8553,6 +8571,14 @@ type ClientChatRequest = {
     turnId?: RuntypeClientChatRequest['turnId'];
     /** Whether this turn should interrupt a prior in-flight response (from Core public OpenAPI). */
     submitMode?: RuntypeClientChatRequest['submitMode'];
+    /**
+     * Spoken-reply hint, set on a delegated voice turn whose reply a voice model
+     * reads aloud: the server asks the agent for a speakable answer (the direct
+     * answer first, in plain sentences). Not persisted into history.
+     */
+    voice?: {
+        spoken: true;
+    };
 };
 /**
  * Feedback types supported by the API
@@ -11017,6 +11043,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;
@@ -11442,6 +11474,8 @@ declare class AgentWidgetSession {
      * Get current voice status
      */
     getVoiceStatus(): VoiceStatus;
+    /** The voice call's pending status-line notice (why it ended, or reconnecting), once. */
+    getVoiceNotice(): string | null;
     /** The live call's AI-disclosure notice, if it shows one. */
     getVoiceDisclosure(): string | null;
     /**