@introspection-sdk/introspection-node 0.4.1 → 0.4.3

package/dist/streaming.js

@@ -0,0 +1,67 @@
+/**
+ * Parse a `text/event-stream` Response into an async-iterable of SSE
+ * events. Minimal parser: handles `event:`, `data:` (multi-line),
+ * `id:`, `retry:`; ignores comments and unknown fields.
+ */
+export async function* parseSse(res) {
+    if (!res.body)
+        return;
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buf = "";
+    let event = "message";
+    let data = [];
+    let id;
+    let retry;
+    const flush = () => {
+        if (data.length === 0 && event === "message" && id === undefined)
+            return null;
+        const ev = { event, data: data.join("\n") };
+        if (id !== undefined)
+            ev.id = id;
+        if (retry !== undefined)
+            ev.retry = retry;
+        event = "message";
+        data = [];
+        id = undefined;
+        retry = undefined;
+        return ev;
+    };
+    while (true) {
+        const { value, done } = await reader.read();
+        if (done)
+            break;
+        buf += decoder.decode(value, { stream: true });
+        let nl;
+        while ((nl = buf.indexOf("\n")) >= 0) {
+            const line = buf.slice(0, nl).replace(/\r$/, "");
+            buf = buf.slice(nl + 1);
+            if (line === "") {
+                const ev = flush();
+                if (ev)
+                    yield ev;
+                continue;
+            }
+            if (line.startsWith(":"))
+                continue;
+            const colon = line.indexOf(":");
+            const field = colon < 0 ? line : line.slice(0, colon);
+            const valueRaw = colon < 0 ? "" : line.slice(colon + 1).replace(/^ /, "");
+            if (field === "event")
+                event = valueRaw;
+            else if (field === "data")
+                data.push(valueRaw);
+            else if (field === "id")
+                id = valueRaw;
+            else if (field === "retry") {
+                const n = Number(valueRaw);
+                if (Number.isFinite(n))
+                    retry = n;
+            }
+        }
+    }
+    const ev = flush();
+    if (ev)
+        yield ev;
+}
+//# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

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

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/types/genai.d.ts

@@ -0,0 +1,165 @@
+/**
+ * OTel Gen AI Semantic Convention types.
+ *
+ * These types represent the standardized format for gen_ai.input.messages
+ * and gen_ai.output.messages attributes as per OpenTelemetry Gen AI semantic conventions.
+ *
+ * @see https://opentelemetry.io/docs/specs/semconv/gen-ai/
+ */
+/**
+ * A text content part in a message.
+ *
+ * @example
+ * ```ts
+ * const part: TextPart = { type: "text", content: "Hello" };
+ * ```
+ */
+export interface TextPart {
+    /** Discriminator — always `"text"`. */
+    type: "text";
+    /** The text body of this part. */
+    content: string;
+}
+/**
+ * A tool / function-call request part in a message.
+ *
+ * @example
+ * ```ts
+ * const part: ToolCallRequestPart = { type: "tool_call", name: "get_weather", arguments: { city: "SF" } };
+ * ```
+ */
+export interface ToolCallRequestPart {
+    /** Discriminator — always `"tool_call"`. */
+    type: "tool_call";
+    /** Function / tool name. */
+    name: string;
+    /** Correlation ID linking request to response. */
+    id?: string;
+    /** Arguments passed to the tool. */
+    arguments?: unknown;
+}
+/**
+ * A tool / function-call response part in a message.
+ *
+ * @example
+ * ```ts
+ * const part: ToolCallResponsePart = { type: "tool_call_response", response: "72°F" };
+ * ```
+ */
+export interface ToolCallResponsePart {
+    /** Discriminator — always `"tool_call_response"`. */
+    type: "tool_call_response";
+    /** The value returned by the tool. */
+    response: unknown;
+    /** Correlation ID linking response to request. */
+    id?: string;
+}
+/**
+ * A reasoning / thinking content part in a message.
+ *
+ * @example
+ * ```ts
+ * const part: ReasoningPart = { type: "thinking", content: "Let me think through this..." };
+ * ```
+ */
+export interface ReasoningPart {
+    /** Discriminator — always `"thinking"`. */
+    type: "thinking";
+    /** The reasoning / thinking summary content. */
+    content?: string;
+    /** Encrypted reasoning signature (maps to OpenAI encrypted_content, Anthropic signature/redacted_thinking data). */
+    signature?: string;
+    /** Provider that produced this thinking block (e.g. `"anthropic"`, `"openai"`). Used to reconstruct the correct wire format on replay. */
+    provider_name?: string;
+}
+/** Union of all possible message-part shapes. */
+export type MessagePart = TextPart | ToolCallRequestPart | ToolCallResponsePart | ReasoningPart;
+/**
+ * A system instruction entry for `gen_ai.system_instructions`.
+ */
+export interface SystemInstruction {
+    /** Part type — always `"text"`. */
+    type: "text";
+    /** The instruction text content. */
+    content: string;
+}
+/**
+ * An input message in OTel Gen AI semantic convention format.
+ *
+ * Used for the `gen_ai.input.messages` span attribute.
+ */
+export interface InputMessage {
+    /** The role of the message sender. */
+    role: "system" | "user" | "assistant" | "tool";
+    /** Ordered content parts that compose this message. */
+    parts: MessagePart[];
+    /** Optional tool name when `role` is `"tool"`. */
+    name?: string;
+}
+/**
+ * An output message in OTel Gen AI semantic convention format.
+ *
+ * Used for the `gen_ai.output.messages` span attribute.
+ */
+export interface OutputMessage {
+    /** The role of the message sender. */
+    role: "system" | "user" | "assistant" | "tool";
+    /** Ordered content parts that compose this message. */
+    parts: MessagePart[];
+    /** Model-reported finish reason (e.g. `"stop"`, `"end_turn"`). */
+    finish_reason?: string;
+    /** Optional tool name when `role` is `"tool"`. */
+    name?: string;
+}
+/**
+ * A tool definition for the `gen_ai.tool.definitions` attribute.
+ *
+ * @example
+ * ```ts
+ * const def: ToolDefinition = { name: "get_weather", description: "Get current weather" };
+ * ```
+ */
+export interface ToolDefinition {
+    /** Tool / function name. */
+    name: string;
+    /** Human-readable description of what the tool does. */
+    description?: string;
+    /** JSON Schema describing the tool's parameters. */
+    parameters?: Record<string, unknown>;
+}
+/**
+ * GenAI semantic convention attributes.
+ *
+ * This interface represents the standardized GenAI attributes that can be
+ * converted to OpenTelemetry semantic convention format (gen_ai.* with dots).
+ *
+ * All properties use camelCase following TypeScript conventions.
+ */
+export interface GenAiAttributes {
+    /** Model name (gen_ai.request.model) */
+    requestModel?: string;
+    /** System prompt (gen_ai.system) */
+    system?: string;
+    /** Operation name (gen_ai.operation.name) */
+    operationName?: string;
+    /** Tool definitions (gen_ai.tool.definitions) — serialized to JSON by {@link toAttributes}. */
+    toolDefinitions?: ToolDefinition[];
+    /** Input messages (gen_ai.input.messages) — serialized to JSON by {@link toAttributes}. */
+    inputMessages?: InputMessage[];
+    /** Output messages (gen_ai.output.messages) — serialized to JSON by {@link toAttributes}. */
+    outputMessages?: OutputMessage[];
+    /** System instructions (gen_ai.system_instructions) — serialized to JSON by {@link toAttributes}. */
+    systemInstructions?: SystemInstruction[];
+    /** Response ID (gen_ai.response.id) */
+    responseId?: string;
+    /** Input token count (gen_ai.usage.input_tokens) */
+    inputTokens?: number;
+    /** Output token count (gen_ai.usage.output_tokens) */
+    outputTokens?: number;
+    /** Cache creation input tokens (gen_ai.usage.cache_creation_input_tokens) */
+    cacheCreationInputTokens?: number;
+    /** Cache read input tokens (gen_ai.usage.cache_read_input_tokens) */
+    cacheReadInputTokens?: number;
+}
+export declare function toAttributes(attrs: GenAiAttributes): Record<string, string | number>;
+//# sourceMappingURL=genai.d.ts.map

package/dist/types/genai.d.ts.map

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

package/dist/types/genai.js

@@ -0,0 +1,82 @@
+/**
+ * OTel Gen AI Semantic Convention types.
+ *
+ * These types represent the standardized format for gen_ai.input.messages
+ * and gen_ai.output.messages attributes as per OpenTelemetry Gen AI semantic conventions.
+ *
+ * @see https://opentelemetry.io/docs/specs/semconv/gen-ai/
+ */
+/**
+ * Convert a {@link GenAiAttributes} object to an OTel-compatible attributes
+ * dictionary with `gen_ai.*` dot-notation keys.
+ *
+ * Properties that are `undefined` are omitted from the result.
+ *
+ * @param attrs - The camelCase {@link GenAiAttributes} to convert.
+ * @returns A flat `Record<string, string | number>` with OTel semconv keys.
+ *
+ * @example
+ * ```ts
+ * const otel = toAttributes({ requestModel: "gpt-4", inputTokens: 42 });
+ * // { "gen_ai.request.model": "gpt-4", "gen_ai.usage.input_tokens": 42 }
+ * ```
+ */
+/**
+ * Recursively strip `undefined` and `null` values from an object before
+ * JSON serialization.  Equivalent to Python's `model_dump(exclude_none=True)`.
+ */
+function stripNullish(obj) {
+    if (Array.isArray(obj))
+        return obj.map(stripNullish);
+    if (obj !== null && typeof obj === "object") {
+        const out = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (value !== undefined && value !== null) {
+                out[key] = stripNullish(value);
+            }
+        }
+        return out;
+    }
+    return obj;
+}
+export function toAttributes(attrs) {
+    const result = {};
+    if (attrs.requestModel !== undefined) {
+        result["gen_ai.request.model"] = attrs.requestModel;
+    }
+    if (attrs.system !== undefined) {
+        result["gen_ai.system"] = attrs.system;
+    }
+    if (attrs.operationName !== undefined) {
+        result["gen_ai.operation.name"] = attrs.operationName;
+    }
+    if (attrs.toolDefinitions !== undefined) {
+        result["gen_ai.tool.definitions"] = JSON.stringify(stripNullish(attrs.toolDefinitions));
+    }
+    if (attrs.inputMessages !== undefined) {
+        result["gen_ai.input.messages"] = JSON.stringify(stripNullish(attrs.inputMessages));
+    }
+    if (attrs.outputMessages !== undefined) {
+        result["gen_ai.output.messages"] = JSON.stringify(stripNullish(attrs.outputMessages));
+    }
+    if (attrs.systemInstructions !== undefined) {
+        result["gen_ai.system_instructions"] = JSON.stringify(stripNullish(attrs.systemInstructions));
+    }
+    if (attrs.responseId !== undefined) {
+        result["gen_ai.response.id"] = attrs.responseId;
+    }
+    if (attrs.inputTokens !== undefined) {
+        result["gen_ai.usage.input_tokens"] = attrs.inputTokens;
+    }
+    if (attrs.outputTokens !== undefined) {
+        result["gen_ai.usage.output_tokens"] = attrs.outputTokens;
+    }
+    if (attrs.cacheCreationInputTokens !== undefined) {
+        result["gen_ai.usage.cache_creation.input_tokens"] =
+            attrs.cacheCreationInputTokens;
+    }
+    if (attrs.cacheReadInputTokens !== undefined) {
+        result["gen_ai.usage.cache_read.input_tokens"] = attrs.cacheReadInputTokens;
+    }
+    return result;
+}

package/dist/types.js

@@ -1 +1,2 @@
 export { generateEventId } from "@introspection-sdk/types";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

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.
@@ -55,3 +68,4 @@ class IntrospectionLogger {
     }
 }
 export const logger = new IntrospectionLogger();
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAc,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,SAAS,gBAAgB;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,SAAS,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAmB,OAAU;IAC7D,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,IAAI,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC;IAE9B,OAAO;QACL,GAAG,OAAO;QACV,gBAAgB,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC;KACjD,CAAC;AACT,CAAC;AAED;;;GAGG;AACH,MAAM,mBAAmB;IACf,QAAQ,CAAe;IAE/B;QACE,MAAM,WAAW,GAAG,CAClB,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,MAAM,CAC9C,CAAC,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAEO,aAAa,CAAC,KAAa;QACjC,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,OAAO;gBACV,OAAO,YAAY,CAAC,KAAK,CAAC;YAC5B,KAAK,MAAM;gBACT,OAAO,YAAY,CAAC,IAAI,CAAC;YAC3B,KAAK,MAAM;gBACT,OAAO,YAAY,CAAC,IAAI,CAAC;YAC3B,KAAK,OAAO;gBACV,OAAO,YAAY,CAAC,KAAK,CAAC;YAC5B,KAAK,SAAS;gBACZ,OAAO,YAAY,CAAC,OAAO,CAAC;YAC9B;gBACE,OAAO,YAAY,CAAC,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,KAAmB;QACnC,OAAO,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,IAAe;QACxB,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC"}

package/dist/version.js

@@ -1,2 +1,3 @@
 /** Version information for introspection-sdk package. */
 export const VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@introspection-sdk/introspection-node",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "license": "Apache-2.0",
   "description": "Introspection observability SDK for Node.js",
   "type": "module",
@@ -11,26 +11,42 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./otel": {
+      "types": "./dist/otel/index.d.ts",
+      "default": "./dist/otel/index.js"
+    },
     "./mastra": {
-      "types": "./dist/mastra-exporter.d.ts",
-      "default": "./dist/mastra-exporter.js"
+      "types": "./dist/otel/mastra-exporter.d.ts",
+      "default": "./dist/otel/mastra-exporter.js"
     },
     "./langchain": {
-      "types": "./dist/langchain-handler.d.ts",
-      "default": "./dist/langchain-handler.js"
+      "types": "./dist/otel/langchain-handler.d.ts",
+      "default": "./dist/otel/langchain-handler.js"
     }
   },
   "devDependencies": {
-    "@openai/agents": "^0.7.2",
-    "@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",
+    "@openai/agents": "^0.11.5",
+    "@opentelemetry/api-logs": "^0.218.0",
+    "@opentelemetry/context-async-hooks": "^2.7.1",
+    "@opentelemetry/core": "^2.7.1",
+    "@opentelemetry/exporter-logs-otlp-proto": "^0.218.0",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",
+    "@opentelemetry/resources": "^2.7.1",
+    "@opentelemetry/sdk-logs": "^0.218.0",
+    "@opentelemetry/sdk-trace-base": "^2.7.1",
+    "@opentelemetry/sdk-trace-node": "^2.7.1",
+    "@opentelemetry/semantic-conventions": "^1.41.1",
+    "@types/node": "^22.19.19",
+    "eslint": "^9.39.4",
+    "@langchain/core": "^1.1.48",
+    "@mastra/core": "^1.37.1",
+    "@mastra/observability": "^1.14.0",
+    "@mariozechner/pi-agent-core": "^0.73.1",
+    "@mariozechner/pi-ai": "^0.73.1",
+    "openai": "^6.39.1",
     "typescript": "5.9.3",
-    "@repo/eslint-config": "0.0.0",
-    "@repo/typescript-config": "0.0.0"
+    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-config": "0.0.0"
   },
   "peerDependencies": {
     "@openai/agents": ">=0.0.1",
@@ -38,7 +54,19 @@
     "ai": ">=4.0.0",
     "@mastra/core": ">=1.0.0",
     "@mastra/observability": ">=1.0.0",
-    "@langchain/core": ">=0.3.0"
+    "@langchain/core": ">=0.3.0",
+    "@mariozechner/pi-agent-core": ">=0.70.0",
+    "@mariozechner/pi-ai": ">=0.70.0",
+    "@opentelemetry/api-logs": ">=0.50.0",
+    "@opentelemetry/context-async-hooks": ">=1.20.0 || >=2.0.0",
+    "@opentelemetry/core": ">=1.20.0 || >=2.0.0",
+    "@opentelemetry/exporter-logs-otlp-proto": ">=0.50.0",
+    "@opentelemetry/exporter-trace-otlp-proto": ">=0.50.0",
+    "@opentelemetry/resources": ">=1.20.0 || >=2.0.0",
+    "@opentelemetry/sdk-logs": ">=0.50.0",
+    "@opentelemetry/sdk-trace-base": ">=1.20.0 || >=2.0.0",
+    "@opentelemetry/sdk-trace-node": ">=1.20.0 || >=2.0.0",
+    "@opentelemetry/semantic-conventions": ">=1.20.0"
   },
   "peerDependenciesMeta": {
     "@openai/agents": {
@@ -58,19 +86,49 @@
     },
     "@langchain/core": {
       "optional": true
+    },
+    "@mariozechner/pi-agent-core": {
+      "optional": true
+    },
+    "@mariozechner/pi-ai": {
+      "optional": true
+    },
+    "@opentelemetry/api-logs": {
+      "optional": true
+    },
+    "@opentelemetry/context-async-hooks": {
+      "optional": true
+    },
+    "@opentelemetry/core": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-logs-otlp-proto": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-trace-otlp-proto": {
+      "optional": true
+    },
+    "@opentelemetry/resources": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-logs": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-trace-base": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-trace-node": {
+      "optional": true
+    },
+    "@opentelemetry/semantic-conventions": {
+      "optional": true
     }
   },
   "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.1"
+    "@opentelemetry/api": "^1.9.1",
+    "https-proxy-agent": "^7.0.6",
+    "@introspection-sdk/types": "0.4.3",
+    "@introspection-sdk/introspection-pi": "0.4.3"
   },
   "scripts": {
     "lint": "eslint . --max-warnings 0",