@coval/sdk 0.1.0 → 0.2.0

package/src/generated/apis/ReviewAnnotationsApi.ts

@@ -51,6 +51,7 @@ import {
 
 export interface CreateReviewAnnotationRequest {
     covalReviewsAPICreateReviewAnnotationRequest: CovalReviewsAPICreateReviewAnnotationRequest;
+    projectId?: string;
 }
 
 export interface DeleteReviewAnnotationRequest {
@@ -59,6 +60,7 @@ export interface DeleteReviewAnnotationRequest {
 
 export interface GetReviewAnnotationRequest {
     annotationId: string;
+    projectId?: string;
 }
 
 export interface ListReviewAnnotationsRequest {
@@ -71,6 +73,7 @@ export interface ListReviewAnnotationsRequest {
 export interface UpdateReviewAnnotationRequest {
     annotationId: string;
     covalReviewsAPIUpdateReviewAnnotationRequest: CovalReviewsAPIUpdateReviewAnnotationRequest;
+    projectId?: string;
 }
 
 /**
@@ -83,6 +86,7 @@ export interface ReviewAnnotationsApiInterface {
     /**
      * Creates request options for createReviewAnnotation without sending the request
      * @param {CovalReviewsAPICreateReviewAnnotationRequest} covalReviewsAPICreateReviewAnnotationRequest 
+     * @param {string} [projectId] Optional project ID to apply project-rule-aware completion status
      * @throws {RequiredError}
      * @memberof ReviewAnnotationsApiInterface
      */
@@ -92,6 +96,7 @@ export interface ReviewAnnotationsApiInterface {
      * Create a new review annotation for your organization.
      * @summary Create review annotation
      * @param {CovalReviewsAPICreateReviewAnnotationRequest} covalReviewsAPICreateReviewAnnotationRequest 
+     * @param {string} [projectId] Optional project ID to apply project-rule-aware completion status
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof ReviewAnnotationsApiInterface
@@ -131,6 +136,7 @@ export interface ReviewAnnotationsApiInterface {
     /**
      * Creates request options for getReviewAnnotation without sending the request
      * @param {string} annotationId The annotation ID
+     * @param {string} [projectId] Optional project ID to apply project-rule-aware completion status
      * @throws {RequiredError}
      * @memberof ReviewAnnotationsApiInterface
      */
@@ -140,6 +146,7 @@ export interface ReviewAnnotationsApiInterface {
      * Get a single review annotation by ID.
      * @summary Get review annotation
      * @param {string} annotationId The annotation ID
+     * @param {string} [projectId] Optional project ID to apply project-rule-aware completion status
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof ReviewAnnotationsApiInterface
@@ -186,6 +193,7 @@ export interface ReviewAnnotationsApiInterface {
      * Creates request options for updateReviewAnnotation without sending the request
      * @param {string} annotationId The annotation ID
      * @param {CovalReviewsAPIUpdateReviewAnnotationRequest} covalReviewsAPIUpdateReviewAnnotationRequest 
+     * @param {string} [projectId] Optional project ID to apply project-rule-aware completion status
      * @throws {RequiredError}
      * @memberof ReviewAnnotationsApiInterface
      */
@@ -196,6 +204,7 @@ export interface ReviewAnnotationsApiInterface {
      * @summary Update review annotation
      * @param {string} annotationId The annotation ID
      * @param {CovalReviewsAPIUpdateReviewAnnotationRequest} covalReviewsAPIUpdateReviewAnnotationRequest 
+     * @param {string} [projectId] Optional project ID to apply project-rule-aware completion status
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof ReviewAnnotationsApiInterface
@@ -228,6 +237,10 @@ export class ReviewAnnotationsApi extends runtime.BaseAPI implements ReviewAnnot
 
         const queryParameters: any = {};
 
+        if (requestParameters['projectId'] != null) {
+            queryParameters['project_id'] = requestParameters['projectId'];
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
         headerParameters['Content-Type'] = 'application/json';
@@ -332,6 +345,10 @@ export class ReviewAnnotationsApi extends runtime.BaseAPI implements ReviewAnnot
 
         const queryParameters: any = {};
 
+        if (requestParameters['projectId'] != null) {
+            queryParameters['project_id'] = requestParameters['projectId'];
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
         if (this.configuration && this.configuration.apiKey) {
@@ -449,6 +466,10 @@ export class ReviewAnnotationsApi extends runtime.BaseAPI implements ReviewAnnot
 
         const queryParameters: any = {};
 
+        if (requestParameters['projectId'] != null) {
+            queryParameters['project_id'] = requestParameters['projectId'];
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
         headerParameters['Content-Type'] = 'application/json';

package/src/generated/apis/RunsApi.ts

@@ -23,6 +23,11 @@ import {
     CovalRunsAPILaunchRunResponseFromJSON,
     CovalRunsAPILaunchRunResponseToJSON,
 } from '../models/CovalRunsAPILaunchRunResponse.js';
+import {
+    type CovalRunsAPIUpdateRunRequest,
+    CovalRunsAPIUpdateRunRequestFromJSON,
+    CovalRunsAPIUpdateRunRequestToJSON,
+} from '../models/CovalRunsAPIUpdateRunRequest.js';
 import {
     type GetRun200Response,
     GetRun200ResponseFromJSON,
@@ -58,6 +63,11 @@ export interface ListRunsRequest {
     orderBy?: string;
 }
 
+export interface UpdateRunRequest {
+    runId: string;
+    covalRunsAPIUpdateRunRequest: CovalRunsAPIUpdateRunRequest;
+}
+
 /**
  * RunsApi - interface
  * 
@@ -167,6 +177,32 @@ export interface RunsApiInterface {
      */
     listRuns(requestParameters: ListRunsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListRuns200Response>;
 
+    /**
+     * Creates request options for updateRun without sending the request
+     * @param {string} runId Unique identifier for the run
+     * @param {CovalRunsAPIUpdateRunRequest} covalRunsAPIUpdateRunRequest 
+     * @throws {RequiredError}
+     * @memberof RunsApiInterface
+     */
+    updateRunRequestOpts(requestParameters: UpdateRunRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Replace the tag set for an existing simulation run. Provide an empty list to clear all tags. 
+     * @summary Update run
+     * @param {string} runId Unique identifier for the run
+     * @param {CovalRunsAPIUpdateRunRequest} covalRunsAPIUpdateRunRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof RunsApiInterface
+     */
+    updateRunRaw(requestParameters: UpdateRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetRun200Response>>;
+
+    /**
+     * Replace the tag set for an existing simulation run. Provide an empty list to clear all tags. 
+     * Update run
+     */
+    updateRun(requestParameters: UpdateRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetRun200Response>;
+
 }
 
 /**
@@ -388,4 +424,65 @@ export class RunsApi extends runtime.BaseAPI implements RunsApiInterface {
         return await response.value();
     }
 
+    /**
+     * Creates request options for updateRun without sending the request
+     */
+    async updateRunRequestOpts(requestParameters: UpdateRunRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['runId'] == null) {
+            throw new runtime.RequiredError(
+                'runId',
+                'Required parameter "runId" was null or undefined when calling updateRun().'
+            );
+        }
+
+        if (requestParameters['covalRunsAPIUpdateRunRequest'] == null) {
+            throw new runtime.RequiredError(
+                'covalRunsAPIUpdateRunRequest',
+                'Required parameter "covalRunsAPIUpdateRunRequest" was null or undefined when calling updateRun().'
+            );
+        }
+
+        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_Runs_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/runs/{run_id}`;
+        urlPath = urlPath.replace('{run_id}', encodeURIComponent(String(requestParameters['runId'])));
+
+        return {
+            path: urlPath,
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CovalRunsAPIUpdateRunRequestToJSON(requestParameters['covalRunsAPIUpdateRunRequest']),
+        };
+    }
+
+    /**
+     * Replace the tag set for an existing simulation run. Provide an empty list to clear all tags. 
+     * Update run
+     */
+    async updateRunRaw(requestParameters: UpdateRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetRun200Response>> {
+        const requestOptions = await this.updateRunRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetRun200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Replace the tag set for an existing simulation run. Provide an empty list to clear all tags. 
+     * Update run
+     */
+    async updateRun(requestParameters: UpdateRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetRun200Response> {
+        const response = await this.updateRunRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
 }

package/src/generated/apis/SimulationsApi.ts

@@ -38,6 +38,16 @@ import {
     CovalSimulationsAPIResimulateSimulationResponseFromJSON,
     CovalSimulationsAPIResimulateSimulationResponseToJSON,
 } from '../models/CovalSimulationsAPIResimulateSimulationResponse.js';
+import {
+    type CovalSimulationsAPIUpdateSimulationRequest,
+    CovalSimulationsAPIUpdateSimulationRequestFromJSON,
+    CovalSimulationsAPIUpdateSimulationRequestToJSON,
+} from '../models/CovalSimulationsAPIUpdateSimulationRequest.js';
+import {
+    type CovalSimulationsAPIUpdateSimulationResponse,
+    CovalSimulationsAPIUpdateSimulationResponseFromJSON,
+    CovalSimulationsAPIUpdateSimulationResponseToJSON,
+} from '../models/CovalSimulationsAPIUpdateSimulationResponse.js';
 
 export interface DeleteSimulationRequest {
     simulationId: string;
@@ -63,6 +73,11 @@ export interface ResimulateSimulationRequest {
     body?: object;
 }
 
+export interface UpdateSimulationRequest {
+    simulationId: string;
+    covalSimulationsAPIUpdateSimulationRequest?: CovalSimulationsAPIUpdateSimulationRequest;
+}
+
 /**
  * SimulationsApi - interface
  * 
@@ -198,6 +213,32 @@ export interface SimulationsApiInterface {
      */
     resimulateSimulation(requestParameters: ResimulateSimulationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalSimulationsAPIResimulateSimulationResponse>;
 
+    /**
+     * Creates request options for updateSimulation without sending the request
+     * @param {string} simulationId The simulation ID
+     * @param {CovalSimulationsAPIUpdateSimulationRequest} [covalSimulationsAPIUpdateSimulationRequest] 
+     * @throws {RequiredError}
+     * @memberof SimulationsApiInterface
+     */
+    updateSimulationRequestOpts(requestParameters: UpdateSimulationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Update specific fields of a simulation. All fields are optional (PATCH semantics). Only provided fields will be updated. 
+     * @summary Update simulation
+     * @param {string} simulationId The simulation ID
+     * @param {CovalSimulationsAPIUpdateSimulationRequest} [covalSimulationsAPIUpdateSimulationRequest] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SimulationsApiInterface
+     */
+    updateSimulationRaw(requestParameters: UpdateSimulationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalSimulationsAPIUpdateSimulationResponse>>;
+
+    /**
+     * Update specific fields of a simulation. All fields are optional (PATCH semantics). Only provided fields will be updated. 
+     * Update simulation
+     */
+    updateSimulation(requestParameters: UpdateSimulationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalSimulationsAPIUpdateSimulationResponse>;
+
 }
 
 /**
@@ -471,4 +512,58 @@ export class SimulationsApi extends runtime.BaseAPI implements SimulationsApiInt
         return await response.value();
     }
 
+    /**
+     * Creates request options for updateSimulation without sending the request
+     */
+    async updateSimulationRequestOpts(requestParameters: UpdateSimulationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['simulationId'] == null) {
+            throw new runtime.RequiredError(
+                'simulationId',
+                'Required parameter "simulationId" was null or undefined when calling updateSimulation().'
+            );
+        }
+
+        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_Simulations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/v1/simulations/{simulation_id}`;
+        urlPath = urlPath.replace('{simulation_id}', encodeURIComponent(String(requestParameters['simulationId'])));
+
+        return {
+            path: urlPath,
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CovalSimulationsAPIUpdateSimulationRequestToJSON(requestParameters['covalSimulationsAPIUpdateSimulationRequest']),
+        };
+    }
+
+    /**
+     * Update specific fields of a simulation. All fields are optional (PATCH semantics). Only provided fields will be updated. 
+     * Update simulation
+     */
+    async updateSimulationRaw(requestParameters: UpdateSimulationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalSimulationsAPIUpdateSimulationResponse>> {
+        const requestOptions = await this.updateSimulationRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalSimulationsAPIUpdateSimulationResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Update specific fields of a simulation. All fields are optional (PATCH semantics). Only provided fields will be updated. 
+     * Update simulation
+     */
+    async updateSimulation(requestParameters: UpdateSimulationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalSimulationsAPIUpdateSimulationResponse> {
+        const response = await this.updateSimulationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
 }

package/src/generated/apis/TracesApi.ts

@@ -0,0 +1,136 @@
+/* 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 IngestTraces200Response,
+    IngestTraces200ResponseFromJSON,
+    IngestTraces200ResponseToJSON,
+} from '../models/IngestTraces200Response.js';
+import {
+    type TracesAPIErrorResponse,
+    TracesAPIErrorResponseFromJSON,
+    TracesAPIErrorResponseToJSON,
+} from '../models/TracesAPIErrorResponse.js';
+
+export interface IngestTracesRequest {
+    body: Blob;
+    xSimulationId?: string;
+    xConversationId?: string;
+}
+
+/**
+ * TracesApi - interface
+ * 
+ * @export
+ * @interface TracesApiInterface
+ */
+export interface TracesApiInterface {
+    /**
+     * Creates request options for ingestTraces without sending the request
+     * @param {Blob} body OTLP `ExportTraceServiceRequest` payload — protobuf or JSON. 
+     * @param {string} [xSimulationId] Simulation output ID to associate the spans with. Use for simulation-based flows. Mutually exclusive with `X-Conversation-Id`. 
+     * @param {string} [xConversationId] Conversation (Run) ID returned by `POST /v1/conversations:submit`. Use for monitoring flows. Mutually exclusive with `X-Simulation-Id`. 
+     * @throws {RequiredError}
+     * @memberof TracesApiInterface
+     */
+    ingestTracesRequestOpts(requestParameters: IngestTracesRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Ingest OpenTelemetry trace data and associate it with a simulation output or a monitoring conversation.  The request body must be a standard OTLP `ExportTraceServiceRequest`, in protobuf binary (`application/x-protobuf`, the default for stock OTLP HTTP exporters) or JSON (`application/json`) format. See the [OTLP/HTTP specification](https://opentelemetry.io/docs/specs/otlp/#otlphttp) and [opentelemetry-proto](https://github.com/open-telemetry/opentelemetry-proto) for the wire format.  Identify the target by providing exactly one of `X-Simulation-Id` or `X-Conversation-Id` (not both). 
+     * @summary Ingest OTLP traces
+     * @param {Blob} body OTLP &#x60;ExportTraceServiceRequest&#x60; payload — protobuf or JSON. 
+     * @param {string} [xSimulationId] Simulation output ID to associate the spans with. Use for simulation-based flows. Mutually exclusive with &#x60;X-Conversation-Id&#x60;. 
+     * @param {string} [xConversationId] Conversation (Run) ID returned by &#x60;POST /v1/conversations:submit&#x60;. Use for monitoring flows. Mutually exclusive with &#x60;X-Simulation-Id&#x60;. 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TracesApiInterface
+     */
+    ingestTracesRaw(requestParameters: IngestTracesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<IngestTraces200Response>>;
+
+    /**
+     * Ingest OpenTelemetry trace data and associate it with a simulation output or a monitoring conversation.  The request body must be a standard OTLP `ExportTraceServiceRequest`, in protobuf binary (`application/x-protobuf`, the default for stock OTLP HTTP exporters) or JSON (`application/json`) format. See the [OTLP/HTTP specification](https://opentelemetry.io/docs/specs/otlp/#otlphttp) and [opentelemetry-proto](https://github.com/open-telemetry/opentelemetry-proto) for the wire format.  Identify the target by providing exactly one of `X-Simulation-Id` or `X-Conversation-Id` (not both). 
+     * Ingest OTLP traces
+     */
+    ingestTraces(requestParameters: IngestTracesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IngestTraces200Response>;
+
+}
+
+/**
+ * 
+ */
+export class TracesApi extends runtime.BaseAPI implements TracesApiInterface {
+
+    /**
+     * Creates request options for ingestTraces without sending the request
+     */
+    async ingestTracesRequestOpts(requestParameters: IngestTracesRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['body'] == null) {
+            throw new runtime.RequiredError(
+                'body',
+                'Required parameter "body" was null or undefined when calling ingestTraces().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/x-protobuf';
+
+        if (requestParameters['xSimulationId'] != null) {
+            headerParameters['X-Simulation-Id'] = String(requestParameters['xSimulationId']);
+        }
+
+        if (requestParameters['xConversationId'] != null) {
+            headerParameters['X-Conversation-Id'] = String(requestParameters['xConversationId']);
+        }
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Traces_API_apiKey authentication
+        }
+
+
+        let urlPath = `/traces`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: requestParameters['body'] as any,
+        };
+    }
+
+    /**
+     * Ingest OpenTelemetry trace data and associate it with a simulation output or a monitoring conversation.  The request body must be a standard OTLP `ExportTraceServiceRequest`, in protobuf binary (`application/x-protobuf`, the default for stock OTLP HTTP exporters) or JSON (`application/json`) format. See the [OTLP/HTTP specification](https://opentelemetry.io/docs/specs/otlp/#otlphttp) and [opentelemetry-proto](https://github.com/open-telemetry/opentelemetry-proto) for the wire format.  Identify the target by providing exactly one of `X-Simulation-Id` or `X-Conversation-Id` (not both). 
+     * Ingest OTLP traces
+     */
+    async ingestTracesRaw(requestParameters: IngestTracesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<IngestTraces200Response>> {
+        const requestOptions = await this.ingestTracesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => IngestTraces200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Ingest OpenTelemetry trace data and associate it with a simulation output or a monitoring conversation.  The request body must be a standard OTLP `ExportTraceServiceRequest`, in protobuf binary (`application/x-protobuf`, the default for stock OTLP HTTP exporters) or JSON (`application/json`) format. See the [OTLP/HTTP specification](https://opentelemetry.io/docs/specs/otlp/#otlphttp) and [opentelemetry-proto](https://github.com/open-telemetry/opentelemetry-proto) for the wire format.  Identify the target by providing exactly one of `X-Simulation-Id` or `X-Conversation-Id` (not both). 
+     * Ingest OTLP traces
+     */
+    async ingestTraces(requestParameters: IngestTracesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IngestTraces200Response> {
+        const response = await this.ingestTracesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/generated/apis/index.ts

@@ -20,4 +20,5 @@ export * from './SimulationsApi.js';
 export * from './TemplatesApi.js';
 export * from './TestCasesApi.js';
 export * from './TestSetsApi.js';
+export * from './TracesApi.js';
 export * from './WidgetsApi.js';

package/src/generated/models/CovalAgentsAPICreateAgentRequest.ts

@@ -88,7 +88,7 @@ export interface CovalAgentsAPICreateAgentRequest {
      * - `custom_persona_data` - Persona-specific data (max 16KB JSON string)
      * 
      * *Headers & Format:*
-     * - `custom_headers` - Additional headers with template variables (max 16KB JSON string)
+     * - `custom_headers` - Additional headers with template variables, as a JSON object or JSON-encoded object string (max 16KB when encoded)
      * - `response_format` - "chat_completions" (default) or "responses"
      * 
      * *Request/Response Processing:*
@@ -105,31 +105,6 @@ export interface CovalAgentsAPICreateAgentRequest {
      * 
      * *Template Variables:* `{{sessionId}}`, `{{simulation_output_id}}`, `{{init_response.path}}`, `{{persona.field}}`, `{{messages}}`, `{{latest_message}}`, `{{custom_data.field}}`
      * 
-     * **For CHAT_A2A agents:**
-     * 
-     * *Required:*
-     * - `chat_endpoint` - A2A JSON-RPC endpoint URL (validated, no private IPs/localhost)
-     * 
-     * *Initialization (optional):*
-     * - `initialization_endpoint` - Auth endpoint called once per simulation; if response contains `access_token`, it is used as `Authorization: Bearer <token>` for chat requests
-     * - `initialization_payload` - Body sent to initialization endpoint (JSON string)
-     * - `initialization_content_type` - `application/x-www-form-urlencoded` (default) or `application/json`
-     * - `authorization_header` - Static auth value, used when no initialization endpoint is configured
-     * 
-     * *Headers:*
-     * - `custom_headers` - Additional headers sent on every chat request (JSON string)
-     * 
-     * *Response Parsing:*
-     * - `response_message_path` - Dot-notation path to the agent's reply text (default: `result.artifacts.0.parts.0.text`)
-     * - `response_state_extraction` - JSON paths to the `contextId` and `taskId` echoed back on each turn (default: `{"contextId": "result.contextId", "taskId": "result.id"}`). Keys must be `contextId` and `taskId`; only the paths are configurable.
-     * 
-     * *End-of-Conversation:*
-     * - `end_state_path` - Dot-notation path to the conversation status field (default: `result.status.state`)
-     * - `end_state_values` - List of status values that terminate the conversation (default: `["completed", "failed"]`)
-     * 
-     * *Custom Data:*
-     * - `custom_data` - Arbitrary JSON object merged into `params.metadata` on every chat request
-     * 
      * **For OUTBOUND_VOICE agents:**
      * - `trigger_call_headers` - JSON string with HTTP headers
      * - `trigger_call_payload` - JSON string with base payload
@@ -138,14 +113,43 @@ export interface CovalAgentsAPICreateAgentRequest {
      * **For WEBSOCKET agents:**
      * 
      * *Required:*
-     * - `endpoint` - WebSocket endpoint URL (must be wss://, validated)
-     * - `initialization_json` - JSON string payload sent on connection
+     * - `endpoint` - WebSocket endpoint URL (must be wss://, validated). Required in `direct` connection mode.
+     * 
+     * *Connection mode:*
+     * - `connection_mode` - `direct` (default) or `http_first`. In `http_first` mode Coval issues an HTTP request first and dials the WebSocket URL returned in the response.
+     * - `http_url`, `http_method`, `http_request_body`, `http_headers`, `websocket_url_response_path` - HTTP-first setup fields when `connection_mode=http_first`.
      * 
      * *Authentication (optional):*
-     * - `authorization_header` - Auth header sent during WebSocket handshake. Supports:
+     * - `authorization_header` - Auth header sent during the WebSocket handshake. Supports:
      *   - `"Bearer <token>"` → sent as `Authorization: Bearer <token>`
+     *   - `"Basic <base64-credentials>"` → sent as `Authorization: Basic <base64-credentials>`
      *   - `"X-API-Key <key>"` → sent as `X-API-Key: <key>`
-     * - `custom_headers` - JSON string of additional HTTP headers for WebSocket handshake
+     * - `custom_headers` - JSON object or JSON-encoded object string of additional HTTP headers for the WebSocket handshake.
+     * 
+     * *Initialization & handshake (optional):*
+     * - `initialization_json` - JSON object or JSON string payload sent after the WebSocket upgrade and before any ready-message wait.
+     * - `handshake_ready_message_type` - Message type to wait for before streaming audio (default `session_ready` in direct mode and empty in `http_first`; empty string skips the ready-message wait).
+     * - `handshake_requires_session_id` - Whether the ready message must include `session_id` (default `true` in direct mode and `false` in `http_first`).
+     * - `handshake_timeout_seconds` - Seconds Coval waits for the ready message (default `30`).
+     * 
+     * *Audio format (optional):*
+     * - `send_audio_template` - JSON template for outbound audio. Must contain `{{audio_data}}`. Setting it exactly to `{{audio_data}}` sends raw PCM bytes (default `{"type":"audio_chunk","data":"{{audio_data}}"}`).
+     * - `message_type_path` - Dot-notation path to the field naming the inbound message kind (default `type`).
+     * - `audio_message_type_value` - Value identifying an audio frame; use `*` to treat every JSON message as audio (default `audio_chunk`).
+     * - `audio_data_path` - Dot-notation path to the inbound base64 audio payload (default `data`).
+     * - `audio_encoding` - Inbound JSON audio payload encoding: `pcm` (default) or `mp3`.
+     * - `receive_audio_channels` - `1` for mono inbound JSON PCM or `2` for legacy stereo-to-mono averaging (default `2`).
+     * - `send_sample_rate_hertz` - Outbound sample rate. One of 8000, 16000, 24000, 48000 (default 16000).
+     * - `receive_sample_rate_hertz` - Inbound sample rate. One of 8000, 16000, 24000, 48000 (default 48000).
+     * - `pipeline_sample_rate_hertz` - Pipeline-internal rate; must remain 16000.
+     * - `pace_inbound_binary_audio` - Boolean, paces inbound binary PCM at real-time. Defaults on when outbound audio is configured for raw PCM bytes, off for JSON templates.
+     * - `send_media_template` - Outbound template for image attachments. Must contain `{{media_data}}`; may also include `{{media_name}}` and `{{mime_type}}`. Set exactly to `{{media_data}}` to send raw bytes, otherwise Coval base64-encodes the image into the JSON template.
+     * 
+     * *Non-audio event capture (optional):*
+     * - `non_audio_event_message_types` - List of message-type values to emit as `WebsocketEventFrame`s instead of dropping. Each match carries the message type, optional `event` name, and original payload. Useful for cart updates, transcript fragments, or session telemetry.
+     * 
+     * *Compatibility profile (optional):*
+     * - `websocket_compat_profile` - One of `generic` or `json_audio`. Forces the simulator routing decision. Use `json_audio` for the JSON audio preset shape.
      * 
      * @type {{ [key: string]: any; }}
      * @memberof CovalAgentsAPICreateAgentRequest

package/src/generated/models/CovalAgentsAPISimulatorType.ts

@@ -14,16 +14,17 @@
 
 
 /**
- * Agent type. 8 types are supported:
+ * Agent type. Active types that can be created via the v1 API:
  * 
  * - **MODEL_TYPE_VOICE**: Inbound voice calls (requires phone_number in E.164 format or SIP address)
  * - **MODEL_TYPE_OUTBOUND_VOICE**: Outbound voice calls (requires endpoint webhook URL)
  * - **MODEL_TYPE_CHAT**: Text-based chat agents (requires metadata.chat_endpoint)
- * - **MODEL_TYPE_CHAT_A2A**: A2A v2 JSON-RPC chat agents (requires metadata.chat_endpoint)
+ * - **MODEL_TYPE_CHAT_A2A**: A2A JSON-RPC chat agents (requires metadata.chat_endpoint)
+ * - **MODEL_TYPE_CHAT_WEBSOCKET**: Text chat over WebSocket (requires metadata.endpoint in direct mode)
  * - **MODEL_TYPE_SMS**: SMS messaging agents (requires phone_number in E.164 format)
- * - **MODEL_TYPE_WEBSOCKET**: WebSocket voice agents (requires metadata.endpoint wss:// URL and metadata.initialization_json)
- * - **MODEL_TYPE_OPENAI_REALTIME**: Voice-to-voice agents on the OpenAI Realtime API (requires metadata.openai_realtime_api_key)
- * - **MODEL_TYPE_GEMINI_REALTIME**: Voice-to-voice agents on Google Gemini Live (requires metadata.gemini_realtime_api_key)
+ * - **MODEL_TYPE_WEBSOCKET**: WebSocket voice agents (requires metadata.endpoint wss:// URL in direct mode; metadata.initialization_json is optional)
+ * - **MODEL_TYPE_OPENAI_REALTIME**: OpenAI Realtime voice-to-voice agents
+ * - **MODEL_TYPE_GEMINI_REALTIME**: Gemini Live voice-to-voice agents
  * 
  * @export
  */
@@ -32,6 +33,7 @@ export const CovalAgentsAPISimulatorType = {
     ModelTypeOutboundVoice: 'MODEL_TYPE_OUTBOUND_VOICE',
     ModelTypeChat: 'MODEL_TYPE_CHAT',
     ModelTypeChatA2A: 'MODEL_TYPE_CHAT_A2A',
+    ModelTypeChatWebsocket: 'MODEL_TYPE_CHAT_WEBSOCKET',
     ModelTypeSms: 'MODEL_TYPE_SMS',
     ModelTypeWebsocket: 'MODEL_TYPE_WEBSOCKET',
     ModelTypeOpenaiRealtime: 'MODEL_TYPE_OPENAI_REALTIME',

package/src/generated/models/CovalConversationsAPIConversationProgress.ts

@@ -43,17 +43,6 @@ export interface CovalConversationsAPIConversationProgress {
      * @memberof CovalConversationsAPIConversationProgress
      */
     in_progress_metrics?: number;
-    /**
-     * Number of metrics that were skipped (e.g., audio-dependent metric
-     * on a transcript-only conversation). Distinct from failed_metrics:
-     * skipped is expected / non-actionable. For a fully-processed
-     * conversation,
-     * `total_metrics == completed_metrics + failed_metrics + in_progress_metrics + skipped_metrics`.
-     * 
-     * @type {number}
-     * @memberof CovalConversationsAPIConversationProgress
-     */
-    skipped_metrics?: number;
 }
 
 /**
@@ -77,7 +66,6 @@ export function CovalConversationsAPIConversationProgressFromJSONTyped(json: any
         'completed_metrics': json['completed_metrics'] == null ? undefined : json['completed_metrics'],
         'failed_metrics': json['failed_metrics'] == null ? undefined : json['failed_metrics'],
         'in_progress_metrics': json['in_progress_metrics'] == null ? undefined : json['in_progress_metrics'],
-        'skipped_metrics': json['skipped_metrics'] == null ? undefined : json['skipped_metrics'],
     };
 }
 
@@ -96,7 +84,6 @@ export function CovalConversationsAPIConversationProgressToJSONTyped(value?: Cov
         'completed_metrics': value['completed_metrics'],
         'failed_metrics': value['failed_metrics'],
         'in_progress_metrics': value['in_progress_metrics'],
-        'skipped_metrics': value['skipped_metrics'],
     };
 }
 

package/src/generated/models/CovalConversationsAPIConversationResource.ts

@@ -81,7 +81,7 @@ export interface CovalConversationsAPIConversationResource {
      */
     has_audio?: boolean;
     /**
-     * Reference to agent resource (typically null for monitoring)
+     * Agent resource ID (22-character ShortUUID), if one was provided at submission
      * @type {string}
      * @memberof CovalConversationsAPIConversationResource
      */