@nocobase/plugin-ai 1.9.32 → 1.9.34

package/dist/node_modules/@langchain/core/node_modules/langsmith/dist/experimental/otel/exporter.d.ts

@@ -0,0 +1,60 @@
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
+import { ReadableSpan } from "@opentelemetry/sdk-trace-base";
+export type LangSmithOTLPTraceExporterConfig = ConstructorParameters<typeof OTLPTraceExporter>[0] & {
+    /**
+     * A function that takes an exported span and returns a transformed version of it.
+     * May be used to add or remove attributes from the span.
+     *
+     * For example, to add a custom attribute to the span, you can do:
+     *
+     * ```ts
+     * import { LangSmithOTLPTraceExporter } from "langsmith/experimental/otel/exporter";
+     *
+     * const exporter = new LangSmithOTLPTraceExporter({
+     *   transformExportedSpan: (span) => {
+     *     if (span.name === "foo") {
+     *       span.attributes["langsmith.metadata.bar"] = "baz";
+     *     }
+     *     return span;
+     *   }
+     * });
+     * ```
+     *
+     * @param span - The span to transform.
+     * @returns A transformed version of the span.
+     */
+    transformExportedSpan?: (span: ReadableSpan) => ReadableSpan | Promise<ReadableSpan>;
+    /**
+     * The API key to use for the exporter.
+     */
+    apiKey?: string;
+    /**
+     * 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
+ * with LangSmith-specific configuration and span attribute transformations.
+ *
+ * This exporter automatically configures itself with LangSmith endpoints and API keys,
+ * based on your LANGSMITH_API_KEY and LANGSMITH_PROJECT environment variables.
+ * Will also respect OTEL_EXPORTER_OTLP_ENDPOINT or OTEL_EXPORTER_OTLP_HEADERS environment
+ * variables if set.
+ *
+ * @param config - Optional configuration object that accepts all OTLPTraceExporter parameters.
+ *                 If not provided, uses default LangSmith configuration:
+ *                 - `url`: Defaults to LangSmith OTEL endpoint (`${LANGSMITH_ENDPOINT}/otel/v1/traces`)
+ *                 - `headers`: Auto-configured with LangSmith API key and project headers
+ *                 Any provided config will override these defaults.
+ */
+export declare class LangSmithOTLPTraceExporter extends OTLPTraceExporter {
+    private transformExportedSpan?;
+    private projectName?;
+    constructor(config?: LangSmithOTLPTraceExporterConfig);
+    export(spans: ReadableSpan[], resultCallback: Parameters<OTLPTraceExporter["export"]>[1]): void;
+}

package/dist/node_modules/@langchain/core/node_modules/langsmith/dist/experimental/otel/exporter.js

@@ -0,0 +1,185 @@
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
+import * as constants from "./constants.js";
+import { isTracingEnabled } from "../../env.js";
+import { getEnvironmentVariable, getLangSmithEnvironmentVariable, } from "../../utils/env.js";
+import { extractUsageMetadata } from "../../utils/vercel.js";
+/**
+ * Convert headers string in format "name=value,name2=value2" to object
+ */
+function parseHeadersString(headersStr) {
+    const headers = {};
+    if (!headersStr)
+        return headers;
+    headersStr.split(",").forEach((pair) => {
+        const [name, ...valueParts] = pair.split("=");
+        if (name && valueParts.length > 0) {
+            headers[name.trim()] = valueParts.join("=").trim();
+        }
+    });
+    return headers;
+}
+/**
+ * LangSmith OpenTelemetry trace exporter that extends the standard OTLP trace exporter
+ * with LangSmith-specific configuration and span attribute transformations.
+ *
+ * This exporter automatically configures itself with LangSmith endpoints and API keys,
+ * based on your LANGSMITH_API_KEY and LANGSMITH_PROJECT environment variables.
+ * Will also respect OTEL_EXPORTER_OTLP_ENDPOINT or OTEL_EXPORTER_OTLP_HEADERS environment
+ * variables if set.
+ *
+ * @param config - Optional configuration object that accepts all OTLPTraceExporter parameters.
+ *                 If not provided, uses default LangSmith configuration:
+ *                 - `url`: Defaults to LangSmith OTEL endpoint (`${LANGSMITH_ENDPOINT}/otel/v1/traces`)
+ *                 - `headers`: Auto-configured with LangSmith API key and project headers
+ *                 Any provided config will override these defaults.
+ */
+export class LangSmithOTLPTraceExporter extends OTLPTraceExporter {
+    constructor(config) {
+        const defaultLsEndpoint = getLangSmithEnvironmentVariable("ENDPOINT") ||
+            "https://api.smith.langchain.com";
+        const defaultBaseUrl = defaultLsEndpoint.replace(/\/$/, "");
+        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) {
+            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,
+            ...config,
+        });
+        Object.defineProperty(this, "transformExportedSpan", {
+            enumerable: true,
+            configurable: true,
+            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()) {
+            return resultCallback({ code: 0 });
+        }
+        const runExport = async () => {
+            for (let span of spans) {
+                if (this.transformExportedSpan) {
+                    span = await this.transformExportedSpan(span);
+                }
+                if (!span.attributes[constants.GENAI_PROMPT]) {
+                    if (span.attributes["ai.prompt"]) {
+                        span.attributes[constants.GENAI_PROMPT] =
+                            span.attributes["ai.prompt"];
+                    }
+                    if (span.attributes["ai.prompt.messages"] &&
+                        typeof span.attributes["ai.prompt.messages"] === "string") {
+                        let messages;
+                        try {
+                            messages = JSON.parse(span.attributes["ai.prompt.messages"]);
+                        }
+                        catch (e) {
+                            console.error("Failed to parse ai.prompt.messages", e);
+                        }
+                        if (messages && Array.isArray(messages)) {
+                            span.attributes[constants.GENAI_PROMPT] = JSON.stringify({
+                                input: messages,
+                            });
+                        }
+                    }
+                    if (span.attributes["ai.toolCall.input"]) {
+                        span.attributes[constants.GENAI_PROMPT] =
+                            span.attributes["ai.toolCall.input"];
+                    }
+                    else if (span.attributes["ai.toolCall.args"]) {
+                        span.attributes[constants.GENAI_PROMPT] =
+                            span.attributes["ai.toolCall.args"];
+                    }
+                }
+                // Iterate over all attributes starting with "ai.telemetry.metadata"
+                for (const [key, value] of Object.entries(span.attributes)) {
+                    if (key.startsWith("ai.telemetry.metadata.")) {
+                        if (key === "ai.telemetry.metadata.ls_project_name") {
+                            span.attributes[constants.LANGSMITH_SESSION_NAME] = value;
+                        }
+                        else if (key === "ai.telemetry.metadata.ls_project_id") {
+                            span.attributes[constants.LANGSMITH_SESSION_ID] = value;
+                        }
+                        else {
+                            const metadataKey = key.replace("ai.telemetry.metadata.", "");
+                            span.attributes[`${constants.LANGSMITH_METADATA}.${metadataKey}`] = value;
+                        }
+                        delete span.attributes[key];
+                    }
+                }
+                if (!span.attributes[constants.GENAI_COMPLETION]) {
+                    if (span.attributes["ai.response.text"]) {
+                        span.attributes[constants.GENAI_COMPLETION] =
+                            span.attributes["ai.response.text"];
+                    }
+                    if (span.attributes["ai.response.choices"]) {
+                        span.attributes[constants.GENAI_COMPLETION] =
+                            span.attributes["ai.response.choices"];
+                    }
+                    if (span.attributes["ai.response.object"]) {
+                        span.attributes[constants.GENAI_COMPLETION] =
+                            span.attributes["ai.response.object"];
+                    }
+                    if (span.attributes["ai.response.toolCalls"]) {
+                        span.attributes[constants.GENAI_COMPLETION] =
+                            span.attributes["ai.response.toolCalls"];
+                    }
+                    if (span.attributes["ai.toolCall.output"]) {
+                        span.attributes[constants.GENAI_COMPLETION] =
+                            span.attributes["ai.toolCall.output"];
+                    }
+                    else if (span.attributes["ai.toolCall.result"]) {
+                        span.attributes[constants.GENAI_COMPLETION] =
+                            span.attributes["ai.toolCall.result"];
+                    }
+                }
+                if (typeof span.attributes["ai.operationId"] === "string" &&
+                    constants.AI_SDK_LLM_OPERATIONS.includes(span.attributes["ai.operationId"])) {
+                    span.attributes[constants.LANGSMITH_RUN_TYPE] = "llm";
+                    const usageMetadata = extractUsageMetadata(span);
+                    span.attributes[constants.LANGSMITH_USAGE_METADATA] =
+                        JSON.stringify(usageMetadata);
+                }
+                else if (typeof span.attributes["ai.operationId"] === "string" &&
+                    constants.AI_SDK_TOOL_OPERATIONS.includes(span.attributes["ai.operationId"])) {
+                    span.attributes[constants.LANGSMITH_RUN_TYPE] = "tool";
+                    if (span.attributes["ai.toolCall.name"]) {
+                        span.attributes[constants.LANGSMITH_NAME] =
+                            span.attributes["ai.toolCall.name"];
+                    }
+                }
+                if (span.attributes[`${constants.LANGSMITH_METADATA}.ls_run_name`]) {
+                    span.attributes[constants.LANGSMITH_NAME] =
+                        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);
+        };
+        void runExport();
+    }
+}

package/dist/node_modules/@langchain/core/node_modules/langsmith/dist/experimental/otel/processor.cjs

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LangSmithOTLPSpanProcessor = void 0;
+exports.isTraceableSpan = isTraceableSpan;
+const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+const constants_js_1 = require("./constants.cjs");
+const utils_js_1 = require("./utils.cjs");
+const run_trees_js_1 = require("../../run_trees.cjs");
+function isTraceableSpan(span) {
+    return (span.attributes[constants_js_1.LANGSMITH_TRACEABLE] === "true" ||
+        typeof span.attributes["ai.operationId"] === "string");
+}
+function getParentSpanId(span) {
+    // Backcompat shim to support OTEL 1.x and 2.x
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return (span.parentSpanId ?? span.parentSpanContext?.spanId ?? undefined);
+}
+/**
+ * Span processor that filters out spans that are not LangSmith-related and
+ * usually should not be traced.
+ */
+class LangSmithOTLPSpanProcessor extends sdk_trace_base_1.BatchSpanProcessor {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "traceMap", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
+    }
+    onStart(span, parentContext) {
+        if (!this.traceMap[span.spanContext().traceId]) {
+            this.traceMap[span.spanContext().traceId] = {
+                spanInfo: {},
+                spanCount: 0,
+            };
+        }
+        this.traceMap[span.spanContext().traceId].spanCount++;
+        const isTraceable = isTraceableSpan(span);
+        const parentSpanId = getParentSpanId(span);
+        this.traceMap[span.spanContext().traceId].spanInfo[span.spanContext().spanId] = {
+            isTraceable,
+            parentSpanId,
+        };
+        let currentCandidateParentSpanId = parentSpanId;
+        let traceableParentId;
+        while (currentCandidateParentSpanId) {
+            const currentSpanInfo = this.traceMap[span.spanContext().traceId].spanInfo[currentCandidateParentSpanId];
+            if (currentSpanInfo?.isTraceable) {
+                traceableParentId = currentCandidateParentSpanId;
+                break;
+            }
+            currentCandidateParentSpanId = currentSpanInfo?.parentSpanId;
+        }
+        if (!traceableParentId) {
+            span.attributes[constants_js_1.LANGSMITH_IS_ROOT] = true;
+        }
+        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);
+        }
+    }
+    onEnd(span) {
+        const traceInfo = this.traceMap[span.spanContext().traceId];
+        if (!traceInfo)
+            return;
+        const spanInfo = traceInfo.spanInfo[span.spanContext().spanId];
+        if (!spanInfo)
+            return;
+        // Decrement span count and cleanup trace if all spans are done
+        traceInfo.spanCount--;
+        if (traceInfo.spanCount <= 0) {
+            delete this.traceMap[span.spanContext().traceId];
+        }
+        if (spanInfo.isTraceable) {
+            super.onEnd(span);
+        }
+    }
+    async shutdown() {
+        await run_trees_js_1.RunTree.getSharedClient().awaitPendingTraceBatches();
+        await super.shutdown();
+    }
+}
+exports.LangSmithOTLPSpanProcessor = LangSmithOTLPSpanProcessor;

package/dist/node_modules/@langchain/core/node_modules/langsmith/dist/experimental/otel/processor.d.ts

@@ -0,0 +1,13 @@
+import { ReadableSpan, Span, BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { Context } from "@opentelemetry/api";
+export declare function isTraceableSpan(span: ReadableSpan): boolean;
+/**
+ * Span processor that filters out spans that are not LangSmith-related and
+ * usually should not be traced.
+ */
+export declare class LangSmithOTLPSpanProcessor extends BatchSpanProcessor {
+    private traceMap;
+    onStart(span: Span, parentContext: Context): void;
+    onEnd(span: ReadableSpan): void;
+    shutdown(): Promise<void>;
+}

package/dist/node_modules/@langchain/core/node_modules/langsmith/dist/experimental/otel/processor.js

@@ -0,0 +1,85 @@
+import { BatchSpanProcessor, } from "@opentelemetry/sdk-trace-base";
+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) {
+    return (span.attributes[LANGSMITH_TRACEABLE] === "true" ||
+        typeof span.attributes["ai.operationId"] === "string");
+}
+function getParentSpanId(span) {
+    // Backcompat shim to support OTEL 1.x and 2.x
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return (span.parentSpanId ?? span.parentSpanContext?.spanId ?? undefined);
+}
+/**
+ * Span processor that filters out spans that are not LangSmith-related and
+ * usually should not be traced.
+ */
+export class LangSmithOTLPSpanProcessor extends BatchSpanProcessor {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "traceMap", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
+    }
+    onStart(span, parentContext) {
+        if (!this.traceMap[span.spanContext().traceId]) {
+            this.traceMap[span.spanContext().traceId] = {
+                spanInfo: {},
+                spanCount: 0,
+            };
+        }
+        this.traceMap[span.spanContext().traceId].spanCount++;
+        const isTraceable = isTraceableSpan(span);
+        const parentSpanId = getParentSpanId(span);
+        this.traceMap[span.spanContext().traceId].spanInfo[span.spanContext().spanId] = {
+            isTraceable,
+            parentSpanId,
+        };
+        let currentCandidateParentSpanId = parentSpanId;
+        let traceableParentId;
+        while (currentCandidateParentSpanId) {
+            const currentSpanInfo = this.traceMap[span.spanContext().traceId].spanInfo[currentCandidateParentSpanId];
+            if (currentSpanInfo?.isTraceable) {
+                traceableParentId = currentCandidateParentSpanId;
+                break;
+            }
+            currentCandidateParentSpanId = currentSpanInfo?.parentSpanId;
+        }
+        if (!traceableParentId) {
+            span.attributes[LANGSMITH_IS_ROOT] = true;
+        }
+        else {
+            span.attributes[LANGSMITH_PARENT_RUN_ID] =
+                getUuidFromOtelSpanId(traceableParentId);
+            span.attributes[LANGSMITH_TRACEABLE_PARENT_OTEL_SPAN_ID] =
+                traceableParentId;
+        }
+        if (isTraceable) {
+            super.onStart(span, parentContext);
+        }
+    }
+    onEnd(span) {
+        const traceInfo = this.traceMap[span.spanContext().traceId];
+        if (!traceInfo)
+            return;
+        const spanInfo = traceInfo.spanInfo[span.spanContext().spanId];
+        if (!spanInfo)
+            return;
+        // Decrement span count and cleanup trace if all spans are done
+        traceInfo.spanCount--;
+        if (traceInfo.spanCount <= 0) {
+            delete this.traceMap[span.spanContext().traceId];
+        }
+        if (spanInfo.isTraceable) {
+            super.onEnd(span);
+        }
+    }
+    async shutdown() {
+        await RunTree.getSharedClient().awaitPendingTraceBatches();
+        await super.shutdown();
+    }
+}

package/dist/node_modules/@langchain/core/node_modules/langsmith/dist/experimental/otel/setup.cjs

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeOTEL = void 0;
+// Avoid async hooks as even a peer dep to avoid pulling into
+// non-node build environments.
+// eslint-disable-next-line import/no-extraneous-dependencies
+const context_async_hooks_1 = require("@opentelemetry/context-async-hooks");
+const api_1 = require("@opentelemetry/api");
+const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+const exporter_js_1 = require("./exporter.cjs");
+const processor_js_1 = require("./processor.cjs");
+const otel_js_1 = require("../../singletons/otel.cjs");
+/**
+ * Initializes OpenTelemetry with LangSmith-specific configuration for tracing.
+ *
+ * Call this once at the start of your application to enable tracing integration. Sets global
+ * OpenTelemetry components including the tracer provider and context manager.
+ *
+ * Requires the following peer dependencies to be installed:
+ * - @opentelemetry/api
+ * - @opentelemetry/sdk-trace-base
+ * - @opentelemetry/exporter-trace-otlp-proto
+ * - @opentelemetry/context-async-hooks
+ *
+ * @param options - Configuration options
+ * @param options.globalTracerProvider - Optional custom TracerProvider to use instead of creating and globally setting a new one
+ * @returns Object containing the initialized OTEL components (tracer provider, span processor, exporter)
+ *
+ * @example
+ * ```typescript
+ * import { initializeOTEL } from "langsmith/experimental/otel/setup";
+ * initializeOTEL();
+ * ```
+ *
+ * @example With custom tracer provider
+ * ```typescript
+ * import { initializeOTEL } from "langsmith/experimental/otel/setup";
+ * import { BasicTracerProvider } from "@opentelemetry/sdk-trace-base";
+ *
+ * const customProvider = new BasicTracerProvider();
+ * initializeOTEL({ globalTracerProvider: customProvider });
+ * ```
+ */
+const initializeOTEL = (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 && !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 processor_js_1.LangSmithOTLPSpanProcessor(DEFAULT_LANGSMITH_SPAN_EXPORTER);
+    if (!globalTracerProvider) {
+        const DEFAULT_LANGSMITH_TRACER_PROVIDER = new sdk_trace_base_1.BasicTracerProvider({
+            spanProcessors: [DEFAULT_LANGSMITH_SPAN_PROCESSOR],
+        });
+        const defaultComponents = {
+            DEFAULT_LANGSMITH_SPAN_PROCESSOR,
+            DEFAULT_LANGSMITH_TRACER_PROVIDER,
+            DEFAULT_LANGSMITH_SPAN_EXPORTER,
+        };
+        // If user has set global tracer before, this fails and returns false
+        const globalSuccessfullyOverridden = api_1.trace.setGlobalTracerProvider(defaultComponents.DEFAULT_LANGSMITH_TRACER_PROVIDER);
+        if (globalSuccessfullyOverridden) {
+            (0, otel_js_1.setDefaultOTLPTracerComponents)(defaultComponents);
+        }
+        return defaultComponents;
+    }
+    else {
+        const defaultComponents = {
+            DEFAULT_LANGSMITH_TRACER_PROVIDER: globalTracerProvider,
+            DEFAULT_LANGSMITH_SPAN_PROCESSOR,
+            DEFAULT_LANGSMITH_SPAN_EXPORTER,
+        };
+        (0, otel_js_1.setDefaultOTLPTracerComponents)(defaultComponents);
+        return defaultComponents;
+    }
+};
+exports.initializeOTEL = initializeOTEL;

package/dist/node_modules/@langchain/core/node_modules/langsmith/dist/experimental/otel/setup.d.ts

@@ -0,0 +1,64 @@
+import { type TracerProvider, type ContextManager } from "@opentelemetry/api";
+import { LangSmithOTLPTraceExporter, LangSmithOTLPTraceExporterConfig } from "./exporter.js";
+import { LangSmithOTLPSpanProcessor } from "./processor.js";
+/**
+ * Configuration options for initializing OpenTelemetry with LangSmith.
+ */
+export type InitializeOTELConfig = {
+    /**
+     * Optional custom OTEL TracerProvider to use instead of
+     * creating and globally setting a new one.
+     */
+    globalTracerProvider?: TracerProvider;
+    /**
+     * Optional custom OTEL ContextManager to use instead of
+     * 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.
+     */
+    exporterConfig?: LangSmithOTLPTraceExporterConfig;
+};
+/**
+ * Initializes OpenTelemetry with LangSmith-specific configuration for tracing.
+ *
+ * Call this once at the start of your application to enable tracing integration. Sets global
+ * OpenTelemetry components including the tracer provider and context manager.
+ *
+ * Requires the following peer dependencies to be installed:
+ * - @opentelemetry/api
+ * - @opentelemetry/sdk-trace-base
+ * - @opentelemetry/exporter-trace-otlp-proto
+ * - @opentelemetry/context-async-hooks
+ *
+ * @param options - Configuration options
+ * @param options.globalTracerProvider - Optional custom TracerProvider to use instead of creating and globally setting a new one
+ * @returns Object containing the initialized OTEL components (tracer provider, span processor, exporter)
+ *
+ * @example
+ * ```typescript
+ * import { initializeOTEL } from "langsmith/experimental/otel/setup";
+ * initializeOTEL();
+ * ```
+ *
+ * @example With custom tracer provider
+ * ```typescript
+ * import { initializeOTEL } from "langsmith/experimental/otel/setup";
+ * import { BasicTracerProvider } from "@opentelemetry/sdk-trace-base";
+ *
+ * const customProvider = new BasicTracerProvider();
+ * initializeOTEL({ globalTracerProvider: customProvider });
+ * ```
+ */
+export declare const initializeOTEL: (config?: InitializeOTELConfig) => {
+    DEFAULT_LANGSMITH_TRACER_PROVIDER: TracerProvider;
+    DEFAULT_LANGSMITH_SPAN_PROCESSOR: LangSmithOTLPSpanProcessor;
+    DEFAULT_LANGSMITH_SPAN_EXPORTER: LangSmithOTLPTraceExporter;
+};