opik 1.9.21 → 1.9.24-0

package/dist/index.d.cts

@@ -183,6 +183,25 @@ declare const DatasetUpdateVisibility: {
     readonly Public: "public";
 };
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+/**
+ * @example
+ *     {
+ *         ids: ["ids"],
+ *         update: {}
+ *     }
+ */
+interface DatasetItemBatchUpdate {
+    /** List of dataset item IDs to update (max 1000) */
+    ids: string[];
+    update: DatasetItemUpdate;
+    /** If true, merge tags with existing tags instead of replacing them. Default: false */
+    mergeTags?: boolean;
+}
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -242,6 +261,23 @@ interface DatasetItemBatchWrite {
     items: DatasetItemWrite[];
 }
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         file: {
+ *             "key": "value"
+ *         },
+ *         datasetId: "dataset_id"
+ *     }
+ */
+interface CreateDatasetItemsFromCsvRequest {
+    file: Record<string, unknown>;
+    datasetId: string;
+}
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -1006,17 +1042,6 @@ declare const GetSpansByProjectRequestType: {
     readonly Guardrail: "guardrail";
 };
 
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-type SpanUpdateType = "general" | "tool" | "llm" | "guardrail";
-declare const SpanUpdateType: {
-    readonly General: "general";
-    readonly Tool: "tool";
-    readonly Llm: "llm";
-    readonly Guardrail: "guardrail";
-};
-
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -1056,22 +1081,14 @@ declare const SpanSearchStreamRequestPublicType: {
 
 /**
  * @example
- *     {}
+ *     {
+ *         spans: [{
+ *                 startTime: "2024-01-15T09:30:00Z"
+ *             }]
+ *     }
  */
-interface GetSpansByProjectRequest {
-    page?: number;
-    size?: number;
-    projectName?: string;
-    projectId?: string;
-    traceId?: string;
-    type?: GetSpansByProjectRequestType;
-    filters?: string;
-    truncate?: boolean;
-    stripAttachments?: boolean;
-    sorting?: string;
-    exclude?: string;
-    fromTime?: Date;
-    toTime?: Date;
+interface SpanBatchWrite {
+    spans: SpanWrite[];
 }
 
 /**
@@ -1081,55 +1098,53 @@ interface GetSpansByProjectRequest {
 /**
  * @example
  *     {
- *         spans: [{
- *                 startTime: "2024-01-15T09:30:00Z"
- *             }]
+ *         ids: ["ids"],
+ *         update: {
+ *             traceId: "trace_id"
+ *         }
  *     }
  */
-interface SpanBatchWrite {
-    spans: SpanWrite[];
+interface SpanBatchUpdate {
+    /** List of span IDs to update (max 1000) */
+    ids: string[];
+    update: SpanUpdate$1;
+    /** If true, merge tags with existing tags instead of replacing them. Default: false */
+    mergeTags?: boolean;
 }
 
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+
 /**
  * @example
  *     {}
  */
-interface GetSpanByIdRequest {
+interface GetSpansByProjectRequest {
+    page?: number;
+    size?: number;
+    projectName?: string;
+    projectId?: string;
+    traceId?: string;
+    type?: GetSpansByProjectRequestType;
+    filters?: string;
+    truncate?: boolean;
     stripAttachments?: boolean;
+    sorting?: string;
+    exclude?: string;
+    fromTime?: Date;
+    toTime?: Date;
 }
 
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-
 /**
  * @example
- *     {
- *         traceId: "trace_id"
- *     }
+ *     {}
  */
-interface SpanUpdate$1 {
-    /** If null and project_id not specified, Default Project is assumed */
-    projectName?: string;
-    /** If null and project_name not specified, Default Project is assumed */
-    projectId?: string;
-    traceId: string;
-    parentSpanId?: string;
-    name?: string;
-    type?: SpanUpdateType;
-    endTime?: Date;
-    input?: JsonListString;
-    output?: JsonListString;
-    metadata?: JsonListString;
-    model?: string;
-    provider?: string;
-    tags?: string[];
-    usage?: Record<string, number>;
-    totalEstimatedCost?: number;
-    errorInfo?: ErrorInfo;
+interface GetSpanByIdRequest {
+    stripAttachments?: boolean;
 }
 
 /**
@@ -1399,36 +1414,36 @@ interface GuardrailBatchWrite {
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+
 /**
  * @example
- *     {}
+ *     {
+ *         traces: [{
+ *                 startTime: "2024-01-15T09:30:00Z"
+ *             }]
+ *     }
  */
-interface TraceThreadBatchIdentifier {
-    projectName?: string;
-    projectId?: string;
-    threadId?: string;
-    threadIds?: string[];
+interface TraceBatchWrite {
+    traces: TraceWrite[];
 }
 
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+
 /**
  * @example
- *     {}
+ *     {
+ *         ids: ["ids"],
+ *         update: {}
+ *     }
  */
-interface GetTracesByProjectRequest {
-    page?: number;
-    size?: number;
-    projectName?: string;
-    projectId?: string;
-    filters?: string;
-    truncate?: boolean;
-    stripAttachments?: boolean;
-    sorting?: string;
-    exclude?: string;
-    fromTime?: Date;
-    toTime?: Date;
+interface TraceBatchUpdate {
+    /** List of trace IDs to update (max 1000) */
+    ids: string[];
+    update: TraceUpdate;
+    /** If true, merge tags with existing tags instead of replacing them. Default: false */
+    mergeTags?: boolean;
 }
 
 /**
@@ -1438,13 +1453,16 @@ interface GetTracesByProjectRequest {
 /**
  * @example
  *     {
- *         traces: [{
- *                 startTime: "2024-01-15T09:30:00Z"
- *             }]
+ *         ids: ["ids"],
+ *         update: {}
  *     }
  */
-interface TraceBatchWrite {
-    traces: TraceWrite[];
+interface TraceThreadBatchUpdate {
+    /** List of thread model IDs to update (max 1000) */
+    ids: string[];
+    update: TraceThreadUpdate;
+    /** If true, merge tags with existing tags instead of replacing them. Default: false */
+    mergeTags?: boolean;
 }
 
 /**
@@ -1454,31 +1472,43 @@ interface TraceBatchWrite {
  * @example
  *     {}
  */
-interface GetTraceByIdRequest {
-    stripAttachments?: boolean;
+interface TraceThreadBatchIdentifier {
+    projectName?: string;
+    projectId?: string;
+    threadId?: string;
+    threadIds?: string[];
 }
 
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-
 /**
  * @example
  *     {}
  */
-interface TraceUpdate {
-    /** If null and project_id not specified, Default Project is assumed */
+interface GetTracesByProjectRequest {
+    page?: number;
+    size?: number;
     projectName?: string;
-    /** If null and project_name not specified, Default Project is assumed */
     projectId?: string;
-    name?: string;
-    endTime?: Date;
-    input?: JsonListString;
-    output?: JsonListString;
-    metadata?: JsonListString;
-    tags?: string[];
-    errorInfo?: ErrorInfo;
-    threadId?: string;
+    filters?: string;
+    truncate?: boolean;
+    stripAttachments?: boolean;
+    sorting?: string;
+    exclude?: string;
+    fromTime?: Date;
+    toTime?: Date;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {}
+ */
+interface GetTraceByIdRequest {
+    stripAttachments?: boolean;
 }
 
 /**
@@ -1636,17 +1666,6 @@ interface TraceSearchStreamRequestPublic {
     toTime?: Date;
 }
 
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-/**
- * @example
- *     {}
- */
-interface TraceThreadUpdate {
-    tags?: string[];
-}
-
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -1785,12 +1804,13 @@ interface WorkspaceTraceCount {
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-type AlertTriggerConfigWriteType = "scope:project" | "threshold:feedback_score" | "threshold:cost" | "threshold:latency";
+type AlertTriggerConfigWriteType = "scope:project" | "threshold:feedback_score" | "threshold:cost" | "threshold:latency" | "threshold:errors";
 declare const AlertTriggerConfigWriteType: {
     readonly ScopeProject: "scope:project";
     readonly ThresholdFeedbackScore: "threshold:feedback_score";
     readonly ThresholdCost: "threshold:cost";
     readonly ThresholdLatency: "threshold:latency";
+    readonly ThresholdErrors: "threshold:errors";
 };
 
 /**
@@ -1887,12 +1907,13 @@ interface AlertPagePublic {
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-type AlertTriggerConfigPublicType = "scope:project" | "threshold:feedback_score" | "threshold:cost" | "threshold:latency";
+type AlertTriggerConfigPublicType = "scope:project" | "threshold:feedback_score" | "threshold:cost" | "threshold:latency" | "threshold:errors";
 declare const AlertTriggerConfigPublicType: {
     readonly ScopeProject: "scope:project";
     readonly ThresholdFeedbackScore: "threshold:feedback_score";
     readonly ThresholdCost: "threshold:cost";
     readonly ThresholdLatency: "threshold:latency";
+    readonly ThresholdErrors: "threshold:errors";
 };
 
 /**
@@ -3106,6 +3127,24 @@ interface DashboardPagePublic {
     total?: number;
 }
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+/**
+ * Dataset item update request
+ */
+interface DatasetItemUpdate {
+    /** Dataset item input */
+    input?: string;
+    /** Dataset item expected output */
+    expectedOutput?: string;
+    metadata?: JsonNode;
+    data?: JsonNode;
+    /** Tags */
+    tags?: string[];
+}
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -4955,6 +4994,43 @@ interface ServiceTogglesConfig {
     opikAiEnabled: boolean;
     alertsEnabled: boolean;
     welcomeWizardEnabled: boolean;
+    csvUploadEnabled: boolean;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type SpanUpdateType = "general" | "tool" | "llm" | "guardrail";
+declare const SpanUpdateType: {
+    readonly General: "general";
+    readonly Tool: "tool";
+    readonly Llm: "llm";
+    readonly Guardrail: "guardrail";
+};
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface SpanUpdate$1 {
+    /** If null and project_id not specified, Default Project is assumed */
+    projectName?: string;
+    /** If null and project_name not specified, Default Project is assumed */
+    projectId?: string;
+    traceId: string;
+    parentSpanId?: string;
+    name?: string;
+    type?: SpanUpdateType;
+    endTime?: Date;
+    input?: JsonListString;
+    output?: JsonListString;
+    metadata?: JsonListString;
+    model?: string;
+    provider?: string;
+    tags?: string[];
+    usage?: Record<string, number>;
+    totalEstimatedCost?: number;
+    errorInfo?: ErrorInfo;
 }
 
 /**
@@ -5193,6 +5269,32 @@ interface SpanFilterPublic {
     value?: string;
 }
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface TraceUpdate {
+    /** If null and project_id not specified, Default Project is assumed */
+    projectName?: string;
+    /** If null and project_name not specified, Default Project is assumed */
+    projectId?: string;
+    name?: string;
+    endTime?: Date;
+    input?: JsonListString;
+    output?: JsonListString;
+    metadata?: JsonListString;
+    tags?: string[];
+    errorInfo?: ErrorInfo;
+    threadId?: string;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+interface TraceThreadUpdate {
+    tags?: string[];
+}
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -6499,6 +6601,22 @@ declare namespace Datasets {
 declare class Datasets {
     protected readonly _options: Datasets.Options;
     constructor(_options?: Datasets.Options);
+    /**
+     * Update multiple dataset items
+     *
+     * @param {OpikApi.DatasetItemBatchUpdate} request
+     * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link OpikApi.BadRequestError}
+     *
+     * @example
+     *     await client.datasets.batchUpdateDatasetItems({
+     *         ids: ["ids"],
+     *         update: {}
+     *     })
+     */
+    batchUpdateDatasetItems(request: DatasetItemBatchUpdate, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<void>;
+    private __batchUpdateDatasetItems;
     /**
      * Find datasets
      *
@@ -6541,6 +6659,25 @@ declare class Datasets {
      */
     createOrUpdateDatasetItems(request: DatasetItemBatchWrite, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<void>;
     private __createOrUpdateDatasetItems;
+    /**
+     * Create dataset items from uploaded CSV file. CSV should have headers in the first row. Processing happens asynchronously in batches.
+     *
+     * @param {OpikApi.CreateDatasetItemsFromCsvRequest} request
+     * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link OpikApi.BadRequestError}
+     * @throws {@link OpikApi.NotFoundError}
+     *
+     * @example
+     *     await client.datasets.createDatasetItemsFromCsv({
+     *         file: {
+     *             "key": "value"
+     *         },
+     *         datasetId: "dataset_id"
+     *     })
+     */
+    createDatasetItemsFromCsv(request: CreateDatasetItemsFromCsvRequest, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<void>;
+    private __createDatasetItemsFromCsv;
     /**
      * Create dataset items from spans with enriched metadata
      *
@@ -8023,6 +8160,39 @@ declare class Spans {
      */
     addSpanFeedbackScore(id: string, request: FeedbackScore, requestOptions?: Spans.RequestOptions): HttpResponsePromise<void>;
     private __addSpanFeedbackScore;
+    /**
+     * Create spans
+     *
+     * @param {OpikApi.SpanBatchWrite} request
+     * @param {Spans.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.spans.createSpans({
+     *         spans: [{
+     *                 startTime: "2024-01-15T09:30:00Z"
+     *             }]
+     *     })
+     */
+    createSpans(request: SpanBatchWrite, requestOptions?: Spans.RequestOptions): HttpResponsePromise<void>;
+    private __createSpans;
+    /**
+     * Update multiple spans
+     *
+     * @param {OpikApi.SpanBatchUpdate} request
+     * @param {Spans.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link OpikApi.BadRequestError}
+     *
+     * @example
+     *     await client.spans.batchUpdateSpans({
+     *         ids: ["ids"],
+     *         update: {
+     *             traceId: "trace_id"
+     *         }
+     *     })
+     */
+    batchUpdateSpans(request: SpanBatchUpdate, requestOptions?: Spans.RequestOptions): HttpResponsePromise<void>;
+    private __batchUpdateSpans;
     /**
      * Get spans by project_name or project_id and optionally by trace_id and/or type
      *
@@ -8049,21 +8219,6 @@ declare class Spans {
      */
     createSpan(request: SpanWrite, requestOptions?: Spans.RequestOptions): HttpResponsePromise<void>;
     private __createSpan;
-    /**
-     * Create spans
-     *
-     * @param {OpikApi.SpanBatchWrite} request
-     * @param {Spans.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.spans.createSpans({
-     *         spans: [{
-     *                 startTime: "2024-01-15T09:30:00Z"
-     *             }]
-     *     })
-     */
-    createSpans(request: SpanBatchWrite, requestOptions?: Spans.RequestOptions): HttpResponsePromise<void>;
-    private __createSpans;
     /**
      * Get span by id
      *
@@ -8294,6 +8449,53 @@ declare class Traces {
      */
     addTraceFeedbackScore(id: string, request: FeedbackScore, requestOptions?: Traces.RequestOptions): HttpResponsePromise<void>;
     private __addTraceFeedbackScore;
+    /**
+     * Create traces
+     *
+     * @param {OpikApi.TraceBatchWrite} request
+     * @param {Traces.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.traces.createTraces({
+     *         traces: [{
+     *                 startTime: "2024-01-15T09:30:00Z"
+     *             }]
+     *     })
+     */
+    createTraces(request: TraceBatchWrite, requestOptions?: Traces.RequestOptions): HttpResponsePromise<void>;
+    private __createTraces;
+    /**
+     * Update multiple traces
+     *
+     * @param {OpikApi.TraceBatchUpdate} request
+     * @param {Traces.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link OpikApi.BadRequestError}
+     *
+     * @example
+     *     await client.traces.batchUpdateTraces({
+     *         ids: ["ids"],
+     *         update: {}
+     *     })
+     */
+    batchUpdateTraces(request: TraceBatchUpdate, requestOptions?: Traces.RequestOptions): HttpResponsePromise<void>;
+    private __batchUpdateTraces;
+    /**
+     * Update multiple threads
+     *
+     * @param {OpikApi.TraceThreadBatchUpdate} request
+     * @param {Traces.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link OpikApi.BadRequestError}
+     *
+     * @example
+     *     await client.traces.batchUpdateThreads({
+     *         ids: ["ids"],
+     *         update: {}
+     *     })
+     */
+    batchUpdateThreads(request: TraceThreadBatchUpdate, requestOptions?: Traces.RequestOptions): HttpResponsePromise<void>;
+    private __batchUpdateThreads;
     /**
      * Close one or multiple trace threads. Supports both single thread_id and multiple thread_ids for batch operations.
      *
@@ -8331,21 +8533,6 @@ declare class Traces {
      */
     createTrace(request: TraceWrite, requestOptions?: Traces.RequestOptions): HttpResponsePromise<void>;
     private __createTrace;
-    /**
-     * Create traces
-     *
-     * @param {OpikApi.TraceBatchWrite} request
-     * @param {Traces.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.traces.createTraces({
-     *         traces: [{
-     *                 startTime: "2024-01-15T09:30:00Z"
-     *             }]
-     *     })
-     */
-    createTraces(request: TraceBatchWrite, requestOptions?: Traces.RequestOptions): HttpResponsePromise<void>;
-    private __createTraces;
     /**
      * Get trace by id
      *
@@ -8377,9 +8564,9 @@ declare class Traces {
      * @param {Traces.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
-     *     await client.traces.updateTrace("id")
+     *     await client.traces.updateTrace("id", {})
      */
-    updateTrace(id: string, request?: TraceUpdate, requestOptions?: Traces.RequestOptions): HttpResponsePromise<void>;
+    updateTrace(id: string, request: TraceUpdate, requestOptions?: Traces.RequestOptions): HttpResponsePromise<void>;
     private __updateTrace;
     /**
      * Delete thread comments
@@ -8623,9 +8810,9 @@ declare class Traces {
      * @throws {@link OpikApi.NotFoundError}
      *
      * @example
-     *     await client.traces.updateThread("threadModelId")
+     *     await client.traces.updateThread("threadModelId", {})
      */
-    updateThread(threadModelId: string, request?: TraceThreadUpdate, requestOptions?: Traces.RequestOptions): HttpResponsePromise<void>;
+    updateThread(threadModelId: string, request: TraceThreadUpdate, requestOptions?: Traces.RequestOptions): HttpResponsePromise<void>;
     private __updateThread;
     /**
      * Update thread comment by id