@introspection-sdk/introspection-node 0.4.2 → 0.4.4

package/dist/otel/gemini.js

@@ -0,0 +1,348 @@
+/**
+ * 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.
+ */
+/**
+ * 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

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,32 @@
+/**
+ * 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";
+export { init, shutdown, track, feedback, identify, conversation, withAgent, withConversation, withUserId, withAnonymousId, newConversationId, getClient, getTracerProvider, getLangchainHandler, getMastraExporter, instrumentPi, instrumentClaudeAgent, _resetForTests, } from "./init.js";
+export type { InitOptions } from "./init.js";
+export { registerOTelGlobals } from "./setup.js";
+export { DidNotEnable, discoverIntegrations, setupIntegrations, resetInstalledForTests, } from "./integrations/index.js";
+export type { Integration, IntegrationSetupContext, IntegrationHandles, } from "./integrations/index.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;AAKxC,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,WAAW,EACX,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC"}

package/dist/otel/index.js

@@ -0,0 +1,41 @@
+/**
+ * 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.
+ */
+// IntrospectionLogs — OTel logs exporter with track/feedback/identify
+// and baggage context helpers (extracted from the old IntrospectionClient).
+export { IntrospectionLogs } from "./logs.js";
+// One-call tracing bootstrap (NodeTracerProvider + AsyncLocalStorage +
+// W3C baggage propagator + IntrospectionSpanProcessor).
+export { setupTracing } from "./setup.js";
+// Span processor — attach to your own TracerProvider.
+export { IntrospectionSpanProcessor } from "./span-processor.js";
+// OpenAI Agents SDK tracing processor.
+export { IntrospectionTracingProcessor } from "./tracing-processor.js";
+// Claude Agent SDK hooks.
+export { IntrospectionClaudeHooks } from "./claude-hooks.js";
+// Claude Agent SDK wrapper.
+export { withIntrospection } from "./claude-wrapper.js";
+// Anthropic SDK instrumentor.
+export { AnthropicInstrumentor, tracedMessagesCreate, REDACTED_THINKING_CONTENT, } from "./anthropic.js";
+// Pi Agent SDK instrumentor.
+export { IntrospectionPiInstrumentor } from "./pi.js";
+// Gemini SDK instrumentor.
+export { GeminiInstrumentor } from "./gemini.js";
+// OpenInference span exporter (drops Arize/OpenInference attrs onto a
+// downstream OTel SpanExporter).
+export { addOpenInferenceAttributes, OpenInferenceSpanExporter, } from "../converters/openinference.js";
+// One-liner bootstrap (`introspection.init()`) + analytics proxies and the
+// per-framework handle accessors it binds. Auto-detects installed frameworks
+// and wires them into one shared provider.
+export { init, shutdown, track, feedback, identify, conversation, withAgent, withConversation, withUserId, withAnonymousId, newConversationId, getClient, getTracerProvider, getLangchainHandler, getMastraExporter, instrumentPi, instrumentClaudeAgent, _resetForTests, } from "./init.js";
+// Low-level OTel registration helper (also used by `init`).
+export { registerOTelGlobals } from "./setup.js";
+// Integration registry — for custom integrations passed to `init`.
+export { DidNotEnable, discoverIntegrations, setupIntegrations, resetInstalledForTests, } from "./integrations/index.js";
+//# sourceMappingURL=index.js.map

package/dist/otel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/otel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sEAAsE;AACtE,4EAA4E;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C,uEAAuE;AACvE,wDAAwD;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,sDAAsD;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAGjE,uCAAuC;AACvC,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAMvE,0BAA0B;AAC1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAiB7D,4BAA4B;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAOxD,8BAA8B;AAC9B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,6BAA6B;AAC7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAMtD,2BAA2B;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,sEAAsE;AACtE,iCAAiC;AACjC,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AAExC,2EAA2E;AAC3E,6EAA6E;AAC7E,2CAA2C;AAC3C,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACf,MAAM,WAAW,CAAC;AAGnB,4DAA4D;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,mEAAmE;AACnE,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC"}

package/dist/otel/init.d.ts

@@ -0,0 +1,126 @@
+/**
+ * One-liner bootstrap for the Introspection OTel surface.
+ *
+ * `init()` detects the installed LLM frameworks and wires them into one shared
+ * pipeline, mirroring the Python SDK's `introspection.init()`:
+ *
+ * ```ts
+ * import * as introspection from "@introspection-sdk/introspection-node/otel";
+ * import Anthropic from "@anthropic-ai/sdk";
+ *
+ * await introspection.init({ serviceName: "my-app" });
+ *
+ * const client = new Anthropic(); // auto-traced — no per-client wiring
+ * await introspection.conversation(() =>
+ *   client.messages.create({ ... }),
+ * );
+ * ```
+ *
+ * It also exposes the `track` / `feedback` / `identify` analytics surface and a
+ * `conversation()` scope, proxied to a global {@link IntrospectionLogs}.
+ */
+import { type TracerProvider } from "@opentelemetry/api";
+import type { SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import type { AdvancedOptions, FeedbackOptions, UserTraits } from "../types.js";
+import type { InstrumentedClaudeAgentSDK } from "./claude-wrapper.js";
+import { type Integration } from "./integrations/index.js";
+import type { Agent } from "@mariozechner/pi-agent-core";
+import type { AgentMeta } from "./pi.js";
+import { IntrospectionLogs } from "./logs.js";
+import { type ConflictBehavior } from "./setup.js";
+/** Options for {@link init}. */
+export interface InitOptions {
+    /** Auth token. Falls back to `INTROSPECTION_TOKEN`. */
+    token?: string;
+    /** Service name for spans. Falls back to `INTROSPECTION_SERVICE_NAME`. */
+    serviceName?: string;
+    /** OTLP base URL. Falls back to `INTROSPECTION_BASE_OTEL_URL`. */
+    baseUrl?: string;
+    /**
+     * Use this provider instead of creating one. The caller owns its span
+     * processors (attach an {@link IntrospectionSpanProcessor} yourself).
+     */
+    tracerProvider?: TracerProvider;
+    /**
+     * Extra span processors composed onto the provider `init()` creates — the
+     * one-call dual-export path. Each runs alongside the Introspection processor,
+     * e.g. `init({ spanProcessors: [new BatchSpanProcessor(langfuseExporter)] })`.
+     * Ignored when `tracerProvider` is supplied.
+     */
+    spanProcessors?: SpanProcessor[];
+    /** Extra integrations to install beyond auto-discovery. */
+    integrations?: Integration[];
+    /** Install every importable built-in integration (default `true`). */
+    autoDiscover?: boolean;
+    /** Behaviour when an OTel context manager / propagator is already registered. */
+    onConflict?: ConflictBehavior;
+    /** Advanced configuration (custom exporter, headers, …). */
+    advanced?: AdvancedOptions;
+}
+/** Generate a fresh conversation id (matches the Python SDK's format). */
+export declare function newConversationId(): string;
+/**
+ * Detect installed LLM frameworks and wire them into one shared provider.
+ *
+ * Idempotent: repeated calls return the already-configured provider without
+ * re-installing integrations.
+ */
+export declare function init(options?: InitOptions): Promise<TracerProvider>;
+/** Return the global logs client. Throws if {@link init} has not been called. */
+export declare function getClient(): IntrospectionLogs;
+/** Return the shared provider. Throws if {@link init} has not been called. */
+export declare function getTracerProvider(): TracerProvider;
+/** Track an analytics event. Requires {@link init} first. */
+export declare function track(eventName: string, properties?: Record<string, unknown>, options?: {
+    eventId?: string;
+}): void;
+/** Record feedback on an AI response. Requires {@link init} first. */
+export declare function feedback(name: string, options?: FeedbackOptions): void;
+/** Associate the current context with a user. Requires {@link init} first. */
+export declare function identify(userId: string, traits?: UserTraits, anonymousId?: string, eventId?: string): void;
+/**
+ * Run `callback` inside a conversation scope: every span/event produced within
+ * is stamped with `gen_ai.conversation.id`. Generates an id when none is given.
+ *
+ * ```ts
+ * await introspection.conversation((id) => client.messages.create({ ... }));
+ * await introspection.conversation("conv_123", (id) => run());
+ * ```
+ */
+export declare function conversation<T>(callback: (conversationId: string) => T | Promise<T>): Promise<T>;
+export declare function conversation<T>(conversationId: string, callback: (conversationId: string) => T | Promise<T>): Promise<T>;
+/**
+ * Run `callback` with `gen_ai.agent.name` (+ optional `gen_ai.agent.id`) on the
+ * baggage, so spans/events produced within are attributed to that agent.
+ * Requires {@link init} first. Mirrors `IntrospectionLogs.withAgent`.
+ */
+export declare function withAgent<T>(agentName: string, agentId: string | undefined, callback: () => T | Promise<T>): Promise<T>;
+/**
+ * Run `callback` inside a conversation scope, optionally chaining a previous
+ * response id. Unlike {@link conversation}, the id is required (no auto-gen).
+ * Requires {@link init} first.
+ */
+export declare function withConversation<T>(conversationId: string | undefined, previousResponseId: string | undefined, callback: () => T | Promise<T>): Promise<T>;
+/** Run `callback` with `identity.user_id` on the baggage. Requires {@link init} first. */
+export declare function withUserId<T>(userId: string, callback: () => T | Promise<T>): Promise<T>;
+/** Run `callback` with `identity.anonymous_id` on the baggage. Requires {@link init} first. */
+export declare function withAnonymousId<T>(anonymousId: string, callback: () => T | Promise<T>): Promise<T>;
+/**
+ * The LangChain handler bound by `init()`. Attach it per-invoke:
+ * `chain.invoke(input, { callbacks: [introspection.getLangchainHandler()] })`.
+ */
+export declare function getLangchainHandler(): import("./langchain-handler.js").IntrospectionCallbackHandler;
+/** The Mastra exporter bound by `init()`. Put it in `observability.configs`. */
+export declare function getMastraExporter(): any;
+/** Instrument a Pi `Agent` against the shared provider. Requires {@link init}. */
+export declare function instrumentPi(agent: Agent, meta: AgentMeta): void;
+/**
+ * Wrap the Claude Agent SDK module so its `query()` calls are traced.
+ * Equivalent to `withIntrospection(sdk)` but pre-bound to the `init()` config.
+ */
+export declare function instrumentClaudeAgent(sdk: any): InstrumentedClaudeAgentSDK;
+/** Flush and shut down the logs client and (if owned) the provider. */
+export declare function shutdown(): Promise<void>;
+/** Reset module state. Test-only utility. */
+export declare function _resetForTests(): void;
+//# sourceMappingURL=init.d.ts.map

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

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