@coval/sdk 0.1.0

package/src/generated/apis/ConversationsApi.ts

@@ -0,0 +1,707 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Coval Agents API
+ *  Manage configurations for simulations and evaluations. 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@coval.dev
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import * as runtime from '../runtime.js';
+import {
+    type CovalConversationsAPIDeleteConversationResponse,
+    CovalConversationsAPIDeleteConversationResponseFromJSON,
+    CovalConversationsAPIDeleteConversationResponseToJSON,
+} from '../models/CovalConversationsAPIDeleteConversationResponse.js';
+import {
+    type CovalConversationsAPIErrorResponse,
+    CovalConversationsAPIErrorResponseFromJSON,
+    CovalConversationsAPIErrorResponseToJSON,
+} from '../models/CovalConversationsAPIErrorResponse.js';
+import {
+    type CovalConversationsAPIGetConversationMetricResponse,
+    CovalConversationsAPIGetConversationMetricResponseFromJSON,
+    CovalConversationsAPIGetConversationMetricResponseToJSON,
+} from '../models/CovalConversationsAPIGetConversationMetricResponse.js';
+import {
+    type CovalConversationsAPIGetConversationResponse,
+    CovalConversationsAPIGetConversationResponseFromJSON,
+    CovalConversationsAPIGetConversationResponseToJSON,
+} from '../models/CovalConversationsAPIGetConversationResponse.js';
+import {
+    type CovalConversationsAPIListConversationMetricsResponse,
+    CovalConversationsAPIListConversationMetricsResponseFromJSON,
+    CovalConversationsAPIListConversationMetricsResponseToJSON,
+} from '../models/CovalConversationsAPIListConversationMetricsResponse.js';
+import {
+    type CovalConversationsAPIListConversationsResponse,
+    CovalConversationsAPIListConversationsResponseFromJSON,
+    CovalConversationsAPIListConversationsResponseToJSON,
+} from '../models/CovalConversationsAPIListConversationsResponse.js';
+import {
+    type CovalConversationsAPIPatchConversationRequest,
+    CovalConversationsAPIPatchConversationRequestFromJSON,
+    CovalConversationsAPIPatchConversationRequestToJSON,
+} from '../models/CovalConversationsAPIPatchConversationRequest.js';
+import {
+    type CovalConversationsAPISubmitConversationRequest,
+    CovalConversationsAPISubmitConversationRequestFromJSON,
+    CovalConversationsAPISubmitConversationRequestToJSON,
+} from '../models/CovalConversationsAPISubmitConversationRequest.js';
+import {
+    type CovalConversationsAPISubmitConversationResponse,
+    CovalConversationsAPISubmitConversationResponseFromJSON,
+    CovalConversationsAPISubmitConversationResponseToJSON,
+} from '../models/CovalConversationsAPISubmitConversationResponse.js';
+
+export interface DeleteConversationRequest {
+    conversationId: string;
+}
+
+export interface GetConversationRequest {
+    conversationId: string;
+    includeProgress?: boolean;
+}
+
+export interface GetConversationMetricRequest {
+    conversationId: string;
+    metricOutputId: string;
+}
+
+export interface ListConversationMetricsRequest {
+    conversationId: string;
+    filter?: string;
+    pageSize?: number;
+    pageToken?: string;
+    orderBy?: string;
+}
+
+export interface ListConversationsRequest {
+    pageSize?: number;
+    pageToken?: string;
+    filter?: string;
+    orderBy?: string;
+}
+
+export interface PatchConversationRequest {
+    conversationId: string;
+    covalConversationsAPIPatchConversationRequest: CovalConversationsAPIPatchConversationRequest;
+}
+
+export interface SubmitConversationRequest {
+    covalConversationsAPISubmitConversationRequest: CovalConversationsAPISubmitConversationRequest;
+}
+
+/**
+ * ConversationsApi - interface
+ * 
+ * @export
+ * @interface ConversationsApiInterface
+ */
+export interface ConversationsApiInterface {
+    /**
+     * Creates request options for deleteConversation without sending the request
+     * @param {string} conversationId Unique conversation identifier
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    deleteConversationRequestOpts(requestParameters: DeleteConversationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Delete or cancel a conversation evaluation. 
+     * @summary Delete or cancel conversation
+     * @param {string} conversationId Unique conversation identifier
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    deleteConversationRaw(requestParameters: DeleteConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPIDeleteConversationResponse>>;
+
+    /**
+     * Delete or cancel a conversation evaluation. 
+     * Delete or cancel conversation
+     */
+    deleteConversation(requestParameters: DeleteConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPIDeleteConversationResponse>;
+
+    /**
+     * Creates request options for getConversation without sending the request
+     * @param {string} conversationId Unique conversation identifier (22-26 characters)
+     * @param {boolean} [includeProgress] Include progress tracking information
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    getConversationRequestOpts(requestParameters: GetConversationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Retrieve detailed information about a specific conversation. 
+     * @summary Get conversation details
+     * @param {string} conversationId Unique conversation identifier (22-26 characters)
+     * @param {boolean} [includeProgress] Include progress tracking information
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    getConversationRaw(requestParameters: GetConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPIGetConversationResponse>>;
+
+    /**
+     * Retrieve detailed information about a specific conversation. 
+     * Get conversation details
+     */
+    getConversation(requestParameters: GetConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPIGetConversationResponse>;
+
+    /**
+     * Creates request options for getConversationMetric without sending the request
+     * @param {string} conversationId Unique conversation identifier
+     * @param {string} metricOutputId Unique metric output identifier (26-char ULID)
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    getConversationMetricRequestOpts(requestParameters: GetConversationMetricRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Retrieve a single metric output by ID for a specific conversation. 
+     * @summary Get single conversation metric
+     * @param {string} conversationId Unique conversation identifier
+     * @param {string} metricOutputId Unique metric output identifier (26-char ULID)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    getConversationMetricRaw(requestParameters: GetConversationMetricRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPIGetConversationMetricResponse>>;
+
+    /**
+     * Retrieve a single metric output by ID for a specific conversation. 
+     * Get single conversation metric
+     */
+    getConversationMetric(requestParameters: GetConversationMetricRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPIGetConversationMetricResponse>;
+
+    /**
+     * Creates request options for listConversationMetrics without sending the request
+     * @param {string} conversationId Unique conversation identifier
+     * @param {string} [filter] Filter expression syntax.  Values may be unquoted or double-quoted. Values containing spaces must be quoted.  **Supported fields:** - &#x60;metric_name&#x60; (string): Filter by metric name (e.g., &#x60;metric_name&#x3D;latency&#x60;) - &#x60;status&#x60; (string): Filter by status (e.g., &#x60;status&#x3D;COMPLETED&#x60;) - &#x60;output_type&#x60; (string): Filter by type (e.g., &#x60;output_type&#x3D;float&#x60;)  **Examples:** - &#x60;filter&#x3D;status&#x3D;COMPLETED&#x60; - &#x60;filter&#x3D;metric_name&#x3D;latency AND status&#x3D;COMPLETED&#x60; - &#x60;filter&#x3D;output_type&#x3D;float&#x60; 
+     * @param {number} [pageSize] Maximum number of metrics to return (1-1000)
+     * @param {string} [pageToken] Pagination token from previous response (for fetching next page)
+     * @param {string} [orderBy] Field to order results by.  **Supported fields:** - &#x60;metric_name&#x60; (default): Sort by metric name alphabetically - &#x60;create_time&#x60;: Sort by creation time - &#x60;start_time&#x60;: Sort by computation start time - &#x60;end_time&#x60;: Sort by computation end time - &#x60;value&#x60;: Sort by metric value (float types only)  **Prefix with &#x60;-&#x60; for descending order** (e.g., &#x60;-create_time&#x60;) 
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    listConversationMetricsRequestOpts(requestParameters: ListConversationMetricsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * List all metrics computed for a specific conversation. 
+     * @summary List conversation metrics
+     * @param {string} conversationId Unique conversation identifier
+     * @param {string} [filter] Filter expression syntax.  Values may be unquoted or double-quoted. Values containing spaces must be quoted.  **Supported fields:** - &#x60;metric_name&#x60; (string): Filter by metric name (e.g., &#x60;metric_name&#x3D;latency&#x60;) - &#x60;status&#x60; (string): Filter by status (e.g., &#x60;status&#x3D;COMPLETED&#x60;) - &#x60;output_type&#x60; (string): Filter by type (e.g., &#x60;output_type&#x3D;float&#x60;)  **Examples:** - &#x60;filter&#x3D;status&#x3D;COMPLETED&#x60; - &#x60;filter&#x3D;metric_name&#x3D;latency AND status&#x3D;COMPLETED&#x60; - &#x60;filter&#x3D;output_type&#x3D;float&#x60; 
+     * @param {number} [pageSize] Maximum number of metrics to return (1-1000)
+     * @param {string} [pageToken] Pagination token from previous response (for fetching next page)
+     * @param {string} [orderBy] Field to order results by.  **Supported fields:** - &#x60;metric_name&#x60; (default): Sort by metric name alphabetically - &#x60;create_time&#x60;: Sort by creation time - &#x60;start_time&#x60;: Sort by computation start time - &#x60;end_time&#x60;: Sort by computation end time - &#x60;value&#x60;: Sort by metric value (float types only)  **Prefix with &#x60;-&#x60; for descending order** (e.g., &#x60;-create_time&#x60;) 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    listConversationMetricsRaw(requestParameters: ListConversationMetricsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPIListConversationMetricsResponse>>;
+
+    /**
+     * List all metrics computed for a specific conversation. 
+     * List conversation metrics
+     */
+    listConversationMetrics(requestParameters: ListConversationMetricsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPIListConversationMetricsResponse>;
+
+    /**
+     * Creates request options for listConversations without sending the request
+     * @param {number} [pageSize] Maximum number of conversations to return (1-250)
+     * @param {string} [pageToken] Token for retrieving next page (from previous response)
+     * @param {string} [filter] Filter expression syntax.  **Operators:** &#x60;&#x3D;&#x60;, &#x60;!&#x3D;&#x60;, &#x60;&gt;&#x60;, &#x60;&lt;&#x60;, &#x60;&gt;&#x3D;&#x60;, &#x60;&lt;&#x3D;&#x60;, &#x60;AND&#x60;, &#x60;OR&#x60;  Values may be unquoted or double-quoted. Values containing spaces must be quoted.  **Fields:** - &#x60;status&#x60; - PENDING, IN_QUEUE, IN_PROGRESS, COMPLETED, FAILED, CANCELLED, DELETED - &#x60;external_conversation_id&#x60; - Your system\&#39;s conversation ID - &#x60;create_time&#x60; - ISO 8601 timestamp - &#x60;occurred_at&#x60; - ISO 8601 timestamp - &#x60;metadata.{key}&#x60; - Custom metadata fields  **Examples:** - &#x60;status&#x3D;COMPLETED&#x60; - &#x60;create_time&gt;\&quot;2025-11-01T00:00:00Z\&quot;&#x60; - &#x60;status&#x3D;COMPLETED AND occurred_at&gt;&#x3D;\&quot;2025-11-01T00:00:00Z\&quot;&#x60; - &#x60;external_conversation_id&#x3D;external-call-abc&#x60; 
+     * @param {string} [orderBy] Sort field with optional &#x60;-&#x60; prefix for descending order.  **Fields:** &#x60;create_time&#x60;, &#x60;occurred_at&#x60;, &#x60;status&#x60;  **Examples:** - &#x60;create_time&#x60; (ascending) - &#x60;-create_time&#x60; (descending, most recent first) - &#x60;-occurred_at&#x60; (most recent conversations first) 
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    listConversationsRequestOpts(requestParameters: ListConversationsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * List conversations with optional filtering, pagination, and ordering. 
+     * @summary List conversations
+     * @param {number} [pageSize] Maximum number of conversations to return (1-250)
+     * @param {string} [pageToken] Token for retrieving next page (from previous response)
+     * @param {string} [filter] Filter expression syntax.  **Operators:** &#x60;&#x3D;&#x60;, &#x60;!&#x3D;&#x60;, &#x60;&gt;&#x60;, &#x60;&lt;&#x60;, &#x60;&gt;&#x3D;&#x60;, &#x60;&lt;&#x3D;&#x60;, &#x60;AND&#x60;, &#x60;OR&#x60;  Values may be unquoted or double-quoted. Values containing spaces must be quoted.  **Fields:** - &#x60;status&#x60; - PENDING, IN_QUEUE, IN_PROGRESS, COMPLETED, FAILED, CANCELLED, DELETED - &#x60;external_conversation_id&#x60; - Your system\&#39;s conversation ID - &#x60;create_time&#x60; - ISO 8601 timestamp - &#x60;occurred_at&#x60; - ISO 8601 timestamp - &#x60;metadata.{key}&#x60; - Custom metadata fields  **Examples:** - &#x60;status&#x3D;COMPLETED&#x60; - &#x60;create_time&gt;\&quot;2025-11-01T00:00:00Z\&quot;&#x60; - &#x60;status&#x3D;COMPLETED AND occurred_at&gt;&#x3D;\&quot;2025-11-01T00:00:00Z\&quot;&#x60; - &#x60;external_conversation_id&#x3D;external-call-abc&#x60; 
+     * @param {string} [orderBy] Sort field with optional &#x60;-&#x60; prefix for descending order.  **Fields:** &#x60;create_time&#x60;, &#x60;occurred_at&#x60;, &#x60;status&#x60;  **Examples:** - &#x60;create_time&#x60; (ascending) - &#x60;-create_time&#x60; (descending, most recent first) - &#x60;-occurred_at&#x60; (most recent conversations first) 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    listConversationsRaw(requestParameters: ListConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPIListConversationsResponse>>;
+
+    /**
+     * List conversations with optional filtering, pagination, and ordering. 
+     * List conversations
+     */
+    listConversations(requestParameters: ListConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPIListConversationsResponse>;
+
+    /**
+     * Creates request options for patchConversation without sending the request
+     * @param {string} conversationId Unique conversation identifier (22-26 characters)
+     * @param {CovalConversationsAPIPatchConversationRequest} covalConversationsAPIPatchConversationRequest 
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    patchConversationRequestOpts(requestParameters: PatchConversationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Attach an audio recording to a conversation previously submitted via `POST /v1/conversations:submit` without audio, and trigger audio-dependent metrics as a second wave.  **When to use this endpoint**  Use this endpoint when your recording URL is not available at the moment the call ends (for example, Twilio Programmable Voice recordings that are only fetchable after an asynchronous job completes ~60 seconds later). Submit the transcript immediately at call end to get a `conversation_id` for trace correlation, then PATCH the audio when the recording URL is ready.  **Two-wave metric timing**  - Text-only metrics fire immediately after `POST /v1/conversations:submit`   and deliver their results via your configured webhook. - Audio-dependent metrics fire after this PATCH and deliver a separate,   later webhook. Configure your consumer to expect both waves.  **One-shot**  Audio can be attached only once per conversation. Overwriting is not supported in v1 — a second PATCH on a conversation that already has audio returns `409 ALREADY_EXISTS`.  **Body**  Exactly one of `audio` or `audio_url` is required. 
+     * @summary Attach audio to a conversation
+     * @param {string} conversationId Unique conversation identifier (22-26 characters)
+     * @param {CovalConversationsAPIPatchConversationRequest} covalConversationsAPIPatchConversationRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    patchConversationRaw(requestParameters: PatchConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPIGetConversationResponse>>;
+
+    /**
+     * Attach an audio recording to a conversation previously submitted via `POST /v1/conversations:submit` without audio, and trigger audio-dependent metrics as a second wave.  **When to use this endpoint**  Use this endpoint when your recording URL is not available at the moment the call ends (for example, Twilio Programmable Voice recordings that are only fetchable after an asynchronous job completes ~60 seconds later). Submit the transcript immediately at call end to get a `conversation_id` for trace correlation, then PATCH the audio when the recording URL is ready.  **Two-wave metric timing**  - Text-only metrics fire immediately after `POST /v1/conversations:submit`   and deliver their results via your configured webhook. - Audio-dependent metrics fire after this PATCH and deliver a separate,   later webhook. Configure your consumer to expect both waves.  **One-shot**  Audio can be attached only once per conversation. Overwriting is not supported in v1 — a second PATCH on a conversation that already has audio returns `409 ALREADY_EXISTS`.  **Body**  Exactly one of `audio` or `audio_url` is required. 
+     * Attach audio to a conversation
+     */
+    patchConversation(requestParameters: PatchConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPIGetConversationResponse>;
+
+    /**
+     * Creates request options for submitConversation without sending the request
+     * @param {CovalConversationsAPISubmitConversationRequest} covalConversationsAPISubmitConversationRequest 
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    submitConversationRequestOpts(requestParameters: SubmitConversationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Submit a conversation for monitoring evaluation. 
+     * @summary Submit conversation for evaluation
+     * @param {CovalConversationsAPISubmitConversationRequest} covalConversationsAPISubmitConversationRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationsApiInterface
+     */
+    submitConversationRaw(requestParameters: SubmitConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPISubmitConversationResponse>>;
+
+    /**
+     * Submit a conversation for monitoring evaluation. 
+     * Submit conversation for evaluation
+     */
+    submitConversation(requestParameters: SubmitConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPISubmitConversationResponse>;
+
+}
+
+/**
+ * 
+ */
+export class ConversationsApi extends runtime.BaseAPI implements ConversationsApiInterface {
+
+    /**
+     * Creates request options for deleteConversation without sending the request
+     */
+    async deleteConversationRequestOpts(requestParameters: DeleteConversationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['conversationId'] == null) {
+            throw new runtime.RequiredError(
+                'conversationId',
+                'Required parameter "conversationId" was null or undefined when calling deleteConversation().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/v1/conversations/{conversation_id}`;
+        urlPath = urlPath.replace('{conversation_id}', encodeURIComponent(String(requestParameters['conversationId'])));
+
+        return {
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Delete or cancel a conversation evaluation. 
+     * Delete or cancel conversation
+     */
+    async deleteConversationRaw(requestParameters: DeleteConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPIDeleteConversationResponse>> {
+        const requestOptions = await this.deleteConversationRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalConversationsAPIDeleteConversationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Delete or cancel a conversation evaluation. 
+     * Delete or cancel conversation
+     */
+    async deleteConversation(requestParameters: DeleteConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPIDeleteConversationResponse> {
+        const response = await this.deleteConversationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getConversation without sending the request
+     */
+    async getConversationRequestOpts(requestParameters: GetConversationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['conversationId'] == null) {
+            throw new runtime.RequiredError(
+                'conversationId',
+                'Required parameter "conversationId" was null or undefined when calling getConversation().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['includeProgress'] != null) {
+            queryParameters['include_progress'] = requestParameters['includeProgress'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/v1/conversations/{conversation_id}`;
+        urlPath = urlPath.replace('{conversation_id}', encodeURIComponent(String(requestParameters['conversationId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Retrieve detailed information about a specific conversation. 
+     * Get conversation details
+     */
+    async getConversationRaw(requestParameters: GetConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPIGetConversationResponse>> {
+        const requestOptions = await this.getConversationRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalConversationsAPIGetConversationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Retrieve detailed information about a specific conversation. 
+     * Get conversation details
+     */
+    async getConversation(requestParameters: GetConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPIGetConversationResponse> {
+        const response = await this.getConversationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getConversationMetric without sending the request
+     */
+    async getConversationMetricRequestOpts(requestParameters: GetConversationMetricRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['conversationId'] == null) {
+            throw new runtime.RequiredError(
+                'conversationId',
+                'Required parameter "conversationId" was null or undefined when calling getConversationMetric().'
+            );
+        }
+
+        if (requestParameters['metricOutputId'] == null) {
+            throw new runtime.RequiredError(
+                'metricOutputId',
+                'Required parameter "metricOutputId" was null or undefined when calling getConversationMetric().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/v1/conversations/{conversation_id}/metrics/{metric_output_id}`;
+        urlPath = urlPath.replace('{conversation_id}', encodeURIComponent(String(requestParameters['conversationId'])));
+        urlPath = urlPath.replace('{metric_output_id}', encodeURIComponent(String(requestParameters['metricOutputId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Retrieve a single metric output by ID for a specific conversation. 
+     * Get single conversation metric
+     */
+    async getConversationMetricRaw(requestParameters: GetConversationMetricRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPIGetConversationMetricResponse>> {
+        const requestOptions = await this.getConversationMetricRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalConversationsAPIGetConversationMetricResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Retrieve a single metric output by ID for a specific conversation. 
+     * Get single conversation metric
+     */
+    async getConversationMetric(requestParameters: GetConversationMetricRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPIGetConversationMetricResponse> {
+        const response = await this.getConversationMetricRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listConversationMetrics without sending the request
+     */
+    async listConversationMetricsRequestOpts(requestParameters: ListConversationMetricsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['conversationId'] == null) {
+            throw new runtime.RequiredError(
+                'conversationId',
+                'Required parameter "conversationId" was null or undefined when calling listConversationMetrics().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['filter'] != null) {
+            queryParameters['filter'] = requestParameters['filter'];
+        }
+
+        if (requestParameters['pageSize'] != null) {
+            queryParameters['page_size'] = requestParameters['pageSize'];
+        }
+
+        if (requestParameters['pageToken'] != null) {
+            queryParameters['page_token'] = requestParameters['pageToken'];
+        }
+
+        if (requestParameters['orderBy'] != null) {
+            queryParameters['order_by'] = requestParameters['orderBy'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/v1/conversations/{conversation_id}/metrics`;
+        urlPath = urlPath.replace('{conversation_id}', encodeURIComponent(String(requestParameters['conversationId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * List all metrics computed for a specific conversation. 
+     * List conversation metrics
+     */
+    async listConversationMetricsRaw(requestParameters: ListConversationMetricsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPIListConversationMetricsResponse>> {
+        const requestOptions = await this.listConversationMetricsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalConversationsAPIListConversationMetricsResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * List all metrics computed for a specific conversation. 
+     * List conversation metrics
+     */
+    async listConversationMetrics(requestParameters: ListConversationMetricsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPIListConversationMetricsResponse> {
+        const response = await this.listConversationMetricsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listConversations without sending the request
+     */
+    async listConversationsRequestOpts(requestParameters: ListConversationsRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['pageSize'] != null) {
+            queryParameters['page_size'] = requestParameters['pageSize'];
+        }
+
+        if (requestParameters['pageToken'] != null) {
+            queryParameters['page_token'] = requestParameters['pageToken'];
+        }
+
+        if (requestParameters['filter'] != null) {
+            queryParameters['filter'] = requestParameters['filter'];
+        }
+
+        if (requestParameters['orderBy'] != null) {
+            queryParameters['order_by'] = requestParameters['orderBy'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/v1/conversations`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * List conversations with optional filtering, pagination, and ordering. 
+     * List conversations
+     */
+    async listConversationsRaw(requestParameters: ListConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPIListConversationsResponse>> {
+        const requestOptions = await this.listConversationsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalConversationsAPIListConversationsResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * List conversations with optional filtering, pagination, and ordering. 
+     * List conversations
+     */
+    async listConversations(requestParameters: ListConversationsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPIListConversationsResponse> {
+        const response = await this.listConversationsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for patchConversation without sending the request
+     */
+    async patchConversationRequestOpts(requestParameters: PatchConversationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['conversationId'] == null) {
+            throw new runtime.RequiredError(
+                'conversationId',
+                'Required parameter "conversationId" was null or undefined when calling patchConversation().'
+            );
+        }
+
+        if (requestParameters['covalConversationsAPIPatchConversationRequest'] == null) {
+            throw new runtime.RequiredError(
+                'covalConversationsAPIPatchConversationRequest',
+                'Required parameter "covalConversationsAPIPatchConversationRequest" was null or undefined when calling patchConversation().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/v1/conversations/{conversation_id}`;
+        urlPath = urlPath.replace('{conversation_id}', encodeURIComponent(String(requestParameters['conversationId'])));
+
+        return {
+            path: urlPath,
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CovalConversationsAPIPatchConversationRequestToJSON(requestParameters['covalConversationsAPIPatchConversationRequest']),
+        };
+    }
+
+    /**
+     * Attach an audio recording to a conversation previously submitted via `POST /v1/conversations:submit` without audio, and trigger audio-dependent metrics as a second wave.  **When to use this endpoint**  Use this endpoint when your recording URL is not available at the moment the call ends (for example, Twilio Programmable Voice recordings that are only fetchable after an asynchronous job completes ~60 seconds later). Submit the transcript immediately at call end to get a `conversation_id` for trace correlation, then PATCH the audio when the recording URL is ready.  **Two-wave metric timing**  - Text-only metrics fire immediately after `POST /v1/conversations:submit`   and deliver their results via your configured webhook. - Audio-dependent metrics fire after this PATCH and deliver a separate,   later webhook. Configure your consumer to expect both waves.  **One-shot**  Audio can be attached only once per conversation. Overwriting is not supported in v1 — a second PATCH on a conversation that already has audio returns `409 ALREADY_EXISTS`.  **Body**  Exactly one of `audio` or `audio_url` is required. 
+     * Attach audio to a conversation
+     */
+    async patchConversationRaw(requestParameters: PatchConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPIGetConversationResponse>> {
+        const requestOptions = await this.patchConversationRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalConversationsAPIGetConversationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Attach an audio recording to a conversation previously submitted via `POST /v1/conversations:submit` without audio, and trigger audio-dependent metrics as a second wave.  **When to use this endpoint**  Use this endpoint when your recording URL is not available at the moment the call ends (for example, Twilio Programmable Voice recordings that are only fetchable after an asynchronous job completes ~60 seconds later). Submit the transcript immediately at call end to get a `conversation_id` for trace correlation, then PATCH the audio when the recording URL is ready.  **Two-wave metric timing**  - Text-only metrics fire immediately after `POST /v1/conversations:submit`   and deliver their results via your configured webhook. - Audio-dependent metrics fire after this PATCH and deliver a separate,   later webhook. Configure your consumer to expect both waves.  **One-shot**  Audio can be attached only once per conversation. Overwriting is not supported in v1 — a second PATCH on a conversation that already has audio returns `409 ALREADY_EXISTS`.  **Body**  Exactly one of `audio` or `audio_url` is required. 
+     * Attach audio to a conversation
+     */
+    async patchConversation(requestParameters: PatchConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPIGetConversationResponse> {
+        const response = await this.patchConversationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for submitConversation without sending the request
+     */
+    async submitConversationRequestOpts(requestParameters: SubmitConversationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['covalConversationsAPISubmitConversationRequest'] == null) {
+            throw new runtime.RequiredError(
+                'covalConversationsAPISubmitConversationRequest',
+                'Required parameter "covalConversationsAPISubmitConversationRequest" was null or undefined when calling submitConversation().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/v1/conversations:submit`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CovalConversationsAPISubmitConversationRequestToJSON(requestParameters['covalConversationsAPISubmitConversationRequest']),
+        };
+    }
+
+    /**
+     * Submit a conversation for monitoring evaluation. 
+     * Submit conversation for evaluation
+     */
+    async submitConversationRaw(requestParameters: SubmitConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalConversationsAPISubmitConversationResponse>> {
+        const requestOptions = await this.submitConversationRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalConversationsAPISubmitConversationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Submit a conversation for monitoring evaluation. 
+     * Submit conversation for evaluation
+     */
+    async submitConversation(requestParameters: SubmitConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalConversationsAPISubmitConversationResponse> {
+        const response = await this.submitConversationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}