langsmith 0.3.44 → 0.3.46-rc.0

package/dist/client.d.ts

@@ -187,8 +187,8 @@ interface CreateRunParams {
     inputs: KVMap;
     run_type: string;
     id?: string;
-    start_time?: number;
-    end_time?: number;
+    start_time?: number | string;
+    end_time?: number | string;
     extra?: KVMap;
     error?: string;
     serialized?: object;

package/dist/experimental/otel/exporter.cjs

@@ -77,20 +77,20 @@ class LangSmithOTLPTraceExporter extends exporter_trace_otlp_proto_1.OTLPTraceEx
         const defaultBaseUrl = defaultLsEndpoint.replace(/\/$/, "");
         const defaultUrl = `${defaultBaseUrl}/otel/v1/traces`;
         // Configure headers with API key and project if available
-        let defaultHeaderString = (0, env_js_2.getEnvironmentVariable)("OTEL_EXPORTER_OTLP_HEADERS") ?? "";
-        if (!defaultHeaderString) {
-            const apiKey = config?.apiKey ?? (0, env_js_2.getLangSmithEnvironmentVariable)("API_KEY");
-            if (apiKey) {
-                defaultHeaderString = `x-api-key=${apiKey}`;
-            }
-            const project = config?.projectName ?? (0, env_js_2.getLangSmithEnvironmentVariable)("PROJECT");
-            if (project) {
-                defaultHeaderString += `,Langsmith-Project=${project}`;
+        let headers = config?.headers;
+        if (headers === undefined) {
+            let defaultHeaderString = (0, env_js_2.getEnvironmentVariable)("OTEL_EXPORTER_OTLP_HEADERS") ?? "";
+            if (!defaultHeaderString) {
+                const apiKey = config?.apiKey ?? (0, env_js_2.getLangSmithEnvironmentVariable)("API_KEY");
+                if (apiKey) {
+                    defaultHeaderString = `x-api-key=${apiKey}`;
+                }
             }
+            headers = parseHeadersString(defaultHeaderString);
         }
         super({
             url: defaultUrl,
-            headers: parseHeadersString(defaultHeaderString),
+            headers,
             ...config,
         });
         Object.defineProperty(this, "transformExportedSpan", {
@@ -99,7 +99,15 @@ class LangSmithOTLPTraceExporter extends exporter_trace_otlp_proto_1.OTLPTraceEx
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "projectName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.transformExportedSpan = config?.transformExportedSpan;
+        this.projectName =
+            config?.projectName ?? (0, env_js_2.getLangSmithEnvironmentVariable)("PROJECT");
     }
     export(spans, resultCallback) {
         if (!(0, env_js_1.isTracingEnabled)()) {
@@ -193,6 +201,10 @@ class LangSmithOTLPTraceExporter extends exporter_trace_otlp_proto_1.OTLPTraceEx
                         span.attributes[`${constants.LANGSMITH_METADATA}.ls_run_name`];
                     delete span.attributes[`${constants.LANGSMITH_METADATA}.ls_run_name`];
                 }
+                if (span.attributes[constants.LANGSMITH_SESSION_NAME] === undefined &&
+                    this.projectName !== undefined) {
+                    span.attributes[constants.LANGSMITH_SESSION_NAME] = this.projectName;
+                }
             }
             super.export(spans, resultCallback);
         };

package/dist/experimental/otel/exporter.d.ts

@@ -32,6 +32,10 @@ export type LangSmithOTLPTraceExporterConfig = ConstructorParameters<typeof OTLP
      * The name of the project to export traces to.
      */
     projectName?: string;
+    /**
+     * Default headers to add to exporter requests.
+     */
+    headers?: Record<string, string>;
 };
 /**
  * LangSmith OpenTelemetry trace exporter that extends the standard OTLP trace exporter
@@ -50,6 +54,7 @@ export type LangSmithOTLPTraceExporterConfig = ConstructorParameters<typeof OTLP
  */
 export declare class LangSmithOTLPTraceExporter extends OTLPTraceExporter {
     private transformExportedSpan?;
+    private projectName?;
     constructor(config?: LangSmithOTLPTraceExporterConfig);
     export(spans: ReadableSpan[], resultCallback: Parameters<OTLPTraceExporter["export"]>[1]): void;
 }

package/dist/experimental/otel/exporter.js

@@ -41,20 +41,20 @@ export class LangSmithOTLPTraceExporter extends OTLPTraceExporter {
         const defaultBaseUrl = defaultLsEndpoint.replace(/\/$/, "");
         const defaultUrl = `${defaultBaseUrl}/otel/v1/traces`;
         // Configure headers with API key and project if available
-        let defaultHeaderString = getEnvironmentVariable("OTEL_EXPORTER_OTLP_HEADERS") ?? "";
-        if (!defaultHeaderString) {
-            const apiKey = config?.apiKey ?? getLangSmithEnvironmentVariable("API_KEY");
-            if (apiKey) {
-                defaultHeaderString = `x-api-key=${apiKey}`;
-            }
-            const project = config?.projectName ?? getLangSmithEnvironmentVariable("PROJECT");
-            if (project) {
-                defaultHeaderString += `,Langsmith-Project=${project}`;
+        let headers = config?.headers;
+        if (headers === undefined) {
+            let defaultHeaderString = getEnvironmentVariable("OTEL_EXPORTER_OTLP_HEADERS") ?? "";
+            if (!defaultHeaderString) {
+                const apiKey = config?.apiKey ?? getLangSmithEnvironmentVariable("API_KEY");
+                if (apiKey) {
+                    defaultHeaderString = `x-api-key=${apiKey}`;
+                }
             }
+            headers = parseHeadersString(defaultHeaderString);
         }
         super({
             url: defaultUrl,
-            headers: parseHeadersString(defaultHeaderString),
+            headers,
             ...config,
         });
         Object.defineProperty(this, "transformExportedSpan", {
@@ -63,7 +63,15 @@ export class LangSmithOTLPTraceExporter extends OTLPTraceExporter {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "projectName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.transformExportedSpan = config?.transformExportedSpan;
+        this.projectName =
+            config?.projectName ?? getLangSmithEnvironmentVariable("PROJECT");
     }
     export(spans, resultCallback) {
         if (!isTracingEnabled()) {
@@ -157,6 +165,10 @@ export class LangSmithOTLPTraceExporter extends OTLPTraceExporter {
                         span.attributes[`${constants.LANGSMITH_METADATA}.ls_run_name`];
                     delete span.attributes[`${constants.LANGSMITH_METADATA}.ls_run_name`];
                 }
+                if (span.attributes[constants.LANGSMITH_SESSION_NAME] === undefined &&
+                    this.projectName !== undefined) {
+                    span.attributes[constants.LANGSMITH_SESSION_NAME] = this.projectName;
+                }
             }
             super.export(spans, resultCallback);
         };

package/dist/experimental/otel/translator.cjs

@@ -102,7 +102,7 @@ class LangSmithToOTELTranslator {
         }
         // End the span if end_time is present
         if (runInfo.end_time) {
-            span.end(runInfo.end_time);
+            span.end(new Date(runInfo.end_time));
         }
         return span;
     }
@@ -126,7 +126,7 @@ class LangSmithToOTELTranslator {
             // End the span if end_time is present
             const endTime = runInfo.end_time;
             if (endTime) {
-                span.end(endTime);
+                span.end(new Date(endTime));
                 this.spans.delete(op.id);
             }
         }

package/dist/experimental/otel/translator.js

@@ -66,7 +66,7 @@ export class LangSmithToOTELTranslator {
         }
         // End the span if end_time is present
         if (runInfo.end_time) {
-            span.end(runInfo.end_time);
+            span.end(new Date(runInfo.end_time));
         }
         return span;
     }
@@ -90,7 +90,7 @@ export class LangSmithToOTELTranslator {
             // End the span if end_time is present
             const endTime = runInfo.end_time;
             if (endTime) {
-                span.end(endTime);
+                span.end(new Date(endTime));
                 this.spans.delete(op.id);
             }
         }

package/dist/experimental/otel/types.d.ts

@@ -5,7 +5,7 @@ export interface OTELSpan {
         message?: string;
     }) => void;
     recordException: (exception: Error | string) => void;
-    end: (endTime?: number) => void;
+    end: (endTime?: number | Date) => void;
 }
 export interface OTELTracer {
     startSpan: (name: string, options?: any) => OTELSpan;

package/dist/index.cjs

@@ -10,4 +10,4 @@ Object.defineProperty(exports, "overrideFetchImplementation", { enumerable: true
 var project_js_1 = require("./utils/project.cjs");
 Object.defineProperty(exports, "getDefaultProjectName", { enumerable: true, get: function () { return project_js_1.getDefaultProjectName; } });
 // Update using yarn bump-version
-exports.__version__ = "0.3.44";
+exports.__version__ = "0.3.46-rc.0";

package/dist/index.d.ts

@@ -3,4 +3,4 @@ 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.44";
+export declare const __version__ = "0.3.46-rc.0";

package/dist/index.js

@@ -3,4 +3,4 @@ export { RunTree } from "./run_trees.js";
 export { overrideFetchImplementation } from "./singletons/fetch.js";
 export { getDefaultProjectName } from "./utils/project.js";
 // Update using yarn bump-version
-export const __version__ = "0.3.44";
+export const __version__ = "0.3.46-rc.0";

package/dist/run_trees.cjs

@@ -53,7 +53,13 @@ function convertToDottedOrderFormat(epoch, runId, 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");
-    return (stripNonAlphanumeric(`${new Date(epoch).toISOString().slice(0, -1)}${paddedOrder}Z`) + runId);
+    const microsecondPrecisionDatestring = `${new Date(epoch)
+        .toISOString()
+        .slice(0, -1)}${paddedOrder}Z`;
+    return {
+        dottedOrder: stripNonAlphanumeric(microsecondPrecisionDatestring) + runId,
+        microsecondPrecisionDatestring,
+    };
 }
 /**
  * Baggage header information
@@ -159,6 +165,12 @@ class RunTree {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "parent_run_id", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "child_runs", {
             enumerable: true,
             configurable: true,
@@ -280,6 +292,12 @@ class RunTree {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "_serialized_start_time", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         // If you pass in a run tree directly, return a shallow clone
         if (isRunTree(originalConfig)) {
             Object.assign(this, { ...originalConfig });
@@ -306,14 +324,14 @@ class RunTree {
         this.execution_order ??= 1;
         this.child_execution_order ??= 1;
         if (!this.dotted_order) {
-            const currentDottedOrder = convertToDottedOrderFormat(this.start_time, this.id, this.execution_order);
+            const { dottedOrder, microsecondPrecisionDatestring } = convertToDottedOrderFormat(this.start_time, this.id, this.execution_order);
             if (this.parent_run) {
-                this.dotted_order =
-                    this.parent_run.dotted_order + "." + currentDottedOrder;
+                this.dotted_order = this.parent_run.dotted_order + "." + dottedOrder;
             }
             else {
-                this.dotted_order = currentDottedOrder;
+                this.dotted_order = dottedOrder;
             }
+            this._serialized_start_time = microsecondPrecisionDatestring;
         }
     }
     set metadata(metadata) {
@@ -430,13 +448,13 @@ class RunTree {
             parent_run_id = undefined;
         }
         else {
-            parent_run_id = run.parent_run?.id;
+            parent_run_id = run.parent_run_id ?? run.parent_run?.id;
             child_runs = [];
         }
         return {
             id: run.id,
             name: run.name,
-            start_time: run.start_time,
+            start_time: run._serialized_start_time ?? run.start_time,
             end_time: run.end_time,
             run_type: run.run_type,
             reference_example_id: run.reference_example_id,

package/dist/run_trees.d.ts

@@ -1,6 +1,9 @@
 import { Client } from "./client.js";
 import { Attachments, BaseRun, KVMap, RunCreate } from "./schemas.js";
-export declare function convertToDottedOrderFormat(epoch: number, runId: string, executionOrder?: number): string;
+export declare function convertToDottedOrderFormat(epoch: number, runId: string, executionOrder?: number): {
+    dottedOrder: string;
+    microsecondPrecisionDatestring: string;
+};
 export interface RunTreeConfig {
     name: string;
     run_type?: string;
@@ -9,8 +12,8 @@ export interface RunTreeConfig {
     parent_run?: RunTree;
     parent_run_id?: string;
     child_runs?: RunTree[];
-    start_time?: number;
-    end_time?: number;
+    start_time?: number | string;
+    end_time?: number | string;
     extra?: KVMap;
     metadata?: KVMap;
     tags?: string[];
@@ -66,6 +69,7 @@ export declare class RunTree implements BaseRun {
     run_type: string;
     project_name: string;
     parent_run?: RunTree;
+    parent_run_id?: string;
     child_runs: RunTree[];
     start_time: number;
     end_time?: number;
@@ -92,6 +96,7 @@ export declare class RunTree implements BaseRun {
      * Projects to replicate this run to with optional updates.
      */
     replicas?: WriteReplica[];
+    private _serialized_start_time;
     constructor(originalConfig: RunTreeConfig | RunTree);
     set metadata(metadata: KVMap);
     get metadata(): KVMap;

package/dist/run_trees.js

@@ -14,7 +14,13 @@ export function convertToDottedOrderFormat(epoch, runId, 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");
-    return (stripNonAlphanumeric(`${new Date(epoch).toISOString().slice(0, -1)}${paddedOrder}Z`) + runId);
+    const microsecondPrecisionDatestring = `${new Date(epoch)
+        .toISOString()
+        .slice(0, -1)}${paddedOrder}Z`;
+    return {
+        dottedOrder: stripNonAlphanumeric(microsecondPrecisionDatestring) + runId,
+        microsecondPrecisionDatestring,
+    };
 }
 /**
  * Baggage header information
@@ -120,6 +126,12 @@ export class RunTree {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "parent_run_id", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "child_runs", {
             enumerable: true,
             configurable: true,
@@ -241,6 +253,12 @@ export class RunTree {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "_serialized_start_time", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         // If you pass in a run tree directly, return a shallow clone
         if (isRunTree(originalConfig)) {
             Object.assign(this, { ...originalConfig });
@@ -267,14 +285,14 @@ export class RunTree {
         this.execution_order ??= 1;
         this.child_execution_order ??= 1;
         if (!this.dotted_order) {
-            const currentDottedOrder = convertToDottedOrderFormat(this.start_time, this.id, this.execution_order);
+            const { dottedOrder, microsecondPrecisionDatestring } = convertToDottedOrderFormat(this.start_time, this.id, this.execution_order);
             if (this.parent_run) {
-                this.dotted_order =
-                    this.parent_run.dotted_order + "." + currentDottedOrder;
+                this.dotted_order = this.parent_run.dotted_order + "." + dottedOrder;
             }
             else {
-                this.dotted_order = currentDottedOrder;
+                this.dotted_order = dottedOrder;
             }
+            this._serialized_start_time = microsecondPrecisionDatestring;
         }
     }
     set metadata(metadata) {
@@ -391,13 +409,13 @@ export class RunTree {
             parent_run_id = undefined;
         }
         else {
-            parent_run_id = run.parent_run?.id;
+            parent_run_id = run.parent_run_id ?? run.parent_run?.id;
             child_runs = [];
         }
         return {
             id: run.id,
             name: run.name,
-            start_time: run.start_time,
+            start_time: run._serialized_start_time ?? run.start_time,
             end_time: run.end_time,
             run_type: run.run_type,
             reference_example_id: run.reference_example_id,

package/dist/schemas.d.ts

@@ -55,11 +55,11 @@ export interface BaseRun {
     /** A human-readable name for the run. */
     name: string;
     /** The epoch time at which the run started, if available. */
-    start_time?: number;
+    start_time?: number | string;
     /** Specifies the type of run (tool, chain, llm, etc.). */
     run_type: string;
     /** The epoch time at which the run ended, if applicable. */
-    end_time?: number;
+    end_time?: number | string;
     /** Any additional metadata or settings for the run. */
     extra?: KVMap;
     /** Error message, captured if the run faces any issues. */
@@ -152,7 +152,7 @@ export interface RunCreate extends BaseRun {
 }
 export interface RunUpdate {
     id?: string;
-    end_time?: number;
+    end_time?: number | string;
     extra?: KVMap;
     tags?: string[];
     error?: string;

package/dist/traceable.cjs

@@ -17,7 +17,7 @@ traceable_js_1.AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new n
 /**
  * Create OpenTelemetry context manager from RunTree if OTEL is enabled.
  */
-function maybeCreateOtelContext(runTree, tracer
+function maybeCreateOtelContext(runTree, projectName, tracer
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 ) {
     if (!runTree || (0, env_js_2.getEnvironmentVariable)("OTEL_ENABLED") !== "true") {
@@ -34,6 +34,9 @@ function maybeCreateOtelContext(runTree, tracer
                 attributes[constants_js_2.LANGSMITH_REFERENCE_EXAMPLE_ID] =
                     runTree.reference_example_id;
             }
+            if (projectName !== undefined) {
+                attributes[constants_js_2.LANGSMITH_SESSION_NAME] = projectName;
+            }
             const forceOTELRoot = runTree.extra?.ls_otel_root === true;
             return resolvedTracer.startActiveSpan(runTree.name, {
                 attributes,
@@ -439,7 +442,7 @@ function traceable(wrappedFunc, config) {
         const currentRunTree = (0, run_trees_js_1.isRunTree)(currentContext)
             ? currentContext
             : undefined;
-        const otelContextManager = maybeCreateOtelContext(currentRunTree, config?.tracer);
+        const otelContextManager = maybeCreateOtelContext(currentRunTree, config?.project_name, config?.tracer);
         const otel_context = (0, otel_js_1.getOTELContext)();
         const runWithContext = () => {
             const postRunPromise = currentRunTree?.postRun();

package/dist/traceable.js

@@ -8,12 +8,12 @@ import { getEnvironmentVariable } from "./utils/env.js";
 import { __version__ } from "./index.js";
 import { getOTELTrace, getOTELContext } from "./singletons/otel.js";
 import { getUuidFromOtelSpanId } from "./experimental/otel/utils.js";
-import { LANGSMITH_REFERENCE_EXAMPLE_ID } from "./experimental/otel/constants.js";
+import { LANGSMITH_REFERENCE_EXAMPLE_ID, LANGSMITH_SESSION_NAME, } from "./experimental/otel/constants.js";
 AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new AsyncLocalStorage());
 /**
  * Create OpenTelemetry context manager from RunTree if OTEL is enabled.
  */
-function maybeCreateOtelContext(runTree, tracer
+function maybeCreateOtelContext(runTree, projectName, tracer
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 ) {
     if (!runTree || getEnvironmentVariable("OTEL_ENABLED") !== "true") {
@@ -30,6 +30,9 @@ function maybeCreateOtelContext(runTree, tracer
                 attributes[LANGSMITH_REFERENCE_EXAMPLE_ID] =
                     runTree.reference_example_id;
             }
+            if (projectName !== undefined) {
+                attributes[LANGSMITH_SESSION_NAME] = projectName;
+            }
             const forceOTELRoot = runTree.extra?.ls_otel_root === true;
             return resolvedTracer.startActiveSpan(runTree.name, {
                 attributes,
@@ -435,7 +438,7 @@ export function traceable(wrappedFunc, config) {
         const currentRunTree = isRunTree(currentContext)
             ? currentContext
             : undefined;
-        const otelContextManager = maybeCreateOtelContext(currentRunTree, config?.tracer);
+        const otelContextManager = maybeCreateOtelContext(currentRunTree, config?.project_name, config?.tracer);
         const otel_context = getOTELContext();
         const runWithContext = () => {
             const postRunPromise = currentRunTree?.postRun();

package/dist/utils/jestlike/index.cjs

@@ -385,7 +385,7 @@ function generateWrapperFromJestlikeMethods(methods, testRunnerName) {
                 context.enableTestTracking = lsParams.config.enableTestTracking;
             }
             const { config, inputs, referenceOutputs, ...rest } = lsParams;
-            const totalRuns = config?.iterations ?? 1;
+            const totalRuns = config?.repetitions ?? config?.iterations ?? 1;
             for (let i = 0; i < totalRuns; i += 1) {
                 const testUuid = (0, uuid_1.v4)().replace(/-/g, "").slice(0, 13);
                 // Jest will not group tests under the same "describe" group if you await the test and

package/dist/utils/jestlike/index.js

@@ -338,7 +338,7 @@ export function generateWrapperFromJestlikeMethods(methods, testRunnerName) {
                 context.enableTestTracking = lsParams.config.enableTestTracking;
             }
             const { config, inputs, referenceOutputs, ...rest } = lsParams;
-            const totalRuns = config?.iterations ?? 1;
+            const totalRuns = config?.repetitions ?? config?.iterations ?? 1;
             for (let i = 0; i < totalRuns; i += 1) {
                 const testUuid = v4().replace(/-/g, "").slice(0, 13);
                 // Jest will not group tests under the same "describe" group if you await the test and

package/dist/utils/jestlike/types.d.ts

@@ -5,7 +5,9 @@ import type { RunTreeConfig } from "../../run_trees.js";
 import type { SimpleEvaluator } from "./vendor/evaluatedBy.js";
 export { type SimpleEvaluator };
 export type LangSmithJestlikeWrapperConfig = Partial<Omit<RunTreeConfig, "client">> & {
+    /** @deprecated Use `repetitions` instead. */
     iterations?: number;
+    repetitions?: number;
     enableTestTracking?: boolean;
 };
 export type LangSmithJestlikeWrapperParams<I, O> = {

package/package.json

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