opik 1.9.69 → 1.9.71

package/dist/index.d.cts

@@ -184,6 +184,23 @@ declare const DatasetUpdateVisibility: {
     readonly Public: "public";
 };
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+/**
+ * @example
+ *     {
+ *         body: {
+ *             "key": "value"
+ *         }
+ *     }
+ */
+interface ApplyDatasetItemChangesRequest {
+    override?: boolean;
+    body: DatasetItemChangesPublic;
+}
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -198,6 +215,8 @@ interface DatasetItemBatchUpdate {
     /** List of dataset item IDs to update (max 1000). Mutually exclusive with 'filters'. */
     ids?: string[];
     filters?: DatasetItemFilter[];
+    /** Dataset ID. Required when using 'filters', optional when using 'ids'. */
+    datasetId?: string;
     update: DatasetItemUpdate;
     /** If true, merge tags with existing tags instead of replacing them. Default: false. When using 'filters', this is automatically set to true. */
     mergeTags?: boolean;
@@ -488,22 +507,6 @@ interface ListDatasetVersionsRequest {
     size?: number;
 }
 
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-/**
- * @example
- *     {}
- */
-interface DatasetVersionCreatePublic {
-    /** Optional list of tags for this version */
-    tags?: string[];
-    /** Optional description of changes in this version */
-    changeDescription?: string;
-    /** Optional user-defined metadata */
-    metadata?: Record<string, string>;
-}
-
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -852,22 +855,6 @@ interface FindOptimizationsRequest {
     filters?: string;
 }
 
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-/**
- * @example
- *     {}
- */
-interface FindStudioOptimizationsRequest {
-    page?: number;
-    size?: number;
-    datasetId?: string;
-    name?: string;
-    datasetDeleted?: boolean;
-    filters?: string;
-}
-
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -3670,6 +3657,39 @@ interface DashboardPagePublic {
     sortableBy?: string[];
 }
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+interface DatasetVersionPublic {
+    id?: string;
+    datasetId?: string;
+    versionHash?: string;
+    tags?: string[];
+    /** Indicates whether this is the latest version of the dataset */
+    isLatest?: boolean;
+    /** Sequential version name formatted as 'v1', 'v2', etc. */
+    versionName?: string;
+    /** Total number of items in this version */
+    itemsTotal?: number;
+    /** Number of items added since last version */
+    itemsAdded?: number;
+    /** Number of items modified since last version */
+    itemsModified?: number;
+    /** Number of items deleted since last version */
+    itemsDeleted?: number;
+    changeDescription?: string;
+    metadata?: Record<string, string>;
+    createdAt?: Date;
+    createdBy?: string;
+    lastUpdatedAt?: Date;
+    lastUpdatedBy?: string;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type DatasetItemChangesPublic = Record<string, unknown>;
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -3968,7 +3988,6 @@ interface DatasetItemPageCompare {
     total?: number;
     columns?: ColumnCompare[];
     sortableBy?: string[];
-    hasDraft?: boolean;
 }
 
 /**
@@ -4113,6 +4132,8 @@ interface DatasetVersionSummaryPublic {
     id?: string;
     /** Hash of the version content */
     versionHash?: string;
+    /** Sequential version name formatted as 'v1', 'v2', etc. */
+    versionName?: string;
     /** Description of changes in this version */
     changeDescription?: string;
     /** Tags associated with this version */
@@ -4315,7 +4336,6 @@ interface DatasetItemPagePublic {
     total?: number;
     columns?: ColumnPublic[];
     sortableBy?: string[];
-    hasDraft?: boolean;
 }
 
 /**
@@ -4382,32 +4402,6 @@ interface DatasetVersionPagePublic {
     total?: number;
 }
 
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-interface DatasetVersionPublic {
-    id?: string;
-    datasetId?: string;
-    versionHash?: string;
-    tags?: string[];
-    /** Indicates whether this is the latest version of the dataset */
-    isLatest?: boolean;
-    /** Total number of items in this version */
-    itemsTotal?: number;
-    /** Number of items added since last version */
-    itemsAdded?: number;
-    /** Number of items modified since last version */
-    itemsModified?: number;
-    /** Number of items deleted since last version */
-    itemsDeleted?: number;
-    changeDescription?: string;
-    metadata?: Record<string, string>;
-    createdAt?: Date;
-    createdBy?: string;
-    lastUpdatedAt?: Date;
-    lastUpdatedBy?: string;
-}
-
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -4796,6 +4790,7 @@ interface ExperimentPublic {
     id?: string;
     datasetName: string;
     datasetId?: string;
+    projectId?: string;
     name?: string;
     metadata?: JsonListStringPublic;
     type?: ExperimentPublicType;
@@ -7469,6 +7464,33 @@ declare namespace Datasets {
 declare class Datasets {
     protected readonly _options: Datasets.Options;
     constructor(_options?: Datasets.Options);
+    /**
+     * Apply delta changes (add, edit, delete) to a dataset version with conflict detection.
+     *
+     * This endpoint:
+     * - Creates a new version with the applied changes
+     * - Validates that baseVersion matches the latest version (unless override=true)
+     * - Returns 409 Conflict if baseVersion is stale and override is not set
+     *
+     * Use `override=true` query parameter to force version creation even with stale baseVersion.
+     *
+     * @param {string} id
+     * @param {OpikApi.ApplyDatasetItemChangesRequest} request
+     * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link OpikApi.BadRequestError}
+     * @throws {@link OpikApi.NotFoundError}
+     * @throws {@link OpikApi.ConflictError}
+     *
+     * @example
+     *     await client.datasets.applyDatasetItemChanges("id", {
+     *         body: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    applyDatasetItemChanges(id: string, request: ApplyDatasetItemChangesRequest, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<DatasetVersionPublic>;
+    private __applyDatasetItemChanges;
     /**
      * Update multiple dataset items
      *
@@ -7801,49 +7823,34 @@ declare class Datasets {
     createVersionTag(versionHash: string, id: string, request: DatasetVersionTag, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<void>;
     private __createVersionTag;
     /**
-     * Get paginated list of versions for a dataset, ordered by creation time (newest first)
+     * Remove a tag from a dataset version. The version itself is not deleted, only the tag reference.
      *
+     * @param {string} versionHash
+     * @param {string} tag
      * @param {string} id
-     * @param {OpikApi.ListDatasetVersionsRequest} request
      * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
      *
-     * @throws {@link OpikApi.BadRequestError}
-     *
      * @example
-     *     await client.datasets.listDatasetVersions("id")
+     *     await client.datasets.deleteVersionTag("versionHash", "tag", "id")
      */
-    listDatasetVersions(id: string, request?: ListDatasetVersionsRequest, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<DatasetVersionPagePublic>;
-    private __listDatasetVersions;
+    deleteVersionTag(versionHash: string, tag: string, id: string, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<void>;
+    private __deleteVersionTag;
     /**
-     * Create a new immutable version of the dataset by snapshotting the current state
+     * Get paginated list of versions for a dataset, ordered by creation time (newest first)
      *
      * @param {string} id
-     * @param {OpikApi.DatasetVersionCreatePublic} request
+     * @param {OpikApi.ListDatasetVersionsRequest} request
      * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link OpikApi.BadRequestError}
-     * @throws {@link OpikApi.ConflictError}
      *
      * @example
-     *     await client.datasets.createDatasetVersion("id")
-     */
-    createDatasetVersion(id: string, request?: DatasetVersionCreatePublic, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<void>;
-    private __createDatasetVersion;
-    /**
-     * Remove a tag from a dataset version. The version itself is not deleted, only the tag reference.
-     *
-     * @param {string} versionHash
-     * @param {string} tag
-     * @param {string} id
-     * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.datasets.deleteVersionTag("versionHash", "tag", "id")
+     *     await client.datasets.listDatasetVersions("id")
      */
-    deleteVersionTag(versionHash: string, tag: string, id: string, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<void>;
-    private __deleteVersionTag;
+    listDatasetVersions(id: string, request?: ListDatasetVersionsRequest, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<DatasetVersionPagePublic>;
+    private __listDatasetVersions;
     /**
-     * Restores the dataset to a previous version state. All draft items are replaced with items from the specified version. If the version is not the latest, a new version snapshot is created. If the version is the latest, only draft items are replaced (revert functionality).
+     * Restores the dataset to a previous version state by creating a new version with items copied from the specified version. If the version is already the latest, returns it as-is (no-op).
      *
      * @param {string} id
      * @param {OpikApi.DatasetVersionRestorePublic} request
@@ -8651,19 +8658,6 @@ declare class Optimizations {
      */
     deleteOptimizationsById(request: DeleteIdsHolder, requestOptions?: Optimizations.RequestOptions): HttpResponsePromise<void>;
     private __deleteOptimizationsById;
-    /**
-     * Find Studio optimizations
-     *
-     * @param {OpikApi.FindStudioOptimizationsRequest} request
-     * @param {Optimizations.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link OpikApi.BadRequestError}
-     *
-     * @example
-     *     await client.optimizations.findStudioOptimizations()
-     */
-    findStudioOptimizations(request?: FindStudioOptimizationsRequest, requestOptions?: Optimizations.RequestOptions): HttpResponsePromise<OptimizationPagePublic>;
-    private __findStudioOptimizations;
     /**
      * Get optimization by id
      *
@@ -8689,19 +8683,6 @@ declare class Optimizations {
      */
     updateOptimizationsById(id: string, request?: OptimizationUpdate, requestOptions?: Optimizations.RequestOptions): HttpResponsePromise<void>;
     private __updateOptimizationsById;
-    /**
-     * Get Studio optimization with config included
-     *
-     * @param {string} id
-     * @param {Optimizations.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link OpikApi.NotFoundError}
-     *
-     * @example
-     *     await client.optimizations.getStudioOptimizationById("id")
-     */
-    getStudioOptimizationById(id: string, requestOptions?: Optimizations.RequestOptions): HttpResponsePromise<OptimizationPublic>;
-    private __getStudioOptimizationById;
     /**
      * Get presigned S3 URL for downloading optimization logs
      *

package/dist/index.d.ts

@@ -184,6 +184,23 @@ declare const DatasetUpdateVisibility: {
     readonly Public: "public";
 };
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+/**
+ * @example
+ *     {
+ *         body: {
+ *             "key": "value"
+ *         }
+ *     }
+ */
+interface ApplyDatasetItemChangesRequest {
+    override?: boolean;
+    body: DatasetItemChangesPublic;
+}
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -198,6 +215,8 @@ interface DatasetItemBatchUpdate {
     /** List of dataset item IDs to update (max 1000). Mutually exclusive with 'filters'. */
     ids?: string[];
     filters?: DatasetItemFilter[];
+    /** Dataset ID. Required when using 'filters', optional when using 'ids'. */
+    datasetId?: string;
     update: DatasetItemUpdate;
     /** If true, merge tags with existing tags instead of replacing them. Default: false. When using 'filters', this is automatically set to true. */
     mergeTags?: boolean;
@@ -488,22 +507,6 @@ interface ListDatasetVersionsRequest {
     size?: number;
 }
 
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-/**
- * @example
- *     {}
- */
-interface DatasetVersionCreatePublic {
-    /** Optional list of tags for this version */
-    tags?: string[];
-    /** Optional description of changes in this version */
-    changeDescription?: string;
-    /** Optional user-defined metadata */
-    metadata?: Record<string, string>;
-}
-
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -852,22 +855,6 @@ interface FindOptimizationsRequest {
     filters?: string;
 }
 
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-/**
- * @example
- *     {}
- */
-interface FindStudioOptimizationsRequest {
-    page?: number;
-    size?: number;
-    datasetId?: string;
-    name?: string;
-    datasetDeleted?: boolean;
-    filters?: string;
-}
-
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -3670,6 +3657,39 @@ interface DashboardPagePublic {
     sortableBy?: string[];
 }
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+interface DatasetVersionPublic {
+    id?: string;
+    datasetId?: string;
+    versionHash?: string;
+    tags?: string[];
+    /** Indicates whether this is the latest version of the dataset */
+    isLatest?: boolean;
+    /** Sequential version name formatted as 'v1', 'v2', etc. */
+    versionName?: string;
+    /** Total number of items in this version */
+    itemsTotal?: number;
+    /** Number of items added since last version */
+    itemsAdded?: number;
+    /** Number of items modified since last version */
+    itemsModified?: number;
+    /** Number of items deleted since last version */
+    itemsDeleted?: number;
+    changeDescription?: string;
+    metadata?: Record<string, string>;
+    createdAt?: Date;
+    createdBy?: string;
+    lastUpdatedAt?: Date;
+    lastUpdatedBy?: string;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type DatasetItemChangesPublic = Record<string, unknown>;
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -3968,7 +3988,6 @@ interface DatasetItemPageCompare {
     total?: number;
     columns?: ColumnCompare[];
     sortableBy?: string[];
-    hasDraft?: boolean;
 }
 
 /**
@@ -4113,6 +4132,8 @@ interface DatasetVersionSummaryPublic {
     id?: string;
     /** Hash of the version content */
     versionHash?: string;
+    /** Sequential version name formatted as 'v1', 'v2', etc. */
+    versionName?: string;
     /** Description of changes in this version */
     changeDescription?: string;
     /** Tags associated with this version */
@@ -4315,7 +4336,6 @@ interface DatasetItemPagePublic {
     total?: number;
     columns?: ColumnPublic[];
     sortableBy?: string[];
-    hasDraft?: boolean;
 }
 
 /**
@@ -4382,32 +4402,6 @@ interface DatasetVersionPagePublic {
     total?: number;
 }
 
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-interface DatasetVersionPublic {
-    id?: string;
-    datasetId?: string;
-    versionHash?: string;
-    tags?: string[];
-    /** Indicates whether this is the latest version of the dataset */
-    isLatest?: boolean;
-    /** Total number of items in this version */
-    itemsTotal?: number;
-    /** Number of items added since last version */
-    itemsAdded?: number;
-    /** Number of items modified since last version */
-    itemsModified?: number;
-    /** Number of items deleted since last version */
-    itemsDeleted?: number;
-    changeDescription?: string;
-    metadata?: Record<string, string>;
-    createdAt?: Date;
-    createdBy?: string;
-    lastUpdatedAt?: Date;
-    lastUpdatedBy?: string;
-}
-
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -4796,6 +4790,7 @@ interface ExperimentPublic {
     id?: string;
     datasetName: string;
     datasetId?: string;
+    projectId?: string;
     name?: string;
     metadata?: JsonListStringPublic;
     type?: ExperimentPublicType;
@@ -7469,6 +7464,33 @@ declare namespace Datasets {
 declare class Datasets {
     protected readonly _options: Datasets.Options;
     constructor(_options?: Datasets.Options);
+    /**
+     * Apply delta changes (add, edit, delete) to a dataset version with conflict detection.
+     *
+     * This endpoint:
+     * - Creates a new version with the applied changes
+     * - Validates that baseVersion matches the latest version (unless override=true)
+     * - Returns 409 Conflict if baseVersion is stale and override is not set
+     *
+     * Use `override=true` query parameter to force version creation even with stale baseVersion.
+     *
+     * @param {string} id
+     * @param {OpikApi.ApplyDatasetItemChangesRequest} request
+     * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link OpikApi.BadRequestError}
+     * @throws {@link OpikApi.NotFoundError}
+     * @throws {@link OpikApi.ConflictError}
+     *
+     * @example
+     *     await client.datasets.applyDatasetItemChanges("id", {
+     *         body: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    applyDatasetItemChanges(id: string, request: ApplyDatasetItemChangesRequest, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<DatasetVersionPublic>;
+    private __applyDatasetItemChanges;
     /**
      * Update multiple dataset items
      *
@@ -7801,49 +7823,34 @@ declare class Datasets {
     createVersionTag(versionHash: string, id: string, request: DatasetVersionTag, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<void>;
     private __createVersionTag;
     /**
-     * Get paginated list of versions for a dataset, ordered by creation time (newest first)
+     * Remove a tag from a dataset version. The version itself is not deleted, only the tag reference.
      *
+     * @param {string} versionHash
+     * @param {string} tag
      * @param {string} id
-     * @param {OpikApi.ListDatasetVersionsRequest} request
      * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
      *
-     * @throws {@link OpikApi.BadRequestError}
-     *
      * @example
-     *     await client.datasets.listDatasetVersions("id")
+     *     await client.datasets.deleteVersionTag("versionHash", "tag", "id")
      */
-    listDatasetVersions(id: string, request?: ListDatasetVersionsRequest, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<DatasetVersionPagePublic>;
-    private __listDatasetVersions;
+    deleteVersionTag(versionHash: string, tag: string, id: string, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<void>;
+    private __deleteVersionTag;
     /**
-     * Create a new immutable version of the dataset by snapshotting the current state
+     * Get paginated list of versions for a dataset, ordered by creation time (newest first)
      *
      * @param {string} id
-     * @param {OpikApi.DatasetVersionCreatePublic} request
+     * @param {OpikApi.ListDatasetVersionsRequest} request
      * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link OpikApi.BadRequestError}
-     * @throws {@link OpikApi.ConflictError}
      *
      * @example
-     *     await client.datasets.createDatasetVersion("id")
-     */
-    createDatasetVersion(id: string, request?: DatasetVersionCreatePublic, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<void>;
-    private __createDatasetVersion;
-    /**
-     * Remove a tag from a dataset version. The version itself is not deleted, only the tag reference.
-     *
-     * @param {string} versionHash
-     * @param {string} tag
-     * @param {string} id
-     * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.datasets.deleteVersionTag("versionHash", "tag", "id")
+     *     await client.datasets.listDatasetVersions("id")
      */
-    deleteVersionTag(versionHash: string, tag: string, id: string, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<void>;
-    private __deleteVersionTag;
+    listDatasetVersions(id: string, request?: ListDatasetVersionsRequest, requestOptions?: Datasets.RequestOptions): HttpResponsePromise<DatasetVersionPagePublic>;
+    private __listDatasetVersions;
     /**
-     * Restores the dataset to a previous version state. All draft items are replaced with items from the specified version. If the version is not the latest, a new version snapshot is created. If the version is the latest, only draft items are replaced (revert functionality).
+     * Restores the dataset to a previous version state by creating a new version with items copied from the specified version. If the version is already the latest, returns it as-is (no-op).
      *
      * @param {string} id
      * @param {OpikApi.DatasetVersionRestorePublic} request
@@ -8651,19 +8658,6 @@ declare class Optimizations {
      */
     deleteOptimizationsById(request: DeleteIdsHolder, requestOptions?: Optimizations.RequestOptions): HttpResponsePromise<void>;
     private __deleteOptimizationsById;
-    /**
-     * Find Studio optimizations
-     *
-     * @param {OpikApi.FindStudioOptimizationsRequest} request
-     * @param {Optimizations.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link OpikApi.BadRequestError}
-     *
-     * @example
-     *     await client.optimizations.findStudioOptimizations()
-     */
-    findStudioOptimizations(request?: FindStudioOptimizationsRequest, requestOptions?: Optimizations.RequestOptions): HttpResponsePromise<OptimizationPagePublic>;
-    private __findStudioOptimizations;
     /**
      * Get optimization by id
      *
@@ -8689,19 +8683,6 @@ declare class Optimizations {
      */
     updateOptimizationsById(id: string, request?: OptimizationUpdate, requestOptions?: Optimizations.RequestOptions): HttpResponsePromise<void>;
     private __updateOptimizationsById;
-    /**
-     * Get Studio optimization with config included
-     *
-     * @param {string} id
-     * @param {Optimizations.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link OpikApi.NotFoundError}
-     *
-     * @example
-     *     await client.optimizations.getStudioOptimizationById("id")
-     */
-    getStudioOptimizationById(id: string, requestOptions?: Optimizations.RequestOptions): HttpResponsePromise<OptimizationPublic>;
-    private __getStudioOptimizationById;
     /**
      * Get presigned S3 URL for downloading optimization logs
      *