@roarkanalytics/sdk 2.23.1 → 2.25.0

package/src/resources/index.ts

@@ -34,21 +34,7 @@ export {
   type CallGetTranscriptParams,
   type CallListMetricsParams,
 } from './call';
-export {
-  Evaluation,
-  type EvaluationCreateEvaluatorResponse,
-  type EvaluationCreateJobResponse,
-  type EvaluationGetEvaluatorByIDResponse,
-  type EvaluationGetJobResponse,
-  type EvaluationListEvaluatorsResponse,
-  type EvaluationListJobRunsResponse,
-  type EvaluationUpdateEvaluatorResponse,
-  type EvaluationCreateEvaluatorParams,
-  type EvaluationCreateJobParams,
-  type EvaluationListEvaluatorsParams,
-  type EvaluationListJobRunsParams,
-  type EvaluationUpdateEvaluatorParams,
-} from './evaluation';
+export { Evaluation } from './evaluation';
 export {
   HTTPRequestDefinition,
   type HTTPRequestDefinitionCreateResponse,
@@ -60,14 +46,32 @@ export {
   type HTTPRequestDefinitionListParams,
 } from './http-request-definition';
 export { Health, type HealthGetResponse } from './health';
+export { Integrations } from './integrations';
+export {
+  Metric,
+  type MetricCreateDefinitionResponse,
+  type MetricListDefinitionsResponse,
+  type MetricCreateDefinitionParams,
+} from './metric';
+export {
+  MetricCollectionJob,
+  type MetricCollectionJobCreateResponse,
+  type MetricCollectionJobListResponse,
+  type MetricCollectionJobGetByIDResponse,
+  type MetricCollectionJobCreateParams,
+  type MetricCollectionJobListParams,
+} from './metric-collection-job';
 export {
-  Integrations,
-  type IntegrationCreateRetellCallResponse,
-  type IntegrationCreateVapiCallResponse,
-  type IntegrationCreateRetellCallParams,
-  type IntegrationCreateVapiCallParams,
-} from './integrations';
-export { Metric, type MetricListDefinitionsResponse } from './metric';
+  MetricPolicy,
+  type MetricPolicyCreateResponse,
+  type MetricPolicyUpdateResponse,
+  type MetricPolicyListResponse,
+  type MetricPolicyDeleteResponse,
+  type MetricPolicyGetByIDResponse,
+  type MetricPolicyCreateParams,
+  type MetricPolicyUpdateParams,
+  type MetricPolicyListParams,
+} from './metric-policy';
 export {
   SimulationJob,
   type SimulationJobGetByIDResponse,
@@ -101,6 +105,7 @@ export {
   type SimulationRunPlanJobGetByIDResponse,
   type SimulationRunPlanJobStartResponse,
   type SimulationRunPlanJobListParams,
+  type SimulationRunPlanJobStartParams,
 } from './simulation-run-plan-job';
 export {
   SimulationScenario,

package/src/resources/integrations.ts

@@ -1,135 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
-import { APIPromise } from '../core/api-promise';
-import { RequestOptions } from '../internal/request-options';
 
-export class Integrations extends APIResource {
-  /**
-   * Process and upload a Retell call to Roark evaluation
-   *
-   * @example
-   * ```ts
-   * const response = await client.integrations.createRetellCall(
-   *   { retellCallEndedPayload: { event: 'bar', call: 'bar' } },
-   * );
-   * ```
-   */
-  createRetellCall(
-    body: IntegrationCreateRetellCallParams,
-    options?: RequestOptions,
-  ): APIPromise<IntegrationCreateRetellCallResponse> {
-    return this._client.post('/v1/retell/call', { body, ...options });
-  }
-
-  /**
-   * Process and upload a VAPI call to Roark evaluation
-   *
-   * @example
-   * ```ts
-   * const response = await client.integrations.createVapiCall({
-   *   vapiEndOfCallReportPayload: {
-   *     call: 'bar',
-   *     type: 'bar',
-   *     status: 'bar',
-   *     assistant: 'bar',
-   *     customer: 'bar',
-   *     phoneNumber: 'bar',
-   *     artifact: 'bar',
-   *     startedAt: 'bar',
-   *     endedAt: 'bar',
-   *     endedReason: 'bar',
-   *   },
-   * });
-   * ```
-   */
-  createVapiCall(
-    body: IntegrationCreateVapiCallParams,
-    options?: RequestOptions,
-  ): APIPromise<IntegrationCreateVapiCallResponse> {
-    return this._client.post('/v1/vapi/call', { body, ...options });
-  }
-}
-
-export interface IntegrationCreateRetellCallResponse {
-  /**
-   * Retell call upload response
-   */
-  data: IntegrationCreateRetellCallResponse.Data;
-}
-
-export namespace IntegrationCreateRetellCallResponse {
-  /**
-   * Retell call upload response
-   */
-  export interface Data {
-    /**
-     * ID of the uploaded call
-     */
-    callId: string;
-  }
-}
-
-export interface IntegrationCreateVapiCallResponse {
-  /**
-   * Vapi call upload response
-   */
-  data: IntegrationCreateVapiCallResponse.Data;
-}
-
-export namespace IntegrationCreateVapiCallResponse {
-  /**
-   * Vapi call upload response
-   */
-  export interface Data {
-    /**
-     * ID of the uploaded call
-     */
-    callId: string;
-  }
-}
-
-export interface IntegrationCreateRetellCallParams {
-  /**
-   * Raw Retell data forwarded directly from the Retell call_ended webhook
-   */
-  retellCallEndedPayload: { [key: string]: unknown };
-
-  /**
-   * Optional metadata (key-value pairs) to include with the call. Useful for
-   * filtering and display in call details.
-   */
-  properties?: { [key: string]: unknown };
-
-  /**
-   * Skip already imported Retell calls with the same Retell call id.
-   */
-  skipAlreadyImported?: boolean;
-}
-
-export interface IntegrationCreateVapiCallParams {
-  /**
-   * Raw Vapi data forwarded directly from the Vapi end-of-call-report webhook
-   */
-  vapiEndOfCallReportPayload: { [key: string]: unknown };
-
-  /**
-   * Optional metadata (key-value pairs) to include with the call. Useful for
-   * filtering and display in call details.
-   */
-  properties?: { [key: string]: unknown };
-
-  /**
-   * Skip already imported Vapi calls with the same Vapi call id.
-   */
-  skipAlreadyImported?: boolean;
-}
-
-export declare namespace Integrations {
-  export {
-    type IntegrationCreateRetellCallResponse as IntegrationCreateRetellCallResponse,
-    type IntegrationCreateVapiCallResponse as IntegrationCreateVapiCallResponse,
-    type IntegrationCreateRetellCallParams as IntegrationCreateRetellCallParams,
-    type IntegrationCreateVapiCallParams as IntegrationCreateVapiCallParams,
-  };
-}
+export class Integrations extends APIResource {}

package/src/resources/metric-collection-job.ts

@@ -0,0 +1,307 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class MetricCollectionJob extends APIResource {
+  /**
+   * Creates a metric collection job for the specified calls and metrics, then
+   * triggers processing.
+   */
+  create(
+    body: MetricCollectionJobCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<MetricCollectionJobCreateResponse> {
+    return this._client.post('/v1/metric/collection-jobs', { body, ...options });
+  }
+
+  /**
+   * Returns a paginated list of metric collection jobs for the project.
+   */
+  list(
+    query: MetricCollectionJobListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MetricCollectionJobListResponse> {
+    return this._client.get('/v1/metric/collection-jobs', { query, ...options });
+  }
+
+  /**
+   * Returns a specific metric collection job with progress information.
+   */
+  getByID(jobID: string, options?: RequestOptions): APIPromise<MetricCollectionJobGetByIDResponse> {
+    return this._client.get(path`/v1/metric/collection-jobs/${jobID}`, options);
+  }
+}
+
+export interface MetricCollectionJobCreateResponse {
+  /**
+   * A metric collection job that processes metrics for calls
+   */
+  data: MetricCollectionJobCreateResponse.Data;
+}
+
+export namespace MetricCollectionJobCreateResponse {
+  /**
+   * A metric collection job that processes metrics for calls
+   */
+  export interface Data {
+    /**
+     * Unique identifier of the metric collection job
+     */
+    id: string;
+
+    /**
+     * When the job completed
+     */
+    completedAt: string | null;
+
+    /**
+     * Number of successfully completed items
+     */
+    completedItems: number;
+
+    /**
+     * When the job was created
+     */
+    createdAt: string;
+
+    /**
+     * Error message if the job failed
+     */
+    errorMessage: string | null;
+
+    /**
+     * Number of failed items
+     */
+    failedItems: number;
+
+    /**
+     * When the job started processing
+     */
+    startedAt: string | null;
+
+    /**
+     * Current status of the job
+     */
+    status: 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELED';
+
+    /**
+     * Total number of call-metric pairs to process
+     */
+    totalItems: number;
+
+    /**
+     * What triggered this job
+     */
+    triggeredBy: 'USER_MANUAL' | 'USER_API' | 'METRIC_POLICY' | 'SIMULATION';
+
+    /**
+     * When the job was last updated
+     */
+    updatedAt: string;
+  }
+}
+
+/**
+ * Paginated list of metric collection jobs
+ */
+export interface MetricCollectionJobListResponse {
+  data: Array<MetricCollectionJobListResponse.Data>;
+
+  pagination: MetricCollectionJobListResponse.Pagination;
+}
+
+export namespace MetricCollectionJobListResponse {
+  /**
+   * A metric collection job that processes metrics for calls
+   */
+  export interface Data {
+    /**
+     * Unique identifier of the metric collection job
+     */
+    id: string;
+
+    /**
+     * When the job completed
+     */
+    completedAt: string | null;
+
+    /**
+     * Number of successfully completed items
+     */
+    completedItems: number;
+
+    /**
+     * When the job was created
+     */
+    createdAt: string;
+
+    /**
+     * Error message if the job failed
+     */
+    errorMessage: string | null;
+
+    /**
+     * Number of failed items
+     */
+    failedItems: number;
+
+    /**
+     * When the job started processing
+     */
+    startedAt: string | null;
+
+    /**
+     * Current status of the job
+     */
+    status: 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELED';
+
+    /**
+     * Total number of call-metric pairs to process
+     */
+    totalItems: number;
+
+    /**
+     * What triggered this job
+     */
+    triggeredBy: 'USER_MANUAL' | 'USER_API' | 'METRIC_POLICY' | 'SIMULATION';
+
+    /**
+     * When the job was last updated
+     */
+    updatedAt: string;
+  }
+
+  export interface Pagination {
+    /**
+     * Whether there are more items to fetch
+     */
+    hasMore: boolean;
+
+    /**
+     * Cursor for the next page of items
+     */
+    nextCursor: string | null;
+
+    /**
+     * Total number of items
+     */
+    total: number;
+  }
+}
+
+export interface MetricCollectionJobGetByIDResponse {
+  /**
+   * A metric collection job that processes metrics for calls
+   */
+  data: MetricCollectionJobGetByIDResponse.Data;
+}
+
+export namespace MetricCollectionJobGetByIDResponse {
+  /**
+   * A metric collection job that processes metrics for calls
+   */
+  export interface Data {
+    /**
+     * Unique identifier of the metric collection job
+     */
+    id: string;
+
+    /**
+     * When the job completed
+     */
+    completedAt: string | null;
+
+    /**
+     * Number of successfully completed items
+     */
+    completedItems: number;
+
+    /**
+     * When the job was created
+     */
+    createdAt: string;
+
+    /**
+     * Error message if the job failed
+     */
+    errorMessage: string | null;
+
+    /**
+     * Number of failed items
+     */
+    failedItems: number;
+
+    /**
+     * When the job started processing
+     */
+    startedAt: string | null;
+
+    /**
+     * Current status of the job
+     */
+    status: 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELED';
+
+    /**
+     * Total number of call-metric pairs to process
+     */
+    totalItems: number;
+
+    /**
+     * What triggered this job
+     */
+    triggeredBy: 'USER_MANUAL' | 'USER_API' | 'METRIC_POLICY' | 'SIMULATION';
+
+    /**
+     * When the job was last updated
+     */
+    updatedAt: string;
+  }
+}
+
+export interface MetricCollectionJobCreateParams {
+  /**
+   * Call IDs to collect metrics for
+   */
+  callIds: Array<string>;
+
+  /**
+   * Metric definitions to collect
+   */
+  metrics: Array<MetricCollectionJobCreateParams.Metric>;
+}
+
+export namespace MetricCollectionJobCreateParams {
+  export interface Metric {
+    id: string;
+  }
+}
+
+export interface MetricCollectionJobListParams {
+  /**
+   * Cursor for pagination - use the nextCursor value from a previous response
+   */
+  after?: string;
+
+  /**
+   * Maximum number of jobs to return (default: 20, max: 50)
+   */
+  limit?: number;
+
+  /**
+   * Filter by job status
+   */
+  status?: 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELED';
+}
+
+export declare namespace MetricCollectionJob {
+  export {
+    type MetricCollectionJobCreateResponse as MetricCollectionJobCreateResponse,
+    type MetricCollectionJobListResponse as MetricCollectionJobListResponse,
+    type MetricCollectionJobGetByIDResponse as MetricCollectionJobGetByIDResponse,
+    type MetricCollectionJobCreateParams as MetricCollectionJobCreateParams,
+    type MetricCollectionJobListParams as MetricCollectionJobListParams,
+  };
+}