@introspection-sdk/introspection-node 0.4.1 → 0.4.3

package/dist/otel/langchain-handler.js

@@ -0,0 +1,555 @@
+/**
+ * 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 { context as otelContext, propagation, ROOT_CONTEXT, SpanStatusCode, trace as otelTrace, } from "@opentelemetry/api";
+import { BasicTracerProvider, BatchSpanProcessor, SimpleSpanProcessor, } from "@opentelemetry/sdk-trace-base";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
+import { randomUUID } from "crypto";
+import { logger, withOtlpHttpsProxy } from "../utils.js";
+import { VERSION } from "../version.js";
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+/**
+ * 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 class IntrospectionCallbackHandler extends BaseCallbackHandler {
+    name = "IntrospectionCallbackHandler";
+    _tracerProvider;
+    _tracer;
+    _spans = new Map();
+    _conversationId;
+    // Track span names and parents so children can resolve gen_ai.agent.name
+    _spanNames = new Map();
+    _spanParents = new Map();
+    _runRoots = new Map();
+    // LangChain wrapper names to skip when resolving agent names
+    static _wrapperNames = new Set([
+        "RunnableSequence",
+        "RunnableParallel",
+        "RunnableMap",
+        "RunnableLambda",
+        "RunnableRetry",
+        "_ConfigurableModel",
+        "ChatOpenAI",
+        "ChatAnthropic",
+        "ChatGoogleGenerativeAI",
+        "ChatGroq",
+    ]);
+    // Store LLM input messages per runId for use in handleLLMEnd
+    _llmInputs = new Map();
+    constructor(options = {}) {
+        super();
+        const advanced = options.advanced;
+        const serviceName = options.serviceName || process.env.INTROSPECTION_SERVICE_NAME;
+        const resource = serviceName
+            ? resourceFromAttributes({ [ATTR_SERVICE_NAME]: serviceName })
+            : undefined;
+        if (!advanced?.spanExporter) {
+            const token = options.token || process.env.INTROSPECTION_TOKEN;
+            if (!token) {
+                throw new Error("INTROSPECTION_TOKEN is required");
+            }
+            const baseUrl = options.baseUrl ||
+                process.env.INTROSPECTION_BASE_OTEL_URL ||
+                "https://otel.introspection.dev";
+            const endpoint = baseUrl.endsWith("/v1/traces")
+                ? baseUrl
+                : `${baseUrl.replace(/\/$/, "")}/v1/traces`;
+            const headers = {
+                "User-Agent": `introspection-sdk/${VERSION}`,
+                Authorization: `Bearer ${token}`,
+                ...options.additionalHeaders,
+            };
+            logger.info(`IntrospectionCallbackHandler initialized: endpoint=${endpoint}`);
+            const spanExporter = new OTLPTraceExporter(withOtlpHttpsProxy({ url: endpoint, headers }));
+            const effectiveBatchSize = token.startsWith("intro_dev") || token.startsWith("intro_staging")
+                ? 1
+                : undefined;
+            const useSimple = advanced?.useSimpleSpanProcessor || effectiveBatchSize === 1;
+            const spanProcessor = useSimple
+                ? new SimpleSpanProcessor(spanExporter)
+                : new BatchSpanProcessor(spanExporter, {
+                    scheduledDelayMillis: 1000,
+                    ...(effectiveBatchSize
+                        ? { maxExportBatchSize: effectiveBatchSize }
+                        : {}),
+                });
+            this._tracerProvider = new BasicTracerProvider({
+                resource,
+                idGenerator: advanced?.idGenerator,
+                spanProcessors: [spanProcessor],
+            });
+        }
+        else {
+            logger.info("IntrospectionCallbackHandler initialized in test mode with custom exporter");
+            const spanProcessor = advanced.useSimpleSpanProcessor
+                ? new SimpleSpanProcessor(advanced.spanExporter)
+                : new BatchSpanProcessor(advanced.spanExporter, {
+                    scheduledDelayMillis: 100,
+                });
+            this._tracerProvider = new BasicTracerProvider({
+                resource,
+                idGenerator: advanced.idGenerator,
+                spanProcessors: [spanProcessor],
+            });
+        }
+        this._tracer = this._tracerProvider.getTracer("langchain", VERSION);
+        this._conversationId = `intro_conv_${randomUUID().replace(/-/g, "")}`;
+    }
+    _rootRunId(runId, parentRunId) {
+        if (!parentRunId)
+            return runId;
+        return this._runRoots.get(parentRunId) || parentRunId;
+    }
+    /** Keep the top-level run span aligned with child conversation IDs. */
+    _setRootConversationId(conversationId, runId, parentRunId) {
+        const root = this._spans.get(this._rootRunId(runId, parentRunId));
+        root?.setAttribute("gen_ai.conversation.id", conversationId);
+    }
+    _endRootIfComplete(runId) {
+        this._runRoots.delete(runId);
+        this._spanNames.delete(runId);
+        this._spanParents.delete(runId);
+    }
+    /** Create a span under a LangChain parent when one exists.
+     *  Sets gen_ai.agent.name to the parent span's name for hierarchy. */
+    _createChildSpan(name, runId, parentRunId) {
+        const parent = parentRunId ? this._spans.get(parentRunId) : undefined;
+        this._runRoots.set(runId, this._rootRunId(runId, parentRunId));
+        const ctx = parent
+            ? otelTrace.setSpan(otelContext.active(), parent)
+            : ROOT_CONTEXT;
+        const span = this._tracer.startSpan(name, {}, ctx);
+        this._spanNames.set(runId, name);
+        if (parentRunId) {
+            this._spanParents.set(runId, parentRunId);
+        }
+        // Baggage wins so per-call agent identity (e.g. via withAgent())
+        // overrides the parent-span-name walk used as a default.
+        const baggageAgentName = this._readBaggage("gen_ai.agent.name");
+        const agentName = baggageAgentName || this._findAgentName(parentRunId);
+        if (agentName) {
+            span.setAttribute("gen_ai.agent.name", agentName);
+        }
+        const baggageAgentId = this._readBaggage("gen_ai.agent.id");
+        if (baggageAgentId) {
+            span.setAttribute("gen_ai.agent.id", baggageAgentId);
+        }
+        return span;
+    }
+    // -------------------------------------------------------------------------
+    // Chat model callbacks (preferred over LLM callbacks for chat models)
+    // -------------------------------------------------------------------------
+    handleChatModelStart(llm, messages, runId, parentRunId, extraParams, _tags, metadata, runName) {
+        const modelName = this._extractModelName(llm, extraParams);
+        const spanName = modelName ? `chat ${modelName}` : runName || "chat";
+        const otelSpan = this._createChildSpan(spanName, runId, parentRunId);
+        this._spans.set(runId, otelSpan);
+        const conversationId = this._getConversationId(metadata);
+        this._setRootConversationId(conversationId, runId, parentRunId);
+        otelSpan.setAttribute("gen_ai.operation.name", "chat");
+        otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
+        otelSpan.setAttribute("openinference.span.kind", "LLM");
+        if (modelName) {
+            otelSpan.setAttribute("gen_ai.request.model", modelName);
+        }
+        const flatMessages = messages[0] || [];
+        const { inputMessages, systemInstructions } = this._convertMessages(flatMessages);
+        if (inputMessages.length > 0) {
+            otelSpan.setAttribute("gen_ai.input.messages", JSON.stringify(inputMessages));
+            this._llmInputs.set(runId, inputMessages);
+        }
+        if (systemInstructions.length > 0) {
+            otelSpan.setAttribute("gen_ai.system_instructions", JSON.stringify(systemInstructions.map((s) => ({ type: "text", content: s }))));
+        }
+        const provider = this._extractProvider(llm);
+        if (provider) {
+            otelSpan.setAttribute("gen_ai.system", provider);
+        }
+        const invocationParams = extraParams?.["invocation_params"];
+        const tools = invocationParams?.["tools"];
+        if (tools && tools.length > 0) {
+            otelSpan.setAttribute("gen_ai.tool.definitions", JSON.stringify(tools.map((t) => {
+                const fn = (t.function || t);
+                return {
+                    type: t.type || "function",
+                    name: (fn.name || ""),
+                    description: (fn.description || ""),
+                    parameters: fn.parameters,
+                };
+            })));
+        }
+        if (invocationParams?.["temperature"] != null) {
+            otelSpan.setAttribute("gen_ai.request.temperature", invocationParams["temperature"]);
+        }
+    }
+    handleLLMStart(llm, prompts, runId, parentRunId, extraParams, _tags, metadata, runName) {
+        const modelName = this._extractModelName(llm, extraParams);
+        const spanName = modelName ? `chat ${modelName}` : runName || "llm";
+        const otelSpan = this._createChildSpan(spanName, runId, parentRunId);
+        this._spans.set(runId, otelSpan);
+        const conversationId = this._getConversationId(metadata);
+        this._setRootConversationId(conversationId, runId, parentRunId);
+        otelSpan.setAttribute("gen_ai.operation.name", "chat");
+        otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
+        otelSpan.setAttribute("openinference.span.kind", "LLM");
+        if (modelName) {
+            otelSpan.setAttribute("gen_ai.request.model", modelName);
+        }
+        if (prompts.length > 0) {
+            const inputMessages = prompts.map((p) => ({
+                role: "user",
+                parts: [{ type: "text", content: p }],
+            }));
+            otelSpan.setAttribute("gen_ai.input.messages", JSON.stringify(inputMessages));
+            this._llmInputs.set(runId, inputMessages);
+        }
+    }
+    handleLLMEnd(output, runId) {
+        const otelSpan = this._spans.get(runId);
+        if (!otelSpan)
+            return;
+        this._spans.delete(runId);
+        this._spanNames.delete(runId);
+        this._llmInputs.delete(runId);
+        this._endRootIfComplete(runId);
+        const generations = output.generations?.[0];
+        if (generations && generations.length > 0) {
+            const parts = [];
+            for (const gen of generations) {
+                if (gen.text) {
+                    parts.push({ type: "text", content: gen.text });
+                }
+                const msg = gen.message;
+                const kwargs = (msg?.["kwargs"] || msg);
+                const additionalKwargs = kwargs?.["additional_kwargs"];
+                const toolCalls = (additionalKwargs?.["tool_calls"] ||
+                    kwargs?.["tool_calls"]);
+                if (toolCalls) {
+                    for (const tc of toolCalls) {
+                        const fn = (tc.function || tc);
+                        parts.push({
+                            type: "tool_call",
+                            name: (fn.name || tc.name || ""),
+                            id: (tc.id || ""),
+                            arguments: (fn.arguments || tc.args || ""),
+                        });
+                    }
+                }
+            }
+            if (parts.length > 0) {
+                const outputMessages = [{ role: "assistant", parts }];
+                otelSpan.setAttribute("gen_ai.output.messages", JSON.stringify(outputMessages));
+            }
+        }
+        const usage = output.llmOutput;
+        const tokenUsage = (usage?.["tokenUsage"] ||
+            usage?.["token_usage"] ||
+            usage?.["usage"]);
+        if (tokenUsage) {
+            const inputTokens = tokenUsage["promptTokens"] ||
+                tokenUsage["prompt_tokens"] ||
+                tokenUsage["input_tokens"];
+            const outputTokens = tokenUsage["completionTokens"] ||
+                tokenUsage["completion_tokens"] ||
+                tokenUsage["output_tokens"];
+            if (typeof inputTokens === "number") {
+                otelSpan.setAttribute("gen_ai.usage.input_tokens", inputTokens);
+            }
+            if (typeof outputTokens === "number") {
+                otelSpan.setAttribute("gen_ai.usage.output_tokens", outputTokens);
+            }
+            // Flat field (legacy format) or nested cache_creation object (Claude 4+).
+            const cacheCreationObj = tokenUsage["cache_creation"];
+            const cacheWriteTokens = tokenUsage["cache_creation_input_tokens"] ||
+                tokenUsage["cacheCreationInputTokens"] ||
+                (cacheCreationObj?.["ephemeral_5m_input_tokens"] || 0) +
+                    (cacheCreationObj?.["ephemeral_1h_input_tokens"] || 0) ||
+                undefined;
+            if (typeof cacheWriteTokens === "number") {
+                otelSpan.setAttribute("gen_ai.usage.cache_creation.input_tokens", cacheWriteTokens);
+            }
+            const cacheReadTokens = tokenUsage["cache_read_input_tokens"] ||
+                tokenUsage["cacheReadInputTokens"];
+            if (typeof cacheReadTokens === "number") {
+                otelSpan.setAttribute("gen_ai.usage.cache_read.input_tokens", cacheReadTokens);
+            }
+        }
+        const model = usage?.["model"] || usage?.["model_name"];
+        if (typeof model === "string") {
+            otelSpan.setAttribute("gen_ai.response.model", model);
+        }
+        // gen_ai.response.id — required by the server for conversation tracking.
+        const responseId = usage?.["id"] || usage?.["system_fingerprint"];
+        otelSpan.setAttribute("gen_ai.response.id", typeof responseId === "string" ? responseId : `langchain-${runId}`);
+        otelSpan.end();
+    }
+    handleLLMError(err, runId) {
+        const otelSpan = this._spans.get(runId);
+        if (!otelSpan)
+            return;
+        this._spans.delete(runId);
+        this._spanNames.delete(runId);
+        this._llmInputs.delete(runId);
+        this._endRootIfComplete(runId);
+        otelSpan.recordException(err);
+        otelSpan.setStatus({ code: SpanStatusCode.ERROR, message: err.message });
+        otelSpan.setAttribute("exception.message", err.message);
+        otelSpan.end();
+    }
+    // -------------------------------------------------------------------------
+    // Chain callbacks
+    // -------------------------------------------------------------------------
+    handleChainStart(chain, _inputs, runId, _runType, _tags, metadata, runName, parentRunId) {
+        const name = runName || chain?.name || chain?.id?.[chain.id.length - 1] || "chain";
+        const otelSpan = this._createChildSpan(name, runId, parentRunId);
+        this._spans.set(runId, otelSpan);
+        const conversationId = this._getConversationId(metadata);
+        this._setRootConversationId(conversationId, runId, parentRunId);
+        otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
+    }
+    handleChainEnd(_outputs, runId) {
+        const otelSpan = this._spans.get(runId);
+        if (!otelSpan)
+            return;
+        this._spans.delete(runId);
+        this._endRootIfComplete(runId);
+        otelSpan.end();
+    }
+    handleChainError(err, runId) {
+        const otelSpan = this._spans.get(runId);
+        if (!otelSpan)
+            return;
+        this._spans.delete(runId);
+        this._endRootIfComplete(runId);
+        otelSpan.recordException(err);
+        otelSpan.setStatus({ code: SpanStatusCode.ERROR, message: err.message });
+        otelSpan.setAttribute("exception.message", err.message);
+        otelSpan.end();
+    }
+    // -------------------------------------------------------------------------
+    // Tool callbacks
+    // -------------------------------------------------------------------------
+    handleToolStart(tool, input, runId, parentRunId, _tags, metadata, runName) {
+        const toolName = runName || tool?.name || tool?.id?.[tool.id.length - 1] || "tool";
+        const otelSpan = this._createChildSpan(toolName, runId, parentRunId);
+        this._spans.set(runId, otelSpan);
+        const conversationId = this._getConversationId(metadata);
+        this._setRootConversationId(conversationId, runId, parentRunId);
+        otelSpan.setAttribute("gen_ai.tool.name", toolName);
+        otelSpan.setAttribute("openinference.span.kind", "TOOL");
+        otelSpan.setAttribute("gen_ai.tool.input", input);
+        otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
+    }
+    handleToolEnd(output, runId) {
+        const otelSpan = this._spans.get(runId);
+        if (!otelSpan)
+            return;
+        this._spans.delete(runId);
+        this._endRootIfComplete(runId);
+        if (output != null) {
+            otelSpan.setAttribute("gen_ai.tool.output", typeof output === "string" ? output : JSON.stringify(output));
+        }
+        otelSpan.end();
+    }
+    handleToolError(err, runId) {
+        const otelSpan = this._spans.get(runId);
+        if (!otelSpan)
+            return;
+        this._spans.delete(runId);
+        this._endRootIfComplete(runId);
+        otelSpan.recordException(err);
+        otelSpan.setStatus({ code: SpanStatusCode.ERROR, message: err.message });
+        otelSpan.setAttribute("exception.message", err.message);
+        otelSpan.end();
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    async shutdown() {
+        for (const span of this._spans.values())
+            span.end();
+        this._spans.clear();
+        this._spanNames.clear();
+        this._spanParents.clear();
+        this._runRoots.clear();
+        await this._tracerProvider.shutdown();
+    }
+    async forceFlush() {
+        await this._tracerProvider.forceFlush();
+    }
+    // -------------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------------
+    _extractModelName(llm, extraParams) {
+        const invocationParams = extraParams?.["invocation_params"];
+        if (invocationParams) {
+            const model = invocationParams["model"] ||
+                invocationParams["model_name"] ||
+                invocationParams["modelName"];
+            if (typeof model === "string")
+                return model;
+        }
+        const kwargs = llm?.kwargs;
+        if (kwargs) {
+            const model = kwargs["model"] || kwargs["model_name"] || kwargs["modelName"];
+            if (typeof model === "string")
+                return model;
+        }
+        return undefined;
+    }
+    _extractProvider(llm) {
+        const id = llm?.id;
+        if (Array.isArray(id) && id.length > 0) {
+            return id[id.length - 1];
+        }
+        return undefined;
+    }
+    /** Walk up the span tree to find the first non-wrapper span name. */
+    _findAgentName(runId) {
+        let current = runId;
+        for (let i = 0; i < 20 && current; i++) {
+            const name = this._spanNames.get(current);
+            if (name && !IntrospectionCallbackHandler._wrapperNames.has(name)) {
+                return name;
+            }
+            current = this._spanParents.get(current);
+        }
+        return undefined;
+    }
+    _getConversationId(metadata) {
+        const metaConvId = metadata?.["gen_ai.conversation.id"];
+        if (metaConvId !== undefined && metaConvId !== null) {
+            return String(metaConvId);
+        }
+        const threadId = metadata?.["thread_id"];
+        if (threadId !== undefined && threadId !== null) {
+            return String(threadId);
+        }
+        const baggageConvId = this._readBaggage("gen_ai.conversation.id");
+        if (baggageConvId)
+            return baggageConvId;
+        return this._conversationId;
+    }
+    /**
+     * Read a single value from the active OTel baggage. Returns undefined when
+     * no propagator is installed or the key is absent.
+     *
+     * Used so callers can scope LangChain calls with
+     * `IntrospectionClient.withAgent()` / `.withConversation()` /
+     * `.withGenAi()` without threading metadata through every invoke().
+     */
+    _readBaggage(key) {
+        const baggage = propagation.getBaggage(otelContext.active());
+        return baggage?.getEntry(key)?.value;
+    }
+    _convertMessages(messages) {
+        const inputMessages = [];
+        const systemInstructions = [];
+        for (const msg of messages) {
+            const msgType = msg._getType?.() ||
+                msg.type ||
+                "unknown";
+            const role = this._mapRole(msgType);
+            const content = this._extractContent(msg.content);
+            if (role === "system") {
+                systemInstructions.push(typeof msg.content === "string"
+                    ? msg.content
+                    : JSON.stringify(msg.content));
+                continue;
+            }
+            const parts = [];
+            if (role === "tool") {
+                const toolCallId = msg
+                    .tool_call_id || "";
+                parts.push({
+                    type: "tool_call_response",
+                    id: toolCallId,
+                    response: content,
+                });
+            }
+            else if (content) {
+                parts.push({ type: "text", content });
+            }
+            const toolCalls = msg
+                .tool_calls;
+            if (toolCalls) {
+                for (const tc of toolCalls) {
+                    parts.push({
+                        type: "tool_call",
+                        name: (tc.name || ""),
+                        id: (tc.id || ""),
+                        arguments: typeof tc.args === "string" ? tc.args : JSON.stringify(tc.args),
+                    });
+                }
+            }
+            if (parts.length > 0) {
+                inputMessages.push({ role, parts });
+            }
+        }
+        return { inputMessages, systemInstructions };
+    }
+    _mapRole(msgType) {
+        switch (msgType) {
+            case "human":
+                return "user";
+            case "ai":
+                return "assistant";
+            case "system":
+                return "system";
+            case "tool":
+                return "tool";
+            default:
+                return "user";
+        }
+    }
+    _extractContent(content) {
+        if (typeof content === "string")
+            return content;
+        if (Array.isArray(content)) {
+            return content
+                .map((part) => {
+                const p = part;
+                if (p.type === "text")
+                    return (p.text || "");
+                return "";
+            })
+                .filter(Boolean)
+                .join("");
+        }
+        return String(content || "");
+    }
+}
+//# sourceMappingURL=langchain-handler.js.map

package/dist/otel/langchain-handler.js.map

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

package/dist/otel/logs.d.ts

@@ -0,0 +1,82 @@
+/**
+ * IntrospectionLogs — OTel logs exporter for Introspection.
+ *
+ * Owns its own `LoggerProvider` and OTLP log exporter. Provides `track`,
+ * `feedback`, `identify`, and async-context helpers (`withBaggage`,
+ * `withAgent`, `withConversation`, etc.) that propagate identity and
+ * gen_ai context through OpenTelemetry baggage.
+ *
+ * Fully independent of {@link IntrospectionClient}. Construct it directly
+ * with the OTel peer dependencies installed.
+ *
+ * @example
+ * ```typescript
+ * import { IntrospectionLogs } from "@introspection-sdk/introspection-node/otel";
+ *
+ * const logs = new IntrospectionLogs({
+ *   token: process.env.INTROSPECTION_TOKEN,
+ *   serviceName: "my-service",
+ * });
+ *
+ * await logs.withAgent("support-bot", "agent_1", () =>
+ *   logs.withConversation("conv_123", undefined, () => {
+ *     logs.feedback("thumbs_up", { comments: "Great answer" });
+ *   }),
+ * );
+ *
+ * await logs.shutdown();
+ * ```
+ */
+import { type FeedbackOptions, type UserTraits } from "../types.js";
+/**
+ * Configuration for {@link IntrospectionLogs}.
+ */
+export interface IntrospectionLogsOptions {
+    /** Authentication token (env: INTROSPECTION_TOKEN). */
+    token?: string;
+    /** Service name for telemetry (env: INTROSPECTION_SERVICE_NAME, default: "introspection-client"). */
+    serviceName?: string;
+    /**
+     * Base URL for the OTLP collector (env: INTROSPECTION_BASE_OTEL_URL,
+     * default: "https://otel.introspection.dev").
+     */
+    baseOtelUrl?: string;
+    /** Additional HTTP headers to include in exporter requests. */
+    additionalHeaders?: Record<string, string>;
+    /** Flush interval in milliseconds (default: 5000). */
+    flushInterval?: number;
+    /** Maximum queue size before auto-flush (default: 100). */
+    maxBatchSize?: number;
+}
+export declare class IntrospectionLogs {
+    private loggerProvider;
+    private otelLogger;
+    private userId;
+    private anonymousId;
+    private traits;
+    constructor(options?: IntrospectionLogsOptions);
+    /** Get gen_ai context from baggage */
+    private getGenAiFromContext;
+    /** Get identity from baggage or instance state */
+    private getIdentityFromContext;
+    private getTimestamp;
+    private buildAttributes;
+    track(eventName: string, properties?: Record<string, unknown>, options?: {
+        eventId?: string;
+    }): void;
+    feedback(name: string, options?: FeedbackOptions): void;
+    identify(userId: string, traits?: UserTraits, anonymousId?: string, eventId?: string): void;
+    createBaggageContext(values: Record<string, string>): import("@opentelemetry/api").Context;
+    withBaggage<T>(values: Record<string, string>, callback: () => T | Promise<T>): Promise<T>;
+    withAgent<T>(agentName: string, agentId: string | undefined, callback: () => T | Promise<T>): Promise<T>;
+    withConversation<T>(conversationId: string | undefined, previousResponseId: string | undefined, callback: () => T | Promise<T>): Promise<T>;
+    setUserId(userId: string): void;
+    setAnonymousId(anonymousId: string): void;
+    withUserId<T>(userId: string, callback: () => T | Promise<T>): Promise<T>;
+    withAnonymousId<T>(anonymousId: string, callback: () => T | Promise<T>): Promise<T>;
+    getAnonymousId(): string | undefined;
+    reset(): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=logs.d.ts.map