@roarkanalytics/sdk 0.328.0 → 0.330.0

package/resources/integrations.mjs

@@ -1,5 +1,42 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../resource.mjs";
 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, options) {
+        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, options) {
+        return this._client.post('/v1/vapi/call', { body, ...options });
+    }
 }
 //# sourceMappingURL=integrations.mjs.map

package/resources/integrations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"integrations.mjs","sourceRoot":"","sources":["../src/resources/integrations.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAEtB,MAAM,OAAO,YAAa,SAAQ,WAAW;CAAG"}
+{"version":3,"file":"integrations.mjs","sourceRoot":"","sources":["../src/resources/integrations.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAGtB,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;OASG;IACH,gBAAgB,CACd,IAAuC,EACvC,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,cAAc,CACZ,IAAqC,EACrC,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;CACF"}

package/src/core.ts

@@ -170,6 +170,7 @@ export class APIPromise<T> extends Promise<T> {
 
 export abstract class APIClient {
   baseURL: string;
+  #baseURLOverridden: boolean;
   maxRetries: number;
   timeout: number;
   httpAgent: Agent | undefined;
@@ -179,18 +180,21 @@ export abstract class APIClient {
 
   constructor({
     baseURL,
+    baseURLOverridden,
     maxRetries = 2,
     timeout = 60000, // 1 minute
     httpAgent,
     fetch: overriddenFetch,
   }: {
     baseURL: string;
+    baseURLOverridden: boolean;
     maxRetries?: number | undefined;
     timeout: number | undefined;
     httpAgent: Agent | undefined;
     fetch: Fetch | undefined;
   }) {
     this.baseURL = baseURL;
+    this.#baseURLOverridden = baseURLOverridden;
     this.maxRetries = validatePositiveInteger('maxRetries', maxRetries);
     this.timeout = validatePositiveInteger('timeout', timeout);
     this.httpAgent = httpAgent;
@@ -300,7 +304,7 @@ export abstract class APIClient {
     { retryCount = 0 }: { retryCount?: number } = {},
   ): { req: RequestInit; url: string; timeout: number } {
     const options = { ...inputOptions };
-    const { method, path, query, headers: headers = {} } = options;
+    const { method, path, query, defaultBaseURL, headers: headers = {} } = options;
 
     const body =
       ArrayBuffer.isView(options.body) || (options.__binaryRequest && typeof options.body === 'string') ?
@@ -310,7 +314,7 @@ export abstract class APIClient {
       : null;
     const contentLength = this.calculateContentLength(body);
 
-    const url = this.buildURL(path!, query);
+    const url = this.buildURL(path!, query, defaultBaseURL);
     if ('timeout' in options) validatePositiveInteger('timeout', options.timeout);
     options.timeout = options.timeout ?? this.timeout;
     const httpAgent = options.httpAgent ?? this.httpAgent ?? getDefaultAgent(url);
@@ -503,11 +507,12 @@ export abstract class APIClient {
     return new PagePromise<PageClass, Item>(this, request, Page);
   }
 
-  buildURL<Req>(path: string, query: Req | null | undefined): string {
+  buildURL<Req>(path: string, query: Req | null | undefined, defaultBaseURL?: string | undefined): string {
+    const baseURL = (!this.#baseURLOverridden && defaultBaseURL) || this.baseURL;
     const url =
       isAbsoluteURL(path) ?
         new URL(path)
-      : new URL(this.baseURL + (this.baseURL.endsWith('/') && path.startsWith('/') ? path.slice(1) : path));
+      : new URL(baseURL + (baseURL.endsWith('/') && path.startsWith('/') ? path.slice(1) : path));
 
     const defaultQuery = this.defaultQuery();
     if (!isEmptyObj(defaultQuery)) {
@@ -792,6 +797,7 @@ export type RequestOptions<
   query?: Req | undefined;
   body?: Req | null | undefined;
   headers?: Headers | undefined;
+  defaultBaseURL?: string | undefined;
 
   maxRetries?: number;
   stream?: boolean | undefined;
@@ -813,6 +819,7 @@ const requestOptionsKeys: KeysEnum<RequestOptions> = {
   query: true,
   body: true,
   headers: true,
+  defaultBaseURL: true,
 
   maxRetries: true,
   stream: true,

package/src/index.ts

@@ -15,7 +15,13 @@ import {
   EvaluationGetJobRunsResponse,
 } from './resources/evaluation';
 import { Health, HealthGetResponse } from './resources/health';
-import { Integrations } from './resources/integrations';
+import {
+  IntegrationCreateRetellCallParams,
+  IntegrationCreateRetellCallResponse,
+  IntegrationCreateVapiCallParams,
+  IntegrationCreateVapiCallResponse,
+  Integrations,
+} from './resources/integrations';
 
 export interface ClientOptions {
   /**
@@ -119,6 +125,7 @@ export class Roark extends Core.APIClient {
 
     super({
       baseURL: options.baseURL!,
+      baseURLOverridden: baseURL ? baseURL !== 'https://api.roark.ai' : false,
       timeout: options.timeout ?? 60000 /* 1 minute */,
       httpAgent: options.httpAgent,
       maxRetries: options.maxRetries,
@@ -135,6 +142,13 @@ export class Roark extends Core.APIClient {
   call: API.Call = new API.Call(this);
   integrations: API.Integrations = new API.Integrations(this);
 
+  /**
+   * Check whether the base URL is set to its default.
+   */
+  #baseURLOverridden(): boolean {
+    return this.baseURL !== 'https://api.roark.ai';
+  }
+
   protected override defaultQuery(): Core.DefaultQuery | undefined {
     return this._options.defaultQuery;
   }
@@ -191,7 +205,13 @@ export declare namespace Roark {
 
   export { Call as Call };
 
-  export { Integrations as Integrations };
+  export {
+    Integrations as Integrations,
+    type IntegrationCreateRetellCallResponse as IntegrationCreateRetellCallResponse,
+    type IntegrationCreateVapiCallResponse as IntegrationCreateVapiCallResponse,
+    type IntegrationCreateRetellCallParams as IntegrationCreateRetellCallParams,
+    type IntegrationCreateVapiCallParams as IntegrationCreateVapiCallParams,
+  };
 }
 
 export { toFile, fileFromPath } from './uploads';

package/src/resource.ts

@@ -2,7 +2,7 @@
 
 import type { Roark } from './index';
 
-export class APIResource {
+export abstract class APIResource {
   protected _client: Roark;
 
   constructor(client: Roark) {

package/src/resources/evaluation.ts

@@ -18,7 +18,7 @@ export class Evaluation extends APIResource {
   /**
    * Retrieve details of a specific evaluation job
    */
-  getJob(jobId: string, options?: Core.RequestOptions): Core.APIPromise<unknown> {
+  getJob(jobId: string, options?: Core.RequestOptions): Core.APIPromise<EvaluationGetJobResponse> {
     return this._client.get(`/v1/evaluation/job/${jobId}`, options);
   }
 
@@ -29,13 +29,13 @@ export class Evaluation extends APIResource {
     jobId: string,
     query?: EvaluationGetJobRunsParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<unknown>;
-  getJobRuns(jobId: string, options?: Core.RequestOptions): Core.APIPromise<unknown>;
+  ): Core.APIPromise<EvaluationGetJobRunsResponse>;
+  getJobRuns(jobId: string, options?: Core.RequestOptions): Core.APIPromise<EvaluationGetJobRunsResponse>;
   getJobRuns(
     jobId: string,
     query: EvaluationGetJobRunsParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
-  ): Core.APIPromise<unknown> {
+  ): Core.APIPromise<EvaluationGetJobRunsResponse> {
     if (isRequestOptions(query)) {
       return this.getJobRuns(jobId, {}, query);
     }
@@ -61,9 +61,259 @@ export namespace EvaluationCreateJobResponse {
   }
 }
 
-export type EvaluationGetJobResponse = unknown;
+export interface EvaluationGetJobResponse {
+  /**
+   * Evaluation job response payload
+   */
+  data: EvaluationGetJobResponse.Data;
+}
+
+export namespace EvaluationGetJobResponse {
+  /**
+   * Evaluation job response payload
+   */
+  export interface Data {
+    /**
+     * ID of the evaluation job
+     */
+    id: string;
+
+    /**
+     * Status of the evaluation job
+     */
+    status: 'PENDING' | 'PROCESSING' | 'SUCCESS' | 'FAILURE';
+
+    /**
+     * Call being evaluated
+     */
+    call?: Data.Call;
+
+    /**
+     * Dataset being evaluated
+     */
+    dataset?: Data.Dataset;
+  }
+
+  export namespace Data {
+    /**
+     * Call being evaluated
+     */
+    export interface Call {
+      /**
+       * ID of the call being evaluated
+       */
+      id: string | null;
+    }
+
+    /**
+     * Dataset being evaluated
+     */
+    export interface Dataset {
+      /**
+       * ID of the dataset
+       */
+      id: string | null;
+
+      /**
+       * Calls in the dataset
+       */
+      calls: Array<Dataset.Call>;
+    }
+
+    export namespace Dataset {
+      export interface Call {
+        /**
+         * ID of the call
+         */
+        id: string | null;
+      }
+    }
+  }
+}
+
+export interface EvaluationGetJobRunsResponse {
+  /**
+   * Evaluation job runs response payload
+   */
+  data: EvaluationGetJobRunsResponse.Data;
+}
+
+export namespace EvaluationGetJobRunsResponse {
+  /**
+   * Evaluation job runs response payload
+   */
+  export interface Data {
+    /**
+     * Evaluator runs of the evaluation job
+     */
+    data: Array<Data.Data> | null;
+
+    /**
+     * Pagination information
+     */
+    pagination: Data.Pagination | null;
+  }
+
+  export namespace Data {
+    export interface Data {
+      /**
+       * ID of the evaluator run
+       */
+      id: string;
+
+      /**
+       * When the evaluator run completed
+       */
+      completedAt: string | null;
+
+      /**
+       * Evaluator of the evaluator run
+       */
+      evaluator: Data.Evaluator | null;
+
+      /**
+       * Evidence of the evaluator run
+       */
+      evidence: Array<Data.Evidence> | null;
+
+      /**
+       * Metrics of the evaluator run
+       */
+      metrics: Array<Data.Metric> | null;
+
+      /**
+       * Score of the evaluator run
+       */
+      score: number | null;
 
-export type EvaluationGetJobRunsResponse = unknown;
+      /**
+       * Score classification of the evaluator run
+       */
+      scoreClassification: 'SUCCESS' | 'FAILURE' | 'IRRELEVANT' | null;
+
+      /**
+       * When the evaluator run started
+       */
+      startedAt: string | null;
+
+      /**
+       * Status of the evaluator run
+       */
+      status: 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED';
+
+      /**
+       * Summary of the evaluator run
+       */
+      summary: string | null;
+    }
+
+    export namespace Data {
+      /**
+       * Evaluator of the evaluator run
+       */
+      export interface Evaluator {
+        /**
+         * ID of the evaluator
+         */
+        id: string | null;
+
+        /**
+         * Name of the evaluator
+         */
+        name: string | null;
+      }
+
+      export interface Evidence {
+        /**
+         * ID of the evidence
+         */
+        id: string | null;
+
+        /**
+         * Comment on the evidence
+         */
+        commentText: string | null;
+
+        /**
+         * Whether this is a positive example of the metric
+         */
+        isPositive: boolean | null;
+
+        /**
+         * Snippet of the evidence
+         */
+        snippetText: string | null;
+      }
+
+      export interface Metric {
+        /**
+         * ID of the metric
+         */
+        id: string | null;
+
+        /**
+         * Boolean value of the metric
+         */
+        booleanValue: boolean | null;
+
+        /**
+         * Confidence of the metric
+         */
+        confidence: number | null;
+
+        /**
+         * Name of the metric
+         */
+        name: string | null;
+
+        /**
+         * Numeric value of the metric
+         */
+        numericValue: number | null;
+
+        /**
+         * Reasoning for the metric
+         */
+        reasoning: string | null;
+
+        /**
+         * Role of the metric
+         */
+        role: 'PRIMARY' | 'SECONDARY' | null;
+
+        /**
+         * Text value of the metric
+         */
+        textValue: string | null;
+
+        /**
+         * Value type of the metric
+         */
+        valueType: 'NUMERIC' | 'BOOLEAN' | 'TEXT' | null;
+      }
+    }
+
+    /**
+     * Pagination information
+     */
+    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 EvaluationCreateJobParams {
   /**

package/src/resources/index.ts

@@ -10,4 +10,10 @@ export {
   type EvaluationGetJobRunsParams,
 } from './evaluation';
 export { Health, type HealthGetResponse } from './health';
-export { Integrations } from './integrations';
+export {
+  Integrations,
+  type IntegrationCreateRetellCallResponse,
+  type IntegrationCreateVapiCallResponse,
+  type IntegrationCreateRetellCallParams,
+  type IntegrationCreateVapiCallParams,
+} from './integrations';

package/src/resources/integrations.ts

@@ -1,5 +1,134 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../resource';
+import * as Core from '../core';
 
-export class Integrations extends APIResource {}
+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?: Core.RequestOptions,
+  ): Core.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?: Core.RequestOptions,
+  ): Core.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: Record<string, unknown>;
+
+  /**
+   * Optional metadata (key-value pairs) to include with the call. Useful for
+   * filtering and display in call details.
+   */
+  properties?: Record<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: Record<string, unknown>;
+
+  /**
+   * Optional metadata (key-value pairs) to include with the call. Useful for
+   * filtering and display in call details.
+   */
+  properties?: Record<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,
+  };
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.328.0'; // x-release-please-version
+export const VERSION = '0.330.0'; // x-release-please-version

package/version.d.ts

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

package/version.mjs

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