@introspection-sdk/introspection-node 0.19.1 → 0.21.0

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

@@ -1,93 +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, 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

@@ -1 +0,0 @@
-{"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,CAwC5B"}

package/dist/otel/claude-wrapper.js

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,56 +0,0 @@
-/**
- * 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 `reasoning` 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 { TracerProvider } from "@opentelemetry/api";
-export declare class GeminiInstrumentor {
-    private tracer;
-    private restores;
-    private conversationId;
-    instrument(opts: {
-        tracerProvider?: TracerProvider;
-        /** 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;
-    /**
-     * Patch `Models.prototype.generateContentInternal` / `…StreamInternal` so
-     * **every** `GoogleGenAI` client is traced — the one-liner path used by
-     * `introspection.init()`. The public `generateContent` /
-     * `generateContentStream` are per-instance bound class fields that delegate
-     * to these prototype methods, so patching the prototype covers all clients.
-     * Idempotent: a second call is a no-op.
-     *
-     * @param opts.genai The `@google/genai` module (must expose `Models`).
-     */
-    instrumentClass(opts: {
-        genai: any;
-        tracerProvider?: TracerProvider;
-        conversationId?: string;
-    }): void;
-    uninstrument(): void;
-}
-//# sourceMappingURL=gemini.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/otel/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAuVvE,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,cAAc,CAAC;QAChC,uDAAuD;QAEvD,MAAM,EAAE,GAAG,CAAC;QACZ;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI;IAsCR;;;;;;;;;OASG;IACH,eAAe,CAAC,IAAI,EAAE;QAEpB,KAAK,EAAE,GAAG,CAAC;QACX,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI;IAyCR,YAAY,IAAI,IAAI;CAKrB"}

package/dist/otel/gemini.js

@@ -1,350 +0,0 @@
-/**
- * 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 `reasoning` 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 { providerCostAttributes } from "@introspection-sdk/types";
-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.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);
-    }
-    // Provider-reported cost (e.g. OpenRouter usage.cost) when present.
-    span.setAttributes(providerCostAttributes(usage));
-}
-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.
- */
-/**
- * Build the traced replacement for a non-streaming `generateContent`-style
- * method. Shared by {@link GeminiInstrumentor.instrument} (patches a client's
- * public `models.generateContent`) and {@link GeminiInstrumentor.instrumentClass}
- * (patches `Models.prototype.generateContentInternal` so every client is
- * auto-traced). Preserves the call-site `this`.
- */
-function buildTracedGenerate(origGenerate, tracer, conversationId) {
-    return async function tracedGenerate(...args) {
-        const kwargs = args[0] || {};
-        const span = startSpan(tracer, kwargs.model || "unknown", conversationId);
-        setRequestAttrs(span, kwargs);
-        try {
-            const response = (await origGenerate.apply(this, args));
-            setResponseAttrs(span, response);
-            return response;
-        }
-        catch (err) {
-            span.setStatus({ code: SpanStatusCode.ERROR, message: String(err) });
-            throw err;
-        }
-        finally {
-            span.end();
-        }
-    };
-}
-/** Build the traced replacement for a streaming `generateContentStream`-style method. */
-function buildTracedGenerateStream(origStream, tracer, conversationId) {
-    return async function tracedGenerateStream(...args) {
-        const kwargs = args[0] || {};
-        const span = startSpan(tracer, kwargs.model || "unknown", conversationId);
-        setRequestAttrs(span, kwargs);
-        try {
-            const stream = (await origStream.apply(this, args));
-            return new TracedStream(stream, span);
-        }
-        catch (err) {
-            span.setStatus({ code: SpanStatusCode.ERROR, message: String(err) });
-            span.end();
-            throw err;
-        }
-    };
-}
-/**
- * Marker placed on a patched `Models.prototype` method so repeated
- * `instrumentClass()` calls (e.g. a second `introspection.init()`) are no-ops.
- */
-const PATCHED = Symbol.for("introspection.gemini.patched");
-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 = buildTracedGenerate(origGenerate, tracer, conversationId);
-        if (origGenerateStream) {
-            api.generateContentStream = buildTracedGenerateStream(origGenerateStream, tracer, conversationId);
-        }
-    }
-    /**
-     * Patch `Models.prototype.generateContentInternal` / `…StreamInternal` so
-     * **every** `GoogleGenAI` client is traced — the one-liner path used by
-     * `introspection.init()`. The public `generateContent` /
-     * `generateContentStream` are per-instance bound class fields that delegate
-     * to these prototype methods, so patching the prototype covers all clients.
-     * Idempotent: a second call is a no-op.
-     *
-     * @param opts.genai The `@google/genai` module (must expose `Models`).
-     */
-    instrumentClass(opts) {
-        const proto = opts.genai?.Models?.prototype;
-        if (typeof proto?.generateContentInternal !== "function") {
-            throw new Error("Invalid @google/genai module — expected `Models.prototype.generateContentInternal`");
-        }
-        if (proto.generateContentInternal[PATCHED])
-            return;
-        this.conversationId = opts.conversationId ?? crypto.randomUUID();
-        const provider = opts.tracerProvider ?? trace.getTracerProvider();
-        this.tracer = provider.getTracer("introspection-gemini");
-        const conversationId = this.conversationId;
-        const origGenerate = proto.generateContentInternal;
-        const patchedGenerate = buildTracedGenerate(origGenerate, this.tracer, conversationId);
-        patchedGenerate[PATCHED] = true;
-        proto.generateContentInternal = patchedGenerate;
-        this.restores.push(() => {
-            proto.generateContentInternal = origGenerate;
-        });
-        if (typeof proto.generateContentStreamInternal === "function") {
-            const origStream = proto.generateContentStreamInternal;
-            const patchedStream = buildTracedGenerateStream(origStream, this.tracer, conversationId);
-            patchedStream[PATCHED] = true;
-            proto.generateContentStreamInternal = patchedStream;
-            this.restores.push(() => {
-                proto.generateContentStreamInternal = origStream;
-            });
-        }
-    }
-    uninstrument() {
-        for (const restore of this.restores)
-            restore();
-        this.restores = [];
-        this.tracer = null;
-    }
-}
-//# sourceMappingURL=gemini.js.map