@coval/sdk 0.7.1 → 0.9.3

package/src/generated/models/CovalUploadedConversationsAPISubmitUploadedConversationRequest.ts

@@ -109,7 +109,10 @@ export interface CovalUploadedConversationsAPISubmitUploadedConversationRequest
      */
     upload_id?: string;
     /**
-     * List of metric IDs to evaluate (22–26 character IDs).
+     * Metric IDs or exact legacy metric_name values to evaluate. IDs take precedence.
+     * Legacy names must resolve to a unique active metric visible in the request workspace.
+     * Display names are not accepted. Unknown, ambiguous, inactive, hidden, deleted, or
+     * inaccessible selections return 400 INVALID_ARGUMENT.
      * 
      * If not provided, uses your default metrics configured in the Coval dashboard.
      * 
@@ -157,7 +160,10 @@ export interface CovalUploadedConversationsAPISubmitUploadedConversationRequest
      */
     external_conversation_id?: string;
     /**
-     * When the conversation actually occurred (ISO 8601)
+     * The instant the audio recording begins, in ISO 8601 with sub-second precision. Coval uses it to align the recording with trace spans in the trace viewer and to locate traces around the call.
+     * 
+     * Optional. Without it, the trace viewer draws the recording without aligning it to spans.
+     * 
      * @type {Date}
      * @memberof CovalUploadedConversationsAPISubmitUploadedConversationRequest
      */

package/src/generated/models/CovalUploadedConversationsAPITranscriptMessage.ts

@@ -34,6 +34,11 @@ import {
  * 2. Each tool call has a unique `id` and function details
  * 3. Tool responses use `role: tool` with matching `tool_call_id`
  * 
+ * **Coval Tool Entries:**
+ * - A `role: tool` message with `is_tool_call` set is an entry recorded by Coval's simulator: a tool
+ *   invocation (`true`) or a setup payload record (`false`)
+ * - It carries `name` and `tool_call_owner` and needs no `tool_call_id`
+ * 
  * **Timing Information:**
  * - `start_time` and `end_time` are measured in seconds from the start of the audio (e.g., 0.0, 3.5, 7.2)
  * - Both `start_time` and `end_time` are **required** if:
@@ -96,6 +101,46 @@ export interface CovalUploadedConversationsAPITranscriptMessage {
      * @memberof CovalUploadedConversationsAPITranscriptMessage
      */
     tool_call_id?: string | null;
+    /**
+     * Tool or record name for a Coval tool entry (`role: tool` with `is_tool_call` set).
+     * 
+     * Coval's own simulator records each tool call made during a simulation, such as a persona
+     * keypad press (`dtmf_tool`), and each setup payload exchanged with the agent, as a `role: tool`
+     * message in this form.
+     * 
+     * @type {string}
+     * @memberof CovalUploadedConversationsAPITranscriptMessage
+     */
+    name?: string | null;
+    /**
+     * Present on a Coval tool entry: `true` for a tool invocation, `false` for a setup payload record.
+     * 
+     * A Coval tool entry needs no `tool_call_id`; the message `content` carries the call's arguments and
+     * result, or the recorded payload. `true` is only valid with `role: tool`.
+     * 
+     * @type {boolean}
+     * @memberof CovalUploadedConversationsAPITranscriptMessage
+     */
+    is_tool_call?: boolean | null;
+    /**
+     * Which side produced a Coval tool entry. Only valid with `role: tool`.
+     * 
+     * @type {CovalUploadedConversationsAPITranscriptMessageToolCallOwnerEnum}
+     * @memberof CovalUploadedConversationsAPITranscriptMessage
+     */
+    tool_call_owner?: CovalUploadedConversationsAPITranscriptMessageToolCallOwnerEnum | null;
+    /**
+     * `true` when the speaker was interrupted before finishing this message.
+     * @type {boolean}
+     * @memberof CovalUploadedConversationsAPITranscriptMessage
+     */
+    is_interrupted?: boolean | null;
+    /**
+     * `true` when `start_time` and `end_time` are estimated rather than measured.
+     * @type {boolean}
+     * @memberof CovalUploadedConversationsAPITranscriptMessage
+     */
+    is_estimated?: boolean | null;
     /**
      * When this message started, in seconds from the beginning of the conversation.
      * 
@@ -152,6 +197,15 @@ export const CovalUploadedConversationsAPITranscriptMessageRoleEnum = {
 } as const;
 export type CovalUploadedConversationsAPITranscriptMessageRoleEnum = typeof CovalUploadedConversationsAPITranscriptMessageRoleEnum[keyof typeof CovalUploadedConversationsAPITranscriptMessageRoleEnum];
 
+/**
+ * @export
+ */
+export const CovalUploadedConversationsAPITranscriptMessageToolCallOwnerEnum = {
+    User: 'user',
+    Assistant: 'assistant'
+} as const;
+export type CovalUploadedConversationsAPITranscriptMessageToolCallOwnerEnum = typeof CovalUploadedConversationsAPITranscriptMessageToolCallOwnerEnum[keyof typeof CovalUploadedConversationsAPITranscriptMessageToolCallOwnerEnum];
+
 
 /**
  * Check if a given object implements the CovalUploadedConversationsAPITranscriptMessage interface.
@@ -176,6 +230,11 @@ export function CovalUploadedConversationsAPITranscriptMessageFromJSONTyped(json
         'message': json['message'] == null ? undefined : json['message'],
         'tool_calls': json['tool_calls'] == null ? undefined : ((json['tool_calls'] as Array<any>).map(CovalUploadedConversationsAPIToolCallFromJSON)),
         'tool_call_id': json['tool_call_id'] == null ? undefined : json['tool_call_id'],
+        'name': json['name'] == null ? undefined : json['name'],
+        'is_tool_call': json['is_tool_call'] == null ? undefined : json['is_tool_call'],
+        'tool_call_owner': json['tool_call_owner'] == null ? undefined : json['tool_call_owner'],
+        'is_interrupted': json['is_interrupted'] == null ? undefined : json['is_interrupted'],
+        'is_estimated': json['is_estimated'] == null ? undefined : json['is_estimated'],
         'start_time': json['start_time'] == null ? undefined : json['start_time'],
         'end_time': json['end_time'] == null ? undefined : json['end_time'],
         'timestamp': json['timestamp'] == null ? undefined : (new Date(json['timestamp'])),
@@ -200,6 +259,11 @@ export function CovalUploadedConversationsAPITranscriptMessageToJSONTyped(value?
         'message': value['message'],
         'tool_calls': value['tool_calls'] == null ? undefined : ((value['tool_calls'] as Array<any>).map(CovalUploadedConversationsAPIToolCallToJSON)),
         'tool_call_id': value['tool_call_id'],
+        'name': value['name'],
+        'is_tool_call': value['is_tool_call'],
+        'tool_call_owner': value['tool_call_owner'],
+        'is_interrupted': value['is_interrupted'],
+        'is_estimated': value['is_estimated'],
         'start_time': value['start_time'],
         'end_time': value['end_time'],
         'timestamp': value['timestamp'] == null ? value['timestamp'] : value['timestamp'].toISOString(),

package/src/generated/models/CovalUploadedConversationsAPIUploadedConversationResource.ts

@@ -100,7 +100,10 @@ export interface CovalUploadedConversationsAPIUploadedConversationResource {
      */
     external_conversation_id?: string | null;
     /**
-     * When the conversation actually occurred (ISO 8601)
+     * The instant the audio recording begins, in ISO 8601 with sub-second precision. Coval uses it to align the recording with trace spans in the trace viewer and to locate traces around the call.
+     * 
+     * When it was not provided at submit, this is the time Coval received the conversation, and the trace viewer draws the recording without aligning it to spans.
+     * 
      * @type {Date}
      * @memberof CovalUploadedConversationsAPIUploadedConversationResource
      */

package/src/generated/models/PythonMetricsAPICreatePythonMetricDraftRequest.ts

@@ -0,0 +1,143 @@
+/* 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 { PythonMetricsAPIInputRequirements } from './PythonMetricsAPIInputRequirements.js';
+import {
+    PythonMetricsAPIInputRequirementsFromJSON,
+    PythonMetricsAPIInputRequirementsFromJSONTyped,
+    PythonMetricsAPIInputRequirementsToJSON,
+    PythonMetricsAPIInputRequirementsToJSONTyped,
+} from './PythonMetricsAPIInputRequirements.js';
+
+/**
+ * 
+ * @export
+ * @interface PythonMetricsAPICreatePythonMetricDraftRequest
+ */
+export interface PythonMetricsAPICreatePythonMetricDraftRequest {
+    /**
+     * Existing Python metric to revise; null creates a new metric.
+     * @type {string}
+     * @memberof PythonMetricsAPICreatePythonMetricDraftRequest
+     */
+    target_metric_id?: string | null;
+    /**
+     * Expected current version when revising a metric; null for a new metric.
+     * @type {string}
+     * @memberof PythonMetricsAPICreatePythonMetricDraftRequest
+     */
+    target_version_id?: string | null;
+    /**
+     * Display name for the metric.
+     * @type {string}
+     * @memberof PythonMetricsAPICreatePythonMetricDraftRequest
+     */
+    display_name: string;
+    /**
+     * What this metric measures.
+     * @type {string}
+     * @memberof PythonMetricsAPICreatePythonMetricDraftRequest
+     */
+    description?: string;
+    /**
+     * Python defining evaluate(conversation).
+     * @type {string}
+     * @memberof PythonMetricsAPICreatePythonMetricDraftRequest
+     */
+    source: string;
+    /**
+     * Scalar return type.
+     * @type {PythonMetricsAPICreatePythonMetricDraftRequestOutputTypeEnum}
+     * @memberof PythonMetricsAPICreatePythonMetricDraftRequest
+     */
+    output_type: PythonMetricsAPICreatePythonMetricDraftRequestOutputTypeEnum;
+    /**
+     * Optional numeric unit; null means unitless.
+     * @type {string}
+     * @memberof PythonMetricsAPICreatePythonMetricDraftRequest
+     */
+    unit?: string | null;
+    /**
+     * Inputs required to evaluate a conversation.
+     * @type {PythonMetricsAPIInputRequirements}
+     * @memberof PythonMetricsAPICreatePythonMetricDraftRequest
+     */
+    requirements?: PythonMetricsAPIInputRequirements;
+}
+
+
+/**
+ * @export
+ */
+export const PythonMetricsAPICreatePythonMetricDraftRequestOutputTypeEnum = {
+    Number: 'number',
+    Boolean: 'boolean'
+} as const;
+export type PythonMetricsAPICreatePythonMetricDraftRequestOutputTypeEnum = typeof PythonMetricsAPICreatePythonMetricDraftRequestOutputTypeEnum[keyof typeof PythonMetricsAPICreatePythonMetricDraftRequestOutputTypeEnum];
+
+
+/**
+ * Check if a given object implements the PythonMetricsAPICreatePythonMetricDraftRequest interface.
+ */
+export function instanceOfPythonMetricsAPICreatePythonMetricDraftRequest(value: object): value is PythonMetricsAPICreatePythonMetricDraftRequest {
+    if (!('display_name' in value) || value['display_name'] === undefined) return false;
+    if (!('source' in value) || value['source'] === undefined) return false;
+    if (!('output_type' in value) || value['output_type'] === undefined) return false;
+    return true;
+}
+
+export function PythonMetricsAPICreatePythonMetricDraftRequestFromJSON(json: any): PythonMetricsAPICreatePythonMetricDraftRequest {
+    return PythonMetricsAPICreatePythonMetricDraftRequestFromJSONTyped(json, false);
+}
+
+export function PythonMetricsAPICreatePythonMetricDraftRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): PythonMetricsAPICreatePythonMetricDraftRequest {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'target_metric_id': json['target_metric_id'] == null ? undefined : json['target_metric_id'],
+        'target_version_id': json['target_version_id'] == null ? undefined : json['target_version_id'],
+        'display_name': json['display_name'],
+        'description': json['description'] == null ? undefined : json['description'],
+        'source': json['source'],
+        'output_type': json['output_type'],
+        'unit': json['unit'] == null ? undefined : json['unit'],
+        'requirements': json['requirements'] == null ? undefined : PythonMetricsAPIInputRequirementsFromJSON(json['requirements']),
+    };
+}
+
+export function PythonMetricsAPICreatePythonMetricDraftRequestToJSON(json: any): PythonMetricsAPICreatePythonMetricDraftRequest {
+    return PythonMetricsAPICreatePythonMetricDraftRequestToJSONTyped(json, false);
+}
+
+export function PythonMetricsAPICreatePythonMetricDraftRequestToJSONTyped(value?: PythonMetricsAPICreatePythonMetricDraftRequest | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'target_metric_id': value['target_metric_id'],
+        'target_version_id': value['target_version_id'],
+        'display_name': value['display_name'],
+        'description': value['description'],
+        'source': value['source'],
+        'output_type': value['output_type'],
+        'unit': value['unit'],
+        'requirements': PythonMetricsAPIInputRequirementsToJSON(value['requirements']),
+    };
+}
+

package/src/generated/models/PythonMetricsAPIInputRequirements.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';
+/**
+ * Distinguish required inputs from optional, unavailable conversation data.
+ * @export
+ * @interface PythonMetricsAPIInputRequirements
+ */
+export interface PythonMetricsAPIInputRequirements {
+    /**
+     * 
+     * @type {boolean}
+     * @memberof PythonMetricsAPIInputRequirements
+     */
+    audio?: boolean;
+    /**
+     * 
+     * @type {boolean}
+     * @memberof PythonMetricsAPIInputRequirements
+     */
+    traces?: boolean;
+    /**
+     * 
+     * @type {Array<string>}
+     * @memberof PythonMetricsAPIInputRequirements
+     */
+    frame_tables?: Array<string>;
+}
+
+/**
+ * Check if a given object implements the PythonMetricsAPIInputRequirements interface.
+ */
+export function instanceOfPythonMetricsAPIInputRequirements(value: object): value is PythonMetricsAPIInputRequirements {
+    return true;
+}
+
+export function PythonMetricsAPIInputRequirementsFromJSON(json: any): PythonMetricsAPIInputRequirements {
+    return PythonMetricsAPIInputRequirementsFromJSONTyped(json, false);
+}
+
+export function PythonMetricsAPIInputRequirementsFromJSONTyped(json: any, ignoreDiscriminator: boolean): PythonMetricsAPIInputRequirements {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'audio': json['audio'] == null ? undefined : json['audio'],
+        'traces': json['traces'] == null ? undefined : json['traces'],
+        'frame_tables': json['frame_tables'] == null ? undefined : json['frame_tables'],
+    };
+}
+
+export function PythonMetricsAPIInputRequirementsToJSON(json: any): PythonMetricsAPIInputRequirements {
+    return PythonMetricsAPIInputRequirementsToJSONTyped(json, false);
+}
+
+export function PythonMetricsAPIInputRequirementsToJSONTyped(value?: PythonMetricsAPIInputRequirements | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'audio': value['audio'],
+        'traces': value['traces'],
+        'frame_tables': value['frame_tables'],
+    };
+}
+

package/src/generated/models/PythonMetricsAPIPreviewPythonMetricBody.ts

@@ -0,0 +1,66 @@
+/* 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 PythonMetricsAPIPreviewPythonMetricBody
+ */
+export interface PythonMetricsAPIPreviewPythonMetricBody {
+    /**
+     * Historical simulation or uploaded-conversation IDs to evaluate.
+     * @type {Array<string>}
+     * @memberof PythonMetricsAPIPreviewPythonMetricBody
+     */
+    simulation_output_ids: Array<string>;
+}
+
+/**
+ * Check if a given object implements the PythonMetricsAPIPreviewPythonMetricBody interface.
+ */
+export function instanceOfPythonMetricsAPIPreviewPythonMetricBody(value: object): value is PythonMetricsAPIPreviewPythonMetricBody {
+    if (!('simulation_output_ids' in value) || value['simulation_output_ids'] === undefined) return false;
+    return true;
+}
+
+export function PythonMetricsAPIPreviewPythonMetricBodyFromJSON(json: any): PythonMetricsAPIPreviewPythonMetricBody {
+    return PythonMetricsAPIPreviewPythonMetricBodyFromJSONTyped(json, false);
+}
+
+export function PythonMetricsAPIPreviewPythonMetricBodyFromJSONTyped(json: any, ignoreDiscriminator: boolean): PythonMetricsAPIPreviewPythonMetricBody {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'simulation_output_ids': json['simulation_output_ids'],
+    };
+}
+
+export function PythonMetricsAPIPreviewPythonMetricBodyToJSON(json: any): PythonMetricsAPIPreviewPythonMetricBody {
+    return PythonMetricsAPIPreviewPythonMetricBodyToJSONTyped(json, false);
+}
+
+export function PythonMetricsAPIPreviewPythonMetricBodyToJSONTyped(value?: PythonMetricsAPIPreviewPythonMetricBody | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'simulation_output_ids': value['simulation_output_ids'],
+    };
+}
+

package/src/generated/models/PythonMetricsAPIPublishPythonMetricBody.ts

@@ -0,0 +1,75 @@
+/* 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 PythonMetricsAPIPublishPythonMetricBody
+ */
+export interface PythonMetricsAPIPublishPythonMetricBody {
+    /**
+     * Successful previews of this exact draft to approve for publication.
+     * @type {Array<string>}
+     * @memberof PythonMetricsAPIPublishPythonMetricBody
+     */
+    preview_ids: Array<string>;
+    /**
+     * Fingerprint of the source and configuration the user approved.
+     * @type {string}
+     * @memberof PythonMetricsAPIPublishPythonMetricBody
+     */
+    fingerprint: string;
+}
+
+/**
+ * Check if a given object implements the PythonMetricsAPIPublishPythonMetricBody interface.
+ */
+export function instanceOfPythonMetricsAPIPublishPythonMetricBody(value: object): value is PythonMetricsAPIPublishPythonMetricBody {
+    if (!('preview_ids' in value) || value['preview_ids'] === undefined) return false;
+    if (!('fingerprint' in value) || value['fingerprint'] === undefined) return false;
+    return true;
+}
+
+export function PythonMetricsAPIPublishPythonMetricBodyFromJSON(json: any): PythonMetricsAPIPublishPythonMetricBody {
+    return PythonMetricsAPIPublishPythonMetricBodyFromJSONTyped(json, false);
+}
+
+export function PythonMetricsAPIPublishPythonMetricBodyFromJSONTyped(json: any, ignoreDiscriminator: boolean): PythonMetricsAPIPublishPythonMetricBody {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'preview_ids': json['preview_ids'],
+        'fingerprint': json['fingerprint'],
+    };
+}
+
+export function PythonMetricsAPIPublishPythonMetricBodyToJSON(json: any): PythonMetricsAPIPublishPythonMetricBody {
+    return PythonMetricsAPIPublishPythonMetricBodyToJSONTyped(json, false);
+}
+
+export function PythonMetricsAPIPublishPythonMetricBodyToJSONTyped(value?: PythonMetricsAPIPublishPythonMetricBody | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'preview_ids': value['preview_ids'],
+        'fingerprint': value['fingerprint'],
+    };
+}
+

package/src/generated/models/PythonMetricsAPIPublishPythonMetricResponse.ts

@@ -0,0 +1,75 @@
+/* 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 PythonMetricsAPIPublishPythonMetricResponse
+ */
+export interface PythonMetricsAPIPublishPythonMetricResponse {
+    /**
+     * 
+     * @type {string}
+     * @memberof PythonMetricsAPIPublishPythonMetricResponse
+     */
+    metric_id: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof PythonMetricsAPIPublishPythonMetricResponse
+     */
+    version_id: string;
+}
+
+/**
+ * Check if a given object implements the PythonMetricsAPIPublishPythonMetricResponse interface.
+ */
+export function instanceOfPythonMetricsAPIPublishPythonMetricResponse(value: object): value is PythonMetricsAPIPublishPythonMetricResponse {
+    if (!('metric_id' in value) || value['metric_id'] === undefined) return false;
+    if (!('version_id' in value) || value['version_id'] === undefined) return false;
+    return true;
+}
+
+export function PythonMetricsAPIPublishPythonMetricResponseFromJSON(json: any): PythonMetricsAPIPublishPythonMetricResponse {
+    return PythonMetricsAPIPublishPythonMetricResponseFromJSONTyped(json, false);
+}
+
+export function PythonMetricsAPIPublishPythonMetricResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): PythonMetricsAPIPublishPythonMetricResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'metric_id': json['metric_id'],
+        'version_id': json['version_id'],
+    };
+}
+
+export function PythonMetricsAPIPublishPythonMetricResponseToJSON(json: any): PythonMetricsAPIPublishPythonMetricResponse {
+    return PythonMetricsAPIPublishPythonMetricResponseToJSONTyped(json, false);
+}
+
+export function PythonMetricsAPIPublishPythonMetricResponseToJSONTyped(value?: PythonMetricsAPIPublishPythonMetricResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'metric_id': value['metric_id'],
+        'version_id': value['version_id'],
+    };
+}
+