@microsoft/opentelemetry 0.1.0-alpha.1 → 0.1.0-alpha.2

package/dist/esm/genai/instrumentations/openai/openAIAgentsTraceInstrumentor.js

@@ -0,0 +1,146 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// Vendored from microsoft/Agent365-nodejs packages/agents-a365-observability-extensions-openai
+// Adapted: removed ObservabilityManager dependency, uses diag logger instead of A365 logger
+import { diag, trace } from "@opentelemetry/api";
+import { InstrumentationBase, } from "@opentelemetry/instrumentation";
+import { setTraceProcessors, setTracingDisabled } from "@openai/agents";
+import { OpenAIAgentsTraceProcessor } from "./openAIAgentsTraceProcessor.js";
+/**
+ * Internal singleton implementation.
+ */
+class OpenAIAgentsTraceInstrumentorImpl extends InstrumentationBase {
+    static _instance = null;
+    _hasBeenEnabled = false;
+    processor;
+    otelTracer;
+    constructor(config = {}) {
+        if (OpenAIAgentsTraceInstrumentorImpl._instance !== null) {
+            throw new Error("OpenAIAgentsTraceInstrumentor can only be instantiated once.");
+        }
+        super("microsoft-otel-openai-agents-instrumentor", "1.0.0", {
+            enabled: true,
+            ...config,
+        });
+        this.otelTracer = trace.getTracer("microsoft-otel-openai-agents", "1.0.0");
+        OpenAIAgentsTraceInstrumentorImpl._instance = this;
+        diag.info("[OpenAIAgentsTraceInstrumentor] Initialized");
+    }
+    static getInstance(config) {
+        if (!OpenAIAgentsTraceInstrumentorImpl._instance) {
+            OpenAIAgentsTraceInstrumentorImpl._instance = new OpenAIAgentsTraceInstrumentorImpl(config);
+        }
+        return OpenAIAgentsTraceInstrumentorImpl._instance;
+    }
+    static hasInstance() {
+        return OpenAIAgentsTraceInstrumentorImpl._instance !== null;
+    }
+    static resetInstance() {
+        const inst = OpenAIAgentsTraceInstrumentorImpl._instance;
+        if (inst) {
+            void inst.processor?.shutdown();
+            inst.processor = undefined;
+        }
+        OpenAIAgentsTraceInstrumentorImpl._instance = null;
+    }
+    init() {
+        return {
+            name: "@openai/agents",
+            supportedVersions: [">=0.1.5"],
+            files: [],
+        };
+    }
+    instrumentationDependencies() {
+        return ["@openai/agents >= 0.1.5"];
+    }
+    /**
+     * Enable instrumentation.
+     * Sets up the trace processor and registers it with the OpenAI Agents SDK.
+     */
+    enable() {
+        if (this._hasBeenEnabled) {
+            return;
+        }
+        this._hasBeenEnabled = true;
+        // Enable tracing in the OpenAI Agents SDK
+        setTracingDisabled(false);
+        this.processor = new OpenAIAgentsTraceProcessor(this.otelTracer, {
+            suppressInvokeAgentInput: this._config.suppressInvokeAgentInput ?? false,
+            isContentRecordingEnabled: this._config.isContentRecordingEnabled ?? false,
+        });
+        try {
+            setTraceProcessors([this.processor]);
+        }
+        catch (error) {
+            diag.error(`[OpenAIAgentsTraceInstrumentor] Failed to register trace processor: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        diag.info("[OpenAIAgentsTraceInstrumentor] Enabled OpenAI Agents instrumentation");
+        super.enable();
+    }
+    /**
+     * Disable instrumentation.
+     */
+    disable() {
+        if (this.processor) {
+            void this.processor.shutdown();
+            this.processor = undefined;
+        }
+        this._hasBeenEnabled = false;
+        try {
+            setTraceProcessors([]);
+        }
+        catch (error) {
+            diag.error(`[OpenAIAgentsTraceInstrumentor] Failed to clear trace processors: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        diag.info("[OpenAIAgentsTraceInstrumentor] Disabled OpenAI Agents instrumentation");
+        super.disable();
+    }
+    getProcessor() {
+        return this.processor;
+    }
+}
+/**
+ * Static wrapper for OpenAI Agents SDK tracing instrumentation.
+ *
+ * Usage:
+ * ```ts
+ * OpenAIAgentsTraceInstrumentor.instrument({ isContentRecordingEnabled: true });
+ * ```
+ */
+export class OpenAIAgentsTraceInstrumentor {
+    static throwNotInitialized() {
+        throw new Error("OpenAIAgentsTraceInstrumentor must be initialized first. " +
+            "Call OpenAIAgentsTraceInstrumentor.instrument() before using enable/disable.");
+    }
+    /**
+     * Initialize and auto-enable the OpenAI Agents instrumentation.
+     */
+    static instrument(options) {
+        OpenAIAgentsTraceInstrumentorImpl.getInstance(options).enable();
+    }
+    /**
+     * Enable OpenAI Agents instrumentation.
+     */
+    static enable() {
+        if (!OpenAIAgentsTraceInstrumentorImpl.hasInstance()) {
+            this.throwNotInitialized();
+        }
+        OpenAIAgentsTraceInstrumentorImpl.getInstance().enable();
+    }
+    /**
+     * Disable OpenAI Agents instrumentation.
+     */
+    static disable() {
+        if (!OpenAIAgentsTraceInstrumentorImpl.hasInstance()) {
+            this.throwNotInitialized();
+        }
+        OpenAIAgentsTraceInstrumentorImpl.getInstance().disable();
+    }
+    /**
+     * Reset the instrumentor instance (for testing).
+     */
+    static resetInstance() {
+        OpenAIAgentsTraceInstrumentorImpl.resetInstance();
+    }
+}
+//# sourceMappingURL=openAIAgentsTraceInstrumentor.js.map

package/dist/esm/genai/instrumentations/openai/openAIAgentsTraceInstrumentor.js.map

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

package/dist/esm/genai/instrumentations/openai/openAIAgentsTraceProcessor.d.ts

@@ -0,0 +1,57 @@
+import { Tracer as OtelTracer } from "@opentelemetry/api";
+import type { Span as AgentsSpan, SpanData, Trace as AgentTrace, TracingProcessor } from "@openai/agents-core";
+/**
+ * OpenTelemetry-based trace processor for the OpenAI Agents SDK.
+ *
+ * Implements the `TracingProcessor` interface from `@openai/agents-core` so it
+ * can be registered via `setTraceProcessors()`. Every OpenAI agent span
+ * (agent invocation, function/tool call, LLM generation, response, handoff,
+ * MCP list-tools) is mapped to an OTel span with GenAI semantic convention
+ * attributes.
+ *
+ * Key behaviors:
+ * - Creates an OTel span on `onSpanStart` and ends it on `onSpanEnd`.
+ * - Maintains parent–child span relationships via trace/span ID maps.
+ * - Guards against unbounded memory with a hard cap of {@link MAX_SPANS_IN_FLIGHT}.
+ * - Content-sensitive attributes (messages, tool args) are only recorded
+ *   when `isContentRecordingEnabled` is true.
+ */
+export declare class OpenAIAgentsTraceProcessor implements TracingProcessor {
+    private static readonly MAX_HANDOFFS_IN_FLIGHT;
+    private static readonly MAX_SPANS_IN_FLIGHT;
+    private readonly tracer;
+    private readonly suppressInvokeAgentInput;
+    private readonly isContentRecordingEnabled;
+    /** Root spans keyed by trace ID. */
+    private readonly rootSpans;
+    /** Active OTel spans keyed by OpenAI span ID. */
+    private readonly otelSpans;
+    /** Context tokens for span activation. */
+    private readonly tokens;
+    /** Reverse handoff map: `${toAgent}:${traceId}` → fromAgent */
+    private readonly reverseHandoffsDict;
+    /** Span names for lookup (OTel Span doesn't expose name). */
+    private readonly spanNames;
+    constructor(tracer: OtelTracer, options?: {
+        suppressInvokeAgentInput?: boolean;
+        isContentRecordingEnabled?: boolean;
+    });
+    private isContentKey;
+    private getNewKey;
+    start(): Promise<void>;
+    onTraceStart(_trace: AgentTrace): Promise<void>;
+    onTraceEnd(trace: AgentTrace): Promise<void>;
+    onSpanStart(span: AgentsSpan<SpanData>): Promise<void>;
+    onSpanEnd(span: AgentsSpan<SpanData>): Promise<void>;
+    forceFlush(): Promise<void>;
+    shutdown(_timeout?: number): Promise<void>;
+    private processSpanData;
+    private processResponseSpanData;
+    private processGenerationSpanData;
+    private processFunctionSpanData;
+    private processMCPListToolsSpanData;
+    private processHandoffSpanData;
+    private processAgentSpanData;
+    private stampCustomParent;
+}
+//# sourceMappingURL=openAIAgentsTraceProcessor.d.ts.map

package/dist/esm/genai/instrumentations/openai/openAIAgentsTraceProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openAIAgentsTraceProcessor.d.ts","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/openai/openAIAgentsTraceProcessor.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,MAAM,IAAI,UAAU,EAErB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,IAAI,IAAI,UAAU,EAClB,QAAQ,EAER,KAAK,IAAI,UAAU,EACnB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAwB7B;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAErD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAU;IACnD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAU;IAEpD,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkC;IACtE,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;gBAG5D,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;QACR,wBAAwB,CAAC,EAAE,OAAO,CAAC;QACnC,yBAAyB,CAAC,EAAE,OAAO,CAAC;KACrC;IAOH,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,SAAS;IAMJ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5C,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsDtD,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgDpD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD,OAAO,CAAC,eAAe;IA+BvB,OAAO,CAAC,uBAAuB;IAkE/B,OAAO,CAAC,yBAAyB;IA2BjC,OAAO,CAAC,uBAAuB;IAwB/B,OAAO,CAAC,2BAA2B;IAkBnC,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,iBAAiB;CAS1B"}

package/dist/esm/genai/instrumentations/openai/openAIAgentsTraceProcessor.js

@@ -0,0 +1,313 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// Vendored from microsoft/Agent365-nodejs packages/agents-a365-observability-extensions-openai
+// Adapted: removed A365 ObservabilityManager dependency, uses local semconv + utils
+import { context, trace as OtelTrace, diag, } from "@opentelemetry/api";
+import { ATTR_GEN_AI_INPUT_MESSAGES, ATTR_GEN_AI_OPERATION_NAME, ATTR_GEN_AI_OUTPUT_MESSAGES, ATTR_GEN_AI_PROVIDER_NAME, ATTR_GEN_AI_REQUEST_MODEL, ATTR_GEN_AI_TOOL_TYPE, ATTR_GEN_AI_TOOL_NAME, GEN_AI_OPERATION_CHAT, GEN_AI_OPERATION_EXECUTE_TOOL, GEN_AI_OPERATION_INVOKE_AGENT, } from "../../index.js";
+import { truncateValue } from "../../utils.js";
+import { GEN_AI_GRAPH_NODE_ID, GEN_AI_GRAPH_NODE_PARENT_ID, GEN_AI_RESPONSE_CONTENT_KEY, GEN_AI_EXECUTION_PAYLOAD_KEY, } from "./semconv.js";
+import * as Utils from "./utils.js";
+/**
+ * OpenTelemetry-based trace processor for the OpenAI Agents SDK.
+ *
+ * Implements the `TracingProcessor` interface from `@openai/agents-core` so it
+ * can be registered via `setTraceProcessors()`. Every OpenAI agent span
+ * (agent invocation, function/tool call, LLM generation, response, handoff,
+ * MCP list-tools) is mapped to an OTel span with GenAI semantic convention
+ * attributes.
+ *
+ * Key behaviors:
+ * - Creates an OTel span on `onSpanStart` and ends it on `onSpanEnd`.
+ * - Maintains parent–child span relationships via trace/span ID maps.
+ * - Guards against unbounded memory with a hard cap of {@link MAX_SPANS_IN_FLIGHT}.
+ * - Content-sensitive attributes (messages, tool args) are only recorded
+ *   when `isContentRecordingEnabled` is true.
+ */
+export class OpenAIAgentsTraceProcessor {
+    static MAX_HANDOFFS_IN_FLIGHT = 1_000;
+    static MAX_SPANS_IN_FLIGHT = 10_000;
+    tracer;
+    suppressInvokeAgentInput;
+    isContentRecordingEnabled;
+    /** Root spans keyed by trace ID. */
+    rootSpans = new Map();
+    /** Active OTel spans keyed by OpenAI span ID. */
+    otelSpans = new Map();
+    /** Context tokens for span activation. */
+    tokens = new Map();
+    /** Reverse handoff map: `${toAgent}:${traceId}` → fromAgent */
+    reverseHandoffsDict = new Map();
+    /** Span names for lookup (OTel Span doesn't expose name). */
+    spanNames = new Map();
+    constructor(tracer, options) {
+        this.tracer = tracer;
+        this.suppressInvokeAgentInput = options?.suppressInvokeAgentInput ?? false;
+        this.isContentRecordingEnabled = options?.isContentRecordingEnabled ?? false;
+    }
+    isContentKey(key) {
+        return Utils.CONTENT_KEYS.has(key);
+    }
+    getNewKey(spanType, key) {
+        return Utils.KEY_MAPPINGS.get(`${spanType}${key}`) ?? null;
+    }
+    // -- TracingProcessor interface --
+    async start() {
+        // no-op
+    }
+    async onTraceStart(_trace) {
+        // no-op
+    }
+    async onTraceEnd(trace) {
+        const rootSpan = this.rootSpans.get(trace.traceId);
+        if (rootSpan) {
+            this.rootSpans.delete(trace.traceId);
+            rootSpan.end();
+        }
+    }
+    async onSpanStart(span) {
+        const spanId = span.spanId;
+        const parentId = span.parentId;
+        const traceId = span.traceId;
+        const startedAt = span.startedAt;
+        const spanData = span.spanData;
+        if (!startedAt || !spanId || !traceId) {
+            return;
+        }
+        if (this.otelSpans.size >= OpenAIAgentsTraceProcessor.MAX_SPANS_IN_FLIGHT) {
+            diag.warn(`[OpenAIAgentsTraceProcessor] Max spans in flight (${OpenAIAgentsTraceProcessor.MAX_SPANS_IN_FLIGHT}) reached, skipping span`);
+            return;
+        }
+        const startTime = new Date(startedAt).getTime();
+        // Find parent span
+        const parentSpan = parentId ? this.otelSpans.get(parentId) : this.rootSpans.get(traceId);
+        // Create context with parent
+        const parentContext = parentSpan
+            ? OtelTrace.setSpan(context.active(), parentSpan)
+            : context.active();
+        const spanName = Utils.getSpanName(span);
+        // Start OpenTelemetry span
+        const otelSpan = this.tracer.startSpan(spanName, {
+            startTime,
+            attributes: {
+                [ATTR_GEN_AI_OPERATION_NAME]: Utils.getOperationName(spanData),
+                [ATTR_GEN_AI_PROVIDER_NAME]: "openai",
+            },
+        }, parentContext);
+        if (!parentSpan) {
+            this.rootSpans.set(traceId, otelSpan);
+        }
+        this.otelSpans.set(spanId, otelSpan);
+        this.spanNames.set(otelSpan, spanName);
+        const newContext = OtelTrace.setSpan(context.active(), otelSpan);
+        const token = context.with(newContext, () => context.active());
+        this.tokens.set(spanId, token);
+    }
+    async onSpanEnd(span) {
+        const spanId = span.spanId;
+        const traceId = span.traceId;
+        const endedAt = span.endedAt;
+        const spanData = span.spanData;
+        if (!spanId || !traceId) {
+            return;
+        }
+        // Cleanup context token
+        const token = this.tokens.get(spanId);
+        if (token) {
+            this.tokens.delete(spanId);
+        }
+        const otelSpan = this.otelSpans.get(spanId);
+        if (!otelSpan) {
+            return;
+        }
+        this.otelSpans.delete(spanId);
+        this.spanNames.delete(otelSpan);
+        // Clean up root span reference if this is the root
+        const rootSpan = this.rootSpans.get(traceId);
+        if (rootSpan === otelSpan) {
+            this.rootSpans.delete(traceId);
+        }
+        // Update span name
+        otelSpan.updateName(Utils.getSpanName(span));
+        // Process based on span data type
+        if (spanData) {
+            this.processSpanData(otelSpan, spanData, traceId);
+        }
+        // Set end time and status
+        const endTime = endedAt ? new Date(endedAt).getTime() : undefined;
+        const status = Utils.getSpanStatus(span);
+        otelSpan.setStatus(status);
+        if (endTime) {
+            otelSpan.end(endTime);
+        }
+        else {
+            otelSpan.end();
+        }
+    }
+    async forceFlush() {
+        // no-op
+    }
+    async shutdown(_timeout) {
+        this.rootSpans.clear();
+        this.otelSpans.clear();
+        this.tokens.clear();
+        this.reverseHandoffsDict.clear();
+    }
+    // -- Span data processors --
+    processSpanData(otelSpan, data, traceId) {
+        const type = data.type;
+        const contentRecording = this.isContentRecordingEnabled;
+        switch (type) {
+            case "response":
+                this.processResponseSpanData(otelSpan, data, contentRecording);
+                break;
+            case "generation":
+                this.processGenerationSpanData(otelSpan, data, traceId, contentRecording);
+                break;
+            case "function":
+                this.processFunctionSpanData(otelSpan, data, traceId, contentRecording);
+                break;
+            case "mcp_tools":
+                this.processMCPListToolsSpanData(otelSpan, data);
+                break;
+            case "handoff":
+                this.processHandoffSpanData(otelSpan, data, traceId);
+                break;
+            case "agent":
+                this.processAgentSpanData(otelSpan, data, traceId);
+                break;
+        }
+    }
+    processResponseSpanData(otelSpan, data, contentRecording) {
+        const responseData = data;
+        const responseObj = responseData._response || responseData.response;
+        const inputObj = responseData._input || responseData.input;
+        if (responseObj) {
+            const resp = responseObj;
+            if (resp.output && contentRecording) {
+                if (typeof resp.output === "string") {
+                    otelSpan.setAttribute(ATTR_GEN_AI_OUTPUT_MESSAGES, truncateValue(resp.output));
+                }
+                else {
+                    otelSpan.setAttribute(ATTR_GEN_AI_OUTPUT_MESSAGES, truncateValue(Utils.buildOutputMessages(resp.output)));
+                }
+            }
+            // Get attributes but filter out response content key (handled above)
+            const attrs = Utils.getAttributesFromResponse(responseObj);
+            Object.entries(attrs).forEach(([key, value]) => {
+                if (value !== null && value !== undefined && key !== GEN_AI_RESPONSE_CONTENT_KEY) {
+                    otelSpan.setAttribute(key, value);
+                }
+            });
+            const modelName = attrs[ATTR_GEN_AI_REQUEST_MODEL] ?? "";
+            otelSpan.updateName(`${GEN_AI_OPERATION_CHAT} ${modelName}`);
+        }
+        if (inputObj && !this.suppressInvokeAgentInput && contentRecording) {
+            if (typeof inputObj === "string") {
+                try {
+                    const parsed = JSON.parse(inputObj);
+                    if (Array.isArray(parsed)) {
+                        otelSpan.setAttribute(ATTR_GEN_AI_INPUT_MESSAGES, truncateValue(Utils.buildInputMessages(parsed)));
+                        return;
+                    }
+                }
+                catch {
+                    // Fall back to raw string
+                }
+                otelSpan.setAttribute(ATTR_GEN_AI_INPUT_MESSAGES, truncateValue(inputObj));
+            }
+            else if (Array.isArray(inputObj)) {
+                otelSpan.setAttribute(ATTR_GEN_AI_INPUT_MESSAGES, truncateValue(Utils.buildInputMessages(inputObj)));
+            }
+        }
+    }
+    processGenerationSpanData(otelSpan, data, traceId, contentRecording) {
+        const attrs = Utils.getAttributesFromGenerationSpanData(data);
+        Object.entries(attrs).forEach(([key, value]) => {
+            const shouldExcludeKey = key === GEN_AI_EXECUTION_PAYLOAD_KEY;
+            if (value !== null && value !== undefined && !shouldExcludeKey) {
+                const newKey = this.getNewKey(data.type, key);
+                const resolvedKey = newKey || key;
+                if (!this.isContentKey(resolvedKey) || contentRecording) {
+                    otelSpan.setAttribute(resolvedKey, value);
+                }
+            }
+        });
+        this.stampCustomParent(otelSpan, traceId);
+        const operationName = attrs[ATTR_GEN_AI_OPERATION_NAME];
+        const modelName = attrs[ATTR_GEN_AI_REQUEST_MODEL];
+        if (operationName && modelName) {
+            otelSpan.updateName(`${operationName} ${modelName}`);
+        }
+    }
+    processFunctionSpanData(otelSpan, data, traceId, contentRecording) {
+        const functionData = data;
+        const attrs = Utils.getAttributesFromFunctionSpanData(data);
+        Object.entries(attrs).forEach(([key, value]) => {
+            if (value !== null && value !== undefined) {
+                const newKey = this.getNewKey(data.type, key);
+                const resolvedKey = newKey || key;
+                if (!this.isContentKey(resolvedKey) || contentRecording) {
+                    otelSpan.setAttribute(resolvedKey, value);
+                }
+            }
+        });
+        otelSpan.setAttribute(ATTR_GEN_AI_TOOL_TYPE, "function");
+        this.stampCustomParent(otelSpan, traceId);
+        otelSpan.updateName(`${GEN_AI_OPERATION_EXECUTE_TOOL} ${functionData.name ?? ""}`);
+        otelSpan.setAttribute(ATTR_GEN_AI_OPERATION_NAME, GEN_AI_OPERATION_EXECUTE_TOOL);
+    }
+    processMCPListToolsSpanData(otelSpan, data) {
+        const attrs = Utils.getAttributesFromMCPListToolsSpanData(data);
+        Object.entries(attrs).forEach(([key, value]) => {
+            if (value !== null && value !== undefined) {
+                const newKey = this.getNewKey(data.type, key);
+                otelSpan.setAttribute(newKey || key, value);
+            }
+        });
+        otelSpan.setAttribute(ATTR_GEN_AI_OPERATION_NAME, GEN_AI_OPERATION_EXECUTE_TOOL);
+        const serverName = data.server ?? "unknown";
+        otelSpan.updateName(`${GEN_AI_OPERATION_EXECUTE_TOOL} ${serverName}`);
+        if (serverName) {
+            otelSpan.setAttribute(ATTR_GEN_AI_TOOL_NAME, serverName);
+        }
+        otelSpan.setAttribute(ATTR_GEN_AI_TOOL_TYPE, "extension");
+    }
+    processHandoffSpanData(_otelSpan, data, traceId) {
+        const handoffData = data;
+        if (handoffData.to_agent && handoffData.from_agent) {
+            const key = `${handoffData.to_agent}:${traceId}`;
+            this.reverseHandoffsDict.set(key, handoffData.from_agent);
+            while (this.reverseHandoffsDict.size > OpenAIAgentsTraceProcessor.MAX_HANDOFFS_IN_FLIGHT) {
+                const firstKey = this.reverseHandoffsDict.keys().next().value;
+                if (firstKey) {
+                    this.reverseHandoffsDict.delete(firstKey);
+                }
+            }
+        }
+    }
+    processAgentSpanData(otelSpan, data, traceId) {
+        const agentData = data;
+        if (agentData.name) {
+            otelSpan.setAttribute(GEN_AI_GRAPH_NODE_ID, agentData.name);
+            otelSpan.setAttribute(ATTR_GEN_AI_OPERATION_NAME, GEN_AI_OPERATION_INVOKE_AGENT);
+            // Lookup parent node from handoff
+            const key = `${agentData.name}:${traceId}`;
+            const parentNode = this.reverseHandoffsDict.get(key);
+            if (parentNode) {
+                this.reverseHandoffsDict.delete(key);
+                otelSpan.setAttribute(GEN_AI_GRAPH_NODE_PARENT_ID, parentNode);
+            }
+            otelSpan.updateName(`${GEN_AI_OPERATION_INVOKE_AGENT} ${agentData.name}`);
+        }
+    }
+    stampCustomParent(otelSpan, traceId) {
+        const root = this.rootSpans.get(traceId);
+        if (!root) {
+            return;
+        }
+        const spanContext = root.spanContext();
+        const pidHex = `0x${spanContext.spanId}`;
+        otelSpan.setAttribute("custom.parent.span.id", pidHex);
+    }
+}
+//# sourceMappingURL=openAIAgentsTraceProcessor.js.map

package/dist/esm/genai/instrumentations/openai/openAIAgentsTraceProcessor.js.map

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

package/dist/esm/genai/instrumentations/openai/semconv.d.ts

@@ -0,0 +1,10 @@
+export declare const GEN_AI_SPAN_KIND_AGENT: "agent";
+export declare const GEN_AI_SPAN_KIND_TOOL: "tool";
+export declare const GEN_AI_SPAN_KIND_CHAIN: "chain";
+export declare const GEN_AI_SPAN_KIND_CHAT: "chat";
+export declare const GEN_AI_REQUEST_CONTENT_KEY: "gen_ai.request.content";
+export declare const GEN_AI_RESPONSE_CONTENT_KEY: "gen_ai.response.content";
+export declare const GEN_AI_EXECUTION_PAYLOAD_KEY: "gen_ai.execution.payload";
+export declare const GEN_AI_GRAPH_NODE_ID: "graph_node_id";
+export declare const GEN_AI_GRAPH_NODE_PARENT_ID: "graph_node_parent_id";
+//# sourceMappingURL=semconv.d.ts.map

package/dist/esm/genai/instrumentations/openai/semconv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semconv.d.ts","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/openai/semconv.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,sBAAsB,EAAG,OAAgB,CAAC;AACvD,eAAO,MAAM,qBAAqB,EAAG,MAAe,CAAC;AACrD,eAAO,MAAM,sBAAsB,EAAG,OAAgB,CAAC;AACvD,eAAO,MAAM,qBAAqB,EAAG,MAAe,CAAC;AAGrD,eAAO,MAAM,0BAA0B,EAAG,wBAAiC,CAAC;AAC5E,eAAO,MAAM,2BAA2B,EAAG,yBAAkC,CAAC;AAC9E,eAAO,MAAM,4BAA4B,EAAG,0BAAmC,CAAC;AAChF,eAAO,MAAM,oBAAoB,EAAG,eAAwB,CAAC;AAC7D,eAAO,MAAM,2BAA2B,EAAG,sBAA+B,CAAC"}

package/dist/esm/genai/instrumentations/openai/semconv.js

@@ -0,0 +1,16 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// Vendored from microsoft/Agent365-nodejs packages/agents-a365-observability-extensions-openai
+// Adapted: uses local semconv constants instead of A365 imports
+// Span kind classifiers (map OpenAI span data types to GenAI operation kinds)
+export const GEN_AI_SPAN_KIND_AGENT = "agent";
+export const GEN_AI_SPAN_KIND_TOOL = "tool";
+export const GEN_AI_SPAN_KIND_CHAIN = "chain";
+export const GEN_AI_SPAN_KIND_CHAT = "chat";
+// OpenAI-specific span attribute keys (not in OTel semconv)
+export const GEN_AI_REQUEST_CONTENT_KEY = "gen_ai.request.content";
+export const GEN_AI_RESPONSE_CONTENT_KEY = "gen_ai.response.content";
+export const GEN_AI_EXECUTION_PAYLOAD_KEY = "gen_ai.execution.payload";
+export const GEN_AI_GRAPH_NODE_ID = "graph_node_id";
+export const GEN_AI_GRAPH_NODE_PARENT_ID = "graph_node_parent_id";
+//# sourceMappingURL=semconv.js.map

package/dist/esm/genai/instrumentations/openai/semconv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semconv.js","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/openai/semconv.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAClC,+FAA+F;AAC/F,gEAAgE;AAEhE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAgB,CAAC;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAe,CAAC;AACrD,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAgB,CAAC;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAe,CAAC;AAErD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,0BAA0B,GAAG,wBAAiC,CAAC;AAC5E,MAAM,CAAC,MAAM,2BAA2B,GAAG,yBAAkC,CAAC;AAC9E,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAAmC,CAAC;AAChF,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAwB,CAAC;AAC7D,MAAM,CAAC,MAAM,2BAA2B,GAAG,sBAA+B,CAAC"}

package/dist/esm/genai/instrumentations/openai/utils.d.ts

@@ -0,0 +1,63 @@
+import { SpanStatusCode } from "@opentelemetry/api";
+import type { Span as AgentsSpan, SpanData } from "@openai/agents-core";
+/**
+ * Safely stringify an object to JSON, truncating to the attribute limit.
+ */
+export declare function safeJsonDumps(obj: unknown): string;
+/**
+ * Get span name from OpenAI Agents SDK span.
+ */
+export declare function getSpanName(span: AgentsSpan<SpanData>): string;
+/**
+ * Map OpenAI span data type to a GenAI operation kind string.
+ */
+export declare function getSpanKind(spanData: SpanData | undefined): string;
+/**
+ * Map OpenAI span data type to a GenAI semantic convention operation name.
+ */
+export declare function getOperationName(spanData: SpanData | undefined): string;
+/**
+ * Derive OTel span status from an OpenAI Agents SDK span.
+ */
+export declare function getSpanStatus(span: AgentsSpan<SpanData>): {
+    code: SpanStatusCode;
+    message?: string;
+};
+/**
+ * Extract attributes from a generation span.
+ */
+export declare function getAttributesFromGenerationSpanData(data: SpanData): Record<string, unknown>;
+/**
+ * Extract attributes from a function/tool span.
+ */
+export declare function getAttributesFromFunctionSpanData(data: SpanData): Record<string, unknown>;
+/**
+ * Extract attributes from an MCP list-tools span.
+ */
+export declare function getAttributesFromMCPListToolsSpanData(data: SpanData): Record<string, unknown>;
+/**
+ * Extract attributes from a response span.
+ */
+export declare function getAttributesFromResponse(response: unknown): Record<string, unknown>;
+/** Content-sensitive attribute keys that should only be recorded when content recording is enabled. */
+export declare const CONTENT_KEYS: Set<string>;
+/** Key remapping table: `${spanType}${originalKey}` → target semconv key */
+export declare const KEY_MAPPINGS: Map<string, string>;
+/**
+ * Build a JSON string of input messages, extracting user-role content.
+ */
+export declare function buildInputMessages(arr: Array<{
+    role: string;
+    content: string;
+}>): string;
+/**
+ * Build a JSON string of output messages, extracting output_text content.
+ */
+export declare function buildOutputMessages(arr: Array<{
+    role: string;
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/esm/genai/instrumentations/openai/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/openai/utils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAuBxE;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,MAAM,CAgB9D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAmBlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAmBvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG;IACzD,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAMA;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsC3F;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzF;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ7F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBpF;AAED,uGAAuG;AACvG,eAAO,MAAM,YAAY,aAOvB,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,YAAY,qBAOvB,CAAC;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAKxF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,GAC3E,MAAM,CAaR"}