langsmith 0.3.79 → 0.3.80-rc.1

package/dist/client.cjs

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Client = exports.DEFAULT_UNCOMPRESSED_BATCH_SIZE_LIMIT_BYTES = exports.AutoBatchQueue = void 0;
+exports.Client = exports.AutoBatchQueue = exports.DEFAULT_MAX_SIZE_BYTES = exports.DEFAULT_UNCOMPRESSED_BATCH_SIZE_LIMIT_BYTES = void 0;
 exports.mergeRuntimeEnvIntoRun = mergeRuntimeEnvIntoRun;
 const uuid = __importStar(require("uuid"));
 const translator_js_1 = require("./experimental/otel/translator.cjs");
@@ -125,8 +125,15 @@ function _formatFeedbackScore(score) {
     }
     return score;
 }
+exports.DEFAULT_UNCOMPRESSED_BATCH_SIZE_LIMIT_BYTES = 24 * 1024 * 1024;
+/** Default maximum memory (1GB) for queue size limits. */
+exports.DEFAULT_MAX_SIZE_BYTES = 1024 * 1024 * 1024; // 1GB
+const SERVER_INFO_REQUEST_TIMEOUT_MS = 10000;
+/** Maximum number of operations to batch in a single request. */
+const DEFAULT_BATCH_SIZE_LIMIT = 100;
+const DEFAULT_API_URL = "https://api.smith.langchain.com";
 class AutoBatchQueue {
-    constructor() {
+    constructor(maxSizeBytes) {
         Object.defineProperty(this, "items", {
             enumerable: true,
             configurable: true,
@@ -139,6 +146,13 @@ class AutoBatchQueue {
             writable: true,
             value: 0
         });
+        Object.defineProperty(this, "maxSizeBytes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.maxSizeBytes = maxSizeBytes ?? exports.DEFAULT_MAX_SIZE_BYTES;
     }
     peek() {
         return this.items[0];
@@ -151,6 +165,15 @@ class AutoBatchQueue {
             itemPromiseResolve = resolve;
         });
         const size = (0, index_js_2.serialize)(item.item, `Serializing run with id: ${item.item.id}`).length;
+        // Check if adding this item would exceed the size limit
+        // Allow the run if the queue is empty (to support large single traces)
+        if (this.sizeBytes + size > this.maxSizeBytes && this.items.length > 0) {
+            console.warn(`AutoBatchQueue size limit (${this.maxSizeBytes} bytes) exceeded. Dropping run with id: ${item.item.id}. ` +
+                `Current queue size: ${this.sizeBytes} bytes, attempted addition: ${size} bytes.`);
+            // Resolve immediately to avoid blocking caller
+            itemPromiseResolve();
+            return itemPromise;
+        }
         this.items.push({
             action: item.action,
             payload: item.item,
@@ -197,17 +220,13 @@ class AutoBatchQueue {
                 otelContext: it.otelContext,
                 apiKey: it.apiKey,
                 apiUrl: it.apiUrl,
+                size: it.size,
             })),
             () => popped.forEach((it) => it.itemPromiseResolve()),
         ];
     }
 }
 exports.AutoBatchQueue = AutoBatchQueue;
-exports.DEFAULT_UNCOMPRESSED_BATCH_SIZE_LIMIT_BYTES = 24 * 1024 * 1024;
-const SERVER_INFO_REQUEST_TIMEOUT_MS = 10000;
-/** Maximum number of operations to batch in a single request. */
-const DEFAULT_BATCH_SIZE_LIMIT = 100;
-const DEFAULT_API_URL = "https://api.smith.langchain.com";
 class Client {
     get _fetch() {
         return this.fetchImplementation || (0, fetch_js_1._getFetchImplementation)(this.debug);
@@ -295,7 +314,7 @@ class Client {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: new AutoBatchQueue()
+            value: void 0
         });
         Object.defineProperty(this, "autoBatchTimeout", {
             enumerable: true,
@@ -419,9 +438,12 @@ class Client {
         }
         this.debug = config.debug ?? this.debug;
         this.fetchImplementation = config.fetchImplementation;
+        // Use maxIngestMemoryBytes for both queues
+        const maxMemory = config.maxIngestMemoryBytes ?? exports.DEFAULT_MAX_SIZE_BYTES;
         this.batchIngestCaller = new async_caller_js_1.AsyncCaller({
             maxRetries: 2,
             maxConcurrency: this.traceBatchConcurrency,
+            maxQueueSizeBytes: maxMemory,
             ...(config.callerOptions ?? {}),
             onFailedResponseHook: handle429,
             debug: config.debug ?? this.debug,
@@ -431,6 +453,7 @@ class Client {
         this.hideOutputs =
             config.hideOutputs ?? config.anonymizer ?? defaultConfig.hideOutputs;
         this.autoBatchTracing = config.autoBatchTracing ?? this.autoBatchTracing;
+        this.autoBatchQueue = new AutoBatchQueue(maxMemory);
         this.blockOnRootRunFinalization =
             config.blockOnRootRunFinalization ?? this.blockOnRootRunFinalization;
         this.batchSizeBytesLimit = config.batchSizeBytesLimit;
@@ -731,6 +754,8 @@ class Client {
         if (!batch.length) {
             return;
         }
+        // Calculate total batch size for queue tracking
+        const batchSizeBytes = batch.reduce((sum, item) => sum + (item.size ?? 0), 0);
         try {
             if (this.langSmithToOTELTranslator !== undefined) {
                 this._sendBatchToOTELTranslator(batch);
@@ -747,10 +772,17 @@ class Client {
                 const serverInfo = await this._ensureServerInfo();
                 if (serverInfo?.batch_ingest_config?.use_multipart_endpoint) {
                     const useGzip = serverInfo?.instance_flags?.gzip_body_enabled;
-                    await this.multipartIngestRuns(ingestParams, { ...options, useGzip });
+                    await this.multipartIngestRuns(ingestParams, {
+                        ...options,
+                        useGzip,
+                        sizeBytes: batchSizeBytes,
+                    });
                 }
                 else {
-                    await this.batchIngestRuns(ingestParams, options);
+                    await this.batchIngestRuns(ingestParams, {
+                        ...options,
+                        sizeBytes: batchSizeBytes,
+                    });
                 }
             }
         }
@@ -1002,7 +1034,7 @@ class Client {
         if (options?.apiKey !== undefined) {
             headers["x-api-key"] = options.apiKey;
         }
-        await this.batchIngestCaller.call(async () => {
+        await this.batchIngestCaller.callWithOptions({ sizeBytes: options?.sizeBytes }, async () => {
             const res = await this._fetch(`${options?.apiUrl ?? this.apiUrl}/runs/batch`, {
                 method: "POST",
                 headers,
@@ -1217,7 +1249,7 @@ class Client {
         const buildBuffered = () => this._createNodeFetchBody(parts, boundary);
         const buildStream = () => this._createMultipartStream(parts, boundary);
         const sendWithRetry = async (bodyFactory) => {
-            return this.batchIngestCaller.call(async () => {
+            return this.batchIngestCaller.callWithOptions({ sizeBytes: options?.sizeBytes }, async () => {
                 const body = await bodyFactory();
                 const headers = {
                     ...this.headers,

package/dist/client.d.ts

@@ -16,6 +16,11 @@ export interface ClientConfig {
     batchSizeBytesLimit?: number;
     /** Maximum number of operations to batch in a single request. */
     batchSizeLimit?: number;
+    /**
+     * Maximum total memory (in bytes) for both the AutoBatchQueue and batchIngestCaller queue.
+     * When exceeded, runs/batches are dropped. Defaults to 1GB.
+     */
+    maxIngestMemoryBytes?: number;
     blockOnRootRunFinalization?: boolean;
     traceBatchConcurrency?: number;
     fetchOptions?: RequestInit;
@@ -258,6 +263,7 @@ type AutoBatchQueueItem = {
     otelContext?: OTELContext;
     apiKey?: string;
     apiUrl?: string;
+    size?: number;
 };
 type Thread = {
     filter: string;
@@ -275,6 +281,9 @@ type Thread = {
     last_error: string | null;
 };
 export declare function mergeRuntimeEnvIntoRun<T extends RunCreate | RunUpdate>(run: T, cachedEnvVars?: Record<string, string>): T;
+export declare const DEFAULT_UNCOMPRESSED_BATCH_SIZE_LIMIT_BYTES: number;
+/** Default maximum memory (1GB) for queue size limits. */
+export declare const DEFAULT_MAX_SIZE_BYTES: number;
 export declare class AutoBatchQueue {
     items: {
         action: "create" | "update";
@@ -287,6 +296,8 @@ export declare class AutoBatchQueue {
         apiUrl?: string;
     }[];
     sizeBytes: number;
+    private maxSizeBytes;
+    constructor(maxSizeBytes?: number);
     peek(): {
         action: "create" | "update";
         payload: RunCreate | RunUpdate;
@@ -303,7 +314,6 @@ export declare class AutoBatchQueue {
         upToSize: number;
     }): [AutoBatchQueueItem[], () => void];
 }
-export declare const DEFAULT_UNCOMPRESSED_BATCH_SIZE_LIMIT_BYTES: number;
 export declare class Client implements LangSmithTracingClientInterface {
     private apiKey?;
     private apiUrl;
@@ -389,6 +399,7 @@ export declare class Client implements LangSmithTracingClientInterface {
     }, options?: {
         apiKey?: string;
         apiUrl?: string;
+        sizeBytes?: number;
     }): Promise<void>;
     private _postBatchIngestRuns;
     /**
@@ -402,6 +413,7 @@ export declare class Client implements LangSmithTracingClientInterface {
         apiKey?: string;
         apiUrl?: string;
         useGzip?: boolean;
+        sizeBytes?: number;
     }): Promise<void>;
     private _createNodeFetchBody;
     private _createMultipartStream;

package/dist/client.js

@@ -88,8 +88,15 @@ function _formatFeedbackScore(score) {
     }
     return score;
 }
+export const DEFAULT_UNCOMPRESSED_BATCH_SIZE_LIMIT_BYTES = 24 * 1024 * 1024;
+/** Default maximum memory (1GB) for queue size limits. */
+export const DEFAULT_MAX_SIZE_BYTES = 1024 * 1024 * 1024; // 1GB
+const SERVER_INFO_REQUEST_TIMEOUT_MS = 10000;
+/** Maximum number of operations to batch in a single request. */
+const DEFAULT_BATCH_SIZE_LIMIT = 100;
+const DEFAULT_API_URL = "https://api.smith.langchain.com";
 export class AutoBatchQueue {
-    constructor() {
+    constructor(maxSizeBytes) {
         Object.defineProperty(this, "items", {
             enumerable: true,
             configurable: true,
@@ -102,6 +109,13 @@ export class AutoBatchQueue {
             writable: true,
             value: 0
         });
+        Object.defineProperty(this, "maxSizeBytes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.maxSizeBytes = maxSizeBytes ?? DEFAULT_MAX_SIZE_BYTES;
     }
     peek() {
         return this.items[0];
@@ -114,6 +128,15 @@ export class AutoBatchQueue {
             itemPromiseResolve = resolve;
         });
         const size = serializePayloadForTracing(item.item, `Serializing run with id: ${item.item.id}`).length;
+        // Check if adding this item would exceed the size limit
+        // Allow the run if the queue is empty (to support large single traces)
+        if (this.sizeBytes + size > this.maxSizeBytes && this.items.length > 0) {
+            console.warn(`AutoBatchQueue size limit (${this.maxSizeBytes} bytes) exceeded. Dropping run with id: ${item.item.id}. ` +
+                `Current queue size: ${this.sizeBytes} bytes, attempted addition: ${size} bytes.`);
+            // Resolve immediately to avoid blocking caller
+            itemPromiseResolve();
+            return itemPromise;
+        }
         this.items.push({
             action: item.action,
             payload: item.item,
@@ -160,16 +183,12 @@ export class AutoBatchQueue {
                 otelContext: it.otelContext,
                 apiKey: it.apiKey,
                 apiUrl: it.apiUrl,
+                size: it.size,
             })),
             () => popped.forEach((it) => it.itemPromiseResolve()),
         ];
     }
 }
-export const DEFAULT_UNCOMPRESSED_BATCH_SIZE_LIMIT_BYTES = 24 * 1024 * 1024;
-const SERVER_INFO_REQUEST_TIMEOUT_MS = 10000;
-/** Maximum number of operations to batch in a single request. */
-const DEFAULT_BATCH_SIZE_LIMIT = 100;
-const DEFAULT_API_URL = "https://api.smith.langchain.com";
 export class Client {
     get _fetch() {
         return this.fetchImplementation || _getFetchImplementation(this.debug);
@@ -257,7 +276,7 @@ export class Client {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: new AutoBatchQueue()
+            value: void 0
         });
         Object.defineProperty(this, "autoBatchTimeout", {
             enumerable: true,
@@ -381,9 +400,12 @@ export class Client {
         }
         this.debug = config.debug ?? this.debug;
         this.fetchImplementation = config.fetchImplementation;
+        // Use maxIngestMemoryBytes for both queues
+        const maxMemory = config.maxIngestMemoryBytes ?? DEFAULT_MAX_SIZE_BYTES;
         this.batchIngestCaller = new AsyncCaller({
             maxRetries: 2,
             maxConcurrency: this.traceBatchConcurrency,
+            maxQueueSizeBytes: maxMemory,
             ...(config.callerOptions ?? {}),
             onFailedResponseHook: handle429,
             debug: config.debug ?? this.debug,
@@ -393,6 +415,7 @@ export class Client {
         this.hideOutputs =
             config.hideOutputs ?? config.anonymizer ?? defaultConfig.hideOutputs;
         this.autoBatchTracing = config.autoBatchTracing ?? this.autoBatchTracing;
+        this.autoBatchQueue = new AutoBatchQueue(maxMemory);
         this.blockOnRootRunFinalization =
             config.blockOnRootRunFinalization ?? this.blockOnRootRunFinalization;
         this.batchSizeBytesLimit = config.batchSizeBytesLimit;
@@ -693,6 +716,8 @@ export class Client {
         if (!batch.length) {
             return;
         }
+        // Calculate total batch size for queue tracking
+        const batchSizeBytes = batch.reduce((sum, item) => sum + (item.size ?? 0), 0);
         try {
             if (this.langSmithToOTELTranslator !== undefined) {
                 this._sendBatchToOTELTranslator(batch);
@@ -709,10 +734,17 @@ export class Client {
                 const serverInfo = await this._ensureServerInfo();
                 if (serverInfo?.batch_ingest_config?.use_multipart_endpoint) {
                     const useGzip = serverInfo?.instance_flags?.gzip_body_enabled;
-                    await this.multipartIngestRuns(ingestParams, { ...options, useGzip });
+                    await this.multipartIngestRuns(ingestParams, {
+                        ...options,
+                        useGzip,
+                        sizeBytes: batchSizeBytes,
+                    });
                 }
                 else {
-                    await this.batchIngestRuns(ingestParams, options);
+                    await this.batchIngestRuns(ingestParams, {
+                        ...options,
+                        sizeBytes: batchSizeBytes,
+                    });
                 }
             }
         }
@@ -964,7 +996,7 @@ export class Client {
         if (options?.apiKey !== undefined) {
             headers["x-api-key"] = options.apiKey;
         }
-        await this.batchIngestCaller.call(async () => {
+        await this.batchIngestCaller.callWithOptions({ sizeBytes: options?.sizeBytes }, async () => {
             const res = await this._fetch(`${options?.apiUrl ?? this.apiUrl}/runs/batch`, {
                 method: "POST",
                 headers,
@@ -1179,7 +1211,7 @@ export class Client {
         const buildBuffered = () => this._createNodeFetchBody(parts, boundary);
         const buildStream = () => this._createMultipartStream(parts, boundary);
         const sendWithRetry = async (bodyFactory) => {
-            return this.batchIngestCaller.call(async () => {
+            return this.batchIngestCaller.callWithOptions({ sizeBytes: options?.sizeBytes }, async () => {
                 const body = await bodyFactory();
                 const headers = {
                     ...this.headers,

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.79";
+exports.__version__ = "0.3.80-rc.1";

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.79";
+export { uuid7, uuid7FromTime } from "./uuid.js";
+export declare const __version__ = "0.3.80-rc.1";

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.79";
+export const __version__ = "0.3.80-rc.1";

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/utils/async_caller.cjs

@@ -40,6 +40,12 @@ class AsyncCaller {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "maxQueueSizeBytes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "queue", {
             enumerable: true,
             configurable: true,
@@ -52,8 +58,15 @@ class AsyncCaller {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "queueSizeBytes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
         this.maxConcurrency = params.maxConcurrency ?? Infinity;
         this.maxRetries = params.maxRetries ?? 6;
+        this.maxQueueSizeBytes = params.maxQueueSizeBytes ?? Infinity;
         if ("default" in p_queue_1.default) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             this.queue = new p_queue_1.default.default({
@@ -68,8 +81,25 @@ class AsyncCaller {
     }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     call(callable, ...args) {
+        return this.callWithOptions({}, callable, ...args);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    callWithOptions(options, callable, ...args) {
+        const sizeBytes = options.sizeBytes ?? 0;
+        // Check if adding this call would exceed the byte size limit
+        if (this.maxQueueSizeBytes !== undefined &&
+            this.maxQueueSizeBytes !== Infinity &&
+            sizeBytes > 0 &&
+            this.queueSizeBytes + sizeBytes > this.maxQueueSizeBytes) {
+            return Promise.reject(new Error(`Queue size limit (${this.maxQueueSizeBytes} bytes) exceeded. ` +
+                `Current queue size: ${this.queueSizeBytes} bytes, attempted addition: ${sizeBytes} bytes.`));
+        }
+        // Add to queue size tracking
+        if (sizeBytes > 0) {
+            this.queueSizeBytes += sizeBytes;
+        }
         const onFailedResponseHook = this.onFailedResponseHook;
-        return this.queue.add(() => (0, p_retry_1.default)(() => callable(...args).catch((error) => {
+        let promise = this.queue.add(() => (0, p_retry_1.default)(() => callable(...args).catch((error) => {
             // eslint-disable-next-line no-instanceof/no-instanceof
             if (error instanceof Error) {
                 throw error;
@@ -106,14 +136,16 @@ class AsyncCaller {
             retries: this.maxRetries,
             randomize: true,
         }), { throwOnTimeout: true });
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    callWithOptions(options, callable, ...args) {
-        // Note this doesn't cancel the underlying request,
-        // when available prefer to use the signal option of the underlying call
+        // Decrement queue size when the call completes (success or failure)
+        if (sizeBytes > 0) {
+            promise = promise.finally(() => {
+                this.queueSizeBytes -= sizeBytes;
+            });
+        }
+        // Handle signal cancellation
         if (options.signal) {
             return Promise.race([
-                this.call(callable, ...args),
+                promise,
                 new Promise((_, reject) => {
                     options.signal?.addEventListener("abort", () => {
                         reject(new Error("AbortError"));
@@ -121,7 +153,7 @@ class AsyncCaller {
                 }),
             ]);
         }
-        return this.call(callable, ...args);
+        return promise;
     }
 }
 exports.AsyncCaller = AsyncCaller;

package/dist/utils/async_caller.d.ts

@@ -10,11 +10,22 @@ export interface AsyncCallerParams {
      * with an exponential backoff between each attempt. Defaults to 6.
      */
     maxRetries?: number;
+    /**
+     * The maximum size of the queue buffer in bytes. When the queue reaches this size,
+     * new calls will be dropped instead of queued.
+     * Defaults to `Infinity`, which means no limit.
+     */
+    maxQueueSizeBytes?: number;
     onFailedResponseHook?: ResponseCallback;
     debug?: boolean;
 }
 export interface AsyncCallerCallOptions {
     signal?: AbortSignal;
+    /**
+     * The size of this call in bytes, used for queue size tracking.
+     * If not provided, size tracking is skipped for this call.
+     */
+    sizeBytes?: number;
 }
 /**
  * A class that can be used to make async calls with concurrency and retry logic.
@@ -32,8 +43,10 @@ export interface AsyncCallerCallOptions {
 export declare class AsyncCaller {
     protected maxConcurrency: AsyncCallerParams["maxConcurrency"];
     protected maxRetries: AsyncCallerParams["maxRetries"];
+    protected maxQueueSizeBytes: AsyncCallerParams["maxQueueSizeBytes"];
     queue: typeof import("p-queue")["default"]["prototype"];
     private onFailedResponseHook?;
+    private queueSizeBytes;
     constructor(params: AsyncCallerParams);
     call<A extends any[], T extends (...args: A) => Promise<any>>(callable: T, ...args: Parameters<T>): Promise<Awaited<ReturnType<T>>>;
     callWithOptions<A extends any[], T extends (...args: A) => Promise<any>>(options: AsyncCallerCallOptions, callable: T, ...args: Parameters<T>): Promise<Awaited<ReturnType<T>>>;

package/dist/utils/async_caller.js

@@ -34,6 +34,12 @@ export class AsyncCaller {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "maxQueueSizeBytes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "queue", {
             enumerable: true,
             configurable: true,
@@ -46,8 +52,15 @@ export class AsyncCaller {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "queueSizeBytes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
         this.maxConcurrency = params.maxConcurrency ?? Infinity;
         this.maxRetries = params.maxRetries ?? 6;
+        this.maxQueueSizeBytes = params.maxQueueSizeBytes ?? Infinity;
         if ("default" in PQueueMod) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             this.queue = new PQueueMod.default({
@@ -62,8 +75,25 @@ export class AsyncCaller {
     }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     call(callable, ...args) {
+        return this.callWithOptions({}, callable, ...args);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    callWithOptions(options, callable, ...args) {
+        const sizeBytes = options.sizeBytes ?? 0;
+        // Check if adding this call would exceed the byte size limit
+        if (this.maxQueueSizeBytes !== undefined &&
+            this.maxQueueSizeBytes !== Infinity &&
+            sizeBytes > 0 &&
+            this.queueSizeBytes + sizeBytes > this.maxQueueSizeBytes) {
+            return Promise.reject(new Error(`Queue size limit (${this.maxQueueSizeBytes} bytes) exceeded. ` +
+                `Current queue size: ${this.queueSizeBytes} bytes, attempted addition: ${sizeBytes} bytes.`));
+        }
+        // Add to queue size tracking
+        if (sizeBytes > 0) {
+            this.queueSizeBytes += sizeBytes;
+        }
         const onFailedResponseHook = this.onFailedResponseHook;
-        return this.queue.add(() => pRetry(() => callable(...args).catch((error) => {
+        let promise = this.queue.add(() => pRetry(() => callable(...args).catch((error) => {
             // eslint-disable-next-line no-instanceof/no-instanceof
             if (error instanceof Error) {
                 throw error;
@@ -100,14 +130,16 @@ export class AsyncCaller {
             retries: this.maxRetries,
             randomize: true,
         }), { throwOnTimeout: true });
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    callWithOptions(options, callable, ...args) {
-        // Note this doesn't cancel the underlying request,
-        // when available prefer to use the signal option of the underlying call
+        // Decrement queue size when the call completes (success or failure)
+        if (sizeBytes > 0) {
+            promise = promise.finally(() => {
+                this.queueSizeBytes -= sizeBytes;
+            });
+        }
+        // Handle signal cancellation
         if (options.signal) {
             return Promise.race([
-                this.call(callable, ...args),
+                promise,
                 new Promise((_, reject) => {
                     options.signal?.addEventListener("abort", () => {
                         reject(new Error("AbortError"));
@@ -115,6 +147,6 @@ export class AsyncCaller {
                 }),
             ]);
         }
-        return this.call(callable, ...args);
+        return promise;
     }
 }

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.79",
+  "version": "0.3.80-rc.1",
   "description": "Client library to connect to the LangSmith Observability and Evaluation Platform.",
   "packageManager": "yarn@1.22.19",
   "files": [