langsmith 0.1.43 → 0.1.45

package/dist/client.js

@@ -6,6 +6,7 @@ import { __version__ } from "./index.js";
 import { assertUuid } from "./utils/_uuid.js";
 import { warnOnce } from "./utils/warn.js";
 import { isVersionGreaterOrEqual, parsePromptIdentifier, } from "./utils/prompts.js";
+import { raiseForStatus } from "./utils/error.js";
 async function mergeRuntimeEnvIntoRunCreates(runs) {
     const runtimeEnv = await getRuntimeEnvironment();
     const envVars = getLangChainEnvVarsMetadata();
@@ -46,14 +47,6 @@ const isLocalhost = (url) => {
     const hostname = strippedUrl.split("/")[0].split(":")[0];
     return (hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1");
 };
-const raiseForStatus = async (response, operation) => {
-    // consume the response body to release the connection
-    // https://undici.nodejs.org/#/?id=garbage-collection
-    const body = await response.text();
-    if (!response.ok) {
-        throw new Error(`Failed to ${operation}: ${response.status} ${response.statusText} ${body}`);
-    }
-};
 async function toArray(iterable) {
     const result = [];
     for await (const item of iterable) {
@@ -360,9 +353,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to fetch ${path}: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, `Failed to fetch ${path}`);
         return response;
     }
     async _get(path, queryParams) {
@@ -382,9 +373,7 @@ export class Client {
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
-            if (!response.ok) {
-                throw new Error(`Failed to fetch ${path}: ${response.status} ${response.statusText}`);
-            }
+            await raiseForStatus(response, `Failed to fetch ${path}`);
             const items = transform
                 ? transform(await response.json())
                 : await response.json();
@@ -501,12 +490,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            // consume the response body to release the connection
-            // https://undici.nodejs.org/#/?id=garbage-collection
-            await response.text();
-            throw new Error("Failed to retrieve server info.");
-        }
+        await raiseForStatus(response, "get server info");
         return response.json();
     }
     async batchEndpointIsSupported() {
@@ -555,7 +539,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        await raiseForStatus(response, "create run");
+        await raiseForStatus(response, "create run", true);
     }
     /**
      * Batch ingest/upsert multiple runs in the Langsmith system.
@@ -655,7 +639,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        await raiseForStatus(response, "batch create run");
+        await raiseForStatus(response, "batch create run", true);
     }
     async updateRun(runId, run) {
         assertUuid(runId);
@@ -692,7 +676,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        await raiseForStatus(response, "update run");
+        await raiseForStatus(response, "update run", true);
     }
     async readRun(runId, { loadChildRuns } = { loadChildRuns: false }) {
         assertUuid(runId);
@@ -985,7 +969,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        await raiseForStatus(response, "unshare run");
+        await raiseForStatus(response, "unshare run", true);
     }
     async readRunSharedLink(runId) {
         assertUuid(runId);
@@ -1070,7 +1054,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        await raiseForStatus(response, "unshare dataset");
+        await raiseForStatus(response, "unshare dataset", true);
     }
     async readSharedDataset(shareToken) {
         assertUuid(shareToken);
@@ -1083,6 +1067,46 @@ export class Client {
         const dataset = await response.json();
         return dataset;
     }
+    /**
+     * Get shared examples.
+     *
+     * @param {string} shareToken The share token to get examples for. A share token is the UUID (or LangSmith URL, including UUID) generated when explicitly marking an example as public.
+     * @param {Object} [options] Additional options for listing the examples.
+     * @param {string[] | undefined} [options.exampleIds] A list of example IDs to filter by.
+     * @returns {Promise<Example[]>} The shared examples.
+     */
+    async listSharedExamples(shareToken, options) {
+        const params = {};
+        if (options?.exampleIds) {
+            params.id = options.exampleIds;
+        }
+        const urlParams = new URLSearchParams();
+        Object.entries(params).forEach(([key, value]) => {
+            if (Array.isArray(value)) {
+                value.forEach((v) => urlParams.append(key, v));
+            }
+            else {
+                urlParams.append(key, value);
+            }
+        });
+        const response = await this.caller.call(fetch, `${this.apiUrl}/public/${shareToken}/examples?${urlParams.toString()}`, {
+            method: "GET",
+            headers: this.headers,
+            signal: AbortSignal.timeout(this.timeout_ms),
+            ...this.fetchOptions,
+        });
+        const result = await response.json();
+        if (!response.ok) {
+            if ("detail" in result) {
+                throw new Error(`Failed to list shared examples.\nStatus: ${response.status}\nMessage: ${result.detail.join("\n")}`);
+            }
+            throw new Error(`Failed to list shared examples: ${response.status} ${response.statusText}`);
+        }
+        return result.map((example) => ({
+            ...example,
+            _hostUrl: this.getHostUrl(),
+        }));
+    }
     async createProject({ projectName, description = null, metadata = null, upsert = false, projectExtra = null, referenceDatasetId = null, }) {
         const upsert_ = upsert ? `?upsert=true` : "";
         const endpoint = `${this.apiUrl}/sessions${upsert_}`;
@@ -1105,10 +1129,8 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
+        await raiseForStatus(response, "create project");
         const result = await response.json();
-        if (!response.ok) {
-            throw new Error(`Failed to create session ${projectName}: ${response.status} ${response.statusText}`);
-        }
         return result;
     }
     async updateProject(projectId, { name = null, description = null, metadata = null, projectExtra = null, endTime = null, }) {
@@ -1130,10 +1152,8 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
+        await raiseForStatus(response, "update project");
         const result = await response.json();
-        if (!response.ok) {
-            throw new Error(`Failed to update project ${projectId}: ${response.status} ${response.statusText}`);
-        }
         return result;
     }
     async hasProject({ projectId, projectName, }) {
@@ -1289,7 +1309,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        await raiseForStatus(response, `delete session ${projectId_} (${projectName})`);
+        await raiseForStatus(response, `delete session ${projectId_} (${projectName})`, true);
     }
     async uploadCsv({ csvFile, fileName, inputKeys, outputKeys, description, dataType, name, }) {
         const url = `${this.apiUrl}/datasets/upload`;
@@ -1317,20 +1337,15 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            const result = await response.json();
-            if (result.detail && result.detail.includes("already exists")) {
-                throw new Error(`Dataset ${fileName} already exists`);
-            }
-            throw new Error(`Failed to upload CSV: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, "upload CSV");
         const result = await response.json();
         return result;
     }
-    async createDataset(name, { description, dataType, inputsSchema, outputsSchema, } = {}) {
+    async createDataset(name, { description, dataType, inputsSchema, outputsSchema, metadata, } = {}) {
         const body = {
             name,
             description,
+            extra: metadata ? { metadata } : undefined,
         };
         if (dataType) {
             body.data_type = dataType;
@@ -1348,13 +1363,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            const result = await response.json();
-            if (result.detail && result.detail.includes("already exists")) {
-                throw new Error(`Dataset ${name} already exists`);
-            }
-            throw new Error(`Failed to create dataset ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, "create dataset");
         const result = await response.json();
         return result;
     }
@@ -1443,7 +1452,7 @@ export class Client {
             .map((line) => JSON.parse(line));
         return dataset;
     }
-    async *listDatasets({ limit = 100, offset = 0, datasetIds, datasetName, datasetNameContains, } = {}) {
+    async *listDatasets({ limit = 100, offset = 0, datasetIds, datasetName, datasetNameContains, metadata, } = {}) {
         const path = "/datasets";
         const params = new URLSearchParams({
             limit: limit.toString(),
@@ -1460,6 +1469,9 @@ export class Client {
         if (datasetNameContains !== undefined) {
             params.append("name_contains", datasetNameContains);
         }
+        if (metadata !== undefined) {
+            params.append("metadata", JSON.stringify(metadata));
+        }
         for await (const datasets of this._getPaginated(path, params)) {
             yield* datasets;
         }
@@ -1483,9 +1495,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to update dataset ${_datasetId}: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, "update dataset");
         return (await response.json());
     }
     async deleteDataset({ datasetId, datasetName, }) {
@@ -1511,9 +1521,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to delete ${path}: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, `delete ${path}`);
         await response.json();
     }
     async indexDataset({ datasetId, datasetName, tag, }) {
@@ -1539,9 +1547,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to index dataset ${datasetId_}: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, "index dataset");
         await response.json();
     }
     /**
@@ -1580,9 +1586,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to fetch similar examples: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, "fetch similar examples");
         const result = await response.json();
         return result["examples"];
     }
@@ -1615,9 +1619,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to create example: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, "create example");
         const result = await response.json();
         return result;
     }
@@ -1652,9 +1654,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to create examples: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, "create examples");
         const result = await response.json();
         return result;
     }
@@ -1747,9 +1747,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to delete ${path}: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, `delete ${path}`);
         await response.json();
     }
     async updateExample(exampleId, update) {
@@ -1761,9 +1759,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to update example ${exampleId}: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, "update example");
         const result = await response.json();
         return result;
     }
@@ -1775,9 +1771,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to update examples: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, "update examples");
         const result = await response.json();
         return result;
     }
@@ -1840,7 +1834,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        await raiseForStatus(response, "update dataset splits");
+        await raiseForStatus(response, "update dataset splits", true);
     }
     /**
      * @deprecated This method is deprecated and will be removed in future LangSmith versions, use `evaluate` from `langsmith/evaluation` instead.
@@ -1906,7 +1900,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        await raiseForStatus(response, "create feedback");
+        await raiseForStatus(response, "create feedback", true);
         return feedback;
     }
     async updateFeedback(feedbackId, { score, value, correction, comment, }) {
@@ -1931,7 +1925,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        await raiseForStatus(response, "update feedback");
+        await raiseForStatus(response, "update feedback", true);
     }
     async readFeedback(feedbackId) {
         assertUuid(feedbackId);
@@ -1948,9 +1942,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to delete ${path}: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, `delete ${path}`);
         await response.json();
     }
     async *listFeedback({ runIds, feedbackKeys, feedbackSourceTypes, } = {}) {
@@ -2143,9 +2135,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to ${like ? "like" : "unlike"} prompt: ${response.status} ${await response.text()}`);
-        }
+        await raiseForStatus(response, `${like ? "like" : "unlike"} prompt`);
         return await response.json();
     }
     async _getPromptUrl(promptIdentifier) {
@@ -2209,9 +2199,7 @@ export class Client {
         if (response.status === 404) {
             return null;
         }
-        if (!response.ok) {
-            throw new Error(`Failed to get prompt: ${response.status} ${await response.text()}`);
-        }
+        await raiseForStatus(response, "get prompt");
         const result = await response.json();
         if (result.repo) {
             return result.repo;
@@ -2246,9 +2234,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to create prompt: ${response.status} ${await response.text()}`);
-        }
+        await raiseForStatus(response, "create prompt");
         const { repo } = await response.json();
         return repo;
     }
@@ -2271,9 +2257,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to create commit: ${response.status} ${await response.text()}`);
-        }
+        await raiseForStatus(response, "create commit");
         const result = await response.json();
         return this._getPromptUrl(`${owner}/${promptName}${result.commit_hash ? `:${result.commit_hash}` : ""}`);
     }
@@ -2310,9 +2294,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`HTTP Error: ${response.status} - ${await response.text()}`);
-        }
+        await raiseForStatus(response, "update prompt");
         return response.json();
     }
     async deletePrompt(promptIdentifier) {
@@ -2351,9 +2333,7 @@ export class Client {
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
-        if (!response.ok) {
-            throw new Error(`Failed to pull prompt commit: ${response.status} ${response.statusText}`);
-        }
+        await raiseForStatus(response, "pull prompt commit");
         const result = await response.json();
         return {
             owner,
@@ -2406,4 +2386,85 @@ export class Client {
         });
         return url;
     }
+    /**
+     * Clone a public dataset to your own langsmith tenant.
+     * This operation is idempotent. If you already have a dataset with the given name,
+     * this function will do nothing.
+  
+     * @param {string} tokenOrUrl The token of the public dataset to clone.
+     * @param {Object} [options] Additional options for cloning the dataset.
+     * @param {string} [options.sourceApiUrl] The URL of the langsmith server where the data is hosted. Defaults to the API URL of your current client.
+     * @param {string} [options.datasetName] The name of the dataset to create in your tenant. Defaults to the name of the public dataset.
+     * @returns {Promise<void>}
+     */
+    async clonePublicDataset(tokenOrUrl, options = {}) {
+        const { sourceApiUrl = this.apiUrl, datasetName } = options;
+        const [parsedApiUrl, tokenUuid] = this.parseTokenOrUrl(tokenOrUrl, sourceApiUrl);
+        const sourceClient = new Client({
+            apiUrl: parsedApiUrl,
+            // Placeholder API key not needed anymore in most cases, but
+            // some private deployments may have API key-based rate limiting
+            // that would cause this to fail if we provide no value.
+            apiKey: "placeholder",
+        });
+        const ds = await sourceClient.readSharedDataset(tokenUuid);
+        const finalDatasetName = datasetName || ds.name;
+        try {
+            if (await this.hasDataset({ datasetId: finalDatasetName })) {
+                console.log(`Dataset ${finalDatasetName} already exists in your tenant. Skipping.`);
+                return;
+            }
+        }
+        catch (_) {
+            // `.hasDataset` will throw an error if the dataset does not exist.
+            // no-op in that case
+        }
+        // Fetch examples first, then create the dataset
+        const examples = await sourceClient.listSharedExamples(tokenUuid);
+        const dataset = await this.createDataset(finalDatasetName, {
+            description: ds.description,
+            dataType: ds.data_type || "kv",
+            inputsSchema: ds.inputs_schema_definition ?? undefined,
+            outputsSchema: ds.outputs_schema_definition ?? undefined,
+        });
+        try {
+            await this.createExamples({
+                inputs: examples.map((e) => e.inputs),
+                outputs: examples.flatMap((e) => (e.outputs ? [e.outputs] : [])),
+                datasetId: dataset.id,
+            });
+        }
+        catch (e) {
+            console.error(`An error occurred while creating dataset ${finalDatasetName}. ` +
+                "You should delete it manually.");
+            throw e;
+        }
+    }
+    parseTokenOrUrl(urlOrToken, apiUrl, numParts = 2, kind = "dataset") {
+        // Try parsing as UUID
+        try {
+            assertUuid(urlOrToken); // Will throw if it's not a UUID.
+            return [apiUrl, urlOrToken];
+        }
+        catch (_) {
+            // no-op if it's not a uuid
+        }
+        // Parse as URL
+        try {
+            const parsedUrl = new URL(urlOrToken);
+            const pathParts = parsedUrl.pathname
+                .split("/")
+                .filter((part) => part !== "");
+            if (pathParts.length >= numParts) {
+                const tokenUuid = pathParts[pathParts.length - numParts];
+                return [apiUrl, tokenUuid];
+            }
+            else {
+                throw new Error(`Invalid public ${kind} URL: ${urlOrToken}`);
+            }
+        }
+        catch (error) {
+            throw new Error(`Invalid public ${kind} URL or token: ${urlOrToken}`);
+        }
+    }
 }

package/dist/evaluation/_runner.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.evaluate = void 0;
+exports._ExperimentManager = exports.evaluate = void 0;
 const index_js_1 = require("../index.cjs");
 const langchain_js_1 = require("../langchain.cjs");
 const traceable_js_1 = require("../traceable.cjs");
@@ -232,17 +232,40 @@ class _ExperimentManager {
         }
         return projectMetadata;
     }
-    async _getProject(firstExample) {
+    async _createProject(firstExample, projectMetadata) {
+        // Create the project, updating the experimentName until we find a unique one.
         let project;
-        if (!this._experiment) {
+        const originalExperimentName = this._experimentName;
+        for (let i = 0; i < 10; i++) {
             try {
-                const projectMetadata = await this._getExperimentMetadata();
                 project = await this.client.createProject({
-                    projectName: this.experimentName,
+                    projectName: this._experimentName,
                     referenceDatasetId: firstExample.dataset_id,
                     metadata: projectMetadata,
                     description: this._description,
                 });
+                return project;
+            }
+            catch (e) {
+                // Naming collision
+                if (e?.name === "LangSmithConflictError") {
+                    const ent = (0, uuid_1.v4)().slice(0, 6);
+                    this._experimentName = `${originalExperimentName}-${ent}`;
+                }
+                else {
+                    throw e;
+                }
+            }
+        }
+        throw new Error("Could not generate a unique experiment name within 10 attempts." +
+            " Please try again with a different name.");
+    }
+    async _getProject(firstExample) {
+        let project;
+        if (!this._experiment) {
+            try {
+                const projectMetadata = await this._getExperimentMetadata();
+                project = await this._createProject(firstExample, projectMetadata);
                 this._experiment = project;
             }
             catch (e) {
@@ -554,6 +577,7 @@ class _ExperimentManager {
         });
     }
 }
+exports._ExperimentManager = _ExperimentManager;
 /**
  * Represents the results of an evaluate() call.
  * This class provides an iterator interface to iterate over the experiment results

package/dist/evaluation/_runner.d.ts

@@ -88,7 +88,7 @@ interface ExperimentResultRow {
  * Supports lazily running predictions and evaluations in parallel to facilitate
  * result streaming and early debugging.
  */
-declare class _ExperimentManager {
+export declare class _ExperimentManager {
     _data?: DataT;
     _runs?: AsyncGenerator<Run>;
     _evaluationResults?: AsyncGenerator<EvaluationResults>;
@@ -110,6 +110,7 @@ declare class _ExperimentManager {
     constructor(args: _ExperimentManagerArgs);
     _getExperiment(): TracerSession;
     _getExperimentMetadata(): Promise<KVMap>;
+    _createProject(firstExample: Example, projectMetadata: KVMap): Promise<TracerSession>;
     _getProject(firstExample: Example): Promise<TracerSession>;
     protected _printExperimentStart(): Promise<void>;
     start(): Promise<_ExperimentManager>;

package/dist/evaluation/_runner.js

@@ -23,7 +23,7 @@ target, options) {
  * Supports lazily running predictions and evaluations in parallel to facilitate
  * result streaming and early debugging.
  */
-class _ExperimentManager {
+export class _ExperimentManager {
     get experimentName() {
         if (this._experimentName) {
             return this._experimentName;
@@ -228,17 +228,40 @@ class _ExperimentManager {
         }
         return projectMetadata;
     }
-    async _getProject(firstExample) {
+    async _createProject(firstExample, projectMetadata) {
+        // Create the project, updating the experimentName until we find a unique one.
         let project;
-        if (!this._experiment) {
+        const originalExperimentName = this._experimentName;
+        for (let i = 0; i < 10; i++) {
             try {
-                const projectMetadata = await this._getExperimentMetadata();
                 project = await this.client.createProject({
-                    projectName: this.experimentName,
+                    projectName: this._experimentName,
                     referenceDatasetId: firstExample.dataset_id,
                     metadata: projectMetadata,
                     description: this._description,
                 });
+                return project;
+            }
+            catch (e) {
+                // Naming collision
+                if (e?.name === "LangSmithConflictError") {
+                    const ent = uuidv4().slice(0, 6);
+                    this._experimentName = `${originalExperimentName}-${ent}`;
+                }
+                else {
+                    throw e;
+                }
+            }
+        }
+        throw new Error("Could not generate a unique experiment name within 10 attempts." +
+            " Please try again with a different name.");
+    }
+    async _getProject(firstExample) {
+        let project;
+        if (!this._experiment) {
+            try {
+                const projectMetadata = await this._getExperimentMetadata();
+                project = await this._createProject(firstExample, projectMetadata);
                 this._experiment = project;
             }
             catch (e) {

package/dist/index.cjs

@@ -6,4 +6,4 @@ Object.defineProperty(exports, "Client", { enumerable: true, get: function () {
 var run_trees_js_1 = require("./run_trees.cjs");
 Object.defineProperty(exports, "RunTree", { enumerable: true, get: function () { return run_trees_js_1.RunTree; } });
 // Update using yarn bump-version
-exports.__version__ = "0.1.43";
+exports.__version__ = "0.1.45";

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { Client } from "./client.js";
+export { Client, type ClientConfig } from "./client.js";
 export type { Dataset, Example, TracerSession, Run, Feedback, RetrieverOutput, } from "./schemas.js";
 export { RunTree, type RunTreeConfig } from "./run_trees.js";
-export declare const __version__ = "0.1.43";
+export declare const __version__ = "0.1.45";

package/dist/index.js

@@ -1,4 +1,4 @@
 export { Client } from "./client.js";
 export { RunTree } from "./run_trees.js";
 // Update using yarn bump-version
-export const __version__ = "0.1.43";
+export const __version__ = "0.1.45";