@roarkanalytics/sdk 4.19.0 → 4.21.0

package/src/resources/simulation-run-plan.ts

@@ -22,7 +22,6 @@ export class SimulationRunPlan extends APIResource {
    *     ],
    *     direction: 'INBOUND',
    *     maxSimulationDurationSeconds: 300,
-   *     metrics: [{}],
    *     name: 'My Run Plan',
    *   });
    * ```
@@ -239,6 +238,19 @@ export namespace SimulationRunPlanCreateResponse {
        */
       maxConcurrentJobs: number;
 
+      /**
+       * How many more times to run a test case when the agent under test never responds:
+       * it never speaks on a call or never replies in a chat (0-10). 0 turns retries
+       * off. Failed checks and failures on Roark’s side are never retried.
+       *
+       * Each retry is a separate attempt, billed like any other, so a plan retrying N
+       * times can place up to N + 1 calls per test case. Every silent attempt stays on
+       * the run with its own call; the run settles once each test case has a final
+       * attempt, and the agent never spoke verdict is judged on each test case’s last
+       * attempt.
+       */
+      maxNoResponseRetries: number;
+
       /**
        * Maximum duration in seconds for each simulation
        */
@@ -254,6 +266,12 @@ export namespace SimulationRunPlanCreateResponse {
        */
       name: string;
 
+      /**
+       * Seconds a retry waits before it dials (30-600). Only used when
+       * `maxNoResponseRetries` is above 0.
+       */
+      noResponseRetryBackoffSeconds: number;
+
       /**
        * Personas included in this run plan. Only meaningful alongside `scenarios`.
        */
@@ -593,6 +611,19 @@ export namespace SimulationRunPlanUpdateResponse {
      */
     maxConcurrentJobs: number;
 
+    /**
+     * How many more times to run a test case when the agent under test never responds:
+     * it never speaks on a call or never replies in a chat (0-10). 0 turns retries
+     * off. Failed checks and failures on Roark’s side are never retried.
+     *
+     * Each retry is a separate attempt, billed like any other, so a plan retrying N
+     * times can place up to N + 1 calls per test case. Every silent attempt stays on
+     * the run with its own call; the run settles once each test case has a final
+     * attempt, and the agent never spoke verdict is judged on each test case’s last
+     * attempt.
+     */
+    maxNoResponseRetries: number;
+
     /**
      * Maximum duration in seconds for each simulation
      */
@@ -608,6 +639,12 @@ export namespace SimulationRunPlanUpdateResponse {
      */
     name: string;
 
+    /**
+     * Seconds a retry waits before it dials (30-600). Only used when
+     * `maxNoResponseRetries` is above 0.
+     */
+    noResponseRetryBackoffSeconds: number;
+
     /**
      * Personas included in this run plan. Only meaningful alongside `scenarios`.
      */
@@ -911,6 +948,19 @@ export namespace SimulationRunPlanListResponse {
      */
     maxConcurrentJobs: number;
 
+    /**
+     * How many more times to run a test case when the agent under test never responds:
+     * it never speaks on a call or never replies in a chat (0-10). 0 turns retries
+     * off. Failed checks and failures on Roark’s side are never retried.
+     *
+     * Each retry is a separate attempt, billed like any other, so a plan retrying N
+     * times can place up to N + 1 calls per test case. Every silent attempt stays on
+     * the run with its own call; the run settles once each test case has a final
+     * attempt, and the agent never spoke verdict is judged on each test case’s last
+     * attempt.
+     */
+    maxNoResponseRetries: number;
+
     /**
      * Maximum duration in seconds for each simulation
      */
@@ -926,6 +976,12 @@ export namespace SimulationRunPlanListResponse {
      */
     name: string;
 
+    /**
+     * Seconds a retry waits before it dials (30-600). Only used when
+     * `maxNoResponseRetries` is above 0.
+     */
+    noResponseRetryBackoffSeconds: number;
+
     /**
      * Personas included in this run plan. Only meaningful alongside `scenarios`.
      */
@@ -1257,6 +1313,19 @@ export namespace SimulationRunPlanGetByIDResponse {
      */
     maxConcurrentJobs: number;
 
+    /**
+     * How many more times to run a test case when the agent under test never responds:
+     * it never speaks on a call or never replies in a chat (0-10). 0 turns retries
+     * off. Failed checks and failures on Roark’s side are never retried.
+     *
+     * Each retry is a separate attempt, billed like any other, so a plan retrying N
+     * times can place up to N + 1 calls per test case. Every silent attempt stays on
+     * the run with its own call; the run settles once each test case has a final
+     * attempt, and the agent never spoke verdict is judged on each test case’s last
+     * attempt.
+     */
+    maxNoResponseRetries: number;
+
     /**
      * Maximum duration in seconds for each simulation
      */
@@ -1272,6 +1341,12 @@ export namespace SimulationRunPlanGetByIDResponse {
      */
     name: string;
 
+    /**
+     * Seconds a retry waits before it dials (30-600). Only used when
+     * `maxNoResponseRetries` is above 0.
+     */
+    noResponseRetryBackoffSeconds: number;
+
     /**
      * Personas included in this run plan. Only meaningful alongside `scenarios`.
      */
@@ -1466,12 +1541,6 @@ export interface SimulationRunPlanCreateParams {
    */
   maxSimulationDurationSeconds: number;
 
-  /**
-   * Metric definitions to include in this run plan. Reference each by `id` (UUID) or
-   * `slug`.
-   */
-  metrics: Array<SimulationRunPlanCreateParams.Metric>;
-
   /**
    * Name of the run plan
    */
@@ -1626,6 +1695,36 @@ export interface SimulationRunPlanCreateParams {
    */
   maxConcurrentJobs?: number;
 
+  /**
+   * How many more times to run a test case when the agent under test never responds:
+   * it never speaks on a call or never replies in a chat (0-10). 0 turns retries
+   * off. Failed checks and failures on Roark’s side are never retried.
+   *
+   * Each retry is a separate attempt, billed like any other, so a plan retrying N
+   * times can place up to N + 1 calls per test case. Every silent attempt stays on
+   * the run with its own call; the run settles once each test case has a final
+   * attempt, and the agent never spoke verdict is judged on each test case’s last
+   * attempt.
+   */
+  maxNoResponseRetries?: number;
+
+  /**
+   * Metric definitions to include in this run plan. Reference each by `id` (UUID) or
+   * `slug`.
+   *
+   * Optional when the attached `flows` carry the grading: metrics a flow declares
+   * itself (with `includeFlowMetrics`), or the Agent Expectations and Keypad Entry
+   * metrics a run adds for flows with expectations or expected keypad entries (with
+   * `includeAutomaticMetrics`). A plan with nothing to grade is rejected with a 400.
+   */
+  metrics?: Array<SimulationRunPlanCreateParams.Metric>;
+
+  /**
+   * Seconds a retry waits before it dials (30-600). Only used when
+   * `maxNoResponseRetries` is above 0.
+   */
+  noResponseRetryBackoffSeconds?: number;
+
   /**
    * Personas to include in this run plan. Required with `scenarios`; ignored with
    * `flows`, where each variant carries its own persona.
@@ -1649,47 +1748,6 @@ export namespace SimulationRunPlanCreateParams {
     id: string;
   }
 
-  export interface Metric {
-    /**
-     * Metric definition UUID. Provide either this or `slug`, not both.
-     */
-    id?: string;
-
-    /**
-     * Which side of an enriched run this metric is scored on. Only meaningful with
-     * `enrichWithLiveConversation: true`, where a run has both a simulated
-     * conversation and the customer's own live recording of it.
-     *
-     * Defaults to `SIMULATED`. Use `LIVE` for a metric that must be measured against
-     * the real recording (audio quality, provider latency) rather than the simulated
-     * leg. `null` means the same as omitting it, so a plan read back from GET can be
-     * sent straight to PUT.
-     */
-    conversationSource?: 'SIMULATED' | 'LIVE' | null;
-
-    /**
-     * Alias of `slug` accepted for backwards compatibility. Use `slug` for new
-     * integrations.
-     */
-    metricId?: string;
-
-    /**
-     * THE BAR, and the only thing that decides pass/fail. The share of the run's
-     * simulations that must pass this check, 0-100.
-     *
-     * Applied to this check alone and never pooled: silence duration at 40 and word
-     * count at 80 means the run fails unless 40% of sims clear silence AND 80% clear
-     * word count. Omit or `null` for the 80% default.
-     */
-    minPassRate?: number | null;
-
-    /**
-     * Stable metric slug (e.g. `customer_satisfaction`). Provide either this or `id`,
-     * not both.
-     */
-    slug?: string;
-  }
-
   /**
    * One customer flow attached to a run plan, and which of its ways of running you
    * cover.
@@ -1795,6 +1853,47 @@ export namespace SimulationRunPlanCreateParams {
     }
   }
 
+  export interface Metric {
+    /**
+     * Metric definition UUID. Provide either this or `slug`, not both.
+     */
+    id?: string;
+
+    /**
+     * Which side of an enriched run this metric is scored on. Only meaningful with
+     * `enrichWithLiveConversation: true`, where a run has both a simulated
+     * conversation and the customer's own live recording of it.
+     *
+     * Defaults to `SIMULATED`. Use `LIVE` for a metric that must be measured against
+     * the real recording (audio quality, provider latency) rather than the simulated
+     * leg. `null` means the same as omitting it, so a plan read back from GET can be
+     * sent straight to PUT.
+     */
+    conversationSource?: 'SIMULATED' | 'LIVE' | null;
+
+    /**
+     * Alias of `slug` accepted for backwards compatibility. Use `slug` for new
+     * integrations.
+     */
+    metricId?: string;
+
+    /**
+     * THE BAR, and the only thing that decides pass/fail. The share of the run's
+     * simulations that must pass this check, 0-100.
+     *
+     * Applied to this check alone and never pooled: silence duration at 40 and word
+     * count at 80 means the run fails unless 40% of sims clear silence AND 80% clear
+     * word count. Omit or `null` for the 80% default.
+     */
+    minPassRate?: number | null;
+
+    /**
+     * Stable metric slug (e.g. `customer_satisfaction`). Provide either this or `id`,
+     * not both.
+     */
+    slug?: string;
+  }
+
   export interface Persona {
     id: string;
   }
@@ -1938,6 +2037,19 @@ export interface SimulationRunPlanUpdateParams {
    */
   maxConcurrentJobs?: number;
 
+  /**
+   * How many more times to run a test case when the agent under test never responds:
+   * it never speaks on a call or never replies in a chat (0-10). 0 turns retries
+   * off. Failed checks and failures on Roark’s side are never retried.
+   *
+   * Each retry is a separate attempt, billed like any other, so a plan retrying N
+   * times can place up to N + 1 calls per test case. Every silent attempt stays on
+   * the run with its own call; the run settles once each test case has a final
+   * attempt, and the agent never spoke verdict is judged on each test case’s last
+   * attempt.
+   */
+  maxNoResponseRetries?: number;
+
   /**
    * Maximum duration in seconds for each simulation
    */
@@ -1954,6 +2066,12 @@ export interface SimulationRunPlanUpdateParams {
    */
   name?: string;
 
+  /**
+   * Seconds a retry waits before it dials (30-600). Only used when
+   * `maxNoResponseRetries` is above 0.
+   */
+  noResponseRetryBackoffSeconds?: number;
+
   /**
    * Personas to include in this run plan
    */

package/src/resources/simulation.ts

@@ -58,7 +58,6 @@ export class Simulation extends APIResource {
    *     ],
    *     direction: 'INBOUND',
    *     maxSimulationDurationSeconds: 300,
-   *     metrics: [{}],
    *   },
    * });
    * ```
@@ -269,12 +268,6 @@ export declare namespace SimulationRunParams {
        */
       maxSimulationDurationSeconds: number;
 
-      /**
-       * Metric definitions to include in this run plan. Reference each by `id` (UUID) or
-       * `slug`.
-       */
-      metrics: Array<Plan.Metric>;
-
       /**
        * The reference value of `comparisonProperty`, for example `NONE` for
        * `BACKGROUND_NOISE` or `NORMAL` for `SPEECH_PACE`: shown first in the results.
@@ -417,12 +410,42 @@ export declare namespace SimulationRunParams {
        */
       maxConcurrentJobs?: number;
 
+      /**
+       * How many more times to run a test case when the agent under test never responds:
+       * it never speaks on a call or never replies in a chat (0-10). 0 turns retries
+       * off. Failed checks and failures on Roark’s side are never retried.
+       *
+       * Each retry is a separate attempt, billed like any other, so a plan retrying N
+       * times can place up to N + 1 calls per test case. Every silent attempt stays on
+       * the run with its own call; the run settles once each test case has a final
+       * attempt, and the agent never spoke verdict is judged on each test case’s last
+       * attempt.
+       */
+      maxNoResponseRetries?: number;
+
+      /**
+       * Metric definitions to include in this run plan. Reference each by `id` (UUID) or
+       * `slug`.
+       *
+       * Optional when the attached `flows` carry the grading: metrics a flow declares
+       * itself (with `includeFlowMetrics`), or the Agent Expectations and Keypad Entry
+       * metrics a run adds for flows with expectations or expected keypad entries (with
+       * `includeAutomaticMetrics`). A plan with nothing to grade is rejected with a 400.
+       */
+      metrics?: Array<Plan.Metric>;
+
       /**
        * What to call this. Generated from the date when omitted, and required with
        * `saveAsPlan`.
        */
       name?: string;
 
+      /**
+       * Seconds a retry waits before it dials (30-600). Only used when
+       * `maxNoResponseRetries` is above 0.
+       */
+      noResponseRetryBackoffSeconds?: number;
+
       /**
        * Personas to include in this run plan. Required with `scenarios`; ignored with
        * `flows`, where each variant carries its own persona.
@@ -446,47 +469,6 @@ export declare namespace SimulationRunParams {
         id: string;
       }
 
-      export interface Metric {
-        /**
-         * Metric definition UUID. Provide either this or `slug`, not both.
-         */
-        id?: string;
-
-        /**
-         * Which side of an enriched run this metric is scored on. Only meaningful with
-         * `enrichWithLiveConversation: true`, where a run has both a simulated
-         * conversation and the customer's own live recording of it.
-         *
-         * Defaults to `SIMULATED`. Use `LIVE` for a metric that must be measured against
-         * the real recording (audio quality, provider latency) rather than the simulated
-         * leg. `null` means the same as omitting it, so a plan read back from GET can be
-         * sent straight to PUT.
-         */
-        conversationSource?: 'SIMULATED' | 'LIVE' | null;
-
-        /**
-         * Alias of `slug` accepted for backwards compatibility. Use `slug` for new
-         * integrations.
-         */
-        metricId?: string;
-
-        /**
-         * THE BAR, and the only thing that decides pass/fail. The share of the run's
-         * simulations that must pass this check, 0-100.
-         *
-         * Applied to this check alone and never pooled: silence duration at 40 and word
-         * count at 80 means the run fails unless 40% of sims clear silence AND 80% clear
-         * word count. Omit or `null` for the 80% default.
-         */
-        minPassRate?: number | null;
-
-        /**
-         * Stable metric slug (e.g. `customer_satisfaction`). Provide either this or `id`,
-         * not both.
-         */
-        slug?: string;
-      }
-
       /**
        * One customer flow attached to a run plan, and which of its ways of running you
        * cover.
@@ -592,6 +574,47 @@ export declare namespace SimulationRunParams {
         }
       }
 
+      export interface Metric {
+        /**
+         * Metric definition UUID. Provide either this or `slug`, not both.
+         */
+        id?: string;
+
+        /**
+         * Which side of an enriched run this metric is scored on. Only meaningful with
+         * `enrichWithLiveConversation: true`, where a run has both a simulated
+         * conversation and the customer's own live recording of it.
+         *
+         * Defaults to `SIMULATED`. Use `LIVE` for a metric that must be measured against
+         * the real recording (audio quality, provider latency) rather than the simulated
+         * leg. `null` means the same as omitting it, so a plan read back from GET can be
+         * sent straight to PUT.
+         */
+        conversationSource?: 'SIMULATED' | 'LIVE' | null;
+
+        /**
+         * Alias of `slug` accepted for backwards compatibility. Use `slug` for new
+         * integrations.
+         */
+        metricId?: string;
+
+        /**
+         * THE BAR, and the only thing that decides pass/fail. The share of the run's
+         * simulations that must pass this check, 0-100.
+         *
+         * Applied to this check alone and never pooled: silence duration at 40 and word
+         * count at 80 means the run fails unless 40% of sims clear silence AND 80% clear
+         * word count. Omit or `null` for the 80% default.
+         */
+        minPassRate?: number | null;
+
+        /**
+         * Stable metric slug (e.g. `customer_satisfaction`). Provide either this or `id`,
+         * not both.
+         */
+        slug?: string;
+      }
+
       export interface Persona {
         id: string;
       }
@@ -822,6 +845,19 @@ export declare namespace SimulationRunParams {
      */
     maxConcurrentJobs?: number;
 
+    /**
+     * How many more times to run a test case when the agent under test never responds:
+     * it never speaks on a call or never replies in a chat (0-10). 0 turns retries
+     * off. Failed checks and failures on Roark’s side are never retried.
+     *
+     * Each retry is a separate attempt, billed like any other, so a plan retrying N
+     * times can place up to N + 1 calls per test case. Every silent attempt stays on
+     * the run with its own call; the run settles once each test case has a final
+     * attempt, and the agent never spoke verdict is judged on each test case’s last
+     * attempt.
+     */
+    maxNoResponseRetries?: number;
+
     /**
      * Defaults to the template's `defaultMaxSimulationDurationSeconds`, as returned by
      * GET /v1/simulation/template.
@@ -834,6 +870,12 @@ export declare namespace SimulationRunParams {
      */
     name?: string;
 
+    /**
+     * Seconds a retry waits before it dials (30-600). Only used when
+     * `maxNoResponseRetries` is above 0.
+     */
+    noResponseRetryBackoffSeconds?: number;
+
     /**
      * For `question-answer-check`: the persona that asks the questions.
      */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '4.19.0'; // x-release-please-version
+export const VERSION = '4.21.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.19.0";
+export declare const VERSION = "4.21.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.19.0";
+export declare const VERSION = "4.21.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '4.19.0'; // x-release-please-version
+exports.VERSION = '4.21.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '4.19.0'; // x-release-please-version
+export const VERSION = '4.21.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map