langsmith 0.3.53 → 0.3.55

package/dist/experimental/otel/constants.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AI_SDK_TOOL_OPERATIONS = exports.AI_SDK_LLM_OPERATIONS = exports.GEN_AI_CHOICE = exports.GEN_AI_ASSISTANT_MESSAGE = exports.GEN_AI_USER_MESSAGE = exports.GEN_AI_SYSTEM_MESSAGE = exports.LANGSMITH_IS_ROOT = exports.LANGSMITH_TRACEABLE = exports.LANGSMITH_REFERENCE_EXAMPLE_ID = exports.LANGSMITH_USAGE_METADATA = exports.LANGSMITH_PARENT_RUN_ID = exports.LANGSMITH_DOTTED_ORDER = exports.LANGSMITH_TRACE_ID = exports.LANGSMITH_RUN_ID = exports.LANGSMITH_REQUEST_HEADERS = exports.LANGSMITH_REQUEST_STREAMING = exports.LANGSMITH_RUNTIME = exports.LANGSMITH_TAGS = exports.LANGSMITH_METADATA = exports.LANGSMITH_NAME = exports.LANGSMITH_RUN_TYPE = exports.LANGSMITH_SESSION_NAME = exports.LANGSMITH_SESSION_ID = exports.GEN_AI_USAGE_OUTPUT_TOKEN_DETAILS = exports.GEN_AI_USAGE_INPUT_TOKEN_DETAILS = exports.GEN_AI_RESPONSE_SYSTEM_FINGERPRINT = exports.GEN_AI_RESPONSE_SERVICE_TIER = exports.GEN_AI_RESPONSE_ID = exports.GEN_AI_SERIALIZED_DOC = exports.GEN_AI_SERIALIZED_SIGNATURE = exports.GEN_AI_SERIALIZED_NAME = exports.GEN_AI_REQUEST_EXTRA_BODY = exports.GEN_AI_REQUEST_EXTRA_QUERY = exports.GENAI_COMPLETION = exports.GENAI_PROMPT = exports.GEN_AI_RESPONSE_FINISH_REASONS = exports.GEN_AI_REQUEST_PRESENCE_PENALTY = exports.GEN_AI_REQUEST_FREQUENCY_PENALTY = exports.GEN_AI_REQUEST_TOP_P = exports.GEN_AI_REQUEST_TEMPERATURE = exports.GEN_AI_REQUEST_MAX_TOKENS = exports.GEN_AI_USAGE_TOTAL_TOKENS = exports.GEN_AI_USAGE_OUTPUT_TOKENS = exports.GEN_AI_USAGE_INPUT_TOKENS = exports.GEN_AI_RESPONSE_MODEL = exports.GEN_AI_REQUEST_MODEL = exports.GEN_AI_SYSTEM = exports.GEN_AI_OPERATION_NAME = void 0;
+exports.AI_SDK_TOOL_OPERATIONS = exports.AI_SDK_LLM_OPERATIONS = exports.GEN_AI_CHOICE = exports.GEN_AI_ASSISTANT_MESSAGE = exports.GEN_AI_USER_MESSAGE = exports.GEN_AI_SYSTEM_MESSAGE = exports.LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID = exports.LANGSMITH_IS_ROOT = exports.LANGSMITH_TRACEABLE = exports.LANGSMITH_REFERENCE_EXAMPLE_ID = exports.LANGSMITH_USAGE_METADATA = exports.LANGSMITH_PARENT_RUN_ID = exports.LANGSMITH_DOTTED_ORDER = exports.LANGSMITH_TRACE_ID = exports.LANGSMITH_RUN_ID = exports.LANGSMITH_REQUEST_HEADERS = exports.LANGSMITH_REQUEST_STREAMING = exports.LANGSMITH_RUNTIME = exports.LANGSMITH_TAGS = exports.LANGSMITH_METADATA = exports.LANGSMITH_NAME = exports.LANGSMITH_RUN_TYPE = exports.LANGSMITH_SESSION_NAME = exports.LANGSMITH_SESSION_ID = exports.GEN_AI_USAGE_OUTPUT_TOKEN_DETAILS = exports.GEN_AI_USAGE_INPUT_TOKEN_DETAILS = exports.GEN_AI_RESPONSE_SYSTEM_FINGERPRINT = exports.GEN_AI_RESPONSE_SERVICE_TIER = exports.GEN_AI_RESPONSE_ID = exports.GEN_AI_SERIALIZED_DOC = exports.GEN_AI_SERIALIZED_SIGNATURE = exports.GEN_AI_SERIALIZED_NAME = exports.GEN_AI_REQUEST_EXTRA_BODY = exports.GEN_AI_REQUEST_EXTRA_QUERY = exports.GENAI_COMPLETION = exports.GENAI_PROMPT = exports.GEN_AI_RESPONSE_FINISH_REASONS = exports.GEN_AI_REQUEST_PRESENCE_PENALTY = exports.GEN_AI_REQUEST_FREQUENCY_PENALTY = exports.GEN_AI_REQUEST_TOP_P = exports.GEN_AI_REQUEST_TEMPERATURE = exports.GEN_AI_REQUEST_MAX_TOKENS = exports.GEN_AI_USAGE_TOTAL_TOKENS = exports.GEN_AI_USAGE_OUTPUT_TOKENS = exports.GEN_AI_USAGE_INPUT_TOKENS = exports.GEN_AI_RESPONSE_MODEL = exports.GEN_AI_REQUEST_MODEL = exports.GEN_AI_SYSTEM = exports.GEN_AI_OPERATION_NAME = void 0;
 // OpenTelemetry GenAI semantic convention attribute names
 exports.GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
 exports.GEN_AI_SYSTEM = "gen_ai.system";
@@ -45,6 +45,7 @@ exports.LANGSMITH_USAGE_METADATA = "langsmith.usage_metadata";
 exports.LANGSMITH_REFERENCE_EXAMPLE_ID = "langsmith.reference_example_id";
 exports.LANGSMITH_TRACEABLE = "langsmith.traceable";
 exports.LANGSMITH_IS_ROOT = "langsmith.is_root";
+exports.LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID = "langsmith.traceable_parent_otel_span_id";
 // GenAI event names
 exports.GEN_AI_SYSTEM_MESSAGE = "gen_ai.system.message";
 exports.GEN_AI_USER_MESSAGE = "gen_ai.user.message";

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

@@ -40,6 +40,7 @@ export declare const LANGSMITH_USAGE_METADATA = "langsmith.usage_metadata";
 export declare const LANGSMITH_REFERENCE_EXAMPLE_ID = "langsmith.reference_example_id";
 export declare const LANGSMITH_TRACEABLE = "langsmith.traceable";
 export declare const LANGSMITH_IS_ROOT = "langsmith.is_root";
+export declare const LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID = "langsmith.traceable_parent_otel_span_id";
 export declare const GEN_AI_SYSTEM_MESSAGE = "gen_ai.system.message";
 export declare const GEN_AI_USER_MESSAGE = "gen_ai.user.message";
 export declare const GEN_AI_ASSISTANT_MESSAGE = "gen_ai.assistant.message";

package/dist/experimental/otel/constants.js

@@ -42,6 +42,7 @@ export const LANGSMITH_USAGE_METADATA = "langsmith.usage_metadata";
 export const LANGSMITH_REFERENCE_EXAMPLE_ID = "langsmith.reference_example_id";
 export const LANGSMITH_TRACEABLE = "langsmith.traceable";
 export const LANGSMITH_IS_ROOT = "langsmith.is_root";
+export const LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID = "langsmith.traceable_parent_otel_span_id";
 // GenAI event names
 export const GEN_AI_SYSTEM_MESSAGE = "gen_ai.system.message";
 export const GEN_AI_USER_MESSAGE = "gen_ai.user.message";

package/dist/experimental/otel/processor.cjs

@@ -59,6 +59,8 @@ class LangSmithOTLPSpanProcessor extends sdk_trace_base_1.BatchSpanProcessor {
         else {
             span.attributes[constants_js_1.LANGSMITH_PARENT_RUN_ID] =
                 (0, utils_js_1.getUuidFromOtelSpanId)(traceableParentId);
+            span.attributes[constants_js_1.LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID] =
+                traceableParentId;
         }
         if (isTraceable) {
             super.onStart(span, parentContext);

package/dist/experimental/otel/processor.js

@@ -1,5 +1,5 @@
 import { BatchSpanProcessor, } from "@opentelemetry/sdk-trace-base";
-import { LANGSMITH_IS_ROOT, LANGSMITH_PARENT_RUN_ID, LANGSMITH_TRACEABLE, } from "./constants.js";
+import { LANGSMITH_IS_ROOT, LANGSMITH_PARENT_RUN_ID, LANGSMITH_TRACEABLE, LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID, } from "./constants.js";
 import { getUuidFromOtelSpanId } from "./utils.js";
 import { RunTree } from "../../run_trees.js";
 export function isTraceableSpan(span) {
@@ -55,6 +55,8 @@ export class LangSmithOTLPSpanProcessor extends BatchSpanProcessor {
         else {
             span.attributes[LANGSMITH_PARENT_RUN_ID] =
                 getUuidFromOtelSpanId(traceableParentId);
+            span.attributes[LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID] =
+                traceableParentId;
         }
         if (isTraceable) {
             super.onStart(span, parentContext);

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.53";
+exports.__version__ = "0.3.55";

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

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

package/dist/vercel.cjs

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AISDKExporter = void 0;
+exports.AISDKExporter = exports.parseStrippedIsoTime = void 0;
 const vercel_js_1 = require("./utils/vercel.cjs");
 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");
+const constants_js_1 = require("./experimental/otel/constants.cjs");
 // Attempt to convert CoreMessage to a LangChain-compatible format
 // which allows us to render messages more nicely in LangSmith
 function convertCoreToSmith(message) {
@@ -18,19 +19,22 @@ function convertCoreToSmith(message) {
                     return {
                         type: "text",
                         text: part.text,
-                        // @ts-expect-error Backcompat for AI SDK 4
+                        // Backcompat for AI SDK 4
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         ...part.experimental_providerMetadata,
                     };
                 }
                 if (part.type === "tool-call") {
-                    // @ts-expect-error Backcompat for AI SDK 4
+                    // Backcompat for AI SDK 4
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     const legacyToolCallInput = part.args;
                     return {
                         type: "tool_use",
                         name: part.toolName,
                         id: part.toolCallId,
                         input: legacyToolCallInput ?? part.input,
-                        // @ts-expect-error Backcompat for AI SDK 4
+                        // Backcompat for AI SDK 4
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         ...part.experimental_providerMetadata,
                     };
                 }
@@ -40,7 +44,8 @@ function convertCoreToSmith(message) {
             if (toolCalls.length > 0) {
                 data.additional_kwargs ??= {};
                 data.additional_kwargs.tool_calls = toolCalls.map((part) => {
-                    // @ts-expect-error Backcompat for AI SDK 4
+                    // Backcompat for AI SDK 4
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     const legacyToolCallInput = part.args;
                     return {
                         id: part.toolCallId,
@@ -64,7 +69,8 @@ function convertCoreToSmith(message) {
                     return {
                         type: "text",
                         text: part.text,
-                        // @ts-expect-error Backcompat for AI SDK 4
+                        // Backcompat for AI SDK 4
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         ...part.experimental_providerMetadata,
                     };
                 }
@@ -99,7 +105,8 @@ function convertCoreToSmith(message) {
                     return {
                         type: "image_url",
                         image_url: imageUrl,
-                        // @ts-expect-error Backcompat for AI SDK 4
+                        // Backcompat for AI SDK 4
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         ...part.experimental_providerMetadata,
                     };
                 }
@@ -113,7 +120,8 @@ function convertCoreToSmith(message) {
     }
     if (message.role === "tool") {
         const res = message.content.map((toolCall) => {
-            // @ts-expect-error Backcompat for AI SDK 4
+            // Backcompat for AI SDK 4
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const legacyToolCallResult = toolCall.result;
             return {
                 type: "tool",
@@ -172,6 +180,22 @@ function reparentDotOrder(dotOrder, sourceRunId, parentDotOrder) {
         return dotOrder;
     return joinDotOrder(...parentDotOrder.split("."), ...segments.slice(sourceIndex));
 }
+// Helper function to convert dotted order version of start time to ISO string
+const parseStrippedIsoTime = (stripped) => {
+    const year = stripped.slice(0, 4);
+    const month = stripped.slice(4, 6);
+    const day = stripped.slice(6, 8);
+    const hour = stripped.slice(9, 11); // Skip 'T'
+    const minute = stripped.slice(11, 13);
+    const second = stripped.slice(13, 15);
+    const ms = stripped.slice(15, 18); // milliseconds
+    const us = stripped.length >= 21 ? stripped.slice(18, 21) : "000"; // microseconds
+    // Create ISO string with microsecond precision only if microseconds are present
+    return us !== "000"
+        ? `${year}-${month}-${day}T${hour}:${minute}:${second}.${ms}${us}Z`
+        : `${year}-${month}-${day}T${hour}:${minute}:${second}.${ms}Z`;
+};
+exports.parseStrippedIsoTime = parseStrippedIsoTime;
 function getMutableRunCreate(dotOrder) {
     const segments = dotOrder.split(".").map((i) => {
         const [startTime, runId] = i.split("Z");
@@ -180,12 +204,14 @@ function getMutableRunCreate(dotOrder) {
     const traceId = segments[0].runId;
     const parentRunId = segments.at(-2)?.runId;
     // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-    const runId = segments.at(-1).runId;
+    const lastSegment = segments.at(-1);
+    const startTime = (0, exports.parseStrippedIsoTime)(lastSegment.startTime);
     return {
-        id: runId,
+        id: lastSegment.runId,
         trace_id: traceId,
         dotted_order: dotOrder,
         parent_run_id: parentRunId,
+        start_time: startTime,
     };
 }
 function convertToTimestamp([seconds, nanoseconds]) {
@@ -667,6 +693,14 @@ class AISDKExporter {
             const { traceId, spanId } = span.spanContext();
             const runId = (0, uuid_1.v5)(spanId, RUN_ID_NAMESPACE);
             let parentId = getParentSpanId(span);
+            if (constants_js_1.LANGSMITH_IS_ROOT in span.attributes) {
+                parentId = undefined;
+            }
+            else if (constants_js_1.LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID in span.attributes &&
+                typeof span.attributes[constants_js_1.LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID] ===
+                    "string") {
+                parentId = span.attributes[constants_js_1.LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID];
+            }
             let parentRunId = parentId
                 ? (0, uuid_1.v5)(parentId, RUN_ID_NAMESPACE)
                 : undefined;

package/dist/vercel.d.ts

@@ -7,6 +7,7 @@ export interface TelemetrySettings extends AITelemetrySettings {
     /** Name of the run sent to LangSmith */
     runName?: string;
 }
+export declare const parseStrippedIsoTime: (stripped: string) => string;
 /**
  * OpenTelemetry trace exporter for Vercel AI SDK.
  *

package/dist/vercel.js

@@ -4,6 +4,7 @@ import { v5 as uuid5 } from "uuid";
 import { getCurrentRunTree } from "./singletons/traceable.js";
 import { getLangSmithEnvironmentVariable, getEnvironmentVariable, } from "./utils/env.js";
 import { isTracingEnabled } from "./env.js";
+import { LANGSMITH_IS_ROOT, LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID, } from "./experimental/otel/constants.js";
 // Attempt to convert CoreMessage to a LangChain-compatible format
 // which allows us to render messages more nicely in LangSmith
 function convertCoreToSmith(message) {
@@ -15,19 +16,22 @@ function convertCoreToSmith(message) {
                     return {
                         type: "text",
                         text: part.text,
-                        // @ts-expect-error Backcompat for AI SDK 4
+                        // Backcompat for AI SDK 4
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         ...part.experimental_providerMetadata,
                     };
                 }
                 if (part.type === "tool-call") {
-                    // @ts-expect-error Backcompat for AI SDK 4
+                    // Backcompat for AI SDK 4
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     const legacyToolCallInput = part.args;
                     return {
                         type: "tool_use",
                         name: part.toolName,
                         id: part.toolCallId,
                         input: legacyToolCallInput ?? part.input,
-                        // @ts-expect-error Backcompat for AI SDK 4
+                        // Backcompat for AI SDK 4
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         ...part.experimental_providerMetadata,
                     };
                 }
@@ -37,7 +41,8 @@ function convertCoreToSmith(message) {
             if (toolCalls.length > 0) {
                 data.additional_kwargs ??= {};
                 data.additional_kwargs.tool_calls = toolCalls.map((part) => {
-                    // @ts-expect-error Backcompat for AI SDK 4
+                    // Backcompat for AI SDK 4
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     const legacyToolCallInput = part.args;
                     return {
                         id: part.toolCallId,
@@ -61,7 +66,8 @@ function convertCoreToSmith(message) {
                     return {
                         type: "text",
                         text: part.text,
-                        // @ts-expect-error Backcompat for AI SDK 4
+                        // Backcompat for AI SDK 4
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         ...part.experimental_providerMetadata,
                     };
                 }
@@ -96,7 +102,8 @@ function convertCoreToSmith(message) {
                     return {
                         type: "image_url",
                         image_url: imageUrl,
-                        // @ts-expect-error Backcompat for AI SDK 4
+                        // Backcompat for AI SDK 4
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         ...part.experimental_providerMetadata,
                     };
                 }
@@ -110,7 +117,8 @@ function convertCoreToSmith(message) {
     }
     if (message.role === "tool") {
         const res = message.content.map((toolCall) => {
-            // @ts-expect-error Backcompat for AI SDK 4
+            // Backcompat for AI SDK 4
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const legacyToolCallResult = toolCall.result;
             return {
                 type: "tool",
@@ -169,6 +177,21 @@ function reparentDotOrder(dotOrder, sourceRunId, parentDotOrder) {
         return dotOrder;
     return joinDotOrder(...parentDotOrder.split("."), ...segments.slice(sourceIndex));
 }
+// Helper function to convert dotted order version of start time to ISO string
+export const parseStrippedIsoTime = (stripped) => {
+    const year = stripped.slice(0, 4);
+    const month = stripped.slice(4, 6);
+    const day = stripped.slice(6, 8);
+    const hour = stripped.slice(9, 11); // Skip 'T'
+    const minute = stripped.slice(11, 13);
+    const second = stripped.slice(13, 15);
+    const ms = stripped.slice(15, 18); // milliseconds
+    const us = stripped.length >= 21 ? stripped.slice(18, 21) : "000"; // microseconds
+    // Create ISO string with microsecond precision only if microseconds are present
+    return us !== "000"
+        ? `${year}-${month}-${day}T${hour}:${minute}:${second}.${ms}${us}Z`
+        : `${year}-${month}-${day}T${hour}:${minute}:${second}.${ms}Z`;
+};
 function getMutableRunCreate(dotOrder) {
     const segments = dotOrder.split(".").map((i) => {
         const [startTime, runId] = i.split("Z");
@@ -177,12 +200,14 @@ function getMutableRunCreate(dotOrder) {
     const traceId = segments[0].runId;
     const parentRunId = segments.at(-2)?.runId;
     // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-    const runId = segments.at(-1).runId;
+    const lastSegment = segments.at(-1);
+    const startTime = parseStrippedIsoTime(lastSegment.startTime);
     return {
-        id: runId,
+        id: lastSegment.runId,
         trace_id: traceId,
         dotted_order: dotOrder,
         parent_run_id: parentRunId,
+        start_time: startTime,
     };
 }
 function convertToTimestamp([seconds, nanoseconds]) {
@@ -664,6 +689,14 @@ export class AISDKExporter {
             const { traceId, spanId } = span.spanContext();
             const runId = uuid5(spanId, RUN_ID_NAMESPACE);
             let parentId = getParentSpanId(span);
+            if (LANGSMITH_IS_ROOT in span.attributes) {
+                parentId = undefined;
+            }
+            else if (LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID in span.attributes &&
+                typeof span.attributes[LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID] ===
+                    "string") {
+                parentId = span.attributes[LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID];
+            }
             let parentRunId = parentId
                 ? uuid5(parentId, RUN_ID_NAMESPACE)
                 : undefined;

package/package.json

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