opik 1.7.26 → 1.7.27

package/dist/{Client-DEn_NVx8.d.cts → Client-C3O8H4SX.d.cts}

@@ -388,6 +388,26 @@ interface ExperimentItemsDelete {
     ids: string[];
 }
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+/**
+ * @example
+ *     {
+ *         experimentName: "experiment_name",
+ *         datasetName: "dataset_name",
+ *         items: [{
+ *                 datasetItemId: "dataset_item_id"
+ *             }]
+ *     }
+ */
+interface ExperimentItemBulkUploadWrite {
+    experimentName: string;
+    datasetName: string;
+    items: ExperimentItemBulkRecordWrite[];
+}
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -489,16 +509,6 @@ interface ProviderApiKeyUpdate {
     name?: string;
 }
 
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-type OptimizationWriteStatus = "running" | "completed" | "cancelled";
-declare const OptimizationWriteStatus: {
-    readonly Running: "running";
-    readonly Completed: "completed";
-    readonly Cancelled: "cancelled";
-};
-
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -524,27 +534,6 @@ interface FindOptimizationsRequest {
     datasetDeleted?: boolean;
 }
 
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-
-/**
- * @example
- *     {
- *         datasetName: "dataset_name",
- *         objectiveName: "objective_name",
- *         status: "running"
- *     }
- */
-interface OptimizationWrite {
-    id?: string;
-    name?: string;
-    datasetName: string;
-    objectiveName: string;
-    status: OptimizationWriteStatus;
-    metadata?: JsonNodeWrite;
-}
-
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -807,6 +796,17 @@ 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.
  */
@@ -870,8 +870,6 @@ interface GetSpansByProjectRequest {
  *     {
  *         spans: [{
  *                 traceId: "trace_id",
- *                 name: "name",
- *                 type: "general",
  *                 startTime: "2024-01-15T09:30:00Z"
  *             }]
  *     }
@@ -897,6 +895,8 @@ interface SpanUpdate$1 {
     projectId?: string;
     traceId: string;
     parentSpanId?: string;
+    name?: string;
+    type?: SpanUpdateType;
     endTime?: Date;
     input?: JsonListString;
     output?: JsonListString;
@@ -2365,6 +2365,238 @@ interface DeleteIdsHolder {
     ids: string[];
 }
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type CheckName = "TOPIC" | "PII";
+declare const CheckName: {
+    readonly Topic: "TOPIC";
+    readonly Pii: "PII";
+};
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type CheckResult = "passed" | "failed";
+declare const CheckResult: {
+    readonly Passed: "passed";
+    readonly Failed: "failed";
+};
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface Check$1 {
+    name?: CheckName;
+    result?: CheckResult;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+interface ErrorInfo {
+    exceptionType: string;
+    message?: string;
+    traceback: string;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface GuardrailsValidation {
+    spanId?: string;
+    checks?: Check$1[];
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type SpanType = "general" | "tool" | "llm" | "guardrail";
+declare const SpanType: {
+    readonly General: "general";
+    readonly Tool: "tool";
+    readonly Llm: "llm";
+    readonly Guardrail: "guardrail";
+};
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface Span$1 {
+    id?: string;
+    /** If null, the default project is used */
+    projectName?: string;
+    projectId?: string;
+    traceId: string;
+    parentSpanId?: string;
+    name?: string;
+    type?: SpanType;
+    startTime: Date;
+    endTime?: Date;
+    input?: JsonListString;
+    output?: JsonListString;
+    metadata?: JsonNode;
+    model?: string;
+    provider?: string;
+    tags?: string[];
+    usage?: Record<string, number>;
+    errorInfo?: ErrorInfo;
+    createdAt?: Date;
+    lastUpdatedAt?: Date;
+    createdBy?: string;
+    lastUpdatedBy?: string;
+    feedbackScores?: FeedbackScore[];
+    comments?: Comment[];
+    totalEstimatedCost?: number;
+    totalEstimatedCostVersion?: string;
+    /** Duration in milliseconds as a decimal number to support sub-millisecond precision */
+    duration?: number;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface Trace$1 {
+    id?: string;
+    /** If null, the default project is used */
+    projectName?: string;
+    projectId?: string;
+    name?: string;
+    startTime: Date;
+    endTime?: Date;
+    input?: JsonListString;
+    output?: JsonListString;
+    metadata?: JsonNode;
+    tags?: string[];
+    errorInfo?: ErrorInfo;
+    usage?: Record<string, number>;
+    createdAt?: Date;
+    lastUpdatedAt?: Date;
+    createdBy?: string;
+    lastUpdatedBy?: string;
+    feedbackScores?: FeedbackScore[];
+    comments?: Comment[];
+    guardrailsValidations?: GuardrailsValidation[];
+    totalEstimatedCost?: number;
+    spanCount?: number;
+    /** Duration in milliseconds as a decimal number to support sub-millisecond precision */
+    duration?: number;
+    threadId?: string;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+interface ErrorInfoWrite {
+    exceptionType: string;
+    message?: string;
+    traceback: string;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface ExperimentItemBulkRecordWrite {
+    datasetItemId: string;
+    trace?: TraceWrite;
+    spans?: SpanWrite[];
+    feedbackScores?: FeedbackScoreWrite[];
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type FeedbackScoreWriteSource = "ui" | "sdk" | "online_scoring";
+declare const FeedbackScoreWriteSource: {
+    readonly Ui: "ui";
+    readonly Sdk: "sdk";
+    readonly OnlineScoring: "online_scoring";
+};
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface FeedbackScoreWrite {
+    name: string;
+    categoryName?: string;
+    value: number;
+    reason?: string;
+    source: FeedbackScoreWriteSource;
+    createdAt?: Date;
+    lastUpdatedAt?: Date;
+    createdBy?: string;
+    lastUpdatedBy?: string;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type JsonListStringWrite = Record<string, unknown> | Record<string, unknown>[] | string;
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type SpanWriteType = "general" | "tool" | "llm" | "guardrail";
+declare const SpanWriteType: {
+    readonly General: "general";
+    readonly Tool: "tool";
+    readonly Llm: "llm";
+    readonly Guardrail: "guardrail";
+};
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface SpanWrite {
+    id?: string;
+    /** If null, the default project is used */
+    projectName?: string;
+    traceId: string;
+    parentSpanId?: string;
+    name?: string;
+    type?: SpanWriteType;
+    startTime: Date;
+    endTime?: Date;
+    input?: JsonListStringWrite;
+    output?: JsonListStringWrite;
+    metadata?: JsonNodeWrite;
+    model?: string;
+    provider?: string;
+    tags?: string[];
+    usage?: Record<string, number>;
+    errorInfo?: ErrorInfoWrite;
+    lastUpdatedAt?: Date;
+    totalEstimatedCost?: number;
+    totalEstimatedCostVersion?: string;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface TraceWrite {
+    id?: string;
+    /** If null, the default project is used */
+    projectName?: string;
+    name?: string;
+    startTime: Date;
+    endTime?: Date;
+    input?: JsonListStringWrite;
+    output?: JsonListStringWrite;
+    metadata?: JsonNodeWrite;
+    tags?: string[];
+    errorInfo?: ErrorInfoWrite;
+    lastUpdatedAt?: Date;
+    threadId?: string;
+}
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -2722,6 +2954,30 @@ interface ProviderApiKeyPublic {
     lastUpdatedBy?: string;
 }
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type OptimizationWriteStatus = "running" | "completed" | "cancelled";
+declare const OptimizationWriteStatus: {
+    readonly Running: "running";
+    readonly Completed: "completed";
+    readonly Cancelled: "cancelled";
+};
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface OptimizationWrite {
+    id?: string;
+    name?: string;
+    datasetName: string;
+    objectiveName: string;
+    status: OptimizationWriteStatus;
+    metadata?: JsonNodeWrite;
+    lastUpdatedAt?: Date;
+}
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -2884,6 +3140,7 @@ interface ProjectStatsSummaryItem {
     feedbackScores?: FeedbackScoreAverage[];
     duration?: PercentageValues;
     totalEstimatedCost?: number;
+    totalEstimatedCostSum?: number;
     usage?: Record<string, number>;
     traceCount?: number;
     guardrailsFailedCount?: number;
@@ -2932,6 +3189,7 @@ interface ProjectDetailed {
     feedbackScores?: FeedbackScoreAverageDetailed[];
     duration?: PercentageValuesDetailed;
     totalEstimatedCost?: number;
+    totalEstimatedCostSum?: number;
     usage?: Record<string, number>;
     traceCount?: number;
     guardrailsFailedCount?: number;
@@ -3057,113 +3315,6 @@ interface ServiceTogglesConfig {
     guardrailsEnabled: boolean;
 }
 
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-interface ErrorInfo {
-    exceptionType: string;
-    message?: string;
-    traceback: string;
-}
-
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-type SpanType = "general" | "tool" | "llm" | "guardrail";
-declare const SpanType: {
-    readonly General: "general";
-    readonly Tool: "tool";
-    readonly Llm: "llm";
-    readonly Guardrail: "guardrail";
-};
-
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-
-interface Span$1 {
-    id?: string;
-    /** If null, the default project is used */
-    projectName?: string;
-    projectId?: string;
-    traceId: string;
-    parentSpanId?: string;
-    name: string;
-    type: SpanType;
-    startTime: Date;
-    endTime?: Date;
-    input?: JsonListString;
-    output?: JsonListString;
-    metadata?: JsonNode;
-    model?: string;
-    provider?: string;
-    tags?: string[];
-    usage?: Record<string, number>;
-    errorInfo?: ErrorInfo;
-    createdAt?: Date;
-    lastUpdatedAt?: Date;
-    createdBy?: string;
-    lastUpdatedBy?: string;
-    feedbackScores?: FeedbackScore[];
-    comments?: Comment[];
-    totalEstimatedCost?: number;
-    totalEstimatedCostVersion?: string;
-    /** Duration in milliseconds as a decimal number to support sub-millisecond precision */
-    duration?: number;
-}
-
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-interface ErrorInfoWrite {
-    exceptionType: string;
-    message?: string;
-    traceback: string;
-}
-
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-type JsonListStringWrite = Record<string, unknown> | Record<string, unknown>[] | string;
-
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-type SpanWriteType = "general" | "tool" | "llm" | "guardrail";
-declare const SpanWriteType: {
-    readonly General: "general";
-    readonly Tool: "tool";
-    readonly Llm: "llm";
-    readonly Guardrail: "guardrail";
-};
-
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-
-interface SpanWrite {
-    id?: string;
-    /** If null, the default project is used */
-    projectName?: string;
-    traceId: string;
-    parentSpanId?: string;
-    name: string;
-    type: SpanWriteType;
-    startTime: Date;
-    endTime?: Date;
-    input?: JsonListStringWrite;
-    output?: JsonListStringWrite;
-    metadata?: JsonNodeWrite;
-    model?: string;
-    provider?: string;
-    tags?: string[];
-    usage?: Record<string, number>;
-    errorInfo?: ErrorInfoWrite;
-    lastUpdatedAt?: Date;
-    totalEstimatedCost?: number;
-    totalEstimatedCostVersion?: string;
-}
-
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -3233,8 +3384,8 @@ interface SpanPublic {
     projectId?: string;
     traceId: string;
     parentSpanId?: string;
-    name: string;
-    type: SpanPublicType;
+    name?: string;
+    type?: SpanPublicType;
     startTime: Date;
     endTime?: Date;
     input?: JsonListStringPublic;
@@ -3382,94 +3533,6 @@ interface SpanFilterPublic {
     value?: string;
 }
 
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-type CheckName = "TOPIC" | "PII";
-declare const CheckName: {
-    readonly Topic: "TOPIC";
-    readonly Pii: "PII";
-};
-
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-type CheckResult = "passed" | "failed";
-declare const CheckResult: {
-    readonly Passed: "passed";
-    readonly Failed: "failed";
-};
-
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-
-interface Check$1 {
-    name?: CheckName;
-    result?: CheckResult;
-}
-
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-
-interface GuardrailsValidation {
-    spanId?: string;
-    checks?: Check$1[];
-}
-
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-
-interface Trace$1 {
-    id?: string;
-    /** If null, the default project is used */
-    projectName?: string;
-    projectId?: string;
-    name?: string;
-    startTime: Date;
-    endTime?: Date;
-    input?: JsonListString;
-    output?: JsonListString;
-    metadata?: JsonNode;
-    tags?: string[];
-    errorInfo?: ErrorInfo;
-    usage?: Record<string, number>;
-    createdAt?: Date;
-    lastUpdatedAt?: Date;
-    createdBy?: string;
-    lastUpdatedBy?: string;
-    feedbackScores?: FeedbackScore[];
-    comments?: Comment[];
-    guardrailsValidations?: GuardrailsValidation[];
-    totalEstimatedCost?: number;
-    spanCount?: number;
-    /** Duration in milliseconds as a decimal number to support sub-millisecond precision */
-    duration?: number;
-    threadId?: string;
-}
-
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-
-interface TraceWrite {
-    id?: string;
-    /** If null, the default project is used */
-    projectName?: string;
-    name?: string;
-    startTime: Date;
-    endTime?: Date;
-    input?: JsonListStringWrite;
-    output?: JsonListStringWrite;
-    metadata?: JsonNodeWrite;
-    tags?: string[];
-    errorInfo?: ErrorInfoWrite;
-    lastUpdatedAt?: Date;
-    threadId?: string;
-}
-
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -4502,6 +4565,26 @@ declare class Experiments {
      */
     deleteExperimentsById(request: DeleteIdsHolder, requestOptions?: Experiments.RequestOptions): HttpResponsePromise<void>;
     private __deleteExperimentsById;
+    /**
+     * Record experiment items in bulk with traces, spans, and feedback scores. Maximum request size is 4MB.
+     *
+     * @param {OpikApi.ExperimentItemBulkUploadWrite} request
+     * @param {Experiments.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link OpikApi.BadRequestError}
+     * @throws {@link OpikApi.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.experiments.experimentItemsBulk({
+     *         experimentName: "experiment_name",
+     *         datasetName: "dataset_name",
+     *         items: [{
+     *                 datasetItemId: "dataset_item_id"
+     *             }]
+     *     })
+     */
+    experimentItemsBulk(request: ExperimentItemBulkUploadWrite, requestOptions?: Experiments.RequestOptions): HttpResponsePromise<void>;
+    private __experimentItemsBulk;
     /**
      * Find Feedback Score names
      *
@@ -4957,6 +5040,21 @@ declare class Optimizations {
      */
     createOptimization(request: OptimizationWrite, requestOptions?: Optimizations.RequestOptions): HttpResponsePromise<void>;
     private __createOptimization;
+    /**
+     * Upsert optimization
+     *
+     * @param {OpikApi.OptimizationWrite} request
+     * @param {Optimizations.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.optimizations.upsertOptimization({
+     *         datasetName: "dataset_name",
+     *         objectiveName: "objective_name",
+     *         status: "running"
+     *     })
+     */
+    upsertOptimization(request: OptimizationWrite, requestOptions?: Optimizations.RequestOptions): HttpResponsePromise<void>;
+    private __upsertOptimization;
     /**
      * Delete optimizations by id
      *
@@ -5496,8 +5594,6 @@ declare class Spans {
      * @example
      *     await client.spans.createSpan({
      *         traceId: "trace_id",
-     *         name: "name",
-     *         type: "general",
      *         startTime: "2024-01-15T09:30:00Z"
      *     })
      */
@@ -5513,8 +5609,6 @@ declare class Spans {
      *     await client.spans.createSpans({
      *         spans: [{
      *                 traceId: "trace_id",
-     *                 name: "name",
-     *                 type: "general",
      *                 startTime: "2024-01-15T09:30:00Z"
      *             }]
      *     })