@introspection-sdk/introspection-node 0.4.1 → 0.4.3

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":"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"}

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

@@ -0,0 +1,87 @@
+/**
+ * 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 type { TracingEvent, InitExporterOptions } from "@mastra/core/observability";
+import { type SpanExporter, type IdGenerator } from "@opentelemetry/sdk-trace-base";
+/** Advanced options for testing and customization. */
+export interface MastraExporterAdvancedOptions {
+    /** Custom span exporter for testing. */
+    spanExporter?: SpanExporter;
+    /** Custom ID generator for testing. */
+    idGenerator?: IdGenerator;
+    /** Use SimpleSpanProcessor instead of BatchSpanProcessor. */
+    useSimpleSpanProcessor?: boolean;
+}
+/** Configuration for {@link IntrospectionMastraExporter}. */
+export interface IntrospectionMastraExporterOptions {
+    /** Authentication token (env: INTROSPECTION_TOKEN). */
+    token?: string;
+    /** Base URL for the API (env: INTROSPECTION_BASE_OTEL_URL). */
+    baseUrl?: string;
+    /** Additional headers to include in requests. */
+    additionalHeaders?: Record<string, string>;
+    /** Enable debug logging. */
+    debug?: boolean;
+    /** Advanced options for testing. */
+    advanced?: MastraExporterAdvancedOptions;
+}
+export declare class IntrospectionMastraExporter extends BaseExporter {
+    name: string;
+    private _options;
+    private _tracerProvider?;
+    private _tracer?;
+    private _conversationIds;
+    private _rootSpans;
+    constructor(options?: IntrospectionMastraExporterOptions);
+    /**
+     * Called by Mastra after the instance is fully configured.
+     * We defer TracerProvider creation to here so we can use the service name.
+     */
+    init(options: InitExporterOptions): void;
+    private _initProvider;
+    protected _exportTracingEvent(event: TracingEvent): Promise<void>;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    private _exportSpan;
+    /** 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. */
+    private _ensureRoot;
+    private _createSpan;
+    private _exportAgentRun;
+    private _exportModelStep;
+    private _exportToolCall;
+    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"}