@roarkanalytics/sdk 2.34.0 → 3.0.0

package/src/resources/customer-flow.ts

@@ -16,7 +16,7 @@ export class CustomerFlow extends APIResource {
    * @example
    * ```ts
    * const customerFlow = await client.customerFlow.create({
-   *   graph: [{ type: 'CUSTOMER_FIRST_MESSAGE' }],
+   *   graph: [{ type: 'AGENT_TURN' }],
    *   title: 'Reschedule an appointment',
    *   type: 'SCRIPTED',
    * });
@@ -29,6 +29,13 @@ export class CustomerFlow extends APIResource {
   /**
    * Updates a flow's title, description, branching mode, linked agents or flow-level
    * expectations. The step graph is replaced through PUT /graph.
+   *
+   * @example
+   * ```ts
+   * const customerFlow = await client.customerFlow.update(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
    */
   update(
     flowID: string,
@@ -44,6 +51,11 @@ export class CustomerFlow extends APIResource {
    * walks the project's whole step graph, so it comes back from the single-flow
    * endpoint instead. Customer flows are how a project describes what to test; they
    * replace the older simulation scenarios.
+   *
+   * @example
+   * ```ts
+   * const customerFlows = await client.customerFlow.list();
+   * ```
    */
   list(
     query: CustomerFlowListParams | null | undefined = {},
@@ -56,6 +68,13 @@ export class CustomerFlow extends APIResource {
    * Soft-deletes a customer flow along with its edge cases, expectations and (for
    * scripted flows) its step graph. Run plans that linked it drop it from their test
    * cases.
+   *
+   * @example
+   * ```ts
+   * const customerFlow = await client.customerFlow.delete(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
    */
   delete(flowID: string, options?: RequestOptions): APIPromise<CustomerFlowDeleteResponse> {
     return this._client.delete(path`/v1/customer-flow/${flowID}`, options);
@@ -64,6 +83,13 @@ export class CustomerFlow extends APIResource {
   /**
    * Returns a customer flow with its happy path, edge cases, expectations and linked
    * agents. Scripted flows also carry their step graph.
+   *
+   * @example
+   * ```ts
+   * const response = await client.customerFlow.getByID(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
    */
   getByID(flowID: string, options?: RequestOptions): APIPromise<CustomerFlowGetByIDResponse> {
     return this._client.get(path`/v1/customer-flow/${flowID}`, options);
@@ -81,6 +107,14 @@ export class CustomerFlow extends APIResource {
    * A change to the set of paths re-seeds how the flow runs, which the response
    * reports as `variantsReshaped` along with the resulting happy path and edge
    * cases.
+   *
+   * @example
+   * ```ts
+   * const response = await client.customerFlow.replaceGraph(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   { graph: [{ type: 'AGENT_TURN' }] },
+   * );
+   * ```
    */
   replaceGraph(
     flowID: string,
@@ -97,6 +131,13 @@ export class CustomerFlow extends APIResource {
    *
    * Its persona and environment are what the edge cases inherit, so changing them
    * here changes every edge case that does not name its own.
+   *
+   * @example
+   * ```ts
+   * const response = await client.customerFlow.updateHappyPath(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
    */
   updateHappyPath(
     flowID: string,
@@ -480,6 +521,12 @@ export namespace CustomerFlowCreateResponse {
           | '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
          */
@@ -787,6 +834,12 @@ export namespace CustomerFlowCreateResponse {
           | '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
          */
@@ -1181,6 +1234,12 @@ export namespace CustomerFlowCreateResponse {
           | '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
          */
@@ -1486,6 +1545,12 @@ export namespace CustomerFlowCreateResponse {
           | '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
          */
@@ -1874,6 +1939,12 @@ export namespace CustomerFlowCreateResponse {
           | '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
          */
@@ -2174,6 +2245,12 @@ export namespace CustomerFlowCreateResponse {
           | '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
          */
@@ -2595,6 +2672,12 @@ export namespace CustomerFlowUpdateResponse {
           | '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
          */
@@ -2902,6 +2985,12 @@ export namespace CustomerFlowUpdateResponse {
           | '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
          */
@@ -3296,6 +3385,12 @@ export namespace CustomerFlowUpdateResponse {
           | '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
          */
@@ -3601,6 +3696,12 @@ export namespace CustomerFlowUpdateResponse {
           | '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
          */
@@ -3989,6 +4090,12 @@ export namespace CustomerFlowUpdateResponse {
           | '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
          */
@@ -4289,6 +4396,12 @@ export namespace CustomerFlowUpdateResponse {
           | '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
          */
@@ -4713,6 +4826,12 @@ export namespace CustomerFlowListResponse {
           | '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
          */
@@ -5020,6 +5139,12 @@ export namespace CustomerFlowListResponse {
           | '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
          */
@@ -5414,6 +5539,12 @@ export namespace CustomerFlowListResponse {
           | '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
          */
@@ -5719,6 +5850,12 @@ export namespace CustomerFlowListResponse {
           | '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
          */
@@ -6107,6 +6244,12 @@ export namespace CustomerFlowListResponse {
           | '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
          */
@@ -6407,6 +6550,12 @@ export namespace CustomerFlowListResponse {
           | '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
          */
@@ -6858,6 +7007,12 @@ export namespace CustomerFlowGetByIDResponse {
           | '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
          */
@@ -7165,6 +7320,12 @@ export namespace CustomerFlowGetByIDResponse {
           | '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
          */
@@ -7559,6 +7720,12 @@ export namespace CustomerFlowGetByIDResponse {
           | '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
          */
@@ -7864,6 +8031,12 @@ export namespace CustomerFlowGetByIDResponse {
           | '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
          */
@@ -8252,6 +8425,12 @@ export namespace CustomerFlowGetByIDResponse {
           | '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
          */
@@ -8552,6 +8731,12 @@ export namespace CustomerFlowGetByIDResponse {
           | '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
          */
@@ -8889,6 +9074,12 @@ export namespace CustomerFlowReplaceGraphResponse {
           | '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
          */
@@ -9194,6 +9385,12 @@ export namespace CustomerFlowReplaceGraphResponse {
           | '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
          */
@@ -9494,6 +9691,12 @@ export namespace CustomerFlowReplaceGraphResponse {
           | '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
          */
@@ -9665,1041 +9868,129 @@ export namespace CustomerFlowReplaceGraphResponse {
         secondaryLanguage?: 'EN' | null;
       }
     }
+  }
+}
+
+export interface CustomerFlowUpdateHappyPathResponse {
+  /**
+   * One way of running a customer flow.
+   */
+  data:
+    | CustomerFlowUpdateHappyPathResponse.ScriptedFlowVariant
+    | CustomerFlowUpdateHappyPathResponse.ImprovFlowVariant
+    | CustomerFlowUpdateHappyPathResponse.VoicemailFlowVariant;
+}
+
+export namespace CustomerFlowUpdateHappyPathResponse {
+  /**
+   * 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;
 
     /**
-     * One path through a scripted flow. The path engine owns which paths exist, so
-     * editing the graph is what creates and removes these.
+     * Graded on top of the flow's own expectations, for this variant only.
      */
-    export interface ScriptedFlowVariant {
-      id: string;
+    additionalExpectations: Array<ScriptedFlowVariant.AdditionalExpectation>;
 
-      /**
-       * Graded on top of the flow's own expectations, for this variant only.
-       */
-      additionalExpectations: Array<ScriptedFlowVariant.AdditionalExpectation>;
+    /**
+     * Creation timestamp in ISO 8601 format
+     */
+    createdAt: string;
 
-      /**
-       * 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: ScriptedFlowVariant.Environment | null;
 
-      /**
-       * 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: ScriptedFlowVariant.Environment | null;
+    isGenerated: boolean;
 
-      isGenerated: boolean;
+    /**
+     * The persona this runs as instead of the happy path's. Null means it inherits.
+     */
+    personaOverride: ScriptedFlowVariant.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;
+  }
+
+  export namespace ScriptedFlowVariant {
+    /**
+     * One thing the agent under test is graded against.
+     */
+    export interface AdditionalExpectation {
+      id: string;
 
       /**
-       * The persona this runs as instead of the happy path's. Null means it inherits.
+       * What the agent under test is graded against.
        */
-      personaOverride: ScriptedFlowVariant.PersonaOverride | null;
+      prompt: string;
+    }
 
-      precededByCustomerFlowId: string | null;
+    /**
+     * 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;
 
-      precededByCustomerFlowVariantId: string | null;
+      backgroundNoise:
+        | 'NONE'
+        | 'AIRPORT'
+        | 'CHILDREN_PLAYING'
+        | 'CITY'
+        | 'COFFEE_SHOP'
+        | 'DRIVING'
+        | 'OFFICE'
+        | 'THUNDERSTORM';
 
       /**
-       * The one path through the graph this variant runs, in order. Linear by
-       * construction, so these steps never nest.
+       * Creation timestamp in ISO 8601 format
        */
-      steps: Array<CustomerFlowAPI.FlowStep>;
-
-      title: string;
+      createdAt: string;
 
-      type: 'SCRIPTED';
+      name: string;
 
       /**
        * Last update timestamp in ISO 8601 format
        */
       updatedAt: string;
+
+      description?: string | null;
     }
 
-    export namespace ScriptedFlowVariant {
+    /**
+     * The persona this runs as instead of the happy path's. Null means it inherits.
+     */
+    export interface PersonaOverride {
       /**
-       * One thing the agent under test is graded against.
+       * Unique identifier of the persona
        */
-      export interface AdditionalExpectation {
-        id: string;
-
-        /**
-         * What the agent under test is graded against.
-         */
-        prompt: string;
-      }
+      id: 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';
-
-        /**
-         * 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';
-
-        /**
-         * 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';
-
-        /**
-         * 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;
-
-        /**
-         * 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 ImprovFlowVariant {
-      id: string;
-
-      /**
-       * Graded on top of the flow's own expectations, for this variant only.
-       */
-      additionalExpectations: Array<ImprovFlowVariant.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: ImprovFlowVariant.Environment | null;
-
-      isGenerated: boolean;
-
-      /**
-       * The persona this runs as instead of the happy path's. Null means it inherits.
-       */
-      personaOverride: ImprovFlowVariant.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;
-    }
-
-    export namespace ImprovFlowVariant {
-      /**
-       * 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';
-
-        /**
-         * 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';
-
-        /**
-         * 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';
-
-        /**
-         * 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;
-
-        /**
-         * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
-         */
-        secondaryLanguage?: 'EN' | null;
-      }
-    }
-
-    /**
-     * One voicemail greeting.
-     */
-    export interface VoicemailFlowVariant {
-      id: string;
-
-      /**
-       * Graded on top of the flow's own expectations, for this variant only.
-       */
-      additionalExpectations: Array<VoicemailFlowVariant.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: VoicemailFlowVariant.Environment | null;
-
-      isGenerated: boolean;
-
-      /**
-       * The persona this runs as instead of the happy path's. Null means it inherits.
-       */
-      personaOverride: VoicemailFlowVariant.PersonaOverride | null;
-
-      precededByCustomerFlowId: string | null;
-
-      precededByCustomerFlowVariantId: string | null;
-
-      title: string;
-
-      type: 'VOICEMAIL';
-
-      /**
-       * Last update timestamp in ISO 8601 format
-       */
-      updatedAt: string;
-    }
-
-    export namespace VoicemailFlowVariant {
-      /**
-       * 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';
-
-        /**
-         * 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';
-
-        /**
-         * 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';
-
-        /**
-         * 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;
-
-        /**
-         * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
-         */
-        secondaryLanguage?: 'EN' | null;
-      }
-    }
-  }
-}
-
-export interface CustomerFlowUpdateHappyPathResponse {
-  /**
-   * One way of running a customer flow.
-   */
-  data:
-    | CustomerFlowUpdateHappyPathResponse.ScriptedFlowVariant
-    | CustomerFlowUpdateHappyPathResponse.ImprovFlowVariant
-    | CustomerFlowUpdateHappyPathResponse.VoicemailFlowVariant;
-}
-
-export namespace CustomerFlowUpdateHappyPathResponse {
-  /**
-   * 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
-     */
-    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: ScriptedFlowVariant.Environment | null;
-
-    isGenerated: boolean;
-
-    /**
-     * The persona this runs as instead of the happy path's. Null means it inherits.
-     */
-    personaOverride: ScriptedFlowVariant.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;
-  }
-
-  export namespace ScriptedFlowVariant {
-    /**
-     * 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';
-
-      /**
-       * 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 of the persona, defined using ISO 3166-1 alpha-2 country codes with
+       * optional variants
        */
       accent:
         | 'US'
@@ -10726,6 +10017,12 @@ export namespace CustomerFlowUpdateHappyPathResponse {
         | '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
        */
@@ -11024,6 +10321,12 @@ export namespace CustomerFlowUpdateHappyPathResponse {
         | '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
        */
@@ -11317,6 +10620,12 @@ export namespace CustomerFlowUpdateHappyPathResponse {
         | '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
        */