@introspection-sdk/introspection-node 0.4.1 → 0.4.3

package/dist/otel/pi.js

@@ -0,0 +1,67 @@
+/**
+ * High-level pi Agent SDK integration for Introspection.
+ *
+ * Wraps {@link @introspection-sdk/introspection-pi} behind a zero-config
+ * interface so users don't need to manage OpenTelemetry tracers directly.
+ *
+ * @example
+ * ```ts
+ * import { IntrospectionPiInstrumentor, setupTracing } from "@introspection-sdk/introspection-node";
+ * import { Agent } from "@mariozechner/pi-agent-core";
+ *
+ * setupTracing({ serviceName: "my-app" });
+ * const instrumentor = new IntrospectionPiInstrumentor();
+ *
+ * const agent = new Agent({ ... });
+ * instrumentor.instrument(agent, {
+ *   conversationId: "conv-123",
+ *   agentId: "weather-agent",
+ *   agentName: "Weather",
+ * });
+ *
+ * await agent.prompt("What's the weather in Tokyo?");
+ * instrumentor.stop();
+ * ```
+ */
+import { trace } from "@opentelemetry/api";
+import { instrumentStream, instrumentAgent, } from "@introspection-sdk/introspection-pi";
+import { VERSION } from "../version.js";
+/**
+ * Zero-config pi Agent SDK integration for Introspection.
+ *
+ * Uses the global OTel tracer provider (registered by {@link setupTracing}).
+ * Call {@link instrument} once per {@link Agent} instance, then {@link stop}
+ * to unsubscribe all tool instrumentation and finalize open spans.
+ */
+export class IntrospectionPiInstrumentor {
+    _tracer;
+    _instrumentations = [];
+    constructor(opts = {}) {
+        this._tracer = trace.getTracer(opts.tracerName ?? "introspection-pi", VERSION);
+    }
+    /**
+     * Instrument a pi {@link Agent}:
+     * - Wraps `agent.streamFn` to emit a `chat ${provider}` span per LLM call.
+     * - Subscribes to the agent loop to emit an `execute_tool ${name}` span per
+     *   tool execution.
+     *
+     * @param agent - The pi Agent instance to instrument.
+     * @param meta  - Identity metadata stamped on every span produced by this agent.
+     */
+    instrument(agent, meta) {
+        agent.streamFn = instrumentStream(agent.streamFn, {
+            tracer: this._tracer,
+            meta,
+        });
+        this._instrumentations.push(instrumentAgent(agent, { tracer: this._tracer, meta }));
+    }
+    /**
+     * Unsubscribe all active tool instrumentations and finalize any open spans.
+     */
+    stop() {
+        for (const inst of this._instrumentations)
+            inst.stop();
+        this._instrumentations = [];
+    }
+}
+//# sourceMappingURL=pi.js.map

package/dist/otel/pi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.js","sourceRoot":"","sources":["../../src/otel/pi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EACL,gBAAgB,EAChB,eAAe,GAGhB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AASxC;;;;;;GAMG;AACH,MAAM,OAAO,2BAA2B;IAC9B,OAAO,CAAqC;IAC5C,iBAAiB,GAA2B,EAAE,CAAC;IAEvD,YAAY,OAA2C,EAAE;QACvD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,SAAS,CAC5B,IAAI,CAAC,UAAU,IAAI,kBAAkB,EACrC,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,KAAY,EAAE,IAAe;QACtC,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE;YAChD,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,IAAI;SACL,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,CAAC,IAAI,CACzB,eAAe,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CACvD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI;QACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,iBAAiB;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/otel/setup.d.ts

@@ -0,0 +1,23 @@
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+import { type IntrospectionSpanProcessorOptions } from "./span-processor.js";
+export type ConflictBehavior = "warn" | "throw" | "replace";
+export interface SetupTracingOptions extends IntrospectionSpanProcessorOptions {
+    /**
+     * What to do if a context manager or propagator is already registered.
+     *
+     *   - `"warn"`  (default) — log a warning and continue with the existing
+     *     registration. Spans still flow but baggage may not propagate as
+     *     expected. Set `INTROSPECTION_STRICT_TRACING=1` to upgrade to throw.
+     *   - `"throw"` — throw an error. Use in environments where a silent
+     *     baggage drop is unacceptable (production telemetry pipelines).
+     *   - `"replace"` — force-register over the existing manager / propagator.
+     *     Useful in tests or when migrating from another tracer; can break
+     *     other libraries that relied on the previous registration.
+     */
+    onConflict?: ConflictBehavior;
+}
+/**
+ * Initialise Introspection tracing for a Node.js process.
+ */
+export declare function setupTracing(options?: SetupTracingOptions): NodeTracerProvider;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/otel/setup.ts"],"names":[],"mappings":"AA8DA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGnE,OAAO,EAEL,KAAK,iCAAiC,EACvC,MAAM,qBAAqB,CAAC;AAI7B,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,mBAAoB,SAAQ,iCAAiC;IAC5E;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AA8DD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,kBAAkB,CAkBpB"}

package/dist/otel/setup.js

@@ -0,0 +1,127 @@
+/**
+ * One-call tracing bootstrap for Introspection.
+ *
+ * Wires up the three things every host process needs for baggage-based
+ * agent / conversation propagation to work:
+ *
+ * 1. `AsyncLocalStorageContextManager` — without this, `context.with()` is a
+ *    no-op (the default `NOOP_CONTEXT_MANAGER` silently drops the context),
+ *    which makes `IntrospectionClient.withAgent()`, `.withConversation()`,
+ *    etc. dead code.
+ * 2. `W3CBaggagePropagator` — so baggage is carried across HTTP boundaries
+ *    via the `baggage` header (alongside W3C trace-context).
+ * 3. A registered `NodeTracerProvider` with an `IntrospectionSpanProcessor`
+ *    on it — so spans are exported to Introspection and baggage values
+ *    (conversation / agent IDs) are merged into span attributes at
+ *    `onEnd()` time.
+ *
+ * Call this once at process start (before any instrumentors run). It is
+ * idempotent across re-invocations — the cached provider is returned and
+ * the global registrations are not touched a second time.
+ *
+ * **Loud-by-default registration.** OTel's `setGlobalContextManager` /
+ * `setGlobalPropagator` silently refuse to replace an existing
+ * registration. If anything (another lib, a stale call, a test fixture)
+ * has already installed a context manager that does NOT propagate W3C
+ * baggage, our `withAgent` / `withConversation` calls become silent
+ * no-ops and users get spans with no identity attached — exactly the
+ * footgun this SDK exists to prevent.
+ *
+ * `setupTracing` defends against that:
+ *   - If no manager / propagator is registered: install ours.
+ *   - If one is registered: WARN (default) or THROW (strict mode) so the
+ *     host author sees it, rather than discovering missing baggage in
+ *     production telemetry weeks later.
+ *
+ * Pass `{ onConflict: "throw" }` (or set `INTROSPECTION_STRICT_TRACING=1`
+ * in the env) for the strict variant. Pass `{ onConflict: "replace" }`
+ * to force replacement when you know the prior registration is wrong
+ * (e.g. test setup, or migrating from another tracer).
+ *
+ * @example
+ * ```ts
+ * import { setupTracing, IntrospectionClient } from "@introspection-sdk/introspection-node";
+ *
+ * setupTracing();
+ *
+ * const introspect = new IntrospectionClient();
+ *
+ * await introspect.withAgent("researcher", "researcher-1", () =>
+ *   introspect.withConversation(conversationId, undefined, () =>
+ *     client.messages.create({ ... }),
+ *   ),
+ * );
+ * ```
+ */
+import { context, propagation } from "@opentelemetry/api";
+import { AsyncLocalStorageContextManager } from "@opentelemetry/context-async-hooks";
+import { CompositePropagator, W3CBaggagePropagator, W3CTraceContextPropagator, } from "@opentelemetry/core";
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+import { logger } from "../utils.js";
+import { IntrospectionSpanProcessor, } from "./span-processor.js";
+let registeredProvider;
+function defaultConflictBehavior() {
+    return process.env.INTROSPECTION_STRICT_TRACING ? "throw" : "warn";
+}
+function registerContextManager(behavior) {
+    const ok = context.setGlobalContextManager(new AsyncLocalStorageContextManager().enable());
+    if (ok)
+        return;
+    // OTel silently refuses replacement — we have to disable+retry to force.
+    const msg = "setupTracing: another OTel context manager was already registered. " +
+        "withAgent / withConversation baggage scopes will not propagate unless " +
+        "that manager is an AsyncLocalStorageContextManager honoring W3C baggage.";
+    if (behavior === "throw") {
+        throw new Error(`[introspection] ${msg}`);
+    }
+    if (behavior === "replace") {
+        context.disable();
+        if (!context.setGlobalContextManager(new AsyncLocalStorageContextManager().enable())) {
+            throw new Error("[introspection] setupTracing: failed to replace context manager " +
+                "even after disable(); the OTel global registry is in a bad state.");
+        }
+        return;
+    }
+    logger.warn(msg);
+}
+function registerPropagator(behavior) {
+    const propagator = new CompositePropagator({
+        propagators: [new W3CTraceContextPropagator(), new W3CBaggagePropagator()],
+    });
+    const ok = propagation.setGlobalPropagator(propagator);
+    if (ok)
+        return;
+    const msg = "setupTracing: another OTel propagator was already registered. " +
+        "Cross-process baggage propagation depends on the existing propagator " +
+        "carrying the W3C `baggage` header.";
+    if (behavior === "throw") {
+        throw new Error(`[introspection] ${msg}`);
+    }
+    if (behavior === "replace") {
+        propagation.disable();
+        if (!propagation.setGlobalPropagator(propagator)) {
+            throw new Error("[introspection] setupTracing: failed to replace propagator even " +
+                "after disable(); the OTel global registry is in a bad state.");
+        }
+        return;
+    }
+    logger.warn(msg);
+}
+/**
+ * Initialise Introspection tracing for a Node.js process.
+ */
+export function setupTracing(options) {
+    if (registeredProvider) {
+        return registeredProvider;
+    }
+    const behavior = options?.onConflict ?? defaultConflictBehavior();
+    registerContextManager(behavior);
+    registerPropagator(behavior);
+    const provider = new NodeTracerProvider({
+        spanProcessors: [new IntrospectionSpanProcessor(options)],
+    });
+    provider.register();
+    registeredProvider = provider;
+    return provider;
+}
+//# sourceMappingURL=setup.js.map

package/dist/otel/setup.js.map

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

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

@@ -0,0 +1,62 @@
+import { Context } from "@opentelemetry/api";
+import { SpanProcessor, ReadableSpan, Span } from "@opentelemetry/sdk-trace-base";
+import type { AdvancedOptions } from "../types.js";
+export interface IntrospectionSpanProcessorOptions {
+    /** Authentication token (env: INTROSPECTION_TOKEN) */
+    token?: string;
+    /**
+     * Service name for telemetry (env: INTROSPECTION_SERVICE_NAME).
+     * Note: For spans, the service name is typically set on the TracerProvider's resource.
+     * This option is provided for consistency but the TracerProvider's resource takes precedence.
+     */
+    serviceName?: string;
+    /** Advanced options for configuration and testing */
+    advanced?: AdvancedOptions;
+}
+/**
+ * OTel {@link SpanProcessor} that forwards traces to the Introspection backend
+ * via OTLP, automatically converting any OpenInference spans to Gen AI
+ * semantic convention attributes.
+ *
+ * @example
+ * ```ts
+ * import { IntrospectionSpanProcessor } from "@introspection-sdk/introspection-node";
+ *
+ * const processor = new IntrospectionSpanProcessor({ token: "sk-intro-…" });
+ * tracerProvider.addSpanProcessor(processor);
+ * ```
+ */
+export declare class IntrospectionSpanProcessor implements SpanProcessor {
+    private _spanProcessor;
+    private _serviceName?;
+    private _conversationIds;
+    constructor(options?: IntrospectionSpanProcessorOptions);
+    /**
+     * Called when a new span is started; delegates to the inner batch processor.
+     *
+     * @param span - The span that was just started.
+     * @param parentContext - The parent {@link Context}.
+     */
+    onStart(span: Span, parentContext: Context): void;
+    /**
+     * Called when a span ends. If the span originates from an OpenInference
+     * instrumentor, its attributes are converted to `gen_ai.*` semconv keys
+     * before being forwarded.
+     *
+     * @param span - The completed {@link ReadableSpan}.
+     */
+    onEnd(span: ReadableSpan): void;
+    /**
+     * Shut down the inner batch processor and its exporter.
+     *
+     * @returns A promise that resolves once all pending spans are flushed.
+     */
+    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=span-processor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"span-processor.d.ts","sourceRoot":"","sources":["../../src/otel/span-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAIR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,IAAI,EAGL,MAAM,+BAA+B,CAAC;AAMvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA8FnD,MAAM,WAAW,iCAAiC;IAChD,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,0BAA2B,YAAW,aAAa;IAC9D,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAkC;gBAE9C,OAAO,GAAE,iCAAsC;IA0H3D;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI;IAIjD;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAgI/B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/otel/span-processor.js

@@ -0,0 +1,319 @@
+import { propagation, context as otelContext, } from "@opentelemetry/api";
+import { BatchSpanProcessor, } 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 { ExportResultCode } from "@opentelemetry/core";
+import { randomUUID } from "crypto";
+import { logger, withOtlpHttpsProxy } from "../utils.js";
+import { isOpenInferenceSpan, replaceOpenInferenceWithGenAI, isVercelAISpan, convertVercelAIToGenAI, } from "../converters/index.js";
+/**
+ * A {@link ReadableSpan} wrapper that substitutes the original attributes with
+ * a converted set while delegating every other property to the original span.
+ *
+ * Used internally by {@link IntrospectionSpanProcessor} to convert
+ * OpenInference attributes to Gen AI semantic conventions on-the-fly.
+ */
+class ConvertedReadableSpan {
+    _original;
+    _convertedAttributes;
+    _resource;
+    constructor(original, convertedAttributes, resource) {
+        this._original = original;
+        this._convertedAttributes = convertedAttributes;
+        this._resource = resource;
+    }
+    get name() {
+        return this._original.name;
+    }
+    get kind() {
+        return this._original.kind;
+    }
+    spanContext() {
+        return this._original.spanContext();
+    }
+    get parentSpanContext() {
+        return this._original.parentSpanContext;
+    }
+    get startTime() {
+        return this._original.startTime;
+    }
+    get endTime() {
+        return this._original.endTime;
+    }
+    get status() {
+        return this._original.status;
+    }
+    get links() {
+        return this._original.links;
+    }
+    get events() {
+        return this._original.events;
+    }
+    get duration() {
+        return this._original.duration;
+    }
+    get ended() {
+        return this._original.ended;
+    }
+    get resource() {
+        return this._resource ?? this._original.resource;
+    }
+    get instrumentationScope() {
+        return this._original.instrumentationScope;
+    }
+    get droppedAttributesCount() {
+        return this._original.droppedAttributesCount;
+    }
+    get droppedEventsCount() {
+        return this._original.droppedEventsCount;
+    }
+    get droppedLinksCount() {
+        return this._original.droppedLinksCount;
+    }
+    get attributes() {
+        return this._convertedAttributes;
+    }
+}
+/**
+ * OTel {@link SpanProcessor} that forwards traces to the Introspection backend
+ * via OTLP, automatically converting any OpenInference spans to Gen AI
+ * semantic convention attributes.
+ *
+ * @example
+ * ```ts
+ * import { IntrospectionSpanProcessor } from "@introspection-sdk/introspection-node";
+ *
+ * const processor = new IntrospectionSpanProcessor({ token: "sk-intro-…" });
+ * tracerProvider.addSpanProcessor(processor);
+ * ```
+ */
+export class IntrospectionSpanProcessor {
+    _spanProcessor;
+    _serviceName;
+    _conversationIds = new Map();
+    constructor(options = {}) {
+        const token = options.token || process.env.INTROSPECTION_TOKEN;
+        if (!token) {
+            throw new Error("INTROSPECTION_TOKEN is required");
+        }
+        const serviceName = options.serviceName ||
+            process.env.INTROSPECTION_SERVICE_NAME ||
+            undefined; // Falls back to TracerProvider's resource
+        this._serviceName = serviceName;
+        const advanced = options.advanced || {};
+        const baseUrl = advanced.baseUrl ||
+            process.env.INTROSPECTION_BASE_OTEL_URL ||
+            "https://otel.introspection.dev";
+        const headers = {
+            Authorization: `Bearer ${token}`,
+            ...(advanced.additionalHeaders || {}),
+        };
+        // Construct endpoint URL
+        let endpoint;
+        if (baseUrl.endsWith("/v1/traces")) {
+            endpoint = baseUrl;
+        }
+        else {
+            endpoint = `${baseUrl.replace(/\/$/, "")}/v1/traces`;
+        }
+        logger.info(`IntrospectionSpanProcessor initialized: endpoint=${endpoint}${serviceName ? `, serviceName=${serviceName}` : ""}`);
+        // Use custom spanExporter if provided (for testing), otherwise create OTLP exporter
+        const baseExporter = advanced.spanExporter ||
+            new OTLPTraceExporter(withOtlpHttpsProxy({
+                url: endpoint,
+                headers,
+            }));
+        // Wrap exporter to add v1/v2 compatibility and basic validation
+        const exporter = {
+            export: (spans, resultCallback) => {
+                // Filter and fix spans: ensure they have required properties and add v1 compatibility
+                const validSpans = spans
+                    .filter((span) => {
+                    // Basic validation: span must have name and resource
+                    if (!span?.name || !span.resource) {
+                        return false;
+                    }
+                    // Must have either instrumentationLibrary or instrumentationScope
+                    const compatSpan = span;
+                    return !!(compatSpan.instrumentationLibrary ||
+                        compatSpan.instrumentationScope);
+                })
+                    .map((span) => span)
+                    .map((span) => {
+                    // Compatibility: add instrumentationLibrary for spans that only have instrumentationScope (v2)
+                    const compatSpan = span;
+                    if (compatSpan.instrumentationScope &&
+                        !compatSpan.instrumentationLibrary) {
+                        compatSpan.instrumentationLibrary =
+                            compatSpan.instrumentationScope;
+                    }
+                    return span;
+                });
+                if (validSpans.length === 0) {
+                    resultCallback({ code: ExportResultCode.SUCCESS });
+                    return;
+                }
+                // Export with error handling
+                try {
+                    baseExporter.export(validSpans, (result) => {
+                        if (result.code === ExportResultCode.SUCCESS) {
+                            logger.debug(`Exported ${validSpans.length} span(s) to ${endpoint}`);
+                        }
+                        else {
+                            logger.error(`Failed to export ${validSpans.length} span(s): ${result.error?.message || "Unknown error"}`);
+                        }
+                        resultCallback(result);
+                    });
+                }
+                catch (error) {
+                    logger.error(`Export error: ${error instanceof Error ? error.message : String(error)}`);
+                    resultCallback({
+                        code: ExportResultCode.FAILED,
+                        error: error instanceof Error ? error : new Error(String(error)),
+                    });
+                }
+            },
+            shutdown: () => baseExporter.shutdown(),
+            forceFlush: () => {
+                if (baseExporter.forceFlush) {
+                    return baseExporter.forceFlush();
+                }
+                return Promise.resolve();
+            },
+        };
+        // Use BatchSpanProcessor like logfire does
+        this._spanProcessor = new BatchSpanProcessor(exporter);
+    }
+    /**
+     * Called when a new span is started; delegates to the inner batch processor.
+     *
+     * @param span - The span that was just started.
+     * @param parentContext - The parent {@link Context}.
+     */
+    onStart(span, parentContext) {
+        this._spanProcessor.onStart(span, parentContext);
+    }
+    /**
+     * Called when a span ends. If the span originates from an OpenInference
+     * instrumentor, its attributes are converted to `gen_ai.*` semconv keys
+     * before being forwarded.
+     *
+     * @param span - The completed {@link ReadableSpan}.
+     */
+    onEnd(span) {
+        const compatSpan = span;
+        const scopeName = compatSpan.instrumentationScope?.name ||
+            compatSpan.instrumentationLibrary?.name;
+        const isOI = isOpenInferenceSpan(scopeName) ||
+            typeof span.attributes["openinference.span.kind"] === "string";
+        const isVercel = isVercelAISpan(span.attributes);
+        // Skip Vercel AI SDK wrapper spans (ai.streamText, ai.generateText).
+        // They duplicate the child doStream/doGenerate output without proper
+        // input message windows, causing empty user messages in conversation view.
+        // This applies regardless of whether OI attributes are also present.
+        const aiOperationId = span.attributes["ai.operationId"];
+        if (typeof aiOperationId === "string" &&
+            !String(aiOperationId).includes(".do")) {
+            return;
+        }
+        // Skip spans that have no LLM-relevant data — they are infrastructure spans
+        // (e.g. Next.js route resolution, HTTP spans) that should not be exported.
+        const hasGenAi = isOI ||
+            isVercel ||
+            span.attributes["gen_ai.system"] != null ||
+            span.attributes["gen_ai.operation.name"] != null ||
+            span.attributes["gen_ai.request.model"] != null ||
+            span.attributes["gen_ai.input.messages"] != null ||
+            span.attributes["gen_ai.output.messages"] != null;
+        if (!hasGenAi)
+            return;
+        let attrs;
+        if (isOI) {
+            attrs = {
+                ...replaceOpenInferenceWithGenAI(span.attributes),
+            };
+            // When both OI and Vercel attrs present, merge Vercel-specific
+            // enrichments (conversation ID from metadata, etc.)
+            if (isVercel) {
+                const vercelAttrs = convertVercelAIToGenAI(span.attributes);
+                for (const [key, value] of Object.entries(vercelAttrs)) {
+                    // Prefer Vercel output messages when they contain reasoning
+                    if (key === "gen_ai.output.messages" &&
+                        typeof value === "string" &&
+                        value.includes('"thinking"')) {
+                        attrs[key] = value;
+                    }
+                    else if (attrs[key] === undefined) {
+                        attrs[key] = value;
+                    }
+                }
+            }
+            logger.debug(`Converting OpenInference span: ${span.name}`);
+        }
+        else if (isVercel) {
+            attrs = {
+                ...span.attributes,
+                ...convertVercelAIToGenAI(span.attributes),
+            };
+            logger.debug(`Converting Vercel AI span: ${span.name}`);
+        }
+        else {
+            attrs = { ...span.attributes };
+        }
+        // Read baggage from active context
+        const baggage = propagation.getBaggage(otelContext.active());
+        // Conversation ID: baggage > existing attr > auto-generate per trace
+        const baggageConvId = baggage?.getEntry("gen_ai.conversation.id")?.value;
+        const existingConvId = attrs["gen_ai.conversation.id"];
+        if (baggageConvId) {
+            attrs["gen_ai.conversation.id"] = baggageConvId;
+        }
+        else if (!existingConvId) {
+            const traceId = span.spanContext().traceId;
+            if (!this._conversationIds.has(traceId)) {
+                this._conversationIds.set(traceId, `intro_conv_${randomUUID().replace(/-/g, "")}`);
+            }
+            attrs["gen_ai.conversation.id"] = this._conversationIds.get(traceId);
+        }
+        // Default gen_ai.operation.name to "chat" for spans with messages but no operation name
+        if (!attrs["gen_ai.operation.name"] &&
+            (attrs["gen_ai.input.messages"] || attrs["gen_ai.output.messages"])) {
+            attrs["gen_ai.operation.name"] = "chat";
+        }
+        // Agent name / id from baggage (baggage wins so per-call agent identity
+        // overrides any default stamped at instrumentor-construction time).
+        const baggageAgentName = baggage?.getEntry("gen_ai.agent.name")?.value;
+        if (baggageAgentName) {
+            attrs["gen_ai.agent.name"] = baggageAgentName;
+        }
+        const baggageAgentId = baggage?.getEntry("gen_ai.agent.id")?.value;
+        if (baggageAgentId) {
+            attrs["gen_ai.agent.id"] = baggageAgentId;
+        }
+        // Override resource with service name if provided
+        let resource;
+        if (this._serviceName) {
+            resource = span.resource.merge(resourceFromAttributes({ [ATTR_SERVICE_NAME]: this._serviceName }));
+        }
+        const processedSpan = new ConvertedReadableSpan(span, attrs, resource);
+        this._spanProcessor.onEnd(processedSpan);
+    }
+    /**
+     * Shut down the inner batch processor and its exporter.
+     *
+     * @returns A promise that resolves once all pending spans are flushed.
+     */
+    async shutdown() {
+        await this._spanProcessor.shutdown();
+    }
+    /**
+     * Force-flush any buffered spans to the Introspection backend.
+     *
+     * @returns A promise that resolves once the flush completes.
+     */
+    async forceFlush() {
+        await this._spanProcessor.forceFlush();
+    }
+}
+//# sourceMappingURL=span-processor.js.map

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

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