@sentry/node 10.53.0 → 10.54.0

package/build/cjs/integrations/tracing/langchain/instrumentation.js

@@ -3,81 +3,25 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const instrumentation = require('@opentelemetry/instrumentation');
 const core = require('@sentry/core');
 
-const supportedVersions = ['>=0.1.0 <2.0.0'];
-
-/**
- * Augments a callback handler list with Sentry's handler if not already present
- */
-function augmentCallbackHandlers(handlers, sentryHandler) {
-  // Handle null/undefined - return array with just our handler
-  if (!handlers) {
-    return [sentryHandler];
-  }
-
-  // If handlers is already an array
-  if (Array.isArray(handlers)) {
-    // Check if our handler is already in the list
-    if (handlers.includes(sentryHandler)) {
-      return handlers;
-    }
-    // Add our handler to the list
-    return [...handlers, sentryHandler];
-  }
-
-  // If it's a single handler object, convert to array
-  if (typeof handlers === 'object') {
-    return [handlers, sentryHandler];
-  }
-
-  // Unknown type - return original
-  return handlers;
-}
-
-/**
- * Wraps Runnable methods (invoke, stream, batch) to inject Sentry callbacks at request time
- * Uses a Proxy to intercept method calls and augment the options.callbacks
- */
-function wrapRunnableMethod(
-  originalMethod,
-  sentryHandler,
-  _methodName,
-) {
+const supportedVersions = [">=0.1.0 <2.0.0"];
+function wrapRunnableMethod(originalMethod, sentryHandler, _methodName) {
   return new Proxy(originalMethod, {
     apply(target, thisArg, args) {
-      // LangChain Runnable method signatures:
-      // invoke(input, options?) - options contains callbacks
-      // stream(input, options?) - options contains callbacks
-      // batch(inputs, options?) - options contains callbacks
-
-      // Options is typically the second argument
       const optionsIndex = 1;
-      let options = args[optionsIndex] ;
-
-      // If options don't exist or aren't an object, create them
-      if (!options || typeof options !== 'object' || Array.isArray(options)) {
+      let options = args[optionsIndex];
+      if (!options || typeof options !== "object" || Array.isArray(options)) {
         options = {};
         args[optionsIndex] = options;
       }
-
-      // Inject our callback handler into options.callbacks (request time callbacks)
-      const existingCallbacks = options.callbacks;
-      const augmentedCallbacks = augmentCallbackHandlers(existingCallbacks, sentryHandler);
-      options.callbacks = augmentedCallbacks;
-
-      // Call original method with augmented options
+      options.callbacks = core._INTERNAL_mergeLangChainCallbackHandler(options.callbacks, sentryHandler);
       return Reflect.apply(target, thisArg, args);
-    },
-  }) ;
+    }
+  });
 }
-
-/**
- * Sentry LangChain instrumentation using OpenTelemetry.
- */
 class SentryLangChainInstrumentation extends instrumentation.InstrumentationBase {
-   constructor(config = {}) {
-    super('@sentry/instrumentation-langchain', core.SDK_VERSION, config);
+  constructor(config = {}) {
+    super("@sentry/instrumentation-langchain", core.SDK_VERSION, config);
   }
-
   /**
    * Initializes the instrumentation by defining the modules to be patched.
    * We patch the BaseChatModel class methods to inject callbacks
@@ -85,142 +29,105 @@ class SentryLangChainInstrumentation extends instrumentation.InstrumentationBase
    * We hook into provider packages (@langchain/anthropic, @langchain/openai, etc.)
    * because @langchain/core is often bundled and not loaded as a separate module
    */
-   init() {
+  init() {
     const modules = [];
-
-    // Hook into common LangChain provider packages
     const providerPackages = [
-      '@langchain/anthropic',
-      '@langchain/openai',
-      '@langchain/google-genai',
-      '@langchain/mistralai',
-      '@langchain/google-vertexai',
-      '@langchain/groq',
+      "@langchain/anthropic",
+      "@langchain/openai",
+      "@langchain/google-genai",
+      "@langchain/mistralai",
+      "@langchain/google-vertexai",
+      "@langchain/groq"
     ];
-
     for (const packageName of providerPackages) {
-      // In CJS, LangChain packages re-export from dist/index.cjs files.
-      // Patching only the root module sometimes misses the real implementation or
-      // gets overwritten when that file is loaded. We add a file-level patch so that
-      // _patch runs again on the concrete implementation
       modules.push(
         new instrumentation.InstrumentationNodeModuleDefinition(
           packageName,
           supportedVersions,
           this._patch.bind(this),
-          exports => exports,
+          (exports) => exports,
           [
             new instrumentation.InstrumentationNodeModuleFile(
               `${packageName}/dist/index.cjs`,
               supportedVersions,
               this._patch.bind(this),
-              exports => exports,
-            ),
-          ],
-        ),
+              (exports) => exports
+            )
+          ]
+        )
       );
     }
-
-    // Hook into main 'langchain' package to catch initChatModel (v1+)
     modules.push(
       new instrumentation.InstrumentationNodeModuleDefinition(
-        'langchain',
+        "langchain",
         supportedVersions,
         this._patch.bind(this),
-        exports => exports,
+        (exports) => exports,
         [
           // To catch the CJS build that contains ConfigurableModel / initChatModel for v1
           new instrumentation.InstrumentationNodeModuleFile(
-            'langchain/dist/chat_models/universal.cjs',
+            "langchain/dist/chat_models/universal.cjs",
             supportedVersions,
             this._patch.bind(this),
-            exports => exports,
-          ),
-        ],
-      ),
+            (exports) => exports
+          )
+        ]
+      )
     );
-
     return modules;
   }
-
   /**
    * Core patch logic - patches chat model and embedding methods
    * This is called when a LangChain provider package is loaded
    */
-   _patch(exports) {
-    // Skip AI provider wrapping now that LangChain is actually being used
-    // This prevents duplicate spans from Anthropic/OpenAI/GoogleGenAI standalone integrations
+  _patch(exports) {
     core._INTERNAL_skipAiProviderWrapping([
       core.OPENAI_INTEGRATION_NAME,
       core.ANTHROPIC_AI_INTEGRATION_NAME,
-      core.GOOGLE_GENAI_INTEGRATION_NAME,
+      core.GOOGLE_GENAI_INTEGRATION_NAME
     ]);
-
     const config = this.getConfig();
-
-    // Create a shared handler instance for chat model callbacks
     const sentryHandler = core.createLangChainCallbackHandler(config);
-
-    // Patch Runnable methods to inject callbacks at request time
-    // This directly manipulates options.callbacks that LangChain uses
     this._patchRunnableMethods(exports, sentryHandler);
-
-    // Patch embedding methods to create spans directly
-    // Embeddings don't use the callback system, so we wrap the methods themselves
     this._patchEmbeddingsMethods(exports, config);
-
     return exports;
   }
-
   /**
    * Patches chat model methods (invoke, stream, batch) to inject Sentry callbacks
    * Finds a chat model class from the provider package exports and patches its prototype methods
    */
-   _patchRunnableMethods(exports, sentryHandler) {
-    // Known chat model class names for each provider
+  _patchRunnableMethods(exports, sentryHandler) {
     const knownChatModelNames = [
-      'ChatAnthropic',
-      'ChatOpenAI',
-      'ChatGoogleGenerativeAI',
-      'ChatMistralAI',
-      'ChatVertexAI',
-      'ChatGroq',
-      'ConfigurableModel',
+      "ChatAnthropic",
+      "ChatOpenAI",
+      "ChatGoogleGenerativeAI",
+      "ChatMistralAI",
+      "ChatVertexAI",
+      "ChatGroq",
+      "ConfigurableModel"
     ];
-
-    const exportsToPatch = (exports.universal_exports ?? exports) ;
-
-    const chatModelClass = Object.values(exportsToPatch).find(exp => {
-      return typeof exp === 'function' && knownChatModelNames.includes(exp.name);
-    }) ;
-
+    const exportsToPatch = exports.universal_exports ?? exports;
+    const chatModelClass = Object.values(exportsToPatch).find((exp) => {
+      return typeof exp === "function" && knownChatModelNames.includes(exp.name);
+    });
     if (!chatModelClass) {
       return;
     }
-
-    // Patch directly on chatModelClass.prototype
-    const targetProto = chatModelClass.prototype ;
-
-    // Skip if already patched (both file-level and module-level hooks resolve to the same prototype)
+    const targetProto = chatModelClass.prototype;
     if (targetProto.__sentry_patched__) {
       return;
     }
     targetProto.__sentry_patched__ = true;
-
-    // Patch the methods (invoke, stream, batch)
-    // All chat model instances will inherit these patched methods
-    const methodsToPatch = ['invoke', 'stream', 'batch'] ;
-
+    const methodsToPatch = ["invoke", "stream", "batch"];
     for (const methodName of methodsToPatch) {
       const method = targetProto[methodName];
-      if (typeof method === 'function') {
+      if (typeof method === "function") {
         targetProto[methodName] = wrapRunnableMethod(
-          method ,
+          method,
           sentryHandler);
       }
     }
   }
-
   /**
    * Patches embedding class methods (embedQuery, embedDocuments) to create Sentry spans.
    *
@@ -229,22 +136,20 @@ class SentryLangChainInstrumentation extends instrumentation.InstrumentationBase
    *
    * Instruments any exported class whose prototype has both embedQuery and embedDocuments as functions.
    */
-   _patchEmbeddingsMethods(exports, options) {
-    const exportsToPatch = (exports.universal_exports ?? exports) ;
-
+  _patchEmbeddingsMethods(exports, options) {
+    const exportsToPatch = exports.universal_exports ?? exports;
     for (const exp of Object.values(exportsToPatch)) {
-      if (typeof exp !== 'function' || !exp.prototype) {
+      if (typeof exp !== "function" || !exp.prototype) {
         continue;
       }
-      const proto = exp.prototype ;
-      if (typeof proto.embedQuery !== 'function' || typeof proto.embedDocuments !== 'function') {
+      const proto = exp.prototype;
+      if (typeof proto.embedQuery !== "function" || typeof proto.embedDocuments !== "function") {
         continue;
       }
       if (proto.__sentry_patched__) {
         continue;
       }
       proto.__sentry_patched__ = true;
-
       core.instrumentLangChainEmbeddings(proto, options);
     }
   }

package/build/cjs/integrations/tracing/langchain/instrumentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.js","sources":["../../../../../src/integrations/tracing/langchain/instrumentation.ts"],"sourcesContent":["import {\n  InstrumentationBase,\n  type InstrumentationConfig,\n  type InstrumentationModuleDefinition,\n  InstrumentationNodeModuleDefinition,\n  InstrumentationNodeModuleFile,\n} from '@opentelemetry/instrumentation';\nimport type { LangChainOptions } from '@sentry/core';\nimport {\n  _INTERNAL_skipAiProviderWrapping,\n  ANTHROPIC_AI_INTEGRATION_NAME,\n  createLangChainCallbackHandler,\n  GOOGLE_GENAI_INTEGRATION_NAME,\n  instrumentLangChainEmbeddings,\n  OPENAI_INTEGRATION_NAME,\n  SDK_VERSION,\n} from '@sentry/core';\n\nconst supportedVersions = ['>=0.1.0 <2.0.0'];\n\ntype LangChainInstrumentationOptions = InstrumentationConfig & LangChainOptions;\n\n/**\n * Represents the patched shape of LangChain provider package exports\n */\ninterface PatchedLangChainExports {\n  [key: string]: unknown;\n}\n\n/**\n * Augments a callback handler list with Sentry's handler if not already present\n */\nfunction augmentCallbackHandlers(handlers: unknown, sentryHandler: unknown): unknown {\n  // Handle null/undefined - return array with just our handler\n  if (!handlers) {\n    return [sentryHandler];\n  }\n\n  // If handlers is already an array\n  if (Array.isArray(handlers)) {\n    // Check if our handler is already in the list\n    if (handlers.includes(sentryHandler)) {\n      return handlers;\n    }\n    // Add our handler to the list\n    return [...handlers, sentryHandler];\n  }\n\n  // If it's a single handler object, convert to array\n  if (typeof handlers === 'object') {\n    return [handlers, sentryHandler];\n  }\n\n  // Unknown type - return original\n  return handlers;\n}\n\n/**\n * Wraps Runnable methods (invoke, stream, batch) to inject Sentry callbacks at request time\n * Uses a Proxy to intercept method calls and augment the options.callbacks\n */\nfunction wrapRunnableMethod(\n  originalMethod: (...args: unknown[]) => unknown,\n  sentryHandler: unknown,\n  _methodName: string,\n): (...args: unknown[]) => unknown {\n  return new Proxy(originalMethod, {\n    apply(target, thisArg, args: unknown[]): unknown {\n      // LangChain Runnable method signatures:\n      // invoke(input, options?) - options contains callbacks\n      // stream(input, options?) - options contains callbacks\n      // batch(inputs, options?) - options contains callbacks\n\n      // Options is typically the second argument\n      const optionsIndex = 1;\n      let options = args[optionsIndex] as Record<string, unknown> | undefined;\n\n      // If options don't exist or aren't an object, create them\n      if (!options || typeof options !== 'object' || Array.isArray(options)) {\n        options = {};\n        args[optionsIndex] = options;\n      }\n\n      // Inject our callback handler into options.callbacks (request time callbacks)\n      const existingCallbacks = options.callbacks;\n      const augmentedCallbacks = augmentCallbackHandlers(existingCallbacks, sentryHandler);\n      options.callbacks = augmentedCallbacks;\n\n      // Call original method with augmented options\n      return Reflect.apply(target, thisArg, args);\n    },\n  }) as (...args: unknown[]) => unknown;\n}\n\n/**\n * Sentry LangChain instrumentation using OpenTelemetry.\n */\nexport class SentryLangChainInstrumentation extends InstrumentationBase<LangChainInstrumentationOptions> {\n  public constructor(config: LangChainInstrumentationOptions = {}) {\n    super('@sentry/instrumentation-langchain', SDK_VERSION, config);\n  }\n\n  /**\n   * Initializes the instrumentation by defining the modules to be patched.\n   * We patch the BaseChatModel class methods to inject callbacks\n   *\n   * We hook into provider packages (@langchain/anthropic, @langchain/openai, etc.)\n   * because @langchain/core is often bundled and not loaded as a separate module\n   */\n  public init(): InstrumentationModuleDefinition | InstrumentationModuleDefinition[] {\n    const modules: InstrumentationModuleDefinition[] = [];\n\n    // Hook into common LangChain provider packages\n    const providerPackages = [\n      '@langchain/anthropic',\n      '@langchain/openai',\n      '@langchain/google-genai',\n      '@langchain/mistralai',\n      '@langchain/google-vertexai',\n      '@langchain/groq',\n    ];\n\n    for (const packageName of providerPackages) {\n      // In CJS, LangChain packages re-export from dist/index.cjs files.\n      // Patching only the root module sometimes misses the real implementation or\n      // gets overwritten when that file is loaded. We add a file-level patch so that\n      // _patch runs again on the concrete implementation\n      modules.push(\n        new InstrumentationNodeModuleDefinition(\n          packageName,\n          supportedVersions,\n          this._patch.bind(this),\n          exports => exports,\n          [\n            new InstrumentationNodeModuleFile(\n              `${packageName}/dist/index.cjs`,\n              supportedVersions,\n              this._patch.bind(this),\n              exports => exports,\n            ),\n          ],\n        ),\n      );\n    }\n\n    // Hook into main 'langchain' package to catch initChatModel (v1+)\n    modules.push(\n      new InstrumentationNodeModuleDefinition(\n        'langchain',\n        supportedVersions,\n        this._patch.bind(this),\n        exports => exports,\n        [\n          // To catch the CJS build that contains ConfigurableModel / initChatModel for v1\n          new InstrumentationNodeModuleFile(\n            'langchain/dist/chat_models/universal.cjs',\n            supportedVersions,\n            this._patch.bind(this),\n            exports => exports,\n          ),\n        ],\n      ),\n    );\n\n    return modules;\n  }\n\n  /**\n   * Core patch logic - patches chat model and embedding methods\n   * This is called when a LangChain provider package is loaded\n   */\n  private _patch(exports: PatchedLangChainExports): PatchedLangChainExports | void {\n    // Skip AI provider wrapping now that LangChain is actually being used\n    // This prevents duplicate spans from Anthropic/OpenAI/GoogleGenAI standalone integrations\n    _INTERNAL_skipAiProviderWrapping([\n      OPENAI_INTEGRATION_NAME,\n      ANTHROPIC_AI_INTEGRATION_NAME,\n      GOOGLE_GENAI_INTEGRATION_NAME,\n    ]);\n\n    const config = this.getConfig();\n\n    // Create a shared handler instance for chat model callbacks\n    const sentryHandler = createLangChainCallbackHandler(config);\n\n    // Patch Runnable methods to inject callbacks at request time\n    // This directly manipulates options.callbacks that LangChain uses\n    this._patchRunnableMethods(exports, sentryHandler);\n\n    // Patch embedding methods to create spans directly\n    // Embeddings don't use the callback system, so we wrap the methods themselves\n    this._patchEmbeddingsMethods(exports, config);\n\n    return exports;\n  }\n\n  /**\n   * Patches chat model methods (invoke, stream, batch) to inject Sentry callbacks\n   * Finds a chat model class from the provider package exports and patches its prototype methods\n   */\n  private _patchRunnableMethods(exports: PatchedLangChainExports, sentryHandler: unknown): void {\n    // Known chat model class names for each provider\n    const knownChatModelNames = [\n      'ChatAnthropic',\n      'ChatOpenAI',\n      'ChatGoogleGenerativeAI',\n      'ChatMistralAI',\n      'ChatVertexAI',\n      'ChatGroq',\n      'ConfigurableModel',\n    ];\n\n    const exportsToPatch = (exports.universal_exports ?? exports) as Record<string, unknown>;\n\n    const chatModelClass = Object.values(exportsToPatch).find(exp => {\n      return typeof exp === 'function' && knownChatModelNames.includes(exp.name);\n    }) as { prototype: unknown; name: string } | undefined;\n\n    if (!chatModelClass) {\n      return;\n    }\n\n    // Patch directly on chatModelClass.prototype\n    const targetProto = chatModelClass.prototype as Record<string, unknown>;\n\n    // Skip if already patched (both file-level and module-level hooks resolve to the same prototype)\n    if (targetProto.__sentry_patched__) {\n      return;\n    }\n    targetProto.__sentry_patched__ = true;\n\n    // Patch the methods (invoke, stream, batch)\n    // All chat model instances will inherit these patched methods\n    const methodsToPatch = ['invoke', 'stream', 'batch'] as const;\n\n    for (const methodName of methodsToPatch) {\n      const method = targetProto[methodName];\n      if (typeof method === 'function') {\n        targetProto[methodName] = wrapRunnableMethod(\n          method as (...args: unknown[]) => unknown,\n          sentryHandler,\n          methodName,\n        );\n      }\n    }\n  }\n\n  /**\n   * Patches embedding class methods (embedQuery, embedDocuments) to create Sentry spans.\n   *\n   * Unlike chat models which use LangChain's callback system, the Embeddings base class\n   * has no callback support. We wrap the methods directly on the prototype.\n   *\n   * Instruments any exported class whose prototype has both embedQuery and embedDocuments as functions.\n   */\n  private _patchEmbeddingsMethods(exports: PatchedLangChainExports, options: LangChainOptions): void {\n    const exportsToPatch = (exports.universal_exports ?? exports) as Record<string, unknown>;\n\n    for (const exp of Object.values(exportsToPatch)) {\n      if (typeof exp !== 'function' || !exp.prototype) {\n        continue;\n      }\n      const proto = exp.prototype as Record<string, unknown>;\n      if (typeof proto.embedQuery !== 'function' || typeof proto.embedDocuments !== 'function') {\n        continue;\n      }\n      if (proto.__sentry_patched__) {\n        continue;\n      }\n      proto.__sentry_patched__ = true;\n\n      instrumentLangChainEmbeddings(proto, options);\n    }\n  }\n}\n"],"names":["InstrumentationBase","SDK_VERSION","InstrumentationNodeModuleDefinition","InstrumentationNodeModuleFile","_INTERNAL_skipAiProviderWrapping","OPENAI_INTEGRATION_NAME","ANTHROPIC_AI_INTEGRATION_NAME","GOOGLE_GENAI_INTEGRATION_NAME","createLangChainCallbackHandler","instrumentLangChainEmbeddings"],"mappings":"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"}
+{"version":3,"file":"instrumentation.js","sources":["../../../../../src/integrations/tracing/langchain/instrumentation.ts"],"sourcesContent":["import {\n  InstrumentationBase,\n  type InstrumentationConfig,\n  type InstrumentationModuleDefinition,\n  InstrumentationNodeModuleDefinition,\n  InstrumentationNodeModuleFile,\n} from '@opentelemetry/instrumentation';\nimport type { LangChainOptions } from '@sentry/core';\nimport {\n  _INTERNAL_mergeLangChainCallbackHandler,\n  _INTERNAL_skipAiProviderWrapping,\n  ANTHROPIC_AI_INTEGRATION_NAME,\n  createLangChainCallbackHandler,\n  GOOGLE_GENAI_INTEGRATION_NAME,\n  instrumentLangChainEmbeddings,\n  OPENAI_INTEGRATION_NAME,\n  SDK_VERSION,\n} from '@sentry/core';\n\nconst supportedVersions = ['>=0.1.0 <2.0.0'];\n\ntype LangChainInstrumentationOptions = InstrumentationConfig & LangChainOptions;\n\n/**\n * Represents the patched shape of LangChain provider package exports\n */\ninterface PatchedLangChainExports {\n  [key: string]: unknown;\n}\n\n/**\n * Wraps Runnable methods (invoke, stream, batch) to inject Sentry callbacks at request time\n * Uses a Proxy to intercept method calls and augment the options.callbacks\n */\nfunction wrapRunnableMethod(\n  originalMethod: (...args: unknown[]) => unknown,\n  sentryHandler: unknown,\n  _methodName: string,\n): (...args: unknown[]) => unknown {\n  return new Proxy(originalMethod, {\n    apply(target, thisArg, args: unknown[]): unknown {\n      // LangChain Runnable method signatures:\n      // invoke(input, options?) - options contains callbacks\n      // stream(input, options?) - options contains callbacks\n      // batch(inputs, options?) - options contains callbacks\n\n      // Options is typically the second argument\n      const optionsIndex = 1;\n      let options = args[optionsIndex] as Record<string, unknown> | undefined;\n\n      // If options don't exist or aren't an object, create them\n      if (!options || typeof options !== 'object' || Array.isArray(options)) {\n        options = {};\n        args[optionsIndex] = options;\n      }\n\n      // Inject our callback handler into options.callbacks (request time callbacks)\n      options.callbacks = _INTERNAL_mergeLangChainCallbackHandler(options.callbacks, sentryHandler);\n\n      // Call original method with augmented options\n      return Reflect.apply(target, thisArg, args);\n    },\n  }) as (...args: unknown[]) => unknown;\n}\n\n/**\n * Sentry LangChain instrumentation using OpenTelemetry.\n */\nexport class SentryLangChainInstrumentation extends InstrumentationBase<LangChainInstrumentationOptions> {\n  public constructor(config: LangChainInstrumentationOptions = {}) {\n    super('@sentry/instrumentation-langchain', SDK_VERSION, config);\n  }\n\n  /**\n   * Initializes the instrumentation by defining the modules to be patched.\n   * We patch the BaseChatModel class methods to inject callbacks\n   *\n   * We hook into provider packages (@langchain/anthropic, @langchain/openai, etc.)\n   * because @langchain/core is often bundled and not loaded as a separate module\n   */\n  public init(): InstrumentationModuleDefinition | InstrumentationModuleDefinition[] {\n    const modules: InstrumentationModuleDefinition[] = [];\n\n    // Hook into common LangChain provider packages\n    const providerPackages = [\n      '@langchain/anthropic',\n      '@langchain/openai',\n      '@langchain/google-genai',\n      '@langchain/mistralai',\n      '@langchain/google-vertexai',\n      '@langchain/groq',\n    ];\n\n    for (const packageName of providerPackages) {\n      // In CJS, LangChain packages re-export from dist/index.cjs files.\n      // Patching only the root module sometimes misses the real implementation or\n      // gets overwritten when that file is loaded. We add a file-level patch so that\n      // _patch runs again on the concrete implementation\n      modules.push(\n        new InstrumentationNodeModuleDefinition(\n          packageName,\n          supportedVersions,\n          this._patch.bind(this),\n          exports => exports,\n          [\n            new InstrumentationNodeModuleFile(\n              `${packageName}/dist/index.cjs`,\n              supportedVersions,\n              this._patch.bind(this),\n              exports => exports,\n            ),\n          ],\n        ),\n      );\n    }\n\n    // Hook into main 'langchain' package to catch initChatModel (v1+)\n    modules.push(\n      new InstrumentationNodeModuleDefinition(\n        'langchain',\n        supportedVersions,\n        this._patch.bind(this),\n        exports => exports,\n        [\n          // To catch the CJS build that contains ConfigurableModel / initChatModel for v1\n          new InstrumentationNodeModuleFile(\n            'langchain/dist/chat_models/universal.cjs',\n            supportedVersions,\n            this._patch.bind(this),\n            exports => exports,\n          ),\n        ],\n      ),\n    );\n\n    return modules;\n  }\n\n  /**\n   * Core patch logic - patches chat model and embedding methods\n   * This is called when a LangChain provider package is loaded\n   */\n  private _patch(exports: PatchedLangChainExports): PatchedLangChainExports | void {\n    // Skip AI provider wrapping now that LangChain is actually being used\n    // This prevents duplicate spans from Anthropic/OpenAI/GoogleGenAI standalone integrations\n    _INTERNAL_skipAiProviderWrapping([\n      OPENAI_INTEGRATION_NAME,\n      ANTHROPIC_AI_INTEGRATION_NAME,\n      GOOGLE_GENAI_INTEGRATION_NAME,\n    ]);\n\n    const config = this.getConfig();\n\n    // Create a shared handler instance for chat model callbacks\n    const sentryHandler = createLangChainCallbackHandler(config);\n\n    // Patch Runnable methods to inject callbacks at request time\n    // This directly manipulates options.callbacks that LangChain uses\n    this._patchRunnableMethods(exports, sentryHandler);\n\n    // Patch embedding methods to create spans directly\n    // Embeddings don't use the callback system, so we wrap the methods themselves\n    this._patchEmbeddingsMethods(exports, config);\n\n    return exports;\n  }\n\n  /**\n   * Patches chat model methods (invoke, stream, batch) to inject Sentry callbacks\n   * Finds a chat model class from the provider package exports and patches its prototype methods\n   */\n  private _patchRunnableMethods(exports: PatchedLangChainExports, sentryHandler: unknown): void {\n    // Known chat model class names for each provider\n    const knownChatModelNames = [\n      'ChatAnthropic',\n      'ChatOpenAI',\n      'ChatGoogleGenerativeAI',\n      'ChatMistralAI',\n      'ChatVertexAI',\n      'ChatGroq',\n      'ConfigurableModel',\n    ];\n\n    const exportsToPatch = (exports.universal_exports ?? exports) as Record<string, unknown>;\n\n    const chatModelClass = Object.values(exportsToPatch).find(exp => {\n      return typeof exp === 'function' && knownChatModelNames.includes(exp.name);\n    }) as { prototype: unknown; name: string } | undefined;\n\n    if (!chatModelClass) {\n      return;\n    }\n\n    // Patch directly on chatModelClass.prototype\n    const targetProto = chatModelClass.prototype as Record<string, unknown>;\n\n    // Skip if already patched (both file-level and module-level hooks resolve to the same prototype)\n    if (targetProto.__sentry_patched__) {\n      return;\n    }\n    targetProto.__sentry_patched__ = true;\n\n    // Patch the methods (invoke, stream, batch)\n    // All chat model instances will inherit these patched methods\n    const methodsToPatch = ['invoke', 'stream', 'batch'] as const;\n\n    for (const methodName of methodsToPatch) {\n      const method = targetProto[methodName];\n      if (typeof method === 'function') {\n        targetProto[methodName] = wrapRunnableMethod(\n          method as (...args: unknown[]) => unknown,\n          sentryHandler,\n          methodName,\n        );\n      }\n    }\n  }\n\n  /**\n   * Patches embedding class methods (embedQuery, embedDocuments) to create Sentry spans.\n   *\n   * Unlike chat models which use LangChain's callback system, the Embeddings base class\n   * has no callback support. We wrap the methods directly on the prototype.\n   *\n   * Instruments any exported class whose prototype has both embedQuery and embedDocuments as functions.\n   */\n  private _patchEmbeddingsMethods(exports: PatchedLangChainExports, options: LangChainOptions): void {\n    const exportsToPatch = (exports.universal_exports ?? exports) as Record<string, unknown>;\n\n    for (const exp of Object.values(exportsToPatch)) {\n      if (typeof exp !== 'function' || !exp.prototype) {\n        continue;\n      }\n      const proto = exp.prototype as Record<string, unknown>;\n      if (typeof proto.embedQuery !== 'function' || typeof proto.embedDocuments !== 'function') {\n        continue;\n      }\n      if (proto.__sentry_patched__) {\n        continue;\n      }\n      proto.__sentry_patched__ = true;\n\n      instrumentLangChainEmbeddings(proto, options);\n    }\n  }\n}\n"],"names":["_INTERNAL_mergeLangChainCallbackHandler","InstrumentationBase","SDK_VERSION","InstrumentationNodeModuleDefinition","InstrumentationNodeModuleFile","_INTERNAL_skipAiProviderWrapping","OPENAI_INTEGRATION_NAME","ANTHROPIC_AI_INTEGRATION_NAME","GOOGLE_GENAI_INTEGRATION_NAME","createLangChainCallbackHandler","instrumentLangChainEmbeddings"],"mappings":"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"}

package/build/cjs/integrations/tracing/langgraph/index.js

@@ -6,86 +6,16 @@ const instrumentation = require('./instrumentation.js');
 
 const instrumentLangGraph = nodeCore.generateInstrumentOnce(
   core.LANGGRAPH_INTEGRATION_NAME,
-  options => new instrumentation.SentryLangGraphInstrumentation(options),
+  (options) => new instrumentation.SentryLangGraphInstrumentation(options)
 );
-
 const _langGraphIntegration = ((options = {}) => {
   return {
     name: core.LANGGRAPH_INTEGRATION_NAME,
     setupOnce() {
       instrumentLangGraph(options);
-    },
+    }
   };
-}) ;
-
-/**
- * Adds Sentry tracing instrumentation for LangGraph.
- *
- * This integration is enabled by default.
- *
- * When configured, this integration automatically instruments LangGraph StateGraph and compiled graph instances
- * to capture telemetry data following OpenTelemetry Semantic Conventions for Generative AI.
- *
- * @example
- * ```javascript
- * import * as Sentry from '@sentry/node';
- *
- * Sentry.init({
- *   integrations: [Sentry.langGraphIntegration()],
- * });
- * ```
- *
- * ## Options
- *
- * - `recordInputs`: Whether to record input messages (default: respects `sendDefaultPii` client option)
- * - `recordOutputs`: Whether to record response text (default: respects `sendDefaultPii` client option)
- *
- * ### Default Behavior
- *
- * By default, the integration will:
- * - Record inputs and outputs ONLY if `sendDefaultPii` is set to `true` in your Sentry client options
- * - Otherwise, inputs and outputs are NOT recorded unless explicitly enabled
- *
- * @example
- * ```javascript
- * // Record inputs and outputs when sendDefaultPii is false
- * Sentry.init({
- *   integrations: [
- *     Sentry.langGraphIntegration({
- *       recordInputs: true,
- *       recordOutputs: true
- *     })
- *   ],
- * });
- *
- * // Never record inputs/outputs regardless of sendDefaultPii
- * Sentry.init({
- *   sendDefaultPii: true,
- *   integrations: [
- *     Sentry.langGraphIntegration({
- *       recordInputs: false,
- *       recordOutputs: false
- *     })
- *   ],
- * });
- * ```
- *
- * ## Captured Operations
- *
- * The integration captures the following LangGraph operations:
- * - **Agent Creation** (`StateGraph.compile()`) - Creates a `gen_ai.create_agent` span
- * - **Agent Invocation** (`CompiledGraph.invoke()`) - Creates a `gen_ai.invoke_agent` span
- *
- * ## Captured Data
- *
- * When `recordInputs` and `recordOutputs` are enabled, the integration captures:
- * - Input messages from the graph state
- * - Output messages and LLM responses
- * - Tool calls made during agent execution
- * - Agent and graph names
- * - Available tools configured in the graph
- *
- */
+});
 const langGraphIntegration = core.defineIntegration(_langGraphIntegration);
 
 exports.instrumentLangGraph = instrumentLangGraph;

package/build/cjs/integrations/tracing/langgraph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../../src/integrations/tracing/langgraph/index.ts"],"sourcesContent":["import type { IntegrationFn, LangGraphOptions } from '@sentry/core';\nimport { defineIntegration, LANGGRAPH_INTEGRATION_NAME } from '@sentry/core';\nimport { generateInstrumentOnce } from '@sentry/node-core';\nimport { SentryLangGraphInstrumentation } from './instrumentation';\n\nexport const instrumentLangGraph = generateInstrumentOnce<LangGraphOptions>(\n  LANGGRAPH_INTEGRATION_NAME,\n  options => new SentryLangGraphInstrumentation(options),\n);\n\nconst _langGraphIntegration = ((options: LangGraphOptions = {}) => {\n  return {\n    name: LANGGRAPH_INTEGRATION_NAME,\n    setupOnce() {\n      instrumentLangGraph(options);\n    },\n  };\n}) satisfies IntegrationFn;\n\n/**\n * Adds Sentry tracing instrumentation for LangGraph.\n *\n * This integration is enabled by default.\n *\n * When configured, this integration automatically instruments LangGraph StateGraph and compiled graph instances\n * to capture telemetry data following OpenTelemetry Semantic Conventions for Generative AI.\n *\n * @example\n * ```javascript\n * import * as Sentry from '@sentry/node';\n *\n * Sentry.init({\n *   integrations: [Sentry.langGraphIntegration()],\n * });\n * ```\n *\n * ## Options\n *\n * - `recordInputs`: Whether to record input messages (default: respects `sendDefaultPii` client option)\n * - `recordOutputs`: Whether to record response text (default: respects `sendDefaultPii` client option)\n *\n * ### Default Behavior\n *\n * By default, the integration will:\n * - Record inputs and outputs ONLY if `sendDefaultPii` is set to `true` in your Sentry client options\n * - Otherwise, inputs and outputs are NOT recorded unless explicitly enabled\n *\n * @example\n * ```javascript\n * // Record inputs and outputs when sendDefaultPii is false\n * Sentry.init({\n *   integrations: [\n *     Sentry.langGraphIntegration({\n *       recordInputs: true,\n *       recordOutputs: true\n *     })\n *   ],\n * });\n *\n * // Never record inputs/outputs regardless of sendDefaultPii\n * Sentry.init({\n *   sendDefaultPii: true,\n *   integrations: [\n *     Sentry.langGraphIntegration({\n *       recordInputs: false,\n *       recordOutputs: false\n *     })\n *   ],\n * });\n * ```\n *\n * ## Captured Operations\n *\n * The integration captures the following LangGraph operations:\n * - **Agent Creation** (`StateGraph.compile()`) - Creates a `gen_ai.create_agent` span\n * - **Agent Invocation** (`CompiledGraph.invoke()`) - Creates a `gen_ai.invoke_agent` span\n *\n * ## Captured Data\n *\n * When `recordInputs` and `recordOutputs` are enabled, the integration captures:\n * - Input messages from the graph state\n * - Output messages and LLM responses\n * - Tool calls made during agent execution\n * - Agent and graph names\n * - Available tools configured in the graph\n *\n */\nexport const langGraphIntegration = defineIntegration(_langGraphIntegration);\n"],"names":["generateInstrumentOnce","LANGGRAPH_INTEGRATION_NAME","SentryLangGraphInstrumentation","defineIntegration"],"mappings":";;;;;;AAKO,MAAM,mBAAA,GAAsBA,+BAAsB;AACzD,EAAEC,+BAA0B;AAC5B,EAAE,WAAW,IAAIC,8CAA8B,CAAC,OAAO,CAAC;AACxD;;AAEA,MAAM,qBAAA,IAAyB,CAAC,OAAO,GAAqB,EAAE,KAAK;AACnE,EAAE,OAAO;AACT,IAAI,IAAI,EAAED,+BAA0B;AACpC,IAAI,SAAS,GAAG;AAChB,MAAM,mBAAmB,CAAC,OAAO,CAAC;AAClC,IAAI,CAAC;AACL,GAAG;AACH,CAAC,CAAA;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;MACa,oBAAA,GAAuBE,sBAAiB,CAAC,qBAAqB;;;;;"}
+{"version":3,"file":"index.js","sources":["../../../../../src/integrations/tracing/langgraph/index.ts"],"sourcesContent":["import type { IntegrationFn, LangGraphOptions } from '@sentry/core';\nimport { defineIntegration, LANGGRAPH_INTEGRATION_NAME } from '@sentry/core';\nimport { generateInstrumentOnce } from '@sentry/node-core';\nimport { SentryLangGraphInstrumentation } from './instrumentation';\n\nexport const instrumentLangGraph = generateInstrumentOnce<LangGraphOptions>(\n  LANGGRAPH_INTEGRATION_NAME,\n  options => new SentryLangGraphInstrumentation(options),\n);\n\nconst _langGraphIntegration = ((options: LangGraphOptions = {}) => {\n  return {\n    name: LANGGRAPH_INTEGRATION_NAME,\n    setupOnce() {\n      instrumentLangGraph(options);\n    },\n  };\n}) satisfies IntegrationFn;\n\n/**\n * Adds Sentry tracing instrumentation for LangGraph.\n *\n * This integration is enabled by default.\n *\n * When configured, this integration automatically instruments LangGraph StateGraph and compiled graph instances\n * to capture telemetry data following OpenTelemetry Semantic Conventions for Generative AI.\n *\n * @example\n * ```javascript\n * import * as Sentry from '@sentry/node';\n *\n * Sentry.init({\n *   integrations: [Sentry.langGraphIntegration()],\n * });\n * ```\n *\n * ## Options\n *\n * - `recordInputs`: Whether to record input messages (default: respects `sendDefaultPii` client option)\n * - `recordOutputs`: Whether to record response text (default: respects `sendDefaultPii` client option)\n *\n * ### Default Behavior\n *\n * By default, the integration will:\n * - Record inputs and outputs ONLY if `sendDefaultPii` is set to `true` in your Sentry client options\n * - Otherwise, inputs and outputs are NOT recorded unless explicitly enabled\n *\n * @example\n * ```javascript\n * // Record inputs and outputs when sendDefaultPii is false\n * Sentry.init({\n *   integrations: [\n *     Sentry.langGraphIntegration({\n *       recordInputs: true,\n *       recordOutputs: true\n *     })\n *   ],\n * });\n *\n * // Never record inputs/outputs regardless of sendDefaultPii\n * Sentry.init({\n *   sendDefaultPii: true,\n *   integrations: [\n *     Sentry.langGraphIntegration({\n *       recordInputs: false,\n *       recordOutputs: false\n *     })\n *   ],\n * });\n * ```\n *\n * ## Captured Operations\n *\n * The integration captures the following LangGraph operations:\n * - **Agent Creation** (`StateGraph.compile()`) - Creates a `gen_ai.create_agent` span\n * - **Agent Invocation** (`CompiledGraph.invoke()`) - Creates a `gen_ai.invoke_agent` span\n *\n * ## Captured Data\n *\n * When `recordInputs` and `recordOutputs` are enabled, the integration captures:\n * - Input messages from the graph state\n * - Output messages and LLM responses\n * - Tool calls made during agent execution\n * - Agent and graph names\n * - Available tools configured in the graph\n *\n */\nexport const langGraphIntegration = defineIntegration(_langGraphIntegration);\n"],"names":["generateInstrumentOnce","LANGGRAPH_INTEGRATION_NAME","SentryLangGraphInstrumentation","defineIntegration"],"mappings":";;;;;;AAKO,MAAM,mBAAA,GAAsBA,+BAAA;AAAA,EACjCC,+BAAA;AAAA,EACA,CAAA,OAAA,KAAW,IAAIC,8CAAA,CAA+B,OAAO;AACvD;AAEA,MAAM,qBAAA,IAAyB,CAAC,OAAA,GAA4B,EAAC,KAAM;AACjE,EAAA,OAAO;AAAA,IACL,IAAA,EAAMD,+BAAA;AAAA,IACN,SAAA,GAAY;AACV,MAAA,mBAAA,CAAoB,OAAO,CAAA;AAAA,IAC7B;AAAA,GACF;AACF,CAAA,CAAA;AAsEO,MAAM,oBAAA,GAAuBE,uBAAkB,qBAAqB;;;;;"}

package/build/cjs/integrations/tracing/langgraph/instrumentation.js

@@ -3,26 +3,21 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const instrumentation = require('@opentelemetry/instrumentation');
 const core = require('@sentry/core');
 
-const supportedVersions = ['>=0.0.0 <2.0.0'];
-
-/**
- * Sentry LangGraph instrumentation using OpenTelemetry.
- */
+const supportedVersions = [">=0.0.0 <2.0.0"];
 class SentryLangGraphInstrumentation extends instrumentation.InstrumentationBase {
-   constructor(config = {}) {
-    super('@sentry/instrumentation-langgraph', core.SDK_VERSION, config);
+  constructor(config = {}) {
+    super("@sentry/instrumentation-langgraph", core.SDK_VERSION, config);
   }
-
   /**
    * Initializes the instrumentation by defining the modules to be patched.
    */
-   init() {
+  init() {
     return [
       new instrumentation.InstrumentationNodeModuleDefinition(
-        '@langchain/langgraph',
+        "@langchain/langgraph",
         supportedVersions,
         this._patch.bind(this),
-        exports => exports,
+        (exports) => exports,
         [
           new instrumentation.InstrumentationNodeModuleFile(
             /**
@@ -31,10 +26,10 @@ class SentryLangGraphInstrumentation extends instrumentation.InstrumentationBase
              * gets overwritten when that file is loaded. We add a file-level patch so that
              * _patch runs again on the concrete implementation
              */
-            '@langchain/langgraph/dist/index.cjs',
+            "@langchain/langgraph/dist/index.cjs",
             supportedVersions,
             this._patch.bind(this),
-            exports => exports,
+            (exports) => exports
           ),
           new instrumentation.InstrumentationNodeModuleFile(
             /**
@@ -42,61 +37,55 @@ class SentryLangGraphInstrumentation extends instrumentation.InstrumentationBase
              * We add a file-level patch under the main module so that CJS require()
              * of @langchain/langgraph/prebuilt gets patched.
              */
-            '@langchain/langgraph/dist/prebuilt/index.cjs',
+            "@langchain/langgraph/dist/prebuilt/index.cjs",
             supportedVersions,
             this._patch.bind(this),
-            exports => exports,
-          ),
-        ],
+            (exports) => exports
+          )
+        ]
       ),
       new instrumentation.InstrumentationNodeModuleDefinition(
-        '@langchain/langgraph/prebuilt',
+        "@langchain/langgraph/prebuilt",
         supportedVersions,
         this._patch.bind(this),
-        exports => exports,
+        (exports) => exports,
         [
           new instrumentation.InstrumentationNodeModuleFile(
             /**
              * In CJS, the prebuilt submodule re-exports from dist/prebuilt/index.cjs.
              * We add file-level patches so _patch runs on the concrete implementation.
              */
-            '@langchain/langgraph/dist/prebuilt/index.cjs',
+            "@langchain/langgraph/dist/prebuilt/index.cjs",
             supportedVersions,
             this._patch.bind(this),
-            exports => exports,
-          ),
-        ],
-      ),
+            (exports) => exports
+          )
+        ]
+      )
     ];
   }
-
   /**
    * Core patch logic applying instrumentation to the LangGraph module.
    */
-   _patch(exports) {
+  _patch(exports) {
     const client = core.getClient();
     const options = {
       ...this.getConfig(),
       recordInputs: this.getConfig().recordInputs ?? client?.getOptions().sendDefaultPii,
-      recordOutputs: this.getConfig().recordOutputs ?? client?.getOptions().sendDefaultPii,
+      recordOutputs: this.getConfig().recordOutputs ?? client?.getOptions().sendDefaultPii
     };
-
-    // Patch StateGraph.compile to instrument both compile() and invoke()
-    if (exports.StateGraph && typeof exports.StateGraph === 'function') {
-      core.instrumentLangGraph(exports.StateGraph.prototype , options);
+    if (exports.StateGraph && typeof exports.StateGraph === "function") {
+      core.instrumentLangGraph(exports.StateGraph.prototype, options);
     }
-
-    // Patch createReactAgent to instrument agent creation and invocation
-    if (exports.createReactAgent && typeof exports.createReactAgent === 'function') {
+    if (exports.createReactAgent && typeof exports.createReactAgent === "function") {
       const originalCreateReactAgent = exports.createReactAgent;
-      Object.defineProperty(exports, 'createReactAgent', {
-        value: core.instrumentCreateReactAgent(originalCreateReactAgent , options),
+      Object.defineProperty(exports, "createReactAgent", {
+        value: core.instrumentCreateReactAgent(originalCreateReactAgent, options),
         writable: true,
         enumerable: true,
-        configurable: true,
+        configurable: true
       });
     }
-
     return exports;
   }
 }