@roarkanalytics/sdk 5.9.0 → 5.11.0

package/src/resources/index.ts

@@ -81,8 +81,11 @@ export {
   Call,
   type CallCreateResponse,
   type CallListResponse,
+  type CallDeleteResponse,
   type CallAppendToolInvocationsResponse,
+  type CallBatchDeleteResponse,
   type CallGetByIDResponse,
+  type CallGetCostResponse,
   type CallGetTranscriptResponse,
   type CallListMetricsResponse,
   type CallListSentimentRunsResponse,
@@ -90,6 +93,7 @@ export {
   type CallCreateParams,
   type CallListParams,
   type CallAppendToolInvocationsParams,
+  type CallBatchDeleteParams,
   type CallGetTranscriptParams,
   type CallListMetricsParams,
   type CallUpdatePropertiesParams,
@@ -287,6 +291,7 @@ export {
   type SimulationRunPlanJobCancelResponse,
   type SimulationRunPlanJobCreateDebriefResponse,
   type SimulationRunPlanJobGetByIDResponse,
+  type SimulationRunPlanJobGetCostResponse,
   type SimulationRunPlanJobGetResultsResponse,
   type SimulationRunPlanJobStartResponse,
   type SimulationRunPlanJobListParams,

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

@@ -81,6 +81,24 @@ export class SimulationRunPlanJob extends APIResource {
     return this._client.get(path`/v1/simulation/plan/job/${jobID}`, options);
   }
 
+  /**
+   * The billable spend for one simulation run (run plan job), split by cost type,
+   * with the spend of each simulated call in it. Safe to call while the run is in
+   * progress: totals reflect the costs recorded so far. Amounts are billable spend
+   * only, in exact micro-dollars (`\*UsdMicros`) and dollars (`\*Usd`, for display).
+   * Requires an API key with the `billing:read` permission.
+   *
+   * @example
+   * ```ts
+   * const response = await client.simulationRunPlanJob.getCost(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
+   */
+  getCost(jobID: string, options?: RequestOptions): APIPromise<SimulationRunPlanJobGetCostResponse> {
+    return this._client.get(path`/v1/simulation/plan/job/${jobID}/cost`, options);
+  }
+
   /**
    * Everything the run report shows, in one request: the summary and score, the
    * pass/fail verdict, per-metric aggregates, every simulation with its check
@@ -1552,6 +1570,128 @@ export namespace SimulationRunPlanJobGetByIDResponse {
   }
 }
 
+export interface SimulationRunPlanJobGetCostResponse {
+  data: SimulationRunPlanJobGetCostResponse.Data;
+}
+
+export namespace SimulationRunPlanJobGetCostResponse {
+  export interface Data {
+    /**
+     * Spend by cost type. Sums to totalUsdMicros.
+     */
+    breakdown: Array<Data.Breakdown>;
+
+    /**
+     * Spend per simulated call in the run.
+     */
+    calls: Array<Data.Call>;
+
+    currency: 'usd';
+
+    jobId: string;
+
+    totalUsd: number;
+
+    /**
+     * Total billable spend for the run, in micro-dollars.
+     */
+    totalUsdMicros: number;
+  }
+
+  export namespace Data {
+    export interface Breakdown {
+      /**
+       * The same figure in US dollars.
+       */
+      amountUsd: number;
+
+      /**
+       * Billable spend for this type, in micro-dollars.
+       */
+      amountUsdMicros: number;
+
+      /**
+       * Units billed (see the line items for the unit).
+       */
+      quantity: number;
+
+      /**
+       * The cost source, e.g. SIM_PLATFORM_FEE, SIM_LLM, METRIC.
+       */
+      source:
+        | 'SIM_PLATFORM_FEE'
+        | 'SIM_TTS'
+        | 'SIM_STT'
+        | 'SIM_LLM'
+        | 'SIM_TELEPHONY'
+        | 'METRIC'
+        | 'TRANSCRIPTION'
+        | 'INTERNAL_LLM'
+        | 'INTERNAL_STT';
+
+      /**
+       * SIMULATION or POST_CALL.
+       */
+      surface: 'SIMULATION' | 'POST_CALL';
+    }
+
+    export interface Call {
+      amountUsd: number;
+
+      amountUsdMicros: number;
+
+      breakdown: Array<Call.Breakdown>;
+
+      /**
+       * The call (voice runs) or chat (chat runs) the spend is attributed to. Null for
+       * costs incurred before the conversation existed; use simulationJobId to join
+       * those.
+       */
+      conversationId: string | null;
+
+      simulationJobId: string | null;
+    }
+
+    export namespace Call {
+      export interface Breakdown {
+        /**
+         * The same figure in US dollars.
+         */
+        amountUsd: number;
+
+        /**
+         * Billable spend for this type, in micro-dollars.
+         */
+        amountUsdMicros: number;
+
+        /**
+         * Units billed (see the line items for the unit).
+         */
+        quantity: number;
+
+        /**
+         * The cost source, e.g. SIM_PLATFORM_FEE, SIM_LLM, METRIC.
+         */
+        source:
+          | 'SIM_PLATFORM_FEE'
+          | 'SIM_TTS'
+          | 'SIM_STT'
+          | 'SIM_LLM'
+          | 'SIM_TELEPHONY'
+          | 'METRIC'
+          | 'TRANSCRIPTION'
+          | 'INTERNAL_LLM'
+          | 'INTERNAL_STT';
+
+        /**
+         * SIMULATION or POST_CALL.
+         */
+        surface: 'SIMULATION' | 'POST_CALL';
+      }
+    }
+  }
+}
+
 export interface SimulationRunPlanJobGetResultsResponse {
   /**
    * Everything the run report shows, in one response.
@@ -2882,6 +3022,7 @@ export declare namespace SimulationRunPlanJob {
     type SimulationRunPlanJobCancelResponse as SimulationRunPlanJobCancelResponse,
     type SimulationRunPlanJobCreateDebriefResponse as SimulationRunPlanJobCreateDebriefResponse,
     type SimulationRunPlanJobGetByIDResponse as SimulationRunPlanJobGetByIDResponse,
+    type SimulationRunPlanJobGetCostResponse as SimulationRunPlanJobGetCostResponse,
     type SimulationRunPlanJobGetResultsResponse as SimulationRunPlanJobGetResultsResponse,
     type SimulationRunPlanJobStartResponse as SimulationRunPlanJobStartResponse,
     type SimulationRunPlanJobListParams as SimulationRunPlanJobListParams,

package/src/resources/usage.ts

@@ -9,8 +9,10 @@ export class Usage extends APIResource {
    * Report billable usage and cost for the organization over a time window, broken
    * down by project (highest spend first). Pass `from`/`to` as ISO 8601 timestamps;
    * optionally pass `projectId` to scope the report to one project. Amounts are
-   * billable spend only (what we absorb is never included). Authenticated by an
-   * organization API key with the `usage:read` permission.
+   * billable spend only (what we absorb is never included). Authenticated by either
+   * an organization API key with the `usage:read` permission (any project in the
+   * organization), or a project API key with the `billing:read` permission (that
+   * key's own project only; any other `projectId` is a 403).
    *
    * @example
    * ```ts

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '5.9.0'; // x-release-please-version
+export const VERSION = '5.11.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/version.d.ts

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

package/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/version.js

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

package/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}

package/version.mjs

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

package/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}