langsmith 0.2.3 → 0.2.4

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.2.3";
+exports.__version__ = "0.2.4";

package/dist/index.d.ts

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

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

package/dist/vercel.cjs

@@ -5,6 +5,7 @@ const index_js_1 = require("./index.cjs");
 const uuid_1 = require("uuid");
 const traceable_js_1 = require("./singletons/traceable.cjs");
 const env_js_1 = require("./utils/env.cjs");
+const env_js_2 = require("./env.cjs");
 // Attempt to convert CoreMessage to a LangChain-compatible format
 // which allows us to render messages more nicely in LangSmith
 function convertCoreToSmith(message) {
@@ -202,6 +203,12 @@ class AISDKExporter {
             writable: true,
             value: {}
         });
+        Object.defineProperty(this, "debug", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         /** @internal */
         Object.defineProperty(this, "getSpanAttributeKey", {
             enumerable: true,
@@ -215,6 +222,9 @@ class AISDKExporter {
             }
         });
         this.client = args?.client ?? new index_js_1.Client();
+        this.debug =
+            args?.debug ?? (0, env_js_1.getEnvironmentVariable)("OTEL_LOG_LEVEL") === "DEBUG";
+        this.logDebug("creating exporter", { tracingEnabled: (0, env_js_2.isTracingEnabled)() });
     }
     static getSettings(settings) {
         const { runId, runName, ...rest } = settings ?? {};
@@ -224,7 +234,7 @@ class AISDKExporter {
         if (runName != null)
             metadata[RUN_NAME_METADATA_KEY.input] = runName;
         // attempt to obtain the run tree if used within a traceable function
-        let defaultEnabled = true;
+        let defaultEnabled = settings?.isEnabled ?? (0, env_js_2.isTracingEnabled)();
         try {
             const runTree = (0, traceable_js_1.getCurrentRunTree)();
             const headers = runTree.toHeaders();
@@ -517,6 +527,7 @@ class AISDKExporter {
         }
     }
     export(spans, resultCallback) {
+        this.logDebug("exporting spans", spans);
         const typedSpans = spans
             .slice()
             .sort((a, b) => sortByHr(a.startTime, b.startTime));
@@ -538,8 +549,10 @@ class AISDKExporter {
                 parentRunId = undefined;
             const traceMap = this.traceByMap[traceId];
             const run = this.getRunCreate(span);
-            if (!run)
+            if (!run) {
+                this.logDebug("skipping span", span);
                 continue;
+            }
             traceMap.relativeExecutionOrder[parentRunId ?? ROOT] ??= -1;
             traceMap.relativeExecutionOrder[parentRunId ?? ROOT] += 1;
             traceMap.nodeMap[runId] ??= {
@@ -550,6 +563,8 @@ class AISDKExporter {
                 sent: false,
                 executionOrder: traceMap.relativeExecutionOrder[parentRunId ?? ROOT],
             };
+            if (this.debug)
+                console.log(`[${span.name}] ${runId}`, run);
             traceMap.childMap[parentRunId ?? ROOT] ??= [];
             traceMap.childMap[parentRunId ?? ROOT].push(traceMap.nodeMap[runId]);
             traceMap.interop = this.parseInteropFromMetadata(span);
@@ -628,11 +643,13 @@ class AISDKExporter {
                 }));
             }
         }
+        this.logDebug(`sampled runs to be sent to LangSmith`, sampled);
         Promise.all(sampled.map(([override, value]) => this.client.createRun({ ...value, ...override }))).then(() => resultCallback({ code: 0 }), (error) => resultCallback({ code: 1, error }));
     }
     async shutdown() {
         // find nodes which are incomplete
         const incompleteNodes = Object.values(this.traceByMap).flatMap((trace) => Object.values(trace.nodeMap).filter((i) => !i.sent));
+        this.logDebug("shutting down", { incompleteNodes: incompleteNodes.length });
         if (incompleteNodes.length > 0) {
             console.warn("Some incomplete nodes were found before shutdown and not sent to LangSmith.");
         }
@@ -641,5 +658,10 @@ class AISDKExporter {
     async forceFlush() {
         await this.client?.awaitPendingTraceBatches();
     }
+    logDebug(...args) {
+        if (!this.debug)
+            return;
+        console.debug(`[${new Date().toISOString()}] [LangSmith]`, ...args);
+    }
 }
 exports.AISDKExporter = AISDKExporter;

package/dist/vercel.d.ts

@@ -50,8 +50,10 @@ export interface TelemetrySettings extends AITelemetrySettings {
 export declare class AISDKExporter {
     private client;
     private traceByMap;
+    private debug;
     constructor(args?: {
         client?: Client;
+        debug?: boolean;
     });
     static getSettings(settings?: TelemetrySettings): {
         isEnabled: boolean;
@@ -69,4 +71,5 @@ export declare class AISDKExporter {
     }) => void): void;
     shutdown(): Promise<void>;
     forceFlush?(): Promise<void>;
+    protected logDebug(...args: Parameters<typeof console.debug>): void;
 }

package/dist/vercel.js

@@ -1,7 +1,8 @@
 import { Client, RunTree } from "./index.js";
 import { v5 as uuid5, v4 as uuid4 } from "uuid";
 import { getCurrentRunTree } from "./singletons/traceable.js";
-import { getLangSmithEnvironmentVariable } from "./utils/env.js";
+import { getLangSmithEnvironmentVariable, getEnvironmentVariable, } from "./utils/env.js";
+import { isTracingEnabled } from "./env.js";
 // Attempt to convert CoreMessage to a LangChain-compatible format
 // which allows us to render messages more nicely in LangSmith
 function convertCoreToSmith(message) {
@@ -199,6 +200,12 @@ export class AISDKExporter {
             writable: true,
             value: {}
         });
+        Object.defineProperty(this, "debug", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         /** @internal */
         Object.defineProperty(this, "getSpanAttributeKey", {
             enumerable: true,
@@ -212,6 +219,9 @@ export class AISDKExporter {
             }
         });
         this.client = args?.client ?? new Client();
+        this.debug =
+            args?.debug ?? getEnvironmentVariable("OTEL_LOG_LEVEL") === "DEBUG";
+        this.logDebug("creating exporter", { tracingEnabled: isTracingEnabled() });
     }
     static getSettings(settings) {
         const { runId, runName, ...rest } = settings ?? {};
@@ -221,7 +231,7 @@ export class AISDKExporter {
         if (runName != null)
             metadata[RUN_NAME_METADATA_KEY.input] = runName;
         // attempt to obtain the run tree if used within a traceable function
-        let defaultEnabled = true;
+        let defaultEnabled = settings?.isEnabled ?? isTracingEnabled();
         try {
             const runTree = getCurrentRunTree();
             const headers = runTree.toHeaders();
@@ -514,6 +524,7 @@ export class AISDKExporter {
         }
     }
     export(spans, resultCallback) {
+        this.logDebug("exporting spans", spans);
         const typedSpans = spans
             .slice()
             .sort((a, b) => sortByHr(a.startTime, b.startTime));
@@ -535,8 +546,10 @@ export class AISDKExporter {
                 parentRunId = undefined;
             const traceMap = this.traceByMap[traceId];
             const run = this.getRunCreate(span);
-            if (!run)
+            if (!run) {
+                this.logDebug("skipping span", span);
                 continue;
+            }
             traceMap.relativeExecutionOrder[parentRunId ?? ROOT] ??= -1;
             traceMap.relativeExecutionOrder[parentRunId ?? ROOT] += 1;
             traceMap.nodeMap[runId] ??= {
@@ -547,6 +560,8 @@ export class AISDKExporter {
                 sent: false,
                 executionOrder: traceMap.relativeExecutionOrder[parentRunId ?? ROOT],
             };
+            if (this.debug)
+                console.log(`[${span.name}] ${runId}`, run);
             traceMap.childMap[parentRunId ?? ROOT] ??= [];
             traceMap.childMap[parentRunId ?? ROOT].push(traceMap.nodeMap[runId]);
             traceMap.interop = this.parseInteropFromMetadata(span);
@@ -625,11 +640,13 @@ export class AISDKExporter {
                 }));
             }
         }
+        this.logDebug(`sampled runs to be sent to LangSmith`, sampled);
         Promise.all(sampled.map(([override, value]) => this.client.createRun({ ...value, ...override }))).then(() => resultCallback({ code: 0 }), (error) => resultCallback({ code: 1, error }));
     }
     async shutdown() {
         // find nodes which are incomplete
         const incompleteNodes = Object.values(this.traceByMap).flatMap((trace) => Object.values(trace.nodeMap).filter((i) => !i.sent));
+        this.logDebug("shutting down", { incompleteNodes: incompleteNodes.length });
         if (incompleteNodes.length > 0) {
             console.warn("Some incomplete nodes were found before shutdown and not sent to LangSmith.");
         }
@@ -638,4 +655,9 @@ export class AISDKExporter {
     async forceFlush() {
         await this.client?.awaitPendingTraceBatches();
     }
+    logDebug(...args) {
+        if (!this.debug)
+            return;
+        console.debug(`[${new Date().toISOString()}] [LangSmith]`, ...args);
+    }
 }

package/package.json

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