@roarkanalytics/sdk 3.10.0 → 3.12.0

package/src/resources/customer-flow.ts

@@ -80,6 +80,29 @@ export class CustomerFlow extends APIResource {
     return this._client.delete(path`/v1/customer-flow/${flowID}`, options);
   }
 
+  /**
+   * Deep-copies a flow into a new project-owned flow. The copy carries the source's
+   * description, branching mode, linked agents, flow-level expectations and
+   * flow-owned metrics. A scripted flow copies its whole step graph; an improv flow
+   * copies its variants (personas, briefs, expectations). Duplicating a
+   * Roark-managed flow is how you customise it. Voicemail flows are Roark-managed
+   * and cannot be duplicated.
+   *
+   * @example
+   * ```ts
+   * const response = await client.customerFlow.duplicate(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
+   */
+  duplicate(
+    flowID: string,
+    body: CustomerFlowDuplicateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CustomerFlowDuplicateResponse> {
+    return this._client.post(path`/v1/customer-flow/${flowID}/duplicate`, { body, ...options });
+  }
+
   /**
    * Returns a customer flow with its happy path, edge cases, expectations and linked
    * agents. Scripted flows also carry their step graph.
@@ -165,12 +188,23 @@ export class CustomerFlow extends APIResource {
  * step is a root wired straight from the start of the flow, so a merge target
  * parked there would also be reachable directly.
  *
+ * A `CUSTOMER_TURN` describes what the simulated customer says and the persona
+ * phrases it; a `CUSTOMER_VERBATIM_TURN` is said word for word, and one placed as
+ * a top-level step opens the call the moment it connects, before the agent speaks.
+ * `CUSTOMER_FIRST_MESSAGE` is the retired name for that opening case: still
+ * accepted, stored and returned as `CUSTOMER_VERBATIM_TURN`.
+ *
  * The two DTMF types are mirror images and both require `dtmfDigits`.
  * `CUSTOMER_DTMF` is keys the simulated caller presses while navigating your
  * agent. `AGENT_DTMF` is keys your agent under test is expected to press while
  * navigating a menu the simulation is playing, so its digits are an assertion the
  * run is graded against rather than an instruction, and it counts as an agent turn
  * for role alternation.
+ *
+ * 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
@@ -180,7 +214,8 @@ export type FlowStep =
   | FlowStep.UnionMember4
   | FlowStep.UnionMember5
   | FlowStep.UnionMember6
-  | FlowStep.UnionMember7;
+  | FlowStep.UnionMember7
+  | FlowStep.UnionMember8;
 
 export namespace FlowStep {
   export interface UnionMember0 {
@@ -192,11 +227,27 @@ export namespace FlowStep {
 
     nodeId?: string;
 
+    offScriptPolicy?: UnionMember0.OffScriptPolicy | null;
+
     ref?: string;
 
     steps?: Array<CustomerFlowAPI.FlowStep>;
   }
 
+  export namespace UnionMember0 {
+    export interface OffScriptPolicy {
+      maxAttempts: number;
+
+      reaction: 'STAY_SILENT' | 'REPEAT' | 'RESPOND' | 'SAY';
+
+      then: 'HANG_UP' | 'MOVE_ON' | 'ADAPT' | 'HANG_UP_INVALIDATE';
+
+      sayLine?: string | null;
+
+      waitSeconds?: number | null;
+    }
+  }
+
   export interface UnionMember1 {
     type: 'CUSTOMER_TURN';
 
@@ -226,6 +277,20 @@ export namespace FlowStep {
   }
 
   export interface UnionMember3 {
+    type: 'CUSTOMER_VERBATIM_TURN';
+
+    content?: string | null;
+
+    mergeIntoNodeIds?: Array<string>;
+
+    nodeId?: string;
+
+    ref?: string;
+
+    steps?: Array<CustomerFlowAPI.FlowStep>;
+  }
+
+  export interface UnionMember4 {
     type: 'CUSTOMER_SILENCE';
 
     mergeIntoNodeIds?: Array<string>;
@@ -239,7 +304,7 @@ export namespace FlowStep {
     steps?: Array<CustomerFlowAPI.FlowStep>;
   }
 
-  export interface UnionMember4 {
+  export interface UnionMember5 {
     type: 'CUSTOMER_DTMF';
 
     dtmfDigits?: string | null;
@@ -253,7 +318,7 @@ export namespace FlowStep {
     steps?: Array<CustomerFlowAPI.FlowStep>;
   }
 
-  export interface UnionMember5 {
+  export interface UnionMember6 {
     type: 'AGENT_DTMF';
 
     dtmfDigits?: string | null;
@@ -267,7 +332,7 @@ export namespace FlowStep {
     steps?: Array<CustomerFlowAPI.FlowStep>;
   }
 
-  export interface UnionMember6 {
+  export interface UnionMember7 {
     type: 'VOICEMAIL';
 
     mergeIntoNodeIds?: Array<string>;
@@ -279,7 +344,7 @@ export namespace FlowStep {
     steps?: Array<CustomerFlowAPI.FlowStep>;
   }
 
-  export interface UnionMember7 {
+  export interface UnionMember8 {
     type: 'SCENARIO_LINK';
 
     linkedCustomerFlowId?: string | null;
@@ -346,6 +411,30 @@ export namespace CustomerFlowCreateResponse {
      */
     happyPath: ScriptedCustomerFlow.HappyPath | null;
 
+    /**
+     * STRICT only. What the simulated customer does when your agent does not say the
+     * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+     * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+     * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+     * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+     * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+     * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+     * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+     * stay silent, 3 attempts, hang up. The default for every agent step; an
+     * AGENT_TURN step can carry its own.
+     */
+    offScriptPolicy: ScriptedCustomerFlow.OffScriptPolicy | null;
+
+    /**
+     * How closely a run follows the script. LOOSE (default) hands the whole script to
+     * the simulated customer as one prompt; it keeps the call moving whatever your
+     * agent says. STRICT runs the script as a state machine on the agent service: at
+     * every agent step the simulated customer waits, silent, until your agent has said
+     * the expected line, and only then moves on. Scripted flows only; STRICT needs the
+     * agent-service transport and is not available on realtime models.
+     */
+    scriptAdherence: 'LOOSE' | 'STRICT';
+
     source: 'SYSTEM' | 'CUSTOM';
 
     title: string;
@@ -496,6 +585,8 @@ export namespace CustomerFlowCreateResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -578,7 +669,10 @@ export namespace CustomerFlowCreateResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -720,6 +814,13 @@ export namespace CustomerFlowCreateResponse {
          */
         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)
          */
@@ -811,6 +912,8 @@ export namespace CustomerFlowCreateResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -893,7 +996,10 @@ export namespace CustomerFlowCreateResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -1035,12 +1141,43 @@ export namespace CustomerFlowCreateResponse {
          */
         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;
       }
     }
+
+    /**
+     * STRICT only. What the simulated customer does when your agent does not say the
+     * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+     * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+     * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+     * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+     * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+     * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+     * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+     * stay silent, 3 attempts, hang up. The default for every agent step; an
+     * AGENT_TURN step can carry its own.
+     */
+    export interface OffScriptPolicy {
+      maxAttempts: number;
+
+      reaction: 'STAY_SILENT' | 'REPEAT' | 'RESPOND' | 'SAY';
+
+      then: 'HANG_UP' | 'MOVE_ON' | 'ADAPT' | 'HANG_UP_INVALIDATE';
+
+      sayLine?: string | null;
+
+      waitSeconds?: number | null;
+    }
   }
 
   /**
@@ -1213,6 +1350,8 @@ export namespace CustomerFlowCreateResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -1295,7 +1434,10 @@ export namespace CustomerFlowCreateResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -1437,6 +1579,13 @@ export namespace CustomerFlowCreateResponse {
          */
         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)
          */
@@ -1526,6 +1675,8 @@ export namespace CustomerFlowCreateResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -1608,7 +1759,10 @@ export namespace CustomerFlowCreateResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -1750,6 +1904,13 @@ export namespace CustomerFlowCreateResponse {
          */
         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)
          */
@@ -1922,6 +2083,8 @@ export namespace CustomerFlowCreateResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -2004,7 +2167,10 @@ export namespace CustomerFlowCreateResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -2146,6 +2312,13 @@ export namespace CustomerFlowCreateResponse {
          */
         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)
          */
@@ -2230,6 +2403,8 @@ export namespace CustomerFlowCreateResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -2312,7 +2487,10 @@ export namespace CustomerFlowCreateResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -2454,6 +2632,13 @@ export namespace CustomerFlowCreateResponse {
          */
         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)
          */
@@ -2513,6 +2698,30 @@ export namespace CustomerFlowUpdateResponse {
      */
     happyPath: ScriptedCustomerFlow.HappyPath | null;
 
+    /**
+     * STRICT only. What the simulated customer does when your agent does not say the
+     * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+     * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+     * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+     * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+     * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+     * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+     * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+     * stay silent, 3 attempts, hang up. The default for every agent step; an
+     * AGENT_TURN step can carry its own.
+     */
+    offScriptPolicy: ScriptedCustomerFlow.OffScriptPolicy | null;
+
+    /**
+     * How closely a run follows the script. LOOSE (default) hands the whole script to
+     * the simulated customer as one prompt; it keeps the call moving whatever your
+     * agent says. STRICT runs the script as a state machine on the agent service: at
+     * every agent step the simulated customer waits, silent, until your agent has said
+     * the expected line, and only then moves on. Scripted flows only; STRICT needs the
+     * agent-service transport and is not available on realtime models.
+     */
+    scriptAdherence: 'LOOSE' | 'STRICT';
+
     source: 'SYSTEM' | 'CUSTOM';
 
     title: string;
@@ -2663,6 +2872,8 @@ export namespace CustomerFlowUpdateResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -2745,7 +2956,10 @@ export namespace CustomerFlowUpdateResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -2887,6 +3101,13 @@ export namespace CustomerFlowUpdateResponse {
          */
         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)
          */
@@ -2978,6 +3199,8 @@ export namespace CustomerFlowUpdateResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -3060,7 +3283,10 @@ export namespace CustomerFlowUpdateResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -3202,12 +3428,43 @@ export namespace CustomerFlowUpdateResponse {
          */
         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;
       }
     }
+
+    /**
+     * STRICT only. What the simulated customer does when your agent does not say the
+     * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+     * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+     * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+     * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+     * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+     * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+     * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+     * stay silent, 3 attempts, hang up. The default for every agent step; an
+     * AGENT_TURN step can carry its own.
+     */
+    export interface OffScriptPolicy {
+      maxAttempts: number;
+
+      reaction: 'STAY_SILENT' | 'REPEAT' | 'RESPOND' | 'SAY';
+
+      then: 'HANG_UP' | 'MOVE_ON' | 'ADAPT' | 'HANG_UP_INVALIDATE';
+
+      sayLine?: string | null;
+
+      waitSeconds?: number | null;
+    }
   }
 
   /**
@@ -3380,6 +3637,8 @@ export namespace CustomerFlowUpdateResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -3462,7 +3721,10 @@ export namespace CustomerFlowUpdateResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -3604,6 +3866,13 @@ export namespace CustomerFlowUpdateResponse {
          */
         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)
          */
@@ -3693,6 +3962,8 @@ export namespace CustomerFlowUpdateResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -3775,7 +4046,10 @@ export namespace CustomerFlowUpdateResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -3917,6 +4191,13 @@ export namespace CustomerFlowUpdateResponse {
          */
         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)
          */
@@ -4089,6 +4370,8 @@ export namespace CustomerFlowUpdateResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -4171,7 +4454,10 @@ export namespace CustomerFlowUpdateResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -4313,6 +4599,13 @@ export namespace CustomerFlowUpdateResponse {
          */
         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)
          */
@@ -4397,6 +4690,8 @@ export namespace CustomerFlowUpdateResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -4479,7 +4774,10 @@ export namespace CustomerFlowUpdateResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -4621,6 +4919,13 @@ export namespace CustomerFlowUpdateResponse {
          */
         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)
          */
@@ -4683,6 +4988,30 @@ export namespace CustomerFlowListResponse {
      */
     happyPath: ScriptedCustomerFlow.HappyPath | null;
 
+    /**
+     * STRICT only. What the simulated customer does when your agent does not say the
+     * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+     * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+     * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+     * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+     * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+     * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+     * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+     * stay silent, 3 attempts, hang up. The default for every agent step; an
+     * AGENT_TURN step can carry its own.
+     */
+    offScriptPolicy: ScriptedCustomerFlow.OffScriptPolicy | null;
+
+    /**
+     * How closely a run follows the script. LOOSE (default) hands the whole script to
+     * the simulated customer as one prompt; it keeps the call moving whatever your
+     * agent says. STRICT runs the script as a state machine on the agent service: at
+     * every agent step the simulated customer waits, silent, until your agent has said
+     * the expected line, and only then moves on. Scripted flows only; STRICT needs the
+     * agent-service transport and is not available on realtime models.
+     */
+    scriptAdherence: 'LOOSE' | 'STRICT';
+
     source: 'SYSTEM' | 'CUSTOM';
 
     title: string;
@@ -4833,6 +5162,8 @@ export namespace CustomerFlowListResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -4915,7 +5246,10 @@ export namespace CustomerFlowListResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -5057,6 +5391,13 @@ export namespace CustomerFlowListResponse {
          */
         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)
          */
@@ -5148,6 +5489,8 @@ export namespace CustomerFlowListResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -5230,7 +5573,10 @@ export namespace CustomerFlowListResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -5372,12 +5718,43 @@ export namespace CustomerFlowListResponse {
          */
         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;
       }
     }
+
+    /**
+     * STRICT only. What the simulated customer does when your agent does not say the
+     * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+     * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+     * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+     * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+     * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+     * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+     * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+     * stay silent, 3 attempts, hang up. The default for every agent step; an
+     * AGENT_TURN step can carry its own.
+     */
+    export interface OffScriptPolicy {
+      maxAttempts: number;
+
+      reaction: 'STAY_SILENT' | 'REPEAT' | 'RESPOND' | 'SAY';
+
+      then: 'HANG_UP' | 'MOVE_ON' | 'ADAPT' | 'HANG_UP_INVALIDATE';
+
+      sayLine?: string | null;
+
+      waitSeconds?: number | null;
+    }
   }
 
   /**
@@ -5550,6 +5927,8 @@ export namespace CustomerFlowListResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -5632,7 +6011,10 @@ export namespace CustomerFlowListResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -5774,6 +6156,13 @@ export namespace CustomerFlowListResponse {
          */
         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)
          */
@@ -5863,6 +6252,8 @@ export namespace CustomerFlowListResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -5945,7 +6336,10 @@ export namespace CustomerFlowListResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -6087,6 +6481,13 @@ export namespace CustomerFlowListResponse {
          */
         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)
          */
@@ -6259,6 +6660,8 @@ export namespace CustomerFlowListResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -6341,7 +6744,10 @@ export namespace CustomerFlowListResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -6483,6 +6889,13 @@ export namespace CustomerFlowListResponse {
          */
         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)
          */
@@ -6567,6 +6980,8 @@ export namespace CustomerFlowListResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -6649,7 +7064,10 @@ export namespace CustomerFlowListResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -6791,6 +7209,13 @@ export namespace CustomerFlowListResponse {
          */
         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)
          */
@@ -6830,17 +7255,17 @@ export namespace CustomerFlowDeleteResponse {
   }
 }
 
-export interface CustomerFlowGetByIDResponse {
+export interface CustomerFlowDuplicateResponse {
   /**
    * The conversation a simulated customer has with the agent under test.
    */
   data:
-    | CustomerFlowGetByIDResponse.ScriptedCustomerFlow
-    | CustomerFlowGetByIDResponse.ImprovCustomerFlow
-    | CustomerFlowGetByIDResponse.VoicemailCustomerFlow;
+    | CustomerFlowDuplicateResponse.ScriptedCustomerFlow
+    | CustomerFlowDuplicateResponse.ImprovCustomerFlow
+    | CustomerFlowDuplicateResponse.VoicemailCustomerFlow;
 }
 
-export namespace CustomerFlowGetByIDResponse {
+export namespace CustomerFlowDuplicateResponse {
   /**
    * A flow whose conversation is written out as a graph of turns.
    */
@@ -6880,6 +7305,30 @@ export namespace CustomerFlowGetByIDResponse {
      */
     happyPath: ScriptedCustomerFlow.HappyPath | null;
 
+    /**
+     * STRICT only. What the simulated customer does when your agent does not say the
+     * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+     * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+     * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+     * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+     * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+     * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+     * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+     * stay silent, 3 attempts, hang up. The default for every agent step; an
+     * AGENT_TURN step can carry its own.
+     */
+    offScriptPolicy: ScriptedCustomerFlow.OffScriptPolicy | null;
+
+    /**
+     * How closely a run follows the script. LOOSE (default) hands the whole script to
+     * the simulated customer as one prompt; it keeps the call moving whatever your
+     * agent says. STRICT runs the script as a state machine on the agent service: at
+     * every agent step the simulated customer waits, silent, until your agent has said
+     * the expected line, and only then moves on. Scripted flows only; STRICT needs the
+     * agent-service transport and is not available on realtime models.
+     */
+    scriptAdherence: 'LOOSE' | 'STRICT';
+
     source: 'SYSTEM' | 'CUSTOM';
 
     title: string;
@@ -7030,6 +7479,8 @@ export namespace CustomerFlowGetByIDResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -7112,7 +7563,10 @@ export namespace CustomerFlowGetByIDResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -7254,6 +7708,13 @@ export namespace CustomerFlowGetByIDResponse {
          */
         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)
          */
@@ -7345,6 +7806,8 @@ export namespace CustomerFlowGetByIDResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -7427,7 +7890,10 @@ export namespace CustomerFlowGetByIDResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -7569,12 +8035,43 @@ export namespace CustomerFlowGetByIDResponse {
          */
         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;
       }
     }
+
+    /**
+     * STRICT only. What the simulated customer does when your agent does not say the
+     * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+     * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+     * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+     * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+     * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+     * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+     * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+     * stay silent, 3 attempts, hang up. The default for every agent step; an
+     * AGENT_TURN step can carry its own.
+     */
+    export interface OffScriptPolicy {
+      maxAttempts: number;
+
+      reaction: 'STAY_SILENT' | 'REPEAT' | 'RESPOND' | 'SAY';
+
+      then: 'HANG_UP' | 'MOVE_ON' | 'ADAPT' | 'HANG_UP_INVALIDATE';
+
+      sayLine?: string | null;
+
+      waitSeconds?: number | null;
+    }
   }
 
   /**
@@ -7747,6 +8244,8 @@ export namespace CustomerFlowGetByIDResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -7829,7 +8328,10 @@ export namespace CustomerFlowGetByIDResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -7971,6 +8473,13 @@ export namespace CustomerFlowGetByIDResponse {
          */
         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)
          */
@@ -8060,6 +8569,8 @@ export namespace CustomerFlowGetByIDResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -8142,7 +8653,10 @@ export namespace CustomerFlowGetByIDResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -8284,6 +8798,13 @@ export namespace CustomerFlowGetByIDResponse {
          */
         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)
          */
@@ -8456,6 +8977,8 @@ export namespace CustomerFlowGetByIDResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -8538,7 +9061,10 @@ export namespace CustomerFlowGetByIDResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -8680,6 +9206,13 @@ export namespace CustomerFlowGetByIDResponse {
          */
         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)
          */
@@ -8764,6 +9297,8 @@ export namespace CustomerFlowGetByIDResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -8846,7 +9381,10 @@ export namespace CustomerFlowGetByIDResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -8988,6 +9526,13 @@ export namespace CustomerFlowGetByIDResponse {
          */
         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)
          */
@@ -8997,45 +9542,2332 @@ export namespace CustomerFlowGetByIDResponse {
   }
 }
 
-export interface CustomerFlowReplaceGraphResponse {
-  data: CustomerFlowReplaceGraphResponse.Data;
+export interface CustomerFlowGetByIDResponse {
+  /**
+   * The conversation a simulated customer has with the agent under test.
+   */
+  data:
+    | CustomerFlowGetByIDResponse.ScriptedCustomerFlow
+    | CustomerFlowGetByIDResponse.ImprovCustomerFlow
+    | CustomerFlowGetByIDResponse.VoicemailCustomerFlow;
 }
 
-export namespace CustomerFlowReplaceGraphResponse {
-  export interface Data {
+export namespace CustomerFlowGetByIDResponse {
+  /**
+   * A flow whose conversation is written out as a graph of turns.
+   */
+  export interface ScriptedCustomerFlow {
+    id: string;
+
+    agentExpectations: Array<ScriptedCustomerFlow.AgentExpectation>;
+
     /**
-     * The edge cases after the write.
+     * The agents this flow is run against.
      */
-    edgeCases: Array<Data.ScriptedFlowVariant | Data.ImprovFlowVariant | Data.VoicemailFlowVariant>;
-
-    graph: Array<CustomerFlowAPI.FlowStep>;
+    agents: Array<ScriptedCustomerFlow.Agent>;
 
     /**
-     * The way a customer flow is meant to go.
+     * How a run walks the graph. DETERMINISTIC ("Simulate every path" in the app)
+     * places one call per variant, each following its path exactly whatever the agent
+     * says. ADAPTIVE ("Adapt to your agent") collapses the paths into one call PER
+     * PERSONA, on which the simulated customer picks a branch from what the agent
+     * actually said. Both modes speak the exact authored lines, and neither changes
+     * how metrics or expectations grade.
      */
-    happyPath: Data.ScriptedFlowVariant | Data.ImprovFlowVariant | Data.VoicemailFlowVariant | null;
+    branchingMode: 'DETERMINISTIC' | 'ADAPTIVE';
 
     /**
-     * True when the write changed the set of paths, so the flow's variants were
-     * re-seeded and any variant id you were holding may no longer exist.
+     * Creation timestamp in ISO 8601 format
      */
-    variantsReshaped: boolean;
+    createdAt: string;
 
-    warnings: Array<string>;
-  }
+    /**
+     * Every other way of running this flow.
+     */
+    edgeCases: Array<ScriptedCustomerFlow.EdgeCase>;
 
-  export namespace Data {
     /**
      * One path through a scripted flow. The path engine owns which paths exist, so
      * editing the graph is what creates and removes these.
      */
-    export interface ScriptedFlowVariant {
-      id: string;
+    happyPath: ScriptedCustomerFlow.HappyPath | null;
 
-      /**
-       * Graded on top of the flow's own expectations, for this variant only.
-       */
-      additionalExpectations: Array<ScriptedFlowVariant.AdditionalExpectation>;
+    /**
+     * STRICT only. What the simulated customer does when your agent does not say the
+     * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+     * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+     * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+     * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+     * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+     * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+     * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+     * stay silent, 3 attempts, hang up. The default for every agent step; an
+     * AGENT_TURN step can carry its own.
+     */
+    offScriptPolicy: ScriptedCustomerFlow.OffScriptPolicy | null;
+
+    /**
+     * How closely a run follows the script. LOOSE (default) hands the whole script to
+     * the simulated customer as one prompt; it keeps the call moving whatever your
+     * agent says. STRICT runs the script as a state machine on the agent service: at
+     * every agent step the simulated customer waits, silent, until your agent has said
+     * the expected line, and only then moves on. Scripted flows only; STRICT needs the
+     * agent-service transport and is not available on realtime models.
+     */
+    scriptAdherence: 'LOOSE' | 'STRICT';
+
+    source: 'SYSTEM' | 'CUSTOM';
+
+    title: string;
+
+    type: 'SCRIPTED';
+
+    /**
+     * Last update timestamp in ISO 8601 format
+     */
+    updatedAt: string;
+
+    description?: string | null;
+
+    /**
+     * The conversation, as a graph of steps. Present on a single flow; omitted from
+     * the list, where reading it would mean walking the project step graph once per
+     * row.
+     */
+    graph?: Array<CustomerFlowAPI.FlowStep>;
+  }
+
+  export namespace ScriptedCustomerFlow {
+    /**
+     * One thing the agent under test is graded against.
+     */
+    export interface AgentExpectation {
+      id: string;
+
+      /**
+       * What the agent under test is graded against.
+       */
+      prompt: string;
+    }
+
+    export interface Agent {
+      /**
+       * Unique identifier of the agent
+       */
+      id: string;
+
+      /**
+       * Creation timestamp in ISO 8601 format
+       */
+      createdAt: string;
+
+      /**
+       * Custom identifier for the agent
+       */
+      customId: string | null;
+
+      /**
+       * Description of the agent
+       */
+      description: string | null;
+
+      /**
+       * Name of the agent
+       */
+      name: string;
+
+      /**
+       * Last update timestamp in ISO 8601 format
+       */
+      updatedAt: string;
+    }
+
+    /**
+     * One path through a scripted flow. The path engine owns which paths exist, so
+     * editing the graph is what creates and removes these.
+     */
+    export interface EdgeCase {
+      id: string;
+
+      /**
+       * Graded on top of the flow's own expectations, for this variant only.
+       */
+      additionalExpectations: Array<EdgeCase.AdditionalExpectation>;
+
+      /**
+       * Creation timestamp in ISO 8601 format
+       */
+      createdAt: string;
+
+      /**
+       * A simulation environment: the ambient conditions a customer flow variant runs
+       * under. The list includes both your own and the ones Roark curates for every
+       * project.
+       */
+      environment: EdgeCase.Environment | null;
+
+      isGenerated: boolean;
+
+      /**
+       * The persona this runs as instead of the happy path's. Null means it inherits.
+       */
+      personaOverride: EdgeCase.PersonaOverride | null;
+
+      precededByCustomerFlowId: string | null;
+
+      precededByCustomerFlowVariantId: string | null;
+
+      /**
+       * The one path through the graph this variant runs, in order. Linear by
+       * construction, so these steps never nest.
+       */
+      steps: Array<CustomerFlowAPI.FlowStep>;
+
+      title: string;
+
+      type: 'SCRIPTED';
+
+      /**
+       * Last update timestamp in ISO 8601 format
+       */
+      updatedAt: string;
+
+      systemKey?: string | null;
+    }
+
+    export namespace EdgeCase {
+      /**
+       * One thing the agent under test is graded against.
+       */
+      export interface AdditionalExpectation {
+        id: string;
+
+        /**
+         * What the agent under test is graded against.
+         */
+        prompt: string;
+      }
+
+      /**
+       * A simulation environment: the ambient conditions a customer flow variant runs
+       * under. The list includes both your own and the ones Roark curates for every
+       * project.
+       */
+      export interface Environment {
+        id: string;
+
+        backgroundNoise:
+          | 'NONE'
+          | 'AIRPORT'
+          | 'CHILDREN_PLAYING'
+          | 'CITY'
+          | 'COFFEE_SHOP'
+          | 'DRIVING'
+          | 'OFFICE'
+          | 'THUNDERSTORM';
+
+        backgroundNoiseVolume: number;
+
+        /**
+         * Creation timestamp in ISO 8601 format
+         */
+        createdAt: string;
+
+        name: string;
+
+        /**
+         * Last update timestamp in ISO 8601 format
+         */
+        updatedAt: string;
+
+        description?: string | null;
+      }
+
+      /**
+       * The persona this runs as instead of the happy path's. Null means it inherits.
+       */
+      export 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'
+          | 'DRIVING'
+          | 'OFFICE'
+          | 'THUNDERSTORM';
+
+        /**
+         * 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)
+         */
+        responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK';
+
+        /**
+         * 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 path through a scripted flow. The path engine owns which paths exist, so
+     * editing the graph is what creates and removes these.
+     */
+    export interface HappyPath {
+      id: string;
+
+      /**
+       * Graded on top of the flow's own expectations, for this variant only.
+       */
+      additionalExpectations: Array<HappyPath.AdditionalExpectation>;
+
+      /**
+       * Creation timestamp in ISO 8601 format
+       */
+      createdAt: string;
+
+      /**
+       * A simulation environment: the ambient conditions a customer flow variant runs
+       * under. The list includes both your own and the ones Roark curates for every
+       * project.
+       */
+      environment: HappyPath.Environment | null;
+
+      isGenerated: boolean;
+
+      /**
+       * The persona this runs as instead of the happy path's. Null means it inherits.
+       */
+      personaOverride: HappyPath.PersonaOverride | null;
+
+      precededByCustomerFlowId: string | null;
+
+      precededByCustomerFlowVariantId: string | null;
+
+      /**
+       * The one path through the graph this variant runs, in order. Linear by
+       * construction, so these steps never nest.
+       */
+      steps: Array<CustomerFlowAPI.FlowStep>;
+
+      title: string;
+
+      type: 'SCRIPTED';
+
+      /**
+       * Last update timestamp in ISO 8601 format
+       */
+      updatedAt: string;
+
+      systemKey?: string | null;
+    }
+
+    export namespace HappyPath {
+      /**
+       * One thing the agent under test is graded against.
+       */
+      export interface AdditionalExpectation {
+        id: string;
+
+        /**
+         * What the agent under test is graded against.
+         */
+        prompt: string;
+      }
+
+      /**
+       * A simulation environment: the ambient conditions a customer flow variant runs
+       * under. The list includes both your own and the ones Roark curates for every
+       * project.
+       */
+      export interface Environment {
+        id: string;
+
+        backgroundNoise:
+          | 'NONE'
+          | 'AIRPORT'
+          | 'CHILDREN_PLAYING'
+          | 'CITY'
+          | 'COFFEE_SHOP'
+          | 'DRIVING'
+          | 'OFFICE'
+          | 'THUNDERSTORM';
+
+        backgroundNoiseVolume: number;
+
+        /**
+         * Creation timestamp in ISO 8601 format
+         */
+        createdAt: string;
+
+        name: string;
+
+        /**
+         * Last update timestamp in ISO 8601 format
+         */
+        updatedAt: string;
+
+        description?: string | null;
+      }
+
+      /**
+       * The persona this runs as instead of the happy path's. Null means it inherits.
+       */
+      export 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'
+          | 'DRIVING'
+          | 'OFFICE'
+          | 'THUNDERSTORM';
+
+        /**
+         * 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)
+         */
+        responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK';
+
+        /**
+         * 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;
+      }
+    }
+
+    /**
+     * STRICT only. What the simulated customer does when your agent does not say the
+     * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+     * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+     * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+     * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+     * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+     * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+     * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+     * stay silent, 3 attempts, hang up. The default for every agent step; an
+     * AGENT_TURN step can carry its own.
+     */
+    export interface OffScriptPolicy {
+      maxAttempts: number;
+
+      reaction: 'STAY_SILENT' | 'REPEAT' | 'RESPOND' | 'SAY';
+
+      then: 'HANG_UP' | 'MOVE_ON' | 'ADAPT' | 'HANG_UP_INVALIDATE';
+
+      sayLine?: string | null;
+
+      waitSeconds?: number | null;
+    }
+  }
+
+  /**
+   * A flow whose conversation is not written out: each variant gives the simulated
+   * customer a brief and lets it improvise.
+   */
+  export interface ImprovCustomerFlow {
+    id: string;
+
+    agentExpectations: Array<ImprovCustomerFlow.AgentExpectation>;
+
+    /**
+     * The agents this flow is run against.
+     */
+    agents: Array<ImprovCustomerFlow.Agent>;
+
+    /**
+     * Creation timestamp in ISO 8601 format
+     */
+    createdAt: string;
+
+    /**
+     * Every other way of running this flow.
+     */
+    edgeCases: Array<ImprovCustomerFlow.EdgeCase>;
+
+    /**
+     * One brief to run an improv flow with.
+     */
+    happyPath: ImprovCustomerFlow.HappyPath | null;
+
+    source: 'SYSTEM' | 'CUSTOM';
+
+    title: string;
+
+    type: 'IMPROV';
+
+    /**
+     * Last update timestamp in ISO 8601 format
+     */
+    updatedAt: string;
+
+    description?: string | null;
+  }
+
+  export namespace ImprovCustomerFlow {
+    /**
+     * One thing the agent under test is graded against.
+     */
+    export interface AgentExpectation {
+      id: string;
+
+      /**
+       * What the agent under test is graded against.
+       */
+      prompt: string;
+    }
+
+    export interface Agent {
+      /**
+       * Unique identifier of the agent
+       */
+      id: string;
+
+      /**
+       * Creation timestamp in ISO 8601 format
+       */
+      createdAt: string;
+
+      /**
+       * Custom identifier for the agent
+       */
+      customId: string | null;
+
+      /**
+       * Description of the agent
+       */
+      description: string | null;
+
+      /**
+       * Name of the agent
+       */
+      name: string;
+
+      /**
+       * Last update timestamp in ISO 8601 format
+       */
+      updatedAt: string;
+    }
+
+    /**
+     * One brief to run an improv flow with.
+     */
+    export interface EdgeCase {
+      id: string;
+
+      /**
+       * Graded on top of the flow's own expectations, for this variant only.
+       */
+      additionalExpectations: Array<EdgeCase.AdditionalExpectation>;
+
+      /**
+       * Creation timestamp in ISO 8601 format
+       */
+      createdAt: string;
+
+      /**
+       * A simulation environment: the ambient conditions a customer flow variant runs
+       * under. The list includes both your own and the ones Roark curates for every
+       * project.
+       */
+      environment: EdgeCase.Environment | null;
+
+      isGenerated: boolean;
+
+      /**
+       * The persona this runs as instead of the happy path's. Null means it inherits.
+       */
+      personaOverride: EdgeCase.PersonaOverride | null;
+
+      precededByCustomerFlowId: string | null;
+
+      precededByCustomerFlowVariantId: string | null;
+
+      title: string;
+
+      type: 'IMPROV';
+
+      /**
+       * Last update timestamp in ISO 8601 format
+       */
+      updatedAt: string;
+
+      /**
+       * The brief the simulated customer improvises from.
+       */
+      prompt?: string | null;
+
+      systemKey?: string | null;
+    }
+
+    export namespace EdgeCase {
+      /**
+       * One thing the agent under test is graded against.
+       */
+      export interface AdditionalExpectation {
+        id: string;
+
+        /**
+         * What the agent under test is graded against.
+         */
+        prompt: string;
+      }
+
+      /**
+       * A simulation environment: the ambient conditions a customer flow variant runs
+       * under. The list includes both your own and the ones Roark curates for every
+       * project.
+       */
+      export interface Environment {
+        id: string;
+
+        backgroundNoise:
+          | 'NONE'
+          | 'AIRPORT'
+          | 'CHILDREN_PLAYING'
+          | 'CITY'
+          | 'COFFEE_SHOP'
+          | 'DRIVING'
+          | 'OFFICE'
+          | 'THUNDERSTORM';
+
+        backgroundNoiseVolume: number;
+
+        /**
+         * Creation timestamp in ISO 8601 format
+         */
+        createdAt: string;
+
+        name: string;
+
+        /**
+         * Last update timestamp in ISO 8601 format
+         */
+        updatedAt: string;
+
+        description?: string | null;
+      }
+
+      /**
+       * The persona this runs as instead of the happy path's. Null means it inherits.
+       */
+      export 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'
+          | 'DRIVING'
+          | 'OFFICE'
+          | 'THUNDERSTORM';
+
+        /**
+         * 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)
+         */
+        responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK';
+
+        /**
+         * 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.
+     */
+    export interface HappyPath {
+      id: string;
+
+      /**
+       * Graded on top of the flow's own expectations, for this variant only.
+       */
+      additionalExpectations: Array<HappyPath.AdditionalExpectation>;
+
+      /**
+       * Creation timestamp in ISO 8601 format
+       */
+      createdAt: string;
+
+      /**
+       * A simulation environment: the ambient conditions a customer flow variant runs
+       * under. The list includes both your own and the ones Roark curates for every
+       * project.
+       */
+      environment: HappyPath.Environment | null;
+
+      isGenerated: boolean;
+
+      /**
+       * The persona this runs as instead of the happy path's. Null means it inherits.
+       */
+      personaOverride: HappyPath.PersonaOverride | null;
+
+      precededByCustomerFlowId: string | null;
+
+      precededByCustomerFlowVariantId: string | null;
+
+      title: string;
+
+      type: 'IMPROV';
+
+      /**
+       * Last update timestamp in ISO 8601 format
+       */
+      updatedAt: string;
+
+      /**
+       * The brief the simulated customer improvises from.
+       */
+      prompt?: string | null;
+
+      systemKey?: string | null;
+    }
+
+    export namespace HappyPath {
+      /**
+       * One thing the agent under test is graded against.
+       */
+      export interface AdditionalExpectation {
+        id: string;
+
+        /**
+         * What the agent under test is graded against.
+         */
+        prompt: string;
+      }
+
+      /**
+       * A simulation environment: the ambient conditions a customer flow variant runs
+       * under. The list includes both your own and the ones Roark curates for every
+       * project.
+       */
+      export interface Environment {
+        id: string;
+
+        backgroundNoise:
+          | 'NONE'
+          | 'AIRPORT'
+          | 'CHILDREN_PLAYING'
+          | 'CITY'
+          | 'COFFEE_SHOP'
+          | 'DRIVING'
+          | 'OFFICE'
+          | 'THUNDERSTORM';
+
+        backgroundNoiseVolume: number;
+
+        /**
+         * Creation timestamp in ISO 8601 format
+         */
+        createdAt: string;
+
+        name: string;
+
+        /**
+         * Last update timestamp in ISO 8601 format
+         */
+        updatedAt: string;
+
+        description?: string | null;
+      }
+
+      /**
+       * The persona this runs as instead of the happy path's. Null means it inherits.
+       */
+      export 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'
+          | 'DRIVING'
+          | 'OFFICE'
+          | 'THUNDERSTORM';
+
+        /**
+         * 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)
+         */
+        responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK';
+
+        /**
+         * 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;
+      }
+    }
+  }
+
+  /**
+   * A flow that leaves a voicemail. Curated by Roark, read-only.
+   */
+  export interface VoicemailCustomerFlow {
+    id: string;
+
+    agentExpectations: Array<VoicemailCustomerFlow.AgentExpectation>;
+
+    /**
+     * The agents this flow is run against.
+     */
+    agents: Array<VoicemailCustomerFlow.Agent>;
+
+    /**
+     * Creation timestamp in ISO 8601 format
+     */
+    createdAt: string;
+
+    /**
+     * Every other way of running this flow.
+     */
+    edgeCases: Array<VoicemailCustomerFlow.EdgeCase>;
+
+    /**
+     * One voicemail greeting.
+     */
+    happyPath: VoicemailCustomerFlow.HappyPath | null;
+
+    source: 'SYSTEM' | 'CUSTOM';
+
+    title: string;
+
+    type: 'VOICEMAIL';
+
+    /**
+     * Last update timestamp in ISO 8601 format
+     */
+    updatedAt: string;
+
+    description?: string | null;
+  }
+
+  export namespace VoicemailCustomerFlow {
+    /**
+     * One thing the agent under test is graded against.
+     */
+    export interface AgentExpectation {
+      id: string;
+
+      /**
+       * What the agent under test is graded against.
+       */
+      prompt: string;
+    }
+
+    export interface Agent {
+      /**
+       * Unique identifier of the agent
+       */
+      id: string;
+
+      /**
+       * Creation timestamp in ISO 8601 format
+       */
+      createdAt: string;
+
+      /**
+       * Custom identifier for the agent
+       */
+      customId: string | null;
+
+      /**
+       * Description of the agent
+       */
+      description: string | null;
+
+      /**
+       * Name of the agent
+       */
+      name: string;
+
+      /**
+       * Last update timestamp in ISO 8601 format
+       */
+      updatedAt: string;
+    }
+
+    /**
+     * One voicemail greeting.
+     */
+    export interface EdgeCase {
+      id: string;
+
+      /**
+       * Graded on top of the flow's own expectations, for this variant only.
+       */
+      additionalExpectations: Array<EdgeCase.AdditionalExpectation>;
+
+      /**
+       * Creation timestamp in ISO 8601 format
+       */
+      createdAt: string;
+
+      /**
+       * A simulation environment: the ambient conditions a customer flow variant runs
+       * under. The list includes both your own and the ones Roark curates for every
+       * project.
+       */
+      environment: EdgeCase.Environment | null;
+
+      isGenerated: boolean;
+
+      /**
+       * The persona this runs as instead of the happy path's. Null means it inherits.
+       */
+      personaOverride: EdgeCase.PersonaOverride | null;
+
+      precededByCustomerFlowId: string | null;
+
+      precededByCustomerFlowVariantId: string | null;
+
+      title: string;
+
+      type: 'VOICEMAIL';
+
+      /**
+       * Last update timestamp in ISO 8601 format
+       */
+      updatedAt: string;
+
+      systemKey?: string | null;
+    }
+
+    export namespace EdgeCase {
+      /**
+       * One thing the agent under test is graded against.
+       */
+      export interface AdditionalExpectation {
+        id: string;
+
+        /**
+         * What the agent under test is graded against.
+         */
+        prompt: string;
+      }
+
+      /**
+       * A simulation environment: the ambient conditions a customer flow variant runs
+       * under. The list includes both your own and the ones Roark curates for every
+       * project.
+       */
+      export interface Environment {
+        id: string;
+
+        backgroundNoise:
+          | 'NONE'
+          | 'AIRPORT'
+          | 'CHILDREN_PLAYING'
+          | 'CITY'
+          | 'COFFEE_SHOP'
+          | 'DRIVING'
+          | 'OFFICE'
+          | 'THUNDERSTORM';
+
+        backgroundNoiseVolume: number;
+
+        /**
+         * Creation timestamp in ISO 8601 format
+         */
+        createdAt: string;
+
+        name: string;
+
+        /**
+         * Last update timestamp in ISO 8601 format
+         */
+        updatedAt: string;
+
+        description?: string | null;
+      }
+
+      /**
+       * The persona this runs as instead of the happy path's. Null means it inherits.
+       */
+      export 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'
+          | 'DRIVING'
+          | 'OFFICE'
+          | 'THUNDERSTORM';
+
+        /**
+         * 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)
+         */
+        responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK';
+
+        /**
+         * 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 voicemail greeting.
+     */
+    export interface HappyPath {
+      id: string;
+
+      /**
+       * Graded on top of the flow's own expectations, for this variant only.
+       */
+      additionalExpectations: Array<HappyPath.AdditionalExpectation>;
+
+      /**
+       * Creation timestamp in ISO 8601 format
+       */
+      createdAt: string;
+
+      /**
+       * A simulation environment: the ambient conditions a customer flow variant runs
+       * under. The list includes both your own and the ones Roark curates for every
+       * project.
+       */
+      environment: HappyPath.Environment | null;
+
+      isGenerated: boolean;
+
+      /**
+       * The persona this runs as instead of the happy path's. Null means it inherits.
+       */
+      personaOverride: HappyPath.PersonaOverride | null;
+
+      precededByCustomerFlowId: string | null;
+
+      precededByCustomerFlowVariantId: string | null;
+
+      title: string;
+
+      type: 'VOICEMAIL';
+
+      /**
+       * Last update timestamp in ISO 8601 format
+       */
+      updatedAt: string;
+
+      systemKey?: string | null;
+    }
+
+    export namespace HappyPath {
+      /**
+       * One thing the agent under test is graded against.
+       */
+      export interface AdditionalExpectation {
+        id: string;
+
+        /**
+         * What the agent under test is graded against.
+         */
+        prompt: string;
+      }
+
+      /**
+       * A simulation environment: the ambient conditions a customer flow variant runs
+       * under. The list includes both your own and the ones Roark curates for every
+       * project.
+       */
+      export interface Environment {
+        id: string;
+
+        backgroundNoise:
+          | 'NONE'
+          | 'AIRPORT'
+          | 'CHILDREN_PLAYING'
+          | 'CITY'
+          | 'COFFEE_SHOP'
+          | 'DRIVING'
+          | 'OFFICE'
+          | 'THUNDERSTORM';
+
+        backgroundNoiseVolume: number;
+
+        /**
+         * Creation timestamp in ISO 8601 format
+         */
+        createdAt: string;
+
+        name: string;
+
+        /**
+         * Last update timestamp in ISO 8601 format
+         */
+        updatedAt: string;
+
+        description?: string | null;
+      }
+
+      /**
+       * The persona this runs as instead of the happy path's. Null means it inherits.
+       */
+      export 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'
+          | 'DRIVING'
+          | 'OFFICE'
+          | 'THUNDERSTORM';
+
+        /**
+         * 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)
+         */
+        responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK';
+
+        /**
+         * 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;
+      }
+    }
+  }
+}
+
+export interface CustomerFlowReplaceGraphResponse {
+  data: CustomerFlowReplaceGraphResponse.Data;
+}
+
+export namespace CustomerFlowReplaceGraphResponse {
+  export interface Data {
+    /**
+     * The edge cases after the write.
+     */
+    edgeCases: Array<Data.ScriptedFlowVariant | Data.ImprovFlowVariant | Data.VoicemailFlowVariant>;
+
+    graph: Array<CustomerFlowAPI.FlowStep>;
+
+    /**
+     * The way a customer flow is meant to go.
+     */
+    happyPath: Data.ScriptedFlowVariant | Data.ImprovFlowVariant | Data.VoicemailFlowVariant | null;
+
+    /**
+     * True when the write changed the set of paths, so the flow's variants were
+     * re-seeded and any variant id you were holding may no longer exist.
+     */
+    variantsReshaped: boolean;
+
+    warnings: Array<string>;
+  }
+
+  export namespace Data {
+    /**
+     * One path through a scripted flow. The path engine owns which paths exist, so
+     * editing the graph is what creates and removes these.
+     */
+    export interface ScriptedFlowVariant {
+      id: string;
+
+      /**
+       * Graded on top of the flow's own expectations, for this variant only.
+       */
+      additionalExpectations: Array<ScriptedFlowVariant.AdditionalExpectation>;
 
       /**
        * Creation timestamp in ISO 8601 format
@@ -9109,6 +11941,8 @@ export namespace CustomerFlowReplaceGraphResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -9191,7 +12025,10 @@ export namespace CustomerFlowReplaceGraphResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -9333,6 +12170,13 @@ export namespace CustomerFlowReplaceGraphResponse {
          */
         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)
          */
@@ -9422,6 +12266,8 @@ export namespace CustomerFlowReplaceGraphResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -9504,7 +12350,10 @@ export namespace CustomerFlowReplaceGraphResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -9646,6 +12495,13 @@ export namespace CustomerFlowReplaceGraphResponse {
          */
         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)
          */
@@ -9730,6 +12586,8 @@ export namespace CustomerFlowReplaceGraphResponse {
           | 'OFFICE'
           | 'THUNDERSTORM';
 
+        backgroundNoiseVolume: number;
+
         /**
          * Creation timestamp in ISO 8601 format
          */
@@ -9812,7 +12670,10 @@ export namespace CustomerFlowReplaceGraphResponse {
           | 'FRUSTRATED'
           | 'SKEPTICAL'
           | 'RUSHED'
-          | 'DISTRACTED';
+          | 'DISTRACTED'
+          | 'ANGRY'
+          | 'ANXIOUS'
+          | 'SAD';
 
         /**
          * How the persona confirms information
@@ -9954,6 +12815,13 @@ export namespace CustomerFlowReplaceGraphResponse {
          */
         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)
          */
@@ -10058,6 +12926,8 @@ export namespace CustomerFlowUpdateHappyPathResponse {
         | 'OFFICE'
         | 'THUNDERSTORM';
 
+      backgroundNoiseVolume: number;
+
       /**
        * Creation timestamp in ISO 8601 format
        */
@@ -10133,7 +13003,17 @@ export namespace CustomerFlowUpdateHappyPathResponse {
       /**
        * Base emotional state of the persona
        */
-      baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED';
+      baseEmotion:
+        | 'NEUTRAL'
+        | 'CHEERFUL'
+        | 'CONFUSED'
+        | 'FRUSTRATED'
+        | 'SKEPTICAL'
+        | 'RUSHED'
+        | 'DISTRACTED'
+        | 'ANGRY'
+        | 'ANXIOUS'
+        | 'SAD';
 
       /**
        * How the persona confirms information
@@ -10275,6 +13155,13 @@ export namespace CustomerFlowUpdateHappyPathResponse {
        */
       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)
        */
@@ -10364,6 +13251,8 @@ export namespace CustomerFlowUpdateHappyPathResponse {
         | 'OFFICE'
         | 'THUNDERSTORM';
 
+      backgroundNoiseVolume: number;
+
       /**
        * Creation timestamp in ISO 8601 format
        */
@@ -10439,7 +13328,17 @@ export namespace CustomerFlowUpdateHappyPathResponse {
       /**
        * Base emotional state of the persona
        */
-      baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED';
+      baseEmotion:
+        | 'NEUTRAL'
+        | 'CHEERFUL'
+        | 'CONFUSED'
+        | 'FRUSTRATED'
+        | 'SKEPTICAL'
+        | 'RUSHED'
+        | 'DISTRACTED'
+        | 'ANGRY'
+        | 'ANXIOUS'
+        | 'SAD';
 
       /**
        * How the persona confirms information
@@ -10581,6 +13480,13 @@ export namespace CustomerFlowUpdateHappyPathResponse {
        */
       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)
        */
@@ -10665,6 +13571,8 @@ export namespace CustomerFlowUpdateHappyPathResponse {
         | 'OFFICE'
         | 'THUNDERSTORM';
 
+      backgroundNoiseVolume: number;
+
       /**
        * Creation timestamp in ISO 8601 format
        */
@@ -10740,7 +13648,17 @@ export namespace CustomerFlowUpdateHappyPathResponse {
       /**
        * Base emotional state of the persona
        */
-      baseEmotion: 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED';
+      baseEmotion:
+        | 'NEUTRAL'
+        | 'CHEERFUL'
+        | 'CONFUSED'
+        | 'FRUSTRATED'
+        | 'SKEPTICAL'
+        | 'RUSHED'
+        | 'DISTRACTED'
+        | 'ANGRY'
+        | 'ANXIOUS'
+        | 'SAD';
 
       /**
        * How the persona confirms information
@@ -10882,6 +13800,13 @@ export namespace CustomerFlowUpdateHappyPathResponse {
        */
       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)
        */
@@ -10899,7 +13824,8 @@ export declare namespace CustomerFlowCreateParams {
     /**
      * The conversation, as a graph of steps. At most 100 steps across at most 25
      * paths. The variants come from the graph: one per path, so they are not sent
-     * here.
+     * here. A CUSTOMER_TURN describes what the simulated customer says and the persona
+     * phrases it; a CUSTOMER_VERBATIM_TURN is said word for word.
      */
     graph: Array<FlowStep>;
 
@@ -10925,6 +13851,31 @@ export declare namespace CustomerFlowCreateParams {
     branchingMode?: 'DETERMINISTIC' | 'ADAPTIVE';
 
     description?: string | null;
+
+    /**
+     * STRICT only. What the simulated customer does when your agent does not say the
+     * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+     * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+     * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+     * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+     * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+     * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+     * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+     * stay silent, 3 attempts, hang up. The default for every agent step; an
+     * AGENT_TURN step can carry its own.
+     */
+    offScriptPolicy?: CreateScriptedCustomerFlowInput.OffScriptPolicy | null;
+
+    /**
+     * How closely a run follows the script. LOOSE (default) hands the whole script to
+     * the simulated customer as one prompt; it keeps the call moving whatever your
+     * agent says. STRICT runs the script as a state machine on the agent service: at
+     * every agent step the simulated customer waits, silent, until your agent has said
+     * the expected line, and only then moves on. Scripted flows only; STRICT needs the
+     * agent-service transport and is not available on realtime models. (LOOSE is the
+     * default.)
+     */
+    scriptAdherence?: 'LOOSE' | 'STRICT';
   }
 
   export namespace CreateScriptedCustomerFlowInput {
@@ -10934,6 +13885,30 @@ export declare namespace CustomerFlowCreateParams {
        */
       prompt: string;
     }
+
+    /**
+     * STRICT only. What the simulated customer does when your agent does not say the
+     * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+     * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+     * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+     * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+     * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+     * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+     * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+     * stay silent, 3 attempts, hang up. The default for every agent step; an
+     * AGENT_TURN step can carry its own.
+     */
+    export interface OffScriptPolicy {
+      maxAttempts: number;
+
+      reaction: 'STAY_SILENT' | 'REPEAT' | 'RESPOND' | 'SAY';
+
+      then: 'HANG_UP' | 'MOVE_ON' | 'ADAPT' | 'HANG_UP_INVALIDATE';
+
+      sayLine?: string | null;
+
+      waitSeconds?: number | null;
+    }
   }
 
   export interface CreateImprovCustomerFlowInput {
@@ -11037,6 +14012,31 @@ export interface CustomerFlowUpdateParams {
 
   description?: string | null;
 
+  /**
+   * STRICT only. What the simulated customer does when your agent does not say the
+   * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+   * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+   * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+   * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+   * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+   * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+   * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+   * stay silent, 3 attempts, hang up. The default for every agent step; an
+   * AGENT_TURN step can carry its own.
+   */
+  offScriptPolicy?: CustomerFlowUpdateParams.OffScriptPolicy | null;
+
+  /**
+   * Scripted flows only. How closely a run follows the script. LOOSE (default) hands
+   * the whole script to the simulated customer as one prompt; it keeps the call
+   * moving whatever your agent says. STRICT runs the script as a state machine on
+   * the agent service: at every agent step the simulated customer waits, silent,
+   * until your agent has said the expected line, and only then moves on. Scripted
+   * flows only; STRICT needs the agent-service transport and is not available on
+   * realtime models.
+   */
+  scriptAdherence?: 'LOOSE' | 'STRICT';
+
   title?: string;
 }
 
@@ -11047,6 +14047,30 @@ export namespace CustomerFlowUpdateParams {
      */
     prompt: string;
   }
+
+  /**
+   * STRICT only. What the simulated customer does when your agent does not say the
+   * expected line. Each unmatched agent utterance is an attempt: `reaction` runs per
+   * attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character
+   * without moving on, or SAY `sayLine`), and `then` runs when attempts reach
+   * `maxAttempts` or your agent stays silent for `waitSeconds` (HANG_UP ends the
+   * call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way
+   * and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON
+   * advances anyway, ADAPT hands the rest of the call to loose behaviour). Null:
+   * stay silent, 3 attempts, hang up. The default for every agent step; an
+   * AGENT_TURN step can carry its own.
+   */
+  export interface OffScriptPolicy {
+    maxAttempts: number;
+
+    reaction: 'STAY_SILENT' | 'REPEAT' | 'RESPOND' | 'SAY';
+
+    then: 'HANG_UP' | 'MOVE_ON' | 'ADAPT' | 'HANG_UP_INVALIDATE';
+
+    sayLine?: string | null;
+
+    waitSeconds?: number | null;
+  }
 }
 
 export interface CustomerFlowListParams {
@@ -11061,6 +14085,8 @@ export interface CustomerFlowListParams {
   type?: 'SCRIPTED' | 'IMPROV' | 'VOICEMAIL';
 }
 
+export interface CustomerFlowDuplicateParams {}
+
 export interface CustomerFlowReplaceGraphParams {
   /**
    * The complete graph. This replaces the flow's existing steps rather than merging
@@ -11117,12 +14143,14 @@ export declare namespace CustomerFlow {
     type CustomerFlowUpdateResponse as CustomerFlowUpdateResponse,
     type CustomerFlowListResponse as CustomerFlowListResponse,
     type CustomerFlowDeleteResponse as CustomerFlowDeleteResponse,
+    type CustomerFlowDuplicateResponse as CustomerFlowDuplicateResponse,
     type CustomerFlowGetByIDResponse as CustomerFlowGetByIDResponse,
     type CustomerFlowReplaceGraphResponse as CustomerFlowReplaceGraphResponse,
     type CustomerFlowUpdateHappyPathResponse as CustomerFlowUpdateHappyPathResponse,
     type CustomerFlowCreateParams as CustomerFlowCreateParams,
     type CustomerFlowUpdateParams as CustomerFlowUpdateParams,
     type CustomerFlowListParams as CustomerFlowListParams,
+    type CustomerFlowDuplicateParams as CustomerFlowDuplicateParams,
     type CustomerFlowReplaceGraphParams as CustomerFlowReplaceGraphParams,
     type CustomerFlowUpdateHappyPathParams as CustomerFlowUpdateHappyPathParams,
   };