@roarkanalytics/sdk 3.12.0 → 3.13.0

package/src/resources/simulation-persona.ts

@@ -234,9 +234,10 @@ export namespace SimulationPersonaCreateResponse {
 
     /**
      * Controls how quickly the persona responds to pauses in conversation (QUICK,
-     * NORMAL, RELAXED)
+     * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+     * for several seconds.
      */
-    responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK';
+    responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
 
     /**
      * Speech clarity of the persona
@@ -462,9 +463,10 @@ export namespace SimulationPersonaUpdateResponse {
 
     /**
      * Controls how quickly the persona responds to pauses in conversation (QUICK,
-     * NORMAL, RELAXED)
+     * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+     * for several seconds.
      */
-    responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK';
+    responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
 
     /**
      * Speech clarity of the persona
@@ -692,9 +694,10 @@ export namespace SimulationPersonaListResponse {
 
     /**
      * Controls how quickly the persona responds to pauses in conversation (QUICK,
-     * NORMAL, RELAXED)
+     * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+     * for several seconds.
      */
-    responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK';
+    responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
 
     /**
      * Speech clarity of the persona
@@ -937,9 +940,10 @@ export namespace SimulationPersonaGetByIDResponse {
 
     /**
      * Controls how quickly the persona responds to pauses in conversation (QUICK,
-     * NORMAL, RELAXED)
+     * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+     * for several seconds.
      */
-    responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK';
+    responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
 
     /**
      * Speech clarity of the persona
@@ -1167,9 +1171,10 @@ export interface SimulationPersonaCreateParams {
 
   /**
    * Controls how quickly the persona responds to pauses in conversation (QUICK,
-   * NORMAL, RELAXED)
+   * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+   * for several seconds.
    */
-  responseTiming?: 'RELAXED' | 'NORMAL' | 'QUICK';
+  responseTiming?: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
 
   /**
    * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
@@ -1374,9 +1379,10 @@ export interface SimulationPersonaUpdateParams {
 
   /**
    * Controls how quickly the persona responds to pauses in conversation (QUICK,
-   * NORMAL, RELAXED)
+   * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+   * for several seconds.
    */
-  responseTiming?: 'RELAXED' | 'NORMAL' | 'QUICK';
+  responseTiming?: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
 
   /**
    * Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)

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

@@ -23,6 +23,23 @@ export class SimulationRunPlanJob extends APIResource {
     return this._client.get('/v1/simulation/plan/jobs', { query, ...options });
   }
 
+  /**
+   * Stops a run that has not finished yet. Already-finished runs are left alone.
+   *
+   * Intended for CI: when a pipeline is cancelled or superseded, cancelling the run
+   * stops it placing calls you no longer need. Safe to call more than once.
+   *
+   * @example
+   * ```ts
+   * const response = await client.simulationRunPlanJob.cancel(
+   *   '7f3e4d2c-8a91-4b5c-9e6f-1a2b3c4d5e6f',
+   * );
+   * ```
+   */
+  cancel(jobID: string, options?: RequestOptions): APIPromise<SimulationRunPlanJobCancelResponse> {
+    return this._client.post(path`/v1/simulation/plan/job/${jobID}/cancel`, options);
+  }
+
   /**
    * Retrieve details of a simulation plan job including all associated simulation
    * jobs (calls)
@@ -144,6 +161,45 @@ export namespace SimulationRunPlanJobListResponse {
   }
 }
 
+export interface SimulationRunPlanJobCancelResponse {
+  /**
+   * Result of cancelling a simulation plan job
+   */
+  data: SimulationRunPlanJobCancelResponse.Data;
+}
+
+export namespace SimulationRunPlanJobCancelResponse {
+  /**
+   * Result of cancelling a simulation plan job
+   */
+  export interface Data {
+    /**
+     * True when this request stopped the run. False when it had already finished,
+     * which is not an error.
+     */
+    cancelled: boolean;
+
+    simulationRunPlanJobId: string;
+
+    /**
+     * The job status after the request. Unchanged when the run had already finished.
+     */
+    status:
+      | 'PENDING'
+      | 'QUEUED'
+      | 'CREATING_SNAPSHOTS'
+      | 'CREATING_SIMULATIONS'
+      | 'PREPARING_CAPACITY'
+      | 'RUNNING_SIMULATIONS'
+      | 'COMPLETED'
+      | 'FAILED'
+      | 'TIMED_OUT'
+      | 'CANCELLED'
+      | 'CANCELLING'
+      | 'ENDING_SIMULATIONS';
+  }
+}
+
 export interface SimulationRunPlanJobGetByIDResponse {
   /**
    * Simulation run plan job with all associated simulation jobs
@@ -202,6 +258,12 @@ export namespace SimulationRunPlanJobGetByIDResponse {
      * When the job started
      */
     startedAt?: string | null;
+
+    /**
+     * Pass/fail verdict for the run, judged against the success criteria pinned on the
+     * run plan when the run started.
+     */
+    verdict?: Data.Verdict | null;
   }
 
   export namespace Data {
@@ -496,9 +558,10 @@ export namespace SimulationRunPlanJobGetByIDResponse {
 
         /**
          * Controls how quickly the persona responds to pauses in conversation (QUICK,
-         * NORMAL, RELAXED)
+         * NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor
+         * for several seconds.
          */
-        responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK';
+        responseTiming: 'RELAXED' | 'NORMAL' | 'QUICK' | 'BARGE_IN';
 
         /**
          * Speech clarity of the persona
@@ -578,6 +641,141 @@ export namespace SimulationRunPlanJobGetByIDResponse {
         description?: string | null;
       }
     }
+
+    /**
+     * Pass/fail verdict for the run, judged against the success criteria pinned on the
+     * run plan when the run started.
+     */
+    export interface Verdict {
+      /**
+       * Every check the run was judged on, with its rate and the minimum it had to
+       * reach.
+       */
+      checks: Array<Verdict.Check>;
+
+      /**
+       * Every criterion the run missed. Empty when it passed.
+       */
+      failures: Array<
+        Verdict.UnionMember0 | Verdict.UnionMember1 | Verdict.UnionMember2 | Verdict.UnionMember3
+      >;
+
+      /**
+       * Whether every check cleared its own `minPassRate` (and the run completed with
+       * full coverage). Use this as the CI exit status.
+       *
+       * Never derived from `score`: a run can score 95 and still fail, or score 40 and
+       * still pass.
+       */
+      passed: boolean;
+
+      /**
+       * The run's headline quality number, 0-100: the mean of each check's own pass
+       * rate.
+       *
+       * REPORTING ONLY, for dashboards and trend lines. Nothing is judged against it.
+       * Null when nothing was evaluated.
+       */
+      score: number | null;
+    }
+
+    export namespace Verdict {
+      /**
+       * How one pass/fail metric did. Present for every check, passing or not.
+       */
+      export interface Check {
+        evaluatedSims: number;
+
+        /**
+         * Whether `minPassRate` is the 80% default (`true`) or a minimum this metric set
+         * for itself.
+         */
+        inherited: boolean;
+
+        metricDefinitionId: string;
+
+        /**
+         * THE BAR it was judged against: the share of the run's simulations it had to
+         * pass.
+         */
+        minPassRate: number;
+
+        /**
+         * This check's own pass rate, 0-100: the share of sims it evaluated that passed
+         * it. Null when it evaluated nothing.
+         */
+        passRate: number | null;
+
+        /**
+         * `passRate >= minPassRate`.
+         */
+        passed: boolean;
+
+        passedSims: number;
+
+        metricName?: string | null;
+      }
+
+      export interface UnionMember0 {
+        /**
+         * The status the run actually ended in.
+         */
+        status:
+          | 'PENDING'
+          | 'QUEUED'
+          | 'CREATING_SNAPSHOTS'
+          | 'CREATING_SIMULATIONS'
+          | 'PREPARING_CAPACITY'
+          | 'RUNNING_SIMULATIONS'
+          | 'COMPLETED'
+          | 'FAILED'
+          | 'TIMED_OUT'
+          | 'CANCELLED'
+          | 'CANCELLING'
+          | 'ENDING_SIMULATIONS';
+
+        type: 'RUN_NOT_COMPLETED';
+      }
+
+      export interface UnionMember1 {
+        evaluatedCalls: number;
+
+        expectedCalls: number;
+
+        type: 'INCOMPLETE_COVERAGE';
+      }
+
+      export interface UnionMember2 {
+        metricDefinitionId: string;
+
+        type: 'METRIC_NOT_EVALUATED';
+
+        /**
+         * The check’s name, for rendering the failure.
+         */
+        metricName?: string | null;
+      }
+
+      export interface UnionMember3 {
+        /**
+         * Whether the missed minimum was the 80% default (`true`) or this metric's own.
+         */
+        inherited: boolean;
+
+        metricDefinitionId: string;
+
+        minPassRate: number;
+
+        passRate: number;
+
+        type: 'METRIC_BELOW_MIN_PASS_RATE';
+
+        /**
+         * The check’s name, for rendering the failure.
+         */
+        metricName?: string | null;
+      }
+    }
   }
 }
 
@@ -745,6 +943,7 @@ export namespace SimulationRunPlanJobStartParams {
 export declare namespace SimulationRunPlanJob {
   export {
     type SimulationRunPlanJobListResponse as SimulationRunPlanJobListResponse,
+    type SimulationRunPlanJobCancelResponse as SimulationRunPlanJobCancelResponse,
     type SimulationRunPlanJobGetByIDResponse as SimulationRunPlanJobGetByIDResponse,
     type SimulationRunPlanJobStartResponse as SimulationRunPlanJobStartResponse,
     type SimulationRunPlanJobListParams as SimulationRunPlanJobListParams,

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

@@ -342,6 +342,12 @@ export namespace SimulationRunPlanCreateResponse {
          * default, SIMULATED.
          */
         conversationSource: 'SIMULATED' | 'LIVE' | null;
+
+        /**
+         * THE BAR. The share of the run's simulations (0-100) that must pass this check.
+         * `null` means the 80% default.
+         */
+        minPassRate: number | null;
       }
 
       export interface Persona {
@@ -624,6 +630,12 @@ export namespace SimulationRunPlanUpdateResponse {
        * default, SIMULATED.
        */
       conversationSource: 'SIMULATED' | 'LIVE' | null;
+
+      /**
+       * THE BAR. The share of the run's simulations (0-100) that must pass this check.
+       * `null` means the 80% default.
+       */
+      minPassRate: number | null;
     }
 
     export interface Persona {
@@ -870,6 +882,12 @@ export namespace SimulationRunPlanListResponse {
        * default, SIMULATED.
        */
       conversationSource: 'SIMULATED' | 'LIVE' | null;
+
+      /**
+       * THE BAR. The share of the run's simulations (0-100) that must pass this check.
+       * `null` means the 80% default.
+       */
+      minPassRate: number | null;
     }
 
     export interface Persona {
@@ -1144,6 +1162,12 @@ export namespace SimulationRunPlanGetByIDResponse {
        * default, SIMULATED.
        */
       conversationSource: 'SIMULATED' | 'LIVE' | null;
+
+      /**
+       * THE BAR. The share of the run's simulations (0-100) that must pass this check.
+       * `null` means the 80% default.
+       */
+      minPassRate: number | null;
     }
 
     export interface Persona {
@@ -1326,6 +1350,16 @@ export namespace SimulationRunPlanCreateParams {
      */
     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.
@@ -1629,6 +1663,16 @@ export namespace SimulationRunPlanUpdateParams {
      */
     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.

package/src/resources/simulation.ts

@@ -312,6 +312,16 @@ export declare namespace SimulationRunParams {
          */
         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.

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '3.12.0'; // x-release-please-version
+export const VERSION = '3.13.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "3.12.0";
+export declare const VERSION = "3.13.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 = '3.12.0'; // x-release-please-version
+exports.VERSION = '3.13.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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