@microsoft/agents-a365-observability-extensions-openai 0.1.0-preview.30

package/dist/esm/OpenAIAgentsTraceProcessor.js

@@ -0,0 +1,337 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+/**
+ * Trace processor for OpenAI Agents SDK
+ * Converts OpenAI Agents SDK spans to OpenTelemetry spans
+ */
+import { context, trace as OtelTrace } from '@opentelemetry/api';
+import { OpenTelemetryConstants, InferenceOperationType } from '@microsoft/agents-a365-observability';
+import * as Constants from './Constants';
+import * as Utils from './Utils';
+/**
+ * Processor for OpenAI Agents SDK traces
+ */
+export class OpenAIAgentsTraceProcessor {
+    constructor(tracer) {
+        this.rootSpans = new Map();
+        this.otelSpans = new Map();
+        this.tokens = new Map();
+        this.reverseHandoffsDict = new Map();
+        // Track span names for later access (since OTel Span doesn't expose name)
+        this.spanNames = new Map();
+        this.keyMappings = new Map([
+            ['mcp_tools' + Constants.GEN_AI_RESPONSE_CONTENT_KEY, OpenTelemetryConstants.GEN_AI_EVENT_CONTENT],
+            ['mcp_tools' + Constants.GEN_AI_REQUEST_CONTENT_KEY, OpenTelemetryConstants.GEN_AI_TOOL_ARGS_KEY],
+            ['function' + Constants.GEN_AI_RESPONSE_CONTENT_KEY, OpenTelemetryConstants.GEN_AI_EVENT_CONTENT],
+            ['function' + Constants.GEN_AI_REQUEST_CONTENT_KEY, OpenTelemetryConstants.GEN_AI_TOOL_ARGS_KEY],
+            ['generation' + Constants.GEN_AI_RESPONSE_CONTENT_KEY, OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY],
+            ['generation' + Constants.GEN_AI_REQUEST_CONTENT_KEY, OpenTelemetryConstants.GEN_AI_INPUT_MESSAGES_KEY],
+        ]);
+        this.tracer = tracer;
+    }
+    getNewKey(spanType, key) {
+        return this.keyMappings.get(`${spanType}${key}`) ?? null;
+    }
+    /**
+     * Called to initialize the processor
+     */
+    async start() {
+        // Initialization logic if needed
+    }
+    /**
+     * Called when a trace starts
+     */
+    async onTraceStart(_trace) {
+        // Trace start - no root span creation needed
+    }
+    /**
+     * Called when a trace ends
+     */
+    async onTraceEnd(trace) {
+        const rootSpan = this.rootSpans.get(trace.traceId);
+        if (rootSpan) {
+            this.rootSpans.delete(trace.traceId);
+            rootSpan.end();
+        }
+    }
+    /**
+     * Called when a span starts
+     */
+    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;
+        }
+        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: {
+                [OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY]: Utils.getSpanKind(spanData),
+                [OpenTelemetryConstants.GEN_AI_SYSTEM_KEY]: 'openai',
+            },
+        }, parentContext);
+        if (!parentSpan) {
+            this.rootSpans.set(traceId, otelSpan);
+        }
+        // Store span and activate context
+        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);
+    }
+    /**
+     * Called when a span ends
+     */
+    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);
+            // Context cleanup is automatic in JS
+        }
+        // Retrieve OpenTelemetry span
+        const otelSpan = this.otelSpans.get(spanId);
+        if (!otelSpan) {
+            return;
+        }
+        this.otelSpans.delete(spanId);
+        this.spanNames.delete(otelSpan);
+        // 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();
+        }
+    }
+    /**
+     * Process span data based on type
+     */
+    processSpanData(otelSpan, data, traceId) {
+        const type = data.type;
+        switch (type) {
+            case 'response':
+                this.processResponseSpanData(otelSpan, data);
+                break;
+            case 'generation':
+                this.processGenerationSpanData(otelSpan, data, traceId);
+                break;
+            case 'function':
+                this.processFunctionSpanData(otelSpan, data, traceId);
+                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;
+        }
+    }
+    /**
+     * Process response span data
+     */
+    processResponseSpanData(otelSpan, data) {
+        const responseData = data;
+        // Handle both formats: _response/_input (actual format) and response/input (legacy format)
+        const responseObj = responseData._response || responseData.response;
+        const inputObj = responseData._input || responseData.input;
+        if (responseObj) {
+            const resp = responseObj;
+            // Store the output field for GEN_AI_RESPONSE_CONTENT_KEY
+            if (resp.output) {
+                if (typeof resp.output === 'string') {
+                    otelSpan.setAttribute(OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY, resp.output);
+                }
+                else {
+                    otelSpan.setAttribute(OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY, JSON.stringify(resp.output));
+                }
+            }
+            // Get attributes but filter out unwanted ones
+            const attrs = Utils.getAttributesFromResponse(responseObj);
+            Object.entries(attrs).forEach(([key, value]) => {
+                if (value !== null && value !== undefined &&
+                    key !== Constants.GEN_AI_RESPONSE_CONTENT_KEY) {
+                    otelSpan.setAttribute(key, value);
+                }
+            });
+            const modelName = attrs[OpenTelemetryConstants.GEN_AI_REQUEST_MODEL_KEY] ?? '';
+            otelSpan.updateName(`${InferenceOperationType.CHAT} ${modelName}`);
+        }
+        if (inputObj) {
+            if (typeof inputObj === 'string') {
+                otelSpan.setAttribute(OpenTelemetryConstants.GEN_AI_INPUT_MESSAGES_KEY, inputObj);
+            }
+            else if (Array.isArray(inputObj)) {
+                // Store the complete _input structure as JSON
+                otelSpan.setAttribute(OpenTelemetryConstants.GEN_AI_INPUT_MESSAGES_KEY, JSON.stringify(inputObj));
+                // Get attributes but filter out unwanted ones
+                const attrs = Utils.getAttributesFromInput(inputObj);
+                Object.entries(attrs).forEach(([key, value]) => {
+                    if (value !== null && value !== undefined &&
+                        key !== Constants.GEN_AI_REQUEST_CONTENT_KEY) {
+                        otelSpan.setAttribute(key, value);
+                    }
+                });
+            }
+        }
+    }
+    /**
+     * Process generation span data
+     */
+    processGenerationSpanData(otelSpan, data, traceId) {
+        const attrs = Utils.getAttributesFromGenerationSpanData(data);
+        Object.entries(attrs).forEach(([key, value]) => {
+            const shouldExcludeKey = key === OpenTelemetryConstants.GEN_AI_EXECUTION_TYPE_KEY
+                || key === Constants.GEN_AI_EXECUTION_PAYLOAD_KEY;
+            if (value !== null && value !== undefined && !shouldExcludeKey) {
+                const newKey = this.getNewKey(data.type, key);
+                otelSpan.setAttribute(newKey || key, value);
+            }
+        });
+        this.stampCustomParent(otelSpan, traceId);
+        // Update span name with model
+        const operationName = attrs[OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY];
+        const modelName = attrs[OpenTelemetryConstants.GEN_AI_REQUEST_MODEL_KEY];
+        if (operationName && modelName) {
+            otelSpan.updateName(`${operationName} ${modelName}`);
+        }
+    }
+    /**
+     * Process function/tool span data
+     */
+    processFunctionSpanData(otelSpan, data, traceId) {
+        const functionData = data;
+        const attrs = Utils.getAttributesFromFunctionSpanData(data);
+        Object.entries(attrs).forEach(([key, value]) => {
+            if (value !== null && value !== undefined && key !== OpenTelemetryConstants.GEN_AI_EXECUTION_TYPE_KEY) {
+                const newKey = this.getNewKey(data.type, key);
+                otelSpan.setAttribute(newKey || key, value);
+            }
+            otelSpan.setAttribute(OpenTelemetryConstants.GEN_AI_TOOL_TYPE_KEY, 'function');
+        });
+        this.stampCustomParent(otelSpan, traceId);
+        // Use function name from data instead of span name
+        otelSpan.updateName(`${OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME} ${functionData.name ?? ''}`);
+        otelSpan.setAttribute(OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY, OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME);
+    }
+    /**
+     * Process MCP list tools span data
+     */
+    processMCPListToolsSpanData(otelSpan, data) {
+        const attrs = Utils.getAttributesFromMCPListToolsSpanData(data);
+        Object.entries(attrs).forEach(([key, value]) => {
+            if (value !== null && value !== undefined && key !== OpenTelemetryConstants.GEN_AI_EXECUTION_TYPE_KEY) {
+                const newKey = this.getNewKey(data.type, key);
+                otelSpan.setAttribute(newKey || key, value);
+            }
+        });
+        otelSpan.setAttribute(OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY, OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME);
+        const serverName = data.server ?? 'unknown';
+        const newSpanName = `${OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME} ${serverName}`;
+        otelSpan.updateName(newSpanName);
+        if (serverName) {
+            otelSpan.setAttribute(OpenTelemetryConstants.GEN_AI_TOOL_NAME_KEY, serverName);
+        }
+        otelSpan.setAttribute(OpenTelemetryConstants.GEN_AI_TOOL_TYPE_KEY, 'extension');
+    }
+    /**
+     * Process handoff span data
+     */
+    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);
+            // Cap the size
+            while (this.reverseHandoffsDict.size > OpenAIAgentsTraceProcessor.MAX_HANDOFFS_IN_FLIGHT) {
+                const firstKey = this.reverseHandoffsDict.keys().next().value;
+                if (firstKey) {
+                    this.reverseHandoffsDict.delete(firstKey);
+                }
+            }
+        }
+    }
+    /**
+     * Process agent span data
+     */
+    processAgentSpanData(otelSpan, data, traceId) {
+        const agentData = data;
+        if (agentData.name) {
+            otelSpan.setAttribute(Constants.GEN_AI_GRAPH_NODE_ID, agentData.name);
+            otelSpan.setAttribute(OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY, OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME);
+            // Lookup parent node if exists
+            const key = `${agentData.name}:${traceId}`;
+            const parentNode = this.reverseHandoffsDict.get(key);
+            if (parentNode) {
+                this.reverseHandoffsDict.delete(key);
+                otelSpan.setAttribute(Constants.GEN_AI_GRAPH_NODE_PARENT_ID, parentNode);
+            }
+            // Update span name for agent
+            otelSpan.updateName(`${OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME} ${agentData.name}`);
+        }
+    }
+    /**
+     * Stamp custom parent reference
+     */
+    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);
+    }
+    /**
+     * Force flush
+     */
+    async forceFlush() {
+        // Implementation depends on tracer provider
+    }
+    /**
+     * Shutdown
+     */
+    async shutdown(_timeout) {
+        this.rootSpans.clear();
+        this.otelSpans.clear();
+        this.tokens.clear();
+        this.reverseHandoffsDict.clear();
+    }
+}
+OpenAIAgentsTraceProcessor.MAX_HANDOFFS_IN_FLIGHT = 1000;
+//# sourceMappingURL=OpenAIAgentsTraceProcessor.js.map

package/dist/esm/OpenAIAgentsTraceProcessor.js.map

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

package/dist/esm/Utils.d.ts

@@ -0,0 +1,44 @@
+import { SpanStatusCode } from '@opentelemetry/api';
+import { Span as AgentsSpan, SpanData } from '@openai/agents-core/dist/tracing/spans';
+/**
+ * Safely stringify an object to JSON
+ * @param obj - The object to stringify
+ * @returns JSON string representation or string conversion if JSON.stringify fails
+ */
+export declare function safeJsonDumps(obj: unknown): string;
+/**
+ * Get span name from OpenAI Agents SDK span
+ */
+export declare function getSpanName(span: AgentsSpan<SpanData>): string;
+/**
+ * Get span kind based on span data type
+ */
+export declare function getSpanKind(spanData: SpanData | undefined): string;
+/**
+ * Get attributes from generation span data
+ */
+export declare function getAttributesFromGenerationSpanData(data: SpanData): Record<string, unknown>;
+/**
+ * Get attributes from function span data
+ */
+export declare function getAttributesFromFunctionSpanData(data: SpanData): Record<string, unknown>;
+/**
+ * Get attributes from MCP list tools span data
+ */
+export declare function getAttributesFromMCPListToolsSpanData(data: SpanData): Record<string, unknown>;
+/**
+ * Get attributes from response span data
+ */
+export declare function getAttributesFromResponse(response: unknown): Record<string, unknown>;
+/**
+ * Get attributes from input data
+ */
+export declare function getAttributesFromInput(input: unknown): Record<string, unknown>;
+/**
+ * Get span status from OpenAI Agents SDK span
+ */
+export declare function getSpanStatus(span: AgentsSpan<SpanData>): {
+    code: SpanStatusCode;
+    message?: string;
+};
+//# sourceMappingURL=Utils.d.ts.map

package/dist/esm/Utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../src/Utils.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAEtF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,MAAM,CAiB9D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAqBlE;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwC3F;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzF;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU7F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBpF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU9E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAUpG"}

package/dist/esm/Utils.js

@@ -0,0 +1,177 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+import { SpanStatusCode } from '@opentelemetry/api';
+import { OpenTelemetryConstants } from '@microsoft/agents-a365-observability';
+import * as Constants from './Constants';
+/**
+ * Safely stringify an object to JSON
+ * @param obj - The object to stringify
+ * @returns JSON string representation or string conversion if JSON.stringify fails
+ */
+export function safeJsonDumps(obj) {
+    try {
+        return JSON.stringify(obj);
+    }
+    catch {
+        return String(obj);
+    }
+}
+/**
+ * Get span name from OpenAI Agents SDK span
+ */
+export function getSpanName(span) {
+    const data = span.spanData;
+    // Check if data has a 'name' property (for agent, function, custom spans)
+    const dataWithName = data;
+    if (dataWithName?.name && typeof dataWithName.name === 'string') {
+        return dataWithName.name;
+    }
+    if (data?.type === 'handoff') {
+        const handoffData = data;
+        if (handoffData.to_agent) {
+            return `handoff to ${handoffData.to_agent}`;
+        }
+    }
+    return data?.type || 'unknown';
+}
+/**
+ * Get span kind based on span data type
+ */
+export function getSpanKind(spanData) {
+    if (!spanData?.type) {
+        return Constants.GEN_AI_SPAN_KIND_CHAIN_KEY;
+    }
+    switch (spanData.type) {
+        case 'agent':
+            return Constants.GEN_AI_SPAN_KIND_AGENT_KEY;
+        case 'function':
+            return Constants.GEN_AI_SPAN_KIND_TOOL_KEY;
+        case 'generation':
+        case 'response':
+            return Constants.GEN_AI_SPAN_KIND_LLM_KEY;
+        case 'handoff':
+            return Constants.GEN_AI_SPAN_KIND_CHAIN_KEY;
+        case 'custom':
+        case 'guardrail':
+            return Constants.GEN_AI_SPAN_KIND_CHAIN_KEY;
+        default:
+            return Constants.GEN_AI_SPAN_KIND_CHAIN_KEY;
+    }
+}
+/**
+ * Get attributes from generation span data
+ */
+export function getAttributesFromGenerationSpanData(data) {
+    const attributes = {
+        [OpenTelemetryConstants.GEN_AI_PROVIDER_NAME_KEY]: 'openai',
+    };
+    const genData = data;
+    if (typeof genData.model === 'string') {
+        attributes[OpenTelemetryConstants.GEN_AI_REQUEST_MODEL_KEY] = genData.model;
+    }
+    if (genData.model_config || genData.modelConfig) {
+        const config = genData.model_config || genData.modelConfig;
+        attributes[OpenTelemetryConstants.GEN_AI_EXECUTION_PAYLOAD_KEY] = safeJsonDumps(config);
+    }
+    if (genData.input) {
+        attributes[Constants.GEN_AI_REQUEST_CONTENT_KEY] = safeJsonDumps(genData.input);
+        attributes[OpenTelemetryConstants.GEN_AI_EXECUTION_TYPE_KEY] = 'application/json';
+    }
+    if (genData.output) {
+        attributes[Constants.GEN_AI_RESPONSE_CONTENT_KEY] = safeJsonDumps(genData.output);
+        const output = genData.output;
+        if (output.id) {
+            attributes[OpenTelemetryConstants.GEN_AI_RESPONSE_ID_KEY] = output.id;
+        }
+    }
+    if (genData.usage) {
+        const usage = genData.usage;
+        if (usage.input_tokens !== undefined) {
+            attributes[OpenTelemetryConstants.GEN_AI_USAGE_INPUT_TOKENS_KEY] = usage.input_tokens;
+        }
+        if (usage.output_tokens !== undefined) {
+            attributes[OpenTelemetryConstants.GEN_AI_USAGE_OUTPUT_TOKENS_KEY] = usage.output_tokens;
+        }
+    }
+    return attributes;
+}
+/**
+ * Get attributes from function span data
+ */
+export function getAttributesFromFunctionSpanData(data) {
+    const attributes = {};
+    const funcData = data;
+    if (funcData.name) {
+        attributes['gen_ai.tool.name'] = funcData.name;
+    }
+    if (funcData.input) {
+        attributes[Constants.GEN_AI_REQUEST_CONTENT_KEY] =
+            typeof funcData.input === 'string' ? funcData.input : safeJsonDumps(funcData.input);
+        attributes[OpenTelemetryConstants.GEN_AI_EXECUTION_TYPE_KEY] = 'application/json';
+    }
+    if (funcData.output !== undefined && funcData.output !== null) {
+        const output = typeof funcData.output === 'object' ? safeJsonDumps(funcData.output) : String(funcData.output);
+        attributes[Constants.GEN_AI_RESPONSE_CONTENT_KEY] = output;
+    }
+    return attributes;
+}
+/**
+ * Get attributes from MCP list tools span data
+ */
+export function getAttributesFromMCPListToolsSpanData(data) {
+    const attributes = {};
+    const mcpData = data;
+    if (mcpData.result) {
+        attributes[Constants.GEN_AI_RESPONSE_CONTENT_KEY] = safeJsonDumps(mcpData.result);
+        attributes[OpenTelemetryConstants.GEN_AI_EXECUTION_TYPE_KEY] = 'application/json';
+    }
+    return attributes;
+}
+/**
+ * Get attributes from response span data
+ */
+export function getAttributesFromResponse(response) {
+    const attributes = {};
+    const resp = response;
+    if (resp.model) {
+        attributes[OpenTelemetryConstants.GEN_AI_REQUEST_MODEL_KEY] = resp.model;
+    }
+    if (resp.usage) {
+        const usage = resp.usage;
+        if (usage.input_tokens !== undefined) {
+            attributes[OpenTelemetryConstants.GEN_AI_USAGE_INPUT_TOKENS_KEY] = usage.input_tokens;
+        }
+        if (usage.output_tokens !== undefined) {
+            attributes[OpenTelemetryConstants.GEN_AI_USAGE_OUTPUT_TOKENS_KEY] = usage.output_tokens;
+        }
+    }
+    return attributes;
+}
+/**
+ * Get attributes from input data
+ */
+export function getAttributesFromInput(input) {
+    const attributes = {};
+    if (typeof input === 'string') {
+        attributes[Constants.GEN_AI_REQUEST_CONTENT_KEY] = input;
+    }
+    else if (Array.isArray(input)) {
+        attributes[Constants.GEN_AI_REQUEST_CONTENT_KEY] = safeJsonDumps(input);
+    }
+    return attributes;
+}
+/**
+ * Get span status from OpenAI Agents SDK span
+ */
+export function getSpanStatus(span) {
+    if (span.error) {
+        const message = span.error.message || span.error.data || 'Unknown error';
+        return {
+            code: SpanStatusCode.ERROR,
+            message: String(message),
+        };
+    }
+    return { code: SpanStatusCode.OK };
+}
+//# sourceMappingURL=Utils.js.map

package/dist/esm/Utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.js","sourceRoot":"","sources":["../../src/Utils.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;AAEjF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAA0B;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;IAE3B,0EAA0E;IAC1E,MAAM,YAAY,GAAG,IAAyB,CAAC;IAC/C,IAAI,YAAY,EAAE,IAAI,IAAI,OAAO,YAAY,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAChE,OAAO,YAAY,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,IAA+B,CAAC;QACpD,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;YACzB,OAAO,cAAc,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,EAAE,IAAI,IAAI,SAAS,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAA8B;IACxD,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC,0BAA0B,CAAC;IAC9C,CAAC;IAED,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,OAAO;YACV,OAAO,SAAS,CAAC,0BAA0B,CAAC;QAC9C,KAAK,UAAU;YACb,OAAO,SAAS,CAAC,yBAAyB,CAAC;QAC7C,KAAK,YAAY,CAAC;QAClB,KAAK,UAAU;YACb,OAAO,SAAS,CAAC,wBAAwB,CAAC;QAC5C,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC,0BAA0B,CAAC;QAC9C,KAAK,QAAQ,CAAC;QACd,KAAK,WAAW;YACd,OAAO,SAAS,CAAC,0BAA0B,CAAC;QAC9C;YACE,OAAO,SAAS,CAAC,0BAA0B,CAAC;IAC9C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mCAAmC,CAAC,IAAc;IAChE,MAAM,UAAU,GAA4B;QAC1C,CAAC,sBAAsB,CAAC,wBAAwB,CAAC,EAAE,QAAQ;KAC5D,CAAC;IAEF,MAAM,OAAO,GAAG,IAA+B,CAAC;IAEhD,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtC,UAAU,CAAC,sBAAsB,CAAC,wBAAwB,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IAC9E,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;QAC3D,UAAU,CAAC,sBAAsB,CAAC,4BAA4B,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1F,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,UAAU,CAAC,SAAS,CAAC,0BAA0B,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChF,UAAU,CAAC,sBAAsB,CAAC,yBAAyB,CAAC,GAAG,kBAAkB,CAAC;IACpF,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,SAAS,CAAC,2BAA2B,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAiC,CAAC;QACzD,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,UAAU,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;QACxE,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAgC,CAAC;QACvD,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACrC,UAAU,CAAC,sBAAsB,CAAC,6BAA6B,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC;QACxF,CAAC;QACD,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACtC,UAAU,CAAC,sBAAsB,CAAC,8BAA8B,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iCAAiC,CAAC,IAAc;IAC9D,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,MAAM,QAAQ,GAAG,IAA+B,CAAC;IAEjD,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,UAAU,CAAC,kBAAkB,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC;IACjD,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,UAAU,CAAC,SAAS,CAAC,0BAA0B,CAAC;YAC9C,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtF,UAAU,CAAC,sBAAsB,CAAC,yBAAyB,CAAC,GAAG,kBAAkB,CAAC;IACpF,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9G,UAAU,CAAC,SAAS,CAAC,2BAA2B,CAAC,GAAG,MAAM,CAAC;IAC7D,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qCAAqC,CAAC,IAAc;IAClE,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,MAAM,OAAO,GAAG,IAA+B,CAAC;IAEhD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,SAAS,CAAC,2BAA2B,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClF,UAAU,CAAC,sBAAsB,CAAC,yBAAyB,CAAC,GAAG,kBAAkB,CAAC;IACpF,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAiB;IACzD,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,MAAM,IAAI,GAAG,QAAmC,CAAC;IAEjD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,sBAAsB,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IAC3E,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,KAAgC,CAAC;QACpD,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACrC,UAAU,CAAC,sBAAsB,CAAC,6BAA6B,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC;QACxF,CAAC;QACD,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACtC,UAAU,CAAC,sBAAsB,CAAC,8BAA8B,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,UAAU,CAAC,SAAS,CAAC,0BAA0B,CAAC,GAAG,KAAK,CAAC;IAC3D,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,UAAU,CAAC,SAAS,CAAC,0BAA0B,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAA0B;IACtD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,eAAe,CAAC;QACzE,OAAO;YACL,IAAI,EAAE,cAAc,CAAC,KAAK;YAC1B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;SACzB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC;AACrC,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Wraps the OpenAI Agents SDK tracer to integrate with Agent 365 Observability.
+ */
+export { OpenAIAgentsTraceInstrumentor, OpenAIAgentsInstrumentationConfig } from './OpenAIAgentsTraceInstrumentor';
+export { OpenAIAgentsTraceProcessor } from './OpenAIAgentsTraceProcessor';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,6BAA6B,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AACnH,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,9 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+/**
+ * Wraps the OpenAI Agents SDK tracer to integrate with Agent 365 Observability.
+ */
+export { OpenAIAgentsTraceInstrumentor } from './OpenAIAgentsTraceInstrumentor';
+export { OpenAIAgentsTraceProcessor } from './OpenAIAgentsTraceProcessor';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;AAEjF;;GAEG;AAEH,OAAO,EAAE,6BAA6B,EAAqC,MAAM,iCAAiC,CAAC;AACnH,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC"}