@introspection-sdk/introspection-node 0.4.3 → 0.4.4

package/dist/claude-wrapper.js

@@ -1,154 +0,0 @@
-/**
- * Claude Agent SDK Wrapper
- *
- * Provides a zero-friction `withIntrospection()` wrapper for the Claude Agent SDK.
- * Automatically instruments all query() calls with OpenTelemetry tracing via
- * IntrospectionClaudeHooks — no manual hook wiring or recordUsage() calls needed.
- *
- * @example
- * ```typescript
- * import * as sdk from "@anthropic-ai/claude-agent-sdk";
- * import { withIntrospection } from "@introspection-sdk/introspection-node";
- *
- * const tracedSdk = withIntrospection(sdk, { serviceName: "my-agent" });
- *
- * for await (const message of tracedSdk.query({ prompt: "Hello" })) {
- *   // messages yielded normally — tracing happens automatically
- * }
- *
- * await tracedSdk.shutdown();
- * ```
- */
-import { IntrospectionClaudeHooks, } from "./claude-hooks.js";
-import { logger } from "./utils.js";
-// --- Implementation ---
-/**
- * Wrap the Claude Agent SDK module to automatically instrument every
- * `query()` call with OpenTelemetry tracing.
- *
- * The returned SDK:
- * - Auto-captures `prompt` and `systemPrompt` from query params
- * - Injects instrumentation hooks (merged with any user-provided hooks)
- * - Calls {@link IntrospectionClaudeHooks.recordUsage | recordUsage()} on
- *   every streamed message automatically
- * - Flushes spans when each query stream completes
- *
- * @param sdk - The Claude Agent SDK module
- *   (`import * as sdk from "@anthropic-ai/claude-agent-sdk"`).
- * @param options - Introspection configuration (token, serviceName, baseUrl, etc.).
- * @returns An {@link InstrumentedClaudeAgentSDK} with the same API plus
- *   `forceFlush()`, `shutdown()`, and `hooks`.
- *
- * @example
- * ```ts
- * import * as sdk from "@anthropic-ai/claude-agent-sdk";
- * import { withIntrospection } from "@introspection-sdk/introspection-node";
- *
- * const traced = withIntrospection(sdk, { serviceName: "my-agent" });
- * for await (const msg of traced.query({ prompt: "Hello" })) { /* … *\/ }
- * await traced.shutdown();
- * ```
- */
-export function withIntrospection(sdk, options) {
-    const hooks = new IntrospectionClaudeHooks(options);
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    function wrappedQuery(params) {
-        // Auto-capture prompt
-        if (typeof params?.prompt === "string") {
-            hooks.setInputPrompt(params.prompt);
-        }
-        // Auto-capture systemPrompt from options
-        const opts = (params?.options || {});
-        if (typeof opts.systemPrompt === "string") {
-            hooks.setSystemInstructions(opts.systemPrompt);
-        }
-        // Merge instrumentation hooks with any user-provided hooks
-        const introspectionHooks = hooks.getHooks();
-        const userHooks = opts.hooks;
-        const mergedHooks = mergeHooks(introspectionHooks, userHooks);
-        // Call original query with merged hooks
-        const modifiedOptions = { ...opts, hooks: mergedHooks };
-        const originalQuery = sdk.query({
-            ...params,
-            options: modifiedOptions,
-        });
-        // Wrap the async generator to intercept messages
-        return wrapQueryResult(originalQuery, hooks);
-    }
-    return {
-        ...sdk,
-        query: wrappedQuery,
-        hooks,
-        forceFlush: () => hooks.forceFlush(),
-        shutdown: () => hooks.shutdown(),
-    };
-}
-/**
- * Merges introspection hooks with user-provided hooks.
- * Introspection hooks fire first, then user hooks.
- * User hooks on events we don't handle pass through untouched.
- */
-function mergeHooks(introspectionHooks, userHooks) {
-    if (!userHooks) {
-        return introspectionHooks;
-    }
-    const merged = {};
-    const allEvents = new Set([
-        ...Object.keys(introspectionHooks),
-        ...Object.keys(userHooks),
-    ]);
-    for (const event of allEvents) {
-        const ours = introspectionHooks[event] || [];
-        const theirs = userHooks[event] || [];
-        merged[event] = [...ours, ...theirs];
-    }
-    return merged;
-}
-/**
- * Wraps a Query async generator to intercept messages for usage recording.
- * Uses a Proxy to transparently forward all non-iterator properties
- * (interrupt, close, setModel, etc.) to the original Query object.
- */
-function wrapQueryResult(originalQuery, hooks) {
-    const query = originalQuery;
-    async function* instrumentedIterator() {
-        try {
-            for await (const message of query) {
-                hooks.recordUsage(message);
-                yield message;
-            }
-        }
-        finally {
-            try {
-                await hooks.forceFlush();
-            }
-            catch (flushError) {
-                logger.warn("Failed to flush spans after query completed", flushError);
-            }
-        }
-    }
-    const wrapped = instrumentedIterator();
-    // Use Proxy to transparently delegate non-iterator properties to original query.
-    // Iterator protocol methods come from our wrapper (bound to the actual generator
-    // to avoid "incompatible receiver" errors); everything else (interrupt, close,
-    // setModel, setPermissionMode, etc.) delegates to the original Query.
-    return new Proxy(wrapped, {
-        get(target, prop) {
-            if (prop === Symbol.asyncIterator ||
-                prop === "next" ||
-                prop === "return" ||
-                prop === "throw") {
-                const value = Reflect.get(target, prop);
-                if (typeof value === "function") {
-                    return value.bind(target);
-                }
-                return value;
-            }
-            const original = query[prop];
-            if (typeof original === "function") {
-                return original.bind(query);
-            }
-            return original;
-        },
-    });
-}

package/dist/converters/ai-sdk.d.ts

@@ -1,65 +0,0 @@
-/**
- * Converter for AI SDK event data → Gen AI semantic conventions.
- *
- * Converts typed event objects (messages, tool definitions, step results)
- * from the AI SDK's TelemetryIntegration callbacks into the standardized
- * gen_ai format used by the Introspection backend.
- *
- * Used by {@link IntrospectionAISDKIntegration}.
- */
-import type { InputMessage, OutputMessage, SystemInstruction, ToolDefinition } from "@introspection-sdk/types";
-/**
- * Convert AI SDK messages (ModelMessage[]) to gen_ai InputMessage[].
- * System messages are excluded — they're handled separately via
- * {@link extractSystemInstructions}.
- *
- * @param messages - Array of AI SDK ModelMessage objects.
- * @returns Array of gen_ai InputMessage objects (without system messages).
- */
-export declare function convertMessagesToInputMessages(messages: readonly unknown[]): InputMessage[];
-/**
- * Extract gen_ai system instructions from AI SDK's system field and messages.
- *
- * The AI SDK provides system prompts in two places:
- * - The `system` parameter (string, SystemModelMessage, or array)
- * - Messages with role "system"
- *
- * @param system - The AI SDK `system` field.
- * @param messages - The messages array (may contain system-role messages).
- * @returns System instructions in gen_ai format, or undefined if none.
- */
-export declare function extractSystemInstructions(system: unknown, messages: readonly unknown[]): SystemInstruction[] | undefined;
-/**
- * Build gen_ai output messages from AI SDK step result data.
- *
- * Combines text, reasoning, and tool call outputs into a single assistant
- * OutputMessage, mirroring the order used by vercel.ts (reasoning → text → tool calls).
- *
- * @param options - Step result fields.
- * @returns Array of gen_ai OutputMessage objects.
- */
-export declare function buildOutputMessages(options: {
-    text?: string;
-    reasoningText?: string;
-    reasoning?: readonly {
-        text?: string;
-    }[];
-    toolCalls?: readonly {
-        toolCallId: string;
-        toolName: string;
-        input: unknown;
-    }[];
-    finishReason?: string;
-}): OutputMessage[];
-/**
- * Convert AI SDK ToolSet to gen_ai ToolDefinition[].
- *
- * The AI SDK represents tools as `Record<string, Tool>` where each Tool has
- * description and parameters (usually a Zod schema). We extract what we can
- * without importing Zod.
- *
- * @param tools - AI SDK ToolSet (Record<string, Tool>).
- * @returns Array of gen_ai ToolDefinition objects, or undefined if no tools.
- */
-export declare function convertToolsToToolDefinitions(tools: unknown): ToolDefinition[] | undefined;
-//# sourceMappingURL=ai-sdk.d.ts.map

package/dist/converters/ai-sdk.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-sdk.d.ts","sourceRoot":"","sources":["../../src/converters/ai-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,cAAc,EAEf,MAAM,0BAA0B,CAAC;AAuBlC;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B,YAAY,EAAE,CAQhB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B,iBAAiB,EAAE,GAAG,SAAS,CAoCjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,SAAS;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,OAAO,CAAC;KAChB,EAAE,CAAC;IACJ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,aAAa,EAAE,CAuClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,cAAc,EAAE,GAAG,SAAS,CAgB9B"}

package/dist/converters/ai-sdk.js

@@ -1,261 +0,0 @@
-/**
- * Converter for AI SDK event data → Gen AI semantic conventions.
- *
- * Converts typed event objects (messages, tool definitions, step results)
- * from the AI SDK's TelemetryIntegration callbacks into the standardized
- * gen_ai format used by the Introspection backend.
- *
- * Used by {@link IntrospectionAISDKIntegration}.
- */
-// ---------------------------------------------------------------------------
-// Public conversion functions
-// ---------------------------------------------------------------------------
-/**
- * Convert AI SDK messages (ModelMessage[]) to gen_ai InputMessage[].
- * System messages are excluded — they're handled separately via
- * {@link extractSystemInstructions}.
- *
- * @param messages - Array of AI SDK ModelMessage objects.
- * @returns Array of gen_ai InputMessage objects (without system messages).
- */
-export function convertMessagesToInputMessages(messages) {
-    const result = [];
-    for (const msg of messages) {
-        const m = msg;
-        if (!m || !m.role || m.role === "system")
-            continue;
-        result.push(convertOneMessage(m));
-    }
-    return result;
-}
-/**
- * Extract gen_ai system instructions from AI SDK's system field and messages.
- *
- * The AI SDK provides system prompts in two places:
- * - The `system` parameter (string, SystemModelMessage, or array)
- * - Messages with role "system"
- *
- * @param system - The AI SDK `system` field.
- * @param messages - The messages array (may contain system-role messages).
- * @returns System instructions in gen_ai format, or undefined if none.
- */
-export function extractSystemInstructions(system, messages) {
-    const instructions = [];
-    // From the `system` field
-    if (typeof system === "string" && system) {
-        instructions.push({ type: "text", content: system });
-    }
-    else if (system && typeof system === "object") {
-        if (Array.isArray(system)) {
-            for (const s of system) {
-                const text = extractTextFromSystemMessage(s);
-                if (text)
-                    instructions.push({ type: "text", content: text });
-            }
-        }
-        else {
-            const text = extractTextFromSystemMessage(system);
-            if (text)
-                instructions.push({ type: "text", content: text });
-        }
-    }
-    // From system-role messages
-    for (const msg of messages) {
-        const m = msg;
-        if (m?.role === "system") {
-            const content = m.content;
-            if (typeof content === "string") {
-                instructions.push({ type: "text", content });
-            }
-            else if (Array.isArray(content)) {
-                const text = content
-                    .filter((p) => p.type === "text")
-                    .map((p) => p.text || "")
-                    .join("");
-                if (text)
-                    instructions.push({ type: "text", content: text });
-            }
-        }
-    }
-    return instructions.length > 0 ? instructions : undefined;
-}
-/**
- * Build gen_ai output messages from AI SDK step result data.
- *
- * Combines text, reasoning, and tool call outputs into a single assistant
- * OutputMessage, mirroring the order used by vercel.ts (reasoning → text → tool calls).
- *
- * @param options - Step result fields.
- * @returns Array of gen_ai OutputMessage objects.
- */
-export function buildOutputMessages(options) {
-    const parts = [];
-    // Reasoning first (mirrors vercel.ts order)
-    if (options.reasoningText) {
-        parts.push({ type: "thinking", content: options.reasoningText });
-    }
-    else if (options.reasoning?.length) {
-        for (const r of options.reasoning) {
-            if (r.text)
-                parts.push({ type: "thinking", content: r.text });
-        }
-    }
-    // Text content
-    if (options.text) {
-        parts.push({ type: "text", content: options.text });
-    }
-    // Tool calls
-    if (options.toolCalls?.length) {
-        for (const tc of options.toolCalls) {
-            parts.push({
-                type: "tool_call",
-                name: tc.toolName,
-                id: tc.toolCallId,
-                arguments: typeof tc.input === "string" ? tc.input : JSON.stringify(tc.input),
-            });
-        }
-    }
-    if (parts.length === 0)
-        return [];
-    return [
-        {
-            role: "assistant",
-            parts,
-            finish_reason: options.finishReason,
-        },
-    ];
-}
-/**
- * Convert AI SDK ToolSet to gen_ai ToolDefinition[].
- *
- * The AI SDK represents tools as `Record<string, Tool>` where each Tool has
- * description and parameters (usually a Zod schema). We extract what we can
- * without importing Zod.
- *
- * @param tools - AI SDK ToolSet (Record<string, Tool>).
- * @returns Array of gen_ai ToolDefinition objects, or undefined if no tools.
- */
-export function convertToolsToToolDefinitions(tools) {
-    if (!tools || typeof tools !== "object")
-        return undefined;
-    const defs = [];
-    for (const [name, tool] of Object.entries(tools)) {
-        if (!tool || typeof tool !== "object")
-            continue;
-        const t = tool;
-        defs.push({
-            name,
-            description: typeof t.description === "string" ? t.description : undefined,
-            parameters: extractToolParameters(t.inputSchema ?? t.parameters),
-        });
-    }
-    return defs.length > 0 ? defs : undefined;
-}
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-function convertOneMessage(msg) {
-    const role = (msg.role || "user");
-    const content = msg.content;
-    const parts = [];
-    if (typeof content === "string") {
-        parts.push({ type: "text", content });
-    }
-    else if (Array.isArray(content)) {
-        for (const part of content) {
-            const converted = convertContentPart(part);
-            if (converted)
-                parts.push(converted);
-        }
-    }
-    return { role, parts };
-}
-function convertContentPart(part) {
-    switch (part.type) {
-        case "text":
-            return { type: "text", content: part.text || "" };
-        case "tool-call": {
-            const args = part.args ?? part.input;
-            return {
-                type: "tool_call",
-                name: part.toolName || "",
-                id: part.toolCallId || "",
-                arguments: typeof args === "string" ? args : JSON.stringify(args ?? {}),
-            };
-        }
-        case "tool-result": {
-            const rawResult = part.result ?? part.output;
-            let response;
-            if (typeof rawResult === "string") {
-                response = rawResult;
-            }
-            else if (rawResult &&
-                typeof rawResult === "object" &&
-                "value" in rawResult) {
-                response = JSON.stringify(rawResult.value);
-            }
-            else {
-                response = JSON.stringify(rawResult);
-            }
-            return {
-                type: "tool_call_response",
-                id: part.toolCallId || "",
-                response,
-            };
-        }
-        case "reasoning":
-            return { type: "thinking", content: part.text || "" };
-        default:
-            // Unknown part type — serialize as text fallback
-            return { type: "text", content: JSON.stringify(part) };
-    }
-}
-function extractTextFromSystemMessage(msg) {
-    if (typeof msg === "string")
-        return msg;
-    if (msg && typeof msg === "object") {
-        const m = msg;
-        if (typeof m.content === "string")
-            return m.content;
-        if (typeof m.text === "string")
-            return m.text;
-    }
-    return null;
-}
-function extractToolParameters(parameters) {
-    if (!parameters || typeof parameters !== "object")
-        return undefined;
-    const p = parameters;
-    // Zod 4 schema — exposes a toJSONSchema() method.
-    if (typeof p.toJSONSchema === "function") {
-        const jsonSchema = p.toJSONSchema();
-        if (jsonSchema && typeof jsonSchema === "object") {
-            return jsonSchema;
-        }
-    }
-    // AI SDK v6 tools expose inputSchema instead of parameters. Zod-backed
-    // schemas usually carry a JSON Schema factory on this property.
-    if (p["~standard"] && typeof p["~standard"] === "object") {
-        const standard = p["~standard"];
-        const standardJsonSchema = standard.jsonSchema;
-        if (standardJsonSchema && typeof standardJsonSchema === "object") {
-            const input = standardJsonSchema.input;
-            if (typeof input === "function") {
-                const jsonSchema = input();
-                if (jsonSchema && typeof jsonSchema === "object") {
-                    return jsonSchema;
-                }
-            }
-            return standardJsonSchema;
-        }
-    }
-    // jsonSchema() wrapper — has a jsonSchema property
-    if (p.jsonSchema && typeof p.jsonSchema === "object") {
-        return p.jsonSchema;
-    }
-    // Plain JSON Schema object (has 'type' and 'properties')
-    if (p.type === "object" && p.properties) {
-        return p;
-    }
-    return undefined;
-}

package/dist/converters/openclaw.d.ts

@@ -1,16 +0,0 @@
-import type { Attributes } from "@opentelemetry/api";
-/**
- * Detect openclaw spans by the presence of openclaw.* attributes.
- * openclaw does not set a distinguishing instrumentation scope, so we
- * use attribute-key presence instead.
- */
-export declare function isOpenClawSpan(attrs?: Attributes): boolean;
-/**
- * Replace mapped openclaw.* attributes with gen_ai semantic conventions.
- * Unmapped openclaw.* attributes (e.g. openclaw.channel, openclaw.sessionId)
- * are preserved unchanged.
- */
-export declare function replaceOpenClawWithGenAI(
-  attrs?: Attributes,
-): Attributes;
-//# sourceMappingURL=openclaw.d.ts.map

package/dist/converters/openclaw.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openclaw.d.ts","sourceRoot":"","sources":["../../src/converters/openclaw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAiBrD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU,CAyBvE"}

package/dist/converters/openclaw.js

@@ -1,49 +0,0 @@
-/**
- * OpenClaw attribute keys that have gen_ai semantic convention equivalents.
- * Other openclaw.* attributes (channel, sessionId, lane, etc.) are preserved as-is.
- *
- * @see https://github.com/openclaw/openclaw/tree/main/extensions/diagnostics-otel
- */
-const OC = {
-  MODEL: "openclaw.model",
-  PROVIDER: "openclaw.provider",
-  TOKENS_INPUT: "openclaw.tokens.input",
-  TOKENS_OUTPUT: "openclaw.tokens.output",
-};
-const MAPPED_KEYS = new Set(Object.values(OC));
-/**
- * Detect openclaw spans by the presence of openclaw.* attributes.
- * openclaw does not set a distinguishing instrumentation scope, so we
- * use attribute-key presence instead.
- */
-export function isOpenClawSpan(attrs) {
-  if (!attrs) return false;
-  return Object.keys(attrs).some((key) => key.startsWith("openclaw."));
-}
-/**
- * Replace mapped openclaw.* attributes with gen_ai semantic conventions.
- * Unmapped openclaw.* attributes (e.g. openclaw.channel, openclaw.sessionId)
- * are preserved unchanged.
- */
-export function replaceOpenClawWithGenAI(attrs) {
-  if (!attrs) return {};
-  const result = {};
-  for (const [key, value] of Object.entries(attrs)) {
-    if (!MAPPED_KEYS.has(key)) {
-      result[key] = value;
-    }
-  }
-  if (attrs[OC.MODEL] !== undefined) {
-    result["gen_ai.request.model"] = attrs[OC.MODEL];
-  }
-  if (attrs[OC.PROVIDER] !== undefined) {
-    result["gen_ai.system"] = attrs[OC.PROVIDER];
-  }
-  if (attrs[OC.TOKENS_INPUT] !== undefined) {
-    result["gen_ai.usage.input_tokens"] = attrs[OC.TOKENS_INPUT];
-  }
-  if (attrs[OC.TOKENS_OUTPUT] !== undefined) {
-    result["gen_ai.usage.output_tokens"] = attrs[OC.TOKENS_OUTPUT];
-  }
-  return result;
-}

package/dist/langchain-handler.d.ts

@@ -1,103 +0,0 @@
-/**
- * LangChain/LangGraph Callback Handler for Introspection.
- *
- * Hooks into LangChain's native callback system to capture LLM, tool, and
- * chain interactions as gen_ai.* OTel spans for the Introspection backend.
- *
- * Similar to IntrospectionTracingProcessor for OpenAI Agents SDK and
- * IntrospectionClaudeHooks for Claude Agent SDK.
- *
- * **Important:** This module requires `@langchain/core` at runtime.
- * Import via the subpath: `@introspection-sdk/introspection-node/langchain`
- *
- * @example
- * ```ts
- * import { IntrospectionCallbackHandler } from "@introspection-sdk/introspection-node/langchain";
- * import { ChatOpenAI } from "@langchain/openai";
- *
- * const handler = new IntrospectionCallbackHandler({
- *   serviceName: "my-langchain-app",
- * });
- *
- * const model = new ChatOpenAI({ modelName: "gpt-4o" });
- * const response = await model.invoke("Hello!", { callbacks: [handler] });
- *
- * await handler.shutdown();
- * ```
- */
-import { BaseCallbackHandler } from "@langchain/core/callbacks/base";
-import type { Serialized } from "@langchain/core/load/serializable";
-import type { LLMResult } from "@langchain/core/outputs";
-import type { BaseMessage } from "@langchain/core/messages";
-import type { ChainValues } from "@langchain/core/utils/types";
-import { type SpanExporter, type IdGenerator } from "@opentelemetry/sdk-trace-base";
-/** Advanced options for testing and customization. */
-export interface LangChainHandlerAdvancedOptions {
-    /** Custom span exporter for testing. */
-    spanExporter?: SpanExporter;
-    /** Custom ID generator for testing. */
-    idGenerator?: IdGenerator;
-    /** Use SimpleSpanProcessor instead of BatchSpanProcessor. */
-    useSimpleSpanProcessor?: boolean;
-}
-/** Configuration for {@link IntrospectionCallbackHandler}. */
-export interface IntrospectionCallbackHandlerOptions {
-    /** Authentication token (env: INTROSPECTION_TOKEN). */
-    token?: string;
-    /** Base URL for the API (env: INTROSPECTION_BASE_URL). */
-    baseUrl?: string;
-    /** Service name for telemetry (env: INTROSPECTION_SERVICE_NAME). */
-    serviceName?: string;
-    /** Additional headers to include in requests. */
-    additionalHeaders?: Record<string, string>;
-    /** Advanced options for testing. */
-    advanced?: LangChainHandlerAdvancedOptions;
-}
-/**
- * LangChain callback handler that captures LLM, tool, and chain events
- * as gen_ai.* OTel spans and exports them to the Introspection backend.
- *
- * Pass as a callback to any LangChain invoke call, or set globally via
- * `setGlobalHandler()`.
- */
-export declare class IntrospectionCallbackHandler extends BaseCallbackHandler {
-    name: string;
-    private _tracerProvider;
-    private _tracer;
-    private _spans;
-    private _conversationId;
-    private _spanNames;
-    private _spanParents;
-    private _runRoots;
-    private static _wrapperNames;
-    private _llmInputs;
-    constructor(options?: IntrospectionCallbackHandlerOptions);
-    private _rootRunId;
-    /** Keep the top-level run span aligned with child conversation IDs. */
-    private _setRootConversationId;
-    private _endRootIfComplete;
-    /** Create a span under a LangChain parent when one exists.
-     *  Sets gen_ai.agent.name to the parent span's name for hierarchy. */
-    private _createChildSpan;
-    handleChatModelStart(llm: Serialized, messages: BaseMessage[][], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, _tags?: string[], metadata?: Record<string, unknown>, runName?: string): void;
-    handleLLMStart(llm: Serialized, prompts: string[], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, _tags?: string[], metadata?: Record<string, unknown>, runName?: string): void;
-    handleLLMEnd(output: LLMResult, runId: string): void;
-    handleLLMError(err: Error, runId: string): void;
-    handleChainStart(chain: Serialized, _inputs: ChainValues, runId: string, _runType?: string, _tags?: string[], metadata?: Record<string, unknown>, runName?: string, parentRunId?: string): void;
-    handleChainEnd(_outputs: ChainValues, runId: string): void;
-    handleChainError(err: Error, runId: string): void;
-    handleToolStart(tool: Serialized, input: string, runId: string, parentRunId?: string, _tags?: string[], metadata?: Record<string, unknown>, runName?: string): void;
-    handleToolEnd(output: unknown, runId: string): void;
-    handleToolError(err: Error, runId: string): void;
-    shutdown(): Promise<void>;
-    forceFlush(): Promise<void>;
-    private _extractModelName;
-    private _extractProvider;
-    /** Walk up the span tree to find the first non-wrapper span name. */
-    private _findAgentName;
-    private _getConversationId;
-    private _convertMessages;
-    private _mapRole;
-    private _extractContent;
-}
-//# sourceMappingURL=langchain-handler.d.ts.map

package/dist/langchain-handler.d.ts.map

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