langsmith 0.7.7 → 0.7.9

package/dist/_openapi_client/resources/commits.cjs

@@ -0,0 +1,44 @@
+"use strict";
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Commits = void 0;
+const resource_js_1 = require("../core/resource.cjs");
+const pagination_js_1 = require("../core/pagination.cjs");
+const path_js_1 = require("../internal/utils/path.cjs");
+class Commits extends resource_js_1.APIResource {
+    /**
+     * Creates a new commit in a repository. Requires authentication and write access
+     * to the repository.
+     */
+    create(repo, params, options) {
+        const { owner, ...body } = params;
+        return this._client.post((0, path_js_1.path) `/commits/${owner}/${repo}`, { body, ...options });
+    }
+    /**
+     * Retrieves a specific commit by hash, tag, or "latest" for a repository. This
+     * endpoint supports both authenticated and unauthenticated access. Authenticated
+     * users can access private repos, while unauthenticated users can only access
+     * public repos. Commit resolution logic:
+     *
+     * - "latest" or empty: Get the most recent commit
+     * - Less than 8 characters: Only check for tags
+     * - 8 or more characters: Prioritize commit hash over tag, check both
+     */
+    retrieve(commit, params, options) {
+        const { owner, repo, ...query } = params;
+        return this._client.get((0, path_js_1.path) `/commits/${owner}/${repo}/${commit}`, { query, ...options });
+    }
+    /**
+     * Lists all commits for a repository with pagination support. This endpoint
+     * supports both authenticated and unauthenticated access. Authenticated users can
+     * access private repos, while unauthenticated users can only access public repos.
+     * The include_stats parameter controls whether download and view statistics are
+     * computed (defaults to true).
+     */
+    list(repo, params, options) {
+        const { owner, ...query } = params;
+        return this._client.getAPIList((0, path_js_1.path) `/commits/${owner}/${repo}`, (pagination_js_1.OffsetPaginationCommits), { query, ...options });
+    }
+}
+exports.Commits = Commits;

package/dist/_openapi_client/resources/commits.d.ts

@@ -0,0 +1,204 @@
+import { APIResource } from '../core/resource.js';
+import { APIPromise } from '../core/api-promise.js';
+import { OffsetPaginationCommits, type OffsetPaginationCommitsParams, PagePromise } from '../core/pagination.js';
+import { RequestOptions } from '../internal/request-options.js';
+export declare class Commits extends APIResource {
+    /**
+     * Creates a new commit in a repository. Requires authentication and write access
+     * to the repository.
+     */
+    create(repo: string, params: CommitCreateParams, options?: RequestOptions): APIPromise<CommitCreateResponse>;
+    /**
+     * Retrieves a specific commit by hash, tag, or "latest" for a repository. This
+     * endpoint supports both authenticated and unauthenticated access. Authenticated
+     * users can access private repos, while unauthenticated users can only access
+     * public repos. Commit resolution logic:
+     *
+     * - "latest" or empty: Get the most recent commit
+     * - Less than 8 characters: Only check for tags
+     * - 8 or more characters: Prioritize commit hash over tag, check both
+     */
+    retrieve(commit: string, params: CommitRetrieveParams, options?: RequestOptions): APIPromise<CommitRetrieveResponse>;
+    /**
+     * Lists all commits for a repository with pagination support. This endpoint
+     * supports both authenticated and unauthenticated access. Authenticated users can
+     * access private repos, while unauthenticated users can only access public repos.
+     * The include_stats parameter controls whether download and view statistics are
+     * computed (defaults to true).
+     */
+    list(repo: string, params: CommitListParams, options?: RequestOptions): PagePromise<CommitWithLookupsOffsetPaginationCommits, CommitWithLookups>;
+}
+export type CommitWithLookupsOffsetPaginationCommits = OffsetPaginationCommits<CommitWithLookups>;
+/**
+ * Response model for get_commit_manifest.
+ */
+export interface CommitManifestResponse {
+    commit_hash: string;
+    manifest: {
+        [key: string]: unknown;
+    };
+    examples?: Array<CommitManifestResponse.Example> | null;
+}
+export declare namespace CommitManifestResponse {
+    /**
+     * Response model for example runs
+     */
+    interface Example {
+        id: string;
+        session_id: string;
+        inputs?: {
+            [key: string]: unknown;
+        } | null;
+        outputs?: {
+            [key: string]: unknown;
+        } | null;
+        start_time?: string | null;
+    }
+}
+export interface CommitWithLookups {
+    /**
+     * The commit ID
+     */
+    id?: string;
+    /**
+     * The hash of the commit
+     */
+    commit_hash?: string;
+    /**
+     * When the commit was created
+     */
+    created_at?: string;
+    /**
+     * Optional human-readable description for the commit
+     */
+    description?: string;
+    /**
+     * Example run IDs associated with the commit
+     */
+    example_run_ids?: Array<string>;
+    /**
+     * Author's full name
+     */
+    full_name?: string;
+    /**
+     * The manifest of the commit
+     */
+    manifest?: unknown;
+    /**
+     * The SHA of the manifest
+     */
+    manifest_sha?: Array<number>;
+    /**
+     * Number of API downloads
+     */
+    num_downloads?: number;
+    /**
+     * Number of web views
+     */
+    num_views?: number;
+    /**
+     * The hash of the parent commit
+     */
+    parent_commit_hash?: string;
+    /**
+     * The ID of the parent commit
+     */
+    parent_id?: string;
+    /**
+     * Repository ID
+     */
+    repo_id?: string;
+    /**
+     * When the commit was last updated
+     */
+    updated_at?: string;
+}
+export interface CommitCreateResponse {
+    commit?: CommitWithLookups;
+}
+export interface CommitRetrieveResponse {
+    commit_hash?: string;
+    description?: string;
+    examples?: Array<CommitRetrieveResponse.Example>;
+    is_draft?: boolean;
+    manifest?: unknown;
+    model_config?: unknown;
+    model_provider?: string;
+}
+export declare namespace CommitRetrieveResponse {
+    interface Example {
+        id?: string;
+        inputs?: unknown;
+        outputs?: unknown;
+        session_id?: string;
+        start_time?: string;
+    }
+}
+export interface CommitCreateParams {
+    /**
+     * Path param: Repository owner (tenant handle) or '-' for private repos
+     */
+    owner: string;
+    /**
+     * Body param
+     */
+    description?: string;
+    /**
+     * Body param
+     */
+    manifest?: unknown;
+    /**
+     * Body param
+     */
+    parent_commit?: string;
+    /**
+     * Body param: SkipWebhooks allows skipping webhook notifications. Can be true
+     * (boolean) to skip all, or an array of webhook UUIDs to skip specific ones.
+     */
+    skip_webhooks?: unknown;
+}
+export interface CommitRetrieveParams {
+    /**
+     * Path param: Repository owner (tenant handle) or '-' for private repos
+     */
+    owner: string;
+    /**
+     * Path param: Repository handle
+     */
+    repo: string;
+    /**
+     * Query param
+     */
+    get_examples?: boolean;
+    /**
+     * Query param: Comma-separated list of optional fields: "model", "is_draft"
+     */
+    include?: string;
+    /**
+     * Query param: Deprecated: use Include instead
+     */
+    include_model?: boolean;
+    /**
+     * Query param
+     */
+    is_view?: boolean;
+}
+export interface CommitListParams extends OffsetPaginationCommitsParams {
+    /**
+     * Path param: Repository owner (tenant handle) or '-' for private repos
+     */
+    owner: string;
+    /**
+     * Query param: IncludeStats determines whether to compute num_downloads and
+     * num_views
+     */
+    include_stats?: boolean;
+    /**
+     * Query param: Tag filters commits to only those with a specific tag (e.g.
+     * "production", "staging")
+     */
+    tag?: string;
+}
+export declare namespace Commits {
+    export { type CommitManifestResponse as CommitManifestResponse, type CommitWithLookups as CommitWithLookups, type CommitCreateResponse as CommitCreateResponse, type CommitRetrieveResponse as CommitRetrieveResponse, type CommitWithLookupsOffsetPaginationCommits as CommitWithLookupsOffsetPaginationCommits, type CommitCreateParams as CommitCreateParams, type CommitRetrieveParams as CommitRetrieveParams, type CommitListParams as CommitListParams, };
+}

package/dist/_openapi_client/resources/commits.js

@@ -0,0 +1,40 @@
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../core/resource.js';
+import { OffsetPaginationCommits } from '../core/pagination.js';
+import { path } from '../internal/utils/path.js';
+export class Commits extends APIResource {
+    /**
+     * Creates a new commit in a repository. Requires authentication and write access
+     * to the repository.
+     */
+    create(repo, params, options) {
+        const { owner, ...body } = params;
+        return this._client.post(path `/commits/${owner}/${repo}`, { body, ...options });
+    }
+    /**
+     * Retrieves a specific commit by hash, tag, or "latest" for a repository. This
+     * endpoint supports both authenticated and unauthenticated access. Authenticated
+     * users can access private repos, while unauthenticated users can only access
+     * public repos. Commit resolution logic:
+     *
+     * - "latest" or empty: Get the most recent commit
+     * - Less than 8 characters: Only check for tags
+     * - 8 or more characters: Prioritize commit hash over tag, check both
+     */
+    retrieve(commit, params, options) {
+        const { owner, repo, ...query } = params;
+        return this._client.get(path `/commits/${owner}/${repo}/${commit}`, { query, ...options });
+    }
+    /**
+     * Lists all commits for a repository with pagination support. This endpoint
+     * supports both authenticated and unauthenticated access. Authenticated users can
+     * access private repos, while unauthenticated users can only access public repos.
+     * The include_stats parameter controls whether download and view statistics are
+     * computed (defaults to true).
+     */
+    list(repo, params, options) {
+        const { owner, ...query } = params;
+        return this._client.getAPIList(path `/commits/${owner}/${repo}`, (OffsetPaginationCommits), { query, ...options });
+    }
+}

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

@@ -0,0 +1,22 @@
+"use strict";
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Comparative = void 0;
+const resource_js_1 = require("../../core/resource.cjs");
+const path_js_1 = require("../../internal/utils/path.cjs");
+class Comparative extends resource_js_1.APIResource {
+    /**
+     * Create a comparative experiment.
+     */
+    create(body, options) {
+        return this._client.post('/api/v1/datasets/comparative', { body, ...options });
+    }
+    /**
+     * Delete a specific comparative experiment.
+     */
+    delete(comparativeExperimentID, options) {
+        return this._client.delete((0, path_js_1.path) `/api/v1/datasets/comparative/${comparativeExperimentID}`, options);
+    }
+}
+exports.Comparative = Comparative;

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

@@ -0,0 +1,55 @@
+import { APIResource } from '../../core/resource.js';
+import { APIPromise } from '../../core/api-promise.js';
+import { RequestOptions } from '../../internal/request-options.js';
+export declare class Comparative extends APIResource {
+    /**
+     * Create a comparative experiment.
+     */
+    create(body: ComparativeCreateParams, options?: RequestOptions): APIPromise<ComparativeCreateResponse>;
+    /**
+     * Delete a specific comparative experiment.
+     */
+    delete(comparativeExperimentID: string, options?: RequestOptions): APIPromise<unknown>;
+}
+/**
+ * Simple experiment info schema for use with comparative experiments
+ */
+export interface SimpleExperimentInfo {
+    id: string;
+    name: string;
+}
+/**
+ * Enum for available comparative experiment columns to sort by.
+ */
+export type SortByComparativeExperimentColumn = 'name' | 'created_at';
+/**
+ * ComparativeExperiment schema.
+ */
+export interface ComparativeCreateResponse {
+    id: string;
+    created_at: string;
+    modified_at: string;
+    reference_dataset_id: string;
+    tenant_id: string;
+    description?: string | null;
+    extra?: {
+        [key: string]: unknown;
+    } | null;
+    name?: string | null;
+}
+export type ComparativeDeleteResponse = unknown;
+export interface ComparativeCreateParams {
+    experiment_ids: Array<string>;
+    id?: string;
+    created_at?: string;
+    description?: string | null;
+    extra?: {
+        [key: string]: unknown;
+    } | null;
+    modified_at?: string;
+    name?: string | null;
+    reference_dataset_id?: string | null;
+}
+export declare namespace Comparative {
+    export { type SimpleExperimentInfo as SimpleExperimentInfo, type SortByComparativeExperimentColumn as SortByComparativeExperimentColumn, type ComparativeCreateResponse as ComparativeCreateResponse, type ComparativeDeleteResponse as ComparativeDeleteResponse, type ComparativeCreateParams as ComparativeCreateParams, };
+}

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

@@ -0,0 +1,18 @@
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../core/resource.js';
+import { path } from '../../internal/utils/path.js';
+export class Comparative extends APIResource {
+    /**
+     * Create a comparative experiment.
+     */
+    create(body, options) {
+        return this._client.post('/api/v1/datasets/comparative', { body, ...options });
+    }
+    /**
+     * Delete a specific comparative experiment.
+     */
+    delete(comparativeExperimentID, options) {
+        return this._client.delete(path `/api/v1/datasets/comparative/${comparativeExperimentID}`, options);
+    }
+}

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

@@ -0,0 +1,193 @@
+"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.Datasets = void 0;
+const resource_js_1 = require("../../core/resource.cjs");
+const ComparativeAPI = __importStar(require("./comparative.cjs"));
+const comparative_js_1 = require("./comparative.cjs");
+const ExperimentsAPI = __importStar(require("./experiments.cjs"));
+const experiments_js_1 = require("./experiments.cjs");
+const GroupAPI = __importStar(require("./group.cjs"));
+const group_js_1 = require("./group.cjs");
+const RunsAPI = __importStar(require("./runs.cjs"));
+const runs_js_1 = require("./runs.cjs");
+const ShareAPI = __importStar(require("./share.cjs"));
+const share_js_1 = require("./share.cjs");
+const SplitsAPI = __importStar(require("./splits.cjs"));
+const splits_js_1 = require("./splits.cjs");
+const VersionsAPI = __importStar(require("./versions.cjs"));
+const versions_js_1 = require("./versions.cjs");
+const pagination_js_1 = require("../../core/pagination.cjs");
+const uploads_js_1 = require("../../internal/uploads.cjs");
+const path_js_1 = require("../../internal/utils/path.cjs");
+class Datasets extends resource_js_1.APIResource {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "versions", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new VersionsAPI.Versions(this._client)
+        });
+        Object.defineProperty(this, "runs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new RunsAPI.Runs(this._client)
+        });
+        Object.defineProperty(this, "group", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new GroupAPI.Group(this._client)
+        });
+        Object.defineProperty(this, "experiments", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new ExperimentsAPI.Experiments(this._client)
+        });
+        Object.defineProperty(this, "share", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new ShareAPI.Share(this._client)
+        });
+        Object.defineProperty(this, "comparative", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new ComparativeAPI.Comparative(this._client)
+        });
+        Object.defineProperty(this, "splits", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new SplitsAPI.Splits(this._client)
+        });
+    }
+    /**
+     * Create a new dataset.
+     */
+    create(body, options) {
+        return this._client.post('/api/v1/datasets', { body, ...options });
+    }
+    /**
+     * Get a specific dataset.
+     */
+    retrieve(datasetID, options) {
+        return this._client.get((0, path_js_1.path) `/api/v1/datasets/${datasetID}`, options);
+    }
+    /**
+     * Update a specific dataset.
+     */
+    update(datasetID, body, options) {
+        return this._client.patch((0, path_js_1.path) `/api/v1/datasets/${datasetID}`, { body, ...options });
+    }
+    /**
+     * Get all datasets by query params and owner.
+     */
+    list(params = {}, options) {
+        const { datatype, ...query } = params ?? {};
+        return this._client.getAPIList('/api/v1/datasets', (pagination_js_1.OffsetPaginationTopLevelArray), {
+            query: { data_type: datatype, ...query },
+            ...options,
+        });
+    }
+    /**
+     * Delete a specific dataset.
+     */
+    delete(datasetID, options) {
+        return this._client.delete((0, path_js_1.path) `/api/v1/datasets/${datasetID}`, options);
+    }
+    /**
+     * Clone a dataset.
+     */
+    clone(body, options) {
+        return this._client.post('/api/v1/datasets/clone', { body, ...options });
+    }
+    /**
+     * Download a dataset as CSV format.
+     */
+    retrieveCsv(datasetID, query = {}, options) {
+        return this._client.get((0, path_js_1.path) `/api/v1/datasets/${datasetID}/csv`, { query, ...options });
+    }
+    /**
+     * Download a dataset as CSV format.
+     */
+    retrieveJSONL(datasetID, query = {}, options) {
+        return this._client.get((0, path_js_1.path) `/api/v1/datasets/${datasetID}/jsonl`, { query, ...options });
+    }
+    /**
+     * Download a dataset as OpenAI Evals Jsonl format.
+     */
+    retrieveOpenAI(datasetID, query = {}, options) {
+        return this._client.get((0, path_js_1.path) `/api/v1/datasets/${datasetID}/openai`, { query, ...options });
+    }
+    /**
+     * Download a dataset as OpenAI Jsonl format.
+     */
+    retrieveOpenAIFt(datasetID, query = {}, options) {
+        return this._client.get((0, path_js_1.path) `/api/v1/datasets/${datasetID}/openai_ft`, { query, ...options });
+    }
+    /**
+     * Get dataset version by as_of or exact tag.
+     */
+    retrieveVersion(datasetID, query = {}, options) {
+        return this._client.get((0, path_js_1.path) `/api/v1/datasets/${datasetID}/version`, { query, ...options });
+    }
+    /**
+     * Set a tag on a dataset version.
+     */
+    updateTags(datasetID, body, options) {
+        return this._client.put((0, path_js_1.path) `/api/v1/datasets/${datasetID}/tags`, { body, ...options });
+    }
+    /**
+     * Create a new dataset from a CSV or JSONL file.
+     */
+    upload(body, options) {
+        return this._client.post('/api/v1/datasets/upload', (0, uploads_js_1.multipartFormRequestOptions)({ body, ...options }, this._client));
+    }
+}
+exports.Datasets = Datasets;
+Datasets.Versions = versions_js_1.Versions;
+Datasets.Runs = runs_js_1.Runs;
+Datasets.Group = group_js_1.Group;
+Datasets.Experiments = experiments_js_1.Experiments;
+Datasets.Share = share_js_1.Share;
+Datasets.Comparative = comparative_js_1.Comparative;
+Datasets.Splits = splits_js_1.Splits;