@coval/sdk 0.4.0 → 0.4.2

package/src/generated/models/TracesAPITraceSearchFilters.ts

@@ -0,0 +1,176 @@
+/* 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 { TracesAPITraceSearchAttributeFilter } from './TracesAPITraceSearchAttributeFilter.js';
+import {
+    TracesAPITraceSearchAttributeFilterFromJSON,
+    TracesAPITraceSearchAttributeFilterFromJSONTyped,
+    TracesAPITraceSearchAttributeFilterToJSON,
+    TracesAPITraceSearchAttributeFilterToJSONTyped,
+} from './TracesAPITraceSearchAttributeFilter.js';
+
+/**
+ * 
+ * @export
+ * @interface TracesAPITraceSearchFilters
+ */
+export interface TracesAPITraceSearchFilters {
+    /**
+     * Include spans at or after this ISO 8601 timestamp.
+     * @type {string}
+     * @memberof TracesAPITraceSearchFilters
+     */
+    start_date?: string | null;
+    /**
+     * Include spans at or before this ISO 8601 timestamp.
+     * @type {string}
+     * @memberof TracesAPITraceSearchFilters
+     */
+    end_date?: string | null;
+    /**
+     * Case-insensitive substring match on span name.
+     * @type {string}
+     * @memberof TracesAPITraceSearchFilters
+     */
+    span_name?: string | null;
+    /**
+     * Case-insensitive substring match on detected provider.
+     * @type {string}
+     * @memberof TracesAPITraceSearchFilters
+     */
+    provider?: string | null;
+    /**
+     * 
+     * @type {TracesAPITraceSearchFiltersStatusEnum}
+     * @memberof TracesAPITraceSearchFilters
+     */
+    status?: TracesAPITraceSearchFiltersStatusEnum | null;
+    /**
+     * 
+     * @type {Array<TracesAPITraceSearchAttributeFilter>}
+     * @memberof TracesAPITraceSearchFilters
+     */
+    attribute_filters?: Array<TracesAPITraceSearchAttributeFilter> | null;
+    /**
+     * 
+     * @type {number}
+     * @memberof TracesAPITraceSearchFilters
+     */
+    duration_ms_min?: number | null;
+    /**
+     * 
+     * @type {number}
+     * @memberof TracesAPITraceSearchFilters
+     */
+    duration_ms_max?: number | null;
+    /**
+     * 
+     * @type {TracesAPITraceSearchFiltersSortByEnum}
+     * @memberof TracesAPITraceSearchFilters
+     */
+    sort_by?: TracesAPITraceSearchFiltersSortByEnum | null;
+    /**
+     * 
+     * @type {string}
+     * @memberof TracesAPITraceSearchFilters
+     */
+    agent_id?: string | null;
+    /**
+     * 
+     * @type {string}
+     * @memberof TracesAPITraceSearchFilters
+     */
+    test_set_id?: string | null;
+}
+
+
+/**
+ * @export
+ */
+export const TracesAPITraceSearchFiltersStatusEnum = {
+    Error: 'ERROR',
+    Ok: 'OK',
+    Unset: 'UNSET'
+} as const;
+export type TracesAPITraceSearchFiltersStatusEnum = typeof TracesAPITraceSearchFiltersStatusEnum[keyof typeof TracesAPITraceSearchFiltersStatusEnum];
+
+/**
+ * @export
+ */
+export const TracesAPITraceSearchFiltersSortByEnum = {
+    Newest: 'newest',
+    Oldest: 'oldest',
+    Slowest: 'slowest',
+    Fastest: 'fastest'
+} as const;
+export type TracesAPITraceSearchFiltersSortByEnum = typeof TracesAPITraceSearchFiltersSortByEnum[keyof typeof TracesAPITraceSearchFiltersSortByEnum];
+
+
+/**
+ * Check if a given object implements the TracesAPITraceSearchFilters interface.
+ */
+export function instanceOfTracesAPITraceSearchFilters(value: object): value is TracesAPITraceSearchFilters {
+    return true;
+}
+
+export function TracesAPITraceSearchFiltersFromJSON(json: any): TracesAPITraceSearchFilters {
+    return TracesAPITraceSearchFiltersFromJSONTyped(json, false);
+}
+
+export function TracesAPITraceSearchFiltersFromJSONTyped(json: any, ignoreDiscriminator: boolean): TracesAPITraceSearchFilters {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'start_date': json['start_date'] == null ? undefined : json['start_date'],
+        'end_date': json['end_date'] == null ? undefined : json['end_date'],
+        'span_name': json['span_name'] == null ? undefined : json['span_name'],
+        'provider': json['provider'] == null ? undefined : json['provider'],
+        'status': json['status'] == null ? undefined : json['status'],
+        'attribute_filters': json['attribute_filters'] == null ? undefined : ((json['attribute_filters'] as Array<any>).map(TracesAPITraceSearchAttributeFilterFromJSON)),
+        'duration_ms_min': json['duration_ms_min'] == null ? undefined : json['duration_ms_min'],
+        'duration_ms_max': json['duration_ms_max'] == null ? undefined : json['duration_ms_max'],
+        'sort_by': json['sort_by'] == null ? undefined : json['sort_by'],
+        'agent_id': json['agent_id'] == null ? undefined : json['agent_id'],
+        'test_set_id': json['test_set_id'] == null ? undefined : json['test_set_id'],
+    };
+}
+
+export function TracesAPITraceSearchFiltersToJSON(json: any): TracesAPITraceSearchFilters {
+    return TracesAPITraceSearchFiltersToJSONTyped(json, false);
+}
+
+export function TracesAPITraceSearchFiltersToJSONTyped(value?: TracesAPITraceSearchFilters | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'start_date': value['start_date'],
+        'end_date': value['end_date'],
+        'span_name': value['span_name'],
+        'provider': value['provider'],
+        'status': value['status'],
+        'attribute_filters': value['attribute_filters'] == null ? undefined : ((value['attribute_filters'] as Array<any>).map(TracesAPITraceSearchAttributeFilterToJSON)),
+        'duration_ms_min': value['duration_ms_min'],
+        'duration_ms_max': value['duration_ms_max'],
+        'sort_by': value['sort_by'],
+        'agent_id': value['agent_id'],
+        'test_set_id': value['test_set_id'],
+    };
+}
+

package/src/generated/models/TracesAPITraceSearchRequest.ts

@@ -0,0 +1,89 @@
+/* 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 { TracesAPITraceSearchFilters } from './TracesAPITraceSearchFilters.js';
+import {
+    TracesAPITraceSearchFiltersFromJSON,
+    TracesAPITraceSearchFiltersFromJSONTyped,
+    TracesAPITraceSearchFiltersToJSON,
+    TracesAPITraceSearchFiltersToJSONTyped,
+} from './TracesAPITraceSearchFilters.js';
+
+/**
+ * 
+ * @export
+ * @interface TracesAPITraceSearchRequest
+ */
+export interface TracesAPITraceSearchRequest {
+    /**
+     * Opaque cursor returned as `next_cursor` by the previous page.
+     * @type {string}
+     * @memberof TracesAPITraceSearchRequest
+     */
+    cursor?: string | null;
+    /**
+     * 
+     * @type {number}
+     * @memberof TracesAPITraceSearchRequest
+     */
+    limit?: number;
+    /**
+     * 
+     * @type {TracesAPITraceSearchFilters}
+     * @memberof TracesAPITraceSearchRequest
+     */
+    filters?: TracesAPITraceSearchFilters;
+}
+
+/**
+ * Check if a given object implements the TracesAPITraceSearchRequest interface.
+ */
+export function instanceOfTracesAPITraceSearchRequest(value: object): value is TracesAPITraceSearchRequest {
+    return true;
+}
+
+export function TracesAPITraceSearchRequestFromJSON(json: any): TracesAPITraceSearchRequest {
+    return TracesAPITraceSearchRequestFromJSONTyped(json, false);
+}
+
+export function TracesAPITraceSearchRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): TracesAPITraceSearchRequest {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'cursor': json['cursor'] == null ? undefined : json['cursor'],
+        'limit': json['limit'] == null ? undefined : json['limit'],
+        'filters': json['filters'] == null ? undefined : TracesAPITraceSearchFiltersFromJSON(json['filters']),
+    };
+}
+
+export function TracesAPITraceSearchRequestToJSON(json: any): TracesAPITraceSearchRequest {
+    return TracesAPITraceSearchRequestToJSONTyped(json, false);
+}
+
+export function TracesAPITraceSearchRequestToJSONTyped(value?: TracesAPITraceSearchRequest | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'cursor': value['cursor'],
+        'limit': value['limit'],
+        'filters': TracesAPITraceSearchFiltersToJSON(value['filters']),
+    };
+}
+

package/src/generated/models/TracesAPITraceSearchResponse.ts

@@ -0,0 +1,107 @@
+/* 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 { TracesAPITraceSearchCallResult } from './TracesAPITraceSearchCallResult.js';
+import {
+    TracesAPITraceSearchCallResultFromJSON,
+    TracesAPITraceSearchCallResultFromJSONTyped,
+    TracesAPITraceSearchCallResultToJSON,
+    TracesAPITraceSearchCallResultToJSONTyped,
+} from './TracesAPITraceSearchCallResult.js';
+import type { TracesAPITraceSearchAggregateStats } from './TracesAPITraceSearchAggregateStats.js';
+import {
+    TracesAPITraceSearchAggregateStatsFromJSON,
+    TracesAPITraceSearchAggregateStatsFromJSONTyped,
+    TracesAPITraceSearchAggregateStatsToJSON,
+    TracesAPITraceSearchAggregateStatsToJSONTyped,
+} from './TracesAPITraceSearchAggregateStats.js';
+
+/**
+ * 
+ * @export
+ * @interface TracesAPITraceSearchResponse
+ */
+export interface TracesAPITraceSearchResponse {
+    /**
+     * 
+     * @type {Array<TracesAPITraceSearchCallResult>}
+     * @memberof TracesAPITraceSearchResponse
+     */
+    items: Array<TracesAPITraceSearchCallResult>;
+    /**
+     * 
+     * @type {number}
+     * @memberof TracesAPITraceSearchResponse
+     */
+    total_count: number;
+    /**
+     * 
+     * @type {string}
+     * @memberof TracesAPITraceSearchResponse
+     */
+    next_cursor?: string | null;
+    /**
+     * 
+     * @type {TracesAPITraceSearchAggregateStats}
+     * @memberof TracesAPITraceSearchResponse
+     */
+    aggregate_stats: TracesAPITraceSearchAggregateStats;
+}
+
+/**
+ * Check if a given object implements the TracesAPITraceSearchResponse interface.
+ */
+export function instanceOfTracesAPITraceSearchResponse(value: object): value is TracesAPITraceSearchResponse {
+    if (!('items' in value) || value['items'] === undefined) return false;
+    if (!('total_count' in value) || value['total_count'] === undefined) return false;
+    if (!('aggregate_stats' in value) || value['aggregate_stats'] === undefined) return false;
+    return true;
+}
+
+export function TracesAPITraceSearchResponseFromJSON(json: any): TracesAPITraceSearchResponse {
+    return TracesAPITraceSearchResponseFromJSONTyped(json, false);
+}
+
+export function TracesAPITraceSearchResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): TracesAPITraceSearchResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'items': ((json['items'] as Array<any>).map(TracesAPITraceSearchCallResultFromJSON)),
+        'total_count': json['total_count'],
+        'next_cursor': json['next_cursor'] == null ? undefined : json['next_cursor'],
+        'aggregate_stats': TracesAPITraceSearchAggregateStatsFromJSON(json['aggregate_stats']),
+    };
+}
+
+export function TracesAPITraceSearchResponseToJSON(json: any): TracesAPITraceSearchResponse {
+    return TracesAPITraceSearchResponseToJSONTyped(json, false);
+}
+
+export function TracesAPITraceSearchResponseToJSONTyped(value?: TracesAPITraceSearchResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'items': ((value['items'] as Array<any>).map(TracesAPITraceSearchCallResultToJSON)),
+        'total_count': value['total_count'],
+        'next_cursor': value['next_cursor'],
+        'aggregate_stats': TracesAPITraceSearchAggregateStatsToJSON(value['aggregate_stats']),
+    };
+}
+

package/src/generated/models/index.ts

@@ -228,11 +228,17 @@ export * from './CovalReportsAPIErrorResponse.js';
 export * from './CovalReportsAPIGetReportResponse.js';
 export * from './CovalReportsAPIListReportRowsResponse.js';
 export * from './CovalReportsAPIListReportsResponse.js';
+export * from './CovalReportsAPIMonitoringFiltersConfiguration.js';
+export * from './CovalReportsAPIMonitoringFiltersPatch.js';
 export * from './CovalReportsAPIReport.js';
+export * from './CovalReportsAPIReportDetail.js';
+export * from './CovalReportsAPIReportMetricConfigurationEntry.js';
 export * from './CovalReportsAPIReportMetricOutput.js';
 export * from './CovalReportsAPIReportMetricOutputValue.js';
 export * from './CovalReportsAPIReportPermission.js';
 export * from './CovalReportsAPIReportRowResource.js';
+export * from './CovalReportsAPIReportViewConfiguration.js';
+export * from './CovalReportsAPIReportViewConfigurationPatch.js';
 export * from './CovalReportsAPIUpdateReportRequest.js';
 export * from './CovalReportsAPIUpdateReportResponse.js';
 export * from './CovalReviewsAPIAnnotationPriority.js';
@@ -399,3 +405,9 @@ export * from './TracesAPIErrorResponseErrorDetailsInner.js';
 export * from './TracesAPISimulationTracesResponse.js';
 export * from './TracesAPITraceQualitySummary.js';
 export * from './TracesAPITraceQualitySummaryExportLag.js';
+export * from './TracesAPITraceSearchAggregateStats.js';
+export * from './TracesAPITraceSearchAttributeFilter.js';
+export * from './TracesAPITraceSearchCallResult.js';
+export * from './TracesAPITraceSearchFilters.js';
+export * from './TracesAPITraceSearchRequest.js';
+export * from './TracesAPITraceSearchResponse.js';

package/src/index.ts

@@ -9,6 +9,8 @@ export type { PaginateOptions } from './pagination.js';
 export { apiKeyAuthMiddleware } from './auth.js';
 export { createRetryingFetch } from './retry.js';
 export type { RetryOptions } from './retry.js';
+export { createTransportStats, formatTransportStats } from './stats.js';
+export type { CovalTransportStats } from './stats.js';
 
 // Re-export the entire generated surface so callers can reach for request
 // types, model types, and individual API classes if they want to bypass the

package/src/retry.ts

@@ -8,6 +8,7 @@
 
 import { CovalNetworkError } from './errors.js';
 import type { FetchAPI } from './generated/runtime.js';
+import type { CovalTransportStats } from './stats.js';
 
 const RETRYABLE_STATUSES = new Set([408, 429, 500, 502, 503, 504]);
 const RETRYABLE_METHODS = new Set(['GET', 'HEAD', 'OPTIONS']);
@@ -30,6 +31,10 @@ export interface RetryOptions {
 export interface RetryDeps {
   fetch?: FetchAPI;
   sleep?: (ms: number) => Promise<void>;
+  /** Counters mutated in place so the client can expose a live view. */
+  stats?: CovalTransportStats;
+  /** Called with a human-readable line on each retry or network error. */
+  onDebug?: (message: string) => void;
 }
 
 export function createRetryingFetch(options: RetryOptions = {}, deps: RetryDeps = {}): FetchAPI {
@@ -41,16 +46,22 @@ export function createRetryingFetch(options: RetryOptions = {}, deps: RetryDeps
   const retryableMethods = options.retryableMethods ?? RETRYABLE_METHODS;
   const innerFetch: FetchAPI = deps.fetch ?? (globalThis.fetch as FetchAPI);
   const sleep = deps.sleep ?? ((ms: number) => new Promise((resolve) => setTimeout(resolve, ms)));
+  const stats = deps.stats;
+  const debug = deps.onDebug;
 
   return async function retryingFetch(input, init) {
     let lastError: unknown;
     const method = (init?.method ?? 'GET').toUpperCase();
     const url = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
+    if (stats) stats.calls += 1;
 
     if (!retryableMethods.has(method)) {
       try {
+        if (stats) stats.requests += 1;
         return await innerFetch(input, init);
       } catch (err) {
+        if (stats) stats.networkErrors += 1;
+        debug?.(`coval-sdk: ${method} ${url} failed in transit (not retried): ${stringifyError(err)}`);
         throw new CovalNetworkError({
           message: `Coval API request failed: ${stringifyError(err)}`,
           url,
@@ -63,15 +74,24 @@ export function createRetryingFetch(options: RetryOptions = {}, deps: RetryDeps
 
     for (let attempt = 1; attempt <= maxAttempts; attempt++) {
       try {
+        if (stats) stats.requests += 1;
         const response = await innerFetch(input, init);
         if (!retryable.has(response.status) || attempt === maxAttempts) {
           return response;
         }
         const wait = computeDelay({ attempt, baseDelay, maxDelay, jitter, response });
+        if (stats) stats.retries += 1;
+        debug?.(
+          `coval-sdk: ${method} ${url} returned ${response.status}, retrying in ${wait}ms (attempt ${attempt}/${maxAttempts})`,
+        );
         await sleep(wait);
       } catch (err) {
         lastError = err;
+        if (stats) stats.networkErrors += 1;
         if (attempt === maxAttempts) {
+          debug?.(
+            `coval-sdk: ${method} ${url} failed in transit after ${attempt} attempts: ${stringifyError(err)}`,
+          );
           throw new CovalNetworkError({
             message: `Coval API request failed after ${attempt} attempt${attempt > 1 ? 's' : ''}: ${stringifyError(err)}`,
             url,
@@ -81,6 +101,10 @@ export function createRetryingFetch(options: RetryOptions = {}, deps: RetryDeps
           });
         }
         const wait = computeDelay({ attempt, baseDelay, maxDelay, jitter });
+        if (stats) stats.retries += 1;
+        debug?.(
+          `coval-sdk: ${method} ${url} failed in transit (${stringifyError(err)}), retrying in ${wait}ms (attempt ${attempt}/${maxAttempts})`,
+        );
         await sleep(wait);
       }
     }

package/src/stats.ts

@@ -0,0 +1,25 @@
+// Transport counters for diagnosing intermittent failures.
+//
+// A request that dies in transit never reaches the API, so there is no
+// server-side trace of it. These counters are often the only evidence available
+// when a caller reports sporadic timeouts. Mirrors `connection_stats` in the
+// Python SDK.
+
+export interface CovalTransportStats {
+  /** Logical API calls started. */
+  calls: number;
+  /** fetch invocations, including retries — exceeds `calls` when retries fire. */
+  requests: number;
+  /** Retry attempts beyond the initial request. */
+  retries: number;
+  /** fetch rejections: DNS failure, reset, abort, or a stranded pooled socket. */
+  networkErrors: number;
+}
+
+export function createTransportStats(): CovalTransportStats {
+  return { calls: 0, requests: 0, retries: 0, networkErrors: 0 };
+}
+
+export function formatTransportStats(stats: CovalTransportStats): string {
+  return `CovalTransportStats(calls=${stats.calls}, requests=${stats.requests}, retries=${stats.retries}, networkErrors=${stats.networkErrors})`;
+}