@introspection-sdk/introspection-node 0.4.2 → 0.4.4

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

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

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

package/dist/otel/logs.js

@@ -0,0 +1,271 @@
+/**
+ * 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 { SeverityNumber } from "@opentelemetry/api-logs";
+import { LoggerProvider, BatchLogRecordProcessor, } from "@opentelemetry/sdk-logs";
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-proto";
+import { resourceFromAttributes, defaultResource, } from "@opentelemetry/resources";
+import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
+import { propagation, context } from "@opentelemetry/api";
+import { logger as sdkLogger, withOtlpHttpsProxy } from "../utils.js";
+import { VERSION } from "../version.js";
+import { generateEventId, } from "../types.js";
+export class IntrospectionLogs {
+    loggerProvider;
+    otelLogger;
+    userId;
+    anonymousId;
+    traits = {};
+    constructor(options = {}) {
+        const token = options.token || process.env.INTROSPECTION_TOKEN || "";
+        const serviceName = options.serviceName ||
+            process.env.INTROSPECTION_SERVICE_NAME ||
+            "introspection-client";
+        const baseOtelUrl = options.baseOtelUrl ||
+            process.env.INTROSPECTION_BASE_OTEL_URL ||
+            "https://otel.introspection.dev";
+        if (!token) {
+            sdkLogger.warn("IntrospectionLogs: No token provided. Events will not be sent.");
+        }
+        // Construct endpoint URL for logs.
+        const endpoint = baseOtelUrl.endsWith("/v1/logs")
+            ? baseOtelUrl
+            : `${baseOtelUrl.replace(/\/$/, "")}/v1/logs`;
+        const headers = {
+            Authorization: `Bearer ${token}`,
+            ...(options.additionalHeaders || {}),
+        };
+        const exporter = new OTLPLogExporter(withOtlpHttpsProxy({
+            url: endpoint,
+            headers,
+        }));
+        const processor = new BatchLogRecordProcessor(exporter, {
+            maxQueueSize: options.maxBatchSize ?? 100,
+            scheduledDelayMillis: options.flushInterval ?? 5000,
+        });
+        const baseResource = defaultResource();
+        const introspectionResource = resourceFromAttributes({
+            [ATTR_SERVICE_NAME]: serviceName,
+        });
+        const resource = baseResource.merge(introspectionResource);
+        this.loggerProvider = new LoggerProvider({
+            resource,
+            processors: [processor],
+        });
+        this.otelLogger = this.loggerProvider.getLogger("@introspection-sdk/introspection-node", VERSION);
+        sdkLogger.info(`IntrospectionLogs initialized: service=${serviceName}, otlp=${endpoint}`);
+    }
+    /** Get gen_ai context from baggage */
+    getGenAiFromContext() {
+        const baggage = propagation.getBaggage(context.active());
+        return {
+            conversationId: baggage?.getEntry("gen_ai.conversation.id")?.value,
+            previousResponseId: baggage?.getEntry("gen_ai.request.previous_response_id")?.value,
+            agentName: baggage?.getEntry("gen_ai.agent.name")?.value,
+            agentId: baggage?.getEntry("gen_ai.agent.id")?.value,
+        };
+    }
+    /** Get identity from baggage or instance state */
+    getIdentityFromContext() {
+        const baggage = propagation.getBaggage(context.active());
+        return {
+            userId: baggage?.getEntry("identity.user_id")?.value || this.userId,
+            anonymousId: baggage?.getEntry("identity.anonymous_id")?.value || this.anonymousId,
+        };
+    }
+    getTimestamp() {
+        const hrTimeNs = process.hrtime.bigint();
+        const epochNs = BigInt(Date.now()) * BigInt(1_000_000);
+        const offsetNs = hrTimeNs - process.hrtime.bigint() + epochNs;
+        const seconds = Number(offsetNs / BigInt(1_000_000_000));
+        const nanos = Number(offsetNs % BigInt(1_000_000_000));
+        return [seconds, nanos];
+    }
+    buildAttributes(eventName, options = {}) {
+        const { properties, traits, conversationId, previousResponseId, eventId } = options;
+        const attributes = {
+            "event.name": eventName,
+            "event.id": eventId || generateEventId(),
+        };
+        const identity = this.getIdentityFromContext();
+        if (identity.userId)
+            attributes["identity.user.id"] = identity.userId;
+        if (identity.anonymousId)
+            attributes["identity.anonymous.id"] = identity.anonymousId;
+        const genAi = this.getGenAiFromContext();
+        const finalConversationId = conversationId || genAi.conversationId;
+        const finalPreviousResponseId = previousResponseId || genAi.previousResponseId;
+        if (finalConversationId)
+            attributes["gen_ai.conversation.id"] = finalConversationId;
+        if (finalPreviousResponseId)
+            attributes["gen_ai.request.previous_response_id"] =
+                finalPreviousResponseId;
+        if (genAi.agentName)
+            attributes["gen_ai.agent.name"] = genAi.agentName;
+        if (genAi.agentId)
+            attributes["gen_ai.agent.id"] = genAi.agentId;
+        if (properties) {
+            for (const [key, value] of Object.entries(properties)) {
+                if (value != null) {
+                    const attrKey = `properties.${key}`;
+                    if (typeof value === "object") {
+                        attributes[attrKey] = JSON.stringify(value);
+                    }
+                    else if (typeof value === "string" ||
+                        typeof value === "number" ||
+                        typeof value === "boolean") {
+                        attributes[attrKey] = value;
+                    }
+                }
+            }
+        }
+        if (traits) {
+            for (const [key, value] of Object.entries(traits)) {
+                if (value != null) {
+                    const attrKey = `context.traits.${key}`;
+                    if (typeof value === "object") {
+                        attributes[attrKey] = JSON.stringify(value);
+                    }
+                    else if (typeof value === "string" ||
+                        typeof value === "number" ||
+                        typeof value === "boolean") {
+                        attributes[attrKey] = value;
+                    }
+                }
+            }
+        }
+        return attributes;
+    }
+    track(eventName, properties, options) {
+        const attributes = this.buildAttributes(eventName, {
+            properties,
+            eventId: options?.eventId,
+        });
+        this.otelLogger.emit({
+            timestamp: this.getTimestamp(),
+            context: context.active(),
+            severityNumber: SeverityNumber.INFO,
+            severityText: "INFO",
+            attributes,
+        });
+        sdkLogger.debug(`Tracked: ${eventName}`);
+    }
+    feedback(name, options = {}) {
+        const { comments, conversationId, previousResponseId, eventId, ...extra } = options;
+        const properties = { name, ...extra };
+        if (comments)
+            properties.comments = comments;
+        const attributes = this.buildAttributes("introspection.feedback", {
+            properties,
+            conversationId: conversationId,
+            previousResponseId: previousResponseId,
+            eventId: eventId,
+        });
+        this.otelLogger.emit({
+            timestamp: this.getTimestamp(),
+            context: context.active(),
+            severityNumber: SeverityNumber.INFO,
+            severityText: "INFO",
+            attributes,
+        });
+        sdkLogger.debug(`Feedback: ${name}`);
+    }
+    identify(userId, traits, anonymousId, eventId) {
+        this.userId = userId;
+        if (anonymousId)
+            this.anonymousId = anonymousId;
+        if (traits)
+            this.traits = { ...this.traits, ...traits };
+        const attributes = this.buildAttributes("identify", { traits, eventId });
+        this.otelLogger.emit({
+            timestamp: this.getTimestamp(),
+            context: context.active(),
+            severityNumber: SeverityNumber.INFO,
+            severityText: "INFO",
+            attributes,
+        });
+        sdkLogger.debug(`Identified: ${userId}`);
+    }
+    createBaggageContext(values) {
+        const ctx = context.active();
+        let bag = propagation.getBaggage(ctx) || propagation.createBaggage();
+        for (const [key, value] of Object.entries(values)) {
+            bag = bag.setEntry(key, { value });
+        }
+        return propagation.setBaggage(ctx, bag);
+    }
+    async withBaggage(values, callback) {
+        const ctx = this.createBaggageContext(values);
+        return await context.with(ctx, callback);
+    }
+    async withAgent(agentName, agentId, callback) {
+        const values = { "gen_ai.agent.name": agentName };
+        if (agentId)
+            values["gen_ai.agent.id"] = agentId;
+        return await context.with(this.createBaggageContext(values), callback);
+    }
+    async withConversation(conversationId, previousResponseId, callback) {
+        const values = {};
+        if (conversationId)
+            values["gen_ai.conversation.id"] = conversationId;
+        if (previousResponseId)
+            values["gen_ai.request.previous_response_id"] = previousResponseId;
+        return await context.with(this.createBaggageContext(values), callback);
+    }
+    setUserId(userId) {
+        this.userId = userId;
+    }
+    setAnonymousId(anonymousId) {
+        this.anonymousId = anonymousId;
+    }
+    async withUserId(userId, callback) {
+        return await context.with(this.createBaggageContext({ "identity.user_id": userId }), callback);
+    }
+    async withAnonymousId(anonymousId, callback) {
+        return await context.with(this.createBaggageContext({ "identity.anonymous_id": anonymousId }), callback);
+    }
+    getAnonymousId() {
+        return this.anonymousId;
+    }
+    reset() {
+        this.userId = undefined;
+        this.anonymousId = undefined;
+        this.traits = {};
+        sdkLogger.debug("IntrospectionLogs state reset");
+    }
+    async flush() {
+        await this.loggerProvider.forceFlush();
+        sdkLogger.debug("Flushed pending log records");
+    }
+    async shutdown() {
+        await this.loggerProvider.shutdown();
+        sdkLogger.debug("IntrospectionLogs shutdown complete");
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/otel/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/otel/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,cAAc,EAAsB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EACL,sBAAsB,EACtB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EACL,eAAe,GAKhB,MAAM,aAAa,CAAC;AAuBrB,MAAM,OAAO,iBAAiB;IACpB,cAAc,CAAiB;IAC/B,UAAU,CAA0C;IACpD,MAAM,CAAqB;IAC3B,WAAW,CAAqB;IAChC,MAAM,GAA4B,EAAE,CAAC;IAE7C,YAAY,UAAoC,EAAE;QAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC;QACrE,MAAM,WAAW,GACf,OAAO,CAAC,WAAW;YACnB,OAAO,CAAC,GAAG,CAAC,0BAA0B;YACtC,sBAAsB,CAAC;QACzB,MAAM,WAAW,GACf,OAAO,CAAC,WAAW;YACnB,OAAO,CAAC,GAAG,CAAC,2BAA2B;YACvC,gCAAgC,CAAC;QAEnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,CAAC,IAAI,CACZ,gEAAgE,CACjE,CAAC;QACJ,CAAC;QAED,mCAAmC;QACnC,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC/C,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC;QAEhD,MAAM,OAAO,GAA2B;YACtC,aAAa,EAAE,UAAU,KAAK,EAAE;YAChC,GAAG,CAAC,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC;SACrC,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,eAAe,CAClC,kBAAkB,CAAC;YACjB,GAAG,EAAE,QAAQ;YACb,OAAO;SACR,CAAC,CACH,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,uBAAuB,CAAC,QAAQ,EAAE;YACtD,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,GAAG;YACzC,oBAAoB,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;SACpD,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;YACnD,CAAC,iBAAiB,CAAC,EAAE,WAAW;SACjC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAE3D,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC;YACvC,QAAQ;YACR,UAAU,EAAE,CAAC,SAAS,CAAC;SACxB,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAC7C,uCAAuC,EACvC,OAAO,CACR,CAAC;QAEF,SAAS,CAAC,IAAI,CACZ,0CAA0C,WAAW,UAAU,QAAQ,EAAE,CAC1E,CAAC;IACJ,CAAC;IAED,sCAAsC;IAC9B,mBAAmB;QACzB,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACzD,OAAO;YACL,cAAc,EAAE,OAAO,EAAE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,KAAK;YAClE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,CACnC,qCAAqC,CACtC,EAAE,KAAK;YACR,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,KAAK;YACxD,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,KAAK;SACrD,CAAC;IACJ,CAAC;IAED,kDAAkD;IAC1C,sBAAsB;QAC5B,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACzD,OAAO;YACL,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,MAAM;YACnE,WAAW,EACT,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,WAAW;SACxE,CAAC;IACJ,CAAC;IAEO,YAAY;QAClB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC;IAEO,eAAe,CACrB,SAAiB,EACjB,UAMI,EAAE;QAEN,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE,OAAO,EAAE,GACvE,OAAO,CAAC;QAEV,MAAM,UAAU,GAAkB;YAChC,YAAY,EAAE,SAAS;YACvB,UAAU,EAAE,OAAO,IAAI,eAAe,EAAE;SACzC,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC/C,IAAI,QAAQ,CAAC,MAAM;YAAE,UAAU,CAAC,kBAAkB,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;QACtE,IAAI,QAAQ,CAAC,WAAW;YACtB,UAAU,CAAC,uBAAuB,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC;QAE7D,MAAM,KAAK,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzC,MAAM,mBAAmB,GAAG,cAAc,IAAI,KAAK,CAAC,cAAc,CAAC;QACnE,MAAM,uBAAuB,GAC3B,kBAAkB,IAAI,KAAK,CAAC,kBAAkB,CAAC;QAEjD,IAAI,mBAAmB;YACrB,UAAU,CAAC,wBAAwB,CAAC,GAAG,mBAAmB,CAAC;QAC7D,IAAI,uBAAuB;YACzB,UAAU,CAAC,qCAAqC,CAAC;gBAC/C,uBAAuB,CAAC;QAC5B,IAAI,KAAK,CAAC,SAAS;YAAE,UAAU,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QACvE,IAAI,KAAK,CAAC,OAAO;YAAE,UAAU,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;QAEjE,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;oBAClB,MAAM,OAAO,GAAG,cAAc,GAAG,EAAE,CAAC;oBACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;wBAC9B,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;oBAC9C,CAAC;yBAAM,IACL,OAAO,KAAK,KAAK,QAAQ;wBACzB,OAAO,KAAK,KAAK,QAAQ;wBACzB,OAAO,KAAK,KAAK,SAAS,EAC1B,CAAC;wBACD,UAAU,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;oBAC9B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;oBAClB,MAAM,OAAO,GAAG,kBAAkB,GAAG,EAAE,CAAC;oBACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;wBAC9B,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;oBAC9C,CAAC;yBAAM,IACL,OAAO,KAAK,KAAK,QAAQ;wBACzB,OAAO,KAAK,KAAK,QAAQ;wBACzB,OAAO,KAAK,KAAK,SAAS,EAC1B,CAAC;wBACD,UAAU,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;oBAC9B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,KAAK,CACH,SAAiB,EACjB,UAAoC,EACpC,OAA8B;QAE9B,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE;YACjD,UAAU;YACV,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACnB,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE;YAC9B,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE;YACzB,cAAc,EAAE,cAAc,CAAC,IAAI;YACnC,YAAY,EAAE,MAAM;YACpB,UAAU;SACX,CAAC,CAAC;QACH,SAAS,CAAC,KAAK,CAAC,YAAY,SAAS,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,UAA2B,EAAE;QAClD,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,GACvE,OAAO,CAAC;QACV,MAAM,UAAU,GAA4B,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;QAC/D,IAAI,QAAQ;YAAE,UAAU,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,wBAAwB,EAAE;YAChE,UAAU;YACV,cAAc,EAAE,cAAoC;YACpD,kBAAkB,EAAE,kBAAwC;YAC5D,OAAO,EAAE,OAA6B;SACvC,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACnB,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE;YAC9B,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE;YACzB,cAAc,EAAE,cAAc,CAAC,IAAI;YACnC,YAAY,EAAE,MAAM;YACpB,UAAU;SACX,CAAC,CAAC;QACH,SAAS,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ,CACN,MAAc,EACd,MAAmB,EACnB,WAAoB,EACpB,OAAgB;QAEhB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,WAAW;YAAE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAChD,IAAI,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACnB,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE;YAC9B,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE;YACzB,cAAc,EAAE,cAAc,CAAC,IAAI;YACnC,YAAY,EAAE,MAAM;YACpB,UAAU;SACX,CAAC,CAAC;QACH,SAAS,CAAC,KAAK,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,oBAAoB,CAAC,MAA8B;QACjD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC7B,IAAI,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,aAAa,EAAE,CAAC;QACrE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,WAAW,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,WAAW,CACf,MAA8B,EAC9B,QAA8B;QAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC9C,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,SAAS,CACb,SAAiB,EACjB,OAA2B,EAC3B,QAA8B;QAE9B,MAAM,MAAM,GAA2B,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC;QAC1E,IAAI,OAAO;YAAE,MAAM,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC;QACjD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,cAAkC,EAClC,kBAAsC,EACtC,QAA8B;QAE9B,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,cAAc;YAAE,MAAM,CAAC,wBAAwB,CAAC,GAAG,cAAc,CAAC;QACtE,IAAI,kBAAkB;YACpB,MAAM,CAAC,qCAAqC,CAAC,GAAG,kBAAkB,CAAC;QACrE,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,cAAc,CAAC,WAAmB;QAChC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,UAAU,CACd,MAAc,EACd,QAA8B;QAE9B,OAAO,MAAM,OAAO,CAAC,IAAI,CACvB,IAAI,CAAC,oBAAoB,CAAC,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,EACzD,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,WAAmB,EACnB,QAA8B;QAE9B,OAAO,MAAM,OAAO,CAAC,IAAI,CACvB,IAAI,CAAC,oBAAoB,CAAC,EAAE,uBAAuB,EAAE,WAAW,EAAE,CAAC,EACnE,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,SAAS,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;QACvC,SAAS,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;QACrC,SAAS,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/{mastra-exporter.d.ts → otel/mastra-exporter.d.ts}

@@ -42,7 +42,7 @@ export interface MastraExporterAdvancedOptions {
 export interface IntrospectionMastraExporterOptions {
     /** Authentication token (env: INTROSPECTION_TOKEN). */
     token?: string;
-    /** Base URL for the API (env: INTROSPECTION_BASE_URL). */
+    /** Base URL for the API (env: INTROSPECTION_BASE_OTEL_URL). */
     baseUrl?: string;
     /** Additional headers to include in requests. */
     additionalHeaders?: Record<string, string>;
@@ -80,6 +80,8 @@ export declare class IntrospectionMastraExporter extends BaseExporter {
     private _getConversationId;
     private _convertInput;
     private _convertOutput;
+    /** Extract plain text from a message content field (string, array of parts, or AIv5 parts). */
+    private _extractTextContent;
     private _extractParts;
 }
 //# sourceMappingURL=mastra-exporter.d.ts.map

package/dist/otel/mastra-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mastra-exporter.d.ts","sourceRoot":"","sources":["../../src/otel/mastra-exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,+BAA+B,CAAC;AAkBvC,sDAAsD;AACtD,MAAM,WAAW,6BAA6B;IAC5C,wCAAwC;IACxC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uCAAuC;IACvC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,6DAA6D;IAC7D,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,6DAA6D;AAC7D,MAAM,WAAW,kCAAkC;IACjD,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,4BAA4B;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,6BAA6B,CAAC;CAC1C;AAMD,qBAAa,2BAA4B,SAAQ,YAAY;IAC3D,IAAI,SAAmB;IAEvB,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,eAAe,CAAC,CAAsB;IAC9C,OAAO,CAAC,OAAO,CAAC,CAA+C;IAC/D,OAAO,CAAC,gBAAgB,CAAkC;IAE1D,OAAO,CAAC,UAAU,CAAoC;gBAE1C,OAAO,GAAE,kCAAuC;IAU5D;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IASxC,OAAO,CAAC,aAAa;cA4EL,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAajE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B,OAAO,CAAC,WAAW;IAsBnB;;4DAEwD;IACxD,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,eAAe;IAuDvB,OAAO,CAAC,gBAAgB;IAgJxB,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,aAAa;IAuDrB,OAAO,CAAC,cAAc;IA6CtB,+FAA+F;IAC/F,OAAO,CAAC,mBAAmB;IAkB3B,OAAO,CAAC,aAAa;CA6DtB"}

package/dist/{mastra-exporter.js → otel/mastra-exporter.js}

@@ -33,8 +33,8 @@ 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";
+import { logger, withOtlpHttpsProxy } from "../utils.js";
+import { VERSION } from "../version.js";
 // ---------------------------------------------------------------------------
 // Exporter
 // ---------------------------------------------------------------------------
@@ -91,7 +91,7 @@ export class IntrospectionMastraExporter extends BaseExporter {
             if (!token)
                 return;
             const baseUrl = opts.baseUrl ||
-                process.env.INTROSPECTION_BASE_URL ||
+                process.env.INTROSPECTION_BASE_OTEL_URL ||
                 "https://otel.introspection.dev";
             const endpoint = baseUrl.endsWith("/v1/traces")
                 ? baseUrl
@@ -196,7 +196,20 @@ export class IntrospectionMastraExporter extends BaseExporter {
         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");
-        if (attrs?.["instructions"] && typeof attrs["instructions"] === "string") {
+        // 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
@@ -234,29 +247,43 @@ export class IntrospectionMastraExporter extends BaseExporter {
             otelSpan.setAttribute("gen_ai.response.model", responseModel);
         if (responseId)
             otelSpan.setAttribute("gen_ai.response.id", responseId);
-        // Input messages — model_step has input.body.input (raw API messages)
+        // 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) {
-            const rawInput = span.input;
-            const body = rawInput?.body;
-            const apiMessages = body?.input ?? body?.messages;
-            if (Array.isArray(apiMessages)) {
+            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
+                // 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: typeof m.content === "string"
-                            ? m.content
-                            : JSON.stringify(m.content),
+                        content: this._extractTextContent(m.content),
                     }))));
                 }
             }
-            // Tool definitions from input.body.tools
-            const tools = body?.tools;
+            // 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",
@@ -283,6 +310,8 @@ export class IntrospectionMastraExporter extends BaseExporter {
             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"];
@@ -338,11 +367,16 @@ export class IntrospectionMastraExporter extends BaseExporter {
                 // Skip system messages (handled separately)
                 if (msg.role === "system")
                     continue;
-                // Standard role-based messages
+                // 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: this._extractParts(msg.content),
+                        parts,
                     });
                     continue;
                 }
@@ -412,6 +446,25 @@ export class IntrospectionMastraExporter extends BaseExporter {
             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 }];
@@ -469,3 +522,4 @@ export class IntrospectionMastraExporter extends BaseExporter {
         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