langsmith 0.3.28 → 0.3.29

package/dist/client.cjs

@@ -145,7 +145,7 @@ class AutoBatchQueue {
             // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/Promise
             itemPromiseResolve = resolve;
         });
-        const size = (0, index_js_2.serialize)(item.item).length;
+        const size = (0, index_js_2.serialize)(item.item, `Serializing run with id: ${item.item.id}`).length;
         this.items.push({
             action: item.action,
             payload: item.item,
@@ -736,7 +736,7 @@ class Client {
         const response = await this.caller.call((0, fetch_js_1._getFetchImplementation)(this.debug), `${this.apiUrl}/runs`, {
             method: "POST",
             headers,
-            body: (0, index_js_2.serialize)(mergedRunCreateParam),
+            body: (0, index_js_2.serialize)(mergedRunCreateParam, `Creating run with id: ${mergedRunCreateParam.id}`),
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
@@ -797,7 +797,11 @@ class Client {
             }
         }
         if (batchChunks.post.length > 0 || batchChunks.patch.length > 0) {
-            await this._postBatchIngestRuns((0, index_js_2.serialize)(batchChunks));
+            const runIds = batchChunks.post
+                .map((item) => item.id)
+                .concat(batchChunks.patch.map((item) => item.id))
+                .join(",");
+            await this._postBatchIngestRuns((0, index_js_2.serialize)(batchChunks, `Ingesting runs with ids: ${runIds}`));
         }
     }
     async _postBatchIngestRuns(body) {
@@ -892,7 +896,7 @@ class Client {
                 const { inputs, outputs, events, attachments, ...payload } = originalPayload;
                 const fields = { inputs, outputs, events };
                 // encode the main run payload
-                const stringifiedPayload = (0, index_js_2.serialize)(payload);
+                const stringifiedPayload = (0, index_js_2.serialize)(payload, `Serializing for multipart ingestion of run with id: ${payload.id}`);
                 accumulatedParts.push({
                     name: `${method}.${payload.id}`,
                     payload: new Blob([stringifiedPayload], {
@@ -904,7 +908,7 @@ class Client {
                     if (value === undefined) {
                         continue;
                     }
-                    const stringifiedValue = (0, index_js_2.serialize)(value);
+                    const stringifiedValue = (0, index_js_2.serialize)(value, `Serializing ${key} for multipart ingestion of run with id: ${payload.id}`);
                     accumulatedParts.push({
                         name: `${method}.${payload.id}.${key}`,
                         payload: new Blob([stringifiedValue], {
@@ -948,34 +952,84 @@ class Client {
         }
         await this._sendMultipartRequest(accumulatedParts, accumulatedContext.join("; "));
     }
+    async _createNodeFetchBody(parts, boundary) {
+        // Create multipart form data manually using Blobs
+        const chunks = [];
+        for (const part of parts) {
+            // Add field boundary
+            chunks.push(new Blob([`--${boundary}\r\n`]));
+            chunks.push(new Blob([
+                `Content-Disposition: form-data; name="${part.name}"\r\n`,
+                `Content-Type: ${part.payload.type}\r\n\r\n`,
+            ]));
+            chunks.push(part.payload);
+            chunks.push(new Blob(["\r\n"]));
+        }
+        // Add final boundary
+        chunks.push(new Blob([`--${boundary}--\r\n`]));
+        // Combine all chunks into a single Blob
+        const body = new Blob(chunks);
+        // Convert Blob to ArrayBuffer for compatibility
+        const arrayBuffer = await body.arrayBuffer();
+        return arrayBuffer;
+    }
+    async _createMultipartStream(parts, boundary) {
+        const encoder = new TextEncoder();
+        // Create a ReadableStream for streaming the multipart data
+        // Only do special handling if we're using node-fetch
+        const stream = new ReadableStream({
+            async start(controller) {
+                // Helper function to write a chunk to the stream
+                const writeChunk = async (chunk) => {
+                    if (typeof chunk === "string") {
+                        controller.enqueue(encoder.encode(chunk));
+                    }
+                    else {
+                        controller.enqueue(chunk);
+                    }
+                };
+                // Write each part to the stream
+                for (const part of parts) {
+                    // Write boundary and headers
+                    await writeChunk(`--${boundary}\r\n`);
+                    await writeChunk(`Content-Disposition: form-data; name="${part.name}"\r\n`);
+                    await writeChunk(`Content-Type: ${part.payload.type}\r\n\r\n`);
+                    // Write the payload
+                    const payloadStream = part.payload.stream();
+                    const reader = payloadStream.getReader();
+                    try {
+                        let result;
+                        while (!(result = await reader.read()).done) {
+                            controller.enqueue(result.value);
+                        }
+                    }
+                    finally {
+                        reader.releaseLock();
+                    }
+                    await writeChunk("\r\n");
+                }
+                // Write final boundary
+                await writeChunk(`--${boundary}--\r\n`);
+                controller.close();
+            },
+        });
+        return stream;
+    }
     async _sendMultipartRequest(parts, context) {
         try {
-            // Create multipart form data manually using Blobs
+            // Create multipart form data boundary
             const boundary = "----LangSmithFormBoundary" + Math.random().toString(36).slice(2);
-            const chunks = [];
-            for (const part of parts) {
-                // Add field boundary
-                chunks.push(new Blob([`--${boundary}\r\n`]));
-                chunks.push(new Blob([
-                    `Content-Disposition: form-data; name="${part.name}"\r\n`,
-                    `Content-Type: ${part.payload.type}\r\n\r\n`,
-                ]));
-                chunks.push(part.payload);
-                chunks.push(new Blob(["\r\n"]));
-            }
-            // Add final boundary
-            chunks.push(new Blob([`--${boundary}--\r\n`]));
-            // Combine all chunks into a single Blob
-            const body = new Blob(chunks);
-            // Convert Blob to ArrayBuffer for compatibility
-            const arrayBuffer = await body.arrayBuffer();
+            const body = await ((0, fetch_js_1._globalFetchImplementationIsNodeFetch)()
+                ? this._createNodeFetchBody(parts, boundary)
+                : this._createMultipartStream(parts, boundary));
             const res = await this.batchIngestCaller.call((0, fetch_js_1._getFetchImplementation)(this.debug), `${this.apiUrl}/runs/multipart`, {
                 method: "POST",
                 headers: {
                     ...this.headers,
                     "Content-Type": `multipart/form-data; boundary=${boundary}`,
                 },
-                body: arrayBuffer,
+                body,
+                duplex: "half",
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -1020,7 +1074,7 @@ class Client {
         const response = await this.caller.call((0, fetch_js_1._getFetchImplementation)(this.debug), `${this.apiUrl}/runs/${runId}`, {
             method: "PATCH",
             headers,
-            body: (0, index_js_2.serialize)(run),
+            body: (0, index_js_2.serialize)(run, `Serializing payload to update run with id: ${runId}`),
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
@@ -1491,7 +1545,9 @@ class Client {
         const result = await response.json();
         if (!response.ok) {
             if ("detail" in result) {
-                throw new Error(`Failed to list shared examples.\nStatus: ${response.status}\nMessage: ${result.detail.join("\n")}`);
+                throw new Error(`Failed to list shared examples.\nStatus: ${response.status}\nMessage: ${Array.isArray(result.detail)
+                    ? result.detail.join("\n")
+                    : "Unspecified error"}`);
             }
             throw new Error(`Failed to list shared examples: ${response.status} ${response.statusText}`);
         }
@@ -3006,14 +3062,14 @@ class Client {
                 ...(example.split && { split: example.split }),
             };
             // Add main example data
-            const stringifiedExample = (0, index_js_2.serialize)(exampleBody);
+            const stringifiedExample = (0, index_js_2.serialize)(exampleBody, `Serializing body for example with id: ${exampleId}`);
             const exampleBlob = new Blob([stringifiedExample], {
                 type: "application/json",
             });
             formData.append(exampleId, exampleBlob);
             // Add inputs if present
             if (example.inputs) {
-                const stringifiedInputs = (0, index_js_2.serialize)(example.inputs);
+                const stringifiedInputs = (0, index_js_2.serialize)(example.inputs, `Serializing inputs for example with id: ${exampleId}`);
                 const inputsBlob = new Blob([stringifiedInputs], {
                     type: "application/json",
                 });
@@ -3021,7 +3077,7 @@ class Client {
             }
             // Add outputs if present
             if (example.outputs) {
-                const stringifiedOutputs = (0, index_js_2.serialize)(example.outputs);
+                const stringifiedOutputs = (0, index_js_2.serialize)(example.outputs, `Serializing outputs whle updating example with id: ${exampleId}`);
                 const outputsBlob = new Blob([stringifiedOutputs], {
                     type: "application/json",
                 });
@@ -3046,7 +3102,7 @@ class Client {
                 }
             }
             if (example.attachments_operations) {
-                const stringifiedAttachmentsOperations = (0, index_js_2.serialize)(example.attachments_operations);
+                const stringifiedAttachmentsOperations = (0, index_js_2.serialize)(example.attachments_operations, `Serializing attachments while updating example with id: ${exampleId}`);
                 const attachmentsOperationsBlob = new Blob([stringifiedAttachmentsOperations], {
                     type: "application/json",
                 });
@@ -3092,14 +3148,14 @@ class Client {
                 }),
             };
             // Add main example data
-            const stringifiedExample = (0, index_js_2.serialize)(exampleBody);
+            const stringifiedExample = (0, index_js_2.serialize)(exampleBody, `Serializing body for uploaded example with id: ${exampleId}`);
             const exampleBlob = new Blob([stringifiedExample], {
                 type: "application/json",
             });
             formData.append(exampleId, exampleBlob);
             // Add inputs if present
             if (example.inputs) {
-                const stringifiedInputs = (0, index_js_2.serialize)(example.inputs);
+                const stringifiedInputs = (0, index_js_2.serialize)(example.inputs, `Serializing inputs for uploaded example with id: ${exampleId}`);
                 const inputsBlob = new Blob([stringifiedInputs], {
                     type: "application/json",
                 });
@@ -3107,7 +3163,7 @@ class Client {
             }
             // Add outputs if present
             if (example.outputs) {
-                const stringifiedOutputs = (0, index_js_2.serialize)(example.outputs);
+                const stringifiedOutputs = (0, index_js_2.serialize)(example.outputs, `Serializing outputs for uploaded example with id: ${exampleId}`);
                 const outputsBlob = new Blob([stringifiedOutputs], {
                     type: "application/json",
                 });

package/dist/client.d.ts

@@ -351,6 +351,8 @@ export declare class Client implements LangSmithTracingClientInterface {
         runCreates?: RunCreate[];
         runUpdates?: RunUpdate[];
     }): Promise<void>;
+    private _createNodeFetchBody;
+    private _createMultipartStream;
     private _sendMultipartRequest;
     updateRun(runId: string, run: RunUpdate): Promise<void>;
     readRun(runId: string, { loadChildRuns }?: {

package/dist/client.js

@@ -7,7 +7,7 @@ import { assertUuid } from "./utils/_uuid.js";
 import { warnOnce } from "./utils/warn.js";
 import { parsePromptIdentifier } from "./utils/prompts.js";
 import { raiseForStatus } from "./utils/error.js";
-import { _getFetchImplementation } from "./singletons/fetch.js";
+import { _globalFetchImplementationIsNodeFetch, _getFetchImplementation, } from "./singletons/fetch.js";
 import { serialize as serializePayloadForTracing } from "./utils/fast-safe-stringify/index.js";
 export function mergeRuntimeEnvIntoRunCreate(run) {
     const runtimeEnv = getRuntimeEnvironment();
@@ -108,7 +108,7 @@ export class AutoBatchQueue {
             // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/Promise
             itemPromiseResolve = resolve;
         });
-        const size = serializePayloadForTracing(item.item).length;
+        const size = serializePayloadForTracing(item.item, `Serializing run with id: ${item.item.id}`).length;
         this.items.push({
             action: item.action,
             payload: item.item,
@@ -698,7 +698,7 @@ export class Client {
         const response = await this.caller.call(_getFetchImplementation(this.debug), `${this.apiUrl}/runs`, {
             method: "POST",
             headers,
-            body: serializePayloadForTracing(mergedRunCreateParam),
+            body: serializePayloadForTracing(mergedRunCreateParam, `Creating run with id: ${mergedRunCreateParam.id}`),
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
@@ -759,7 +759,11 @@ export class Client {
             }
         }
         if (batchChunks.post.length > 0 || batchChunks.patch.length > 0) {
-            await this._postBatchIngestRuns(serializePayloadForTracing(batchChunks));
+            const runIds = batchChunks.post
+                .map((item) => item.id)
+                .concat(batchChunks.patch.map((item) => item.id))
+                .join(",");
+            await this._postBatchIngestRuns(serializePayloadForTracing(batchChunks, `Ingesting runs with ids: ${runIds}`));
         }
     }
     async _postBatchIngestRuns(body) {
@@ -854,7 +858,7 @@ export class Client {
                 const { inputs, outputs, events, attachments, ...payload } = originalPayload;
                 const fields = { inputs, outputs, events };
                 // encode the main run payload
-                const stringifiedPayload = serializePayloadForTracing(payload);
+                const stringifiedPayload = serializePayloadForTracing(payload, `Serializing for multipart ingestion of run with id: ${payload.id}`);
                 accumulatedParts.push({
                     name: `${method}.${payload.id}`,
                     payload: new Blob([stringifiedPayload], {
@@ -866,7 +870,7 @@ export class Client {
                     if (value === undefined) {
                         continue;
                     }
-                    const stringifiedValue = serializePayloadForTracing(value);
+                    const stringifiedValue = serializePayloadForTracing(value, `Serializing ${key} for multipart ingestion of run with id: ${payload.id}`);
                     accumulatedParts.push({
                         name: `${method}.${payload.id}.${key}`,
                         payload: new Blob([stringifiedValue], {
@@ -910,34 +914,84 @@ export class Client {
         }
         await this._sendMultipartRequest(accumulatedParts, accumulatedContext.join("; "));
     }
+    async _createNodeFetchBody(parts, boundary) {
+        // Create multipart form data manually using Blobs
+        const chunks = [];
+        for (const part of parts) {
+            // Add field boundary
+            chunks.push(new Blob([`--${boundary}\r\n`]));
+            chunks.push(new Blob([
+                `Content-Disposition: form-data; name="${part.name}"\r\n`,
+                `Content-Type: ${part.payload.type}\r\n\r\n`,
+            ]));
+            chunks.push(part.payload);
+            chunks.push(new Blob(["\r\n"]));
+        }
+        // Add final boundary
+        chunks.push(new Blob([`--${boundary}--\r\n`]));
+        // Combine all chunks into a single Blob
+        const body = new Blob(chunks);
+        // Convert Blob to ArrayBuffer for compatibility
+        const arrayBuffer = await body.arrayBuffer();
+        return arrayBuffer;
+    }
+    async _createMultipartStream(parts, boundary) {
+        const encoder = new TextEncoder();
+        // Create a ReadableStream for streaming the multipart data
+        // Only do special handling if we're using node-fetch
+        const stream = new ReadableStream({
+            async start(controller) {
+                // Helper function to write a chunk to the stream
+                const writeChunk = async (chunk) => {
+                    if (typeof chunk === "string") {
+                        controller.enqueue(encoder.encode(chunk));
+                    }
+                    else {
+                        controller.enqueue(chunk);
+                    }
+                };
+                // Write each part to the stream
+                for (const part of parts) {
+                    // Write boundary and headers
+                    await writeChunk(`--${boundary}\r\n`);
+                    await writeChunk(`Content-Disposition: form-data; name="${part.name}"\r\n`);
+                    await writeChunk(`Content-Type: ${part.payload.type}\r\n\r\n`);
+                    // Write the payload
+                    const payloadStream = part.payload.stream();
+                    const reader = payloadStream.getReader();
+                    try {
+                        let result;
+                        while (!(result = await reader.read()).done) {
+                            controller.enqueue(result.value);
+                        }
+                    }
+                    finally {
+                        reader.releaseLock();
+                    }
+                    await writeChunk("\r\n");
+                }
+                // Write final boundary
+                await writeChunk(`--${boundary}--\r\n`);
+                controller.close();
+            },
+        });
+        return stream;
+    }
     async _sendMultipartRequest(parts, context) {
         try {
-            // Create multipart form data manually using Blobs
+            // Create multipart form data boundary
             const boundary = "----LangSmithFormBoundary" + Math.random().toString(36).slice(2);
-            const chunks = [];
-            for (const part of parts) {
-                // Add field boundary
-                chunks.push(new Blob([`--${boundary}\r\n`]));
-                chunks.push(new Blob([
-                    `Content-Disposition: form-data; name="${part.name}"\r\n`,
-                    `Content-Type: ${part.payload.type}\r\n\r\n`,
-                ]));
-                chunks.push(part.payload);
-                chunks.push(new Blob(["\r\n"]));
-            }
-            // Add final boundary
-            chunks.push(new Blob([`--${boundary}--\r\n`]));
-            // Combine all chunks into a single Blob
-            const body = new Blob(chunks);
-            // Convert Blob to ArrayBuffer for compatibility
-            const arrayBuffer = await body.arrayBuffer();
+            const body = await (_globalFetchImplementationIsNodeFetch()
+                ? this._createNodeFetchBody(parts, boundary)
+                : this._createMultipartStream(parts, boundary));
             const res = await this.batchIngestCaller.call(_getFetchImplementation(this.debug), `${this.apiUrl}/runs/multipart`, {
                 method: "POST",
                 headers: {
                     ...this.headers,
                     "Content-Type": `multipart/form-data; boundary=${boundary}`,
                 },
-                body: arrayBuffer,
+                body,
+                duplex: "half",
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -982,7 +1036,7 @@ export class Client {
         const response = await this.caller.call(_getFetchImplementation(this.debug), `${this.apiUrl}/runs/${runId}`, {
             method: "PATCH",
             headers,
-            body: serializePayloadForTracing(run),
+            body: serializePayloadForTracing(run, `Serializing payload to update run with id: ${runId}`),
             signal: AbortSignal.timeout(this.timeout_ms),
             ...this.fetchOptions,
         });
@@ -1453,7 +1507,9 @@ export class Client {
         const result = await response.json();
         if (!response.ok) {
             if ("detail" in result) {
-                throw new Error(`Failed to list shared examples.\nStatus: ${response.status}\nMessage: ${result.detail.join("\n")}`);
+                throw new Error(`Failed to list shared examples.\nStatus: ${response.status}\nMessage: ${Array.isArray(result.detail)
+                    ? result.detail.join("\n")
+                    : "Unspecified error"}`);
             }
             throw new Error(`Failed to list shared examples: ${response.status} ${response.statusText}`);
         }
@@ -2968,14 +3024,14 @@ export class Client {
                 ...(example.split && { split: example.split }),
             };
             // Add main example data
-            const stringifiedExample = serializePayloadForTracing(exampleBody);
+            const stringifiedExample = serializePayloadForTracing(exampleBody, `Serializing body for example with id: ${exampleId}`);
             const exampleBlob = new Blob([stringifiedExample], {
                 type: "application/json",
             });
             formData.append(exampleId, exampleBlob);
             // Add inputs if present
             if (example.inputs) {
-                const stringifiedInputs = serializePayloadForTracing(example.inputs);
+                const stringifiedInputs = serializePayloadForTracing(example.inputs, `Serializing inputs for example with id: ${exampleId}`);
                 const inputsBlob = new Blob([stringifiedInputs], {
                     type: "application/json",
                 });
@@ -2983,7 +3039,7 @@ export class Client {
             }
             // Add outputs if present
             if (example.outputs) {
-                const stringifiedOutputs = serializePayloadForTracing(example.outputs);
+                const stringifiedOutputs = serializePayloadForTracing(example.outputs, `Serializing outputs whle updating example with id: ${exampleId}`);
                 const outputsBlob = new Blob([stringifiedOutputs], {
                     type: "application/json",
                 });
@@ -3008,7 +3064,7 @@ export class Client {
                 }
             }
             if (example.attachments_operations) {
-                const stringifiedAttachmentsOperations = serializePayloadForTracing(example.attachments_operations);
+                const stringifiedAttachmentsOperations = serializePayloadForTracing(example.attachments_operations, `Serializing attachments while updating example with id: ${exampleId}`);
                 const attachmentsOperationsBlob = new Blob([stringifiedAttachmentsOperations], {
                     type: "application/json",
                 });
@@ -3054,14 +3110,14 @@ export class Client {
                 }),
             };
             // Add main example data
-            const stringifiedExample = serializePayloadForTracing(exampleBody);
+            const stringifiedExample = serializePayloadForTracing(exampleBody, `Serializing body for uploaded example with id: ${exampleId}`);
             const exampleBlob = new Blob([stringifiedExample], {
                 type: "application/json",
             });
             formData.append(exampleId, exampleBlob);
             // Add inputs if present
             if (example.inputs) {
-                const stringifiedInputs = serializePayloadForTracing(example.inputs);
+                const stringifiedInputs = serializePayloadForTracing(example.inputs, `Serializing inputs for uploaded example with id: ${exampleId}`);
                 const inputsBlob = new Blob([stringifiedInputs], {
                     type: "application/json",
                 });
@@ -3069,7 +3125,7 @@ export class Client {
             }
             // Add outputs if present
             if (example.outputs) {
-                const stringifiedOutputs = serializePayloadForTracing(example.outputs);
+                const stringifiedOutputs = serializePayloadForTracing(example.outputs, `Serializing outputs for uploaded example with id: ${exampleId}`);
                 const outputsBlob = new Blob([stringifiedOutputs], {
                     type: "application/json",
                 });

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.28";
+exports.__version__ = "0.3.29";

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.28";
+export declare const __version__ = "0.3.29";

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.28";
+export const __version__ = "0.3.29";

package/dist/singletons/fetch.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._getFetchImplementation = exports.overrideFetchImplementation = void 0;
+exports._getFetchImplementation = exports._globalFetchImplementationIsNodeFetch = exports.overrideFetchImplementation = void 0;
 const env_js_1 = require("../utils/env.cjs");
 // Wrap the default fetch call due to issues with illegal invocations
 // in some environments:
@@ -18,6 +18,17 @@ const overrideFetchImplementation = (fetch) => {
     globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY] = fetch;
 };
 exports.overrideFetchImplementation = overrideFetchImplementation;
+const _globalFetchImplementationIsNodeFetch = () => {
+    const fetchImpl = globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY];
+    if (!fetchImpl)
+        return false;
+    // Check if the implementation has node-fetch specific properties
+    return (typeof fetchImpl === "function" &&
+        "Headers" in fetchImpl &&
+        "Request" in fetchImpl &&
+        "Response" in fetchImpl);
+};
+exports._globalFetchImplementationIsNodeFetch = _globalFetchImplementationIsNodeFetch;
 /**
  * @internal
  */

package/dist/singletons/fetch.d.ts

@@ -5,3 +5,4 @@
  * @param fetch The new fetch functino to use.
  */
 export declare const overrideFetchImplementation: (fetch: (...args: any[]) => any) => void;
+export declare const _globalFetchImplementationIsNodeFetch: () => boolean;

package/dist/singletons/fetch.js

@@ -14,6 +14,16 @@ const LANGSMITH_FETCH_IMPLEMENTATION_KEY = Symbol.for("ls:fetch_implementation")
 export const overrideFetchImplementation = (fetch) => {
     globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY] = fetch;
 };
+export const _globalFetchImplementationIsNodeFetch = () => {
+    const fetchImpl = globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY];
+    if (!fetchImpl)
+        return false;
+    // Check if the implementation has node-fetch specific properties
+    return (typeof fetchImpl === "function" &&
+        "Headers" in fetchImpl &&
+        "Request" in fetchImpl &&
+        "Response" in fetchImpl);
+};
 /**
  * @internal
  */

package/dist/singletons/traceable.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ROOT = exports.getCurrentRunTree = exports.AsyncLocalStorageProviderSingleton = void 0;
+exports.ROOT = exports.AsyncLocalStorageProviderSingleton = void 0;
+exports.getCurrentRunTree = getCurrentRunTree;
 exports.withRunTree = withRunTree;
 exports.isTraceableFunction = isTraceableFunction;
 const run_trees_js_1 = require("../run_trees.cjs");
@@ -28,24 +29,13 @@ class AsyncLocalStorageProvider {
     }
 }
 exports.AsyncLocalStorageProviderSingleton = new AsyncLocalStorageProvider();
-/**
- * Return the current run tree from within a traceable-wrapped function.
- * Will throw an error if called outside of a traceable function.
- *
- * @returns The run tree for the given context.
- */
-const getCurrentRunTree = () => {
+function getCurrentRunTree(permitAbsentRunTree = false) {
     const runTree = exports.AsyncLocalStorageProviderSingleton.getInstance().getStore();
-    if (!(0, run_trees_js_1.isRunTree)(runTree)) {
-        throw new Error([
-            "Could not get the current run tree.",
-            "",
-            "Please make sure you are calling this method within a traceable function and that tracing is enabled.",
-        ].join("\n"));
+    if (!permitAbsentRunTree && !(0, run_trees_js_1.isRunTree)(runTree)) {
+        throw new Error("Could not get the current run tree.\n\nPlease make sure you are calling this method within a traceable function and that tracing is enabled.");
     }
     return runTree;
-};
-exports.getCurrentRunTree = getCurrentRunTree;
+}
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function withRunTree(runTree, fn) {
     const storage = exports.AsyncLocalStorageProviderSingleton.getInstance();

package/dist/singletons/traceable.d.ts

@@ -15,7 +15,9 @@ export declare const AsyncLocalStorageProviderSingleton: AsyncLocalStorageProvid
  *
  * @returns The run tree for the given context.
  */
-export declare const getCurrentRunTree: () => RunTree;
+export declare function getCurrentRunTree(): RunTree;
+export declare function getCurrentRunTree(permitAbsentRunTree: false): RunTree;
+export declare function getCurrentRunTree(permitAbsentRunTree: boolean): RunTree | undefined;
 export declare function withRunTree<Fn extends (...args: any[]) => any>(runTree: RunTree, fn: Fn): Promise<Awaited<ReturnType<Fn>>>;
 export declare const ROOT: unique symbol;
 export declare function isTraceableFunction(x: unknown): x is TraceableFunction<any>;

package/dist/singletons/traceable.js

@@ -23,23 +23,13 @@ class AsyncLocalStorageProvider {
     }
 }
 export const AsyncLocalStorageProviderSingleton = new AsyncLocalStorageProvider();
-/**
- * Return the current run tree from within a traceable-wrapped function.
- * Will throw an error if called outside of a traceable function.
- *
- * @returns The run tree for the given context.
- */
-export const getCurrentRunTree = () => {
+export function getCurrentRunTree(permitAbsentRunTree = false) {
     const runTree = AsyncLocalStorageProviderSingleton.getInstance().getStore();
-    if (!isRunTree(runTree)) {
-        throw new Error([
-            "Could not get the current run tree.",
-            "",
-            "Please make sure you are calling this method within a traceable function and that tracing is enabled.",
-        ].join("\n"));
+    if (!permitAbsentRunTree && !isRunTree(runTree)) {
+        throw new Error("Could not get the current run tree.\n\nPlease make sure you are calling this method within a traceable function and that tracing is enabled.");
     }
     return runTree;
-};
+}
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function withRunTree(runTree, fn) {
     const storage = AsyncLocalStorageProviderSingleton.getInstance();

package/dist/traceable.d.ts

@@ -15,7 +15,7 @@ import { TraceableFunction } from "./singletons/types.js";
  * @param config Additional metadata such as name, tags or providing
  *     a custom LangSmith client instance
  */
-export declare function traceable<Func extends (...args: any[]) => any>(wrappedFunc: Func, config?: Partial<RunTreeConfig> & {
+export declare function traceable<Func extends (...args: any[]) => any>(wrappedFunc: Func, config?: Partial<Omit<RunTreeConfig, "inputs" | "outputs">> & {
     aggregator?: (args: any[]) => any;
     argsConfigPath?: [number] | [number, string];
     __finalTracedIteratorKey?: string;

package/dist/utils/fast-safe-stringify/index.cjs

@@ -18,7 +18,7 @@ function encodeString(str) {
     return encoder.encode(str);
 }
 // Regular stringify
-function serialize(obj, replacer, spacer, options) {
+function serialize(obj, errorContext, replacer, spacer, options) {
     try {
         const str = JSON.stringify(obj, replacer, spacer);
         return encodeString(str);
@@ -26,10 +26,10 @@ function serialize(obj, replacer, spacer, options) {
     catch (e) {
         // Fall back to more complex stringify if circular reference
         if (!e.message?.includes("Converting circular structure to JSON")) {
-            console.warn("[WARNING]: LangSmith received unserializable value.");
+            console.warn(`[WARNING]: LangSmith received unserializable value.${errorContext ? `\nContext: ${errorContext}` : ""}`);
             return encodeString("[Unserializable]");
         }
-        console.warn("[WARNING]: LangSmith received circular JSON. This will decrease tracer performance.");
+        console.warn(`[WARNING]: LangSmith received circular JSON. This will decrease tracer performance. ${errorContext ? `\nContext: ${errorContext}` : ""}`);
         if (typeof options === "undefined") {
             options = defaultOptions();
         }

package/dist/utils/fast-safe-stringify/index.d.ts

@@ -1 +1 @@
-export declare function serialize(obj: any, replacer?: any, spacer?: any, options?: any): Uint8Array<ArrayBufferLike>;
+export declare function serialize(obj: any, errorContext?: any, replacer?: any, spacer?: any, options?: any): Uint8Array<ArrayBufferLike>;

package/dist/utils/fast-safe-stringify/index.js

@@ -15,7 +15,7 @@ function encodeString(str) {
     return encoder.encode(str);
 }
 // Regular stringify
-export function serialize(obj, replacer, spacer, options) {
+export function serialize(obj, errorContext, replacer, spacer, options) {
     try {
         const str = JSON.stringify(obj, replacer, spacer);
         return encodeString(str);
@@ -23,10 +23,10 @@ export function serialize(obj, replacer, spacer, options) {
     catch (e) {
         // Fall back to more complex stringify if circular reference
         if (!e.message?.includes("Converting circular structure to JSON")) {
-            console.warn("[WARNING]: LangSmith received unserializable value.");
+            console.warn(`[WARNING]: LangSmith received unserializable value.${errorContext ? `\nContext: ${errorContext}` : ""}`);
             return encodeString("[Unserializable]");
         }
-        console.warn("[WARNING]: LangSmith received circular JSON. This will decrease tracer performance.");
+        console.warn(`[WARNING]: LangSmith received circular JSON. This will decrease tracer performance. ${errorContext ? `\nContext: ${errorContext}` : ""}`);
         if (typeof options === "undefined") {
             options = defaultOptions();
         }

package/dist/wrappers/openai.d.ts

@@ -29,7 +29,7 @@ type PatchedOpenAIClient<T extends OpenAIType> = T & {
             } & {
                 (arg: OpenAI.ChatCompletionCreateParamsNonStreaming, arg2?: OpenAI.RequestOptions & {
                     langsmithExtra?: ExtraRunTreeConfig;
-                }): APIPromise<OpenAI.ChatCompletionChunk>;
+                }): APIPromise<OpenAI.ChatCompletion>;
             };
         };
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.3.28",
+  "version": "0.3.29",
   "description": "Client library to connect to the LangSmith LLM Tracing and Evaluation Platform.",
   "packageManager": "yarn@1.22.19",
   "files": [
@@ -142,9 +142,9 @@
     "@langchain/openai": "^0.3.11",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/auto-instrumentations-node": "^0.58.0",
+    "@opentelemetry/sdk-node": "^0.200.0",
     "@opentelemetry/sdk-trace-base": "^2.0.0",
     "@opentelemetry/sdk-trace-node": "^2.0.0",
-    "@opentelemetry/sdk-node": "^0.200.0",
     "@tsconfig/recommended": "^1.0.2",
     "@types/jest": "^29.5.1",
     "@typescript-eslint/eslint-plugin": "^5.59.8",
@@ -168,7 +168,7 @@
     "typedoc": "^0.27.6",
     "typedoc-plugin-expand-object-like-types": "^0.1.2",
     "typescript": "^5.4.5",
-    "vitest": "^3.0.5",
+    "vitest": "^3.1.3",
     "zod": "^3.23.8"
   },
   "peerDependencies": {