@roarkanalytics/sdk 3.14.0 → 3.16.0

package/resources/customer-flow.d.ts

@@ -154,12 +154,17 @@ export declare class CustomerFlow extends APIResource {
  * run is graded against rather than an instruction, and it counts as an agent turn
  * for role alternation.
  *
+ * A `CUSTOMER_HANDOFF` hands the phone to another persona (`handoffPersonaId`), or
+ * back to the flow's own persona when it is null. The steps after it are spoken by
+ * whoever holds the phone. It sits between turns like a silence, so it may follow
+ * either side.
+ *
  * In a STRICT flow an `AGENT_TURN` may carry its own `offScriptPolicy`, which
  * replaces the flow-level one at that step. Omit it (or send null) to follow the
  * flow's policy. Use it where one missed step makes the rest of the call
  * meaningless: an authentication menu, say, with `then: HANG_UP_INVALIDATE`.
  */
-export type FlowStep = FlowStep.UnionMember0 | FlowStep.UnionMember1 | FlowStep.UnionMember2 | FlowStep.UnionMember3 | FlowStep.UnionMember4 | FlowStep.UnionMember5 | FlowStep.UnionMember6 | FlowStep.UnionMember7 | FlowStep.UnionMember8;
+export type FlowStep = FlowStep.UnionMember0 | FlowStep.UnionMember1 | FlowStep.UnionMember2 | FlowStep.UnionMember3 | FlowStep.UnionMember4 | FlowStep.UnionMember5 | FlowStep.UnionMember6 | FlowStep.UnionMember7 | FlowStep.UnionMember8 | FlowStep.UnionMember9;
 export declare namespace FlowStep {
     interface UnionMember0 {
         type: 'AGENT_TURN';
@@ -235,6 +240,14 @@ export declare namespace FlowStep {
         steps?: Array<CustomerFlowAPI.FlowStep>;
     }
     interface UnionMember8 {
+        type: 'CUSTOMER_HANDOFF';
+        handoffPersonaId?: string | null;
+        mergeIntoNodeIds?: Array<string>;
+        nodeId?: string;
+        ref?: string;
+        steps?: Array<CustomerFlowAPI.FlowStep>;
+    }
+    interface UnionMember9 {
         type: 'SCENARIO_LINK';
         linkedCustomerFlowId?: string | null;
         linkedCustomerFlowVariantId?: string | null;
@@ -855,6 +868,11 @@ export declare namespace CustomerFlowCreateResponse {
              * project.
              */
             environment: EdgeCase.Environment | null;
+            /**
+             * The personas this brief hands the phone to, in order of first mention. Empty
+             * when the brief inherits the happy path's: read the happy path's list.
+             */
+            handoffPersonas: Array<EdgeCase.HandoffPersona>;
             isGenerated: boolean;
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -869,7 +887,9 @@ export declare namespace CustomerFlowCreateResponse {
              */
             updatedAt: string;
             /**
-             * The brief the simulated customer improvises from.
+             * The brief the simulated customer improvises from. A `@{persona:<id>}` mention
+             * hands the phone to that persona mid-call; the sentences around the mention say
+             * when.
              */
             prompt?: string | null;
             systemKey?: string | null;
@@ -905,6 +925,126 @@ export declare namespace CustomerFlowCreateResponse {
                 updatedAt: string;
                 description?: string | null;
             }
+            interface HandoffPersona {
+                /**
+                 * Unique identifier of the persona
+                 */
+                id: string;
+                /**
+                 * Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with
+                 * optional variants
+                 */
+                accent: 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL';
+                /**
+                 * How old the caller sounds and behaves. Only ages the persona's accent has a
+                 * voice for are accepted; defaults to ADULT, which every accent supports.
+                 */
+                age: 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY';
+                /**
+                 * Background noise setting
+                 */
+                backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
+                /**
+                 * Base emotional state of the persona
+                 */
+                baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED' | 'ANGRY' | 'ANXIOUS' | 'SAD';
+                /**
+                 * How the persona confirms information
+                 */
+                confirmationStyle: 'EXPLICIT' | 'VAGUE';
+                /**
+                 * Creation timestamp
+                 */
+                createdAt: string;
+                /**
+                 * Gender of the persona
+                 */
+                gender: 'MALE' | 'FEMALE';
+                /**
+                 * Whether the persona uses filler words like "um" and "uh"
+                 */
+                hasDisfluencies: boolean;
+                /**
+                 * Maximum number of idle messages the persona will send before giving up
+                 */
+                idleMessageMaxSpokenCount: number;
+                /**
+                 * Whether the idle message counter resets when the agent speaks
+                 */
+                idleMessageResetCountOnUserSpeechEnabled: boolean;
+                /**
+                 * Messages the persona will say when the agent goes silent during a call. null =
+                 * "Automatic": language-appropriate defaults are used at call time.
+                 */
+                idleMessages: Array<string> | null;
+                /**
+                 * Seconds of silence before the persona sends an idle message
+                 */
+                idleTimeoutSeconds: number;
+                /**
+                 * How clearly the persona expresses their intentions
+                 */
+                intentClarity: 'CLEAR' | 'INDIRECT' | 'VAGUE';
+                /**
+                 * Primary language ISO 639-1 code for the persona
+                 */
+                language: 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE';
+                /**
+                 * How reliable the persona's memory is
+                 */
+                memoryReliability: 'HIGH' | 'LOW';
+                /**
+                 * The name the agent will identify as during conversations
+                 */
+                name: string;
+                /**
+                 * Additional custom properties about the persona
+                 */
+                properties: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Controls how quickly the persona responds to pauses in conversation (QUICK,
+                 * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+                 * for several seconds.
+                 */
+                responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
+                /**
+                 * Speech clarity of the persona
+                 */
+                speechClarity: 'CLEAR' | 'VAGUE' | 'RAMBLING';
+                /**
+                 * Speech pace of the persona
+                 */
+                speechPace: 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST';
+                /**
+                 * Languages the persona can understand. Multilingual combinations are limited by
+                 * multilingual speech recognition support.
+                 */
+                understoodLanguages: Array<'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE'>;
+                /**
+                 * Last update timestamp
+                 */
+                updatedAt: string;
+                /**
+                 * Background story and behavioral patterns for the persona
+                 */
+                backstoryPrompt?: string | null;
+                /**
+                 * Human-readable description of the persona
+                 */
+                description?: string | null;
+                /**
+                 * Label shown in place of the name across the dashboard (e.g. a short descriptor
+                 * like "Irate Escalator"). The persona still identifies as `name` on calls. Omit
+                 * or set null to display the name itself.
+                 */
+                displayName?: string | null;
+                /**
+                 * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
+                 */
+                secondaryLanguage?: 'EN' | null;
+            }
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
              */
@@ -1048,6 +1188,11 @@ export declare namespace CustomerFlowCreateResponse {
              * project.
              */
             environment: HappyPath.Environment | null;
+            /**
+             * The personas this brief hands the phone to, in order of first mention. Empty
+             * when the brief inherits the happy path's: read the happy path's list.
+             */
+            handoffPersonas: Array<HappyPath.HandoffPersona>;
             isGenerated: boolean;
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -1062,7 +1207,9 @@ export declare namespace CustomerFlowCreateResponse {
              */
             updatedAt: string;
             /**
-             * The brief the simulated customer improvises from.
+             * The brief the simulated customer improvises from. A `@{persona:<id>}` mention
+             * hands the phone to that persona mid-call; the sentences around the mention say
+             * when.
              */
             prompt?: string | null;
             systemKey?: string | null;
@@ -1098,6 +1245,126 @@ export declare namespace CustomerFlowCreateResponse {
                 updatedAt: string;
                 description?: string | null;
             }
+            interface HandoffPersona {
+                /**
+                 * Unique identifier of the persona
+                 */
+                id: string;
+                /**
+                 * Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with
+                 * optional variants
+                 */
+                accent: 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL';
+                /**
+                 * How old the caller sounds and behaves. Only ages the persona's accent has a
+                 * voice for are accepted; defaults to ADULT, which every accent supports.
+                 */
+                age: 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY';
+                /**
+                 * Background noise setting
+                 */
+                backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
+                /**
+                 * Base emotional state of the persona
+                 */
+                baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED' | 'ANGRY' | 'ANXIOUS' | 'SAD';
+                /**
+                 * How the persona confirms information
+                 */
+                confirmationStyle: 'EXPLICIT' | 'VAGUE';
+                /**
+                 * Creation timestamp
+                 */
+                createdAt: string;
+                /**
+                 * Gender of the persona
+                 */
+                gender: 'MALE' | 'FEMALE';
+                /**
+                 * Whether the persona uses filler words like "um" and "uh"
+                 */
+                hasDisfluencies: boolean;
+                /**
+                 * Maximum number of idle messages the persona will send before giving up
+                 */
+                idleMessageMaxSpokenCount: number;
+                /**
+                 * Whether the idle message counter resets when the agent speaks
+                 */
+                idleMessageResetCountOnUserSpeechEnabled: boolean;
+                /**
+                 * Messages the persona will say when the agent goes silent during a call. null =
+                 * "Automatic": language-appropriate defaults are used at call time.
+                 */
+                idleMessages: Array<string> | null;
+                /**
+                 * Seconds of silence before the persona sends an idle message
+                 */
+                idleTimeoutSeconds: number;
+                /**
+                 * How clearly the persona expresses their intentions
+                 */
+                intentClarity: 'CLEAR' | 'INDIRECT' | 'VAGUE';
+                /**
+                 * Primary language ISO 639-1 code for the persona
+                 */
+                language: 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE';
+                /**
+                 * How reliable the persona's memory is
+                 */
+                memoryReliability: 'HIGH' | 'LOW';
+                /**
+                 * The name the agent will identify as during conversations
+                 */
+                name: string;
+                /**
+                 * Additional custom properties about the persona
+                 */
+                properties: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Controls how quickly the persona responds to pauses in conversation (QUICK,
+                 * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+                 * for several seconds.
+                 */
+                responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
+                /**
+                 * Speech clarity of the persona
+                 */
+                speechClarity: 'CLEAR' | 'VAGUE' | 'RAMBLING';
+                /**
+                 * Speech pace of the persona
+                 */
+                speechPace: 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST';
+                /**
+                 * Languages the persona can understand. Multilingual combinations are limited by
+                 * multilingual speech recognition support.
+                 */
+                understoodLanguages: Array<'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE'>;
+                /**
+                 * Last update timestamp
+                 */
+                updatedAt: string;
+                /**
+                 * Background story and behavioral patterns for the persona
+                 */
+                backstoryPrompt?: string | null;
+                /**
+                 * Human-readable description of the persona
+                 */
+                description?: string | null;
+                /**
+                 * Label shown in place of the name across the dashboard (e.g. a short descriptor
+                 * like "Irate Escalator"). The persona still identifies as `name` on calls. Omit
+                 * or set null to display the name itself.
+                 */
+                displayName?: string | null;
+                /**
+                 * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
+                 */
+                secondaryLanguage?: 'EN' | null;
+            }
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
              */
@@ -2282,6 +2549,11 @@ export declare namespace CustomerFlowUpdateResponse {
              * project.
              */
             environment: EdgeCase.Environment | null;
+            /**
+             * The personas this brief hands the phone to, in order of first mention. Empty
+             * when the brief inherits the happy path's: read the happy path's list.
+             */
+            handoffPersonas: Array<EdgeCase.HandoffPersona>;
             isGenerated: boolean;
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -2296,7 +2568,9 @@ export declare namespace CustomerFlowUpdateResponse {
              */
             updatedAt: string;
             /**
-             * The brief the simulated customer improvises from.
+             * The brief the simulated customer improvises from. A `@{persona:<id>}` mention
+             * hands the phone to that persona mid-call; the sentences around the mention say
+             * when.
              */
             prompt?: string | null;
             systemKey?: string | null;
@@ -2332,10 +2606,7 @@ export declare namespace CustomerFlowUpdateResponse {
                 updatedAt: string;
                 description?: string | null;
             }
-            /**
-             * The persona this runs as instead of the happy path's. Null means it inherits.
-             */
-            interface PersonaOverride {
+            interface HandoffPersona {
                 /**
                  * Unique identifier of the persona
                  */
@@ -2455,8 +2726,131 @@ export declare namespace CustomerFlowUpdateResponse {
                  */
                 secondaryLanguage?: 'EN' | null;
             }
-        }
-        /**
+            /**
+             * The persona this runs as instead of the happy path's. Null means it inherits.
+             */
+            interface PersonaOverride {
+                /**
+                 * Unique identifier of the persona
+                 */
+                id: string;
+                /**
+                 * Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with
+                 * optional variants
+                 */
+                accent: 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL';
+                /**
+                 * How old the caller sounds and behaves. Only ages the persona's accent has a
+                 * voice for are accepted; defaults to ADULT, which every accent supports.
+                 */
+                age: 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY';
+                /**
+                 * Background noise setting
+                 */
+                backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
+                /**
+                 * Base emotional state of the persona
+                 */
+                baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED' | 'ANGRY' | 'ANXIOUS' | 'SAD';
+                /**
+                 * How the persona confirms information
+                 */
+                confirmationStyle: 'EXPLICIT' | 'VAGUE';
+                /**
+                 * Creation timestamp
+                 */
+                createdAt: string;
+                /**
+                 * Gender of the persona
+                 */
+                gender: 'MALE' | 'FEMALE';
+                /**
+                 * Whether the persona uses filler words like "um" and "uh"
+                 */
+                hasDisfluencies: boolean;
+                /**
+                 * Maximum number of idle messages the persona will send before giving up
+                 */
+                idleMessageMaxSpokenCount: number;
+                /**
+                 * Whether the idle message counter resets when the agent speaks
+                 */
+                idleMessageResetCountOnUserSpeechEnabled: boolean;
+                /**
+                 * Messages the persona will say when the agent goes silent during a call. null =
+                 * "Automatic": language-appropriate defaults are used at call time.
+                 */
+                idleMessages: Array<string> | null;
+                /**
+                 * Seconds of silence before the persona sends an idle message
+                 */
+                idleTimeoutSeconds: number;
+                /**
+                 * How clearly the persona expresses their intentions
+                 */
+                intentClarity: 'CLEAR' | 'INDIRECT' | 'VAGUE';
+                /**
+                 * Primary language ISO 639-1 code for the persona
+                 */
+                language: 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE';
+                /**
+                 * How reliable the persona's memory is
+                 */
+                memoryReliability: 'HIGH' | 'LOW';
+                /**
+                 * The name the agent will identify as during conversations
+                 */
+                name: string;
+                /**
+                 * Additional custom properties about the persona
+                 */
+                properties: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Controls how quickly the persona responds to pauses in conversation (QUICK,
+                 * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+                 * for several seconds.
+                 */
+                responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
+                /**
+                 * Speech clarity of the persona
+                 */
+                speechClarity: 'CLEAR' | 'VAGUE' | 'RAMBLING';
+                /**
+                 * Speech pace of the persona
+                 */
+                speechPace: 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST';
+                /**
+                 * Languages the persona can understand. Multilingual combinations are limited by
+                 * multilingual speech recognition support.
+                 */
+                understoodLanguages: Array<'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE'>;
+                /**
+                 * Last update timestamp
+                 */
+                updatedAt: string;
+                /**
+                 * Background story and behavioral patterns for the persona
+                 */
+                backstoryPrompt?: string | null;
+                /**
+                 * Human-readable description of the persona
+                 */
+                description?: string | null;
+                /**
+                 * Label shown in place of the name across the dashboard (e.g. a short descriptor
+                 * like "Irate Escalator"). The persona still identifies as `name` on calls. Omit
+                 * or set null to display the name itself.
+                 */
+                displayName?: string | null;
+                /**
+                 * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
+                 */
+                secondaryLanguage?: 'EN' | null;
+            }
+        }
+        /**
          * One brief to run an improv flow with.
          */
         interface HappyPath {
@@ -2475,6 +2869,11 @@ export declare namespace CustomerFlowUpdateResponse {
              * project.
              */
             environment: HappyPath.Environment | null;
+            /**
+             * The personas this brief hands the phone to, in order of first mention. Empty
+             * when the brief inherits the happy path's: read the happy path's list.
+             */
+            handoffPersonas: Array<HappyPath.HandoffPersona>;
             isGenerated: boolean;
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -2489,7 +2888,9 @@ export declare namespace CustomerFlowUpdateResponse {
              */
             updatedAt: string;
             /**
-             * The brief the simulated customer improvises from.
+             * The brief the simulated customer improvises from. A `@{persona:<id>}` mention
+             * hands the phone to that persona mid-call; the sentences around the mention say
+             * when.
              */
             prompt?: string | null;
             systemKey?: string | null;
@@ -2525,6 +2926,126 @@ export declare namespace CustomerFlowUpdateResponse {
                 updatedAt: string;
                 description?: string | null;
             }
+            interface HandoffPersona {
+                /**
+                 * Unique identifier of the persona
+                 */
+                id: string;
+                /**
+                 * Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with
+                 * optional variants
+                 */
+                accent: 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL';
+                /**
+                 * How old the caller sounds and behaves. Only ages the persona's accent has a
+                 * voice for are accepted; defaults to ADULT, which every accent supports.
+                 */
+                age: 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY';
+                /**
+                 * Background noise setting
+                 */
+                backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
+                /**
+                 * Base emotional state of the persona
+                 */
+                baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED' | 'ANGRY' | 'ANXIOUS' | 'SAD';
+                /**
+                 * How the persona confirms information
+                 */
+                confirmationStyle: 'EXPLICIT' | 'VAGUE';
+                /**
+                 * Creation timestamp
+                 */
+                createdAt: string;
+                /**
+                 * Gender of the persona
+                 */
+                gender: 'MALE' | 'FEMALE';
+                /**
+                 * Whether the persona uses filler words like "um" and "uh"
+                 */
+                hasDisfluencies: boolean;
+                /**
+                 * Maximum number of idle messages the persona will send before giving up
+                 */
+                idleMessageMaxSpokenCount: number;
+                /**
+                 * Whether the idle message counter resets when the agent speaks
+                 */
+                idleMessageResetCountOnUserSpeechEnabled: boolean;
+                /**
+                 * Messages the persona will say when the agent goes silent during a call. null =
+                 * "Automatic": language-appropriate defaults are used at call time.
+                 */
+                idleMessages: Array<string> | null;
+                /**
+                 * Seconds of silence before the persona sends an idle message
+                 */
+                idleTimeoutSeconds: number;
+                /**
+                 * How clearly the persona expresses their intentions
+                 */
+                intentClarity: 'CLEAR' | 'INDIRECT' | 'VAGUE';
+                /**
+                 * Primary language ISO 639-1 code for the persona
+                 */
+                language: 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE';
+                /**
+                 * How reliable the persona's memory is
+                 */
+                memoryReliability: 'HIGH' | 'LOW';
+                /**
+                 * The name the agent will identify as during conversations
+                 */
+                name: string;
+                /**
+                 * Additional custom properties about the persona
+                 */
+                properties: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Controls how quickly the persona responds to pauses in conversation (QUICK,
+                 * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+                 * for several seconds.
+                 */
+                responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
+                /**
+                 * Speech clarity of the persona
+                 */
+                speechClarity: 'CLEAR' | 'VAGUE' | 'RAMBLING';
+                /**
+                 * Speech pace of the persona
+                 */
+                speechPace: 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST';
+                /**
+                 * Languages the persona can understand. Multilingual combinations are limited by
+                 * multilingual speech recognition support.
+                 */
+                understoodLanguages: Array<'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE'>;
+                /**
+                 * Last update timestamp
+                 */
+                updatedAt: string;
+                /**
+                 * Background story and behavioral patterns for the persona
+                 */
+                backstoryPrompt?: string | null;
+                /**
+                 * Human-readable description of the persona
+                 */
+                description?: string | null;
+                /**
+                 * Label shown in place of the name across the dashboard (e.g. a short descriptor
+                 * like "Irate Escalator"). The persona still identifies as `name` on calls. Omit
+                 * or set null to display the name itself.
+                 */
+                displayName?: string | null;
+                /**
+                 * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
+                 */
+                secondaryLanguage?: 'EN' | null;
+            }
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
              */
@@ -3710,6 +4231,11 @@ export declare namespace CustomerFlowListResponse {
              * project.
              */
             environment: EdgeCase.Environment | null;
+            /**
+             * The personas this brief hands the phone to, in order of first mention. Empty
+             * when the brief inherits the happy path's: read the happy path's list.
+             */
+            handoffPersonas: Array<EdgeCase.HandoffPersona>;
             isGenerated: boolean;
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -3724,7 +4250,9 @@ export declare namespace CustomerFlowListResponse {
              */
             updatedAt: string;
             /**
-             * The brief the simulated customer improvises from.
+             * The brief the simulated customer improvises from. A `@{persona:<id>}` mention
+             * hands the phone to that persona mid-call; the sentences around the mention say
+             * when.
              */
             prompt?: string | null;
             systemKey?: string | null;
@@ -3760,10 +4288,7 @@ export declare namespace CustomerFlowListResponse {
                 updatedAt: string;
                 description?: string | null;
             }
-            /**
-             * The persona this runs as instead of the happy path's. Null means it inherits.
-             */
-            interface PersonaOverride {
+            interface HandoffPersona {
                 /**
                  * Unique identifier of the persona
                  */
@@ -3883,10 +4408,133 @@ export declare namespace CustomerFlowListResponse {
                  */
                 secondaryLanguage?: 'EN' | null;
             }
-        }
-        /**
-         * One brief to run an improv flow with.
-         */
+            /**
+             * The persona this runs as instead of the happy path's. Null means it inherits.
+             */
+            interface PersonaOverride {
+                /**
+                 * Unique identifier of the persona
+                 */
+                id: string;
+                /**
+                 * Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with
+                 * optional variants
+                 */
+                accent: 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL';
+                /**
+                 * How old the caller sounds and behaves. Only ages the persona's accent has a
+                 * voice for are accepted; defaults to ADULT, which every accent supports.
+                 */
+                age: 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY';
+                /**
+                 * Background noise setting
+                 */
+                backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
+                /**
+                 * Base emotional state of the persona
+                 */
+                baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED' | 'ANGRY' | 'ANXIOUS' | 'SAD';
+                /**
+                 * How the persona confirms information
+                 */
+                confirmationStyle: 'EXPLICIT' | 'VAGUE';
+                /**
+                 * Creation timestamp
+                 */
+                createdAt: string;
+                /**
+                 * Gender of the persona
+                 */
+                gender: 'MALE' | 'FEMALE';
+                /**
+                 * Whether the persona uses filler words like "um" and "uh"
+                 */
+                hasDisfluencies: boolean;
+                /**
+                 * Maximum number of idle messages the persona will send before giving up
+                 */
+                idleMessageMaxSpokenCount: number;
+                /**
+                 * Whether the idle message counter resets when the agent speaks
+                 */
+                idleMessageResetCountOnUserSpeechEnabled: boolean;
+                /**
+                 * Messages the persona will say when the agent goes silent during a call. null =
+                 * "Automatic": language-appropriate defaults are used at call time.
+                 */
+                idleMessages: Array<string> | null;
+                /**
+                 * Seconds of silence before the persona sends an idle message
+                 */
+                idleTimeoutSeconds: number;
+                /**
+                 * How clearly the persona expresses their intentions
+                 */
+                intentClarity: 'CLEAR' | 'INDIRECT' | 'VAGUE';
+                /**
+                 * Primary language ISO 639-1 code for the persona
+                 */
+                language: 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE';
+                /**
+                 * How reliable the persona's memory is
+                 */
+                memoryReliability: 'HIGH' | 'LOW';
+                /**
+                 * The name the agent will identify as during conversations
+                 */
+                name: string;
+                /**
+                 * Additional custom properties about the persona
+                 */
+                properties: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Controls how quickly the persona responds to pauses in conversation (QUICK,
+                 * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+                 * for several seconds.
+                 */
+                responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
+                /**
+                 * Speech clarity of the persona
+                 */
+                speechClarity: 'CLEAR' | 'VAGUE' | 'RAMBLING';
+                /**
+                 * Speech pace of the persona
+                 */
+                speechPace: 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST';
+                /**
+                 * Languages the persona can understand. Multilingual combinations are limited by
+                 * multilingual speech recognition support.
+                 */
+                understoodLanguages: Array<'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE'>;
+                /**
+                 * Last update timestamp
+                 */
+                updatedAt: string;
+                /**
+                 * Background story and behavioral patterns for the persona
+                 */
+                backstoryPrompt?: string | null;
+                /**
+                 * Human-readable description of the persona
+                 */
+                description?: string | null;
+                /**
+                 * Label shown in place of the name across the dashboard (e.g. a short descriptor
+                 * like "Irate Escalator"). The persona still identifies as `name` on calls. Omit
+                 * or set null to display the name itself.
+                 */
+                displayName?: string | null;
+                /**
+                 * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
+                 */
+                secondaryLanguage?: 'EN' | null;
+            }
+        }
+        /**
+         * One brief to run an improv flow with.
+         */
         interface HappyPath {
             id: string;
             /**
@@ -3903,6 +4551,11 @@ export declare namespace CustomerFlowListResponse {
              * project.
              */
             environment: HappyPath.Environment | null;
+            /**
+             * The personas this brief hands the phone to, in order of first mention. Empty
+             * when the brief inherits the happy path's: read the happy path's list.
+             */
+            handoffPersonas: Array<HappyPath.HandoffPersona>;
             isGenerated: boolean;
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -3917,7 +4570,9 @@ export declare namespace CustomerFlowListResponse {
              */
             updatedAt: string;
             /**
-             * The brief the simulated customer improvises from.
+             * The brief the simulated customer improvises from. A `@{persona:<id>}` mention
+             * hands the phone to that persona mid-call; the sentences around the mention say
+             * when.
              */
             prompt?: string | null;
             systemKey?: string | null;
@@ -3953,6 +4608,126 @@ export declare namespace CustomerFlowListResponse {
                 updatedAt: string;
                 description?: string | null;
             }
+            interface HandoffPersona {
+                /**
+                 * Unique identifier of the persona
+                 */
+                id: string;
+                /**
+                 * Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with
+                 * optional variants
+                 */
+                accent: 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL';
+                /**
+                 * How old the caller sounds and behaves. Only ages the persona's accent has a
+                 * voice for are accepted; defaults to ADULT, which every accent supports.
+                 */
+                age: 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY';
+                /**
+                 * Background noise setting
+                 */
+                backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
+                /**
+                 * Base emotional state of the persona
+                 */
+                baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED' | 'ANGRY' | 'ANXIOUS' | 'SAD';
+                /**
+                 * How the persona confirms information
+                 */
+                confirmationStyle: 'EXPLICIT' | 'VAGUE';
+                /**
+                 * Creation timestamp
+                 */
+                createdAt: string;
+                /**
+                 * Gender of the persona
+                 */
+                gender: 'MALE' | 'FEMALE';
+                /**
+                 * Whether the persona uses filler words like "um" and "uh"
+                 */
+                hasDisfluencies: boolean;
+                /**
+                 * Maximum number of idle messages the persona will send before giving up
+                 */
+                idleMessageMaxSpokenCount: number;
+                /**
+                 * Whether the idle message counter resets when the agent speaks
+                 */
+                idleMessageResetCountOnUserSpeechEnabled: boolean;
+                /**
+                 * Messages the persona will say when the agent goes silent during a call. null =
+                 * "Automatic": language-appropriate defaults are used at call time.
+                 */
+                idleMessages: Array<string> | null;
+                /**
+                 * Seconds of silence before the persona sends an idle message
+                 */
+                idleTimeoutSeconds: number;
+                /**
+                 * How clearly the persona expresses their intentions
+                 */
+                intentClarity: 'CLEAR' | 'INDIRECT' | 'VAGUE';
+                /**
+                 * Primary language ISO 639-1 code for the persona
+                 */
+                language: 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE';
+                /**
+                 * How reliable the persona's memory is
+                 */
+                memoryReliability: 'HIGH' | 'LOW';
+                /**
+                 * The name the agent will identify as during conversations
+                 */
+                name: string;
+                /**
+                 * Additional custom properties about the persona
+                 */
+                properties: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Controls how quickly the persona responds to pauses in conversation (QUICK,
+                 * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+                 * for several seconds.
+                 */
+                responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
+                /**
+                 * Speech clarity of the persona
+                 */
+                speechClarity: 'CLEAR' | 'VAGUE' | 'RAMBLING';
+                /**
+                 * Speech pace of the persona
+                 */
+                speechPace: 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST';
+                /**
+                 * Languages the persona can understand. Multilingual combinations are limited by
+                 * multilingual speech recognition support.
+                 */
+                understoodLanguages: Array<'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE'>;
+                /**
+                 * Last update timestamp
+                 */
+                updatedAt: string;
+                /**
+                 * Background story and behavioral patterns for the persona
+                 */
+                backstoryPrompt?: string | null;
+                /**
+                 * Human-readable description of the persona
+                 */
+                description?: string | null;
+                /**
+                 * Label shown in place of the name across the dashboard (e.g. a short descriptor
+                 * like "Irate Escalator"). The persona still identifies as `name` on calls. Omit
+                 * or set null to display the name itself.
+                 */
+                displayName?: string | null;
+                /**
+                 * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
+                 */
+                secondaryLanguage?: 'EN' | null;
+            }
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
              */
@@ -5162,6 +5937,11 @@ export declare namespace CustomerFlowDuplicateResponse {
              * project.
              */
             environment: EdgeCase.Environment | null;
+            /**
+             * The personas this brief hands the phone to, in order of first mention. Empty
+             * when the brief inherits the happy path's: read the happy path's list.
+             */
+            handoffPersonas: Array<EdgeCase.HandoffPersona>;
             isGenerated: boolean;
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -5176,7 +5956,9 @@ export declare namespace CustomerFlowDuplicateResponse {
              */
             updatedAt: string;
             /**
-             * The brief the simulated customer improvises from.
+             * The brief the simulated customer improvises from. A `@{persona:<id>}` mention
+             * hands the phone to that persona mid-call; the sentences around the mention say
+             * when.
              */
             prompt?: string | null;
             systemKey?: string | null;
@@ -5212,10 +5994,7 @@ export declare namespace CustomerFlowDuplicateResponse {
                 updatedAt: string;
                 description?: string | null;
             }
-            /**
-             * The persona this runs as instead of the happy path's. Null means it inherits.
-             */
-            interface PersonaOverride {
+            interface HandoffPersona {
                 /**
                  * Unique identifier of the persona
                  */
@@ -5335,8 +6114,131 @@ export declare namespace CustomerFlowDuplicateResponse {
                  */
                 secondaryLanguage?: 'EN' | null;
             }
-        }
-        /**
+            /**
+             * The persona this runs as instead of the happy path's. Null means it inherits.
+             */
+            interface PersonaOverride {
+                /**
+                 * Unique identifier of the persona
+                 */
+                id: string;
+                /**
+                 * Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with
+                 * optional variants
+                 */
+                accent: 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL';
+                /**
+                 * How old the caller sounds and behaves. Only ages the persona's accent has a
+                 * voice for are accepted; defaults to ADULT, which every accent supports.
+                 */
+                age: 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY';
+                /**
+                 * Background noise setting
+                 */
+                backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
+                /**
+                 * Base emotional state of the persona
+                 */
+                baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED' | 'ANGRY' | 'ANXIOUS' | 'SAD';
+                /**
+                 * How the persona confirms information
+                 */
+                confirmationStyle: 'EXPLICIT' | 'VAGUE';
+                /**
+                 * Creation timestamp
+                 */
+                createdAt: string;
+                /**
+                 * Gender of the persona
+                 */
+                gender: 'MALE' | 'FEMALE';
+                /**
+                 * Whether the persona uses filler words like "um" and "uh"
+                 */
+                hasDisfluencies: boolean;
+                /**
+                 * Maximum number of idle messages the persona will send before giving up
+                 */
+                idleMessageMaxSpokenCount: number;
+                /**
+                 * Whether the idle message counter resets when the agent speaks
+                 */
+                idleMessageResetCountOnUserSpeechEnabled: boolean;
+                /**
+                 * Messages the persona will say when the agent goes silent during a call. null =
+                 * "Automatic": language-appropriate defaults are used at call time.
+                 */
+                idleMessages: Array<string> | null;
+                /**
+                 * Seconds of silence before the persona sends an idle message
+                 */
+                idleTimeoutSeconds: number;
+                /**
+                 * How clearly the persona expresses their intentions
+                 */
+                intentClarity: 'CLEAR' | 'INDIRECT' | 'VAGUE';
+                /**
+                 * Primary language ISO 639-1 code for the persona
+                 */
+                language: 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE';
+                /**
+                 * How reliable the persona's memory is
+                 */
+                memoryReliability: 'HIGH' | 'LOW';
+                /**
+                 * The name the agent will identify as during conversations
+                 */
+                name: string;
+                /**
+                 * Additional custom properties about the persona
+                 */
+                properties: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Controls how quickly the persona responds to pauses in conversation (QUICK,
+                 * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+                 * for several seconds.
+                 */
+                responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
+                /**
+                 * Speech clarity of the persona
+                 */
+                speechClarity: 'CLEAR' | 'VAGUE' | 'RAMBLING';
+                /**
+                 * Speech pace of the persona
+                 */
+                speechPace: 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST';
+                /**
+                 * Languages the persona can understand. Multilingual combinations are limited by
+                 * multilingual speech recognition support.
+                 */
+                understoodLanguages: Array<'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE'>;
+                /**
+                 * Last update timestamp
+                 */
+                updatedAt: string;
+                /**
+                 * Background story and behavioral patterns for the persona
+                 */
+                backstoryPrompt?: string | null;
+                /**
+                 * Human-readable description of the persona
+                 */
+                description?: string | null;
+                /**
+                 * Label shown in place of the name across the dashboard (e.g. a short descriptor
+                 * like "Irate Escalator"). The persona still identifies as `name` on calls. Omit
+                 * or set null to display the name itself.
+                 */
+                displayName?: string | null;
+                /**
+                 * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
+                 */
+                secondaryLanguage?: 'EN' | null;
+            }
+        }
+        /**
          * One brief to run an improv flow with.
          */
         interface HappyPath {
@@ -5355,6 +6257,11 @@ export declare namespace CustomerFlowDuplicateResponse {
              * project.
              */
             environment: HappyPath.Environment | null;
+            /**
+             * The personas this brief hands the phone to, in order of first mention. Empty
+             * when the brief inherits the happy path's: read the happy path's list.
+             */
+            handoffPersonas: Array<HappyPath.HandoffPersona>;
             isGenerated: boolean;
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -5369,7 +6276,9 @@ export declare namespace CustomerFlowDuplicateResponse {
              */
             updatedAt: string;
             /**
-             * The brief the simulated customer improvises from.
+             * The brief the simulated customer improvises from. A `@{persona:<id>}` mention
+             * hands the phone to that persona mid-call; the sentences around the mention say
+             * when.
              */
             prompt?: string | null;
             systemKey?: string | null;
@@ -5405,6 +6314,126 @@ export declare namespace CustomerFlowDuplicateResponse {
                 updatedAt: string;
                 description?: string | null;
             }
+            interface HandoffPersona {
+                /**
+                 * Unique identifier of the persona
+                 */
+                id: string;
+                /**
+                 * Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with
+                 * optional variants
+                 */
+                accent: 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL';
+                /**
+                 * How old the caller sounds and behaves. Only ages the persona's accent has a
+                 * voice for are accepted; defaults to ADULT, which every accent supports.
+                 */
+                age: 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY';
+                /**
+                 * Background noise setting
+                 */
+                backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
+                /**
+                 * Base emotional state of the persona
+                 */
+                baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED' | 'ANGRY' | 'ANXIOUS' | 'SAD';
+                /**
+                 * How the persona confirms information
+                 */
+                confirmationStyle: 'EXPLICIT' | 'VAGUE';
+                /**
+                 * Creation timestamp
+                 */
+                createdAt: string;
+                /**
+                 * Gender of the persona
+                 */
+                gender: 'MALE' | 'FEMALE';
+                /**
+                 * Whether the persona uses filler words like "um" and "uh"
+                 */
+                hasDisfluencies: boolean;
+                /**
+                 * Maximum number of idle messages the persona will send before giving up
+                 */
+                idleMessageMaxSpokenCount: number;
+                /**
+                 * Whether the idle message counter resets when the agent speaks
+                 */
+                idleMessageResetCountOnUserSpeechEnabled: boolean;
+                /**
+                 * Messages the persona will say when the agent goes silent during a call. null =
+                 * "Automatic": language-appropriate defaults are used at call time.
+                 */
+                idleMessages: Array<string> | null;
+                /**
+                 * Seconds of silence before the persona sends an idle message
+                 */
+                idleTimeoutSeconds: number;
+                /**
+                 * How clearly the persona expresses their intentions
+                 */
+                intentClarity: 'CLEAR' | 'INDIRECT' | 'VAGUE';
+                /**
+                 * Primary language ISO 639-1 code for the persona
+                 */
+                language: 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE';
+                /**
+                 * How reliable the persona's memory is
+                 */
+                memoryReliability: 'HIGH' | 'LOW';
+                /**
+                 * The name the agent will identify as during conversations
+                 */
+                name: string;
+                /**
+                 * Additional custom properties about the persona
+                 */
+                properties: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Controls how quickly the persona responds to pauses in conversation (QUICK,
+                 * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+                 * for several seconds.
+                 */
+                responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
+                /**
+                 * Speech clarity of the persona
+                 */
+                speechClarity: 'CLEAR' | 'VAGUE' | 'RAMBLING';
+                /**
+                 * Speech pace of the persona
+                 */
+                speechPace: 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST';
+                /**
+                 * Languages the persona can understand. Multilingual combinations are limited by
+                 * multilingual speech recognition support.
+                 */
+                understoodLanguages: Array<'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE'>;
+                /**
+                 * Last update timestamp
+                 */
+                updatedAt: string;
+                /**
+                 * Background story and behavioral patterns for the persona
+                 */
+                backstoryPrompt?: string | null;
+                /**
+                 * Human-readable description of the persona
+                 */
+                description?: string | null;
+                /**
+                 * Label shown in place of the name across the dashboard (e.g. a short descriptor
+                 * like "Irate Escalator"). The persona still identifies as `name` on calls. Omit
+                 * or set null to display the name itself.
+                 */
+                displayName?: string | null;
+                /**
+                 * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
+                 */
+                secondaryLanguage?: 'EN' | null;
+            }
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
              */
@@ -6589,6 +7618,11 @@ export declare namespace CustomerFlowGetByIDResponse {
              * project.
              */
             environment: EdgeCase.Environment | null;
+            /**
+             * The personas this brief hands the phone to, in order of first mention. Empty
+             * when the brief inherits the happy path's: read the happy path's list.
+             */
+            handoffPersonas: Array<EdgeCase.HandoffPersona>;
             isGenerated: boolean;
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -6603,7 +7637,9 @@ export declare namespace CustomerFlowGetByIDResponse {
              */
             updatedAt: string;
             /**
-             * The brief the simulated customer improvises from.
+             * The brief the simulated customer improvises from. A `@{persona:<id>}` mention
+             * hands the phone to that persona mid-call; the sentences around the mention say
+             * when.
              */
             prompt?: string | null;
             systemKey?: string | null;
@@ -6639,6 +7675,126 @@ export declare namespace CustomerFlowGetByIDResponse {
                 updatedAt: string;
                 description?: string | null;
             }
+            interface HandoffPersona {
+                /**
+                 * Unique identifier of the persona
+                 */
+                id: string;
+                /**
+                 * Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with
+                 * optional variants
+                 */
+                accent: 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL';
+                /**
+                 * How old the caller sounds and behaves. Only ages the persona's accent has a
+                 * voice for are accepted; defaults to ADULT, which every accent supports.
+                 */
+                age: 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY';
+                /**
+                 * Background noise setting
+                 */
+                backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
+                /**
+                 * Base emotional state of the persona
+                 */
+                baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED' | 'ANGRY' | 'ANXIOUS' | 'SAD';
+                /**
+                 * How the persona confirms information
+                 */
+                confirmationStyle: 'EXPLICIT' | 'VAGUE';
+                /**
+                 * Creation timestamp
+                 */
+                createdAt: string;
+                /**
+                 * Gender of the persona
+                 */
+                gender: 'MALE' | 'FEMALE';
+                /**
+                 * Whether the persona uses filler words like "um" and "uh"
+                 */
+                hasDisfluencies: boolean;
+                /**
+                 * Maximum number of idle messages the persona will send before giving up
+                 */
+                idleMessageMaxSpokenCount: number;
+                /**
+                 * Whether the idle message counter resets when the agent speaks
+                 */
+                idleMessageResetCountOnUserSpeechEnabled: boolean;
+                /**
+                 * Messages the persona will say when the agent goes silent during a call. null =
+                 * "Automatic": language-appropriate defaults are used at call time.
+                 */
+                idleMessages: Array<string> | null;
+                /**
+                 * Seconds of silence before the persona sends an idle message
+                 */
+                idleTimeoutSeconds: number;
+                /**
+                 * How clearly the persona expresses their intentions
+                 */
+                intentClarity: 'CLEAR' | 'INDIRECT' | 'VAGUE';
+                /**
+                 * Primary language ISO 639-1 code for the persona
+                 */
+                language: 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE';
+                /**
+                 * How reliable the persona's memory is
+                 */
+                memoryReliability: 'HIGH' | 'LOW';
+                /**
+                 * The name the agent will identify as during conversations
+                 */
+                name: string;
+                /**
+                 * Additional custom properties about the persona
+                 */
+                properties: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Controls how quickly the persona responds to pauses in conversation (QUICK,
+                 * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+                 * for several seconds.
+                 */
+                responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
+                /**
+                 * Speech clarity of the persona
+                 */
+                speechClarity: 'CLEAR' | 'VAGUE' | 'RAMBLING';
+                /**
+                 * Speech pace of the persona
+                 */
+                speechPace: 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST';
+                /**
+                 * Languages the persona can understand. Multilingual combinations are limited by
+                 * multilingual speech recognition support.
+                 */
+                understoodLanguages: Array<'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE'>;
+                /**
+                 * Last update timestamp
+                 */
+                updatedAt: string;
+                /**
+                 * Background story and behavioral patterns for the persona
+                 */
+                backstoryPrompt?: string | null;
+                /**
+                 * Human-readable description of the persona
+                 */
+                description?: string | null;
+                /**
+                 * Label shown in place of the name across the dashboard (e.g. a short descriptor
+                 * like "Irate Escalator"). The persona still identifies as `name` on calls. Omit
+                 * or set null to display the name itself.
+                 */
+                displayName?: string | null;
+                /**
+                 * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
+                 */
+                secondaryLanguage?: 'EN' | null;
+            }
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
              */
@@ -6782,6 +7938,11 @@ export declare namespace CustomerFlowGetByIDResponse {
              * project.
              */
             environment: HappyPath.Environment | null;
+            /**
+             * The personas this brief hands the phone to, in order of first mention. Empty
+             * when the brief inherits the happy path's: read the happy path's list.
+             */
+            handoffPersonas: Array<HappyPath.HandoffPersona>;
             isGenerated: boolean;
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -6796,7 +7957,9 @@ export declare namespace CustomerFlowGetByIDResponse {
              */
             updatedAt: string;
             /**
-             * The brief the simulated customer improvises from.
+             * The brief the simulated customer improvises from. A `@{persona:<id>}` mention
+             * hands the phone to that persona mid-call; the sentences around the mention say
+             * when.
              */
             prompt?: string | null;
             systemKey?: string | null;
@@ -6822,15 +7985,135 @@ export declare namespace CustomerFlowGetByIDResponse {
                 backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
                 backgroundNoiseVolume: number;
                 /**
-                 * Creation timestamp in ISO 8601 format
+                 * Creation timestamp in ISO 8601 format
+                 */
+                createdAt: string;
+                name: string;
+                /**
+                 * Last update timestamp in ISO 8601 format
+                 */
+                updatedAt: string;
+                description?: string | null;
+            }
+            interface HandoffPersona {
+                /**
+                 * Unique identifier of the persona
+                 */
+                id: string;
+                /**
+                 * Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with
+                 * optional variants
+                 */
+                accent: 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL';
+                /**
+                 * How old the caller sounds and behaves. Only ages the persona's accent has a
+                 * voice for are accepted; defaults to ADULT, which every accent supports.
+                 */
+                age: 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY';
+                /**
+                 * Background noise setting
+                 */
+                backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
+                /**
+                 * Base emotional state of the persona
+                 */
+                baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED' | 'ANGRY' | 'ANXIOUS' | 'SAD';
+                /**
+                 * How the persona confirms information
+                 */
+                confirmationStyle: 'EXPLICIT' | 'VAGUE';
+                /**
+                 * Creation timestamp
+                 */
+                createdAt: string;
+                /**
+                 * Gender of the persona
+                 */
+                gender: 'MALE' | 'FEMALE';
+                /**
+                 * Whether the persona uses filler words like "um" and "uh"
+                 */
+                hasDisfluencies: boolean;
+                /**
+                 * Maximum number of idle messages the persona will send before giving up
+                 */
+                idleMessageMaxSpokenCount: number;
+                /**
+                 * Whether the idle message counter resets when the agent speaks
+                 */
+                idleMessageResetCountOnUserSpeechEnabled: boolean;
+                /**
+                 * Messages the persona will say when the agent goes silent during a call. null =
+                 * "Automatic": language-appropriate defaults are used at call time.
+                 */
+                idleMessages: Array<string> | null;
+                /**
+                 * Seconds of silence before the persona sends an idle message
+                 */
+                idleTimeoutSeconds: number;
+                /**
+                 * How clearly the persona expresses their intentions
+                 */
+                intentClarity: 'CLEAR' | 'INDIRECT' | 'VAGUE';
+                /**
+                 * Primary language ISO 639-1 code for the persona
+                 */
+                language: 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE';
+                /**
+                 * How reliable the persona's memory is
+                 */
+                memoryReliability: 'HIGH' | 'LOW';
+                /**
+                 * The name the agent will identify as during conversations
+                 */
+                name: string;
+                /**
+                 * Additional custom properties about the persona
+                 */
+                properties: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Controls how quickly the persona responds to pauses in conversation (QUICK,
+                 * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+                 * for several seconds.
+                 */
+                responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
+                /**
+                 * Speech clarity of the persona
+                 */
+                speechClarity: 'CLEAR' | 'VAGUE' | 'RAMBLING';
+                /**
+                 * Speech pace of the persona
+                 */
+                speechPace: 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST';
+                /**
+                 * Languages the persona can understand. Multilingual combinations are limited by
+                 * multilingual speech recognition support.
+                 */
+                understoodLanguages: Array<'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE'>;
+                /**
+                 * Last update timestamp
+                 */
+                updatedAt: string;
+                /**
+                 * Background story and behavioral patterns for the persona
+                 */
+                backstoryPrompt?: string | null;
+                /**
+                 * Human-readable description of the persona
+                 */
+                description?: string | null;
+                /**
+                 * Label shown in place of the name across the dashboard (e.g. a short descriptor
+                 * like "Irate Escalator"). The persona still identifies as `name` on calls. Omit
+                 * or set null to display the name itself.
                  */
-                createdAt: string;
-                name: string;
+                displayName?: string | null;
                 /**
-                 * Last update timestamp in ISO 8601 format
+                 * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
                  */
-                updatedAt: string;
-                description?: string | null;
+                secondaryLanguage?: 'EN' | null;
             }
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -7641,6 +8924,11 @@ export declare namespace CustomerFlowReplaceGraphResponse {
              * project.
              */
             environment: ImprovFlowVariant.Environment | null;
+            /**
+             * The personas this brief hands the phone to, in order of first mention. Empty
+             * when the brief inherits the happy path's: read the happy path's list.
+             */
+            handoffPersonas: Array<ImprovFlowVariant.HandoffPersona>;
             isGenerated: boolean;
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -7655,7 +8943,9 @@ export declare namespace CustomerFlowReplaceGraphResponse {
              */
             updatedAt: string;
             /**
-             * The brief the simulated customer improvises from.
+             * The brief the simulated customer improvises from. A `@{persona:<id>}` mention
+             * hands the phone to that persona mid-call; the sentences around the mention say
+             * when.
              */
             prompt?: string | null;
             systemKey?: string | null;
@@ -7691,6 +8981,126 @@ export declare namespace CustomerFlowReplaceGraphResponse {
                 updatedAt: string;
                 description?: string | null;
             }
+            interface HandoffPersona {
+                /**
+                 * Unique identifier of the persona
+                 */
+                id: string;
+                /**
+                 * Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with
+                 * optional variants
+                 */
+                accent: 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL';
+                /**
+                 * How old the caller sounds and behaves. Only ages the persona's accent has a
+                 * voice for are accepted; defaults to ADULT, which every accent supports.
+                 */
+                age: 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY';
+                /**
+                 * Background noise setting
+                 */
+                backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
+                /**
+                 * Base emotional state of the persona
+                 */
+                baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED' | 'ANGRY' | 'ANXIOUS' | 'SAD';
+                /**
+                 * How the persona confirms information
+                 */
+                confirmationStyle: 'EXPLICIT' | 'VAGUE';
+                /**
+                 * Creation timestamp
+                 */
+                createdAt: string;
+                /**
+                 * Gender of the persona
+                 */
+                gender: 'MALE' | 'FEMALE';
+                /**
+                 * Whether the persona uses filler words like "um" and "uh"
+                 */
+                hasDisfluencies: boolean;
+                /**
+                 * Maximum number of idle messages the persona will send before giving up
+                 */
+                idleMessageMaxSpokenCount: number;
+                /**
+                 * Whether the idle message counter resets when the agent speaks
+                 */
+                idleMessageResetCountOnUserSpeechEnabled: boolean;
+                /**
+                 * Messages the persona will say when the agent goes silent during a call. null =
+                 * "Automatic": language-appropriate defaults are used at call time.
+                 */
+                idleMessages: Array<string> | null;
+                /**
+                 * Seconds of silence before the persona sends an idle message
+                 */
+                idleTimeoutSeconds: number;
+                /**
+                 * How clearly the persona expresses their intentions
+                 */
+                intentClarity: 'CLEAR' | 'INDIRECT' | 'VAGUE';
+                /**
+                 * Primary language ISO 639-1 code for the persona
+                 */
+                language: 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE';
+                /**
+                 * How reliable the persona's memory is
+                 */
+                memoryReliability: 'HIGH' | 'LOW';
+                /**
+                 * The name the agent will identify as during conversations
+                 */
+                name: string;
+                /**
+                 * Additional custom properties about the persona
+                 */
+                properties: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Controls how quickly the persona responds to pauses in conversation (QUICK,
+                 * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+                 * for several seconds.
+                 */
+                responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
+                /**
+                 * Speech clarity of the persona
+                 */
+                speechClarity: 'CLEAR' | 'VAGUE' | 'RAMBLING';
+                /**
+                 * Speech pace of the persona
+                 */
+                speechPace: 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST';
+                /**
+                 * Languages the persona can understand. Multilingual combinations are limited by
+                 * multilingual speech recognition support.
+                 */
+                understoodLanguages: Array<'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE'>;
+                /**
+                 * Last update timestamp
+                 */
+                updatedAt: string;
+                /**
+                 * Background story and behavioral patterns for the persona
+                 */
+                backstoryPrompt?: string | null;
+                /**
+                 * Human-readable description of the persona
+                 */
+                description?: string | null;
+                /**
+                 * Label shown in place of the name across the dashboard (e.g. a short descriptor
+                 * like "Irate Escalator"). The persona still identifies as `name` on calls. Omit
+                 * or set null to display the name itself.
+                 */
+                displayName?: string | null;
+                /**
+                 * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
+                 */
+                secondaryLanguage?: 'EN' | null;
+            }
             /**
              * The persona this runs as instead of the happy path's. Null means it inherits.
              */
@@ -8227,6 +9637,11 @@ export declare namespace CustomerFlowUpdateHappyPathResponse {
          * project.
          */
         environment: ImprovFlowVariant.Environment | null;
+        /**
+         * The personas this brief hands the phone to, in order of first mention. Empty
+         * when the brief inherits the happy path's: read the happy path's list.
+         */
+        handoffPersonas: Array<ImprovFlowVariant.HandoffPersona>;
         isGenerated: boolean;
         /**
          * The persona this runs as instead of the happy path's. Null means it inherits.
@@ -8241,7 +9656,9 @@ export declare namespace CustomerFlowUpdateHappyPathResponse {
          */
         updatedAt: string;
         /**
-         * The brief the simulated customer improvises from.
+         * The brief the simulated customer improvises from. A `@{persona:<id>}` mention
+         * hands the phone to that persona mid-call; the sentences around the mention say
+         * when.
          */
         prompt?: string | null;
         systemKey?: string | null;
@@ -8277,6 +9694,126 @@ export declare namespace CustomerFlowUpdateHappyPathResponse {
             updatedAt: string;
             description?: string | null;
         }
+        interface HandoffPersona {
+            /**
+             * Unique identifier of the persona
+             */
+            id: string;
+            /**
+             * Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with
+             * optional variants
+             */
+            accent: 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL';
+            /**
+             * How old the caller sounds and behaves. Only ages the persona's accent has a
+             * voice for are accepted; defaults to ADULT, which every accent supports.
+             */
+            age: 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY';
+            /**
+             * Background noise setting
+             */
+            backgroundNoise: 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'CONSTRUCTION' | 'CRYING_BABY' | 'DRIVING' | 'LIBRARY' | 'OFFICE' | 'THUNDERSTORM' | 'TRAIN';
+            /**
+             * Base emotional state of the persona
+             */
+            baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED' | 'ANGRY' | 'ANXIOUS' | 'SAD';
+            /**
+             * How the persona confirms information
+             */
+            confirmationStyle: 'EXPLICIT' | 'VAGUE';
+            /**
+             * Creation timestamp
+             */
+            createdAt: string;
+            /**
+             * Gender of the persona
+             */
+            gender: 'MALE' | 'FEMALE';
+            /**
+             * Whether the persona uses filler words like "um" and "uh"
+             */
+            hasDisfluencies: boolean;
+            /**
+             * Maximum number of idle messages the persona will send before giving up
+             */
+            idleMessageMaxSpokenCount: number;
+            /**
+             * Whether the idle message counter resets when the agent speaks
+             */
+            idleMessageResetCountOnUserSpeechEnabled: boolean;
+            /**
+             * Messages the persona will say when the agent goes silent during a call. null =
+             * "Automatic": language-appropriate defaults are used at call time.
+             */
+            idleMessages: Array<string> | null;
+            /**
+             * Seconds of silence before the persona sends an idle message
+             */
+            idleTimeoutSeconds: number;
+            /**
+             * How clearly the persona expresses their intentions
+             */
+            intentClarity: 'CLEAR' | 'INDIRECT' | 'VAGUE';
+            /**
+             * Primary language ISO 639-1 code for the persona
+             */
+            language: 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE';
+            /**
+             * How reliable the persona's memory is
+             */
+            memoryReliability: 'HIGH' | 'LOW';
+            /**
+             * The name the agent will identify as during conversations
+             */
+            name: string;
+            /**
+             * Additional custom properties about the persona
+             */
+            properties: {
+                [key: string]: unknown;
+            };
+            /**
+             * Controls how quickly the persona responds to pauses in conversation (QUICK,
+             * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+             * for several seconds.
+             */
+            responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
+            /**
+             * Speech clarity of the persona
+             */
+            speechClarity: 'CLEAR' | 'VAGUE' | 'RAMBLING';
+            /**
+             * Speech pace of the persona
+             */
+            speechPace: 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST';
+            /**
+             * Languages the persona can understand. Multilingual combinations are limited by
+             * multilingual speech recognition support.
+             */
+            understoodLanguages: Array<'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE'>;
+            /**
+             * Last update timestamp
+             */
+            updatedAt: string;
+            /**
+             * Background story and behavioral patterns for the persona
+             */
+            backstoryPrompt?: string | null;
+            /**
+             * Human-readable description of the persona
+             */
+            description?: string | null;
+            /**
+             * Label shown in place of the name across the dashboard (e.g. a short descriptor
+             * like "Irate Escalator"). The persona still identifies as `name` on calls. Omit
+             * or set null to display the name itself.
+             */
+            displayName?: string | null;
+            /**
+             * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
+             */
+            secondaryLanguage?: 'EN' | null;
+        }
         /**
          * The persona this runs as instead of the happy path's. Null means it inherits.
          */