@introspection-sdk/introspection-node 0.4.0 → 0.4.2

package/dist/langchain-handler.js

@@ -26,13 +26,13 @@
  * ```
  */
 import { BaseCallbackHandler } from "@langchain/core/callbacks/base";
-import { context as otelContext, trace as otelTrace, } from "@opentelemetry/api";
+import { context as otelContext, ROOT_CONTEXT, SpanStatusCode, 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 } from "./utils.js";
+import { logger, withOtlpHttpsProxy } from "./utils.js";
 import { VERSION } from "./version.js";
 // ---------------------------------------------------------------------------
 // Handler
@@ -49,11 +49,11 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
     _tracerProvider;
     _tracer;
     _spans = new Map();
-    _rootSpan = null;
     _conversationId;
     // Track span names and parents so children can resolve gen_ai.agent.name
     _spanNames = new Map();
     _spanParents = new Map();
+    _runRoots = new Map();
     // LangChain wrapper names to skip when resolving agent names
     static _wrapperNames = new Set([
         "RunnableSequence",
@@ -93,7 +93,7 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
                 ...options.additionalHeaders,
             };
             logger.info(`IntrospectionCallbackHandler initialized: endpoint=${endpoint}`);
-            const spanExporter = new OTLPTraceExporter({ url: endpoint, headers });
+            const spanExporter = new OTLPTraceExporter(withOtlpHttpsProxy({ url: endpoint, headers }));
             const effectiveBatchSize = token.startsWith("intro_dev") || token.startsWith("intro_staging")
                 ? 1
                 : undefined;
@@ -128,20 +128,29 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
         this._tracer = this._tracerProvider.getTracer("langchain", VERSION);
         this._conversationId = `intro_conv_${randomUUID().replace(/-/g, "")}`;
     }
-    /** Get or create a root span so all callbacks share the same traceId. */
-    _ensureRoot() {
-        if (!this._rootSpan) {
-            this._rootSpan = this._tracer.startSpan("langchain-run");
-            this._rootSpan.setAttribute("gen_ai.conversation.id", this._conversationId);
-        }
-        return this._rootSpan;
+    _rootRunId(runId, parentRunId) {
+        if (!parentRunId)
+            return runId;
+        return this._runRoots.get(parentRunId) || parentRunId;
+    }
+    /** Keep the top-level run span aligned with child conversation IDs. */
+    _setRootConversationId(conversationId, runId, parentRunId) {
+        const root = this._spans.get(this._rootRunId(runId, parentRunId));
+        root?.setAttribute("gen_ai.conversation.id", conversationId);
     }
-    /** Create a child span under the root (or under a parent if provided).
+    _endRootIfComplete(runId) {
+        this._runRoots.delete(runId);
+        this._spanNames.delete(runId);
+        this._spanParents.delete(runId);
+    }
+    /** Create a span under a LangChain parent when one exists.
      *  Sets gen_ai.agent.name to the parent span's name for hierarchy. */
     _createChildSpan(name, runId, parentRunId) {
-        const parent = (parentRunId ? this._spans.get(parentRunId) : undefined) ||
-            this._ensureRoot();
-        const ctx = otelTrace.setSpan(otelContext.active(), parent);
+        const parent = parentRunId ? this._spans.get(parentRunId) : undefined;
+        this._runRoots.set(runId, this._rootRunId(runId, parentRunId));
+        const ctx = parent
+            ? otelTrace.setSpan(otelContext.active(), parent)
+            : ROOT_CONTEXT;
         const span = this._tracer.startSpan(name, {}, ctx);
         this._spanNames.set(runId, name);
         if (parentRunId) {
@@ -163,6 +172,7 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
         const otelSpan = this._createChildSpan(spanName, runId, parentRunId);
         this._spans.set(runId, otelSpan);
         const conversationId = this._getConversationId(metadata);
+        this._setRootConversationId(conversationId, runId, parentRunId);
         otelSpan.setAttribute("gen_ai.operation.name", "chat");
         otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
         otelSpan.setAttribute("openinference.span.kind", "LLM");
@@ -205,6 +215,7 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
         const otelSpan = this._createChildSpan(spanName, runId, parentRunId);
         this._spans.set(runId, otelSpan);
         const conversationId = this._getConversationId(metadata);
+        this._setRootConversationId(conversationId, runId, parentRunId);
         otelSpan.setAttribute("gen_ai.operation.name", "chat");
         otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
         otelSpan.setAttribute("openinference.span.kind", "LLM");
@@ -227,6 +238,7 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
         this._spans.delete(runId);
         this._spanNames.delete(runId);
         this._llmInputs.delete(runId);
+        this._endRootIfComplete(runId);
         const generations = output.generations?.[0];
         if (generations && generations.length > 0) {
             const parts = [];
@@ -290,8 +302,10 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
         this._spans.delete(runId);
         this._spanNames.delete(runId);
         this._llmInputs.delete(runId);
-        otelSpan.setAttribute("error", true);
-        otelSpan.setAttribute("error.message", err.message);
+        this._endRootIfComplete(runId);
+        otelSpan.recordException(err);
+        otelSpan.setStatus({ code: SpanStatusCode.ERROR, message: err.message });
+        otelSpan.setAttribute("exception.message", err.message);
         otelSpan.end();
     }
     // -------------------------------------------------------------------------
@@ -302,6 +316,7 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
         const otelSpan = this._createChildSpan(name, runId, parentRunId);
         this._spans.set(runId, otelSpan);
         const conversationId = this._getConversationId(metadata);
+        this._setRootConversationId(conversationId, runId, parentRunId);
         otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
     }
     handleChainEnd(_outputs, runId) {
@@ -309,6 +324,7 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
         if (!otelSpan)
             return;
         this._spans.delete(runId);
+        this._endRootIfComplete(runId);
         otelSpan.end();
     }
     handleChainError(err, runId) {
@@ -316,27 +332,32 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
         if (!otelSpan)
             return;
         this._spans.delete(runId);
-        otelSpan.setAttribute("error", true);
-        otelSpan.setAttribute("error.message", err.message);
+        this._endRootIfComplete(runId);
+        otelSpan.recordException(err);
+        otelSpan.setStatus({ code: SpanStatusCode.ERROR, message: err.message });
+        otelSpan.setAttribute("exception.message", err.message);
         otelSpan.end();
     }
     // -------------------------------------------------------------------------
     // Tool callbacks
     // -------------------------------------------------------------------------
-    handleToolStart(tool, input, runId, parentRunId, _tags, _metadata, runName) {
+    handleToolStart(tool, input, runId, parentRunId, _tags, metadata, runName) {
         const toolName = runName || tool?.name || tool?.id?.[tool.id.length - 1] || "tool";
         const otelSpan = this._createChildSpan(toolName, runId, parentRunId);
         this._spans.set(runId, otelSpan);
+        const conversationId = this._getConversationId(metadata);
+        this._setRootConversationId(conversationId, runId, parentRunId);
         otelSpan.setAttribute("gen_ai.tool.name", toolName);
         otelSpan.setAttribute("openinference.span.kind", "TOOL");
         otelSpan.setAttribute("gen_ai.tool.input", input);
-        otelSpan.setAttribute("gen_ai.conversation.id", this._conversationId);
+        otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
     }
     handleToolEnd(output, runId) {
         const otelSpan = this._spans.get(runId);
         if (!otelSpan)
             return;
         this._spans.delete(runId);
+        this._endRootIfComplete(runId);
         if (output != null) {
             otelSpan.setAttribute("gen_ai.tool.output", typeof output === "string" ? output : JSON.stringify(output));
         }
@@ -347,8 +368,10 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
         if (!otelSpan)
             return;
         this._spans.delete(runId);
-        otelSpan.setAttribute("error", true);
-        otelSpan.setAttribute("error.message", err.message);
+        this._endRootIfComplete(runId);
+        otelSpan.recordException(err);
+        otelSpan.setStatus({ code: SpanStatusCode.ERROR, message: err.message });
+        otelSpan.setAttribute("exception.message", err.message);
         otelSpan.end();
     }
     // -------------------------------------------------------------------------
@@ -358,10 +381,9 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
         for (const span of this._spans.values())
             span.end();
         this._spans.clear();
-        if (this._rootSpan) {
-            this._rootSpan.end();
-            this._rootSpan = null;
-        }
+        this._spanNames.clear();
+        this._spanParents.clear();
+        this._runRoots.clear();
         await this._tracerProvider.shutdown();
     }
     async forceFlush() {
@@ -408,7 +430,14 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
     }
     _getConversationId(metadata) {
         const metaConvId = metadata?.["gen_ai.conversation.id"];
-        return metaConvId || this._conversationId;
+        if (metaConvId !== undefined && metaConvId !== null) {
+            return String(metaConvId);
+        }
+        const threadId = metadata?.["thread_id"];
+        if (threadId !== undefined && threadId !== null) {
+            return String(threadId);
+        }
+        return this._conversationId;
     }
     _convertMessages(messages) {
         const inputMessages = [];

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

@@ -1 +1 @@
-{"version":3,"file":"mastra-exporter.d.ts","sourceRoot":"","sources":["../src/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,0DAA0D;IAC1D,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;cA0EL,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;IAoCvB,OAAO,CAAC,gBAAgB;IA+HxB,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,aAAa;IAiDrB,OAAO,CAAC,cAAc;IA6CtB,OAAO,CAAC,aAAa;CA6DtB"}
+{"version":3,"file":"mastra-exporter.d.ts","sourceRoot":"","sources":["../src/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,0DAA0D;IAC1D,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;IAoCvB,OAAO,CAAC,gBAAgB;IA+HxB,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,aAAa;IAiDrB,OAAO,CAAC,cAAc;IA6CtB,OAAO,CAAC,aAAa;CA6DtB"}

package/dist/mastra-exporter.js

@@ -33,7 +33,7 @@ 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 } from "./utils.js";
+import { logger, withOtlpHttpsProxy } from "./utils.js";
 import { VERSION } from "./version.js";
 // ---------------------------------------------------------------------------
 // Exporter
@@ -101,7 +101,7 @@ export class IntrospectionMastraExporter extends BaseExporter {
                 Authorization: `Bearer ${token}`,
                 ...opts.additionalHeaders,
             };
-            const spanExporter = new OTLPTraceExporter({ url: endpoint, headers });
+            const spanExporter = new OTLPTraceExporter(withOtlpHttpsProxy({ url: endpoint, headers }));
             const effectiveBatchSize = token.startsWith("intro_dev") || token.startsWith("intro_staging")
                 ? 1
                 : undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"span-processor.d.ts","sourceRoot":"","sources":["../src/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,YAAY,CAAC;AA2FlD,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;IAwH3D;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI;IAIjD;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IA2H/B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}
+{"version":3,"file":"span-processor.d.ts","sourceRoot":"","sources":["../src/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,YAAY,CAAC;AA8FlD,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;IA2H/B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/span-processor.js

@@ -5,7 +5,7 @@ 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 } from "./utils.js";
+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
@@ -32,6 +32,9 @@ class ConvertedReadableSpan {
     spanContext() {
         return this._original.spanContext();
     }
+    get parentSpanContext() {
+        return this._original.parentSpanContext;
+    }
     get startTime() {
         return this._original.startTime;
     }
@@ -117,10 +120,10 @@ export class IntrospectionSpanProcessor {
         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({
+            new OTLPTraceExporter(withOtlpHttpsProxy({
                 url: endpoint,
                 headers,
-            });
+            }));
         // Wrap exporter to add v1/v2 compatibility and basic validation
         const exporter = {
             export: (spans, resultCallback) => {

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

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

package/dist/tracing-processor.js

@@ -11,7 +11,7 @@ import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
 import { randomUUID } from "crypto";
 import { convertResponsesInputsToSemconv, convertResponsesOutputsToSemconv, convertResponsesToolsToSemconv, convertResponsesInstructionsToSemconv, } from "./converters/openai.js";
-import { logger } from "./utils.js";
+import { logger, withOtlpHttpsProxy } from "./utils.js";
 import { VERSION } from "./version.js";
 /**
  * {@link TracingProcessor} that forwards OpenAI agent traces to the
@@ -63,10 +63,10 @@ export class IntrospectionTracingProcessor {
                 : `${baseUrl.replace(/\/$/, "")}/v1/traces`;
             logger.info(`IntrospectionTracingProcessor initialized: endpoint=${endpoint}`);
             // Setup OTLP exporter
-            const spanExporter = new OTLPTraceExporter({
+            const spanExporter = new OTLPTraceExporter(withOtlpHttpsProxy({
                 url: endpoint,
                 headers,
-            });
+            }));
             // Use SimpleSpanProcessor for maxExportBatchSize=1 (sequential export),
             // otherwise BatchSpanProcessor with configurable batch size.
             // Default to sequential export for dev/staging tokens.

package/dist/utils.d.ts

@@ -1,4 +1,5 @@
 import { DiagLogger } from "@opentelemetry/api";
+export declare function withOtlpHttpsProxy<T extends object>(options: T): T;
 /**
  * Logger for introspection-sdk package.
  * Uses OpenTelemetry's diagnostic logger.

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;GAGG;AACH,cAAM,mBAAoB,YAAW,UAAU;IAC7C,OAAO,CAAC,QAAQ,CAAe;;IAS/B,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,SAAS;IAIjB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/B,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAKlC;AAED,eAAO,MAAM,MAAM,qBAA4B,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAO9D,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAQlE;AAED;;;GAGG;AACH,cAAM,mBAAoB,YAAW,UAAU;IAC7C,OAAO,CAAC,QAAQ,CAAe;;IAS/B,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,SAAS;IAIjB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/B,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAKlC;AAED,eAAO,MAAM,MAAM,qBAA4B,CAAC"}

package/dist/utils.js

@@ -1,4 +1,17 @@
 import { DiagLogLevel } from "@opentelemetry/api";
+import { HttpsProxyAgent } from "https-proxy-agent";
+function getHttpsProxyUrl() {
+    return process.env.HTTPS_PROXY || undefined;
+}
+export function withOtlpHttpsProxy(options) {
+    const proxyUrl = getHttpsProxyUrl();
+    if (!proxyUrl)
+        return options;
+    return {
+        ...options,
+        httpAgentOptions: () => new HttpsProxyAgent(proxyUrl),
+    };
+}
 /**
  * Logger for introspection-sdk package.
  * Uses OpenTelemetry's diagnostic logger.

package/package.json

@@ -1,6 +1,8 @@
 {
   "name": "@introspection-sdk/introspection-node",
-  "version": "0.4.0",
+  "version": "0.4.2",
+  "license": "Apache-2.0",
+  "description": "Introspection observability SDK for Node.js",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -19,13 +21,13 @@
     }
   },
   "devDependencies": {
-    "@openai/agents": "^0.7.2",
+    "@openai/agents": "^0.11.4",
     "@types/node": "^22.15.3",
     "eslint": "^9.39.1",
-    "@langchain/core": "^1.0.0",
-    "@mastra/core": "^1.13.2",
-    "@mastra/observability": "^1.5.0",
-    "openai": "^6.29.0",
+    "@langchain/core": "^1.1.46",
+    "@mastra/core": "^1.33.0",
+    "@mastra/observability": "^1.12.0",
+    "openai": "^6.37.0",
     "typescript": "5.9.3",
     "@repo/eslint-config": "0.0.0",
     "@repo/typescript-config": "0.0.0"
@@ -59,16 +61,17 @@
     }
   },
   "dependencies": {
-    "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/api-logs": "^0.213.0",
-    "@opentelemetry/core": "^2.6.0",
-    "@opentelemetry/exporter-logs-otlp-proto": "^0.213.0",
-    "@opentelemetry/exporter-trace-otlp-proto": "^0.213.0",
-    "@opentelemetry/resources": "^2.6.0",
-    "@opentelemetry/sdk-logs": "^0.213.0",
-    "@opentelemetry/sdk-trace-base": "^2.6.0",
-    "@opentelemetry/semantic-conventions": "^1.40.0",
-    "@introspection-sdk/types": "0.4.0"
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/api-logs": "^0.217.0",
+    "@opentelemetry/core": "^2.7.1",
+    "@opentelemetry/exporter-logs-otlp-proto": "^0.217.0",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0.217.0",
+    "@opentelemetry/resources": "^2.7.1",
+    "@opentelemetry/sdk-logs": "^0.217.0",
+    "@opentelemetry/sdk-trace-base": "^2.7.1",
+    "@opentelemetry/semantic-conventions": "^1.41.1",
+    "https-proxy-agent": "^7.0.6",
+    "@introspection-sdk/types": "0.4.2"
   },
   "scripts": {
     "lint": "eslint . --max-warnings 0",

package/src/ai-sdk-integration.ts

@@ -55,8 +55,8 @@ import {
   buildOutputMessages,
   convertToolsToToolDefinitions,
 } from "./converters/ai-sdk.js";
-import type { InputMessage } from "./types/genai.js";
-import { logger } from "./utils.js";
+import type { InputMessage } from "@introspection-sdk/types";
+import { logger, withOtlpHttpsProxy } from "./utils.js";
 import { VERSION } from "./version.js";
 
 // ---------------------------------------------------------------------------
@@ -159,7 +159,9 @@ export class IntrospectionAISDKIntegration {
         `IntrospectionAISDKIntegration initialized: endpoint=${endpoint}`,
       );
 
-      const spanExporter = new OTLPTraceExporter({ url: endpoint, headers });
+      const spanExporter = new OTLPTraceExporter(
+        withOtlpHttpsProxy({ url: endpoint, headers }),
+      );
 
       // Use SimpleSpanProcessor for sequential export (dev/staging tokens)
       const effectiveBatchSize =

package/src/anthropic.ts

@@ -22,7 +22,7 @@ import type {
   OutputMessage,
   MessagePart,
   ReasoningPart,
-} from "./types/genai.js";
+} from "@introspection-sdk/types";
 
 import { trace, SpanKind, SpanStatusCode } from "@opentelemetry/api";
 import type { Tracer, Span } from "@opentelemetry/api";

package/src/claude-hooks.ts

@@ -28,7 +28,7 @@ import {
 } from "@opentelemetry/resources";
 import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
 
-import { logger } from "./utils.js";
+import { logger, withOtlpHttpsProxy } from "./utils.js";
 import { VERSION } from "./version.js";
 import {
   convertClaudeSessionToOtelAttributes,
@@ -372,10 +372,12 @@ export class IntrospectionClaudeHooks {
         `IntrospectionClaudeHooks initialized: service=${serviceName}, endpoint=${endpoint}`,
       );
 
-      const spanExporter = new OTLPTraceExporter({
-        url: endpoint,
-        headers,
-      });
+      const spanExporter = new OTLPTraceExporter(
+        withOtlpHttpsProxy({
+          url: endpoint,
+          headers,
+        }),
+      );
 
       // Default to sequential export for dev/staging tokens.
       const useSimple =

package/src/client.ts

@@ -18,7 +18,7 @@ import {
 } from "@opentelemetry/resources";
 import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
 import { propagation, context } from "@opentelemetry/api";
-import { logger as sdkLogger } from "./utils.js";
+import { logger as sdkLogger, withOtlpHttpsProxy } from "./utils.js";
 import { VERSION } from "./version.js";
 import {
   generateEventId,
@@ -86,10 +86,12 @@ export class IntrospectionClient {
     }
 
     // Create OTLP log exporter
-    const exporter = new OTLPLogExporter({
-      url: endpoint,
-      headers,
-    });
+    const exporter = new OTLPLogExporter(
+      withOtlpHttpsProxy({
+        url: endpoint,
+        headers,
+      }),
+    );
 
     // Create batch processor
     const processor = new BatchLogRecordProcessor(exporter, {

package/src/converters/ai-sdk.ts

@@ -14,7 +14,7 @@ import type {
   SystemInstruction,
   ToolDefinition,
   MessagePart,
-} from "../types/genai.js";
+} from "@introspection-sdk/types";
 
 // ---------------------------------------------------------------------------
 // Local types — minimal shapes matching AI SDK data structures.
@@ -192,7 +192,7 @@ export function convertToolsToToolDefinitions(
       name,
       description:
         typeof t.description === "string" ? t.description : undefined,
-      parameters: extractToolParameters(t.parameters),
+      parameters: extractToolParameters(t.inputSchema ?? t.parameters),
     });
   }
 
@@ -284,6 +284,31 @@ function extractToolParameters(
   if (!parameters || typeof parameters !== "object") return undefined;
   const p = parameters as Record<string, unknown>;
 
+  // Zod 4 schema — exposes a toJSONSchema() method.
+  if (typeof p.toJSONSchema === "function") {
+    const jsonSchema = p.toJSONSchema();
+    if (jsonSchema && typeof jsonSchema === "object") {
+      return jsonSchema as Record<string, unknown>;
+    }
+  }
+
+  // AI SDK v6 tools expose inputSchema instead of parameters. Zod-backed
+  // schemas usually carry a JSON Schema factory on this property.
+  if (p["~standard"] && typeof p["~standard"] === "object") {
+    const standard = p["~standard"] as Record<string, unknown>;
+    const standardJsonSchema = standard.jsonSchema;
+    if (standardJsonSchema && typeof standardJsonSchema === "object") {
+      const input = (standardJsonSchema as Record<string, unknown>).input;
+      if (typeof input === "function") {
+        const jsonSchema = input();
+        if (jsonSchema && typeof jsonSchema === "object") {
+          return jsonSchema as Record<string, unknown>;
+        }
+      }
+      return standardJsonSchema as Record<string, unknown>;
+    }
+  }
+
   // jsonSchema() wrapper — has a jsonSchema property
   if (p.jsonSchema && typeof p.jsonSchema === "object") {
     return p.jsonSchema as Record<string, unknown>;

package/src/converters/claude.ts

@@ -12,8 +12,8 @@ import type {
   ReasoningPart,
   GenAiAttributes,
   ToolDefinition,
-} from "../types/genai.js";
-import { toAttributes } from "../types/genai.js";
+} from "@introspection-sdk/types";
+import { toAttributes } from "@introspection-sdk/types";
 
 /** A plain-text content block from the Claude API. */
 export interface ClaudeTextBlock {
@@ -318,7 +318,7 @@ export function convertClaudeSessionToGenAI(
  */
 export function convertClaudeSessionToOtelAttributes(
   data: ClaudeSessionData,
-): Record<string, string | number> {
+): Record<string, string | number | string[] | number[]> {
   const genaiAttrs = convertClaudeSessionToGenAI(data);
   const result = toAttributes(genaiAttrs);
 

package/src/converters/openai.ts

@@ -14,7 +14,7 @@ import type {
   ReasoningPart,
   ToolDefinition,
   SystemInstruction,
-} from "../types/genai.js";
+} from "@introspection-sdk/types";
 
 /** Re-export OpenAI types used by callers (e.g. tracing-processor). */
 export type ResponseInputItem = Responses.ResponseInputItem;

package/src/converters/openinference.ts

@@ -7,8 +7,8 @@ import type {
   ReasoningPart,
   SystemInstruction,
   ToolDefinition,
-} from "../types/genai.js";
-import { toAttributes } from "../types/genai.js";
+} from "@introspection-sdk/types";
+import { toAttributes } from "@introspection-sdk/types";
 
 const OI = {
   MODEL_NAME: "llm.model_name",

package/src/index.ts

@@ -82,8 +82,8 @@ export type {
   ToolCallRequestPart,
   ToolCallResponsePart,
   MessagePart,
-} from "./types/genai.js";
-export { toAttributes } from "./types/genai.js";
+} from "@introspection-sdk/types";
+export { toAttributes } from "@introspection-sdk/types";
 
 // OpenAI converter exports
 export {