@sentry/node 10.21.0 → 10.23.0

package/build/types-ts3.8/integrations/tracing/langchain/index.d.ts

@@ -0,0 +1,93 @@
+import { LangChainOptions } from '@sentry/core';
+export declare const instrumentLangChain: ((options?: LangChainOptions | undefined) => import("@opentelemetry/instrumentation").Instrumentation<import("@opentelemetry/instrumentation").InstrumentationConfig>) & {
+    id: string;
+};
+/**
+ * Adds Sentry tracing instrumentation for LangChain.
+ *
+ * This integration is enabled by default.
+ *
+ * When configured, this integration automatically instruments LangChain runnable instances
+ * to capture telemetry data by injecting Sentry callback handlers into all LangChain calls.
+ *
+ * @example
+ * ```javascript
+ * import * as Sentry from '@sentry/node';
+ * import { ChatOpenAI } from '@langchain/openai';
+ *
+ * Sentry.init({
+ *   integrations: [Sentry.langChainIntegration()],
+ *   sendDefaultPii: true, // Enable to record inputs/outputs
+ * });
+ *
+ * // LangChain calls are automatically instrumented
+ * const model = new ChatOpenAI();
+ * await model.invoke("What is the capital of France?");
+ * ```
+ *
+ * ## Manual Callback Handler
+ *
+ * You can also manually add the Sentry callback handler alongside other callbacks:
+ *
+ * @example
+ * ```javascript
+ * import * as Sentry from '@sentry/node';
+ * import { ChatOpenAI } from '@langchain/openai';
+ *
+ * const sentryHandler = Sentry.createLangChainCallbackHandler({
+ *   recordInputs: true,
+ *   recordOutputs: true
+ * });
+ *
+ * const model = new ChatOpenAI();
+ * await model.invoke(
+ *   "What is the capital of France?",
+ *   { callbacks: [sentryHandler, myOtherCallback] }
+ * );
+ * ```
+ *
+ * ## Options
+ *
+ * - `recordInputs`: Whether to record input messages/prompts (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.langChainIntegration({
+ *       recordInputs: true,
+ *       recordOutputs: true
+ *     })
+ *   ],
+ * });
+ *
+ * // Never record inputs/outputs regardless of sendDefaultPii
+ * Sentry.init({
+ *   sendDefaultPii: true,
+ *   integrations: [
+ *     Sentry.langChainIntegration({
+ *       recordInputs: false,
+ *       recordOutputs: false
+ *     })
+ *   ],
+ * });
+ * ```
+ *
+ * ## Supported Events
+ *
+ * The integration captures the following LangChain lifecycle events:
+ * - LLM/Chat Model: start, end, error
+ * - Chain: start, end, error
+ * - Tool: start, end, error
+ *
+ */
+export declare const langChainIntegration: (options?: LangChainOptions | undefined) => import("@sentry/core").Integration;
+//# sourceMappingURL=index.d.ts.map

package/build/types-ts3.8/integrations/tracing/langchain/instrumentation.d.ts

@@ -0,0 +1,29 @@
+import { InstrumentationConfig, InstrumentationModuleDefinition, InstrumentationBase } from '@opentelemetry/instrumentation';
+import { LangChainOptions } from '@sentry/core';
+type LangChainInstrumentationOptions = InstrumentationConfig & LangChainOptions;
+/**
+ * Sentry LangChain instrumentation using OpenTelemetry.
+ */
+export declare class SentryLangChainInstrumentation extends InstrumentationBase<LangChainInstrumentationOptions> {
+    constructor(config?: LangChainInstrumentationOptions);
+    /**
+     * Initializes the instrumentation by defining the modules to be patched.
+     * We patch the BaseChatModel class methods to inject callbacks
+     *
+     * We hook into provider packages (@langchain/anthropic, @langchain/openai, etc.)
+     * because @langchain/core is often bundled and not loaded as a separate module
+     */
+    init(): InstrumentationModuleDefinition | InstrumentationModuleDefinition[];
+    /**
+     * Core patch logic - patches chat model methods to inject Sentry callbacks
+     * This is called when a LangChain provider package is loaded
+     */
+    private _patch;
+    /**
+     * 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
+     */
+    private _patchRunnableMethods;
+}
+export {};
+//# sourceMappingURL=instrumentation.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/node",
-  "version": "10.21.0",
+  "version": "10.23.0",
   "description": "Sentry Node SDK using OpenTelemetry for performance instrumentation",
   "repository": "git://github.com/getsentry/sentry-javascript.git",
   "homepage": "https://github.com/getsentry/sentry-javascript/tree/master/packages/node",
@@ -95,9 +95,9 @@
     "@opentelemetry/sdk-trace-base": "^2.1.0",
     "@opentelemetry/semantic-conventions": "^1.37.0",
     "@prisma/instrumentation": "6.15.0",
-    "@sentry/core": "10.21.0",
-    "@sentry/node-core": "10.21.0",
-    "@sentry/opentelemetry": "10.21.0",
+    "@sentry/core": "10.23.0",
+    "@sentry/node-core": "10.23.0",
+    "@sentry/opentelemetry": "10.23.0",
     "import-in-the-middle": "^1.14.2",
     "minimatch": "^9.0.0"
   },