opik 1.7.26 → 1.7.28

package/dist/{Client-DEn_NVx8.d.cts → Client-C7xyHzcm.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 ExperimentItemBulkUploadExperimentItemBulkWriteView {
+    experimentName: string;
+    datasetName: string;
+    items: ExperimentItemBulkRecordExperimentItemBulkWriteView[];
+}
+
 /**
  * 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,250 @@ 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.
+ */
+type TraceVisibilityMode = "default" | "hidden";
+declare const TraceVisibilityMode: {
+    readonly Default: "default";
+    readonly Hidden: "hidden";
+};
+
+/**
+ * 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;
+    visibilityMode?: TraceVisibilityMode;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+interface ErrorInfoExperimentItemBulkWriteView {
+    exceptionType: string;
+    message?: string;
+    traceback: string;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface ExperimentItemBulkRecordExperimentItemBulkWriteView {
+    datasetItemId: string;
+    trace?: TraceExperimentItemBulkWriteView;
+    spans?: SpanExperimentItemBulkWriteView[];
+    feedbackScores?: FeedbackScoreExperimentItemBulkWriteView[];
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type FeedbackScoreExperimentItemBulkWriteViewSource = "ui" | "sdk" | "online_scoring";
+declare const FeedbackScoreExperimentItemBulkWriteViewSource: {
+    readonly Ui: "ui";
+    readonly Sdk: "sdk";
+    readonly OnlineScoring: "online_scoring";
+};
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface FeedbackScoreExperimentItemBulkWriteView {
+    name: string;
+    categoryName?: string;
+    value: number;
+    reason?: string;
+    source: FeedbackScoreExperimentItemBulkWriteViewSource;
+    createdAt?: Date;
+    lastUpdatedAt?: Date;
+    createdBy?: string;
+    lastUpdatedBy?: string;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type JsonListStringExperimentItemBulkWriteView = Record<string, unknown> | Record<string, unknown>[] | string;
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type JsonNodeExperimentItemBulkWriteView = Record<string, unknown>;
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type SpanExperimentItemBulkWriteViewType = "general" | "tool" | "llm" | "guardrail";
+declare const SpanExperimentItemBulkWriteViewType: {
+    readonly General: "general";
+    readonly Tool: "tool";
+    readonly Llm: "llm";
+    readonly Guardrail: "guardrail";
+};
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface SpanExperimentItemBulkWriteView {
+    id?: string;
+    parentSpanId?: string;
+    name?: string;
+    type?: SpanExperimentItemBulkWriteViewType;
+    startTime: Date;
+    endTime?: Date;
+    input?: JsonListStringExperimentItemBulkWriteView;
+    output?: JsonListStringExperimentItemBulkWriteView;
+    metadata?: JsonNodeExperimentItemBulkWriteView;
+    model?: string;
+    provider?: string;
+    tags?: string[];
+    usage?: Record<string, number>;
+    errorInfo?: ErrorInfoExperimentItemBulkWriteView;
+    lastUpdatedAt?: Date;
+    totalEstimatedCost?: number;
+    totalEstimatedCostVersion?: string;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface TraceExperimentItemBulkWriteView {
+    id?: string;
+    /** If null, the default project is used */
+    projectName?: string;
+    name?: string;
+    startTime: Date;
+    endTime?: Date;
+    input?: JsonListStringExperimentItemBulkWriteView;
+    output?: JsonListStringExperimentItemBulkWriteView;
+    metadata?: JsonNodeExperimentItemBulkWriteView;
+    tags?: string[];
+    errorInfo?: ErrorInfoExperimentItemBulkWriteView;
+    lastUpdatedAt?: Date;
+    threadId?: string;
+}
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -2708,18 +2952,42 @@ declare const ProviderApiKeyPublicProvider: {
  * This file was auto-generated by Fern from our API Definition.
  */
 
-interface ProviderApiKeyPublic {
+interface ProviderApiKeyPublic {
+    id?: string;
+    provider: ProviderApiKeyPublicProvider;
+    apiKey: string;
+    name?: string;
+    headers?: Record<string, string>;
+    configuration?: Record<string, string>;
+    baseUrl?: string;
+    createdAt?: Date;
+    createdBy?: string;
+    lastUpdatedAt?: Date;
+    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;
-    provider: ProviderApiKeyPublicProvider;
-    apiKey: string;
     name?: string;
-    headers?: Record<string, string>;
-    configuration?: Record<string, string>;
-    baseUrl?: string;
-    createdAt?: Date;
-    createdBy?: string;
+    datasetName: string;
+    objectiveName: string;
+    status: OptimizationWriteStatus;
+    metadata?: JsonNodeWrite;
     lastUpdatedAt?: Date;
-    lastUpdatedBy?: string;
 }
 
 /**
@@ -2884,6 +3152,7 @@ interface ProjectStatsSummaryItem {
     feedbackScores?: FeedbackScoreAverage[];
     duration?: PercentageValues;
     totalEstimatedCost?: number;
+    totalEstimatedCostSum?: number;
     usage?: Record<string, number>;
     traceCount?: number;
     guardrailsFailedCount?: number;
@@ -2932,6 +3201,7 @@ interface ProjectDetailed {
     feedbackScores?: FeedbackScoreAverageDetailed[];
     duration?: PercentageValuesDetailed;
     totalEstimatedCost?: number;
+    totalEstimatedCostSum?: number;
     usage?: Record<string, number>;
     traceCount?: number;
     guardrailsFailedCount?: number;
@@ -3057,61 +3327,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.
  */
@@ -3147,8 +3362,8 @@ interface SpanWrite {
     projectName?: string;
     traceId: string;
     parentSpanId?: string;
-    name: string;
-    type: SpanWriteType;
+    name?: string;
+    type?: SpanWriteType;
     startTime: Date;
     endTime?: Date;
     input?: JsonListStringWrite;
@@ -3233,8 +3448,8 @@ interface SpanPublic {
     projectId?: string;
     traceId: string;
     parentSpanId?: string;
-    name: string;
-    type: SpanPublicType;
+    name?: string;
+    type?: SpanPublicType;
     startTime: Date;
     endTime?: Date;
     input?: JsonListStringPublic;
@@ -3382,74 +3597,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.
  */
@@ -3506,6 +3653,15 @@ interface GuardrailsValidationPublic {
     checks?: CheckPublic[];
 }
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type TracePublicVisibilityMode = "default" | "hidden";
+declare const TracePublicVisibilityMode: {
+    readonly Default: "default";
+    readonly Hidden: "hidden";
+};
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -3534,6 +3690,7 @@ interface TracePublic {
     /** Duration in milliseconds as a decimal number to support sub-millisecond precision */
     duration?: number;
     threadId?: string;
+    visibilityMode?: TracePublicVisibilityMode;
 }
 
 /**
@@ -4502,6 +4659,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.ExperimentItemBulkUploadExperimentItemBulkWriteView} 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: ExperimentItemBulkUploadExperimentItemBulkWriteView, requestOptions?: Experiments.RequestOptions): HttpResponsePromise<void>;
+    private __experimentItemsBulk;
     /**
      * Find Feedback Score names
      *
@@ -4957,6 +5134,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 +5688,6 @@ declare class Spans {
      * @example
      *     await client.spans.createSpan({
      *         traceId: "trace_id",
-     *         name: "name",
-     *         type: "general",
      *         startTime: "2024-01-15T09:30:00Z"
      *     })
      */
@@ -5513,8 +5703,6 @@ declare class Spans {
      *     await client.spans.createSpans({
      *         spans: [{
      *                 traceId: "trace_id",
-     *                 name: "name",
-     *                 type: "general",
      *                 startTime: "2024-01-15T09:30:00Z"
      *             }]
      *     })
@@ -6275,6 +6463,133 @@ declare class TraceFeedbackScoresBatchQueue extends BatchQueue<FeedbackScoreBatc
     protected deleteEntities(scoreIds: FeedbackScoreId[]): Promise<void>;
 }
 
+/**
+ * Batch queue for dataset operations that allows efficient batching of dataset CRUD operations.
+ * Extends the generic BatchQueue to provide specific implementations for dataset resources.
+ */
+declare class DatasetBatchQueue extends BatchQueue<DatasetWrite> {
+    private readonly api;
+    /**
+     * Creates a new DatasetBatchQueue instance.
+     *
+     * @param api The OpikApiClient instance used to communicate with the API
+     * @param delay Optional delay in milliseconds before flushing the queue (defaults to 300ms)
+     */
+    constructor(api: OpikApiClient, delay?: number);
+    /**
+     * Gets the ID of a dataset entity.
+     *
+     * @param entity The dataset entity
+     * @returns The ID of the dataset
+     */
+    protected getId(entity: DatasetWrite): string;
+    /**
+     * Creates multiple dataset entities in a batch.
+     *
+     * @param datasets The array of datasets to create
+     */
+    protected createEntities(datasets: DatasetWrite[]): Promise<void>;
+    /**
+     * Retrieves a dataset by its ID.
+     *
+     * @param id The ID of the dataset to retrieve
+     * @returns The retrieved dataset or undefined if not found
+     */
+    protected getEntity(id: string): Promise<DatasetPublic | undefined>;
+    /**
+     * Updates a dataset by its ID with the provided updates.
+     *
+     * @param id The ID of the dataset to update
+     * @param updates Partial dataset properties to update
+     */
+    protected updateEntity(id: string, updates: Partial<DatasetWrite>): Promise<void>;
+    /**
+     * Deletes multiple datasets by their IDs.
+     *
+     * @param ids Array of dataset IDs to delete
+     */
+    protected deleteEntities(ids: string[]): Promise<void>;
+}
+
+type DatasetItemData = JsonNode & {
+    id?: string;
+};
+
+interface DatasetData {
+    name: string;
+    description?: string;
+    id?: string;
+}
+declare class Dataset<T extends DatasetItemData = DatasetItemData> {
+    private opik;
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    private idToHash;
+    private hashes;
+    /**
+     * Configuration object for creating a new Dataset instance.
+     * This should not be created directly, use static factory methods instead.
+     */
+    constructor({ name, description, id }: DatasetData, opik: OpikClient);
+    /**
+     * Insert new items into the dataset.
+     *
+     * @param items List of objects to add to the dataset
+     */
+    insert(items: T[]): Promise<void>;
+    /**
+     * Update existing items in the dataset.
+     * You need to provide the full item object as it will override what has been supplied previously.
+     *
+     * @param items List of objects to update in the dataset
+     */
+    update(items: T[]): Promise<void>;
+    /**
+     * Delete items from the dataset.
+     *
+     * @param itemIds List of item ids to delete
+     */
+    delete(itemIds: string[]): Promise<void>;
+    /**
+     * Delete all items from the dataset.
+     */
+    clear(): Promise<void>;
+    /**
+     * Retrieve a fixed number of dataset items.
+     *
+     * @param nbSamples The number of samples to retrieve. If not set - all items are returned
+     * @param lastRetrievedId Optional ID of the last retrieved item for pagination
+     * @returns A list of objects representing the dataset items
+     */
+    getItems(nbSamples?: number, lastRetrievedId?: string): Promise<(T & {
+        id: string;
+    })[]>;
+    private getItemsAsDataclasses;
+    /**
+     * Insert items from a JSON string array into the dataset.
+     *
+     * @param jsonArray JSON string of format: "[{...}, {...}, {...}]" where every object is transformed into a dataset item
+     * @param keysMapping Optional dictionary that maps JSON keys to dataset item field names (e.g., {'Expected output': 'expected_output'})
+     * @param ignoreKeys Optional array of keys that should be ignored when constructing dataset items
+     */
+    insertFromJson(jsonArray: string, keysMapping?: Record<string, string>, ignoreKeys?: string[]): Promise<void>;
+    /**
+     * Convert the dataset to a JSON string.
+     *
+     * @param keysMapping Optional dictionary that maps dataset item field names to output JSON keys
+     * @returns A JSON string representation of all items in the dataset
+     */
+    toJson(keysMapping?: Record<string, string>): Promise<string>;
+    /**
+     * Retrieves all items from the dataset, deduplicates them, and returns them.
+     *
+     * @returns A list of deduplicated dataset items
+     */
+    private getDeduplicatedItems;
+    syncHashes(): Promise<void>;
+}
+
 interface TraceData extends Omit<Trace$1, "startTime"> {
     startTime?: Date;
 }
@@ -6285,10 +6600,48 @@ declare class OpikClient {
     traceBatchQueue: TraceBatchQueue;
     spanFeedbackScoresBatchQueue: SpanFeedbackScoresBatchQueue;
     traceFeedbackScoresBatchQueue: TraceFeedbackScoresBatchQueue;
+    datasetBatchQueue: DatasetBatchQueue;
     private lastProjectNameLogged;
     constructor(explicitConfig?: Partial<OpikConfig>);
     private displayTraceLog;
     trace: (traceData: TraceData) => Trace;
+    /**
+     * Retrieves an existing dataset by name
+     *
+     * @param name The name of the dataset to retrieve
+     * @returns A Dataset object associated with the specified name
+     * @throws Error if the dataset doesn't exist
+     */
+    getDataset: <T extends DatasetItemData = DatasetItemData>(name: string) => Promise<Dataset<T>>;
+    /**
+     * Creates a new dataset with the given name and optional description
+     *
+     * @param name The name of the dataset
+     * @param description Optional description of the dataset
+     * @returns The created Dataset object
+     */
+    createDataset: <T extends DatasetItemData = DatasetItemData>(name: string, description?: string) => Promise<Dataset<T>>;
+    /**
+     * Retrieves an existing dataset by name or creates a new one if it doesn't exist.
+     *
+     * @param name The name of the dataset
+     * @param description Optional description of the dataset (used if created)
+     * @returns A promise that resolves to the existing or newly created Dataset object
+     */
+    getOrCreateDataset: <T extends DatasetItemData = DatasetItemData>(name: string, description?: string) => Promise<Dataset<T>>;
+    /**
+     * Returns all datasets up to the specified limit
+     *
+     * @param maxResults Maximum number of datasets to return (default: 100)
+     * @returns List of Dataset objects
+     */
+    getDatasets: <T extends DatasetItemData = DatasetItemData>(maxResults?: number) => Promise<Dataset<T>[]>;
+    /**
+     * Deletes a dataset by name
+     *
+     * @param name The name of the dataset to delete
+     */
+    deleteDataset: (name: string) => Promise<void>;
     flush: () => Promise<void>;
 }