@introspection-sdk/introspection-node 0.4.1 → 0.4.3

package/dist/otel/mastra-exporter.js

@@ -0,0 +1,525 @@
+/**
+ * Mastra-compatible Exporter for Introspection.
+ *
+ * Extends Mastra's BaseExporter to receive TracingEvents (Mastra's native
+ * span format) and convert them to gen_ai.* OTel spans for the Introspection
+ * backend.
+ *
+ * **Important:** This module requires `@mastra/observability` and `@mastra/core`
+ * at runtime. Import via the subpath: `@introspection-sdk/introspection-node/mastra`
+ *
+ * @example
+ * ```ts
+ * import { Mastra } from "@mastra/core/mastra";
+ * import { IntrospectionMastraExporter } from "@introspection-sdk/introspection-node/mastra";
+ *
+ * const mastra = new Mastra({
+ *   agents: { myAgent },
+ *   observability: {
+ *     configs: {
+ *       otel: {
+ *         serviceName: "my-mastra-app",
+ *         exporters: [new IntrospectionMastraExporter()],
+ *       },
+ *     },
+ *   },
+ * });
+ * ```
+ */
+import { BaseExporter } from "@mastra/observability";
+import { context as otelContext, 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";
+// ---------------------------------------------------------------------------
+// Exporter
+// ---------------------------------------------------------------------------
+export class IntrospectionMastraExporter extends BaseExporter {
+    name = "introspection";
+    _options;
+    _tracerProvider;
+    _tracer;
+    _conversationIds = new Map();
+    // Track root OTel spans per Mastra traceId so children share the same trace
+    _rootSpans = new Map();
+    constructor(options = {}) {
+        super({ logLevel: options.debug ? "debug" : "info" });
+        this._options = options;
+        const token = options.token || process.env.INTROSPECTION_TOKEN;
+        if (!token && !options.advanced?.spanExporter) {
+            this.setDisabled("INTROSPECTION_TOKEN is required");
+        }
+    }
+    /**
+     * Called by Mastra after the instance is fully configured.
+     * We defer TracerProvider creation to here so we can use the service name.
+     */
+    init(options) {
+        if (this.isDisabled)
+            return;
+        const config = options.config;
+        const serviceName = config?.["serviceName"] || "mastra-app";
+        this._initProvider(serviceName);
+    }
+    _initProvider(serviceName) {
+        if (this._tracerProvider)
+            return; // Already initialized
+        const opts = this._options;
+        const advanced = opts.advanced;
+        const resource = resourceFromAttributes({
+            [ATTR_SERVICE_NAME]: serviceName,
+        });
+        if (advanced?.spanExporter) {
+            const sp = advanced.useSimpleSpanProcessor
+                ? new SimpleSpanProcessor(advanced.spanExporter)
+                : new BatchSpanProcessor(advanced.spanExporter, {
+                    scheduledDelayMillis: 100,
+                });
+            this._tracerProvider = new BasicTracerProvider({
+                resource,
+                idGenerator: advanced.idGenerator,
+                spanProcessors: [sp],
+            });
+            logger.info("IntrospectionMastraExporter initialized in test mode");
+        }
+        else {
+            const token = opts.token || process.env.INTROSPECTION_TOKEN;
+            if (!token)
+                return;
+            const baseUrl = opts.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}`,
+                ...opts.additionalHeaders,
+            };
+            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 sp = useSimple
+                ? new SimpleSpanProcessor(spanExporter)
+                : new BatchSpanProcessor(spanExporter, {
+                    scheduledDelayMillis: 1000,
+                    ...(effectiveBatchSize
+                        ? { maxExportBatchSize: effectiveBatchSize }
+                        : {}),
+                });
+            this._tracerProvider = new BasicTracerProvider({
+                resource,
+                idGenerator: advanced?.idGenerator,
+                spanProcessors: [sp],
+            });
+            logger.info(`IntrospectionMastraExporter initialized: endpoint=${endpoint}, serviceName=${serviceName}`);
+        }
+        this._tracer = this._tracerProvider.getTracer("introspection-mastra", VERSION);
+    }
+    async _exportTracingEvent(event) {
+        if (this.isDisabled)
+            return;
+        if (event.type !== "span_ended")
+            return;
+        // Lazy init if init() wasn't called
+        if (!this._tracerProvider) {
+            this._initProvider("mastra-app");
+        }
+        if (!this._tracer)
+            return;
+        this._exportSpan(event.exportedSpan);
+    }
+    async flush() {
+        await this._tracerProvider?.forceFlush();
+    }
+    async shutdown() {
+        // End any open root spans
+        for (const span of this._rootSpans.values())
+            span.end();
+        this._rootSpans.clear();
+        await this._tracerProvider?.shutdown();
+    }
+    // -------------------------------------------------------------------------
+    // Span routing
+    // -------------------------------------------------------------------------
+    _exportSpan(span) {
+        switch (span.type) {
+            case "agent_run":
+                this._exportAgentRun(span);
+                break;
+            case "model_step":
+                this._exportModelStep(span);
+                break;
+            case "tool_call":
+            case "mcp_tool_call":
+                this._exportToolCall(span);
+                break;
+            // model_generation — skipped; model_step has per-step tool calls
+            default:
+                break;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Span creation with shared trace context
+    // -------------------------------------------------------------------------
+    /** Ensure a root OTel span exists for this Mastra trace.
+     *  Events arrive in end-order (children first, agent_run last),
+     *  so we create a synthetic root on first encounter. */
+    _ensureRoot(span) {
+        if (this._rootSpans.has(span.traceId))
+            return;
+        const rootSpan = this._tracer.startSpan("trace", {
+            startTime: span.startTime,
+        });
+        this._rootSpans.set(span.traceId, rootSpan);
+    }
+    _createSpan(span, name) {
+        this._ensureRoot(span);
+        const parentCtx = otelTrace.setSpan(otelContext.active(), this._rootSpans.get(span.traceId));
+        return this._tracer.startSpan(name || span.name, { startTime: span.startTime }, parentCtx);
+    }
+    // -------------------------------------------------------------------------
+    // Span converters
+    // -------------------------------------------------------------------------
+    _exportAgentRun(span) {
+        const attrs = span.attributes;
+        const conversationId = this._getConversationId(span);
+        // agent_run arrives last — set attrs on the synthetic root and end it
+        this._ensureRoot(span);
+        const rootSpan = this._rootSpans.get(span.traceId);
+        rootSpan.setAttribute("gen_ai.conversation.id", conversationId);
+        rootSpan.setAttribute("gen_ai.agent.name", span.entityName || span.name || "agent");
+        // Prefer system messages from span.input (full prompt sent to LLM) over
+        // attrs.instructions (may be just the short placeholder string).
+        const inputMsgs = Array.isArray(span.input)
+            ? span.input
+            : undefined;
+        const systemMsgsFromInput = inputMsgs?.filter((m) => m.role === "system");
+        if (systemMsgsFromInput && systemMsgsFromInput.length > 0) {
+            rootSpan.setAttribute("gen_ai.system_instructions", JSON.stringify(systemMsgsFromInput.map((m) => ({
+                type: "text",
+                content: this._extractTextContent(m.content),
+            }))));
+        }
+        else if (attrs?.["instructions"] &&
+            typeof attrs["instructions"] === "string") {
+            rootSpan.setAttribute("gen_ai.system_instructions", JSON.stringify([{ type: "text", content: attrs["instructions"] }]));
+        }
+        // Metadata passthrough
+        if (span.metadata) {
+            for (const [key, value] of Object.entries(span.metadata)) {
+                if (value != null) {
+                    rootSpan.setAttribute(`ai.telemetry.metadata.${key}`, typeof value === "string" ? value : JSON.stringify(value));
+                }
+            }
+        }
+        rootSpan.end(span.endTime || new Date());
+        this._rootSpans.delete(span.traceId);
+    }
+    _exportModelStep(span) {
+        const attrs = span.attributes;
+        const conversationId = this._getConversationId(span);
+        // Model info lives in metadata.modelMetadata (set by Mastra)
+        const modelMeta = span.metadata?.["modelMetadata"];
+        const model = modelMeta?.["modelId"] || "";
+        const provider = modelMeta?.["modelProvider"] || "";
+        // Response metadata from metadata.body (the API response)
+        const respBody = span.metadata?.["body"];
+        const responseModel = respBody?.["model"] || "";
+        const responseId = respBody?.["id"] || "";
+        const spanName = model ? `chat ${model}` : span.name;
+        const otelSpan = this._createSpan(span, spanName);
+        otelSpan.setAttribute("gen_ai.operation.name", "chat");
+        otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
+        otelSpan.setAttribute("openinference.span.kind", "LLM");
+        if (model)
+            otelSpan.setAttribute("gen_ai.request.model", model);
+        if (provider)
+            otelSpan.setAttribute("gen_ai.system", provider);
+        if (responseModel)
+            otelSpan.setAttribute("gen_ai.response.model", responseModel);
+        if (responseId)
+            otelSpan.setAttribute("gen_ai.response.id", responseId);
+        // Input messages — span.input is either:
+        //   (a) a flat normalized array { role, content }[] from Mastra's inputMessages path, or
+        //   (b) an object { body: { input/messages, tools } } from the raw HTTP request path.
+        if (span.input != null) {
+            let apiMessages;
+            let tools;
+            if (Array.isArray(span.input)) {
+                // Path (a): flat array already normalized by Mastra's normalizeMessages()
+                apiMessages = span.input;
+            }
+            else {
+                // Path (b): nested request body
+                const rawInput = span.input;
+                const body = rawInput?.body;
+                const msgs = body?.input ?? body?.messages;
+                if (Array.isArray(msgs)) {
+                    apiMessages = msgs;
+                }
+                if (Array.isArray(body?.tools)) {
+                    tools = body.tools;
+                }
+            }
+            if (apiMessages && apiMessages.length > 0) {
+                const inputMessages = this._convertInput(apiMessages);
+                if (inputMessages.length > 0) {
+                    otelSpan.setAttribute("gen_ai.input.messages", JSON.stringify(inputMessages));
+                }
+                // System instructions — combine all system messages into one attribute
+                const systemMsgs = apiMessages.filter((m) => m.role === "system");
+                if (systemMsgs.length > 0) {
+                    otelSpan.setAttribute("gen_ai.system_instructions", JSON.stringify(systemMsgs.map((m) => ({
+                        type: "text",
+                        content: this._extractTextContent(m.content),
+                    }))));
+                }
+            }
+            // Tool definitions (only present on path (b))
+            if (Array.isArray(tools) && tools.length > 0) {
+                otelSpan.setAttribute("gen_ai.tool.definitions", JSON.stringify(tools.map((t) => ({
+                    type: t.type || "function",
+                    name: t.name || "",
+                    description: t.description || "",
+                    parameters: t.parameters,
+                }))));
+            }
+        }
+        // Output messages — model_step output has {text, toolCalls} per step
+        if (span.output != null) {
+            const outputMessages = this._convertOutput(span.output, attrs?.["finishReason"]);
+            if (outputMessages.length > 0) {
+                otelSpan.setAttribute("gen_ai.output.messages", JSON.stringify(outputMessages));
+            }
+        }
+        // Token usage (per step)
+        const usage = attrs?.["usage"];
+        if (usage) {
+            if (typeof usage["inputTokens"] === "number")
+                otelSpan.setAttribute("gen_ai.usage.input_tokens", usage["inputTokens"]);
+            if (typeof usage["outputTokens"] === "number")
+                otelSpan.setAttribute("gen_ai.usage.output_tokens", usage["outputTokens"]);
+            const inputDetails = usage["inputDetails"];
+            if (typeof inputDetails?.["cacheRead"] === "number")
+                otelSpan.setAttribute("gen_ai.usage.cache_read.input_tokens", inputDetails["cacheRead"]);
+            if (typeof inputDetails?.["cacheWrite"] === "number")
+                otelSpan.setAttribute("gen_ai.usage.cache_creation.input_tokens", inputDetails["cacheWrite"]);
+        }
+        // Finish reason
+        const finishReason = attrs?.["finishReason"];
+        if (finishReason)
+            otelSpan.setAttribute("gen_ai.response.finish_reasons", [finishReason]);
+        otelSpan.end(span.endTime || new Date());
+    }
+    _exportToolCall(span) {
+        const conversationId = this._getConversationId(span);
+        const toolName = span.entityName || span.name || "tool";
+        const otelSpan = this._createSpan(span, toolName);
+        otelSpan.setAttribute("gen_ai.tool.name", toolName);
+        otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
+        otelSpan.setAttribute("openinference.span.kind", "TOOL");
+        if (span.input != null) {
+            otelSpan.setAttribute("gen_ai.tool.input", typeof span.input === "string"
+                ? span.input
+                : JSON.stringify(span.input));
+        }
+        if (span.output != null) {
+            otelSpan.setAttribute("gen_ai.tool.output", typeof span.output === "string"
+                ? span.output
+                : JSON.stringify(span.output));
+        }
+        otelSpan.end(span.endTime || new Date());
+    }
+    // -------------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------------
+    _getConversationId(span) {
+        const metaConvId = span.metadata?.["gen_ai.conversation.id"];
+        if (metaConvId)
+            return metaConvId;
+        const attrs = span.attributes;
+        const attrConvId = attrs?.["conversationId"];
+        if (attrConvId)
+            return attrConvId;
+        const traceId = span.traceId;
+        if (!this._conversationIds.has(traceId)) {
+            this._conversationIds.set(traceId, `intro_conv_${randomUUID().replace(/-/g, "")}`);
+        }
+        return this._conversationIds.get(traceId);
+    }
+    _convertInput(input) {
+        if (!input)
+            return [];
+        if (Array.isArray(input)) {
+            const result = [];
+            for (const m of input) {
+                const msg = m;
+                if (!msg)
+                    continue;
+                // Skip system messages (handled separately)
+                if (msg.role === "system")
+                    continue;
+                // Standard role-based messages (AIv4 uses msg.content; AIv5 may use msg.parts)
+                if (msg.role) {
+                    const parts = msg.content != null
+                        ? this._extractParts(msg.content)
+                        : Array.isArray(msg.parts)
+                            ? this._extractParts(msg.parts)
+                            : [];
+                    result.push({
+                        role: msg.role,
+                        parts,
+                    });
+                    continue;
+                }
+                // OpenAI Responses API: function_call_output (no role, has type)
+                if (msg.type === "function_call_output") {
+                    result.push({
+                        role: "tool",
+                        parts: [
+                            {
+                                type: "tool_call_response",
+                                id: (msg.call_id || ""),
+                                response: typeof msg.output === "string"
+                                    ? msg.output
+                                    : JSON.stringify(msg.output),
+                            },
+                        ],
+                    });
+                    continue;
+                }
+                // item_reference — skip (OpenAI internal reference)
+                if (msg.type === "item_reference")
+                    continue;
+            }
+            return result;
+        }
+        if (typeof input === "string") {
+            return [{ role: "user", parts: [{ type: "text", content: input }] }];
+        }
+        return [];
+    }
+    _convertOutput(output, finishReason) {
+        if (!output)
+            return [];
+        const parts = [];
+        if (typeof output === "string") {
+            parts.push({ type: "text", content: output });
+        }
+        else if (typeof output === "object" && output !== null) {
+            const out = output;
+            // Reasoning
+            if (Array.isArray(out.reasoning)) {
+                for (const r of out.reasoning) {
+                    const text = (r.text || r.content || "");
+                    if (text)
+                        parts.push({ type: "thinking", content: text });
+                }
+            }
+            // Text
+            if (typeof out.text === "string" && out.text) {
+                parts.push({ type: "text", content: out.text });
+            }
+            // Tool calls
+            if (Array.isArray(out.toolCalls)) {
+                for (const tc of out.toolCalls) {
+                    parts.push({
+                        type: "tool_call",
+                        name: (tc.toolName || tc.name || ""),
+                        id: (tc.toolCallId || tc.id || ""),
+                        arguments: typeof tc.args === "string"
+                            ? tc.args
+                            : JSON.stringify(tc.args || tc.input),
+                    });
+                }
+            }
+        }
+        if (parts.length === 0)
+            return [];
+        return [{ role: "assistant", parts, finish_reason: finishReason }];
+    }
+    /** Extract plain text from a message content field (string, array of parts, or AIv5 parts). */
+    _extractTextContent(content) {
+        if (typeof content === "string")
+            return content;
+        if (Array.isArray(content)) {
+            return content
+                .map((p) => {
+                const part = p;
+                return typeof part.text === "string"
+                    ? part.text
+                    : typeof part.content === "string"
+                        ? part.content
+                        : "";
+            })
+                .filter(Boolean)
+                .join("\n");
+        }
+        return typeof content === "undefined" ? "" : JSON.stringify(content);
+    }
+    _extractParts(content) {
+        if (typeof content === "string") {
+            return [{ type: "text", content }];
+        }
+        if (Array.isArray(content)) {
+            return content
+                .map((part) => {
+                const p = part;
+                // Standard text
+                if (p.type === "text")
+                    return {
+                        type: "text",
+                        content: (p.text || p.content || ""),
+                    };
+                // OpenAI Responses API input_text format
+                if (p.type === "input_text")
+                    return {
+                        type: "text",
+                        content: (p.text || ""),
+                    };
+                // Tool call
+                if (p.type === "tool-call" ||
+                    p.type === "tool_call" ||
+                    p.type === "function_call")
+                    return {
+                        type: "tool_call",
+                        name: (p.toolName || p.name || ""),
+                        id: (p.toolCallId || p.id || p.call_id || ""),
+                        arguments: typeof p.args === "string"
+                            ? p.args
+                            : typeof p.arguments === "string"
+                                ? p.arguments
+                                : JSON.stringify(p.args || p.arguments || p.input),
+                    };
+                // Tool result
+                if (p.type === "tool-result" ||
+                    p.type === "tool_call_response" ||
+                    p.type === "function_call_output")
+                    return {
+                        type: "tool_call_response",
+                        id: (p.toolCallId || p.id || p.call_id || ""),
+                        response: typeof p.result === "string"
+                            ? p.result
+                            : typeof p.output === "string"
+                                ? p.output
+                                : JSON.stringify(p.result || p.output),
+                    };
+                // item_reference (OpenAI Responses API) — skip
+                if (p.type === "item_reference")
+                    return null;
+                return { type: "text", content: JSON.stringify(p) };
+            })
+                .filter((p) => p !== null);
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=mastra-exporter.js.map

package/dist/otel/mastra-exporter.js.map

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

package/dist/otel/pi.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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 type { Agent } from "@mariozechner/pi-agent-core";
+import { type AgentMeta } from "@introspection-sdk/introspection-pi";
+export type { AgentMeta } from "@introspection-sdk/introspection-pi";
+export interface IntrospectionPiInstrumentorOptions {
+    /** Tracer name used for all spans produced by this instrumentor. */
+    tracerName?: string;
+}
+/**
+ * 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 declare class IntrospectionPiInstrumentor {
+    private _tracer;
+    private _instrumentations;
+    constructor(opts?: IntrospectionPiInstrumentorOptions);
+    /**
+     * 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: Agent, meta: AgentMeta): void;
+    /**
+     * Unsubscribe all active tool instrumentations and finalize any open spans.
+     */
+    stop(): void;
+}
+//# sourceMappingURL=pi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pi.d.ts","sourceRoot":"","sources":["../../src/otel/pi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAGL,KAAK,SAAS,EAEf,MAAM,qCAAqC,CAAC;AAG7C,YAAY,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,MAAM,WAAW,kCAAkC;IACjD,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,iBAAiB,CAA8B;gBAE3C,IAAI,GAAE,kCAAuC;IAOzD;;;;;;;;OAQG;IACH,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAU/C;;OAEG;IACH,IAAI,IAAI,IAAI;CAIb"}