@coval/sdk 0.2.1 → 0.4.0

package/src/generated/models/CovalConversationsAPIPhoneEndpoint.ts

@@ -0,0 +1,85 @@
+/* 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 CovalConversationsAPIPhoneEndpoint
+ */
+export interface CovalConversationsAPIPhoneEndpoint {
+    /**
+     * Endpoint kind discriminator
+     * @type {CovalConversationsAPIPhoneEndpointTypeEnum}
+     * @memberof CovalConversationsAPIPhoneEndpoint
+     */
+    type: CovalConversationsAPIPhoneEndpointTypeEnum;
+    /**
+     * Phone number in E.164 format
+     * @type {string}
+     * @memberof CovalConversationsAPIPhoneEndpoint
+     */
+    value: string;
+}
+
+
+/**
+ * @export
+ */
+export const CovalConversationsAPIPhoneEndpointTypeEnum = {
+    Phone: 'phone'
+} as const;
+export type CovalConversationsAPIPhoneEndpointTypeEnum = typeof CovalConversationsAPIPhoneEndpointTypeEnum[keyof typeof CovalConversationsAPIPhoneEndpointTypeEnum];
+
+
+/**
+ * Check if a given object implements the CovalConversationsAPIPhoneEndpoint interface.
+ */
+export function instanceOfCovalConversationsAPIPhoneEndpoint(value: object): value is CovalConversationsAPIPhoneEndpoint {
+    if (!('type' in value) || value['type'] === undefined) return false;
+    if (!('value' in value) || value['value'] === undefined) return false;
+    return true;
+}
+
+export function CovalConversationsAPIPhoneEndpointFromJSON(json: any): CovalConversationsAPIPhoneEndpoint {
+    return CovalConversationsAPIPhoneEndpointFromJSONTyped(json, false);
+}
+
+export function CovalConversationsAPIPhoneEndpointFromJSONTyped(json: any, ignoreDiscriminator: boolean): CovalConversationsAPIPhoneEndpoint {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'type': json['type'],
+        'value': json['value'],
+    };
+}
+
+export function CovalConversationsAPIPhoneEndpointToJSON(json: any): CovalConversationsAPIPhoneEndpoint {
+    return CovalConversationsAPIPhoneEndpointToJSONTyped(json, false);
+}
+
+export function CovalConversationsAPIPhoneEndpointToJSONTyped(value?: CovalConversationsAPIPhoneEndpoint | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'type': value['type'],
+        'value': value['value'],
+    };
+}
+

package/src/generated/models/CovalConversationsAPISimpleMetricOutput.ts

@@ -40,6 +40,12 @@ export interface CovalConversationsAPISimpleMetricOutput {
      * @memberof CovalConversationsAPISimpleMetricOutput
      */
     metric_id: string;
+    /**
+     * ULID of the metric version this output was scored against (null for outputs produced before metric versioning landed)
+     * @type {string}
+     * @memberof CovalConversationsAPISimpleMetricOutput
+     */
+    metric_version_ulid?: string | null;
     /**
      * 
      * @type {CovalConversationsAPISimpleMetricOutputValue}
@@ -52,6 +58,24 @@ export interface CovalConversationsAPISimpleMetricOutput {
      * @memberof CovalConversationsAPISimpleMetricOutput
      */
     status: CovalConversationsAPISimpleMetricOutputStatusEnum;
+    /**
+     * Stored reason for the current status, including the actionable reason a metric was skipped or failed. Null when no reason was recorded.
+     * @type {string}
+     * @memberof CovalConversationsAPISimpleMetricOutput
+     */
+    status_reason?: string | null;
+    /**
+     * The LLM judge's reasoning for this metric output, as a flat string. Null for metrics that produce no explanation (non-judge metrics) or when the output is not yet computed. This is a convenience surfacing of the reasoning that otherwise lives nested under result.llm.answer_explanation (or result.explanation); it is populated in both the list and single-output responses so callers do not have to request the full result object to read it.
+     * @type {string}
+     * @memberof CovalConversationsAPISimpleMetricOutput
+     */
+    explanation?: string | null;
+    /**
+     * Structured metric result. Its keys depend on the metric type — for LLM-judge metrics the judge's reasoning is at result.llm.answer_explanation and the evaluation prompt at result.llm.prompt. Null for metrics that produce no structured result.
+     * @type {{ [key: string]: any; }}
+     * @memberof CovalConversationsAPISimpleMetricOutput
+     */
+    result?: { [key: string]: any; } | null;
 }
 
 
@@ -62,7 +86,9 @@ export const CovalConversationsAPISimpleMetricOutputStatusEnum = {
     InQueue: 'IN QUEUE',
     InProgress: 'IN PROGRESS',
     Completed: 'COMPLETED',
-    Failed: 'FAILED'
+    Skipped: 'SKIPPED',
+    Failed: 'FAILED',
+    Cancelled: 'CANCELLED'
 } as const;
 export type CovalConversationsAPISimpleMetricOutputStatusEnum = typeof CovalConversationsAPISimpleMetricOutputStatusEnum[keyof typeof CovalConversationsAPISimpleMetricOutputStatusEnum];
 
@@ -89,8 +115,12 @@ export function CovalConversationsAPISimpleMetricOutputFromJSONTyped(json: any,
         
         'metric_output_id': json['metric_output_id'],
         'metric_id': json['metric_id'],
+        'metric_version_ulid': json['metric_version_ulid'] == null ? undefined : json['metric_version_ulid'],
         'value': json['value'] == null ? undefined : CovalConversationsAPISimpleMetricOutputValueFromJSON(json['value']),
         'status': json['status'],
+        'status_reason': json['status_reason'] == null ? undefined : json['status_reason'],
+        'explanation': json['explanation'] == null ? undefined : json['explanation'],
+        'result': json['result'] == null ? undefined : json['result'],
     };
 }
 
@@ -107,8 +137,12 @@ export function CovalConversationsAPISimpleMetricOutputToJSONTyped(value?: Coval
         
         'metric_output_id': value['metric_output_id'],
         'metric_id': value['metric_id'],
+        'metric_version_ulid': value['metric_version_ulid'],
         'value': CovalConversationsAPISimpleMetricOutputValueToJSON(value['value']),
         'status': value['status'],
+        'status_reason': value['status_reason'],
+        'explanation': value['explanation'],
+        'result': value['result'],
     };
 }
 

package/src/generated/models/CovalConversationsAPISipEndpoint.ts

@@ -0,0 +1,85 @@
+/* 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 CovalConversationsAPISipEndpoint
+ */
+export interface CovalConversationsAPISipEndpoint {
+    /**
+     * Endpoint kind discriminator
+     * @type {CovalConversationsAPISipEndpointTypeEnum}
+     * @memberof CovalConversationsAPISipEndpoint
+     */
+    type: CovalConversationsAPISipEndpointTypeEnum;
+    /**
+     * SIP URI
+     * @type {string}
+     * @memberof CovalConversationsAPISipEndpoint
+     */
+    value: string;
+}
+
+
+/**
+ * @export
+ */
+export const CovalConversationsAPISipEndpointTypeEnum = {
+    Sip: 'sip'
+} as const;
+export type CovalConversationsAPISipEndpointTypeEnum = typeof CovalConversationsAPISipEndpointTypeEnum[keyof typeof CovalConversationsAPISipEndpointTypeEnum];
+
+
+/**
+ * Check if a given object implements the CovalConversationsAPISipEndpoint interface.
+ */
+export function instanceOfCovalConversationsAPISipEndpoint(value: object): value is CovalConversationsAPISipEndpoint {
+    if (!('type' in value) || value['type'] === undefined) return false;
+    if (!('value' in value) || value['value'] === undefined) return false;
+    return true;
+}
+
+export function CovalConversationsAPISipEndpointFromJSON(json: any): CovalConversationsAPISipEndpoint {
+    return CovalConversationsAPISipEndpointFromJSONTyped(json, false);
+}
+
+export function CovalConversationsAPISipEndpointFromJSONTyped(json: any, ignoreDiscriminator: boolean): CovalConversationsAPISipEndpoint {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'type': json['type'],
+        'value': json['value'],
+    };
+}
+
+export function CovalConversationsAPISipEndpointToJSON(json: any): CovalConversationsAPISipEndpoint {
+    return CovalConversationsAPISipEndpointToJSONTyped(json, false);
+}
+
+export function CovalConversationsAPISipEndpointToJSONTyped(value?: CovalConversationsAPISipEndpoint | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'type': value['type'],
+        'value': value['value'],
+    };
+}
+

package/src/generated/models/CovalConversationsAPISubmitConversationRequest.ts

@@ -123,6 +123,17 @@ export interface CovalConversationsAPISubmitConversationRequest {
      * @memberof CovalConversationsAPISubmitConversationRequest
      */
     metadata?: { [key: string]: any; };
+    /**
+     * Optional tags to apply to this conversation for filtering and organization.
+     * 
+     * Tags are normalized case-insensitively and stored on the monitoring
+     * conversation's backing run. Use them to group uploaded conversations
+     * by product, workflow, customer segment, or other operational slices.
+     * 
+     * @type {Array<string>}
+     * @memberof CovalConversationsAPISubmitConversationRequest
+     */
+    tags?: Array<string>;
     /**
      * External conversation ID from your system.
      * 
@@ -175,6 +186,7 @@ export function CovalConversationsAPISubmitConversationRequestFromJSONTyped(json
         'upload_id': json['upload_id'] == null ? undefined : json['upload_id'],
         'metrics': json['metrics'] == null ? undefined : json['metrics'],
         'metadata': json['metadata'] == null ? undefined : json['metadata'],
+        'tags': json['tags'] == null ? undefined : json['tags'],
         'external_conversation_id': json['external_conversation_id'] == null ? undefined : json['external_conversation_id'],
         'occurred_at': json['occurred_at'] == null ? undefined : (new Date(json['occurred_at'])),
         'agent_id': json['agent_id'] == null ? undefined : json['agent_id'],
@@ -197,6 +209,7 @@ export function CovalConversationsAPISubmitConversationRequestToJSONTyped(value?
         'upload_id': value['upload_id'],
         'metrics': value['metrics'],
         'metadata': value['metadata'],
+        'tags': value['tags'],
         'external_conversation_id': value['external_conversation_id'],
         'occurred_at': value['occurred_at'] == null ? value['occurred_at'] : value['occurred_at'].toISOString(),
         'agent_id': value['agent_id'],

package/src/generated/models/CovalConversationsAPIWebsocketEndpoint.ts

@@ -0,0 +1,85 @@
+/* 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 CovalConversationsAPIWebsocketEndpoint
+ */
+export interface CovalConversationsAPIWebsocketEndpoint {
+    /**
+     * Endpoint kind discriminator
+     * @type {CovalConversationsAPIWebsocketEndpointTypeEnum}
+     * @memberof CovalConversationsAPIWebsocketEndpoint
+     */
+    type: CovalConversationsAPIWebsocketEndpointTypeEnum;
+    /**
+     * WebSocket URL
+     * @type {string}
+     * @memberof CovalConversationsAPIWebsocketEndpoint
+     */
+    value: string;
+}
+
+
+/**
+ * @export
+ */
+export const CovalConversationsAPIWebsocketEndpointTypeEnum = {
+    Websocket: 'websocket'
+} as const;
+export type CovalConversationsAPIWebsocketEndpointTypeEnum = typeof CovalConversationsAPIWebsocketEndpointTypeEnum[keyof typeof CovalConversationsAPIWebsocketEndpointTypeEnum];
+
+
+/**
+ * Check if a given object implements the CovalConversationsAPIWebsocketEndpoint interface.
+ */
+export function instanceOfCovalConversationsAPIWebsocketEndpoint(value: object): value is CovalConversationsAPIWebsocketEndpoint {
+    if (!('type' in value) || value['type'] === undefined) return false;
+    if (!('value' in value) || value['value'] === undefined) return false;
+    return true;
+}
+
+export function CovalConversationsAPIWebsocketEndpointFromJSON(json: any): CovalConversationsAPIWebsocketEndpoint {
+    return CovalConversationsAPIWebsocketEndpointFromJSONTyped(json, false);
+}
+
+export function CovalConversationsAPIWebsocketEndpointFromJSONTyped(json: any, ignoreDiscriminator: boolean): CovalConversationsAPIWebsocketEndpoint {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'type': json['type'],
+        'value': json['value'],
+    };
+}
+
+export function CovalConversationsAPIWebsocketEndpointToJSON(json: any): CovalConversationsAPIWebsocketEndpoint {
+    return CovalConversationsAPIWebsocketEndpointToJSONTyped(json, false);
+}
+
+export function CovalConversationsAPIWebsocketEndpointToJSONTyped(value?: CovalConversationsAPIWebsocketEndpoint | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'type': value['type'],
+        'value': value['value'],
+    };
+}
+

package/src/generated/models/CovalDashboardsAPIAggregationType.ts

@@ -23,7 +23,10 @@ export const CovalDashboardsAPIAggregationType = {
     Avg: 'avg',
     Max: 'max',
     Min: 'min',
-    Success: 'success'
+    Success: 'success',
+    P90: 'p90',
+    P95: 'p95',
+    P99: 'p99'
 } as const;
 export type CovalDashboardsAPIAggregationType = typeof CovalDashboardsAPIAggregationType[keyof typeof CovalDashboardsAPIAggregationType];
 

package/src/generated/models/CovalDashboardsAPICreateDashboardRequest.ts

@@ -25,6 +25,36 @@ export interface CovalDashboardsAPICreateDashboardRequest {
      * @memberof CovalDashboardsAPICreateDashboardRequest
      */
     display_name: string;
+    /**
+     * Optional free-text description
+     * @type {string}
+     * @memberof CovalDashboardsAPICreateDashboardRequest
+     */
+    description?: string;
+    /**
+     * Mark the dashboard as a favorite
+     * @type {boolean}
+     * @memberof CovalDashboardsAPICreateDashboardRequest
+     */
+    is_favorite?: boolean;
+    /**
+     * Mark as the organization's default dashboard. Omit to auto-default the first dashboard in the organization; set true to make this the default (any existing default is unset).
+     * @type {boolean}
+     * @memberof CovalDashboardsAPICreateDashboardRequest
+     */
+    is_default?: boolean | null;
+    /**
+     * Ordering position. Omit to append to the end.
+     * @type {number}
+     * @memberof CovalDashboardsAPICreateDashboardRequest
+     */
+    position?: number;
+    /**
+     * Free-form JSON config blob (max 50000 bytes serialized)
+     * @type {{ [key: string]: any; }}
+     * @memberof CovalDashboardsAPICreateDashboardRequest
+     */
+    config?: { [key: string]: any; };
 }
 
 /**
@@ -46,6 +76,11 @@ export function CovalDashboardsAPICreateDashboardRequestFromJSONTyped(json: any,
     return {
         
         'display_name': json['display_name'],
+        'description': json['description'] == null ? undefined : json['description'],
+        'is_favorite': json['is_favorite'] == null ? undefined : json['is_favorite'],
+        'is_default': json['is_default'] == null ? undefined : json['is_default'],
+        'position': json['position'] == null ? undefined : json['position'],
+        'config': json['config'] == null ? undefined : json['config'],
     };
 }
 
@@ -61,6 +96,11 @@ export function CovalDashboardsAPICreateDashboardRequestToJSONTyped(value?: Cova
     return {
         
         'display_name': value['display_name'],
+        'description': value['description'],
+        'is_favorite': value['is_favorite'],
+        'is_default': value['is_default'],
+        'position': value['position'],
+        'config': value['config'],
     };
 }
 

package/src/generated/models/CovalDashboardsAPICreateWidgetRequest.ts

@@ -41,11 +41,12 @@ export interface CovalDashboardsAPICreateWidgetRequest {
      */
     display_name: string;
     /**
+     * Widget type. Optional; defaults to `chart` when omitted.
      * 
      * @type {CovalDashboardsAPIWidgetType}
      * @memberof CovalDashboardsAPICreateWidgetRequest
      */
-    type: CovalDashboardsAPIWidgetType;
+    type?: CovalDashboardsAPIWidgetType;
     /**
      * Grid column position
      * @type {number}
@@ -85,7 +86,6 @@ export interface CovalDashboardsAPICreateWidgetRequest {
  */
 export function instanceOfCovalDashboardsAPICreateWidgetRequest(value: object): value is CovalDashboardsAPICreateWidgetRequest {
     if (!('display_name' in value) || value['display_name'] === undefined) return false;
-    if (!('type' in value) || value['type'] === undefined) return false;
     return true;
 }
 
@@ -100,7 +100,7 @@ export function CovalDashboardsAPICreateWidgetRequestFromJSONTyped(json: any, ig
     return {
         
         'display_name': json['display_name'],
-        'type': CovalDashboardsAPIWidgetTypeFromJSON(json['type']),
+        'type': json['type'] == null ? undefined : CovalDashboardsAPIWidgetTypeFromJSON(json['type']),
         'grid_x': json['grid_x'] == null ? undefined : json['grid_x'],
         'grid_y': json['grid_y'] == null ? undefined : json['grid_y'],
         'grid_w': json['grid_w'] == null ? undefined : json['grid_w'],

package/src/generated/models/CovalDashboardsAPIDashboardResource.ts

@@ -31,6 +31,36 @@ export interface CovalDashboardsAPIDashboardResource {
      * @memberof CovalDashboardsAPIDashboardResource
      */
     display_name?: string | null;
+    /**
+     * Free-text dashboard description
+     * @type {string}
+     * @memberof CovalDashboardsAPIDashboardResource
+     */
+    description?: string | null;
+    /**
+     * Whether this is the organization's default dashboard (the one shown when no dashboard is specified)
+     * @type {boolean}
+     * @memberof CovalDashboardsAPIDashboardResource
+     */
+    is_default?: boolean;
+    /**
+     * Whether the dashboard is marked as a favorite
+     * @type {boolean}
+     * @memberof CovalDashboardsAPIDashboardResource
+     */
+    is_favorite?: boolean;
+    /**
+     * Ordering position within the organization's dashboards
+     * @type {number}
+     * @memberof CovalDashboardsAPIDashboardResource
+     */
+    position?: number;
+    /**
+     * Free-form JSON config blob (e.g. saved date preferences)
+     * @type {{ [key: string]: any; }}
+     * @memberof CovalDashboardsAPIDashboardResource
+     */
+    config?: { [key: string]: any; } | null;
     /**
      * Creation timestamp (ISO 8601)
      * @type {Date}
@@ -67,6 +97,11 @@ export function CovalDashboardsAPIDashboardResourceFromJSONTyped(json: any, igno
         
         'name': json['name'],
         'display_name': json['display_name'] == null ? undefined : json['display_name'],
+        'description': json['description'] == null ? undefined : json['description'],
+        'is_default': json['is_default'] == null ? undefined : json['is_default'],
+        'is_favorite': json['is_favorite'] == null ? undefined : json['is_favorite'],
+        'position': json['position'] == null ? undefined : json['position'],
+        'config': json['config'] == null ? undefined : json['config'],
         'create_time': (new Date(json['create_time'])),
         'update_time': (new Date(json['update_time'])),
     };
@@ -85,6 +120,11 @@ export function CovalDashboardsAPIDashboardResourceToJSONTyped(value?: CovalDash
         
         'name': value['name'],
         'display_name': value['display_name'],
+        'description': value['description'],
+        'is_default': value['is_default'],
+        'is_favorite': value['is_favorite'],
+        'position': value['position'],
+        'config': value['config'],
         'create_time': value['create_time'].toISOString(),
         'update_time': value['update_time'].toISOString(),
     };

package/src/generated/models/CovalDashboardsAPIUpdateDashboardRequest.ts

@@ -14,7 +14,7 @@
 
 import { mapValues } from '../runtime.js';
 /**
- * 
+ * All fields optional (PATCH semantics). Provided fields are updated; omitted or null fields are left unchanged. Setting is_default=true unsets any other default dashboard in the organization. config fully replaces the stored blob; to clear a value send an empty string (description) or an empty object (config) rather than null.
  * @export
  * @interface CovalDashboardsAPIUpdateDashboardRequest
  */
@@ -24,7 +24,37 @@ export interface CovalDashboardsAPIUpdateDashboardRequest {
      * @type {string}
      * @memberof CovalDashboardsAPIUpdateDashboardRequest
      */
-    display_name?: string;
+    display_name?: string | null;
+    /**
+     * Updated free-text description (empty string clears it)
+     * @type {string}
+     * @memberof CovalDashboardsAPIUpdateDashboardRequest
+     */
+    description?: string | null;
+    /**
+     * Updated favorite flag
+     * @type {boolean}
+     * @memberof CovalDashboardsAPIUpdateDashboardRequest
+     */
+    is_favorite?: boolean | null;
+    /**
+     * Set true to make this the organization's default dashboard (unsets any other default)
+     * @type {boolean}
+     * @memberof CovalDashboardsAPIUpdateDashboardRequest
+     */
+    is_default?: boolean | null;
+    /**
+     * Updated ordering position
+     * @type {number}
+     * @memberof CovalDashboardsAPIUpdateDashboardRequest
+     */
+    position?: number | null;
+    /**
+     * Replacement free-form JSON config blob (max 50000 bytes serialized)
+     * @type {{ [key: string]: any; }}
+     * @memberof CovalDashboardsAPIUpdateDashboardRequest
+     */
+    config?: { [key: string]: any; } | null;
 }
 
 /**
@@ -45,6 +75,11 @@ export function CovalDashboardsAPIUpdateDashboardRequestFromJSONTyped(json: any,
     return {
         
         'display_name': json['display_name'] == null ? undefined : json['display_name'],
+        'description': json['description'] == null ? undefined : json['description'],
+        'is_favorite': json['is_favorite'] == null ? undefined : json['is_favorite'],
+        'is_default': json['is_default'] == null ? undefined : json['is_default'],
+        'position': json['position'] == null ? undefined : json['position'],
+        'config': json['config'] == null ? undefined : json['config'],
     };
 }
 
@@ -60,6 +95,11 @@ export function CovalDashboardsAPIUpdateDashboardRequestToJSONTyped(value?: Cova
     return {
         
         'display_name': value['display_name'],
+        'description': value['description'],
+        'is_favorite': value['is_favorite'],
+        'is_default': value['is_default'],
+        'position': value['position'],
+        'config': value['config'],
     };
 }
 

package/src/generated/models/CovalDashboardsAPIWidgetResource.ts

@@ -47,7 +47,7 @@ export interface CovalDashboardsAPIWidgetResource {
      */
     display_name?: string | null;
     /**
-     * 
+     * Widget type.
      * @type {CovalDashboardsAPIWidgetType}
      * @memberof CovalDashboardsAPIWidgetResource
      */