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

package/README.md

@@ -0,0 +1,33 @@
+# @microsoft/agents-a365-observability-extensions-openai
+
+[![npm](https://img.shields.io/npm/v/@microsoft/agents-a365-observability-extensions-openai?label=npm&logo=npm)](https://www.npmjs.com/package/@microsoft/agents-a365-observability-extensions-openai)
+[![npm Downloads](https://img.shields.io/npm/dm/@microsoft/agents-a365-observability-extensions-openai?label=Downloads&logo=npm)](https://www.npmjs.com/package/@microsoft/agents-a365-observability-extensions-openai)
+
+OpenAI Agents SDK instrumentation for the Microsoft Agent 365 Observability SDK. This package provides automatic OpenTelemetry tracing and telemetry collection for OpenAI Agents SDK operations, including agent execution, function calls, and AI model interactions.
+
+## Installation
+
+```bash
+npm install @microsoft/agents-a365-observability-extensions-openai
+```
+
+## Usage
+
+For detailed usage examples and implementation guidance, see the [Microsoft Agent 365 Observability Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/observability?tabs=nodejs).
+
+## Support
+
+For issues, questions, or feedback:
+
+- File issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section
+- See the [main documentation](../../README.md) for more information
+
+## Trademarks
+
+*Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.*
+
+## License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the MIT License - see the [LICENSE](../../LICENSE.md) file for details

package/dist/cjs/Constants.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Constants for OpenAI Agents SDK wrapper
+ */
+export declare const GEN_AI_SPAN_KIND_AGENT_KEY = "agent";
+export declare const GEN_AI_SPAN_KIND_TOOL_KEY = "tool";
+export declare const GEN_AI_SPAN_KIND_CHAIN_KEY = "chain";
+export declare const GEN_AI_SPAN_KIND_LLM_KEY = "chat";
+export declare const GEN_AI_SPAN_KIND_RETRIEVER_KEY = "retriever";
+export declare const GEN_AI_SPAN_KIND_EMBEDDING_KEY = "embedding";
+export declare const GEN_AI_SPAN_KIND_RERANKER_KEY = "reranker";
+export declare const GEN_AI_SPAN_KIND_GUARDRAIL_KEY = "guardrail";
+export declare const GEN_AI_SPAN_KIND_EVALUATOR_KEY = "evaluator";
+export declare const GEN_AI_SPAN_KIND_UNKNOWN_KEY = "unknown";
+export declare const GEN_AI_MESSAGE_ROLE = "message_role";
+export declare const GEN_AI_MESSAGE_CONTENT = "message_content";
+export declare const GEN_AI_MESSAGE_CONTENTS = "message_contents";
+export declare const GEN_AI_MESSAGE_CONTENT_TYPE = "content_type";
+export declare const GEN_AI_MESSAGE_TOOL_CALLS = "message_tool_calls";
+export declare const GEN_AI_MESSAGE_TOOL_CALL_ID = "message_tool_id";
+export declare const GEN_AI_MESSAGE_TOOL_CALL_NAME = "message_tool_name";
+export declare const GEN_AI_TOOL_JSON_SCHEMA = "tool_json_schema";
+export declare const GEN_AI_LLM_TOKEN_COUNT_PROMPT_DETAILS_CACHED_READ = "llm_token_count_prompt_details_cached_read";
+export declare const GEN_AI_LLM_TOKEN_COUNT_COMPLETION_DETAILS_REASONING = "llm_token_count_completion_details_reasoning";
+export declare const GEN_AI_GRAPH_NODE_ID = "graph_node_id";
+export declare const GEN_AI_GRAPH_NODE_PARENT_ID = "graph_node_parent_id";
+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";
+//# sourceMappingURL=Constants.d.ts.map

package/dist/cjs/Constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constants.d.ts","sourceRoot":"","sources":["../../src/Constants.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAClD,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAChD,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAClD,eAAO,MAAM,wBAAwB,SAAS,CAAC;AAC/C,eAAO,MAAM,8BAA8B,cAAc,CAAC;AAC1D,eAAO,MAAM,8BAA8B,cAAc,CAAC;AAC1D,eAAO,MAAM,6BAA6B,aAAa,CAAC;AACxD,eAAO,MAAM,8BAA8B,cAAc,CAAC;AAC1D,eAAO,MAAM,8BAA8B,cAAc,CAAC;AAC1D,eAAO,MAAM,4BAA4B,YAAY,CAAC;AAGtD,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AACxD,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAC1D,eAAO,MAAM,2BAA2B,iBAAiB,CAAC;AAC1D,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAC9D,eAAO,MAAM,2BAA2B,oBAAoB,CAAC;AAC7D,eAAO,MAAM,6BAA6B,sBAAsB,CAAC;AACjE,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAC1D,eAAO,MAAM,iDAAiD,+CAA+C,CAAC;AAC9G,eAAO,MAAM,mDAAmD,iDAAiD,CAAC;AAClH,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAElE,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AACnE,eAAO,MAAM,2BAA2B,4BAA4B,CAAC;AACrE,eAAO,MAAM,4BAA4B,6BAA6B,CAAC"}

package/dist/cjs/Constants.js

@@ -0,0 +1,37 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GEN_AI_EXECUTION_PAYLOAD_KEY = exports.GEN_AI_RESPONSE_CONTENT_KEY = exports.GEN_AI_REQUEST_CONTENT_KEY = exports.GEN_AI_GRAPH_NODE_PARENT_ID = exports.GEN_AI_GRAPH_NODE_ID = exports.GEN_AI_LLM_TOKEN_COUNT_COMPLETION_DETAILS_REASONING = exports.GEN_AI_LLM_TOKEN_COUNT_PROMPT_DETAILS_CACHED_READ = exports.GEN_AI_TOOL_JSON_SCHEMA = exports.GEN_AI_MESSAGE_TOOL_CALL_NAME = exports.GEN_AI_MESSAGE_TOOL_CALL_ID = exports.GEN_AI_MESSAGE_TOOL_CALLS = exports.GEN_AI_MESSAGE_CONTENT_TYPE = exports.GEN_AI_MESSAGE_CONTENTS = exports.GEN_AI_MESSAGE_CONTENT = exports.GEN_AI_MESSAGE_ROLE = exports.GEN_AI_SPAN_KIND_UNKNOWN_KEY = exports.GEN_AI_SPAN_KIND_EVALUATOR_KEY = exports.GEN_AI_SPAN_KIND_GUARDRAIL_KEY = exports.GEN_AI_SPAN_KIND_RERANKER_KEY = exports.GEN_AI_SPAN_KIND_EMBEDDING_KEY = exports.GEN_AI_SPAN_KIND_RETRIEVER_KEY = exports.GEN_AI_SPAN_KIND_LLM_KEY = exports.GEN_AI_SPAN_KIND_CHAIN_KEY = exports.GEN_AI_SPAN_KIND_TOOL_KEY = exports.GEN_AI_SPAN_KIND_AGENT_KEY = void 0;
+/**
+ * Constants for OpenAI Agents SDK wrapper
+ */
+// Span Attribute Types
+exports.GEN_AI_SPAN_KIND_AGENT_KEY = 'agent';
+exports.GEN_AI_SPAN_KIND_TOOL_KEY = 'tool';
+exports.GEN_AI_SPAN_KIND_CHAIN_KEY = 'chain';
+exports.GEN_AI_SPAN_KIND_LLM_KEY = 'chat';
+exports.GEN_AI_SPAN_KIND_RETRIEVER_KEY = 'retriever';
+exports.GEN_AI_SPAN_KIND_EMBEDDING_KEY = 'embedding';
+exports.GEN_AI_SPAN_KIND_RERANKER_KEY = 'reranker';
+exports.GEN_AI_SPAN_KIND_GUARDRAIL_KEY = 'guardrail';
+exports.GEN_AI_SPAN_KIND_EVALUATOR_KEY = 'evaluator';
+exports.GEN_AI_SPAN_KIND_UNKNOWN_KEY = 'unknown';
+// Message Prefixes
+exports.GEN_AI_MESSAGE_ROLE = 'message_role';
+exports.GEN_AI_MESSAGE_CONTENT = 'message_content';
+exports.GEN_AI_MESSAGE_CONTENTS = 'message_contents';
+exports.GEN_AI_MESSAGE_CONTENT_TYPE = 'content_type';
+exports.GEN_AI_MESSAGE_TOOL_CALLS = 'message_tool_calls';
+exports.GEN_AI_MESSAGE_TOOL_CALL_ID = 'message_tool_id';
+exports.GEN_AI_MESSAGE_TOOL_CALL_NAME = 'message_tool_name';
+exports.GEN_AI_TOOL_JSON_SCHEMA = 'tool_json_schema';
+exports.GEN_AI_LLM_TOKEN_COUNT_PROMPT_DETAILS_CACHED_READ = 'llm_token_count_prompt_details_cached_read';
+exports.GEN_AI_LLM_TOKEN_COUNT_COMPLETION_DETAILS_REASONING = 'llm_token_count_completion_details_reasoning';
+exports.GEN_AI_GRAPH_NODE_ID = 'graph_node_id';
+exports.GEN_AI_GRAPH_NODE_PARENT_ID = 'graph_node_parent_id';
+exports.GEN_AI_REQUEST_CONTENT_KEY = 'gen_ai.request.content';
+exports.GEN_AI_RESPONSE_CONTENT_KEY = 'gen_ai.response.content';
+exports.GEN_AI_EXECUTION_PAYLOAD_KEY = 'gen_ai.execution.payload';
+//# sourceMappingURL=Constants.js.map

package/dist/cjs/Constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constants.js","sourceRoot":"","sources":["../../src/Constants.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;;;AAEjF;;GAEG;AAEH,uBAAuB;AACV,QAAA,0BAA0B,GAAG,OAAO,CAAC;AACrC,QAAA,yBAAyB,GAAG,MAAM,CAAC;AACnC,QAAA,0BAA0B,GAAG,OAAO,CAAC;AACrC,QAAA,wBAAwB,GAAG,MAAM,CAAC;AAClC,QAAA,8BAA8B,GAAG,WAAW,CAAC;AAC7C,QAAA,8BAA8B,GAAG,WAAW,CAAC;AAC7C,QAAA,6BAA6B,GAAG,UAAU,CAAC;AAC3C,QAAA,8BAA8B,GAAG,WAAW,CAAC;AAC7C,QAAA,8BAA8B,GAAG,WAAW,CAAC;AAC7C,QAAA,4BAA4B,GAAG,SAAS,CAAC;AAEtD,mBAAmB;AACN,QAAA,mBAAmB,GAAG,cAAc,CAAC;AACrC,QAAA,sBAAsB,GAAG,iBAAiB,CAAC;AAC3C,QAAA,uBAAuB,GAAG,kBAAkB,CAAC;AAC7C,QAAA,2BAA2B,GAAG,cAAc,CAAC;AAC7C,QAAA,yBAAyB,GAAG,oBAAoB,CAAC;AACjD,QAAA,2BAA2B,GAAG,iBAAiB,CAAC;AAChD,QAAA,6BAA6B,GAAG,mBAAmB,CAAC;AACpD,QAAA,uBAAuB,GAAG,kBAAkB,CAAC;AAC7C,QAAA,iDAAiD,GAAG,4CAA4C,CAAC;AACjG,QAAA,mDAAmD,GAAG,8CAA8C,CAAC;AACrG,QAAA,oBAAoB,GAAG,eAAe,CAAC;AACvC,QAAA,2BAA2B,GAAG,sBAAsB,CAAC;AAErD,QAAA,0BAA0B,GAAG,wBAAwB,CAAC;AACtD,QAAA,2BAA2B,GAAG,yBAAyB,CAAC;AACxD,QAAA,4BAA4B,GAAG,0BAA0B,CAAC"}

package/dist/cjs/OpenAIAgentsTraceInstrumentor.d.ts

@@ -0,0 +1,43 @@
+import { InstrumentationBase, InstrumentationConfig, InstrumentationModuleDefinition } from '@opentelemetry/instrumentation';
+import { OpenAIAgentsTraceProcessor } from './OpenAIAgentsTraceProcessor';
+/**
+ * Configuration options for the OpenAI Agents instrument
+ */
+export interface OpenAIAgentsInstrumentationConfig extends InstrumentationConfig {
+    enabled?: boolean;
+    tracerName?: string;
+    tracerVersion?: string;
+}
+/**
+ * Instrumentor for OpenAI Agents SDK
+ * Automatically instruments the @openai/agents package to send traces to OpenTelemetry
+ */
+export declare class OpenAIAgentsTraceInstrumentor extends InstrumentationBase<OpenAIAgentsInstrumentationConfig> {
+    private processor?;
+    private _hasBeenEnabled;
+    constructor(config?: OpenAIAgentsInstrumentationConfig);
+    /**
+     * Initialize the instrumentation modules
+     * This defines which npm packages to instrument
+     */
+    protected init(): InstrumentationModuleDefinition;
+    /**
+     * Returns the packages this instrumentation depends on
+     */
+    instrumentationDependencies(): readonly string[];
+    /**
+     * Enable instrumentation
+     * Sets up the trace processor and registers it with the OpenAI Agents SDK
+     */
+    enable(): void;
+    /**
+     * Disable instrumentation
+     * Cleans up the trace processor and unregisters it
+     */
+    disable(): void;
+    /**
+     * Get the trace processor instance
+     */
+    getProcessor(): OpenAIAgentsTraceProcessor | undefined;
+}
+//# sourceMappingURL=OpenAIAgentsTraceInstrumentor.d.ts.map

package/dist/cjs/OpenAIAgentsTraceInstrumentor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIAgentsTraceInstrumentor.d.ts","sourceRoot":"","sources":["../../src/OpenAIAgentsTraceInstrumentor.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAE7H,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAG1E;;GAEG;AACH,MAAM,WAAW,iCAAkC,SAAQ,qBAAqB;IAE9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,6BAA8B,SAAQ,mBAAmB,CAAC,iCAAiC,CAAC;IACvG,OAAO,CAAC,SAAS,CAAC,CAA6B;IAC/C,OAAO,CAAC,eAAe,CAAS;gBAEpB,MAAM,GAAE,iCAAsC;IAmB1D;;;OAGG;IACH,SAAS,CAAC,IAAI,IAAI,+BAA+B;IAQjD;;OAEG;IACI,2BAA2B,IAAI,SAAS,MAAM,EAAE;IAIvD;;;OAGG;IACa,MAAM,IAAI,IAAI;IAkC9B;;;OAGG;IACa,OAAO,IAAI,IAAI;IAmB/B;;OAEG;IACI,YAAY,IAAI,0BAA0B,GAAG,SAAS;CAG9D"}

package/dist/cjs/OpenAIAgentsTraceInstrumentor.js

@@ -0,0 +1,108 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIAgentsTraceInstrumentor = void 0;
+/**
+ * Instrumentor for OpenAI Agents SDK
+ * Extends OpenTelemetry's InstrumentationBase to provide automatic tracing
+ */
+const api_1 = require("@opentelemetry/api");
+const instrumentation_1 = require("@opentelemetry/instrumentation");
+const agents_a365_observability_1 = require("@microsoft/agents-a365-observability");
+const OpenAIAgentsTraceProcessor_1 = require("./OpenAIAgentsTraceProcessor");
+const agents_1 = require("@openai/agents");
+/**
+ * Instrumentor for OpenAI Agents SDK
+ * Automatically instruments the @openai/agents package to send traces to OpenTelemetry
+ */
+class OpenAIAgentsTraceInstrumentor extends instrumentation_1.InstrumentationBase {
+    constructor(config = {}) {
+        if (!agents_a365_observability_1.ObservabilityManager.getInstance()) {
+            throw new Error('ObservabilityManager is not configured yet. Please configure ObservabilityManager before initializing this instrumentor.');
+        }
+        const configWithDefaults = {
+            enabled: false,
+            ...config
+        };
+        super('agent365-openai-agents-instrumentor', '1.0.0', configWithDefaults);
+        this._hasBeenEnabled = false;
+    }
+    /**
+     * Initialize the instrumentation modules
+     * This defines which npm packages to instrument
+     */
+    init() {
+        return {
+            name: '@openai/agents',
+            supportedVersions: ['>=0.1.5'],
+            files: [],
+        };
+    }
+    /**
+     * Returns the packages this instrumentation depends on
+     */
+    instrumentationDependencies() {
+        return ['@openai/agents >= 0.1.5'];
+    }
+    /**
+     * Enable instrumentation
+     * Sets up the trace processor and registers it with the OpenAI Agents SDK
+     */
+    enable() {
+        // Prevent double-enabling
+        if (this._hasBeenEnabled) {
+            return;
+        }
+        this._hasBeenEnabled = true;
+        // Enable tracing in the OpenAI Agents SDK (it's disabled by default)
+        (0, agents_1.setTracingDisabled)(false);
+        // Get tracer name and version from config
+        const tracerName = this._config.tracerName;
+        const tracerVersion = this._config.tracerVersion;
+        // Get the configured tracer using OpenTelemetry API
+        const agent365Tracer = api_1.trace.getTracer(tracerName ?? 'agent365-openai-agents', tracerVersion);
+        // Get tracer provider
+        api_1.trace.getTracerProvider();
+        this.processor = new OpenAIAgentsTraceProcessor_1.OpenAIAgentsTraceProcessor(agent365Tracer);
+        // Register the processor directly using the imported setTraceProcessors function
+        // This bypasses the OpenTelemetry instrumentation patching mechanism
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            (0, agents_1.setTraceProcessors)([this.processor]);
+        }
+        catch (error) {
+            // Silent failure - processor registration failed
+        }
+        super.enable();
+    }
+    /**
+     * Disable instrumentation
+     * Cleans up the trace processor and unregisters it
+     */
+    disable() {
+        if (this.processor) {
+            this.processor.shutdown();
+            this.processor = undefined;
+        }
+        // Reset flag to allow re-enabling
+        this._hasBeenEnabled = false;
+        // Reset trace processors using direct import
+        try {
+            (0, agents_1.setTraceProcessors)([]);
+        }
+        catch (error) {
+            // Silent failure - processor cleanup failed
+        }
+        super.disable();
+    }
+    /**
+     * Get the trace processor instance
+     */
+    getProcessor() {
+        return this.processor;
+    }
+}
+exports.OpenAIAgentsTraceInstrumentor = OpenAIAgentsTraceInstrumentor;
+//# sourceMappingURL=OpenAIAgentsTraceInstrumentor.js.map

package/dist/cjs/OpenAIAgentsTraceInstrumentor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIAgentsTraceInstrumentor.js","sourceRoot":"","sources":["../../src/OpenAIAgentsTraceInstrumentor.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;;;AAEjF;;;GAGG;AAEH,4CAA2C;AAC3C,oEAA6H;AAC7H,oFAA4E;AAC5E,6EAA0E;AAC1E,2CAA0F;AAY1F;;;GAGG;AACH,MAAa,6BAA8B,SAAQ,qCAAsD;IAIvG,YAAY,SAA4C,EAAE;QACxD,IAAI,CAAC,gDAAoB,CAAC,WAAW,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,0HAA0H,CAC3H,CAAC;QACJ,CAAC;QAED,MAAM,kBAAkB,GAAG;YACzB,OAAO,EAAE,KAAK;YACd,GAAG,MAAM;SACV,CAAC;QAEF,KAAK,CACH,qCAAqC,EACrC,OAAO,EACP,kBAAkB,CACnB,CAAC;QAlBI,oBAAe,GAAG,KAAK,CAAC;IAmBhC,CAAC;IAED;;;OAGG;IACO,IAAI;QACZ,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,iBAAiB,EAAE,CAAC,SAAS,CAAC;YAC9B,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,2BAA2B;QAChC,OAAO,CAAC,yBAAyB,CAAU,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACa,MAAM;QACpB,0BAA0B;QAC1B,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAE5B,qEAAqE;QACrE,IAAA,2BAAkB,EAAC,KAAK,CAAC,CAAC;QAE1B,0CAA0C;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;QAEjD,oDAAoD;QACpD,MAAM,cAAc,GAAG,WAAK,CAAC,SAAS,CAAC,UAAU,IAAI,wBAAwB,EAAE,aAAa,CAAC,CAAC;QAE9F,sBAAsB;QACtB,WAAK,CAAC,iBAAiB,EAAE,CAAC;QAE1B,IAAI,CAAC,SAAS,GAAG,IAAI,uDAA0B,CAAC,cAAc,CAAC,CAAC;QAEhE,iFAAiF;QACjF,qEAAqE;QACrE,IAAI,CAAC;YACH,8DAA8D;YAC9D,IAAA,2BAAkB,EAAC,CAAC,IAAI,CAAC,SAA6B,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iDAAiD;QACnD,CAAC;QAED,KAAK,CAAC,MAAM,EAAE,CAAC;IACjB,CAAC;IAED;;;OAGG;IACa,OAAO;QACrB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,CAAC;QAED,kCAAkC;QAClC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAE7B,6CAA6C;QAC7C,IAAI,CAAC;YACH,IAAA,2BAAkB,EAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,4CAA4C;QAC9C,CAAC;QAED,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF;AA7GD,sEA6GC"}

package/dist/cjs/OpenAIAgentsTraceProcessor.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Trace processor for OpenAI Agents SDK
+ * Converts OpenAI Agents SDK spans to OpenTelemetry spans
+ */
+import { Tracer as OtelTracer } from '@opentelemetry/api';
+import { Span as AgentsSpan, SpanData } from '@openai/agents-core/dist/tracing/spans';
+import { Trace as AgentTrace } from '@openai/agents-core/dist/tracing/traces';
+import { TracingProcessor } from '@openai/agents-core/dist/tracing/processor';
+/**
+ * Processor for OpenAI Agents SDK traces
+ */
+export declare class OpenAIAgentsTraceProcessor implements TracingProcessor {
+    private static readonly MAX_HANDOFFS_IN_FLIGHT;
+    private readonly tracer;
+    private readonly rootSpans;
+    private readonly otelSpans;
+    private readonly tokens;
+    private readonly reverseHandoffsDict;
+    private readonly spanNames;
+    private readonly keyMappings;
+    constructor(tracer: OtelTracer);
+    private getNewKey;
+    /**
+     * Called to initialize the processor
+     */
+    start(): Promise<void>;
+    /**
+     * Called when a trace starts
+     */
+    onTraceStart(_trace: AgentTrace): Promise<void>;
+    /**
+     * Called when a trace ends
+     */
+    onTraceEnd(trace: AgentTrace): Promise<void>;
+    /**
+     * Called when a span starts
+     */
+    onSpanStart(span: AgentsSpan<SpanData>): Promise<void>;
+    /**
+     * Called when a span ends
+     */
+    onSpanEnd(span: AgentsSpan<SpanData>): Promise<void>;
+    /**
+     * Process span data based on type
+     */
+    private processSpanData;
+    /**
+     * Process response span data
+     */
+    private processResponseSpanData;
+    /**
+     * Process generation span data
+     */
+    private processGenerationSpanData;
+    /**
+     * Process function/tool span data
+     */
+    private processFunctionSpanData;
+    /**
+     * Process MCP list tools span data
+     */
+    private processMCPListToolsSpanData;
+    /**
+     * Process handoff span data
+     */
+    private processHandoffSpanData;
+    /**
+     * Process agent span data
+     */
+    private processAgentSpanData;
+    /**
+     * Stamp custom parent reference
+     */
+    private stampCustomParent;
+    /**
+     * Force flush
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Shutdown
+     */
+    shutdown(_timeout?: number): Promise<void>;
+}
+//# sourceMappingURL=OpenAIAgentsTraceProcessor.d.ts.map

package/dist/cjs/OpenAIAgentsTraceProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIAgentsTraceProcessor.d.ts","sourceRoot":"","sources":["../../src/OpenAIAgentsTraceProcessor.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH,OAAO,EAAiD,MAAM,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIzG,OAAO,EACL,IAAI,IAAI,UAAU,EAClB,QAAQ,EAET,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAO9E;;GAEG;AACH,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAQ;IAEtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkC;IAEtE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAE9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAOzB;gBAES,MAAM,EAAE,UAAU;IAI9B,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;IACU,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D;;OAEG;IACU,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzD;;OAEG;IACU,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDnE;;OAEG;IACU,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CjE;;OAEG;IACH,OAAO,CAAC,eAAe;IA8BvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqD/B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAqBjC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAmBnC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACU,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMxD"}