@introspection-sdk/introspection-node 0.4.1 → 0.4.3

package/dist/otel/claude-wrapper.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 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, type IntrospectionClaudeHooksOptions } from "./claude-hooks.js";
+/**
+ * Configuration for {@link withIntrospection}.
+ *
+ * Alias of {@link IntrospectionClaudeHooksOptions}.
+ */
+export type WithIntrospectionOptions = IntrospectionClaudeHooksOptions;
+/**
+ * Minimal interface for the Claude Agent SDK module.
+ * Accepts `import * as sdk from "@anthropic-ai/claude-agent-sdk"`.
+ *
+ * Uses `any` for the query signature to accept any SDK version's types
+ * without requiring the SDK as a compile-time dependency.
+ */
+export interface ClaudeAgentSDKModule {
+    query: (...args: any[]) => any;
+    [key: string]: unknown;
+}
+/**
+ * The instrumented SDK returned by {@link withIntrospection}.
+ *
+ * Exposes the same surface as the original SDK module plus tracing helpers.
+ */
+export interface InstrumentedClaudeAgentSDK {
+    /** Instrumented `query()` — auto-captures prompt, hooks, and usage. */
+    query: (...args: any[]) => any;
+    /**
+     * Flush pending spans without shutting down.
+     *
+     * @returns A promise that resolves once the flush completes.
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Shut down tracing and flush all pending spans.
+     *
+     * @returns A promise that resolves once shutdown is complete.
+     */
+    shutdown(): Promise<void>;
+    /** The underlying {@link IntrospectionClaudeHooks} instance for advanced usage. */
+    readonly hooks: IntrospectionClaudeHooks;
+    /** All other SDK exports pass through unchanged. */
+    [key: string]: unknown;
+}
+/**
+ * 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 declare function withIntrospection(sdk: ClaudeAgentSDKModule, options?: WithIntrospectionOptions): InstrumentedClaudeAgentSDK;
+//# sourceMappingURL=claude-wrapper.d.ts.map

package/dist/otel/claude-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-wrapper.d.ts","sourceRoot":"","sources":["../../src/otel/claude-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,EAGrC,MAAM,mBAAmB,CAAC;AAK3B;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IAEnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,uEAAuE;IAEvE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IAC/B;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,oDAAoD;IACpD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,oBAAoB,EACzB,OAAO,CAAC,EAAE,wBAAwB,GACjC,0BAA0B,CAyC5B"}

package/dist/otel/claude-wrapper.js

@@ -0,0 +1,155 @@
+/**
+ * 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;
+        },
+    });
+}
+//# sourceMappingURL=claude-wrapper.js.map

package/dist/otel/claude-wrapper.js.map

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

package/dist/otel/gemini.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Lightweight Google Gemini (`@google/genai`) instrumentor for Introspection SDK.
+ *
+ * Captures the full Gemini response including per-part `thoughtSignature`
+ * payloads (Gemini 3.x extended thinking) as gen_ai `thinking` parts with
+ * `signature` set — mirroring how the {@link AnthropicInstrumentor} captures
+ * Anthropic thinking blocks.
+ *
+ * Supports both non-streaming (`client.models.generateContent`) and streaming
+ * (`client.models.generateContentStream`) calls.
+ *
+ * @example
+ * ```ts
+ * import { GoogleGenAI } from "@google/genai";
+ * import { GeminiInstrumentor } from "@introspection-sdk/introspection-node";
+ *
+ * const client = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
+ * new GeminiInstrumentor().instrument({ tracerProvider: provider, client });
+ * // All client.models.generateContent / generateContentStream calls are now traced
+ * ```
+ *
+ * @see https://ai.google.dev/gemini-api/docs/thought-signatures
+ */
+import type { BasicTracerProvider } from "@opentelemetry/sdk-trace-base";
+/**
+ * Auto-instrumentor that wraps a `@google/genai` client instance to add
+ * Introspection tracing with full thought-signature capture.
+ *
+ * Captures all content parts including thought summaries and signed
+ * `thoughtSignature` payloads required for multi-turn replay.
+ */
+export declare class GeminiInstrumentor {
+    private tracer;
+    private restores;
+    private conversationId;
+    instrument(opts: {
+        tracerProvider?: BasicTracerProvider;
+        /** A `@google/genai` `GoogleGenAI` client instance. */
+        client: any;
+        /**
+         * Conversation ID shared across all spans produced by this instrumentor.
+         * Defaults to a random UUID generated at `instrument()` time.
+         */
+        conversationId?: string;
+    }): void;
+    uninstrument(): void;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/otel/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/otel/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AA0QzE;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,cAAc,CAAqB;IAE3C,UAAU,CAAC,IAAI,EAAE;QACf,cAAc,CAAC,EAAE,mBAAmB,CAAC;QACrC,uDAAuD;QAEvD,MAAM,EAAE,GAAG,CAAC;QACZ;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI;IA6ER,YAAY,IAAI,IAAI;CAKrB"}

package/dist/otel/gemini.js

@@ -0,0 +1,297 @@
+/**
+ * Lightweight Google Gemini (`@google/genai`) instrumentor for Introspection SDK.
+ *
+ * Captures the full Gemini response including per-part `thoughtSignature`
+ * payloads (Gemini 3.x extended thinking) as gen_ai `thinking` parts with
+ * `signature` set — mirroring how the {@link AnthropicInstrumentor} captures
+ * Anthropic thinking blocks.
+ *
+ * Supports both non-streaming (`client.models.generateContent`) and streaming
+ * (`client.models.generateContentStream`) calls.
+ *
+ * @example
+ * ```ts
+ * import { GoogleGenAI } from "@google/genai";
+ * import { GeminiInstrumentor } from "@introspection-sdk/introspection-node";
+ *
+ * const client = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
+ * new GeminiInstrumentor().instrument({ tracerProvider: provider, client });
+ * // All client.models.generateContent / generateContentStream calls are now traced
+ * ```
+ *
+ * @see https://ai.google.dev/gemini-api/docs/thought-signatures
+ */
+import { trace, SpanKind, SpanStatusCode } from "@opentelemetry/api";
+import { convertGeminiContentsToInputMessages, convertGeminiCandidatesToOutputMessages, convertGeminiSystemInstructionToSemconv, convertGeminiToolsToToolDefinitions, GEMINI_PROVIDER_NAME, } from "../converters/gemini.js";
+// ---------------------------------------------------------------------------
+// Span helpers
+// ---------------------------------------------------------------------------
+function serializeMessages(msgs) {
+    return JSON.stringify(msgs.map((m) => {
+        const obj = { role: m.role, parts: m.parts };
+        if ("finish_reason" in m && m.finish_reason) {
+            obj.finish_reason = m.finish_reason;
+        }
+        return obj;
+    }));
+}
+function startSpan(tracer, model, conversationId) {
+    return tracer.startSpan("chat", {
+        kind: SpanKind.CLIENT,
+        attributes: {
+            "gen_ai.system": GEMINI_PROVIDER_NAME,
+            "gen_ai.provider.name": GEMINI_PROVIDER_NAME,
+            "gen_ai.operation.name": "chat",
+            "gen_ai.request.model": model,
+            "openinference.span.kind": "LLM",
+            ...(conversationId
+                ? { "gen_ai.conversation.id": conversationId }
+                : undefined),
+        },
+    });
+}
+function setRequestAttrs(span, kwargs) {
+    const contents = kwargs.contents;
+    const inputMsgs = convertGeminiContentsToInputMessages(contents);
+    if (inputMsgs.length > 0) {
+        span.setAttribute("gen_ai.input.messages", serializeMessages(inputMsgs));
+    }
+    const config = kwargs.config || {};
+    const systemInstruction = config.systemInstruction;
+    const systemInstructions = convertGeminiSystemInstructionToSemconv(systemInstruction);
+    if (systemInstructions && systemInstructions.length > 0) {
+        span.setAttribute("gen_ai.system_instructions", JSON.stringify(systemInstructions));
+    }
+    const tools = config.tools;
+    const toolDefs = convertGeminiToolsToToolDefinitions(tools);
+    if (toolDefs && toolDefs.length > 0) {
+        span.setAttribute("gen_ai.tool.definitions", JSON.stringify(toolDefs));
+    }
+}
+function setUsageAttrs(span, usage) {
+    if (!usage)
+        return;
+    const promptTokens = usage.promptTokenCount;
+    const candidateTokens = usage.candidatesTokenCount;
+    const cachedTokens = usage.cachedContentTokenCount;
+    const thoughtTokens = usage.thoughtsTokenCount;
+    if (typeof promptTokens === "number") {
+        span.setAttribute("gen_ai.usage.input_tokens", promptTokens);
+    }
+    if (typeof candidateTokens === "number") {
+        // Gemini reports candidatesTokenCount separately from thoughtsTokenCount;
+        // sum them so output_tokens reflects everything billed as model output.
+        const total = candidateTokens + (thoughtTokens ?? 0);
+        span.setAttribute("gen_ai.usage.output_tokens", total);
+    }
+    else if (typeof thoughtTokens === "number") {
+        span.setAttribute("gen_ai.usage.output_tokens", thoughtTokens);
+    }
+    if (typeof cachedTokens === "number") {
+        span.setAttribute("gen_ai.usage.cache_read.input_tokens", cachedTokens);
+    }
+}
+function setResponseAttrs(span, response) {
+    const candidates = response.candidates;
+    const outputMsgs = convertGeminiCandidatesToOutputMessages(candidates);
+    if (outputMsgs.length > 0) {
+        span.setAttribute("gen_ai.output.messages", serializeMessages(outputMsgs));
+        const finishReasons = outputMsgs
+            .map((m) => m.finish_reason)
+            .filter((r) => typeof r === "string");
+        if (finishReasons.length > 0) {
+            span.setAttribute("gen_ai.response.finish_reasons", finishReasons);
+        }
+    }
+    const responseId = response.responseId;
+    if (responseId)
+        span.setAttribute("gen_ai.response.id", responseId);
+    const modelVersion = response.modelVersion;
+    if (modelVersion)
+        span.setAttribute("gen_ai.response.model", modelVersion);
+    setUsageAttrs(span, response.usageMetadata);
+    span.setStatus({ code: SpanStatusCode.OK });
+}
+/** True if a streamed part is just incremental text with no metadata to preserve. */
+function isPlainTextPart(part) {
+    return (typeof part.text === "string" &&
+        part.thought !== true &&
+        !part.thoughtSignature &&
+        !part.functionCall &&
+        !part.functionResponse);
+}
+/**
+ * Async-iterable wrapper that aggregates streamed `GenerateContentResponse`
+ * chunks so the underlying span captures the complete final message — including
+ * the final per-part `thoughtSignature` values that only arrive on the last
+ * chunk of a streamed turn.
+ */
+class TracedStream {
+    inner;
+    span;
+    aggregated = new Map();
+    usage;
+    responseId;
+    modelVersion;
+    finalized = false;
+    constructor(inner, span) {
+        this.inner = inner;
+        this.span = span;
+    }
+    async *[Symbol.asyncIterator]() {
+        try {
+            for await (const chunk of this.inner) {
+                this.processChunk(chunk);
+                yield chunk;
+            }
+        }
+        catch (err) {
+            this.span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: String(err),
+            });
+            this.span.end();
+            this.finalized = true;
+            throw err;
+        }
+        finally {
+            this.finalize();
+        }
+    }
+    processChunk(chunk) {
+        if (chunk.responseId)
+            this.responseId = chunk.responseId;
+        if (chunk.modelVersion)
+            this.modelVersion = chunk.modelVersion;
+        if (chunk.usageMetadata)
+            this.usage = chunk.usageMetadata;
+        for (const cand of chunk.candidates ?? []) {
+            const idx = cand.index ?? 0;
+            const existing = this.aggregated.get(idx);
+            if (!existing) {
+                this.aggregated.set(idx, {
+                    index: idx,
+                    finishReason: cand.finishReason,
+                    content: {
+                        role: cand.content?.role,
+                        parts: [...(cand.content?.parts ?? [])],
+                    },
+                });
+                continue;
+            }
+            if (cand.finishReason)
+                existing.finishReason = cand.finishReason;
+            if (cand.content?.role && !existing.content?.role) {
+                existing.content.role = cand.content.role;
+            }
+            this.mergeParts(existing.content.parts, cand.content?.parts ?? []);
+        }
+    }
+    /**
+     * Merge streamed parts into the aggregated parts list.
+     *
+     * Gemini streams text incrementally as separate `text`-only parts; thought
+     * signatures and function calls arrive as their own parts. Consecutive
+     * plain-text parts are coalesced into a single accumulating text part so the
+     * final thought signature on a block survives on its trailing part.
+     */
+    mergeParts(target, incoming) {
+        for (const part of incoming) {
+            const last = target[target.length - 1];
+            if (isPlainTextPart(part) && last && isPlainTextPart(last)) {
+                last.text = (last.text || "") + (part.text || "");
+                continue;
+            }
+            target.push({ ...part });
+        }
+    }
+    finalize() {
+        if (this.finalized)
+            return;
+        this.finalized = true;
+        setResponseAttrs(this.span, {
+            candidates: Array.from(this.aggregated.values()),
+            usageMetadata: this.usage,
+            responseId: this.responseId,
+            modelVersion: this.modelVersion,
+        });
+        this.span.end();
+    }
+}
+/**
+ * Auto-instrumentor that wraps a `@google/genai` client instance to add
+ * Introspection tracing with full thought-signature capture.
+ *
+ * Captures all content parts including thought summaries and signed
+ * `thoughtSignature` payloads required for multi-turn replay.
+ */
+export class GeminiInstrumentor {
+    tracer = null;
+    restores = [];
+    conversationId;
+    instrument(opts) {
+        const { client } = opts;
+        if (!client?.models?.generateContent) {
+            throw new Error("Invalid client — pass a GoogleGenAI client instance (new GoogleGenAI({...}))");
+        }
+        this.conversationId = opts.conversationId ?? crypto.randomUUID();
+        const provider = opts.tracerProvider ?? trace.getTracerProvider();
+        this.tracer = provider.getTracer("introspection-gemini");
+        const tracer = this.tracer;
+        const conversationId = this.conversationId;
+        const api = client.models;
+        const origGenerate = api.generateContent.bind(api);
+        const origGenerateStream = api.generateContentStream?.bind(api);
+        this.restores.push(() => {
+            api.generateContent = origGenerate;
+            if (origGenerateStream)
+                api.generateContentStream = origGenerateStream;
+        });
+        api.generateContent = async (...args) => {
+            const kwargs = args[0] || {};
+            const span = startSpan(tracer, kwargs.model || "unknown", conversationId);
+            setRequestAttrs(span, kwargs);
+            try {
+                const response = (await origGenerate(...args));
+                setResponseAttrs(span, response);
+                return response;
+            }
+            catch (err) {
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: String(err),
+                });
+                throw err;
+            }
+            finally {
+                span.end();
+            }
+        };
+        if (origGenerateStream) {
+            api.generateContentStream = async (...args) => {
+                const kwargs = args[0] || {};
+                const span = startSpan(tracer, kwargs.model || "unknown", conversationId);
+                setRequestAttrs(span, kwargs);
+                try {
+                    const stream = (await origGenerateStream(...args));
+                    return new TracedStream(stream, span);
+                }
+                catch (err) {
+                    span.setStatus({
+                        code: SpanStatusCode.ERROR,
+                        message: String(err),
+                    });
+                    span.end();
+                    throw err;
+                }
+            };
+        }
+    }
+    uninstrument() {
+        for (const restore of this.restores)
+            restore();
+        this.restores = [];
+        this.tracer = null;
+    }
+}
+//# sourceMappingURL=gemini.js.map

package/dist/otel/gemini.js.map

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

package/dist/otel/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * OpenTelemetry surface for the Introspection Node SDK.
+ *
+ * Subpath entry point: `@introspection-sdk/introspection-node/otel`.
+ *
+ * Importing from here pulls in OTel SDK packages (peer deps). The
+ * REST-only `IntrospectionClient` is available from the package root
+ * and does not require these to be installed.
+ */
+export { IntrospectionLogs } from "./logs.js";
+export type { IntrospectionLogsOptions } from "./logs.js";
+export { setupTracing } from "./setup.js";
+export type { SetupTracingOptions, ConflictBehavior } from "./setup.js";
+export { IntrospectionSpanProcessor } from "./span-processor.js";
+export type { IntrospectionSpanProcessorOptions } from "./span-processor.js";
+export { IntrospectionTracingProcessor } from "./tracing-processor.js";
+export type { IntrospectionTracingProcessorOptions, TracingProcessorAdvancedOptions, } from "./tracing-processor.js";
+export { IntrospectionClaudeHooks } from "./claude-hooks.js";
+export type { IntrospectionClaudeHooksOptions, ClaudeHooksAdvancedOptions, ClaudeHooksConfig, ClaudeHookCallbackMatcher, ClaudeHookEvent, ClaudeHookInput, ClaudeHookOutput, ClaudeHookCallback, ClaudeUsage, ClaudeModelUsage, ClaudeResultMessage, ClaudeAssistantMessage, ClaudeSDKMessage, } from "./claude-hooks.js";
+export { withIntrospection } from "./claude-wrapper.js";
+export type { WithIntrospectionOptions, InstrumentedClaudeAgentSDK, ClaudeAgentSDKModule, } from "./claude-wrapper.js";
+export { AnthropicInstrumentor, tracedMessagesCreate, REDACTED_THINKING_CONTENT, } from "./anthropic.js";
+export { IntrospectionPiInstrumentor } from "./pi.js";
+export type { IntrospectionPiInstrumentorOptions, AgentMeta as PiAgentMeta, } from "./pi.js";
+export { GeminiInstrumentor } from "./gemini.js";
+export { addOpenInferenceAttributes, OpenInferenceSpanExporter, } from "../converters/openinference.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/otel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/otel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAI1D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EACV,oCAAoC,EACpC,+BAA+B,GAChC,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,YAAY,EACV,+BAA+B,EAC/B,0BAA0B,EAC1B,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AACtD,YAAY,EACV,kCAAkC,EAClC,SAAS,IAAI,WAAW,GACzB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIjD,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC"}