langsmith 0.3.47 → 0.3.49-rc.0

package/dist/client.cjs

@@ -34,7 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Client = exports.DEFAULT_BATCH_SIZE_LIMIT_BYTES = exports.AutoBatchQueue = void 0;
-exports.mergeRuntimeEnvIntoRunCreate = mergeRuntimeEnvIntoRunCreate;
+exports.mergeRuntimeEnvIntoRun = mergeRuntimeEnvIntoRun;
 const uuid = __importStar(require("uuid"));
 const translator_js_1 = require("./experimental/otel/translator.cjs");
 const otel_js_1 = require("./singletons/otel.cjs");
@@ -48,7 +48,7 @@ const prompts_js_1 = require("./utils/prompts.cjs");
 const error_js_1 = require("./utils/error.cjs");
 const fetch_js_1 = require("./singletons/fetch.cjs");
 const index_js_2 = require("./utils/fast-safe-stringify/index.cjs");
-function mergeRuntimeEnvIntoRunCreate(run) {
+function mergeRuntimeEnvIntoRun(run) {
     const runtimeEnv = (0, env_js_1.getRuntimeEnvironment)();
     const envVars = (0, env_js_1.getLangChainEnvVarsMetadata)();
     const extra = run.extra ?? {};
@@ -61,8 +61,11 @@ function mergeRuntimeEnvIntoRunCreate(run) {
         },
         metadata: {
             ...envVars,
-            ...(envVars.revision_id || run.revision_id
-                ? { revision_id: run.revision_id ?? envVars.revision_id }
+            ...(envVars.revision_id || ("revision_id" in run && run.revision_id)
+                ? {
+                    revision_id: ("revision_id" in run ? run.revision_id : undefined) ??
+                        envVars.revision_id,
+                }
                 : {}),
             ...metadata,
         },
@@ -401,7 +404,7 @@ class Client {
         this.batchSizeBytesLimit = config.batchSizeBytesLimit;
         this.fetchOptions = config.fetchOptions || {};
         this.manualFlushMode = config.manualFlushMode ?? this.manualFlushMode;
-        if ((0, env_js_1.getEnvironmentVariable)("OTEL_ENABLED") === "true") {
+        if ((0, env_js_1.getOtelEnabled)()) {
             this.langSmithToOTELTranslator = new translator_js_1.LangSmithToOTELTranslator();
         }
     }
@@ -724,9 +727,7 @@ class Client {
     async processRunOperation(item) {
         clearTimeout(this.autoBatchTimeout);
         this.autoBatchTimeout = undefined;
-        if (item.action === "create") {
-            item.item = mergeRuntimeEnvIntoRunCreate(item.item);
-        }
+        item.item = mergeRuntimeEnvIntoRun(item.item);
         const itemPromise = this.autoBatchQueue.push(item);
         if (this.manualFlushMode) {
             // Rely on manual flushing in serverless environments
@@ -833,7 +834,7 @@ class Client {
             }).catch(console.error);
             return;
         }
-        const mergedRunCreateParam = mergeRuntimeEnvIntoRunCreate(runCreate);
+        const mergedRunCreateParam = mergeRuntimeEnvIntoRun(runCreate);
         if (options?.apiKey !== undefined) {
             headers["x-api-key"] = options.apiKey;
         }

package/dist/client.d.ts

@@ -260,7 +260,7 @@ type Thread = {
     last_outputs: string;
     last_error: string | null;
 };
-export declare function mergeRuntimeEnvIntoRunCreate(run: RunCreate): RunCreate;
+export declare function mergeRuntimeEnvIntoRun<T extends RunCreate | RunUpdate>(run: T): T;
 export declare class AutoBatchQueue {
     items: {
         action: "create" | "update";

package/dist/client.js

@@ -3,7 +3,7 @@ import { LangSmithToOTELTranslator, } from "./experimental/otel/translator.js";
 import { getDefaultOTLPTracerComponents, getOTELTrace, getOTELContext, } from "./singletons/otel.js";
 import { AsyncCaller } from "./utils/async_caller.js";
 import { convertLangChainMessageToExample, isLangChainMessage, } from "./utils/messages.js";
-import { getEnvironmentVariable, getLangChainEnvVarsMetadata, getLangSmithEnvironmentVariable, getRuntimeEnvironment, } from "./utils/env.js";
+import { getEnvironmentVariable, getLangChainEnvVarsMetadata, getLangSmithEnvironmentVariable, getRuntimeEnvironment, getOtelEnabled, } from "./utils/env.js";
 import { __version__ } from "./index.js";
 import { assertUuid } from "./utils/_uuid.js";
 import { warnOnce } from "./utils/warn.js";
@@ -11,7 +11,7 @@ import { parsePromptIdentifier } from "./utils/prompts.js";
 import { raiseForStatus } from "./utils/error.js";
 import { _globalFetchImplementationIsNodeFetch, _getFetchImplementation, } from "./singletons/fetch.js";
 import { serialize as serializePayloadForTracing } from "./utils/fast-safe-stringify/index.js";
-export function mergeRuntimeEnvIntoRunCreate(run) {
+export function mergeRuntimeEnvIntoRun(run) {
     const runtimeEnv = getRuntimeEnvironment();
     const envVars = getLangChainEnvVarsMetadata();
     const extra = run.extra ?? {};
@@ -24,8 +24,11 @@ export function mergeRuntimeEnvIntoRunCreate(run) {
         },
         metadata: {
             ...envVars,
-            ...(envVars.revision_id || run.revision_id
-                ? { revision_id: run.revision_id ?? envVars.revision_id }
+            ...(envVars.revision_id || ("revision_id" in run && run.revision_id)
+                ? {
+                    revision_id: ("revision_id" in run ? run.revision_id : undefined) ??
+                        envVars.revision_id,
+                }
                 : {}),
             ...metadata,
         },
@@ -363,7 +366,7 @@ export class Client {
         this.batchSizeBytesLimit = config.batchSizeBytesLimit;
         this.fetchOptions = config.fetchOptions || {};
         this.manualFlushMode = config.manualFlushMode ?? this.manualFlushMode;
-        if (getEnvironmentVariable("OTEL_ENABLED") === "true") {
+        if (getOtelEnabled()) {
             this.langSmithToOTELTranslator = new LangSmithToOTELTranslator();
         }
     }
@@ -686,9 +689,7 @@ export class Client {
     async processRunOperation(item) {
         clearTimeout(this.autoBatchTimeout);
         this.autoBatchTimeout = undefined;
-        if (item.action === "create") {
-            item.item = mergeRuntimeEnvIntoRunCreate(item.item);
-        }
+        item.item = mergeRuntimeEnvIntoRun(item.item);
         const itemPromise = this.autoBatchQueue.push(item);
         if (this.manualFlushMode) {
             // Rely on manual flushing in serverless environments
@@ -795,7 +796,7 @@ export class Client {
             }).catch(console.error);
             return;
         }
-        const mergedRunCreateParam = mergeRuntimeEnvIntoRunCreate(runCreate);
+        const mergedRunCreateParam = mergeRuntimeEnvIntoRun(runCreate);
         if (options?.apiKey !== undefined) {
             headers["x-api-key"] = options.apiKey;
         }

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_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 = 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";
@@ -43,6 +43,7 @@ exports.LANGSMITH_DOTTED_ORDER = "langsmith.span.dotted_order";
 exports.LANGSMITH_PARENT_RUN_ID = "langsmith.span.parent_id";
 exports.LANGSMITH_USAGE_METADATA = "langsmith.usage_metadata";
 exports.LANGSMITH_REFERENCE_EXAMPLE_ID = "langsmith.reference_example_id";
+exports.LANGSMITH_TRACEABLE = "langsmith.traceable";
 // 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

@@ -38,6 +38,7 @@ export declare const LANGSMITH_DOTTED_ORDER = "langsmith.span.dotted_order";
 export declare const LANGSMITH_PARENT_RUN_ID = "langsmith.span.parent_id";
 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 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

@@ -40,6 +40,7 @@ export const LANGSMITH_DOTTED_ORDER = "langsmith.span.dotted_order";
 export const LANGSMITH_PARENT_RUN_ID = "langsmith.span.parent_id";
 export const LANGSMITH_USAGE_METADATA = "langsmith.usage_metadata";
 export const LANGSMITH_REFERENCE_EXAMPLE_ID = "langsmith.reference_example_id";
+export const LANGSMITH_TRACEABLE = "langsmith.traceable";
 // 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/exporter.cjs

@@ -39,6 +39,7 @@ const constants = __importStar(require("./constants.cjs"));
 const env_js_1 = require("../../env.cjs");
 const env_js_2 = require("../../utils/env.cjs");
 const vercel_js_1 = require("../../utils/vercel.cjs");
+const constants_js_1 = require("./constants.cjs");
 /**
  * Convert headers string in format "name=value,name2=value2" to object
  */
@@ -54,6 +55,10 @@ function parseHeadersString(headersStr) {
     });
     return headers;
 }
+function isTraceableSpan(span) {
+    return (span.attributes[constants_js_1.LANGSMITH_TRACEABLE] === "true" ||
+        typeof span.attributes["ai.operationId"] === "string");
+}
 /**
  * LangSmith OpenTelemetry trace exporter that extends the standard OTLP trace exporter
  * with LangSmith-specific configuration and span attribute transformations.
@@ -71,11 +76,11 @@ function parseHeadersString(headersStr) {
  */
 class LangSmithOTLPTraceExporter extends exporter_trace_otlp_proto_1.OTLPTraceExporter {
     constructor(config) {
-        const defaultLsEndpoint = (0, env_js_2.getEnvironmentVariable)("OTEL_EXPORTER_OTLP_ENDPOINT") ||
-            (0, env_js_2.getLangSmithEnvironmentVariable)("ENDPOINT") ||
+        const defaultLsEndpoint = (0, env_js_2.getLangSmithEnvironmentVariable)("ENDPOINT") ||
             "https://api.smith.langchain.com";
         const defaultBaseUrl = defaultLsEndpoint.replace(/\/$/, "");
-        const defaultUrl = `${defaultBaseUrl}/otel/v1/traces`;
+        const defaultUrl = (0, env_js_2.getEnvironmentVariable)("OTEL_EXPORTER_OTLP_ENDPOINT") ??
+            `${defaultBaseUrl}/otel/v1/traces`;
         // Configure headers with API key and project if available
         let headers = config?.headers;
         if (headers === undefined) {
@@ -105,9 +110,16 @@ class LangSmithOTLPTraceExporter extends exporter_trace_otlp_proto_1.OTLPTraceEx
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "exportAllSpans", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.transformExportedSpan = config?.transformExportedSpan;
         this.projectName =
             config?.projectName ?? (0, env_js_2.getLangSmithEnvironmentVariable)("PROJECT");
+        this.exportAllSpans = config?.exportAllSpans;
     }
     export(spans, resultCallback) {
         if (!(0, env_js_1.isTracingEnabled)()) {
@@ -115,6 +127,9 @@ class LangSmithOTLPTraceExporter extends exporter_trace_otlp_proto_1.OTLPTraceEx
         }
         const runExport = async () => {
             for (let span of spans) {
+                if (!this.exportAllSpans && !isTraceableSpan(span)) {
+                    continue;
+                }
                 if (this.transformExportedSpan) {
                     span = await this.transformExportedSpan(span);
                 }

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

@@ -36,6 +36,16 @@ export type LangSmithOTLPTraceExporterConfig = ConstructorParameters<typeof OTLP
      * Default headers to add to exporter requests.
      */
     headers?: Record<string, string>;
+    /**
+     * Trace all spans.
+     *
+     * If true, all spans will be traced, regardless of whether they are
+     * normally interesting to LangSmith.
+     * If false, only selected spans will be traced.
+     *
+     * @default false
+     */
+    exportAllSpans?: boolean;
 };
 /**
  * LangSmith OpenTelemetry trace exporter that extends the standard OTLP trace exporter
@@ -55,6 +65,7 @@ export type LangSmithOTLPTraceExporterConfig = ConstructorParameters<typeof OTLP
 export declare class LangSmithOTLPTraceExporter extends OTLPTraceExporter {
     private transformExportedSpan?;
     private projectName?;
+    private exportAllSpans?;
     constructor(config?: LangSmithOTLPTraceExporterConfig);
     export(spans: ReadableSpan[], resultCallback: Parameters<OTLPTraceExporter["export"]>[1]): void;
 }

package/dist/experimental/otel/exporter.js

@@ -3,6 +3,7 @@ import * as constants from "./constants.js";
 import { isTracingEnabled } from "../../env.js";
 import { getEnvironmentVariable, getLangSmithEnvironmentVariable, } from "../../utils/env.js";
 import { extractUsageMetadata } from "../../utils/vercel.js";
+import { LANGSMITH_TRACEABLE } from "./constants.js";
 /**
  * Convert headers string in format "name=value,name2=value2" to object
  */
@@ -18,6 +19,10 @@ function parseHeadersString(headersStr) {
     });
     return headers;
 }
+function isTraceableSpan(span) {
+    return (span.attributes[LANGSMITH_TRACEABLE] === "true" ||
+        typeof span.attributes["ai.operationId"] === "string");
+}
 /**
  * LangSmith OpenTelemetry trace exporter that extends the standard OTLP trace exporter
  * with LangSmith-specific configuration and span attribute transformations.
@@ -35,11 +40,11 @@ function parseHeadersString(headersStr) {
  */
 export class LangSmithOTLPTraceExporter extends OTLPTraceExporter {
     constructor(config) {
-        const defaultLsEndpoint = getEnvironmentVariable("OTEL_EXPORTER_OTLP_ENDPOINT") ||
-            getLangSmithEnvironmentVariable("ENDPOINT") ||
+        const defaultLsEndpoint = getLangSmithEnvironmentVariable("ENDPOINT") ||
             "https://api.smith.langchain.com";
         const defaultBaseUrl = defaultLsEndpoint.replace(/\/$/, "");
-        const defaultUrl = `${defaultBaseUrl}/otel/v1/traces`;
+        const defaultUrl = getEnvironmentVariable("OTEL_EXPORTER_OTLP_ENDPOINT") ??
+            `${defaultBaseUrl}/otel/v1/traces`;
         // Configure headers with API key and project if available
         let headers = config?.headers;
         if (headers === undefined) {
@@ -69,9 +74,16 @@ export class LangSmithOTLPTraceExporter extends OTLPTraceExporter {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "exportAllSpans", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.transformExportedSpan = config?.transformExportedSpan;
         this.projectName =
             config?.projectName ?? getLangSmithEnvironmentVariable("PROJECT");
+        this.exportAllSpans = config?.exportAllSpans;
     }
     export(spans, resultCallback) {
         if (!isTracingEnabled()) {
@@ -79,6 +91,9 @@ export class LangSmithOTLPTraceExporter extends OTLPTraceExporter {
         }
         const runExport = async () => {
             for (let span of spans) {
+                if (!this.exportAllSpans && !isTraceableSpan(span)) {
+                    continue;
+                }
                 if (this.transformExportedSpan) {
                     span = await this.transformExportedSpan(span);
                 }

package/dist/experimental/otel/setup.cjs

@@ -41,16 +41,25 @@ const otel_js_1 = require("../../singletons/otel.cjs");
  * ```
  */
 const initializeOTEL = (config = {}) => {
-    const { globalTracerProvider, globalContextManager, exporterConfig } = config;
+    const { globalTracerProvider, globalContextManager, skipGlobalContextManagerSetup, exporterConfig, } = config;
     const otel = {
         trace: api_1.trace,
         context: api_1.context,
     };
     (0, otel_js_1.setOTELInstances)(otel);
-    if (!globalContextManager) {
-        const contextManager = new context_async_hooks_1.AsyncHooksContextManager();
-        contextManager.enable();
-        api_1.context.setGlobalContextManager(contextManager);
+    if (!globalContextManager && !skipGlobalContextManagerSetup) {
+        try {
+            const contextManager = new context_async_hooks_1.AsyncHooksContextManager();
+            contextManager.enable();
+            api_1.context.setGlobalContextManager(contextManager);
+        }
+        catch (e) {
+            console.log([
+                `Could not automatically set up an OTEL context manager.`,
+                `This may be expected if you have (or another imported library has) already set a global context manager.`,
+                `If expected, you can skip this warning by passing "skipGlobalContextManagerSetup: true" into your initializeOTEL call.`,
+            ].join("\n"));
+        }
     }
     const DEFAULT_LANGSMITH_SPAN_EXPORTER = new exporter_js_1.LangSmithOTLPTraceExporter(exporterConfig);
     const DEFAULT_LANGSMITH_SPAN_PROCESSOR = new sdk_trace_base_1.BatchSpanProcessor(DEFAULT_LANGSMITH_SPAN_EXPORTER);

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

@@ -15,6 +15,12 @@ export type InitializeOTELConfig = {
      * creating and globally setting a new one with AsyncHooksContextManager.
      */
     globalContextManager?: ContextManager;
+    /**
+     * Skip automatic initialization of a global context manager.
+     *
+     * @default false
+     */
+    skipGlobalContextManagerSetup?: boolean;
     /**
      * Optional configuration passed to the default LangSmith OTLP trace exporter.
      */

package/dist/experimental/otel/setup.js

@@ -38,16 +38,25 @@ import { setDefaultOTLPTracerComponents, setOTELInstances, } from "../../singlet
  * ```
  */
 export const initializeOTEL = (config = {}) => {
-    const { globalTracerProvider, globalContextManager, exporterConfig } = config;
+    const { globalTracerProvider, globalContextManager, skipGlobalContextManagerSetup, exporterConfig, } = config;
     const otel = {
         trace: otel_trace,
         context: otel_context,
     };
     setOTELInstances(otel);
-    if (!globalContextManager) {
-        const contextManager = new AsyncHooksContextManager();
-        contextManager.enable();
-        otel_context.setGlobalContextManager(contextManager);
+    if (!globalContextManager && !skipGlobalContextManagerSetup) {
+        try {
+            const contextManager = new AsyncHooksContextManager();
+            contextManager.enable();
+            otel_context.setGlobalContextManager(contextManager);
+        }
+        catch (e) {
+            console.log([
+                `Could not automatically set up an OTEL context manager.`,
+                `This may be expected if you have (or another imported library has) already set a global context manager.`,
+                `If expected, you can skip this warning by passing "skipGlobalContextManagerSetup: true" into your initializeOTEL call.`,
+            ].join("\n"));
+        }
     }
     const DEFAULT_LANGSMITH_SPAN_EXPORTER = new LangSmithOTLPTraceExporter(exporterConfig);
     const DEFAULT_LANGSMITH_SPAN_PROCESSOR = new BatchSpanProcessor(DEFAULT_LANGSMITH_SPAN_EXPORTER);

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.47";
+exports.__version__ = "0.3.49-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.47";
+export declare const __version__ = "0.3.49-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.47";
+export const __version__ = "0.3.49-rc.0";

package/dist/singletons/otel.cjs

@@ -18,8 +18,8 @@ class MockTracer {
         });
     }
     startActiveSpan(_name, ...args) {
-        if (!this.hasWarned && (0, env_js_1.getEnvironmentVariable)("OTEL_ENABLED") === "true") {
-            console.warn("You have enabled OTEL export via the `OTEL_ENABLED` environment variable, but have not initialized the required OTEL instances. " +
+        if (!this.hasWarned && (0, env_js_1.getOtelEnabled)()) {
+            console.warn("You have enabled OTEL export via the `OTEL_ENABLED` or `LANGSMITH_OTEL_ENABLED` environment variable, but have not initialized the required OTEL instances. " +
                 'Please add:\n```\nimport { initializeOTEL } from "langsmith/experimental/otel/setup";\ninitializeOTEL();\n```\nat the beginning of your code.');
             this.hasWarned = true;
         }

package/dist/singletons/otel.js

@@ -1,5 +1,5 @@
 // Should not import any OTEL packages to avoid pulling in optional deps.
-import { getEnvironmentVariable } from "../utils/env.js";
+import { getOtelEnabled } from "../utils/env.js";
 class MockTracer {
     constructor() {
         Object.defineProperty(this, "hasWarned", {
@@ -10,8 +10,8 @@ class MockTracer {
         });
     }
     startActiveSpan(_name, ...args) {
-        if (!this.hasWarned && getEnvironmentVariable("OTEL_ENABLED") === "true") {
-            console.warn("You have enabled OTEL export via the `OTEL_ENABLED` environment variable, but have not initialized the required OTEL instances. " +
+        if (!this.hasWarned && getOtelEnabled()) {
+            console.warn("You have enabled OTEL export via the `OTEL_ENABLED` or `LANGSMITH_OTEL_ENABLED` environment variable, but have not initialized the required OTEL instances. " +
                 'Please add:\n```\nimport { initializeOTEL } from "langsmith/experimental/otel/setup";\ninitializeOTEL();\n```\nat the beginning of your code.');
             this.hasWarned = true;
         }

package/dist/traceable.cjs

@@ -20,7 +20,7 @@ traceable_js_1.AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new n
 function maybeCreateOtelContext(runTree, projectName, tracer
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 ) {
-    if (!runTree || (0, env_js_2.getEnvironmentVariable)("OTEL_ENABLED") !== "true") {
+    if (!runTree || !(0, env_js_2.getOtelEnabled)()) {
         return;
     }
     const otel_trace = (0, otel_js_1.getOTELTrace)();
@@ -29,7 +29,9 @@ function maybeCreateOtelContext(runTree, projectName, tracer
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return (fn) => {
             const resolvedTracer = tracer ?? otel_trace.getTracer("langsmith", index_js_1.__version__);
-            const attributes = {};
+            const attributes = {
+                [constants_js_2.LANGSMITH_TRACEABLE]: "true",
+            };
             if (runTree.reference_example_id) {
                 attributes[constants_js_2.LANGSMITH_REFERENCE_EXAMPLE_ID] =
                     runTree.reference_example_id;

package/dist/traceable.js

@@ -4,11 +4,11 @@ import { isTracingEnabled } from "./env.js";
 import { ROOT, AsyncLocalStorageProviderSingleton, getCurrentRunTree, } from "./singletons/traceable.js";
 import { _LC_CONTEXT_VARIABLES_KEY } from "./singletons/constants.js";
 import { isKVMap, isReadableStream, isAsyncIterable, isIteratorLike, isThenable, isGenerator, isPromiseMethod, } from "./utils/asserts.js";
-import { getEnvironmentVariable } from "./utils/env.js";
+import { getOtelEnabled } 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, LANGSMITH_SESSION_NAME, } from "./experimental/otel/constants.js";
+import { LANGSMITH_REFERENCE_EXAMPLE_ID, LANGSMITH_SESSION_NAME, LANGSMITH_TRACEABLE, } from "./experimental/otel/constants.js";
 AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new AsyncLocalStorage());
 /**
  * Create OpenTelemetry context manager from RunTree if OTEL is enabled.
@@ -16,7 +16,7 @@ AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new AsyncLocalStorag
 function maybeCreateOtelContext(runTree, projectName, tracer
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 ) {
-    if (!runTree || getEnvironmentVariable("OTEL_ENABLED") !== "true") {
+    if (!runTree || !getOtelEnabled()) {
         return;
     }
     const otel_trace = getOTELTrace();
@@ -25,7 +25,9 @@ function maybeCreateOtelContext(runTree, projectName, tracer
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return (fn) => {
             const resolvedTracer = tracer ?? otel_trace.getTracer("langsmith", __version__);
-            const attributes = {};
+            const attributes = {
+                [LANGSMITH_TRACEABLE]: "true",
+            };
             if (runTree.reference_example_id) {
                 attributes[LANGSMITH_REFERENCE_EXAMPLE_ID] =
                     runTree.reference_example_id;

package/dist/utils/env.cjs

@@ -9,6 +9,7 @@ exports.getEnvironmentVariable = getEnvironmentVariable;
 exports.getLangSmithEnvironmentVariable = getLangSmithEnvironmentVariable;
 exports.setEnvironmentVariable = setEnvironmentVariable;
 exports.getShas = getShas;
+exports.getOtelEnabled = getOtelEnabled;
 // Inlined from https://github.com/flexdinesh/browser-or-node
 const index_js_1 = require("../index.cjs");
 let globalEnv;
@@ -230,3 +231,7 @@ function getShas() {
     cachedCommitSHAs = shas;
     return shas;
 }
+function getOtelEnabled() {
+    return (getEnvironmentVariable("OTEL_ENABLED") === "true" ||
+        getLangSmithEnvironmentVariable("OTEL_ENABLED") === "true");
+}

package/dist/utils/env.d.ts

@@ -58,4 +58,5 @@ interface ICommitSHAs {
  * @returns {string | undefined} The Git commit SHA or undefined if not found.
  */
 export declare function getShas(): ICommitSHAs;
+export declare function getOtelEnabled(): boolean;
 export {};

package/dist/utils/env.js

@@ -213,3 +213,7 @@ export function getShas() {
     cachedCommitSHAs = shas;
     return shas;
 }
+export function getOtelEnabled() {
+    return (getEnvironmentVariable("OTEL_ENABLED") === "true" ||
+        getLangSmithEnvironmentVariable("OTEL_ENABLED") === "true");
+}

package/package.json

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