@coval/sdk 0.7.0 → 0.7.2

package/src/generated/apis/ReviewProjectsApi.ts

@@ -184,7 +184,7 @@ export interface ReviewProjectsApiInterface {
     createReviewProjectRequestOpts(requestParameters: CreateReviewProjectRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Create a new review project. Automatically generates annotations for every (simulation, metric, assignee) combination. 
+     * Create a new review project defining assignments for the configured (simulation, metric, assignee) combinations. Assignments track review work separately from saved annotations. Submit review data with POST `/review-annotations` and use the returned annotation ID for later edits. 
      * @summary Create review project
      * @param {CovalReviewsAPICreateReviewProjectRequest} covalReviewsAPICreateReviewProjectRequest 
      * @param {string} [xCovalWorkspaceId] Workspace that scopes this operation. When omitted, the organization\&#39;s active default workspace is used when one can be resolved.
@@ -195,7 +195,7 @@ export interface ReviewProjectsApiInterface {
     createReviewProjectRaw(requestParameters: CreateReviewProjectRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalReviewsAPICreateReviewProjectResponse>>;
 
     /**
-     * Create a new review project. Automatically generates annotations for every (simulation, metric, assignee) combination. 
+     * Create a new review project defining assignments for the configured (simulation, metric, assignee) combinations. Assignments track review work separately from saved annotations. Submit review data with POST `/review-annotations` and use the returned annotation ID for later edits. 
      * Create review project
      */
     createReviewProject(requestParameters: CreateReviewProjectRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalReviewsAPICreateReviewProjectResponse>;
@@ -526,7 +526,7 @@ export class ReviewProjectsApi extends runtime.BaseAPI implements ReviewProjects
     }
 
     /**
-     * Create a new review project. Automatically generates annotations for every (simulation, metric, assignee) combination. 
+     * Create a new review project defining assignments for the configured (simulation, metric, assignee) combinations. Assignments track review work separately from saved annotations. Submit review data with POST `/review-annotations` and use the returned annotation ID for later edits. 
      * Create review project
      */
     async createReviewProjectRaw(requestParameters: CreateReviewProjectRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalReviewsAPICreateReviewProjectResponse>> {
@@ -537,7 +537,7 @@ export class ReviewProjectsApi extends runtime.BaseAPI implements ReviewProjects
     }
 
     /**
-     * Create a new review project. Automatically generates annotations for every (simulation, metric, assignee) combination. 
+     * Create a new review project defining assignments for the configured (simulation, metric, assignee) combinations. Assignments track review work separately from saved annotations. Submit review data with POST `/review-annotations` and use the returned annotation ID for later edits. 
      * Create review project
      */
     async createReviewProject(requestParameters: CreateReviewProjectRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalReviewsAPICreateReviewProjectResponse> {

package/src/generated/apis/SimulatedConversationsApi.ts

@@ -58,6 +58,16 @@ import {
     CovalSimulatedConversationsAPIUpdateSimulatedConversationResponseFromJSON,
     CovalSimulatedConversationsAPIUpdateSimulatedConversationResponseToJSON,
 } from '../models/CovalSimulatedConversationsAPIUpdateSimulatedConversationResponse.js';
+import {
+    type GetSimulationAttribute200Response,
+    GetSimulationAttribute200ResponseFromJSON,
+    GetSimulationAttribute200ResponseToJSON,
+} from '../models/GetSimulationAttribute200Response.js';
+import {
+    type GetSimulationConnect200Response,
+    GetSimulationConnect200ResponseFromJSON,
+    GetSimulationConnect200ResponseToJSON,
+} from '../models/GetSimulationConnect200Response.js';
 
 export interface DeleteSimulatedConversationRequest {
     simulationId: string;
@@ -71,6 +81,16 @@ export interface GetSimulatedConversationAudioRequest {
     simulationId: string;
 }
 
+export interface GetSimulationAttributeRequest {
+    simulationId: string;
+    attributeName: string;
+    xCovalWorkspaceId?: string;
+}
+
+export interface GetSimulationConnectRequest {
+    simulationId: string;
+}
+
 export interface ListSimulatedConversationsRequest {
     filter?: string;
     pageSize?: number;
@@ -172,6 +192,58 @@ export interface SimulatedConversationsApiInterface {
      */
     getSimulatedConversationAudio(requestParameters: GetSimulatedConversationAudioRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalSimulatedConversationsAPIGetSimulatedConversationAudioResponse>;
 
+    /**
+     * Creates request options for getSimulationAttribute without sending the request
+     * @param {string} simulationId Simulation output ID for the conversation. Pass {{simulation_output_id}} to your backend through a supported connection field and use the received value here. 
+     * @param {string} attributeName Exact, case-sensitive top-level key in the test case\&#39;s expected_output_json. Dots are literal characters. URL-encode special characters. 
+     * @param {string} [xCovalWorkspaceId] Workspace containing the simulation. Omit to use the organization\&#39;s default workspace. A resolved, accessible workspace is required. 
+     * @throws {RequiredError}
+     * @memberof SimulatedConversationsApiInterface
+     */
+    getSimulationAttributeRequestOpts(requestParameters: GetSimulationAttributeRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Returns an exact, case-sensitive top-level attribute from the simulation\'s current active test case. Names are literal keys, including dots, rather than paths. URL-encode names when necessary.  Requires simulations:read permission. The simulation, run, test case and test set must be accessible in the authenticated organization and workspace. A resolved workspace is required. Select one with X-Coval-Workspace-Id when the organization has no default workspace. Legacy unassigned rows are accessible only through the default workspace. Monitoring conversations and deleted runs are excluded. This endpoint can be used while a simulation is running or after it finishes.  JSON values return directly without an envelope. Null is a successful JSON value, while an absent attribute returns 404. Changes to the test case are visible on subsequent requests. This endpoint does not capture a snapshot or persist tool-call events.  An object with type: image_ref is reserved for image references and must contain attachment: <name>, matching exactly one media attachment on the test case. Image responses contain raw PNG/JPEG bytes, with a maximum size of 4 MiB. Ordinary objects without that marker return unchanged.  This deliberately returns content instead of an AIP-131 resource envelope: customer tool handlers consume the fixture directly, including image bytes. Both JSON and image response content are limited to 4 MiB.  See [Retrieve test-case attributes during a simulation](https://docs.coval.ai/concepts/attributes/overview#retrieve-test-case-attributes-during-a-simulation) for attribute setup, passing the simulation ID to your backend, and request examples. 
+     * @summary Retrieve a named simulation attribute
+     * @param {string} simulationId Simulation output ID for the conversation. Pass {{simulation_output_id}} to your backend through a supported connection field and use the received value here. 
+     * @param {string} attributeName Exact, case-sensitive top-level key in the test case\&#39;s expected_output_json. Dots are literal characters. URL-encode special characters. 
+     * @param {string} [xCovalWorkspaceId] Workspace containing the simulation. Omit to use the organization\&#39;s default workspace. A resolved, accessible workspace is required. 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SimulatedConversationsApiInterface
+     */
+    getSimulationAttributeRaw(requestParameters: GetSimulationAttributeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSimulationAttribute200Response>>;
+
+    /**
+     * Returns an exact, case-sensitive top-level attribute from the simulation\'s current active test case. Names are literal keys, including dots, rather than paths. URL-encode names when necessary.  Requires simulations:read permission. The simulation, run, test case and test set must be accessible in the authenticated organization and workspace. A resolved workspace is required. Select one with X-Coval-Workspace-Id when the organization has no default workspace. Legacy unassigned rows are accessible only through the default workspace. Monitoring conversations and deleted runs are excluded. This endpoint can be used while a simulation is running or after it finishes.  JSON values return directly without an envelope. Null is a successful JSON value, while an absent attribute returns 404. Changes to the test case are visible on subsequent requests. This endpoint does not capture a snapshot or persist tool-call events.  An object with type: image_ref is reserved for image references and must contain attachment: <name>, matching exactly one media attachment on the test case. Image responses contain raw PNG/JPEG bytes, with a maximum size of 4 MiB. Ordinary objects without that marker return unchanged.  This deliberately returns content instead of an AIP-131 resource envelope: customer tool handlers consume the fixture directly, including image bytes. Both JSON and image response content are limited to 4 MiB.  See [Retrieve test-case attributes during a simulation](https://docs.coval.ai/concepts/attributes/overview#retrieve-test-case-attributes-during-a-simulation) for attribute setup, passing the simulation ID to your backend, and request examples. 
+     * Retrieve a named simulation attribute
+     */
+    getSimulationAttribute(requestParameters: GetSimulationAttributeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetSimulationAttribute200Response>;
+
+    /**
+     * Creates request options for getSimulationConnect without sending the request
+     * @param {string} simulationId The simulation execution ID.
+     * @throws {RequiredError}
+     * @memberof SimulatedConversationsApiInterface
+     */
+    getSimulationConnectRequestOpts(requestParameters: GetSimulationConnectRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Returns the current SDK WebSocket connection state for a simulation. A READY response includes a short-lived, one-use token and a WSS URL. Poll until READY or a terminal status. The token is never returned after a successful connection, and responses must not be cached. 
+     * @summary Discover SDK WebSocket connection
+     * @param {string} simulationId The simulation execution ID.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SimulatedConversationsApiInterface
+     */
+    getSimulationConnectRaw(requestParameters: GetSimulationConnectRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSimulationConnect200Response>>;
+
+    /**
+     * Returns the current SDK WebSocket connection state for a simulation. A READY response includes a short-lived, one-use token and a WSS URL. Poll until READY or a terminal status. The token is never returned after a successful connection, and responses must not be cached. 
+     * Discover SDK WebSocket connection
+     */
+    getSimulationConnect(requestParameters: GetSimulationConnectRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetSimulationConnect200Response>;
+
     /**
      * Creates request options for listSimulatedConversations without sending the request
      * @param {string} [filter] Filter expression syntax.  Supported fields: &#x60;status&#x60;, &#x60;agent_id&#x60;, &#x60;persona_id&#x60;, &#x60;test_set_id&#x60;, &#x60;test_case_id&#x60;, &#x60;run_id&#x60;, &#x60;external_conversation_id&#x60;, &#x60;mutation_id&#x60;, &#x60;mutation_name&#x60;, &#x60;create_time&#x60;, &#x60;metric.{metric_id}&#x60;  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;  A &#x60;metric.{metric_id}&#x60; predicate (score filtering; number and string metrics, type inferred from the literal) returns only simulations whose metric matches, with each simulation\&#39;s value per metric embedded inline (&#x60;metric_values&#x60;). On this path the request is keyset-paginated, ordered newest-first by creation time, and supports only &#x60;AND&#x60; alongside &#x60;create_time&#x60;, &#x60;agent_id&#x60;, &#x60;status&#x60;, &#x60;test_set_id&#x60;, and &#x60;persona_id&#x60;; other fields and any non-default &#x60;order_by&#x60; are rejected with 400, and &#x60;page_size&#x60; is capped at 100.  Values may be unquoted or double-quoted. Values containing spaces must be quoted (e.g., &#x60;status&#x3D;\&quot;IN PROGRESS\&quot;&#x60;).  The &#x60;external_conversation_id&#x60; field is your system\&#39;s conversation ID for cross-system lookup.  **Mutation Filtering:** Use &#x60;mutation_id&#x60; or &#x60;mutation_name&#x60; to filter simulations by agent mutation variant. Base agent simulations have both &#x60;mutation_id&#x60; and &#x60;mutation_name&#x60; &#x3D; null. To get only base agent results, filter for simulations where &#x60;mutation_id&#x60; is not set. 
@@ -440,6 +512,120 @@ export class SimulatedConversationsApi extends runtime.BaseAPI implements Simula
         return await response.value();
     }
 
+    /**
+     * Creates request options for getSimulationAttribute without sending the request
+     */
+    async getSimulationAttributeRequestOpts(requestParameters: GetSimulationAttributeRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['simulationId'] == null) {
+            throw new runtime.RequiredError(
+                'simulationId',
+                'Required parameter "simulationId" was null or undefined when calling getSimulationAttribute().'
+            );
+        }
+
+        if (requestParameters['attributeName'] == null) {
+            throw new runtime.RequiredError(
+                'attributeName',
+                'Required parameter "attributeName" was null or undefined when calling getSimulationAttribute().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (requestParameters['xCovalWorkspaceId'] != null) {
+            headerParameters['X-Coval-Workspace-Id'] = String(requestParameters['xCovalWorkspaceId']);
+        }
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Simulated_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/simulations/{simulation_id}/attributes/{attribute_name}`;
+        urlPath = urlPath.replace('{simulation_id}', encodeURIComponent(String(requestParameters['simulationId'])));
+        urlPath = urlPath.replace('{attribute_name}', encodeURIComponent(String(requestParameters['attributeName'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Returns an exact, case-sensitive top-level attribute from the simulation\'s current active test case. Names are literal keys, including dots, rather than paths. URL-encode names when necessary.  Requires simulations:read permission. The simulation, run, test case and test set must be accessible in the authenticated organization and workspace. A resolved workspace is required. Select one with X-Coval-Workspace-Id when the organization has no default workspace. Legacy unassigned rows are accessible only through the default workspace. Monitoring conversations and deleted runs are excluded. This endpoint can be used while a simulation is running or after it finishes.  JSON values return directly without an envelope. Null is a successful JSON value, while an absent attribute returns 404. Changes to the test case are visible on subsequent requests. This endpoint does not capture a snapshot or persist tool-call events.  An object with type: image_ref is reserved for image references and must contain attachment: <name>, matching exactly one media attachment on the test case. Image responses contain raw PNG/JPEG bytes, with a maximum size of 4 MiB. Ordinary objects without that marker return unchanged.  This deliberately returns content instead of an AIP-131 resource envelope: customer tool handlers consume the fixture directly, including image bytes. Both JSON and image response content are limited to 4 MiB.  See [Retrieve test-case attributes during a simulation](https://docs.coval.ai/concepts/attributes/overview#retrieve-test-case-attributes-during-a-simulation) for attribute setup, passing the simulation ID to your backend, and request examples. 
+     * Retrieve a named simulation attribute
+     */
+    async getSimulationAttributeRaw(requestParameters: GetSimulationAttributeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSimulationAttribute200Response>> {
+        const requestOptions = await this.getSimulationAttributeRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetSimulationAttribute200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Returns an exact, case-sensitive top-level attribute from the simulation\'s current active test case. Names are literal keys, including dots, rather than paths. URL-encode names when necessary.  Requires simulations:read permission. The simulation, run, test case and test set must be accessible in the authenticated organization and workspace. A resolved workspace is required. Select one with X-Coval-Workspace-Id when the organization has no default workspace. Legacy unassigned rows are accessible only through the default workspace. Monitoring conversations and deleted runs are excluded. This endpoint can be used while a simulation is running or after it finishes.  JSON values return directly without an envelope. Null is a successful JSON value, while an absent attribute returns 404. Changes to the test case are visible on subsequent requests. This endpoint does not capture a snapshot or persist tool-call events.  An object with type: image_ref is reserved for image references and must contain attachment: <name>, matching exactly one media attachment on the test case. Image responses contain raw PNG/JPEG bytes, with a maximum size of 4 MiB. Ordinary objects without that marker return unchanged.  This deliberately returns content instead of an AIP-131 resource envelope: customer tool handlers consume the fixture directly, including image bytes. Both JSON and image response content are limited to 4 MiB.  See [Retrieve test-case attributes during a simulation](https://docs.coval.ai/concepts/attributes/overview#retrieve-test-case-attributes-during-a-simulation) for attribute setup, passing the simulation ID to your backend, and request examples. 
+     * Retrieve a named simulation attribute
+     */
+    async getSimulationAttribute(requestParameters: GetSimulationAttributeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetSimulationAttribute200Response> {
+        const response = await this.getSimulationAttributeRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getSimulationConnect without sending the request
+     */
+    async getSimulationConnectRequestOpts(requestParameters: GetSimulationConnectRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['simulationId'] == null) {
+            throw new runtime.RequiredError(
+                'simulationId',
+                'Required parameter "simulationId" was null or undefined when calling getSimulationConnect().'
+            );
+        }
+
+        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_Simulated_Conversations_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/simulations/{simulation_id}/connect`;
+        urlPath = urlPath.replace('{simulation_id}', encodeURIComponent(String(requestParameters['simulationId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Returns the current SDK WebSocket connection state for a simulation. A READY response includes a short-lived, one-use token and a WSS URL. Poll until READY or a terminal status. The token is never returned after a successful connection, and responses must not be cached. 
+     * Discover SDK WebSocket connection
+     */
+    async getSimulationConnectRaw(requestParameters: GetSimulationConnectRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSimulationConnect200Response>> {
+        const requestOptions = await this.getSimulationConnectRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetSimulationConnect200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Returns the current SDK WebSocket connection state for a simulation. A READY response includes a short-lived, one-use token and a WSS URL. Poll until READY or a terminal status. The token is never returned after a successful connection, and responses must not be cached. 
+     * Discover SDK WebSocket connection
+     */
+    async getSimulationConnect(requestParameters: GetSimulationConnectRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetSimulationConnect200Response> {
+        const response = await this.getSimulationConnectRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for listSimulatedConversations without sending the request
      */

package/src/generated/apis/index.ts

@@ -14,6 +14,7 @@ export * from './MonitorEventsApi.js';
 export * from './MonitorsApi.js';
 export * from './MutationsApi.js';
 export * from './OrganizationConversationsConfigApi.js';
+export * from './OrganizationUsersApi.js';
 export * from './PersonasApi.js';
 export * from './ReportsApi.js';
 export * from './ReviewAnnotationsApi.js';

package/src/generated/models/CovalAgentsAPIAgentResourceModelType.ts

@@ -29,6 +29,7 @@ export const CovalAgentsAPIAgentResourceModelType = {
     ModelTypeEmail: 'MODEL_TYPE_EMAIL',
     ModelTypeSms: 'MODEL_TYPE_SMS',
     ModelTypeWebsocket: 'MODEL_TYPE_WEBSOCKET',
+    ModelTypeSdkWebsocket: 'MODEL_TYPE_SDK_WEBSOCKET',
     ModelTypeOpenaiRealtime: 'MODEL_TYPE_OPENAI_REALTIME',
     ModelTypeGeminiRealtime: 'MODEL_TYPE_GEMINI_REALTIME',
     ModelTypeGrokRealtime: 'MODEL_TYPE_GROK_REALTIME',

package/src/generated/models/CovalAgentsAPISimulatorType.ts

@@ -24,6 +24,7 @@
  * - **MODEL_TYPE_EMAIL**: Email-based text agents
  * - **MODEL_TYPE_SMS**: SMS messaging agents (requires phone_number in E.164 format)
  * - **MODEL_TYPE_WEBSOCKET**: WebSocket voice agents (requires metadata.endpoint wss:// URL in direct mode; metadata.initialization_json is optional)
+ * - **MODEL_TYPE_SDK_WEBSOCKET**: Voice agents that connect outbound to the Cloudflare Durable Object relay using Coval Agent SDK.
  * - **MODEL_TYPE_LIVEKIT**: LiveKit agents (requires metadata.generate_token_endpoint and metadata.livekit_url)
  * - **MODEL_TYPE_DAILY**: Pipecat Cloud agents (requires metadata.pipecat_api_key and metadata.agent_name)
  * - **MODEL_TYPE_OPENAI_REALTIME**: OpenAI Realtime voice-to-voice agents
@@ -42,6 +43,7 @@ export const CovalAgentsAPISimulatorType = {
     ModelTypeEmail: 'MODEL_TYPE_EMAIL',
     ModelTypeSms: 'MODEL_TYPE_SMS',
     ModelTypeWebsocket: 'MODEL_TYPE_WEBSOCKET',
+    ModelTypeSdkWebsocket: 'MODEL_TYPE_SDK_WEBSOCKET',
     ModelTypeLivekit: 'MODEL_TYPE_LIVEKIT',
     ModelTypeDaily: 'MODEL_TYPE_DAILY',
     ModelTypeOpenaiRealtime: 'MODEL_TYPE_OPENAI_REALTIME',

package/src/generated/models/CovalMetricsAPIMetricVersionResource.ts

@@ -90,7 +90,7 @@ export interface CovalMetricsAPIMetricVersionResource {
      */
     label?: string | null;
     /**
-     * Who created this version (email address)
+     * Version author: canonical user ID for system-materialized versions; other entries may contain an email address or an empty string when unknown
      * @type {string}
      * @memberof CovalMetricsAPIMetricVersionResource
      */

package/src/generated/models/CovalMetricsAPIRecentlyDeletedMetricResource.ts

@@ -44,7 +44,7 @@ export interface CovalMetricsAPIRecentlyDeletedMetricResource {
      */
     delete_time?: Date | null;
     /**
-     * Who deleted the metric (email address)
+     * Canonical user ID of the last editor at deletion, or null when unknown
      * @type {string}
      * @memberof CovalMetricsAPIRecentlyDeletedMetricResource
      */

package/src/generated/models/CovalOrganizationAPIListOrganizationUsersResponse.ts

@@ -0,0 +1,81 @@
+/* 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 { mapValues } from '../runtime.js';
+import type { CovalOrganizationAPIOrganizationUser } from './CovalOrganizationAPIOrganizationUser.js';
+import {
+    CovalOrganizationAPIOrganizationUserFromJSON,
+    CovalOrganizationAPIOrganizationUserFromJSONTyped,
+    CovalOrganizationAPIOrganizationUserToJSON,
+    CovalOrganizationAPIOrganizationUserToJSONTyped,
+} from './CovalOrganizationAPIOrganizationUser.js';
+
+/**
+ * 
+ * @export
+ * @interface CovalOrganizationAPIListOrganizationUsersResponse
+ */
+export interface CovalOrganizationAPIListOrganizationUsersResponse {
+    /**
+     * Current organization members in this page.
+     * @type {Array<CovalOrganizationAPIOrganizationUser>}
+     * @memberof CovalOrganizationAPIListOrganizationUsersResponse
+     */
+    users?: Array<CovalOrganizationAPIOrganizationUser>;
+    /**
+     * Continue with this token; null when no pages remain.
+     * @type {string}
+     * @memberof CovalOrganizationAPIListOrganizationUsersResponse
+     */
+    next_page_token?: string | null;
+}
+
+/**
+ * Check if a given object implements the CovalOrganizationAPIListOrganizationUsersResponse interface.
+ */
+export function instanceOfCovalOrganizationAPIListOrganizationUsersResponse(value: object): value is CovalOrganizationAPIListOrganizationUsersResponse {
+    return true;
+}
+
+export function CovalOrganizationAPIListOrganizationUsersResponseFromJSON(json: any): CovalOrganizationAPIListOrganizationUsersResponse {
+    return CovalOrganizationAPIListOrganizationUsersResponseFromJSONTyped(json, false);
+}
+
+export function CovalOrganizationAPIListOrganizationUsersResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): CovalOrganizationAPIListOrganizationUsersResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'users': json['users'] == null ? undefined : ((json['users'] as Array<any>).map(CovalOrganizationAPIOrganizationUserFromJSON)),
+        'next_page_token': json['next_page_token'] == null ? undefined : json['next_page_token'],
+    };
+}
+
+export function CovalOrganizationAPIListOrganizationUsersResponseToJSON(json: any): CovalOrganizationAPIListOrganizationUsersResponse {
+    return CovalOrganizationAPIListOrganizationUsersResponseToJSONTyped(json, false);
+}
+
+export function CovalOrganizationAPIListOrganizationUsersResponseToJSONTyped(value?: CovalOrganizationAPIListOrganizationUsersResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'users': value['users'] == null ? undefined : ((value['users'] as Array<any>).map(CovalOrganizationAPIOrganizationUserToJSON)),
+        'next_page_token': value['next_page_token'],
+    };
+}
+

package/src/generated/models/CovalOrganizationAPIOrganizationUser.ts

@@ -0,0 +1,123 @@
+/* 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 { mapValues } from '../runtime.js';
+/**
+ * 
+ * @export
+ * @interface CovalOrganizationAPIOrganizationUser
+ */
+export interface CovalOrganizationAPIOrganizationUser {
+    /**
+     * Coval user ULID. Null when the member has not synced to Coval.
+     * @type {string}
+     * @memberof CovalOrganizationAPIOrganizationUser
+     */
+    id?: string | null;
+    /**
+     * Member's primary identifier from Clerk; empty when unavailable.
+     * @type {string}
+     * @memberof CovalOrganizationAPIOrganizationUser
+     */
+    email: string;
+    /**
+     * Coval display name, falling back to the Clerk name or email.
+     * @type {string}
+     * @memberof CovalOrganizationAPIOrganizationUser
+     */
+    display_name: string;
+    /**
+     * First name from Clerk, or null when unset.
+     * @type {string}
+     * @memberof CovalOrganizationAPIOrganizationUser
+     */
+    first_name?: string | null;
+    /**
+     * Last name from Clerk, or null when unset.
+     * @type {string}
+     * @memberof CovalOrganizationAPIOrganizationUser
+     */
+    last_name?: string | null;
+    /**
+     * Profile image URL from Clerk, or null when unset.
+     * @type {string}
+     * @memberof CovalOrganizationAPIOrganizationUser
+     */
+    image_url?: string | null;
+    /**
+     * Coval user creation time, or null before synchronization.
+     * @type {Date}
+     * @memberof CovalOrganizationAPIOrganizationUser
+     */
+    created_at?: Date | null;
+    /**
+     * Coval user update time, or null before synchronization.
+     * @type {Date}
+     * @memberof CovalOrganizationAPIOrganizationUser
+     */
+    last_updated_at?: Date | null;
+}
+
+/**
+ * Check if a given object implements the CovalOrganizationAPIOrganizationUser interface.
+ */
+export function instanceOfCovalOrganizationAPIOrganizationUser(value: object): value is CovalOrganizationAPIOrganizationUser {
+    if (!('email' in value) || value['email'] === undefined) return false;
+    if (!('display_name' in value) || value['display_name'] === undefined) return false;
+    return true;
+}
+
+export function CovalOrganizationAPIOrganizationUserFromJSON(json: any): CovalOrganizationAPIOrganizationUser {
+    return CovalOrganizationAPIOrganizationUserFromJSONTyped(json, false);
+}
+
+export function CovalOrganizationAPIOrganizationUserFromJSONTyped(json: any, ignoreDiscriminator: boolean): CovalOrganizationAPIOrganizationUser {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'id': json['id'] == null ? undefined : json['id'],
+        'email': json['email'],
+        'display_name': json['display_name'],
+        'first_name': json['first_name'] == null ? undefined : json['first_name'],
+        'last_name': json['last_name'] == null ? undefined : json['last_name'],
+        'image_url': json['image_url'] == null ? undefined : json['image_url'],
+        'created_at': json['created_at'] == null ? undefined : (new Date(json['created_at'])),
+        'last_updated_at': json['last_updated_at'] == null ? undefined : (new Date(json['last_updated_at'])),
+    };
+}
+
+export function CovalOrganizationAPIOrganizationUserToJSON(json: any): CovalOrganizationAPIOrganizationUser {
+    return CovalOrganizationAPIOrganizationUserToJSONTyped(json, false);
+}
+
+export function CovalOrganizationAPIOrganizationUserToJSONTyped(value?: CovalOrganizationAPIOrganizationUser | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'id': value['id'],
+        'email': value['email'],
+        'display_name': value['display_name'],
+        'first_name': value['first_name'],
+        'last_name': value['last_name'],
+        'image_url': value['image_url'],
+        'created_at': value['created_at'] == null ? value['created_at'] : value['created_at'].toISOString(),
+        'last_updated_at': value['last_updated_at'] == null ? value['last_updated_at'] : value['last_updated_at'].toISOString(),
+    };
+}
+

package/src/generated/models/CovalReviewsAPICreateReviewAnnotationRequest.ts

@@ -44,13 +44,13 @@ export interface CovalReviewsAPICreateReviewAnnotationRequest {
      */
     assignee?: string | null;
     /**
-     * Optional ground truth numeric value (auto-completes annotation)
+     * Optional ground truth numeric value; completion also depends on applicable project rules
      * @type {number}
      * @memberof CovalReviewsAPICreateReviewAnnotationRequest
      */
     ground_truth_float_value?: number | null;
     /**
-     * Optional ground truth string value (auto-completes annotation)
+     * Optional ground truth string value; completion also depends on applicable project rules
      * @type {string}
      * @memberof CovalReviewsAPICreateReviewAnnotationRequest
      */

package/src/generated/models/CovalReviewsAPIProjectType.ts

@@ -14,7 +14,7 @@
 
 
 /**
- * Project type: COLLABORATIVE (shared annotations) or INDIVIDUAL (per-assignee annotations)
+ * Project review workflow type: PROJECT_COLLABORATIVE or PROJECT_INDIVIDUAL
  * @export
  */
 export const CovalReviewsAPIProjectType = {

package/src/generated/models/CovalReviewsAPIReviewAnnotationResource.ts

@@ -36,7 +36,7 @@ import {
 } from './CovalReviewsAPIAnnotationStatus.js';
 
 /**
- * A single review annotation resource.
+ * Saved review data for a simulation output, metric, and reviewer.
  * @export
  * @interface CovalReviewsAPIReviewAnnotationResource
  */
@@ -48,7 +48,7 @@ export interface CovalReviewsAPIReviewAnnotationResource {
      */
     name: string;
     /**
-     * Unique annotation ID
+     * Saved annotation ID used for GET, PATCH, and DELETE; not a project assignment ID
      * @type {string}
      * @memberof CovalReviewsAPIReviewAnnotationResource
      */

package/src/generated/models/CovalReviewsAPIReviewAnnotationWithMetricVersionResource.ts

@@ -48,7 +48,7 @@ export interface CovalReviewsAPIReviewAnnotationWithMetricVersionResource {
      */
     name: string;
     /**
-     * Unique annotation ID
+     * Saved annotation ID used for GET, PATCH, and DELETE; not a project assignment ID
      * @type {string}
      * @memberof CovalReviewsAPIReviewAnnotationWithMetricVersionResource
      */

package/src/generated/models/CovalReviewsAPIReviewProjectResource.ts

@@ -142,6 +142,12 @@ export interface CovalReviewsAPIReviewProjectResource {
      * @memberof CovalReviewsAPIReviewProjectResource
      */
     allow_metric_skipping?: boolean;
+    /**
+     * Metric IDs eligible for skipping. Null means all linked metrics; an empty list means none.
+     * @type {Array<string>}
+     * @memberof CovalReviewsAPIReviewProjectResource
+     */
+    skippable_metric_ids?: Array<string> | null;
     /**
      * Creation timestamp (ISO 8601)
      * @type {Date}
@@ -268,6 +274,7 @@ export function CovalReviewsAPIReviewProjectResourceFromJSONTyped(json: any, ign
         'project_rules': json['project_rules'] == null ? undefined : ((json['project_rules'] as Array<any>).map(CovalReviewsAPIProjectRuleFromJSON)),
         'enforced_collaboration': json['enforced_collaboration'] == null ? undefined : json['enforced_collaboration'],
         'allow_metric_skipping': json['allow_metric_skipping'] == null ? undefined : json['allow_metric_skipping'],
+        'skippable_metric_ids': json['skippable_metric_ids'] == null ? undefined : json['skippable_metric_ids'],
         'create_time': (new Date(json['create_time'])),
         'update_time': (new Date(json['update_time'])),
         'blind_labeling_shown_metric_ids': json['blind_labeling_shown_metric_ids'] == null ? undefined : json['blind_labeling_shown_metric_ids'],
@@ -305,6 +312,7 @@ export function CovalReviewsAPIReviewProjectResourceToJSONTyped(value?: Omit<Cov
         'project_rules': value['project_rules'] == null ? undefined : ((value['project_rules'] as Array<any>).map(CovalReviewsAPIProjectRuleToJSON)),
         'enforced_collaboration': value['enforced_collaboration'],
         'allow_metric_skipping': value['allow_metric_skipping'],
+        'skippable_metric_ids': value['skippable_metric_ids'],
         'create_time': value['create_time'].toISOString(),
         'update_time': value['update_time'].toISOString(),
         'blind_labeling_shown_metric_ids': value['blind_labeling_shown_metric_ids'],

package/src/generated/models/CovalReviewsAPIUpdateReviewAnnotationRequest.ts

@@ -28,13 +28,13 @@ import {
  */
 export interface CovalReviewsAPIUpdateReviewAnnotationRequest {
     /**
-     * Ground truth numeric value (auto-completes annotation)
+     * Ground truth numeric value; completion also depends on applicable project rules
      * @type {number}
      * @memberof CovalReviewsAPIUpdateReviewAnnotationRequest
      */
     ground_truth_float_value?: number | null;
     /**
-     * Ground truth string value (auto-completes annotation)
+     * Ground truth string value; completion also depends on applicable project rules
      * @type {string}
      * @memberof CovalReviewsAPIUpdateReviewAnnotationRequest
      */
@@ -58,7 +58,11 @@ export interface CovalReviewsAPIUpdateReviewAnnotationRequest {
      */
     priority?: CovalReviewsAPIAnnotationPriority;
     /**
-     * Reassign to a different reviewer
+     * Existing reviewer email, retained for compatibility. Omission, null,
+     * or the current value leaves the reviewer unchanged. A different
+     * non-null value is rejected with HTTP 400 (`INVALID_ARGUMENT`);
+     * create an annotation for that reviewer instead.
+     * 
      * @type {string}
      * @memberof CovalReviewsAPIUpdateReviewAnnotationRequest
      */