@introspection-sdk/introspection-node 0.4.1 → 0.4.3

package/dist/otel/tracing-processor.d.ts

@@ -0,0 +1,139 @@
+/**
+ * OpenAI Agents TracingProcessor for Introspection SDK.
+ *
+ * Forwards OpenAI agent traces to the backend via OTLP with OTel Gen AI semantic
+ * convention attributes.
+ */
+import { type SpanExporter, type IdGenerator } from "@opentelemetry/sdk-trace-base";
+import type { TracingProcessor, Trace, Span, SpanData } from "@openai/agents";
+/**
+ * Advanced options for testing and customization of
+ * {@link IntrospectionTracingProcessor}.
+ */
+export interface TracingProcessorAdvancedOptions {
+    /** Custom span exporter (for testing - use InMemorySpanExporter) */
+    spanExporter?: SpanExporter;
+    /** Custom ID generator (for testing - use IncrementalIdGenerator) */
+    idGenerator?: IdGenerator;
+    /** Use SimpleSpanProcessor instead of BatchSpanProcessor (for testing) */
+    useSimpleSpanProcessor?: boolean;
+    /**
+     * Maximum number of spans to export in a single batch.
+     * Set to 1 to export each span individually on end, ensuring sequential
+     * processing by the backend (useful for multi-turn conversations where
+     * each turn must be ingested before the next arrives).
+     * Defaults to the OTel SDK default (512).
+     */
+    maxExportBatchSize?: number;
+    /**
+     * Delay interval in milliseconds between batch exports.
+     * Lower values reduce latency but increase network requests.
+     * Defaults to 1000.
+     */
+    scheduledDelayMillis?: number;
+}
+/** Configuration for {@link IntrospectionTracingProcessor}. */
+export interface IntrospectionTracingProcessorOptions {
+    /** Authentication token (env: INTROSPECTION_TOKEN) */
+    token?: string;
+    /** Base URL for the API (env: INTROSPECTION_BASE_OTEL_URL, default: "https://otel.introspection.dev") */
+    baseUrl?: string;
+    /** Service name for telemetry (env: INTROSPECTION_SERVICE_NAME) */
+    serviceName?: string;
+    /** Additional headers to include in requests */
+    additionalHeaders?: Record<string, string>;
+    /** Advanced options for testing and customization */
+    advanced?: TracingProcessorAdvancedOptions;
+}
+/**
+ * {@link TracingProcessor} that forwards OpenAI agent traces to the
+ * Introspection backend via OTLP.
+ *
+ * Extracts OTel Gen AI semantic convention attributes from span data:
+ * - Agent spans: `gen_ai.agent.name`, `gen_ai.tool.definitions`, `gen_ai.agent.handoffs`
+ * - Function spans: `gen_ai.tool.name`, `gen_ai.tool.input`, `gen_ai.tool.output`
+ * - Response spans: `gen_ai.input/output.messages`, `gen_ai.usage.*`, `gen_ai.request.model`
+ * - Generation spans: `gen_ai.request.model`, `gen_ai.usage.*`
+ * - Handoff spans: `gen_ai.handoff.from_agent`, `gen_ai.handoff.to_agent`
+ *
+ * @example
+ * ```ts
+ * import { IntrospectionTracingProcessor } from "@introspection-sdk/introspection-node";
+ *
+ * const processor = new IntrospectionTracingProcessor({ token: "sk-intro-…" });
+ * // pass processor to the OpenAI Agents SDK withTrace() or registerProcessor()
+ * ```
+ */
+export declare class IntrospectionTracingProcessor implements TracingProcessor {
+    private _tracerProvider;
+    private _tracer;
+    private _spans;
+    private _conversationIds;
+    constructor(options?: IntrospectionTracingProcessorOptions);
+    /**
+     * Called when the processor is started. Optional lifecycle hook.
+     */
+    start(): void;
+    /**
+     * Called when a trace starts. Creates a root OTel span.
+     *
+     * @param trace - The OpenAI Agents SDK trace object.
+     */
+    onTraceStart(trace: Trace): Promise<void>;
+    /**
+     * Called when a trace ends. Closes the root OTel span.
+     *
+     * @param trace - The OpenAI Agents SDK trace object.
+     */
+    onTraceEnd(trace: Trace): Promise<void>;
+    /**
+     * Called when a span starts. Creates a child OTel span with parent context.
+     *
+     * @param span - The OpenAI Agents SDK span.
+     */
+    onSpanStart(span: Span<SpanData>): Promise<void>;
+    /**
+     * Called when a span ends. Extracts `gen_ai.*` attributes from the span
+     * data and sets them on the corresponding OTel span before ending it.
+     *
+     * @param span - The OpenAI Agents SDK span.
+     */
+    onSpanEnd(span: Span<SpanData>): Promise<void>;
+    /**
+     * Extract attributes from agent spans.
+     */
+    private _processAgentSpan;
+    /**
+     * Extract attributes from function/tool spans.
+     */
+    private _processFunctionSpan;
+    /**
+     * Extract attributes from response spans.
+     * Matches Python implementation - extracts from both spanData and _response object.
+     */
+    private _processResponseSpan;
+    /**
+     * Extract attributes from generation spans.
+     * Handles both structured GenerationUsageData (spanData.usage) and raw
+     * Chat Completions API responses stored in spanData.output[0] by
+     * OpenAIChatCompletionsModel.
+     */
+    private _processGenerationSpan;
+    /**
+     * Extract attributes from handoff spans.
+     */
+    private _processHandoffSpan;
+    /**
+     * Shut down the tracer provider, flushing all pending spans.
+     *
+     * @returns A promise that resolves once shutdown is complete.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Force-flush any buffered spans to the Introspection backend.
+     *
+     * @returns A promise that resolves once the flush completes.
+     */
+    forceFlush(): Promise<void>;
+}
+//# sourceMappingURL=tracing-processor.d.ts.map

package/dist/otel/tracing-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-processor.d.ts","sourceRoot":"","sources":["../../src/otel/tracing-processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,+BAA+B,CAAC;AAoBvC,OAAO,KAAK,EACV,gBAAgB,EAChB,KAAK,EACL,IAAI,EACJ,QAAQ,EAMT,MAAM,gBAAgB,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,oEAAoE;IACpE,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,qEAAqE;IACrE,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,+DAA+D;AAC/D,MAAM,WAAW,oCAAoC;IACnD,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yGAAyG;IACzG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,qDAAqD;IACrD,QAAQ,CAAC,EAAE,+BAA+B,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,6BAA8B,YAAW,gBAAgB;IACpE,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,OAAO,CAA+C;IAC9D,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,gBAAgB,CAAkC;gBAE9C,OAAO,GAAE,oCAAyC;IA2F9D;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/C;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7C;;;;OAIG;IACG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BtD;;;;;OAKG;IACG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCpD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAkG5B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAyG9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/otel/tracing-processor.js

@@ -0,0 +1,418 @@
+/**
+ * OpenAI Agents TracingProcessor for Introspection SDK.
+ *
+ * Forwards OpenAI agent traces to the backend via OTLP with OTel Gen AI semantic
+ * convention attributes.
+ */
+import { context as otelContext, trace as otelTrace, } from "@opentelemetry/api";
+import { BasicTracerProvider, BatchSpanProcessor, SimpleSpanProcessor, } from "@opentelemetry/sdk-trace-base";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
+import { randomUUID } from "crypto";
+import { convertResponsesInputsToSemconv, convertResponsesOutputsToSemconv, convertResponsesToolsToSemconv, convertResponsesInstructionsToSemconv, } from "../converters/openai.js";
+import { logger, withOtlpHttpsProxy } from "../utils.js";
+import { VERSION } from "../version.js";
+/**
+ * {@link TracingProcessor} that forwards OpenAI agent traces to the
+ * Introspection backend via OTLP.
+ *
+ * Extracts OTel Gen AI semantic convention attributes from span data:
+ * - Agent spans: `gen_ai.agent.name`, `gen_ai.tool.definitions`, `gen_ai.agent.handoffs`
+ * - Function spans: `gen_ai.tool.name`, `gen_ai.tool.input`, `gen_ai.tool.output`
+ * - Response spans: `gen_ai.input/output.messages`, `gen_ai.usage.*`, `gen_ai.request.model`
+ * - Generation spans: `gen_ai.request.model`, `gen_ai.usage.*`
+ * - Handoff spans: `gen_ai.handoff.from_agent`, `gen_ai.handoff.to_agent`
+ *
+ * @example
+ * ```ts
+ * import { IntrospectionTracingProcessor } from "@introspection-sdk/introspection-node";
+ *
+ * const processor = new IntrospectionTracingProcessor({ token: "sk-intro-…" });
+ * // pass processor to the OpenAI Agents SDK withTrace() or registerProcessor()
+ * ```
+ */
+export class IntrospectionTracingProcessor {
+    _tracerProvider;
+    _tracer;
+    _spans = new Map();
+    _conversationIds = new Map();
+    constructor(options = {}) {
+        const advanced = options.advanced;
+        const serviceName = options.serviceName || process.env.INTROSPECTION_SERVICE_NAME;
+        const resource = serviceName
+            ? resourceFromAttributes({ [ATTR_SERVICE_NAME]: serviceName })
+            : undefined;
+        // If custom exporter is provided (testing mode), skip token validation
+        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 headers = {
+                "User-Agent": `introspection-sdk/${VERSION}`,
+                Authorization: `Bearer ${token}`,
+                ...options.additionalHeaders,
+            };
+            // Construct endpoint URL
+            const endpoint = baseUrl.endsWith("/v1/traces")
+                ? baseUrl
+                : `${baseUrl.replace(/\/$/, "")}/v1/traces`;
+            logger.info(`IntrospectionTracingProcessor initialized: endpoint=${endpoint}`);
+            // Setup OTLP exporter
+            const spanExporter = new OTLPTraceExporter(withOtlpHttpsProxy({
+                url: endpoint,
+                headers,
+            }));
+            // Use SimpleSpanProcessor for maxExportBatchSize=1 (sequential export),
+            // otherwise BatchSpanProcessor with configurable batch size.
+            // Default to sequential export for dev/staging tokens.
+            const effectiveBatchSize = advanced?.maxExportBatchSize ??
+                (token.startsWith("intro_dev") || token.startsWith("intro_staging")
+                    ? 1
+                    : undefined);
+            const useSimple = advanced?.useSimpleSpanProcessor || effectiveBatchSize === 1;
+            const scheduledDelayMillis = advanced?.scheduledDelayMillis ?? 1000;
+            const spanProcessor = useSimple
+                ? new SimpleSpanProcessor(spanExporter)
+                : new BatchSpanProcessor(spanExporter, {
+                    scheduledDelayMillis,
+                    ...(effectiveBatchSize
+                        ? { maxExportBatchSize: effectiveBatchSize }
+                        : {}),
+                });
+            this._tracerProvider = new BasicTracerProvider({
+                resource,
+                idGenerator: advanced?.idGenerator,
+                spanProcessors: [spanProcessor],
+            });
+        }
+        else {
+            // Testing mode: use provided exporter
+            logger.info(`IntrospectionTracingProcessor initialized in test mode with custom exporter`);
+            // Choose span processor based on options
+            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("openai-agents", VERSION);
+    }
+    /**
+     * Called when the processor is started. Optional lifecycle hook.
+     */
+    start() {
+        // No-op - processor is ready after construction
+    }
+    /**
+     * Called when a trace starts. Creates a root OTel span.
+     *
+     * @param trace - The OpenAI Agents SDK trace object.
+     */
+    async onTraceStart(trace) {
+        logger.debug(`onTraceStart called: ${trace?.name} (${trace?.traceId})`);
+        if (trace) {
+            // Use groupId as conversationId when provided so callers can link
+            // multiple traces (e.g. multi-turn orchestrator runs) into one conversation.
+            const conversationId = trace.groupId ?? `intro_conv_${randomUUID().replace(/-/g, "")}`;
+            this._conversationIds.set(trace.traceId, conversationId);
+            const otelSpan = this._tracer.startSpan(trace.name);
+            this._spans.set(trace.traceId, otelSpan);
+            logger.debug(`Created root span for trace: ${trace.traceId}`);
+        }
+    }
+    /**
+     * Called when a trace ends. Closes the root OTel span.
+     *
+     * @param trace - The OpenAI Agents SDK trace object.
+     */
+    async onTraceEnd(trace) {
+        logger.debug(`onTraceEnd called: ${trace?.name} (${trace?.traceId})`);
+        if (trace) {
+            const otelSpan = this._spans.get(trace.traceId);
+            if (otelSpan) {
+                this._spans.delete(trace.traceId);
+                this._conversationIds.delete(trace.traceId);
+                otelSpan.end();
+                logger.debug(`Ended root span for trace: ${trace.traceId}`);
+            }
+        }
+    }
+    /**
+     * Called when a span starts. Creates a child OTel span with parent context.
+     *
+     * @param span - The OpenAI Agents SDK span.
+     */
+    async onSpanStart(span) {
+        logger.debug(`onSpanStart called: ${span?.spanId} (type: ${span?.spanData?.type})`);
+        if (span) {
+            const parentId = span.parentId || span.traceId;
+            const parent = this._spans.get(parentId);
+            const ctx = parent
+                ? otelTrace.setSpan(otelContext.active(), parent)
+                : undefined;
+            const spanData = span.spanData;
+            let name;
+            // Use name for agent and function spans, type for others
+            if (spanData.type === "agent") {
+                name = spanData.name;
+            }
+            else if (spanData.type === "function") {
+                name = spanData.name;
+            }
+            else {
+                name = spanData.type;
+            }
+            const otelSpan = this._tracer.startSpan(name, {}, ctx);
+            this._spans.set(span.spanId, otelSpan);
+        }
+    }
+    /**
+     * Called when a span ends. Extracts `gen_ai.*` attributes from the span
+     * data and sets them on the corresponding OTel span before ending it.
+     *
+     * @param span - The OpenAI Agents SDK span.
+     */
+    async onSpanEnd(span) {
+        if (!span)
+            return;
+        const otelSpan = this._spans.get(span.spanId);
+        if (!otelSpan) {
+            return;
+        }
+        this._spans.delete(span.spanId);
+        const spanData = span.spanData;
+        // Extract gen_ai.* attributes based on span type
+        switch (spanData.type) {
+            case "agent":
+                this._processAgentSpan(otelSpan, spanData);
+                break;
+            case "function":
+                this._processFunctionSpan(otelSpan, spanData);
+                break;
+            case "response":
+                this._processResponseSpan(otelSpan, spanData);
+                break;
+            case "generation":
+                this._processGenerationSpan(otelSpan, spanData);
+                break;
+            case "handoff":
+                this._processHandoffSpan(otelSpan, spanData);
+                break;
+        }
+        // Propagate conversation ID from trace
+        const conversationId = this._conversationIds.get(span.traceId);
+        if (conversationId) {
+            otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
+        }
+        // Keep raw span data for debugging (matches Python attribute name)
+        otelSpan.setAttribute("openai_agents.span_data", JSON.stringify(spanData));
+        otelSpan.end();
+    }
+    /**
+     * Extract attributes from agent spans.
+     */
+    _processAgentSpan(otelSpan, spanData) {
+        otelSpan.setAttribute("gen_ai.agent.name", spanData.name);
+        otelSpan.setAttribute("gen_ai.system", "openai");
+        otelSpan.setAttribute("openinference.span.kind", "AGENT");
+        if (spanData.tools) {
+            // Wrap tool names as objects for ClickHouse Array(JSON) compatibility
+            const toolDefs = spanData.tools.map((t) => ({ name: t }));
+            otelSpan.setAttribute("gen_ai.tool.definitions", JSON.stringify(toolDefs));
+        }
+        if (spanData.handoffs) {
+            otelSpan.setAttribute("gen_ai.agent.handoffs", JSON.stringify(spanData.handoffs));
+        }
+        if (spanData.output_type) {
+            otelSpan.setAttribute("gen_ai.agent.output_type", spanData.output_type);
+        }
+    }
+    /**
+     * Extract attributes from function/tool spans.
+     */
+    _processFunctionSpan(otelSpan, spanData) {
+        otelSpan.setAttribute("gen_ai.tool.name", spanData.name);
+        otelSpan.setAttribute("openinference.span.kind", "TOOL");
+        if (spanData.input) {
+            otelSpan.setAttribute("gen_ai.tool.input", spanData.input);
+        }
+        if (spanData.output) {
+            otelSpan.setAttribute("gen_ai.tool.output", String(spanData.output));
+        }
+    }
+    /**
+     * Extract attributes from response spans.
+     * Matches Python implementation - extracts from both spanData and _response object.
+     */
+    _processResponseSpan(otelSpan, spanData) {
+        otelSpan.setAttribute("gen_ai.operation.name", "chat");
+        otelSpan.setAttribute("gen_ai.system", "openai");
+        otelSpan.setAttribute("openinference.span.kind", "LLM");
+        // Response ID (from span_data directly)
+        if (spanData.response_id) {
+            otelSpan.setAttribute("gen_ai.response.id", spanData.response_id);
+        }
+        // Input messages (from spanData._input)
+        if (spanData._input) {
+            const inputs = Array.isArray(spanData._input)
+                ? spanData._input
+                : [spanData._input];
+            const [inputMessages] = convertResponsesInputsToSemconv(inputs, undefined);
+            if (inputMessages.length > 0) {
+                otelSpan.setAttribute("gen_ai.input.messages", JSON.stringify(inputMessages));
+            }
+        }
+        // Extract from _response if available (full Response object)
+        const response = spanData._response;
+        if (!response)
+            return;
+        // System instructions
+        const sysInstructions = convertResponsesInstructionsToSemconv(response.instructions);
+        if (sysInstructions) {
+            otelSpan.setAttribute("gen_ai.system_instructions", JSON.stringify(sysInstructions));
+        }
+        // Tool definitions (with full details from Response object)
+        if (response.tools && response.tools.length > 0) {
+            const toolDefs = convertResponsesToolsToSemconv(response.tools);
+            otelSpan.setAttribute("gen_ai.tool.definitions", JSON.stringify(toolDefs));
+        }
+        // Token usage
+        const usage = response.usage;
+        if (usage) {
+            if (usage.input_tokens) {
+                otelSpan.setAttribute("gen_ai.usage.input_tokens", usage.input_tokens);
+            }
+            if (usage.output_tokens) {
+                otelSpan.setAttribute("gen_ai.usage.output_tokens", usage.output_tokens);
+            }
+            // OpenAI returns cached token count in input_tokens_details.cached_tokens
+            const cachedTokens = usage.input_tokens_details?.cached_tokens;
+            if (cachedTokens) {
+                otelSpan.setAttribute("gen_ai.usage.cache_read.input_tokens", cachedTokens);
+            }
+        }
+        // Model info
+        if (response.model) {
+            otelSpan.setAttribute("gen_ai.request.model", response.model);
+        }
+        // Response ID from response object (fallback if not in span_data)
+        if (!spanData.response_id && response.id) {
+            otelSpan.setAttribute("gen_ai.response.id", response.id);
+        }
+        // Output messages (from response.output)
+        if (response.output && response.output.length > 0) {
+            const outputMessages = convertResponsesOutputsToSemconv(response.output);
+            if (outputMessages.length > 0) {
+                otelSpan.setAttribute("gen_ai.output.messages", JSON.stringify(outputMessages));
+            }
+        }
+    }
+    /**
+     * Extract attributes from generation spans.
+     * Handles both structured GenerationUsageData (spanData.usage) and raw
+     * Chat Completions API responses stored in spanData.output[0] by
+     * OpenAIChatCompletionsModel.
+     */
+    _processGenerationSpan(otelSpan, spanData) {
+        otelSpan.setAttribute("gen_ai.operation.name", "chat");
+        otelSpan.setAttribute("gen_ai.system", "openai");
+        otelSpan.setAttribute("openinference.span.kind", "LLM");
+        if (spanData.model) {
+            otelSpan.setAttribute("gen_ai.request.model", spanData.model);
+        }
+        // GenerationUsageData uses snake_case: input_tokens / output_tokens.
+        if (spanData.usage?.input_tokens) {
+            otelSpan.setAttribute("gen_ai.usage.input_tokens", spanData.usage.input_tokens);
+        }
+        if (spanData.usage?.output_tokens) {
+            otelSpan.setAttribute("gen_ai.usage.output_tokens", spanData.usage.output_tokens);
+        }
+        // OpenAIChatCompletionsModel stores the raw ChatCompletion response object
+        // in spanData.output[0] (it never sets spanData.usage). Extract usage,
+        // response ID, response model, and the actual assistant message from it.
+        if (!spanData.usage) {
+            const rawResponse = spanData.output?.[0];
+            // Response ID — required by the backend processor to register this span
+            // as a conversation item (build_request returns None without it).
+            const responseId = rawResponse?.id;
+            if (typeof responseId === "string" && responseId) {
+                otelSpan.setAttribute("gen_ai.response.id", responseId);
+            }
+            // Resolved model name (e.g. "gpt-4o-mini-2024-07-18" vs "gpt-4o-mini").
+            const responseModel = rawResponse?.model;
+            if (typeof responseModel === "string" && responseModel) {
+                otelSpan.setAttribute("gen_ai.response.model", responseModel);
+            }
+            const rawUsage = rawResponse?.usage;
+            if (rawUsage) {
+                const promptTokens = rawUsage.prompt_tokens;
+                const completionTokens = rawUsage.completion_tokens;
+                if (typeof promptTokens === "number") {
+                    otelSpan.setAttribute("gen_ai.usage.input_tokens", promptTokens);
+                }
+                if (typeof completionTokens === "number") {
+                    otelSpan.setAttribute("gen_ai.usage.output_tokens", completionTokens);
+                }
+                const promptDetails = rawUsage.prompt_tokens_details;
+                const cachedTokens = promptDetails?.cached_tokens;
+                if (typeof cachedTokens === "number" && cachedTokens > 0) {
+                    otelSpan.setAttribute("gen_ai.usage.cache_read.input_tokens", cachedTokens);
+                }
+            }
+            // Extract the actual assistant message from choices[0].message so that
+            // gen_ai.output.messages is a proper [{role, content}] array rather than
+            // the full ChatCompletion envelope (which the backend cannot parse).
+            const choices = rawResponse?.choices;
+            const assistantMessage = choices?.[0]?.message;
+            if (assistantMessage) {
+                otelSpan.setAttribute("gen_ai.output.messages", JSON.stringify([assistantMessage]));
+            }
+        }
+        if (spanData.input) {
+            otelSpan.setAttribute("gen_ai.input.messages", JSON.stringify(spanData.input));
+        }
+        // For non-Chat-Completions generation spans that do have usage set,
+        // still export output messages in the standard format if present.
+        if (spanData.usage && spanData.output) {
+            otelSpan.setAttribute("gen_ai.output.messages", JSON.stringify(spanData.output));
+        }
+    }
+    /**
+     * Extract attributes from handoff spans.
+     */
+    _processHandoffSpan(otelSpan, spanData) {
+        if (spanData.from_agent) {
+            otelSpan.setAttribute("gen_ai.handoff.from_agent", spanData.from_agent);
+        }
+        if (spanData.to_agent) {
+            otelSpan.setAttribute("gen_ai.handoff.to_agent", spanData.to_agent);
+        }
+    }
+    /**
+     * Shut down the tracer provider, flushing all pending spans.
+     *
+     * @returns A promise that resolves once shutdown is complete.
+     */
+    async shutdown() {
+        await this._tracerProvider.shutdown();
+    }
+    /**
+     * Force-flush any buffered spans to the Introspection backend.
+     *
+     * @returns A promise that resolves once the flush completes.
+     */
+    async forceFlush() {
+        await this._tracerProvider.forceFlush();
+    }
+}
+//# sourceMappingURL=tracing-processor.js.map

package/dist/otel/tracing-processor.js.map

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

package/dist/resources/experiments.d.ts

@@ -0,0 +1,31 @@
+import type { Experiment, ExperimentEndParams, ExperimentCreate, ExperimentListParams, ExperimentUpdate, Paginated, RunRequest, Uuid } from "@introspection-sdk/types";
+import type { HttpClient } from "../http.js";
+import type { IntrospectionClient } from "../client.js";
+import { Runner } from "../runner.js";
+export declare class ExperimentsApi {
+    private readonly http;
+    private readonly client;
+    constructor(http: HttpClient, client: IntrospectionClient);
+    list(params: ExperimentListParams): Promise<Paginated<Experiment>>;
+    listAll(params: ExperimentListParams): AsyncIterable<Experiment>;
+    get(id: Uuid): Promise<Experiment>;
+    create(input: ExperimentCreate): Promise<Experiment>;
+    update(id: Uuid, input: ExperimentUpdate): Promise<Experiment>;
+    delete(id: Uuid): Promise<void>;
+    startById(id: Uuid): Promise<Experiment>;
+    endById(id: Uuid, params?: ExperimentEndParams): Promise<Experiment>;
+    cancelById(id: Uuid): Promise<Experiment>;
+    runById(id: Uuid, opts?: RunRequest): Promise<Runner>;
+}
+export declare class ExperimentHandle {
+    private readonly api;
+    private readonly id;
+    constructor(api: ExperimentsApi, id: Uuid);
+    run(opts?: RunRequest): Promise<Runner>;
+    start(): Promise<Experiment>;
+    end(opts?: ExperimentEndParams): Promise<Experiment>;
+    cancel(): Promise<Experiment>;
+}
+export type ExperimentHandleFactory = (id: Uuid) => ExperimentHandle;
+export declare function attachExperiments(client: IntrospectionClient, http: HttpClient): ExperimentsApi & ExperimentHandleFactory;
+//# sourceMappingURL=experiments.d.ts.map

package/dist/resources/experiments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiments.d.ts","sourceRoot":"","sources":["../../src/resources/experiments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,UAAU,EAEV,IAAI,EACL,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,MAAM,EAAqB,MAAM,cAAc,CAAC;AAmBzD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,mBAAmB;IAG9C,IAAI,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAQ3D,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,aAAa,CAAC,UAAU,CAAC;IASvE,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAOlC,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAQpD,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ9D,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/B,SAAS,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAQxC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAQpE,UAAU,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAQnC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAa5D;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBADF,GAAG,EAAE,cAAc,EACnB,EAAE,EAAE,IAAI;IAG3B,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvC,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAI5B,GAAG,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpD,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;CAG9B;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,EAAE,EAAE,IAAI,KAAK,gBAAgB,CAAC;AAErE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,UAAU,GACf,cAAc,GAAG,uBAAuB,CAgB1C"}