@depup/sentry__server-utils 10.75.2-depup.0 → 11.1.0-depup.0

package/build/types/ai/google-genai/utils.d.ts

@@ -0,0 +1,50 @@
+import type { Span } from '@sentry/core';
+export type ContentListUnion = Content | Content[] | PartListUnion;
+export type ContentUnion = Content | PartUnion[] | PartUnion;
+export type Content = {
+    parts?: Part[];
+    role?: string;
+};
+export type PartUnion = Part | string;
+export type Part = Record<string, unknown> & {
+    inlineData?: {
+        data?: string;
+        displayName?: string;
+        mimeType?: string;
+    };
+    text?: string;
+};
+export type PartListUnion = PartUnion[] | PartUnion;
+/**
+ * A message part as described in https://develop.sentry.dev/sdk/telemetry/traces/modules/ai-agents/.
+ * Parts Sentry cannot type are dropped when the message is rendered, so Google's own `Part` shape
+ * (`{ text }`, `{ functionCall }`, ...) has to be translated into this one.
+ */
+export type MessagePart = Record<string, unknown> & {
+    type: string;
+};
+export type Message = {
+    role: string;
+    parts: MessagePart[];
+};
+/**
+ * Binary payloads are reported by media type only: `inlineData.data` is base64 bytes, which the
+ * conventions require to be dropped rather than recorded.
+ */
+export declare function partToMessagePart(part: unknown): MessagePart | undefined;
+/**
+ * Bare parts are collected into one message rather than one message each: `[{ text }, { inlineData }]`
+ * is a single multimodal turn in Google's API, not two turns.
+ */
+export declare function contentUnionToMessages(content: ContentListUnion, role?: string): Message[];
+/** Collect the message parts of every candidate in a response. */
+export declare function candidatesToMessageParts(candidates: unknown): MessagePart[];
+/**
+ * Set alongside the deprecated `gen_ai.response.text` / `gen_ai.response.tool_calls`: Relay migrates
+ * those into `gen_ai.output.messages`, but the tool-calls half of that migration is lossy, so a turn
+ * that only calls a tool would otherwise render an empty Output.
+ */
+export declare function setOutputMessagesAttribute(span: Span, parts: MessagePart[]): void;
+/** Flatten a `ContentUnion` instruction into the plain text `gen_ai.system_instructions` expects. */
+export declare function systemInstructionToText(systemInstruction: unknown): string | undefined;
+//# sourceMappingURL=utils.d.ts.map

package/build/types/ai/google-genai/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/ai/google-genai/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAIzC,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,EAAE,GAAG,aAAa,CAAC;AACnE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,EAAE,GAAG,SAAS,CAAC;AAC7D,MAAM,MAAM,OAAO,GAAG;IACpB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC;AACtC,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC3C,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,SAAS,EAAE,GAAG,SAAS,CAAC;AAEpD;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB,CAAC;AAWF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CA2CxE;AAkBD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,SAAS,GAAG,OAAO,EAAE,CAsC1F;AAED,kEAAkE;AAClE,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,OAAO,GAAG,WAAW,EAAE,CAU3E;AAuBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAKjF;AAED,qGAAqG;AACrG,wBAAgB,uBAAuB,CAAC,iBAAiB,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOtF"}

package/build/types/ai/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * AI/gen-ai instrumentation logic for server runtimes.
+ *
+ * @module
+ */
+export { instrumentOpenAiClient } from './openai';
+export { instrumentAnthropicAiClient } from './anthropic-ai';
+export { instrumentGoogleGenAIClient } from './google-genai';
+export { instrumentMistralAiClient } from './mistral';
+export { instrumentTypeSafeClient } from './typesafe';
+export { instrumentWorkersAiClient } from './workers-ai';
+export { createLangChainCallbackHandler, instrumentLangChainEmbeddings } from './langchain';
+export { instrumentStateGraph, instrumentStateGraphCompile, instrumentCreateReactAgent } from './langgraph';
+export { SentryMastraExporter } from './mastra';
+export { createFlueInstrumentation } from './flue';
+export type { FlueOptions } from './flue';
+//# sourceMappingURL=index.d.ts.map

package/build/types/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC5G,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC"}

package/build/types/ai/langchain/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const LANGCHAIN_INTEGRATION_NAME: 'LangChain';
+export declare const LANGCHAIN_ORIGIN = "auto.ai.langchain";
+export declare const ROLE_MAP: Record<string, string>;
+//# sourceMappingURL=constants.d.ts.map

package/build/types/ai/langchain/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/ai/langchain/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,EAAG,WAAoB,CAAC;AAC/D,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO3C,CAAC"}

package/build/types/ai/langchain/embeddings.d.ts

@@ -0,0 +1,38 @@
+import type { SpanAttributeValue } from '@sentry/core';
+import type { LangChainOptions } from './types';
+/**
+ * Builds the span options for a LangChain embedding call from the embeddings instance and input.
+ *
+ * @internal Exported so the diagnostics-channel (orchestrion) instrumentation can build the same
+ * span as the prototype-patching path below.
+ */
+export declare function _INTERNAL_getLangChainEmbeddingsSpanOptions(instance: unknown, input: unknown, options?: LangChainOptions): {
+    name: string;
+    attributes: Record<string, SpanAttributeValue>;
+};
+/**
+ * Wraps a LangChain embedding method (embedQuery or embedDocuments) to create Sentry spans.
+ *
+ * Used internally by the Node.js auto-instrumentation to patch embedding class prototypes.
+ */
+export declare function instrumentEmbeddingMethod(originalMethod: (...args: unknown[]) => Promise<unknown>, options?: LangChainOptions): (...args: unknown[]) => Promise<unknown>;
+/**
+ * Wraps a LangChain embeddings instance to create Sentry spans for `embedQuery` and `embedDocuments` calls.
+ *
+ * Use this in non-Node runtimes (Cloudflare, browser, etc.) where auto-instrumentation is not available.
+ *
+ * @example
+ * ```javascript
+ * import * as Sentry from '@sentry/cloudflare';
+ * import { OpenAIEmbeddings } from '@langchain/openai';
+ *
+ * const embeddings = Sentry.instrumentLangChainEmbeddings(
+ *   new OpenAIEmbeddings({ model: 'text-embedding-3-small' })
+ * );
+ *
+ * await embeddings.embedQuery('Hello world');
+ * await embeddings.embedDocuments(['doc1', 'doc2']);
+ * ```
+ */
+export declare function instrumentLangChainEmbeddings<T extends object>(instance: T, options?: LangChainOptions): T;
+//# sourceMappingURL=embeddings.d.ts.map

package/build/types/ai/langchain/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../../../src/ai/langchain/embeddings.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAevD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AA0ChD;;;;;GAKG;AACH,wBAAgB,2CAA2C,CACzD,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,gBAAqB,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;CAAE,CAkBlE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EACxD,OAAO,GAAE,gBAAqB,GAC7B,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAU1C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,CAAC,CAkB1G"}

package/build/types/ai/langchain/index.d.ts

@@ -0,0 +1,10 @@
+import type { LangChainCallbackHandler, LangChainOptions } from './types';
+/**
+ * Creates a Sentry callback handler for LangChain
+ * Returns a plain object that LangChain will call via duck-typing
+ *
+ * This is a stateful handler that tracks spans across multiple LangChain executions.
+ */
+export declare function createLangChainCallbackHandler(options?: LangChainOptions): LangChainCallbackHandler;
+export { instrumentLangChainEmbeddings } from './embeddings';
+//# sourceMappingURL=index.d.ts.map

package/build/types/ai/langchain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/langchain/index.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,wBAAwB,EAGxB,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AAUjB;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,GAAE,gBAAqB,GAAG,wBAAwB,CAmVvG;AAED,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC"}

package/build/types/ai/langchain/types.d.ts

@@ -0,0 +1,136 @@
+import type { GenAiOptions } from '../core/utils';
+/** Options for the LangChain integration. */
+export type LangChainOptions = GenAiOptions;
+/**
+ * LangChain Serialized type (compatible with @langchain/core)
+ * Uses general types to be compatible with LangChain's Serialized interface.
+ * This is a flexible interface that accepts any serialized LangChain object.
+ */
+export interface LangChainSerialized {
+    [key: string]: unknown;
+    lc?: number;
+    type?: string;
+    id?: string[];
+    name?: string;
+    graph?: Record<string, unknown>;
+    kwargs?: Record<string, unknown>;
+}
+/**
+ * Subset of the 'llm' param passed to createReactAgent
+ */
+export interface BaseChatModel {
+    lc_namespace: string[];
+    modelName?: string;
+    model?: string;
+}
+/**
+ * LangChain message structure
+ * Supports both regular messages and LangChain serialized format
+ */
+export interface LangChainMessage {
+    [key: string]: unknown;
+    type?: string;
+    content?: string;
+    message?: {
+        content?: unknown[];
+        type?: string;
+    };
+    role?: string;
+    additional_kwargs?: Record<string, unknown>;
+    lc?: number;
+    id?: string[] | string;
+    response_metadata?: {
+        model_name?: string;
+        finish_reason?: string;
+    };
+    kwargs?: {
+        [key: string]: unknown;
+        content?: string;
+        additional_kwargs?: Record<string, unknown>;
+        response_metadata?: Record<string, unknown>;
+    };
+}
+/**
+ * LangChain LLM result structure
+ */
+export interface LangChainLLMResult {
+    [key: string]: unknown;
+    generations: Array<Array<{
+        text?: string;
+        message?: LangChainMessage;
+        generation_info?: {
+            [key: string]: unknown;
+            finish_reason?: string;
+            logprobs?: unknown;
+        };
+        generationInfo?: {
+            [key: string]: unknown;
+            finish_reason?: string;
+            logprobs?: unknown;
+        };
+    }>>;
+    llmOutput?: {
+        [key: string]: unknown;
+        tokenUsage?: {
+            completionTokens?: number;
+            promptTokens?: number;
+            totalTokens?: number;
+        };
+        model_name?: string;
+    };
+}
+/**
+ * LangChain callback handler interface
+ * Compatible with both BaseCallbackHandlerMethodsClass and BaseCallbackHandler from @langchain/core
+ * Uses general types and index signature for maximum compatibility across LangChain versions
+ */
+export interface LangChainCallbackHandler {
+    [key: string]: unknown;
+    lc_serializable: boolean;
+    lc_namespace: ['langchain_core', 'callbacks', string];
+    lc_secrets: {
+        [key: string]: string;
+    } | undefined;
+    lc_attributes: {
+        [key: string]: string;
+    } | undefined;
+    lc_aliases: {
+        [key: string]: string;
+    } | undefined;
+    lc_serializable_keys: string[] | undefined;
+    lc_id: string[];
+    lc_kwargs: {
+        [key: string]: any;
+    };
+    name: string;
+    ignoreLLM: boolean;
+    ignoreChain: boolean;
+    ignoreAgent: boolean;
+    ignoreRetriever: boolean;
+    ignoreCustomEvent: boolean;
+    raiseError: boolean;
+    awaitHandlers: boolean;
+    handleLLMStart?: (llm: unknown, prompts: string[], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string) => Promise<unknown> | unknown;
+    handleChatModelStart?: (llm: unknown, messages: unknown, runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string) => Promise<unknown> | unknown;
+    handleLLMNewToken?: (token: string, idx: unknown, runId: string, parentRunId?: string, tags?: string[], fields?: unknown) => Promise<unknown> | unknown;
+    handleLLMEnd?: (output: unknown, runId: string, parentRunId?: string, tags?: string[], extraParams?: Record<string, unknown>) => Promise<unknown> | unknown;
+    handleLLMError?: (error: Error, runId: string, parentRunId?: string, tags?: string[], extraParams?: Record<string, unknown>) => Promise<unknown> | unknown;
+    handleChainStart?: (chain: {
+        name?: string;
+    }, inputs: Record<string, unknown>, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, runType?: string, runName?: string) => Promise<unknown> | unknown;
+    handleChainEnd?: (outputs: unknown, runId: string, parentRunId?: string, tags?: string[], kwargs?: {
+        inputs?: Record<string, unknown>;
+    }) => Promise<unknown> | unknown;
+    handleChainError?: (error: Error, runId: string, parentRunId?: string, tags?: string[], kwargs?: {
+        inputs?: Record<string, unknown>;
+    }) => Promise<unknown> | unknown;
+    handleToolStart?: (tool: {
+        name?: string;
+    }, input: string, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, runName?: string) => Promise<unknown> | unknown;
+    handleToolEnd?: (output: unknown, runId: string, parentRunId?: string, tags?: string[]) => Promise<unknown> | unknown;
+    handleToolError?: (error: Error, runId: string, parentRunId?: string, tags?: string[]) => Promise<unknown> | unknown;
+    copy(): unknown;
+    toJSON(): Record<string, unknown>;
+    toJSONNotImplemented(): unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types/ai/langchain/types.d.ts.map

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

package/build/types/ai/langchain/utils.d.ts

@@ -0,0 +1,67 @@
+import type { SpanAttributeValue } from '@sentry/core';
+import type { LangChainLLMResult, LangChainMessage, LangChainSerialized } from './types';
+/**
+ * Returns invocation params from a LangChain `tags` object.
+ *
+ * LangChain often passes runtime parameters (model, temperature, etc.) via the
+ * `tags.invocation_params` bag. If `tags` is an array (LangChain sometimes uses
+ * string tags), we return `undefined`.
+ *
+ * @param tags LangChain tags (string[] or record)
+ * @returns The `invocation_params` object, if present
+ */
+export declare function getInvocationParams(tags?: string[] | Record<string, unknown>): Record<string, unknown> | undefined;
+/**
+ * Normalizes a heterogeneous set of LangChain messages to `{ role, content }`.
+ *
+ * Why so many branches? LangChain messages can arrive in several shapes:
+ *  - Message classes with `_getType()` (most reliable)
+ *  - Classes with meaningful constructor names (e.g. `SystemMessage`)
+ *  - Plain objects with `type`, or `{ role, content }`
+ *  - Serialized format with `{ lc: 1, id: [...], kwargs: { content } }`
+ * We preserve the prioritization to minimize behavioral drift.
+ *
+ * @param messages Mixed LangChain messages
+ * @returns Array of normalized `{ role, content }`
+ */
+export declare function normalizeLangChainMessages(messages: LangChainMessage[]): Array<{
+    role: string;
+    content: string | undefined;
+}>;
+/**
+ * Extracts attributes for plain LLM invocations (string prompts).
+ *
+ * - Operation is tagged as `chat` following OpenTelemetry semantic conventions.
+ *   LangChain LLM operations are treated as chat operations.
+ * - When `recordInputs` is true, string prompts are wrapped into `{role:"user"}`
+ *   messages to align with the chat schema used elsewhere.
+ */
+export declare function extractLLMRequestAttributes(llm: LangChainSerialized, prompts: string[], recordInputs: boolean, invocationParams?: Record<string, unknown>, langSmithMetadata?: Record<string, unknown>): Record<string, SpanAttributeValue | undefined>;
+/**
+ * Extracts attributes for ChatModel invocations (array-of-arrays of messages).
+ *
+ * - Operation is tagged as `chat` following OpenTelemetry semantic conventions.
+ *   LangChain chat model operations are chat operations.
+ * - We flatten LangChain's `LangChainMessage[][]` and normalize shapes into a
+ *   consistent `{ role, content }` array when `recordInputs` is true.
+ * - Provider system value falls back to `serialized.id?.[2]`.
+ */
+export declare function extractChatModelRequestAttributes(llm: LangChainSerialized, langChainMessages: LangChainMessage[][], recordInputs: boolean, invocationParams?: Record<string, unknown>, langSmithMetadata?: Record<string, unknown>): Record<string, SpanAttributeValue | undefined>;
+/**
+ * Extracts response-related attributes based on a `LangChainLLMResult`.
+ *
+ * - Records finish reasons when present on generations (e.g., OpenAI)
+ * - When `recordOutputs` is true, captures textual response content and any
+ *   tool calls.
+ * - Also propagates model name (`model_name` or `model`), response `id`, and
+ *   `stop_reason` (for providers that use it).
+ */
+export declare function extractLlmResponseAttributes(llmResult: LangChainLLMResult, recordOutputs: boolean): Record<string, SpanAttributeValue> | undefined;
+export declare function getAgentNameFromMetadata(metadata?: Record<string, unknown>): Record<string, SpanAttributeValue>;
+export declare function extractToolDefinitions(extraParams?: Record<string, unknown>): string | undefined;
+/**
+ * Merge `sentryHandler` into a given set of LangChain callbacks or callback manager.
+ * @internal Exported for cross-package instrumentation.
+ */
+export declare function _INTERNAL_mergeLangChainCallbackHandler(existing: unknown, sentryHandler: unknown): unknown;
+//# sourceMappingURL=utils.d.ts.map

package/build/types/ai/langchain/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/ai/langchain/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AA2BvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAkDzF;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGlH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,CA2DtD;AAiED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,OAAO,EACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC,CAYhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,mBAAmB,EACxB,iBAAiB,EAAE,gBAAgB,EAAE,EAAE,EACvC,YAAY,EAAE,OAAO,EACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC,CAmBhD;AA8ED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,kBAAkB,EAC7B,aAAa,EAAE,OAAO,GACrB,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,SAAS,CAkEhD;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAQ/G;AAED,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAchG;AAuBD;;;GAGG;AACH,wBAAgB,uCAAuC,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAqB1G"}

package/build/types/ai/langgraph/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const LANGGRAPH_INTEGRATION_NAME: 'LangGraph';
+export declare const LANGGRAPH_ORIGIN = "auto.ai.langgraph";
+//# sourceMappingURL=constants.d.ts.map

package/build/types/ai/langgraph/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/ai/langgraph/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,EAAG,WAAoB,CAAC;AAC/D,eAAO,MAAM,gBAAgB,sBAAsB,CAAC"}

package/build/types/ai/langgraph/index.d.ts

@@ -0,0 +1,44 @@
+import type { BaseChatModel } from '../langchain/types';
+import type { CompiledGraph, LangGraphOptions } from './types';
+/**
+ * Instruments StateGraph's compile method to wrap the returned compiled graph's invoke() with a
+ * `gen_ai.invoke_agent` span.
+ */
+export declare function instrumentStateGraphCompile(originalCompile: (...args: unknown[]) => CompiledGraph, rawOptions: LangGraphOptions): (...args: unknown[]) => CompiledGraph;
+/**
+ * Instruments CompiledGraph's invoke method to create spans for agent invocation
+ *
+ * Creates a `gen_ai.invoke_agent` span when invoke() is called
+ */
+export declare function instrumentCompiledGraphInvoke(originalInvoke: (...args: unknown[]) => Promise<unknown>, graphInstance: CompiledGraph, compileOptions: Record<string, unknown>, options: LangGraphOptions, llm?: BaseChatModel | null, sentryCallbackHandler?: unknown): (...args: unknown[]) => Promise<unknown>;
+/**
+ * Instruments createReactAgent to create invoke_agent and execute_tool spans.
+ */
+export declare function instrumentCreateReactAgent(originalCreateReactAgent: (...args: unknown[]) => CompiledGraph, options?: LangGraphOptions): (...args: unknown[]) => CompiledGraph;
+/**
+ * Directly instruments a StateGraph instance to add tracing spans
+ *
+ * This function can be used to manually instrument LangGraph StateGraph instances
+ * in environments where automatic instrumentation is not available or desired.
+ *
+ * @param stateGraph - The StateGraph instance to instrument
+ * @param options - Optional configuration for recording inputs/outputs
+ *
+ * @example
+ * ```typescript
+ * import { instrumentStateGraph } from '@sentry/cloudflare';
+ * import { StateGraph } from '@langchain/langgraph';
+ *
+ * const graph = new StateGraph(MessagesAnnotation)
+ *   .addNode('agent', mockLlm)
+ *   .addEdge(START, 'agent')
+ *   .addEdge('agent', END);
+ *
+ * instrumentStateGraph(graph, { recordInputs: true, recordOutputs: true });
+ * const compiled = graph.compile({ name: 'my_agent' });
+ * ```
+ */
+export declare function instrumentStateGraph<T extends {
+    compile: (...args: any[]) => any;
+}>(stateGraph: T, options?: LangGraphOptions): T;
+//# sourceMappingURL=index.d.ts.map

package/build/types/ai/langgraph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/langgraph/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,oBAAoB,CAAC;AAG1E,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAc/D;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,aAAa,EACtD,UAAU,EAAE,gBAAgB,GAC3B,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,aAAa,CAuCvC;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EACxD,aAAa,EAAE,aAAa,EAC5B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,OAAO,EAAE,gBAAgB,EACzB,GAAG,CAAC,EAAE,aAAa,GAAG,IAAI,EAC1B,qBAAqB,CAAC,EAAE,OAAO,GAC9B,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAkG1C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,wBAAwB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,aAAa,EAC/D,OAAO,CAAC,EAAE,gBAAgB,GACzB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,aAAa,CAoDvC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;CAAE,EACjF,UAAU,EAAE,CAAC,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,CAAC,CAIH"}

package/build/types/ai/langgraph/types.d.ts

@@ -0,0 +1,64 @@
+import type { GenAiOptions } from '../core/utils';
+/** Options for the LangGraph integration. */
+export type LangGraphOptions = GenAiOptions;
+/**
+ * LangGraph Tool definition from lc_kwargs
+ */
+export interface LangGraphToolDefinition {
+    name?: string;
+    description?: string;
+    schema?: unknown;
+    func?: (...args: unknown[]) => unknown;
+}
+/**
+ * LangGraph Tool object (DynamicTool, DynamicStructuredTool, etc.)
+ */
+export interface LangGraphTool {
+    [key: string]: unknown;
+    lc_kwargs?: LangGraphToolDefinition;
+    name?: string;
+    description?: string;
+}
+/**
+ * LangGraph ToolNode with tools array
+ */
+export interface ToolNode {
+    [key: string]: unknown;
+    tools?: LangGraphTool[];
+}
+/**
+ * LangGraph PregelNode containing a ToolNode
+ */
+export interface PregelNode {
+    [key: string]: unknown;
+    runnable?: ToolNode;
+}
+/**
+ * LangGraph StateGraph builder nodes
+ */
+export interface StateGraphNodes {
+    [key: string]: unknown;
+    tools?: PregelNode;
+}
+/**
+ * LangGraph StateGraph builder
+ */
+export interface StateGraphBuilder {
+    [key: string]: unknown;
+    nodes?: StateGraphNodes;
+}
+/**
+ * Basic interface for compiled graph
+ */
+export interface CompiledGraph {
+    [key: string]: unknown;
+    invoke?: (...args: unknown[]) => Promise<unknown>;
+    name?: string;
+    graph_name?: string;
+    lc_kwargs?: {
+        [key: string]: unknown;
+        name?: string;
+    };
+    builder?: StateGraphBuilder;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types/ai/langgraph/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/ai/langgraph/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE;QACV,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B"}

package/build/types/ai/langgraph/utils.d.ts

@@ -0,0 +1,45 @@
+import type { Span } from '@sentry/core';
+import type { BaseChatModel, LangChainMessage } from '../langchain/types';
+import type { CompiledGraph, LangGraphOptions } from './types';
+/**
+ * Extract LLM model object from createReactAgent params
+ */
+export declare function extractLLMFromParams(args: unknown[]): BaseChatModel | null;
+/**
+ * Extract agent name from createReactAgent params
+ */
+export declare function extractAgentNameFromParams(args: unknown[]): string | null;
+/**
+ * Wraps an array of LangChain tools so each invocation creates a gen_ai.execute_tool span.
+ *
+ * Wraps each tool's invoke() method in place. A marker prevents double-wrapping.
+ */
+export declare function wrapToolsWithSpans(tools: unknown[], options: LangGraphOptions, agentName?: string): unknown[];
+/**
+ * Extract tool calls from messages
+ */
+export declare function extractToolCalls(messages: Array<Record<string, unknown>> | null): unknown[] | null;
+/**
+ * Extract token usage from a message's usage_metadata or response_metadata
+ * Returns token counts without setting span attributes
+ */
+export declare function extractTokenUsageFromMessage(message: LangChainMessage): {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+};
+/**
+ * Extract model and finish reason from a message's response_metadata
+ */
+export declare function extractModelMetadata(span: Span, message: LangChainMessage): void;
+/**
+ * Extract tools from compiled graph structure
+ *
+ * Tools are stored in: compiledGraph.builder.nodes.tools.runnable.tools
+ */
+export declare function extractToolsFromCompiledGraph(compiledGraph: CompiledGraph): unknown[] | null;
+/**
+ * Set response attributes on the span
+ */
+export declare function setResponseAttributes(span: Span, inputMessages: LangChainMessage[] | null, result: unknown): void;
+//# sourceMappingURL=utils.d.ts.map

package/build/types/ai/langgraph/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/ai/langgraph/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,cAAc,CAAC;AAmBzD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAiB,MAAM,SAAS,CAAC;AAE9E;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,aAAa,GAAG,IAAI,CAU1E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAMzE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAgG7G;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,CAiBlG;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,gBAAgB,GAAG;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAuCA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAchF;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,EAAE,GAAG,IAAI,CAiB5F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,gBAAgB,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAuDjH"}

package/build/types/ai/mastra/constants.d.ts

@@ -0,0 +1,32 @@
+export declare const MASTRA_INTEGRATION_NAME: 'Mastra';
+/** Cap on tracked spans, matching `MAX_TRACKED_PRISMA_SPANS`. Spans that never end would otherwise leak. */
+export declare const MAX_TRACKED_MASTRA_SPANS = 1000;
+export declare const MASTRA_ORIGIN = "auto.ai.mastra";
+/** Not `sentry` — that is the community `@mastra/sentry` exporter name. */
+export declare const MASTRA_EXPORTER_NAME = "sentry-sdk";
+/** Name used by the community `@mastra/sentry` package. */
+export declare const COMMUNITY_MASTRA_SENTRY_EXPORTER_NAME = "sentry";
+/**
+ * Distinguishes our exporter from the community one. `Symbol.for` so the check still matches if
+ * two copies of `@sentry/server-utils` are loaded (`instanceof` would not).
+ */
+export declare const MASTRA_EXPORTER_BRAND: unique symbol;
+/**
+ * Only conventional `gen_ai` ops. Unmapped Mastra types (workflow steps, processors, scorers, …)
+ * are dropped; their children re-parent onto the nearest mapped ancestor.
+ *
+ * `op` comes from `@sentry/conventions/op`. `operationName` is a `gen_ai.operation.name` literal —
+ * the conventions package has no constants for those.
+ */
+export declare const SPAN_TYPE_OPS: Readonly<Record<string, {
+    op: string;
+    operationName: string;
+}>>;
+export declare const TOOL_SPAN_TYPES: ReadonlySet<string>;
+/**
+ * `model_inference` is omitted: Mastra nests `model_generation > model_step > model_inference`,
+ * and the inference span repeats the generation — mapping both to `gen_ai.chat` duplicates it.
+ */
+export declare const MODEL_SPAN_TYPES: ReadonlySet<string>;
+export declare const AGENT_SPAN_TYPES: ReadonlySet<string>;
+//# sourceMappingURL=constants.d.ts.map

package/build/types/ai/mastra/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/ai/mastra/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,EAAG,QAAiB,CAAC;AAEzD,4GAA4G;AAC5G,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAE9C,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD,2DAA2D;AAC3D,eAAO,MAAM,qCAAqC,WAAW,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,eAAuC,CAAC;AAE1E;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CASzF,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAK9C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAiD,CAAC;AAEnG,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAA0D,CAAC"}

package/build/types/ai/mastra/index.d.ts

@@ -0,0 +1,43 @@
+import type { GenAiOptions } from '../core/utils';
+import { MASTRA_EXPORTER_BRAND } from './constants';
+import type { MastraObservabilityExporter, MastraTracingEvent } from './types';
+export type MastraExporterOptions = GenAiOptions;
+/**
+ * Mastra `ObservabilityExporter` that turns tracing events into Sentry spans.
+ *
+ * Never calls `Sentry.init()` / `Sentry.close()` — the community `@mastra/sentry` package does both
+ * and replaces the app's client. No `@mastra/*` or `node:` imports.
+ */
+export declare class SentryMastraExporter implements MastraObservabilityExporter {
+    name: string;
+    readonly [MASTRA_EXPORTER_BRAND] = true;
+    private readonly _spans;
+    /**
+     * Dropped span id -> parent id, for re-parenting descendants. A dropped span with no parent maps to
+     * its own id: `LRUMap.remove` only deletes truthy values, so an empty-string sentinel would never be
+     * evicted and would eventually fill the map, while a self-reference can never be a real parent id.
+     */
+    private readonly _skipped;
+    private readonly _options;
+    constructor(options?: MastraExporterOptions);
+    /** Mastra's interface is async; the work is synchronous. */
+    exportTracingEvent(event: MastraTracingEvent): Promise<void>;
+    /** Flush without closing the client — the app still owns it. */
+    flush(): Promise<void>;
+    /** End open spans, then flush. Does not close the Sentry client. */
+    shutdown(): Promise<void>;
+    private _handleEvent;
+    private _onSpanStarted;
+    /** Track a started span, ending any Sentry span that would otherwise be dropped without `end()`. */
+    private _trackSpan;
+    /** Remove a tracked span and keep the id→span registry in lockstep. */
+    private _removeTracked;
+    private _onSpanUpdated;
+    private _onSpanEnded;
+    /** Copy model/usage onto the parent agent so the AI Agents view shows totals. */
+    private _rollUpToParentAgent;
+    /** Nearest exported ancestor of a dropped span. */
+    private _resolveParentId;
+    private _attributesFor;
+}
+//# sourceMappingURL=index.d.ts.map

package/build/types/ai/mastra/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/mastra/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAWlD,OAAO,EAEL,qBAAqB,EAKtB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAsB,2BAA2B,EAAkB,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEnH,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAajD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,2BAA2B;IAC/D,IAAI,SAAwB;IAEnC,SAAgB,CAAC,qBAAqB,CAAC,QAAQ;IAE/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6D;IACpF;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwD;IACjF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IAEjD,YAAmB,OAAO,GAAE,qBAA0B,EAErD;IAED,4DAA4D;IAC/C,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUxE;IAED,gEAAgE;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAElC;IAED,oEAAoE;IACvD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAUrC;IAED,OAAO,CAAC,YAAY;IA8BpB,OAAO,CAAC,cAAc;IAoBtB,oGAAoG;IACpG,OAAO,CAAC,UAAU;IAiBlB,uEAAuE;IACvE,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;IAwBpB,iFAAiF;IACjF,OAAO,CAAC,oBAAoB;IAiB5B,mDAAmD;IACnD,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,cAAc;CAIvB"}

package/build/types/ai/mastra/span-registry.d.ts

@@ -0,0 +1,5 @@
+import type { Span } from '@sentry/core';
+export declare function registerMastraSpan(mastraId: string, span: Span): void;
+export declare function unregisterMastraSpan(mastraId: string): void;
+export declare function getSentrySpanForMastraId(mastraId: string): Span | undefined;
+//# sourceMappingURL=span-registry.d.ts.map