@microsoft/opentelemetry 0.1.0-alpha.1

package/dist/esm/distro/distro.js

@@ -0,0 +1,120 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { metrics, trace } from "@opentelemetry/api";
+import { logs } from "@opentelemetry/api-logs";
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import { InternalConfig } from "../shared/config.js";
+import { MetricHandler } from "../metrics/index.js";
+import { TraceHandler } from "../traces/handler.js";
+import { LogHandler } from "../logs/index.js";
+import { AZURE_MONITOR_OPENTELEMETRY_VERSION } from "../types.js";
+import { patchOpenTelemetryInstrumentationEnable } from "../utils/opentelemetryInstrumentationPatcher.js";
+import { parseResourceDetectorsFromEnvVar } from "../utils/common.js";
+import { setupAzureMonitorComponents } from "../azureMonitorSetup.js";
+import { isOtlpEnabled, createOtlpComponents } from "../otlp/index.js";
+import { MICROSOFT_OPENTELEMETRY_VERSION } from "./types.js";
+process.env["AZURE_MONITOR_DISTRO_VERSION"] = AZURE_MONITOR_OPENTELEMETRY_VERSION;
+process.env["MICROSOFT_OPENTELEMETRY_VERSION"] = MICROSOFT_OPENTELEMETRY_VERSION;
+let sdk;
+let disposeAzureMonitor;
+/**
+ * Initialize Microsoft OpenTelemetry distribution.
+ *
+ * This is the primary entry point for the distro. It sets up OpenTelemetry
+ * providers and instrumentations, then attaches the configured exporters:
+ * - Azure Monitor (when `options.azureMonitor` is provided)
+ * - OTLP HTTP (when `OTEL_EXPORTER_OTLP_ENDPOINT` is set)
+ * - A365 (future)
+ *
+ * @param options - Microsoft OpenTelemetry configuration options
+ */
+export function useMicrosoftOpenTelemetry(options) {
+    const config = new InternalConfig(options);
+    patchOpenTelemetryInstrumentationEnable();
+    // ── Azure Monitor components (statsbeat, browser SDK loader, etc.) ─
+    disposeAzureMonitor = setupAzureMonitorComponents(config);
+    // ── Register global providers ─────────────────────────────────────
+    // Remove global providers in OpenTelemetry, these would be overridden if present
+    metrics.disable();
+    trace.disable();
+    logs.disable();
+    // Clear the entire OpenTelemetry API global state to avoid version conflicts.
+    // The disable() calls above remove individual providers but leave the `version` field
+    // on the global object intact. If a different version of @opentelemetry/api was loaded
+    // first (e.g. by a VS Code extension host or another extension), the stale version
+    // causes registerGlobal() in sdk.start() to fail with "All API registration versions
+    // must match", resulting in Noop providers. Deleting the global object forces
+    // registerGlobal() to create a fresh one with the correct version.
+    const globalOpentelemetryApiKey = Symbol.for("opentelemetry.js.api.1");
+    delete globalThis[globalOpentelemetryApiKey];
+    // ── Azure Monitor handlers ────────────────────────────────────────
+    const metricHandler = new MetricHandler(config);
+    const traceHandler = new TraceHandler(config, metricHandler);
+    const logHandler = new LogHandler(config, metricHandler);
+    const instrumentations = traceHandler
+        .getInstrumentations()
+        .concat(logHandler.getInstrumentations());
+    const resourceDetectorsList = parseResourceDetectorsFromEnvVar();
+    // ── Merge user-provided processors / readers / views ──────────────
+    // Clone caller-provided arrays to avoid mutating them when OTLP components are appended.
+    const spanProcessors = [...(options?.spanProcessors || [])];
+    const logRecordProcessors = [...(options?.logRecordProcessors || [])];
+    const customViews = [...(options?.views || [])];
+    // Always include Azure Monitor metric reader
+    const metricReaders = [
+        metricHandler.getMetricReader(),
+        ...(options?.metricReaders || []),
+    ];
+    // ── OTLP HTTP exporters (enabled via OTEL_EXPORTER_OTLP_ENDPOINT) ─
+    if (isOtlpEnabled()) {
+        const otlp = createOtlpComponents();
+        if (otlp.spanProcessor) {
+            spanProcessors.push(otlp.spanProcessor);
+        }
+        if (otlp.metricReader) {
+            metricReaders.push(otlp.metricReader);
+        }
+        if (otlp.logRecordProcessor) {
+            logRecordProcessors.push(otlp.logRecordProcessor);
+        }
+    }
+    const views = metricHandler.getViews().concat(customViews);
+    // ── Create and start NodeSDK ──────────────────────────────────────
+    const sdkConfig = {
+        autoDetectResources: true,
+        metricReaders: metricReaders,
+        views,
+        instrumentations: instrumentations,
+        logRecordProcessors: [
+            logHandler.getAzureLogRecordProcessor(),
+            ...logRecordProcessors,
+            logHandler.getBatchLogRecordProcessor(),
+        ],
+        resource: config.resource,
+        sampler: traceHandler.getSampler(),
+        spanProcessors: [
+            traceHandler.getAzureMonitorSpanProcessor(),
+            ...spanProcessors,
+            traceHandler.getBatchSpanProcessor(),
+        ],
+        resourceDetectors: resourceDetectorsList,
+    };
+    sdk = new NodeSDK(sdkConfig);
+    // TODO: Enable auto-attach warning — see autoAttach.ts
+    sdk.start();
+}
+/**
+ * Shutdown Microsoft OpenTelemetry distribution.
+ */
+export function shutdownMicrosoftOpenTelemetry() {
+    disposeAzureMonitor?.();
+    return sdk?.shutdown();
+}
+/**
+ * Get the internal SDK instance for testing purposes
+ * @internal
+ */
+export function _getSdkInstance() {
+    return sdk;
+}
+//# sourceMappingURL=distro.js.map

package/dist/esm/distro/distro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distro.js","sourceRoot":"","sources":["../../../src/distro/distro.ts"],"names":[],"mappings":"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"}

package/dist/esm/distro/index.d.ts

@@ -0,0 +1,4 @@
+export type { MicrosoftOpenTelemetryOptions, InstrumentationOptions, BrowserSdkLoaderOptions, A365Options, } from "./types.js";
+export { MICROSOFT_OPENTELEMETRY_VERSION } from "./types.js";
+export { useMicrosoftOpenTelemetry, shutdownMicrosoftOpenTelemetry } from "./distro.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/distro/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/distro/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/distro/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export { MICROSOFT_OPENTELEMETRY_VERSION } from "./types.js";
+export { useMicrosoftOpenTelemetry, shutdownMicrosoftOpenTelemetry } from "./distro.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/distro/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/distro/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAQlC,OAAO,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/distro/types.d.ts

@@ -0,0 +1,41 @@
+import type { Resource } from "@opentelemetry/resources";
+import type { LogRecordProcessor } from "@opentelemetry/sdk-logs";
+import type { MetricReader, ViewOptions } from "@opentelemetry/sdk-metrics";
+import type { SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import type { AzureMonitorOpenTelemetryOptions, InstrumentationOptions, BrowserSdkLoaderOptions } from "../types.js";
+import type { A365Options } from "../_a365/index.js";
+export type { InstrumentationOptions, BrowserSdkLoaderOptions, A365Options };
+/**
+ * Microsoft OpenTelemetry distribution version.
+ */
+export declare const MICROSOFT_OPENTELEMETRY_VERSION = "0.1.0";
+/**
+ * Microsoft OpenTelemetry Options
+ *
+ * Top-level configuration for the Microsoft OpenTelemetry distribution.
+ * Global options (resource, sampling, instrumentations, processors) live here.
+ * Backend-specific options are scoped under their respective keys.
+ */
+export interface MicrosoftOpenTelemetryOptions {
+    /** OpenTelemetry Resource */
+    resource?: Resource;
+    /** The rate of telemetry items tracked that should be transmitted (Default 1.0) */
+    samplingRatio?: number;
+    /** The maximum number of traces to sample per second (Default 5). Set to 0 to use samplingRatio instead. */
+    tracesPerSecond?: number;
+    /** OpenTelemetry Instrumentations configuration */
+    instrumentationOptions?: InstrumentationOptions;
+    /** An array of log record processors to register to the logger provider. */
+    logRecordProcessors?: LogRecordProcessor[];
+    /** An array of span processors to register to the tracer provider. */
+    spanProcessors?: SpanProcessor[];
+    /** An array of metric readers to register to the meter provider. */
+    metricReaders?: MetricReader[];
+    /** An array of metric views to register to the meter provider. */
+    views?: ViewOptions[];
+    /** Azure Monitor configuration. When provided, Azure Monitor export is enabled. */
+    azureMonitor?: AzureMonitorOpenTelemetryOptions;
+    /** A365 observability configuration. When provided with `enabled: true`, A365 export is enabled. */
+    a365?: A365Options;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/distro/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/distro/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,gCAAgC,EAChC,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,WAAW,EAAE,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,+BAA+B,UAAU,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAG5C,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4GAA4G;IAC5G,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC3C,sEAAsE;IACtE,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,oEAAoE;IACpE,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,kEAAkE;IAClE,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IAItB,mFAAmF;IACnF,YAAY,CAAC,EAAE,gCAAgC,CAAC;IAEhD,oGAAoG;IACpG,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB"}

package/dist/esm/distro/types.js

@@ -0,0 +1,7 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Microsoft OpenTelemetry distribution version.
+ */
+export const MICROSOFT_OPENTELEMETRY_VERSION = "0.1.0";
+//# sourceMappingURL=types.js.map

package/dist/esm/distro/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/distro/types.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAelC;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,OAAO,CAAC"}

package/dist/esm/genai/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./semconv.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/genai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/genai/index.ts"],"names":[],"mappings":"AAGA,cAAc,cAAc,CAAC"}

package/dist/esm/genai/index.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export * from "./semconv.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/genai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/genai/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,cAAc,cAAc,CAAC"}

package/dist/esm/genai/instrumentations/langchain/index.d.ts

@@ -0,0 +1,3 @@
+export { LangChainTraceInstrumentor } from "./langchainTraceInstrumentor.js";
+export { LangChainTracer } from "./tracer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/genai/instrumentations/langchain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/langchain/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/genai/instrumentations/langchain/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export { LangChainTraceInstrumentor } from "./langchainTraceInstrumentor.js";
+export { LangChainTracer } from "./tracer.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/genai/instrumentations/langchain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/langchain/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/genai/instrumentations/langchain/langchainTraceInstrumentor.d.ts

@@ -0,0 +1,34 @@
+import type * as CallbackManagerModule from "@langchain/core/callbacks/manager";
+import { Tracer } from "@opentelemetry/api";
+type CallbackManagerModuleType = typeof CallbackManagerModule;
+/**
+ * Static wrapper for LangChain tracing instrumentation
+ */
+export declare class LangChainTraceInstrumentor {
+    private static throwNotInitialized;
+    /**
+     * Initialize and auto-instrument for LangChain
+     * @param module The CallbackManager module to instrument
+     * @param options Optional configuration options
+     */
+    static instrument(module: CallbackManagerModuleType, options?: {
+        isContentRecordingEnabled?: boolean;
+    }): void;
+    /**
+     * Enable LangChain instrumentation
+     */
+    static enable(): void;
+    /**
+     * Disable LangChain instrumentation
+     */
+    static disable(): void;
+    /**
+     * Reset the instrumentor instance (for testing)
+     */
+    static resetInstance(): void;
+}
+export declare function addTracerToHandlers(tracer: Tracer, handlers: CallbackManagerModule.Callbacks | undefined, options?: {
+    isContentRecordingEnabled?: boolean;
+}): CallbackManagerModule.Callbacks;
+export {};
+//# sourceMappingURL=langchainTraceInstrumentor.d.ts.map

package/dist/esm/genai/instrumentations/langchain/langchainTraceInstrumentor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchainTraceInstrumentor.d.ts","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/langchain/langchainTraceInstrumentor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,qBAAqB,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAe,MAAM,EAAE,MAAM,oBAAoB,CAAC;AASzD,KAAK,yBAAyB,GAAG,OAAO,qBAAqB,CAAC;AA0H9D;;GAEG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAOlC;;;;OAIG;IACH,MAAM,CAAC,UAAU,CACf,MAAM,EAAE,yBAAyB,EACjC,OAAO,CAAC,EAAE;QAAE,yBAAyB,CAAC,EAAE,OAAO,CAAA;KAAE,GAChD,IAAI;IAIP;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,IAAI;IAOrB;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,IAAI;IAOtB;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;CAG7B;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,qBAAqB,CAAC,SAAS,GAAG,SAAS,EACrD,OAAO,CAAC,EAAE;IAAE,yBAAyB,CAAC,EAAE,OAAO,CAAA;CAAE,GAChD,qBAAqB,CAAC,SAAS,CAgBjC"}

package/dist/esm/genai/instrumentations/langchain/langchainTraceInstrumentor.js

@@ -0,0 +1,159 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// Vendored from microsoft/Agent365-nodejs packages/agents-a365-observability-extensions-langchain
+// Adapted: removed ObservabilityManager dependency, uses diag logger instead of A365 logger
+import { diag, trace } from "@opentelemetry/api";
+import { InstrumentationBase, isWrapped, } from "@opentelemetry/instrumentation";
+import { LangChainTracer } from "./tracer.js";
+class LangChainTraceInstrumentorImpl extends InstrumentationBase {
+    static _instance = null;
+    _hasBeenEnabled = false;
+    _isPatched = false;
+    otelTracer;
+    isContentRecordingEnabled;
+    constructor(options) {
+        if (LangChainTraceInstrumentorImpl._instance !== null) {
+            throw new Error("LangChainTraceInstrumentor can only be instantiated once.");
+        }
+        super("microsoft-otel-langchain-instrumentor", "1.0.0", {
+            enabled: true,
+        });
+        this.otelTracer = trace.getTracer("microsoft-otel-langchain", "1.0.0");
+        this.isContentRecordingEnabled = options?.isContentRecordingEnabled ?? false;
+        LangChainTraceInstrumentorImpl._instance = this;
+        diag.info("[LangChainTraceInstrumentor] Initialized and automatically enabled");
+    }
+    static getInstance(options) {
+        if (!LangChainTraceInstrumentorImpl._instance) {
+            LangChainTraceInstrumentorImpl._instance = new LangChainTraceInstrumentorImpl(options);
+        }
+        return LangChainTraceInstrumentorImpl._instance;
+    }
+    static hasInstance() {
+        return LangChainTraceInstrumentorImpl._instance !== null;
+    }
+    static resetInstance() {
+        if (LangChainTraceInstrumentorImpl._instance) {
+            LangChainTraceInstrumentorImpl._instance._isPatched = false;
+        }
+        LangChainTraceInstrumentorImpl._instance = null;
+    }
+    init() {
+        return {
+            name: "@langchain/core/callbacks/manager",
+            supportedVersions: [">=0.2.0"],
+            files: [],
+            patch: this.patch.bind(this),
+            unpatch: this.unpatch.bind(this),
+        };
+    }
+    unpatch(moduleExports) {
+        const CallbackManager = moduleExports?.CallbackManager;
+        if (!CallbackManager || !isWrapped(CallbackManager._configureSync)) {
+            return;
+        }
+        this._unwrap(CallbackManager, "_configureSync");
+        this._isPatched = false;
+        diag.info("[LangChainTraceInstrumentor] Unpatched OTEL LangChain instrumentation");
+    }
+    patch(module) {
+        if (this._isPatched) {
+            return module;
+        }
+        const { CallbackManager } = module;
+        if (!CallbackManager || !("_configureSync" in CallbackManager)) {
+            return module;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const instrumentor = this;
+        this._wrap(CallbackManager, "_configureSync", (original) => {
+            return function (...args) {
+                args[0] = addTracerToHandlers(instrumentor.otelTracer, args[0], {
+                    isContentRecordingEnabled: instrumentor.isContentRecordingEnabled,
+                });
+                diag.debug("[LangChainTraceInstrumentor] _configureSync wrapped to add LangChainTracer");
+                return original.apply(this, args);
+            };
+        });
+        diag.info("[LangChainTraceInstrumentor] Patched OTEL LangChain instrumentation");
+        this._isPatched = true;
+        return module;
+    }
+    manuallyInstrumentImpl(module) {
+        diag.info("[LangChainTraceInstrumentor] Manually instrumenting CallbackManagerModule");
+        this.patch(module);
+    }
+    instrumentationDependencies() {
+        return ["@langchain/core >= 0.2.0"];
+    }
+    enable() {
+        if (this._hasBeenEnabled) {
+            return;
+        }
+        this._hasBeenEnabled = true;
+        diag.info("[LangChainTraceInstrumentor] Enabled LangChain instrumentation");
+        super.enable();
+    }
+    disable() {
+        this._hasBeenEnabled = false;
+        diag.info("[LangChainTraceInstrumentor] Disabled LangChain instrumentation");
+        super.disable();
+    }
+}
+/**
+ * Static wrapper for LangChain tracing instrumentation
+ */
+export class LangChainTraceInstrumentor {
+    static throwNotInitialized() {
+        throw new Error("LangChainTraceInstrumentor must be initialized first. " +
+            "Call LangChainTraceInstrumentor.instrument() before using enable/disable.");
+    }
+    /**
+     * Initialize and auto-instrument for LangChain
+     * @param module The CallbackManager module to instrument
+     * @param options Optional configuration options
+     */
+    static instrument(module, options) {
+        LangChainTraceInstrumentorImpl.getInstance(options).manuallyInstrumentImpl(module);
+    }
+    /**
+     * Enable LangChain instrumentation
+     */
+    static enable() {
+        if (!LangChainTraceInstrumentorImpl.hasInstance()) {
+            this.throwNotInitialized();
+        }
+        LangChainTraceInstrumentorImpl.getInstance().enable();
+    }
+    /**
+     * Disable LangChain instrumentation
+     */
+    static disable() {
+        if (!LangChainTraceInstrumentorImpl.hasInstance()) {
+            this.throwNotInitialized();
+        }
+        LangChainTraceInstrumentorImpl.getInstance().disable();
+    }
+    /**
+     * Reset the instrumentor instance (for testing)
+     */
+    static resetInstance() {
+        LangChainTraceInstrumentorImpl.resetInstance();
+    }
+}
+export function addTracerToHandlers(tracer, handlers, options) {
+    if (handlers == null) {
+        return [new LangChainTracer(tracer, options)];
+    }
+    if (Array.isArray(handlers)) {
+        if (!handlers.some((h) => h instanceof LangChainTracer)) {
+            handlers.push(new LangChainTracer(tracer, options));
+        }
+        return handlers;
+    }
+    if (!handlers.inheritableHandlers.some((h) => h instanceof LangChainTracer)) {
+        handlers.addHandler(new LangChainTracer(tracer, options), true);
+    }
+    return handlers;
+}
+//# sourceMappingURL=langchainTraceInstrumentor.js.map

package/dist/esm/genai/instrumentations/langchain/langchainTraceInstrumentor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchainTraceInstrumentor.js","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/langchain/langchainTraceInstrumentor.ts"],"names":[],"mappings":"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"}

package/dist/esm/genai/instrumentations/langchain/tracer.d.ts

@@ -0,0 +1,59 @@
+import { Tracer } from "@opentelemetry/api";
+import { BaseTracer, Run } from "@langchain/core/tracers/base";
+/**
+ * OpenTelemetry-based tracer for LangChain / LangGraph applications.
+ *
+ * Extends LangChain's `BaseTracer` callback handler so it can be injected into
+ * the LangChain callback system (via `LangChainTraceInstrumentor`). Every
+ * LangChain "run" (agent invocation, tool execution, or LLM call) is mapped to
+ * an OTel span with GenAI semantic convention attributes.
+ *
+ * Key behaviors:
+ * - Creates a span on `onRunCreate` and ends it on `_endTrace`.
+ * - Maintains parent–child span relationships by tracking run IDs and walking
+ *   up the parent chain to find the nearest span context.
+ * - Skips LangChain-internal runs (tagged `langsmith:hidden`, `Branch*`, or
+ *   unmapped run types) to avoid noisy traces.
+ * - Guards against unbounded memory with a hard cap of {@link MAX_RUNS}.
+ * - Content-sensitive attributes (messages, tool args, system instructions)
+ *   are only recorded when `isContentRecordingEnabled` is true.
+ */
+export declare class LangChainTracer extends BaseTracer {
+    /** Hard cap on concurrent tracked runs to prevent memory leaks. */
+    private static readonly MAX_RUNS;
+    private tracer;
+    private isContentRecordingEnabled;
+    /** Active runs keyed by LangChain run ID. */
+    private runs;
+    /** Maps each run ID → its parent run ID for parent-span-context lookup. */
+    private parentByRunId;
+    constructor(tracer: Tracer, options?: {
+        isContentRecordingEnabled?: boolean;
+    });
+    name: string;
+    protected persistRun(_run: Run): Promise<void>;
+    /**
+     * Called by LangChain when a new run starts. Records the parent mapping
+     * and opens a span via {@link startTracing}.
+     */
+    onRunCreate(run: Run): Promise<void>;
+    /**
+     * Opens an OTel span for the given run. The span name is derived from the
+     * operation type (invoke_agent, execute_tool, chat) and the run/model name.
+     * Internal or unknown runs are silently skipped.
+     */
+    protected startTracing(run: Run): void;
+    /**
+     * Called by LangChain when a run finishes. Sets status, enriches the span
+     * with GenAI attributes, and ends it. If content recording is enabled,
+     * message bodies, tool arguments, and system instructions are also attached.
+     */
+    protected _endTrace(run: Run): Promise<void>;
+    /**
+     * Walks up the parent run chain to find the nearest ancestor that has an
+     * active span, returning its `SpanContext` so the new span can be linked
+     * as a child.
+     */
+    private getNearestParentSpanContext;
+}
+//# sourceMappingURL=tracer.d.ts.map

package/dist/esm/genai/instrumentations/langchain/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/langchain/tracer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkD,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,8BAA8B,CAAC;AAQ/D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,mEAAmE;IACnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAU;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,yBAAyB,CAAU;IAC3C,6CAA6C;IAC7C,OAAO,CAAC,IAAI,CAAkC;IAC9C,2EAA2E;IAC3E,OAAO,CAAC,aAAa,CAAyC;gBAElD,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,yBAAyB,CAAC,EAAE,OAAO,CAAA;KAAE;IAM7E,IAAI,SAAkC;IAEtC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;;OAGG;IACG,WAAW,CAAC,GAAG,EAAE,GAAG;IAM1B;;;;OAIG;IACH,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG;IAuD/B;;;;OAIG;cACa,SAAS,CAAC,GAAG,EAAE,GAAG;IAoElC;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;CAUpC"}