langsmith 0.7.8 → 0.7.9

package/dist/_openapi_client/resources/online-evaluators.d.ts

@@ -0,0 +1,284 @@
+import { APIResource } from '../core/resource.js';
+import { APIPromise } from '../core/api-promise.js';
+import { OffsetPaginationOnlineEvaluators, type OffsetPaginationOnlineEvaluatorsParams, PagePromise } from '../core/pagination.js';
+import { RequestOptions } from '../internal/request-options.js';
+export declare class OnlineEvaluators extends APIResource {
+    /**
+     * Create a new LLM or code evaluator for the current workspace.
+     */
+    create(body: OnlineEvaluatorCreateParams, options?: RequestOptions): APIPromise<CreateOnlineEvaluatorResponse>;
+    /**
+     * Retrieve a single evaluator by its ID.
+     */
+    retrieve(evaluatorID: string, options?: RequestOptions): APIPromise<OnlineEvaluator>;
+    /**
+     * Update an existing evaluator's name, LLM configuration, or code configuration.
+     */
+    update(evaluatorID: string, body: OnlineEvaluatorUpdateParams, options?: RequestOptions): APIPromise<UpdateOnlineEvaluatorResponse>;
+    /**
+     * List evaluators for the current workspace, with optional filtering by type,
+     * name, tag, feedback key, or resource ID.
+     */
+    list(query?: OnlineEvaluatorListParams | null | undefined, options?: RequestOptions): PagePromise<OnlineEvaluatorsOffsetPaginationOnlineEvaluators, OnlineEvaluator>;
+    /**
+     * Delete an evaluator. When delete_run_rules is true, all run rules referencing
+     * this evaluator are deleted first (same tenant). Associated llm_evaluators and
+     * code_evaluators rows are removed by foreign-key cascade when the evaluator row
+     * is deleted.
+     */
+    delete(evaluatorID: string, params?: OnlineEvaluatorDeleteParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Delete multiple evaluators by their IDs. Returns per-item success/failure.
+     */
+    bulkDelete(params: OnlineEvaluatorBulkDeleteParams, options?: RequestOptions): APIPromise<BulkDeleteEvaluatorsResponse>;
+    /**
+     * Returns per-day LLM evaluator spend for the requested 7-day period, grouped by
+     * evaluator, resource, or run rule. Exactly one of group_by, evaluator_id,
+     * session_id, or dataset_id is required. resource_id, type, and feedback_key may
+     * be supplied with group_by to narrow listing aggregations.
+     */
+    spend(query: OnlineEvaluatorSpendParams, options?: RequestOptions): APIPromise<GetOnlineEvaluatorSpendResponse>;
+}
+export type OnlineEvaluatorsOffsetPaginationOnlineEvaluators = OffsetPaginationOnlineEvaluators<OnlineEvaluator>;
+export interface BulkDeleteEvaluatorFailedItem {
+    id?: string;
+    error?: string;
+}
+export interface BulkDeleteEvaluatorsResponse {
+    failed?: Array<BulkDeleteEvaluatorFailedItem>;
+    succeeded?: Array<string>;
+}
+export interface CreateOnlineCodeEvaluatorRequest {
+    code?: string;
+    /**
+     * Default: "python"
+     */
+    language?: string;
+}
+export interface CreateOnlineEvaluatorRequest {
+    code_evaluator?: CreateOnlineCodeEvaluatorRequest;
+    llm_evaluator?: CreateOnlineLlmEvaluatorRequest;
+    name?: string;
+    type?: OnlineEvaluatorType;
+}
+export interface CreateOnlineEvaluatorResponse {
+    evaluator?: OnlineEvaluator;
+}
+export interface CreateOnlineLlmEvaluatorRequest {
+    commit_hash_or_tag?: string;
+    prompt_repo_handle?: string;
+    variable_mapping?: unknown;
+}
+export interface GetOnlineEvaluatorSpendResponse {
+    groups?: Array<OnlineEvaluatorSpendGroup>;
+    period_end?: string;
+    period_start?: string;
+}
+export interface OnlineCodeEvaluator {
+    code?: string;
+    evaluator_id?: string;
+    /**
+     * Default: "python"
+     */
+    language?: string;
+}
+export interface OnlineEvaluator {
+    id?: string;
+    code_evaluator?: OnlineCodeEvaluator;
+    created_at?: string;
+    created_by?: string;
+    feedback_keys?: Array<string>;
+    /**
+     * Embedded child evaluator (populated based on type)
+     */
+    llm_evaluator?: OnlineLlmEvaluator;
+    name?: string;
+    run_rules?: Array<OnlineEvaluatorRunRule>;
+    tenant_id?: string;
+    type?: OnlineEvaluatorType;
+    updated_at?: string;
+}
+export interface OnlineEvaluatorRunRule {
+    id?: string;
+    corrections_dataset_id?: string;
+    dataset_id?: string;
+    dataset_name?: string;
+    group_by?: string;
+    num_few_shot_examples?: number;
+    session_id?: string;
+    session_name?: string;
+    /**
+     * SpendLimit is the effective spend-cap limit for this rule (nil when
+     * unconfigured).
+     */
+    spend_limit?: OnlineSpendLimit;
+    /**
+     * Per-rule usage for the current ISO week (omitted when feature is disabled).
+     * LLM-evaluator rules are initialized to 0; code-evaluator rules include trace
+     * counts only.
+     */
+    spend_usd?: number;
+    trace_count?: number;
+    use_corrections_dataset?: boolean;
+}
+export interface OnlineEvaluatorSpendDay {
+    date?: string;
+    spend_usd?: number;
+    trace_count?: number;
+}
+export interface OnlineEvaluatorSpendGroup {
+    dataset_id?: string;
+    dataset_name?: string;
+    days?: Array<OnlineEvaluatorSpendDay>;
+    evaluator_id?: string;
+    evaluator_name?: string;
+    prev_total_spend_usd?: number;
+    prev_total_trace_count?: number;
+    run_rule_id?: string;
+    run_rule_name?: string;
+    session_id?: string;
+    session_name?: string;
+    spend_limit?: OnlineSpendLimit;
+    total_spend_usd?: number;
+    total_trace_count?: number;
+}
+export type OnlineEvaluatorType = 'llm' | 'code';
+export interface OnlineLlmEvaluator {
+    annotation_queue_id?: string;
+    commit_hash_or_tag?: string;
+    corrections_dataset_id?: string;
+    evaluator_id?: string;
+    num_few_shot_examples?: number;
+    prompt_id?: string;
+    prompt_repo_handle?: string;
+    /**
+     * Derived from the evaluator's run rules — shared across all rules on this
+     * evaluator. Nil when the evaluator has no run rules.
+     */
+    use_corrections_dataset?: boolean;
+    /**
+     * JSONB
+     */
+    variable_mapping?: unknown;
+}
+export interface OnlineSpendLimit {
+    limit_usd?: number;
+    utilization_pct?: number;
+    window?: string;
+}
+export interface UpdateOnlineCodeEvaluatorRequest {
+    code?: string;
+    language?: string;
+}
+export interface UpdateOnlineEvaluatorRequest {
+    code_evaluator?: UpdateOnlineCodeEvaluatorRequest;
+    llm_evaluator?: UpdateOnlineLlmEvaluatorRequest;
+    name?: string;
+}
+export interface UpdateOnlineEvaluatorResponse {
+    evaluator?: OnlineEvaluator;
+}
+export interface UpdateOnlineLlmEvaluatorRequest {
+    commit_hash_or_tag?: string;
+    num_few_shot_examples?: number;
+    prompt_repo_handle?: string;
+    use_corrections_dataset?: boolean;
+    variable_mapping?: unknown;
+}
+export interface OnlineEvaluatorCreateParams {
+    code_evaluator?: CreateOnlineCodeEvaluatorRequest;
+    llm_evaluator?: CreateOnlineLlmEvaluatorRequest;
+    name?: string;
+    type?: OnlineEvaluatorType;
+}
+export interface OnlineEvaluatorUpdateParams {
+    code_evaluator?: UpdateOnlineCodeEvaluatorRequest;
+    llm_evaluator?: UpdateOnlineLlmEvaluatorRequest;
+    name?: string;
+}
+export interface OnlineEvaluatorListParams extends OffsetPaginationOnlineEvaluatorsParams {
+    /**
+     * Filter by feedback key
+     */
+    feedback_key?: string;
+    /**
+     * Filter by name substring (also searches creator names)
+     */
+    name_contains?: string;
+    /**
+     * Filter by resource IDs
+     */
+    resource_id?: Array<string>;
+    /**
+     * Field to sort by
+     */
+    sort_by?: string;
+    /**
+     * Sort in descending order
+     */
+    sort_by_desc?: boolean;
+    /**
+     * Filter by tag value IDs
+     */
+    tag_value_id?: Array<string>;
+    /**
+     * Filter by evaluator type
+     */
+    type?: string;
+}
+export interface OnlineEvaluatorDeleteParams {
+    /**
+     * When true, delete all run rules for this evaluator before deleting the evaluator
+     */
+    delete_run_rules?: boolean;
+}
+export interface OnlineEvaluatorBulkDeleteParams {
+    /**
+     * Evaluator IDs to delete
+     */
+    evaluator_ids: Array<string>;
+    /**
+     * When true, delete all run rules for this evaluator before deleting the evaluator
+     */
+    delete_run_rules?: boolean;
+}
+export interface OnlineEvaluatorSpendParams {
+    /**
+     * Start of the 7-day window (YYYY-MM-DD).
+     */
+    period_start: string;
+    /**
+     * Filter to a specific dataset (UUID). Mutually exclusive with group_by.
+     */
+    dataset_id?: string;
+    /**
+     * Filter to a specific evaluator (UUID). Mutually exclusive with group_by.
+     */
+    evaluator_id?: string;
+    /**
+     * Filter grouped results by evaluator feedback key. Only valid with group_by.
+     */
+    feedback_key?: string;
+    /**
+     * Aggregation mode: 'evaluator', 'resource', or 'run_rule'. Mutually exclusive
+     * with entity filters.
+     */
+    group_by?: string;
+    /**
+     * Filter grouped results to evaluators attached to all supplied project or dataset
+     * IDs. Only valid with group_by.
+     */
+    resource_id?: Array<string>;
+    /**
+     * Filter to a specific project (UUID). Mutually exclusive with group_by.
+     */
+    session_id?: string;
+    /**
+     * Filter grouped results by evaluator type: 'llm' or 'code'. Only valid with
+     * group_by.
+     */
+    type?: string;
+}
+export declare namespace OnlineEvaluators {
+    export { type BulkDeleteEvaluatorFailedItem as BulkDeleteEvaluatorFailedItem, type BulkDeleteEvaluatorsResponse as BulkDeleteEvaluatorsResponse, type CreateOnlineCodeEvaluatorRequest as CreateOnlineCodeEvaluatorRequest, type CreateOnlineEvaluatorRequest as CreateOnlineEvaluatorRequest, type CreateOnlineEvaluatorResponse as CreateOnlineEvaluatorResponse, type CreateOnlineLlmEvaluatorRequest as CreateOnlineLlmEvaluatorRequest, type GetOnlineEvaluatorSpendResponse as GetOnlineEvaluatorSpendResponse, type OnlineCodeEvaluator as OnlineCodeEvaluator, type OnlineEvaluator as OnlineEvaluator, type OnlineEvaluatorRunRule as OnlineEvaluatorRunRule, type OnlineEvaluatorSpendDay as OnlineEvaluatorSpendDay, type OnlineEvaluatorSpendGroup as OnlineEvaluatorSpendGroup, type OnlineEvaluatorType as OnlineEvaluatorType, type OnlineLlmEvaluator as OnlineLlmEvaluator, type OnlineSpendLimit as OnlineSpendLimit, type UpdateOnlineCodeEvaluatorRequest as UpdateOnlineCodeEvaluatorRequest, type UpdateOnlineEvaluatorRequest as UpdateOnlineEvaluatorRequest, type UpdateOnlineEvaluatorResponse as UpdateOnlineEvaluatorResponse, type UpdateOnlineLlmEvaluatorRequest as UpdateOnlineLlmEvaluatorRequest, type OnlineEvaluatorsOffsetPaginationOnlineEvaluators as OnlineEvaluatorsOffsetPaginationOnlineEvaluators, type OnlineEvaluatorCreateParams as OnlineEvaluatorCreateParams, type OnlineEvaluatorUpdateParams as OnlineEvaluatorUpdateParams, type OnlineEvaluatorListParams as OnlineEvaluatorListParams, type OnlineEvaluatorDeleteParams as OnlineEvaluatorDeleteParams, type OnlineEvaluatorBulkDeleteParams as OnlineEvaluatorBulkDeleteParams, type OnlineEvaluatorSpendParams as OnlineEvaluatorSpendParams, };
+}

package/dist/_openapi_client/resources/online-evaluators.js

@@ -0,0 +1,66 @@
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../core/resource.js';
+import { OffsetPaginationOnlineEvaluators, } from '../core/pagination.js';
+import { buildHeaders } from '../internal/headers.js';
+import { path } from '../internal/utils/path.js';
+export class OnlineEvaluators extends APIResource {
+    /**
+     * Create a new LLM or code evaluator for the current workspace.
+     */
+    create(body, options) {
+        return this._client.post('/v1/platform/evaluators', { body, ...options });
+    }
+    /**
+     * Retrieve a single evaluator by its ID.
+     */
+    retrieve(evaluatorID, options) {
+        return this._client.get(path `/v1/platform/evaluators/${evaluatorID}`, options);
+    }
+    /**
+     * Update an existing evaluator's name, LLM configuration, or code configuration.
+     */
+    update(evaluatorID, body, options) {
+        return this._client.patch(path `/v1/platform/evaluators/${evaluatorID}`, { body, ...options });
+    }
+    /**
+     * List evaluators for the current workspace, with optional filtering by type,
+     * name, tag, feedback key, or resource ID.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/platform/evaluators', (OffsetPaginationOnlineEvaluators), { query, ...options });
+    }
+    /**
+     * Delete an evaluator. When delete_run_rules is true, all run rules referencing
+     * this evaluator are deleted first (same tenant). Associated llm_evaluators and
+     * code_evaluators rows are removed by foreign-key cascade when the evaluator row
+     * is deleted.
+     */
+    delete(evaluatorID, params = {}, options) {
+        const { delete_run_rules } = params ?? {};
+        return this._client.delete(path `/v1/platform/evaluators/${evaluatorID}`, {
+            query: { delete_run_rules },
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Delete multiple evaluators by their IDs. Returns per-item success/failure.
+     */
+    bulkDelete(params, options) {
+        const { evaluator_ids, delete_run_rules } = params;
+        return this._client.delete('/v1/platform/evaluators', {
+            query: { evaluator_ids, delete_run_rules },
+            ...options,
+        });
+    }
+    /**
+     * Returns per-day LLM evaluator spend for the requested 7-day period, grouped by
+     * evaluator, resource, or run rule. Exactly one of group_by, evaluator_id,
+     * session_id, or dataset_id is required. resource_id, type, and feedback_key may
+     * be supplied with group_by to narrow listing aggregations.
+     */
+    spend(query, options) {
+        return this._client.get('/v1/platform/evaluators/spend', { query, ...options });
+    }
+}

package/dist/_openapi_client/resources/public/datasets.cjs

@@ -0,0 +1,47 @@
+"use strict";
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Datasets = void 0;
+const resource_js_1 = require("../../core/resource.cjs");
+const pagination_js_1 = require("../../core/pagination.cjs");
+const headers_js_1 = require("../../internal/headers.cjs");
+const path_js_1 = require("../../internal/utils/path.cjs");
+class Datasets extends resource_js_1.APIResource {
+    /**
+     * Get dataset by ids or the shared dataset if not specifed.
+     */
+    list(shareToken, query = {}, options) {
+        return this._client.get((0, path_js_1.path) `/api/v1/public/${shareToken}/datasets`, { query, ...options });
+    }
+    /**
+     * Get all comparative experiments for a given dataset.
+     */
+    listComparative(shareToken, query = {}, options) {
+        return this._client.getAPIList((0, path_js_1.path) `/api/v1/public/${shareToken}/datasets/comparative`, (pagination_js_1.OffsetPaginationTopLevelArray), { query, ...options });
+    }
+    /**
+     * Get feedback for runs in projects run over a dataset that has been shared.
+     */
+    listFeedback(shareToken, query = {}, options) {
+        return this._client.getAPIList((0, path_js_1.path) `/api/v1/public/${shareToken}/datasets/feedback`, (pagination_js_1.OffsetPaginationTopLevelArray), { query, ...options });
+    }
+    /**
+     * Get projects run on a dataset that has been shared.
+     */
+    listSessions(shareToken, params = {}, options) {
+        const { accept, ...query } = params ?? {};
+        return this._client.getAPIList((0, path_js_1.path) `/api/v1/public/${shareToken}/datasets/sessions`, (pagination_js_1.OffsetPaginationTopLevelArray), {
+            query,
+            ...options,
+            headers: (0, headers_js_1.buildHeaders)([{ ...(accept != null ? { accept: accept } : undefined) }, options?.headers]),
+        });
+    }
+    /**
+     * Get sessions from multiple datasets using share tokens.
+     */
+    retrieveSessionsBulk(query, options) {
+        return this._client.get('/api/v1/public/datasets/sessions-bulk', { query, ...options });
+    }
+}
+exports.Datasets = Datasets;

package/dist/_openapi_client/resources/public/datasets.d.ts

@@ -0,0 +1,152 @@
+import { APIResource } from '../../core/resource.js';
+import * as ComparativeAPI from '../datasets/comparative.js';
+import * as DatasetsAPI from '../datasets/datasets.js';
+import * as FeedbackAPI from '../feedback/feedback.js';
+import { FeedbackSchemasOffsetPaginationTopLevelArray } from '../feedback/feedback.js';
+import * as SessionsAPI from '../sessions/sessions.js';
+import { TracerSessionsOffsetPaginationTopLevelArray } from '../sessions/sessions.js';
+import { APIPromise } from '../../core/api-promise.js';
+import { OffsetPaginationTopLevelArray, type OffsetPaginationTopLevelArrayParams, PagePromise } from '../../core/pagination.js';
+import { RequestOptions } from '../../internal/request-options.js';
+export declare class Datasets extends APIResource {
+    /**
+     * Get dataset by ids or the shared dataset if not specifed.
+     */
+    list(shareToken: string, query?: DatasetListParams | null | undefined, options?: RequestOptions): APIPromise<DatasetListResponse>;
+    /**
+     * Get all comparative experiments for a given dataset.
+     */
+    listComparative(shareToken: string, query?: DatasetListComparativeParams | null | undefined, options?: RequestOptions): PagePromise<DatasetListComparativeResponsesOffsetPaginationTopLevelArray, DatasetListComparativeResponse>;
+    /**
+     * Get feedback for runs in projects run over a dataset that has been shared.
+     */
+    listFeedback(shareToken: string, query?: DatasetListFeedbackParams | null | undefined, options?: RequestOptions): PagePromise<FeedbackSchemasOffsetPaginationTopLevelArray, FeedbackAPI.FeedbackSchema>;
+    /**
+     * Get projects run on a dataset that has been shared.
+     */
+    listSessions(shareToken: string, params?: DatasetListSessionsParams | null | undefined, options?: RequestOptions): PagePromise<TracerSessionsOffsetPaginationTopLevelArray, SessionsAPI.TracerSession>;
+    /**
+     * Get sessions from multiple datasets using share tokens.
+     */
+    retrieveSessionsBulk(query: DatasetRetrieveSessionsBulkParams, options?: RequestOptions): APIPromise<DatasetRetrieveSessionsBulkResponse>;
+}
+export type DatasetListComparativeResponsesOffsetPaginationTopLevelArray = OffsetPaginationTopLevelArray<DatasetListComparativeResponse>;
+/**
+ * Public schema for datasets.
+ *
+ * Doesn't currently include session counts/stats since public test project sharing
+ * is not yet shipped
+ */
+export interface DatasetListResponse {
+    id: string;
+    example_count: number;
+    name: string;
+    created_at?: string;
+    /**
+     * Enum for dataset data types.
+     */
+    data_type?: DatasetsAPI.DataType | null;
+    description?: string | null;
+    externally_managed?: boolean | null;
+    inputs_schema_definition?: {
+        [key: string]: unknown;
+    } | null;
+    outputs_schema_definition?: {
+        [key: string]: unknown;
+    } | null;
+    transformations?: Array<DatasetsAPI.DatasetTransformation> | null;
+}
+/**
+ * Publicly-shared ComparativeExperiment schema.
+ */
+export interface DatasetListComparativeResponse {
+    id: string;
+    created_at: string;
+    experiments_info: Array<ComparativeAPI.SimpleExperimentInfo>;
+    modified_at: string;
+    description?: string | null;
+    extra?: {
+        [key: string]: unknown;
+    } | null;
+    feedback_stats?: {
+        [key: string]: unknown;
+    } | null;
+    name?: string | null;
+}
+export type DatasetRetrieveSessionsBulkResponse = Array<SessionsAPI.TracerSession>;
+export interface DatasetListParams {
+    limit?: number;
+    offset?: number;
+    /**
+     * Enum for available dataset columns to sort by.
+     */
+    sort_by?: DatasetsAPI.SortByDatasetColumn;
+    sort_by_desc?: boolean;
+}
+export interface DatasetListComparativeParams extends OffsetPaginationTopLevelArrayParams {
+    name?: string | null;
+    name_contains?: string | null;
+    /**
+     * Enum for available comparative experiment columns to sort by.
+     */
+    sort_by?: ComparativeAPI.SortByComparativeExperimentColumn;
+    sort_by_desc?: boolean;
+}
+export interface DatasetListFeedbackParams extends OffsetPaginationTopLevelArrayParams {
+    has_comment?: boolean | null;
+    has_score?: boolean | null;
+    key?: Array<string> | null;
+    /**
+     * Enum for feedback levels.
+     */
+    level?: FeedbackAPI.FeedbackLevel | null;
+    run?: Array<string> | null;
+    session?: Array<string> | null;
+    source?: Array<FeedbackAPI.SourceType> | null;
+    user?: Array<string> | null;
+}
+export interface DatasetListSessionsParams extends OffsetPaginationTopLevelArrayParams {
+    /**
+     * Query param
+     */
+    id?: Array<string> | null;
+    /**
+     * Query param
+     */
+    dataset_version?: string | null;
+    /**
+     * Query param
+     */
+    facets?: boolean;
+    /**
+     * Query param
+     */
+    name?: string | null;
+    /**
+     * Query param
+     */
+    name_contains?: string | null;
+    /**
+     * Query param
+     */
+    sort_by?: SessionsAPI.SessionSortableColumns;
+    /**
+     * Query param
+     */
+    sort_by_desc?: boolean;
+    /**
+     * Query param
+     */
+    sort_by_feedback_key?: string | null;
+    /**
+     * Header param
+     */
+    accept?: string;
+}
+export interface DatasetRetrieveSessionsBulkParams {
+    share_tokens: Array<string>;
+}
+export declare namespace Datasets {
+    export { type DatasetListResponse as DatasetListResponse, type DatasetListComparativeResponse as DatasetListComparativeResponse, type DatasetRetrieveSessionsBulkResponse as DatasetRetrieveSessionsBulkResponse, type DatasetListComparativeResponsesOffsetPaginationTopLevelArray as DatasetListComparativeResponsesOffsetPaginationTopLevelArray, type DatasetListParams as DatasetListParams, type DatasetListComparativeParams as DatasetListComparativeParams, type DatasetListFeedbackParams as DatasetListFeedbackParams, type DatasetListSessionsParams as DatasetListSessionsParams, type DatasetRetrieveSessionsBulkParams as DatasetRetrieveSessionsBulkParams, };
+}
+export { type FeedbackSchemasOffsetPaginationTopLevelArray, type TracerSessionsOffsetPaginationTopLevelArray, };

package/dist/_openapi_client/resources/public/datasets.js

@@ -0,0 +1,43 @@
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../core/resource.js';
+import { OffsetPaginationTopLevelArray, } from '../../core/pagination.js';
+import { buildHeaders } from '../../internal/headers.js';
+import { path } from '../../internal/utils/path.js';
+export class Datasets extends APIResource {
+    /**
+     * Get dataset by ids or the shared dataset if not specifed.
+     */
+    list(shareToken, query = {}, options) {
+        return this._client.get(path `/api/v1/public/${shareToken}/datasets`, { query, ...options });
+    }
+    /**
+     * Get all comparative experiments for a given dataset.
+     */
+    listComparative(shareToken, query = {}, options) {
+        return this._client.getAPIList(path `/api/v1/public/${shareToken}/datasets/comparative`, (OffsetPaginationTopLevelArray), { query, ...options });
+    }
+    /**
+     * Get feedback for runs in projects run over a dataset that has been shared.
+     */
+    listFeedback(shareToken, query = {}, options) {
+        return this._client.getAPIList(path `/api/v1/public/${shareToken}/datasets/feedback`, (OffsetPaginationTopLevelArray), { query, ...options });
+    }
+    /**
+     * Get projects run on a dataset that has been shared.
+     */
+    listSessions(shareToken, params = {}, options) {
+        const { accept, ...query } = params ?? {};
+        return this._client.getAPIList(path `/api/v1/public/${shareToken}/datasets/sessions`, (OffsetPaginationTopLevelArray), {
+            query,
+            ...options,
+            headers: buildHeaders([{ ...(accept != null ? { accept: accept } : undefined) }, options?.headers]),
+        });
+    }
+    /**
+     * Get sessions from multiple datasets using share tokens.
+     */
+    retrieveSessionsBulk(query, options) {
+        return this._client.get('/api/v1/public/datasets/sessions-bulk', { query, ...options });
+    }
+}

package/dist/_openapi_client/resources/public/public.cjs

@@ -0,0 +1,62 @@
+"use strict";
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Public = void 0;
+const resource_js_1 = require("../../core/resource.cjs");
+const DatasetsAPI = __importStar(require("./datasets.cjs"));
+const datasets_js_1 = require("./datasets.cjs");
+const pagination_js_1 = require("../../core/pagination.cjs");
+const path_js_1 = require("../../internal/utils/path.cjs");
+class Public extends resource_js_1.APIResource {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "datasets", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new DatasetsAPI.Datasets(this._client)
+        });
+    }
+    /**
+     * Read Shared Feedbacks
+     */
+    retrieveFeedbacks(shareToken, query = {}, options) {
+        return this._client.getAPIList((0, path_js_1.path) `/api/v1/public/${shareToken}/feedbacks`, (pagination_js_1.OffsetPaginationTopLevelArray), { query, ...options });
+    }
+}
+exports.Public = Public;
+Public.Datasets = datasets_js_1.Datasets;