langsmith 0.3.78 → 0.3.79-rc.0

package/dist/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.__version__ = exports.getDefaultProjectName = exports.overrideFetchImplementation = exports.RunTree = exports.Client = void 0;
+exports.__version__ = exports.uuid7FromTime = exports.uuid7 = exports.getDefaultProjectName = exports.overrideFetchImplementation = exports.RunTree = exports.Client = void 0;
 var client_js_1 = require("./client.cjs");
 Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return client_js_1.Client; } });
 var run_trees_js_1 = require("./run_trees.cjs");
@@ -9,5 +9,8 @@ var fetch_js_1 = require("./singletons/fetch.cjs");
 Object.defineProperty(exports, "overrideFetchImplementation", { enumerable: true, get: function () { return fetch_js_1.overrideFetchImplementation; } });
 var project_js_1 = require("./utils/project.cjs");
 Object.defineProperty(exports, "getDefaultProjectName", { enumerable: true, get: function () { return project_js_1.getDefaultProjectName; } });
+var uuid_js_1 = require("./uuid.cjs");
+Object.defineProperty(exports, "uuid7", { enumerable: true, get: function () { return uuid_js_1.uuid7; } });
+Object.defineProperty(exports, "uuid7FromTime", { enumerable: true, get: function () { return uuid_js_1.uuid7FromTime; } });
 // Update using yarn bump-version
-exports.__version__ = "0.3.78";
+exports.__version__ = "0.3.79-rc.0";

package/dist/index.d.ts

@@ -3,4 +3,5 @@ export type { Dataset, Example, TracerSession, Run, Feedback, RetrieverOutput, }
 export { RunTree, type RunTreeConfig } from "./run_trees.js";
 export { overrideFetchImplementation } from "./singletons/fetch.js";
 export { getDefaultProjectName } from "./utils/project.js";
-export declare const __version__ = "0.3.78";
+export { uuid7, uuid7FromTime } from "./uuid.js";
+export declare const __version__ = "0.3.79-rc.0";

package/dist/index.js

@@ -2,5 +2,6 @@ export { Client, } from "./client.js";
 export { RunTree } from "./run_trees.js";
 export { overrideFetchImplementation } from "./singletons/fetch.js";
 export { getDefaultProjectName } from "./utils/project.js";
+export { uuid7, uuid7FromTime } from "./uuid.js";
 // Update using yarn bump-version
-export const __version__ = "0.3.78";
+export const __version__ = "0.3.79-rc.0";

package/dist/run_trees.cjs

@@ -1,43 +1,9 @@
 "use strict";
-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.RunTree = void 0;
 exports.convertToDottedOrderFormat = convertToDottedOrderFormat;
 exports.isRunTree = isRunTree;
 exports.isRunnableConfigLike = isRunnableConfigLike;
-const uuid = __importStar(require("uuid"));
 const client_js_1 = require("./client.cjs");
 const env_js_1 = require("./env.cjs");
 const error_js_1 = require("./utils/error.cjs");
@@ -46,16 +12,18 @@ const env_js_2 = require("./utils/env.cjs");
 const project_js_1 = require("./utils/project.cjs");
 const env_js_3 = require("./utils/env.cjs");
 const warn_js_1 = require("./utils/warn.cjs");
+const _uuid_js_1 = require("./utils/_uuid.cjs");
 function stripNonAlphanumeric(input) {
     return input.replace(/[-:.]/g, "");
 }
-function convertToDottedOrderFormat(epoch, runId, executionOrder = 1) {
+function getMicrosecondPrecisionDatestring(epoch, executionOrder = 1) {
     // Date only has millisecond precision, so we use the microseconds to break
     // possible ties, avoiding incorrect run order
     const paddedOrder = executionOrder.toFixed(0).slice(0, 3).padStart(3, "0");
-    const microsecondPrecisionDatestring = `${new Date(epoch)
-        .toISOString()
-        .slice(0, -1)}${paddedOrder}Z`;
+    return `${new Date(epoch).toISOString().slice(0, -1)}${paddedOrder}Z`;
+}
+function convertToDottedOrderFormat(epoch, runId, executionOrder = 1) {
+    const microsecondPrecisionDatestring = getMicrosecondPrecisionDatestring(epoch, executionOrder);
     return {
         dottedOrder: stripNonAlphanumeric(microsecondPrecisionDatestring) + runId,
         microsecondPrecisionDatestring,
@@ -315,6 +283,19 @@ class RunTree {
             delete config.id;
         }
         Object.assign(this, { ...defaultConfig, ...config, client });
+        this.execution_order ??= 1;
+        this.child_execution_order ??= 1;
+        // Generate serialized start time for ID generation
+        if (!this.dotted_order) {
+            this._serialized_start_time = getMicrosecondPrecisionDatestring(this.start_time, this.execution_order);
+        }
+        // Generate id from serialized start_time if not provided
+        if (!this.id) {
+            this.id = (0, _uuid_js_1.uuid7FromTime)(this._serialized_start_time ?? this.start_time);
+        }
+        if (config.id) {
+            (0, _uuid_js_1.warnIfNotUuidV7)(config.id, "run_id");
+        }
         if (!this.trace_id) {
             if (this.parent_run) {
                 this.trace_id = this.parent_run.trace_id ?? this.id;
@@ -323,18 +304,22 @@ class RunTree {
                 this.trace_id = this.id;
             }
         }
+        else if (config.trace_id) {
+            (0, _uuid_js_1.warnIfNotUuidV7)(config.trace_id, "trace_id");
+        }
+        if (config.parent_run_id) {
+            (0, _uuid_js_1.warnIfNotUuidV7)(config.parent_run_id, "parent_run_id");
+        }
         this.replicas = _ensureWriteReplicas(this.replicas);
-        this.execution_order ??= 1;
-        this.child_execution_order ??= 1;
+        // Now set the dotted order with the actual ID
         if (!this.dotted_order) {
-            const { dottedOrder, microsecondPrecisionDatestring } = convertToDottedOrderFormat(this.start_time, this.id, this.execution_order);
+            const { dottedOrder } = convertToDottedOrderFormat(this.start_time, this.id, this.execution_order);
             if (this.parent_run) {
                 this.dotted_order = this.parent_run.dotted_order + "." + dottedOrder;
             }
             else {
                 this.dotted_order = dottedOrder;
             }
-            this._serialized_start_time = microsecondPrecisionDatestring;
         }
     }
     set metadata(metadata) {
@@ -350,15 +335,15 @@ class RunTree {
         return this.extra?.metadata;
     }
     static getDefaultConfig() {
+        const start_time = Date.now();
         return {
-            id: uuid.v4(),
             run_type: "chain",
             project_name: (0, project_js_1.getDefaultProjectName)(),
             child_runs: [],
             api_url: (0, env_js_2.getEnvironmentVariable)("LANGCHAIN_ENDPOINT") ?? "http://localhost:1984",
             api_key: (0, env_js_2.getEnvironmentVariable)("LANGCHAIN_API_KEY"),
             caller_options: {},
-            start_time: Date.now(),
+            start_time,
             serialized: {},
             inputs: {},
             extra: {},
@@ -478,50 +463,10 @@ class RunTree {
     }
     _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 = {
+        return {
             ...baseRun,
-            id: newId,
-            trace_id: newTraceId,
-            parent_run_id: newParentRunId,
-            dotted_order: newDottedOrder,
             session_name: projectName,
         };
-        return remappedRun;
     }
     async postRun(excludeChildRuns = true) {
         try {
@@ -559,6 +504,9 @@ class RunTree {
                 const runData = this._remapForProject(projectName ?? this.project_name);
                 const updatePayload = {
                     id: runData.id,
+                    name: runData.name,
+                    run_type: runData.run_type,
+                    start_time: runData.start_time,
                     outputs: runData.outputs,
                     error: runData.error,
                     parent_run_id: runData.parent_run_id,
@@ -589,6 +537,9 @@ class RunTree {
         else {
             try {
                 const runUpdate = {
+                    name: this.name,
+                    run_type: this.run_type,
+                    start_time: this._serialized_start_time ?? this.start_time,
                     end_time: this.end_time,
                     error: this.error,
                     outputs: this.outputs,
@@ -770,24 +721,6 @@ 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];
-    });
-}
 function _getWriteReplicasFromEnv() {
     const envVar = (0, env_js_2.getEnvironmentVariable)("LANGSMITH_RUNS_ENDPOINTS");
     if (!envVar)

package/dist/run_trees.js

@@ -1,4 +1,3 @@
-import * as uuid from "uuid";
 import { Client } from "./client.js";
 import { isTracingEnabled } from "./env.js";
 import { isConflictingEndpointsError, ConflictingEndpointsError, } from "./utils/error.js";
@@ -7,16 +6,18 @@ import { getEnvironmentVariable, getRuntimeEnvironment, } from "./utils/env.js";
 import { getDefaultProjectName } from "./utils/project.js";
 import { getLangSmithEnvironmentVariable } from "./utils/env.js";
 import { warnOnce } from "./utils/warn.js";
+import { warnIfNotUuidV7, uuid7FromTime } from "./utils/_uuid.js";
 function stripNonAlphanumeric(input) {
     return input.replace(/[-:.]/g, "");
 }
-export function convertToDottedOrderFormat(epoch, runId, executionOrder = 1) {
+function getMicrosecondPrecisionDatestring(epoch, executionOrder = 1) {
     // Date only has millisecond precision, so we use the microseconds to break
     // possible ties, avoiding incorrect run order
     const paddedOrder = executionOrder.toFixed(0).slice(0, 3).padStart(3, "0");
-    const microsecondPrecisionDatestring = `${new Date(epoch)
-        .toISOString()
-        .slice(0, -1)}${paddedOrder}Z`;
+    return `${new Date(epoch).toISOString().slice(0, -1)}${paddedOrder}Z`;
+}
+export function convertToDottedOrderFormat(epoch, runId, executionOrder = 1) {
+    const microsecondPrecisionDatestring = getMicrosecondPrecisionDatestring(epoch, executionOrder);
     return {
         dottedOrder: stripNonAlphanumeric(microsecondPrecisionDatestring) + runId,
         microsecondPrecisionDatestring,
@@ -276,6 +277,19 @@ export class RunTree {
             delete config.id;
         }
         Object.assign(this, { ...defaultConfig, ...config, client });
+        this.execution_order ??= 1;
+        this.child_execution_order ??= 1;
+        // Generate serialized start time for ID generation
+        if (!this.dotted_order) {
+            this._serialized_start_time = getMicrosecondPrecisionDatestring(this.start_time, this.execution_order);
+        }
+        // Generate id from serialized start_time if not provided
+        if (!this.id) {
+            this.id = uuid7FromTime(this._serialized_start_time ?? this.start_time);
+        }
+        if (config.id) {
+            warnIfNotUuidV7(config.id, "run_id");
+        }
         if (!this.trace_id) {
             if (this.parent_run) {
                 this.trace_id = this.parent_run.trace_id ?? this.id;
@@ -284,18 +298,22 @@ export class RunTree {
                 this.trace_id = this.id;
             }
         }
+        else if (config.trace_id) {
+            warnIfNotUuidV7(config.trace_id, "trace_id");
+        }
+        if (config.parent_run_id) {
+            warnIfNotUuidV7(config.parent_run_id, "parent_run_id");
+        }
         this.replicas = _ensureWriteReplicas(this.replicas);
-        this.execution_order ??= 1;
-        this.child_execution_order ??= 1;
+        // Now set the dotted order with the actual ID
         if (!this.dotted_order) {
-            const { dottedOrder, microsecondPrecisionDatestring } = convertToDottedOrderFormat(this.start_time, this.id, this.execution_order);
+            const { dottedOrder } = convertToDottedOrderFormat(this.start_time, this.id, this.execution_order);
             if (this.parent_run) {
                 this.dotted_order = this.parent_run.dotted_order + "." + dottedOrder;
             }
             else {
                 this.dotted_order = dottedOrder;
             }
-            this._serialized_start_time = microsecondPrecisionDatestring;
         }
     }
     set metadata(metadata) {
@@ -311,15 +329,15 @@ export class RunTree {
         return this.extra?.metadata;
     }
     static getDefaultConfig() {
+        const start_time = Date.now();
         return {
-            id: uuid.v4(),
             run_type: "chain",
             project_name: getDefaultProjectName(),
             child_runs: [],
             api_url: getEnvironmentVariable("LANGCHAIN_ENDPOINT") ?? "http://localhost:1984",
             api_key: getEnvironmentVariable("LANGCHAIN_API_KEY"),
             caller_options: {},
-            start_time: Date.now(),
+            start_time,
             serialized: {},
             inputs: {},
             extra: {},
@@ -439,50 +457,10 @@ export class RunTree {
     }
     _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 = {
+        return {
             ...baseRun,
-            id: newId,
-            trace_id: newTraceId,
-            parent_run_id: newParentRunId,
-            dotted_order: newDottedOrder,
             session_name: projectName,
         };
-        return remappedRun;
     }
     async postRun(excludeChildRuns = true) {
         try {
@@ -520,6 +498,9 @@ export class RunTree {
                 const runData = this._remapForProject(projectName ?? this.project_name);
                 const updatePayload = {
                     id: runData.id,
+                    name: runData.name,
+                    run_type: runData.run_type,
+                    start_time: runData.start_time,
                     outputs: runData.outputs,
                     error: runData.error,
                     parent_run_id: runData.parent_run_id,
@@ -550,6 +531,9 @@ export class RunTree {
         else {
             try {
                 const runUpdate = {
+                    name: this.name,
+                    run_type: this.run_type,
+                    start_time: this._serialized_start_time ?? this.start_time,
                     end_time: this.end_time,
                     error: this.error,
                     outputs: this.outputs,
@@ -730,24 +714,6 @@ 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];
-    });
-}
 function _getWriteReplicasFromEnv() {
     const envVar = getEnvironmentVariable("LANGSMITH_RUNS_ENDPOINTS");
     if (!envVar)

package/dist/schemas.d.ts

@@ -152,6 +152,9 @@ export interface RunCreate extends BaseRun {
 }
 export interface RunUpdate {
     id?: string;
+    name?: string;
+    run_type?: string;
+    start_time?: number | string;
     end_time?: number | string;
     extra?: KVMap;
     tags?: string[];

package/dist/utils/_uuid.cjs

@@ -1,8 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assertUuid = assertUuid;
+exports.uuid7FromTime = uuid7FromTime;
+exports.getUuidVersion = getUuidVersion;
+exports.warnIfNotUuidV7 = warnIfNotUuidV7;
 // Relaxed UUID validation regex (allows any valid UUID format including nil UUIDs)
 const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const uuid_1 = require("uuid");
+const warn_js_1 = require("./warn.cjs");
+let UUID7_WARNING_EMITTED = false;
 function assertUuid(str, which) {
     // Use relaxed regex validation instead of strict uuid.validate()
     // This allows edge cases like nil UUIDs or test UUIDs that might not pass strict validation
@@ -14,3 +20,47 @@ function assertUuid(str, which) {
     }
     return str;
 }
+/**
+ * Generate a UUID v7 from a timestamp.
+ *
+ * @param timestamp - The timestamp in milliseconds
+ * @returns A UUID v7 string
+ */
+function uuid7FromTime(timestamp) {
+    const msecs = typeof timestamp === "string" ? Date.parse(timestamp) : timestamp;
+    // Work around uuid@10 behavior where providing only { msecs }
+    // may not set the internal timestamp used for stringification.
+    // Providing a seq ensures the implementation updates its internal state
+    // and encodes the provided milliseconds into the UUID bytes.
+    return (0, uuid_1.v7)({ msecs, seq: 0 });
+}
+/**
+ * Get the version of a UUID string.
+ * @param uuidStr - The UUID string to check
+ * @returns The version number (1-7) or null if invalid
+ */
+function getUuidVersion(uuidStr) {
+    if (!UUID_REGEX.test(uuidStr)) {
+        return null;
+    }
+    // Version is in bits 48-51
+    // Format: xxxxxxxx-xxxx-Vxxx-xxxx-xxxxxxxxxxxx
+    const versionChar = uuidStr[14];
+    return parseInt(versionChar, 16);
+}
+/**
+ * Warn if a UUID is not version 7.
+ *
+ * @param uuidStr - The UUID string to check
+ * @param idType - The type of ID (e.g., "run_id", "trace_id") for the warning message
+ */
+function warnIfNotUuidV7(uuidStr, _idType) {
+    const version = getUuidVersion(uuidStr);
+    if (version !== null && version !== 7 && !UUID7_WARNING_EMITTED) {
+        UUID7_WARNING_EMITTED = true;
+        (0, warn_js_1.warnOnce)(`LangSmith now uses UUID v7 for run and trace identifiers. ` +
+            `This warning appears when passing custom IDs. ` +
+            `Please use: import { uuidv7 } from 'langsmith'; const id = uuidv7(); ` +
+            `Future versions will require UUID v7.`);
+    }
+}

package/dist/utils/_uuid.d.ts

@@ -1 +1,21 @@
 export declare function assertUuid(str: string, which?: string): string;
+/**
+ * Generate a UUID v7 from a timestamp.
+ *
+ * @param timestamp - The timestamp in milliseconds
+ * @returns A UUID v7 string
+ */
+export declare function uuid7FromTime(timestamp: number | string): string;
+/**
+ * Get the version of a UUID string.
+ * @param uuidStr - The UUID string to check
+ * @returns The version number (1-7) or null if invalid
+ */
+export declare function getUuidVersion(uuidStr: string): number | null;
+/**
+ * Warn if a UUID is not version 7.
+ *
+ * @param uuidStr - The UUID string to check
+ * @param idType - The type of ID (e.g., "run_id", "trace_id") for the warning message
+ */
+export declare function warnIfNotUuidV7(uuidStr: string, _idType: string): void;

package/dist/utils/_uuid.js

@@ -1,5 +1,8 @@
 // Relaxed UUID validation regex (allows any valid UUID format including nil UUIDs)
 const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+import { v7 as uuidv7 } from "uuid";
+import { warnOnce } from "./warn.js";
+let UUID7_WARNING_EMITTED = false;
 export function assertUuid(str, which) {
     // Use relaxed regex validation instead of strict uuid.validate()
     // This allows edge cases like nil UUIDs or test UUIDs that might not pass strict validation
@@ -11,3 +14,47 @@ export function assertUuid(str, which) {
     }
     return str;
 }
+/**
+ * Generate a UUID v7 from a timestamp.
+ *
+ * @param timestamp - The timestamp in milliseconds
+ * @returns A UUID v7 string
+ */
+export function uuid7FromTime(timestamp) {
+    const msecs = typeof timestamp === "string" ? Date.parse(timestamp) : timestamp;
+    // Work around uuid@10 behavior where providing only { msecs }
+    // may not set the internal timestamp used for stringification.
+    // Providing a seq ensures the implementation updates its internal state
+    // and encodes the provided milliseconds into the UUID bytes.
+    return uuidv7({ msecs, seq: 0 });
+}
+/**
+ * Get the version of a UUID string.
+ * @param uuidStr - The UUID string to check
+ * @returns The version number (1-7) or null if invalid
+ */
+export function getUuidVersion(uuidStr) {
+    if (!UUID_REGEX.test(uuidStr)) {
+        return null;
+    }
+    // Version is in bits 48-51
+    // Format: xxxxxxxx-xxxx-Vxxx-xxxx-xxxxxxxxxxxx
+    const versionChar = uuidStr[14];
+    return parseInt(versionChar, 16);
+}
+/**
+ * Warn if a UUID is not version 7.
+ *
+ * @param uuidStr - The UUID string to check
+ * @param idType - The type of ID (e.g., "run_id", "trace_id") for the warning message
+ */
+export function warnIfNotUuidV7(uuidStr, _idType) {
+    const version = getUuidVersion(uuidStr);
+    if (version !== null && version !== 7 && !UUID7_WARNING_EMITTED) {
+        UUID7_WARNING_EMITTED = true;
+        warnOnce(`LangSmith now uses UUID v7 for run and trace identifiers. ` +
+            `This warning appears when passing custom IDs. ` +
+            `Please use: import { uuidv7 } from 'langsmith'; const id = uuidv7(); ` +
+            `Future versions will require UUID v7.`);
+    }
+}

package/dist/uuid.cjs

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uuid7FromTime = void 0;
+exports.uuid7 = uuid7;
+const uuid_1 = require("uuid");
+var _uuid_js_1 = require("./utils/_uuid.cjs");
+Object.defineProperty(exports, "uuid7FromTime", { enumerable: true, get: function () { return _uuid_js_1.uuid7FromTime; } });
+/**
+ * Generate a random UUID v7 string.
+ */
+function uuid7() {
+    return (0, uuid_1.v7)();
+}

package/dist/uuid.d.ts

@@ -0,0 +1,5 @@
+export { uuid7FromTime } from "./utils/_uuid.js";
+/**
+ * Generate a random UUID v7 string.
+ */
+export declare function uuid7(): string;

package/dist/uuid.js

@@ -0,0 +1,8 @@
+import { v7 as uuidv7 } from "uuid";
+export { uuid7FromTime } from "./utils/_uuid.js";
+/**
+ * Generate a random UUID v7 string.
+ */
+export function uuid7() {
+    return uuidv7();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.3.78",
+  "version": "0.3.79-rc.0",
   "description": "Client library to connect to the LangSmith Observability and Evaluation Platform.",
   "packageManager": "yarn@1.22.19",
   "files": [