langsmith 0.3.31 → 0.3.32-rc.1

package/dist/index.cjs

@@ -8,4 +8,4 @@ Object.defineProperty(exports, "RunTree", { enumerable: true, get: function () {
 var fetch_js_1 = require("./singletons/fetch.cjs");
 Object.defineProperty(exports, "overrideFetchImplementation", { enumerable: true, get: function () { return fetch_js_1.overrideFetchImplementation; } });
 // Update using yarn bump-version
-exports.__version__ = "0.3.31";
+exports.__version__ = "0.3.32-rc.1";

package/dist/index.d.ts

@@ -2,4 +2,4 @@ export { Client, type ClientConfig, type LangSmithTracingClientInterface, } from
 export type { Dataset, Example, TracerSession, Run, Feedback, RetrieverOutput, } from "./schemas.js";
 export { RunTree, type RunTreeConfig } from "./run_trees.js";
 export { overrideFetchImplementation } from "./singletons/fetch.js";
-export declare const __version__ = "0.3.31";
+export declare const __version__ = "0.3.32-rc.1";

package/dist/index.js

@@ -2,4 +2,4 @@ export { Client, } from "./client.js";
 export { RunTree } from "./run_trees.js";
 export { overrideFetchImplementation } from "./singletons/fetch.js";
 // Update using yarn bump-version
-export const __version__ = "0.3.31";
+export const __version__ = "0.3.32-rc.1";

package/dist/run_trees.cjs

@@ -56,7 +56,7 @@ function convertToDottedOrderFormat(epoch, runId, executionOrder = 1) {
  * Baggage header information
  */
 class Baggage {
-    constructor(metadata, tags, project_name) {
+    constructor(metadata, tags, project_name, replicas) {
         Object.defineProperty(this, "metadata", {
             enumerable: true,
             configurable: true,
@@ -75,15 +75,23 @@ class Baggage {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "replicas", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.metadata = metadata;
         this.tags = tags;
         this.project_name = project_name;
+        this.replicas = replicas;
     }
     static fromHeader(value) {
         const items = value.split(",");
         let metadata = {};
         let tags = [];
         let project_name;
+        let replicas;
         for (const item of items) {
             const [key, uriValue] = item.split("=");
             const value = decodeURIComponent(uriValue);
@@ -96,8 +104,11 @@ class Baggage {
             else if (key === "langsmith-project") {
                 project_name = value;
             }
+            else if (key === "langsmith-replicas") {
+                replicas = JSON.parse(value);
+            }
         }
-        return new Baggage(metadata, tags, project_name);
+        return new Baggage(metadata, tags, project_name, replicas);
     }
     toHeader() {
         const items = [];
@@ -257,6 +268,15 @@ class RunTree {
             writable: true,
             value: void 0
         });
+        /**
+         * Projects to replicate this run to with optional updates.
+         */
+        Object.defineProperty(this, "replicas", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         // If you pass in a run tree directly, return a shallow clone
         if (isRunTree(originalConfig)) {
             Object.assign(this, { ...originalConfig });
@@ -333,6 +353,7 @@ class RunTree {
             ...config,
             parent_run: this,
             project_name: this.project_name,
+            replicas: this.replicas,
             client: this.client,
             tracingEnabled: this.tracingEnabled,
             execution_order: child_execution_order,
@@ -387,13 +408,16 @@ class RunTree {
     }
     _convertToCreate(run, runtimeEnv, excludeChildRuns = true) {
         const runExtra = run.extra ?? {};
-        if (!runExtra.runtime) {
-            runExtra.runtime = {};
-        }
-        if (runtimeEnv) {
-            for (const [k, v] of Object.entries(runtimeEnv)) {
-                if (!runExtra.runtime[k]) {
-                    runExtra.runtime[k] = v;
+        // Avoid overwriting the runtime environment if it's already set
+        if (runExtra?.runtime?.library === undefined) {
+            if (!runExtra.runtime) {
+                runExtra.runtime = {};
+            }
+            if (runtimeEnv) {
+                for (const [k, v] of Object.entries(runtimeEnv)) {
+                    if (!runExtra.runtime[k]) {
+                        runExtra.runtime[k] = v;
+                    }
                 }
             }
         }
@@ -407,7 +431,7 @@ class RunTree {
             parent_run_id = run.parent_run?.id;
             child_runs = [];
         }
-        const persistedRun = {
+        return {
             id: run.id,
             name: run.name,
             start_time: run.start_time,
@@ -426,14 +450,69 @@ class RunTree {
             dotted_order: run.dotted_order,
             tags: run.tags,
             attachments: run.attachments,
+            events: run.events,
         };
-        return persistedRun;
+    }
+    _remapForProject(projectName, runtimeEnv, excludeChildRuns = true) {
+        const baseRun = this._convertToCreate(this, runtimeEnv, excludeChildRuns);
+        if (projectName === this.project_name) {
+            return baseRun;
+        }
+        // Create a deterministic UUID mapping for this project
+        const createRemappedId = (originalId) => {
+            return uuid.v5(`${originalId}:${projectName}`, uuid.v5.DNS);
+        };
+        // Remap the current run's ID
+        const newId = createRemappedId(baseRun.id);
+        const newTraceId = baseRun.trace_id
+            ? createRemappedId(baseRun.trace_id)
+            : undefined;
+        const newParentRunId = baseRun.parent_run_id
+            ? createRemappedId(baseRun.parent_run_id)
+            : undefined;
+        let newDottedOrder;
+        if (baseRun.dotted_order) {
+            const segments = _parseDottedOrder(baseRun.dotted_order);
+            const rebuilt = [];
+            // Process all segments except the last one
+            for (let i = 0; i < segments.length - 1; i++) {
+                const [timestamp, segmentId] = segments[i];
+                const remappedId = createRemappedId(segmentId);
+                rebuilt.push(timestamp.toISOString().replace(/[-:]/g, "").replace(".", "") +
+                    remappedId);
+            }
+            // Process the last segment with the new run ID
+            const [lastTimestamp] = segments[segments.length - 1];
+            rebuilt.push(lastTimestamp.toISOString().replace(/[-:]/g, "").replace(".", "") +
+                newId);
+            newDottedOrder = rebuilt.join(".");
+        }
+        else {
+            newDottedOrder = undefined;
+        }
+        const remappedRun = {
+            ...baseRun,
+            id: newId,
+            trace_id: newTraceId,
+            parent_run_id: newParentRunId,
+            dotted_order: newDottedOrder,
+            session_name: projectName,
+        };
+        return remappedRun;
     }
     async postRun(excludeChildRuns = true) {
         try {
             const runtimeEnv = (0, env_js_1.getRuntimeEnvironment)();
-            const runCreate = await this._convertToCreate(this, runtimeEnv, true);
-            await this.client.createRun(runCreate);
+            if (this.replicas && this.replicas.length > 0) {
+                for (const [projectName] of this.replicas) {
+                    const runCreate = this._remapForProject(projectName, runtimeEnv, true);
+                    await this.client.createRun(runCreate);
+                }
+            }
+            else {
+                const runCreate = this._convertToCreate(this, runtimeEnv, excludeChildRuns);
+                await this.client.createRun(runCreate);
+            }
             if (!excludeChildRuns) {
                 (0, warn_js_1.warnOnce)("Posting with excludeChildRuns=false is deprecated and will be removed in a future version.");
                 for (const childRun of this.child_runs) {
@@ -446,26 +525,49 @@ class RunTree {
         }
     }
     async patchRun() {
-        try {
-            const runUpdate = {
-                end_time: this.end_time,
-                error: this.error,
-                inputs: this.inputs,
-                outputs: this.outputs,
-                parent_run_id: this.parent_run?.id,
-                reference_example_id: this.reference_example_id,
-                extra: this.extra,
-                events: this.events,
-                dotted_order: this.dotted_order,
-                trace_id: this.trace_id,
-                tags: this.tags,
-                attachments: this.attachments,
-                session_name: this.project_name,
-            };
-            await this.client.updateRun(this.id, runUpdate);
+        if (this.replicas && this.replicas.length > 0) {
+            for (const [projectName, updates] of this.replicas) {
+                const runData = this._remapForProject(projectName);
+                await this.client.updateRun(runData.id, {
+                    inputs: runData.inputs,
+                    outputs: runData.outputs,
+                    error: runData.error,
+                    parent_run_id: runData.parent_run_id,
+                    session_name: runData.session_name,
+                    reference_example_id: runData.reference_example_id,
+                    end_time: runData.end_time,
+                    dotted_order: runData.dotted_order,
+                    trace_id: runData.trace_id,
+                    events: runData.events,
+                    tags: runData.tags,
+                    extra: runData.extra,
+                    attachments: this.attachments,
+                    ...updates,
+                });
+            }
         }
-        catch (error) {
-            console.error(`Error in patchRun for run ${this.id}`, error);
+        else {
+            try {
+                const runUpdate = {
+                    end_time: this.end_time,
+                    error: this.error,
+                    inputs: this.inputs,
+                    outputs: this.outputs,
+                    parent_run_id: this.parent_run?.id,
+                    reference_example_id: this.reference_example_id,
+                    extra: this.extra,
+                    events: this.events,
+                    dotted_order: this.dotted_order,
+                    trace_id: this.trace_id,
+                    tags: this.tags,
+                    attachments: this.attachments,
+                    session_name: this.project_name,
+                };
+                await this.client.updateRun(this.id, runUpdate);
+            }
+            catch (error) {
+                console.error(`Error in patchRun for run ${this.id}`, error);
+            }
         }
     }
     toJSON() {
@@ -569,13 +671,14 @@ class RunTree {
             config.metadata = baggage.metadata;
             config.tags = baggage.tags;
             config.project_name = baggage.project_name;
+            config.replicas = baggage.replicas;
         }
         return new RunTree(config);
     }
     toHeaders(headers) {
         const result = {
             "langsmith-trace": this.dotted_order,
-            baggage: new Baggage(this.extra?.metadata, this.tags, this.project_name).toHeader(),
+            baggage: new Baggage(this.extra?.metadata, this.tags, this.project_name, this.replicas).toHeader(),
         };
         if (headers) {
             for (const [key, value] of Object.entries(result)) {
@@ -622,3 +725,21 @@ function isRunnableConfigLike(x) {
             // Or it's an array with a LangChainTracerLike object within it
             containsLangChainTracerLike(x.callbacks)));
 }
+function _parseDottedOrder(dottedOrder) {
+    const parts = dottedOrder.split(".");
+    return parts.map((part) => {
+        const timestampStr = part.slice(0, -36);
+        const uuidStr = part.slice(-36);
+        // Parse timestamp: "%Y%m%dT%H%M%S%fZ" format
+        // Example: "20231215T143045123456Z"
+        const year = parseInt(timestampStr.slice(0, 4));
+        const month = parseInt(timestampStr.slice(4, 6)) - 1; // JS months are 0-indexed
+        const day = parseInt(timestampStr.slice(6, 8));
+        const hour = parseInt(timestampStr.slice(9, 11));
+        const minute = parseInt(timestampStr.slice(11, 13));
+        const second = parseInt(timestampStr.slice(13, 15));
+        const microsecond = parseInt(timestampStr.slice(15, 21));
+        const timestamp = new Date(year, month, day, hour, minute, second, microsecond / 1000);
+        return [timestamp, uuidStr];
+    });
+}

package/dist/run_trees.d.ts

@@ -27,6 +27,7 @@ export interface RunTreeConfig {
     trace_id?: string;
     dotted_order?: string;
     attachments?: Attachments;
+    replicas?: [string, KVMap | undefined][];
 }
 export interface RunnableConfigLike {
     /**
@@ -78,6 +79,10 @@ export declare class RunTree implements BaseRun {
      * Each entry is a tuple of [mime_type, bytes]
      */
     attachments?: Attachments;
+    /**
+     * Projects to replicate this run to with optional updates.
+     */
+    replicas?: [string, KVMap | undefined][];
     constructor(originalConfig: RunTreeConfig | RunTree);
     set metadata(metadata: KVMap);
     get metadata(): KVMap;
@@ -86,9 +91,12 @@ export declare class RunTree implements BaseRun {
     createChild(config: RunTreeConfig): RunTree;
     end(outputs?: KVMap, error?: string, endTime?: number, metadata?: KVMap): Promise<void>;
     private _convertToCreate;
+    private _remapForProject;
     postRun(excludeChildRuns?: boolean): Promise<void>;
     patchRun(): Promise<void>;
-    toJSON(): RunCreate;
+    toJSON(): RunCreate & {
+        id: string;
+    };
     /**
      * Add an event to the run tree.
      * @param event - A single event or string to add

package/dist/run_trees.js

@@ -17,7 +17,7 @@ export function convertToDottedOrderFormat(epoch, runId, executionOrder = 1) {
  * Baggage header information
  */
 class Baggage {
-    constructor(metadata, tags, project_name) {
+    constructor(metadata, tags, project_name, replicas) {
         Object.defineProperty(this, "metadata", {
             enumerable: true,
             configurable: true,
@@ -36,15 +36,23 @@ class Baggage {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "replicas", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.metadata = metadata;
         this.tags = tags;
         this.project_name = project_name;
+        this.replicas = replicas;
     }
     static fromHeader(value) {
         const items = value.split(",");
         let metadata = {};
         let tags = [];
         let project_name;
+        let replicas;
         for (const item of items) {
             const [key, uriValue] = item.split("=");
             const value = decodeURIComponent(uriValue);
@@ -57,8 +65,11 @@ class Baggage {
             else if (key === "langsmith-project") {
                 project_name = value;
             }
+            else if (key === "langsmith-replicas") {
+                replicas = JSON.parse(value);
+            }
         }
-        return new Baggage(metadata, tags, project_name);
+        return new Baggage(metadata, tags, project_name, replicas);
     }
     toHeader() {
         const items = [];
@@ -218,6 +229,15 @@ export class RunTree {
             writable: true,
             value: void 0
         });
+        /**
+         * Projects to replicate this run to with optional updates.
+         */
+        Object.defineProperty(this, "replicas", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         // If you pass in a run tree directly, return a shallow clone
         if (isRunTree(originalConfig)) {
             Object.assign(this, { ...originalConfig });
@@ -294,6 +314,7 @@ export class RunTree {
             ...config,
             parent_run: this,
             project_name: this.project_name,
+            replicas: this.replicas,
             client: this.client,
             tracingEnabled: this.tracingEnabled,
             execution_order: child_execution_order,
@@ -348,13 +369,16 @@ export class RunTree {
     }
     _convertToCreate(run, runtimeEnv, excludeChildRuns = true) {
         const runExtra = run.extra ?? {};
-        if (!runExtra.runtime) {
-            runExtra.runtime = {};
-        }
-        if (runtimeEnv) {
-            for (const [k, v] of Object.entries(runtimeEnv)) {
-                if (!runExtra.runtime[k]) {
-                    runExtra.runtime[k] = v;
+        // Avoid overwriting the runtime environment if it's already set
+        if (runExtra?.runtime?.library === undefined) {
+            if (!runExtra.runtime) {
+                runExtra.runtime = {};
+            }
+            if (runtimeEnv) {
+                for (const [k, v] of Object.entries(runtimeEnv)) {
+                    if (!runExtra.runtime[k]) {
+                        runExtra.runtime[k] = v;
+                    }
                 }
             }
         }
@@ -368,7 +392,7 @@ export class RunTree {
             parent_run_id = run.parent_run?.id;
             child_runs = [];
         }
-        const persistedRun = {
+        return {
             id: run.id,
             name: run.name,
             start_time: run.start_time,
@@ -387,14 +411,69 @@ export class RunTree {
             dotted_order: run.dotted_order,
             tags: run.tags,
             attachments: run.attachments,
+            events: run.events,
         };
-        return persistedRun;
+    }
+    _remapForProject(projectName, runtimeEnv, excludeChildRuns = true) {
+        const baseRun = this._convertToCreate(this, runtimeEnv, excludeChildRuns);
+        if (projectName === this.project_name) {
+            return baseRun;
+        }
+        // Create a deterministic UUID mapping for this project
+        const createRemappedId = (originalId) => {
+            return uuid.v5(`${originalId}:${projectName}`, uuid.v5.DNS);
+        };
+        // Remap the current run's ID
+        const newId = createRemappedId(baseRun.id);
+        const newTraceId = baseRun.trace_id
+            ? createRemappedId(baseRun.trace_id)
+            : undefined;
+        const newParentRunId = baseRun.parent_run_id
+            ? createRemappedId(baseRun.parent_run_id)
+            : undefined;
+        let newDottedOrder;
+        if (baseRun.dotted_order) {
+            const segments = _parseDottedOrder(baseRun.dotted_order);
+            const rebuilt = [];
+            // Process all segments except the last one
+            for (let i = 0; i < segments.length - 1; i++) {
+                const [timestamp, segmentId] = segments[i];
+                const remappedId = createRemappedId(segmentId);
+                rebuilt.push(timestamp.toISOString().replace(/[-:]/g, "").replace(".", "") +
+                    remappedId);
+            }
+            // Process the last segment with the new run ID
+            const [lastTimestamp] = segments[segments.length - 1];
+            rebuilt.push(lastTimestamp.toISOString().replace(/[-:]/g, "").replace(".", "") +
+                newId);
+            newDottedOrder = rebuilt.join(".");
+        }
+        else {
+            newDottedOrder = undefined;
+        }
+        const remappedRun = {
+            ...baseRun,
+            id: newId,
+            trace_id: newTraceId,
+            parent_run_id: newParentRunId,
+            dotted_order: newDottedOrder,
+            session_name: projectName,
+        };
+        return remappedRun;
     }
     async postRun(excludeChildRuns = true) {
         try {
             const runtimeEnv = getRuntimeEnvironment();
-            const runCreate = await this._convertToCreate(this, runtimeEnv, true);
-            await this.client.createRun(runCreate);
+            if (this.replicas && this.replicas.length > 0) {
+                for (const [projectName] of this.replicas) {
+                    const runCreate = this._remapForProject(projectName, runtimeEnv, true);
+                    await this.client.createRun(runCreate);
+                }
+            }
+            else {
+                const runCreate = this._convertToCreate(this, runtimeEnv, excludeChildRuns);
+                await this.client.createRun(runCreate);
+            }
             if (!excludeChildRuns) {
                 warnOnce("Posting with excludeChildRuns=false is deprecated and will be removed in a future version.");
                 for (const childRun of this.child_runs) {
@@ -407,26 +486,49 @@ export class RunTree {
         }
     }
     async patchRun() {
-        try {
-            const runUpdate = {
-                end_time: this.end_time,
-                error: this.error,
-                inputs: this.inputs,
-                outputs: this.outputs,
-                parent_run_id: this.parent_run?.id,
-                reference_example_id: this.reference_example_id,
-                extra: this.extra,
-                events: this.events,
-                dotted_order: this.dotted_order,
-                trace_id: this.trace_id,
-                tags: this.tags,
-                attachments: this.attachments,
-                session_name: this.project_name,
-            };
-            await this.client.updateRun(this.id, runUpdate);
+        if (this.replicas && this.replicas.length > 0) {
+            for (const [projectName, updates] of this.replicas) {
+                const runData = this._remapForProject(projectName);
+                await this.client.updateRun(runData.id, {
+                    inputs: runData.inputs,
+                    outputs: runData.outputs,
+                    error: runData.error,
+                    parent_run_id: runData.parent_run_id,
+                    session_name: runData.session_name,
+                    reference_example_id: runData.reference_example_id,
+                    end_time: runData.end_time,
+                    dotted_order: runData.dotted_order,
+                    trace_id: runData.trace_id,
+                    events: runData.events,
+                    tags: runData.tags,
+                    extra: runData.extra,
+                    attachments: this.attachments,
+                    ...updates,
+                });
+            }
         }
-        catch (error) {
-            console.error(`Error in patchRun for run ${this.id}`, error);
+        else {
+            try {
+                const runUpdate = {
+                    end_time: this.end_time,
+                    error: this.error,
+                    inputs: this.inputs,
+                    outputs: this.outputs,
+                    parent_run_id: this.parent_run?.id,
+                    reference_example_id: this.reference_example_id,
+                    extra: this.extra,
+                    events: this.events,
+                    dotted_order: this.dotted_order,
+                    trace_id: this.trace_id,
+                    tags: this.tags,
+                    attachments: this.attachments,
+                    session_name: this.project_name,
+                };
+                await this.client.updateRun(this.id, runUpdate);
+            }
+            catch (error) {
+                console.error(`Error in patchRun for run ${this.id}`, error);
+            }
         }
     }
     toJSON() {
@@ -530,13 +632,14 @@ export class RunTree {
             config.metadata = baggage.metadata;
             config.tags = baggage.tags;
             config.project_name = baggage.project_name;
+            config.replicas = baggage.replicas;
         }
         return new RunTree(config);
     }
     toHeaders(headers) {
         const result = {
             "langsmith-trace": this.dotted_order,
-            baggage: new Baggage(this.extra?.metadata, this.tags, this.project_name).toHeader(),
+            baggage: new Baggage(this.extra?.metadata, this.tags, this.project_name, this.replicas).toHeader(),
         };
         if (headers) {
             for (const [key, value] of Object.entries(result)) {
@@ -582,3 +685,21 @@ export function isRunnableConfigLike(x) {
             // Or it's an array with a LangChainTracerLike object within it
             containsLangChainTracerLike(x.callbacks)));
 }
+function _parseDottedOrder(dottedOrder) {
+    const parts = dottedOrder.split(".");
+    return parts.map((part) => {
+        const timestampStr = part.slice(0, -36);
+        const uuidStr = part.slice(-36);
+        // Parse timestamp: "%Y%m%dT%H%M%S%fZ" format
+        // Example: "20231215T143045123456Z"
+        const year = parseInt(timestampStr.slice(0, 4));
+        const month = parseInt(timestampStr.slice(4, 6)) - 1; // JS months are 0-indexed
+        const day = parseInt(timestampStr.slice(6, 8));
+        const hour = parseInt(timestampStr.slice(9, 11));
+        const minute = parseInt(timestampStr.slice(11, 13));
+        const second = parseInt(timestampStr.slice(13, 15));
+        const microsecond = parseInt(timestampStr.slice(15, 21));
+        const timestamp = new Date(year, month, day, hour, minute, second, microsecond / 1000);
+        return [timestamp, uuidStr];
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.3.31",
+  "version": "0.3.32-rc.1",
   "description": "Client library to connect to the LangSmith LLM Tracing and Evaluation Platform.",
   "packageManager": "yarn@1.22.19",
   "files": [