@microsoft/agents-a365-tooling-extensions-openai 0.1.0-preview.103

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Microsoft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @microsoft/agents-a365-tooling-extensions-openai
+
+[![npm](https://img.shields.io/npm/v/@microsoft/agents-a365-tooling-extensions-openai?label=npm&logo=npm)](https://www.npmjs.com/package/@microsoft/agents-a365-tooling-extensions-openai)
+[![npm Downloads](https://img.shields.io/npm/dm/@microsoft/agents-a365-tooling-extensions-openai?label=Downloads&logo=npm)](https://www.npmjs.com/package/@microsoft/agents-a365-tooling-extensions-openai)
+
+OpenAI Agents SDK integration for the Microsoft Agent 365 Tooling SDK. This package enables seamless integration of MCP (Model Context Protocol) tool servers with OpenAI Agents, providing automatic tool discovery and registration.
+
+## Installation
+
+```bash
+npm install @microsoft/agents-a365-tooling-extensions-openai
+```
+
+## Usage
+
+For detailed usage examples and implementation guidance, see the [Microsoft Agent 365 Tooling Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/tooling?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/McpToolRegistrationService.d.ts

@@ -0,0 +1,120 @@
+import { ToolOptions } from '@microsoft/agents-a365-tooling';
+import { OperationResult, IConfigurationProvider } from '@microsoft/agents-a365-runtime';
+import { OpenAIToolingConfiguration } from './configuration';
+import { TurnContext, Authorization } from '@microsoft/agents-hosting';
+import { Agent, AgentInputItem } from '@openai/agents';
+import { OpenAIConversationsSession } from '@openai/agents-openai';
+/**
+ * Discover MCP servers and list tools formatted for the OpenAI Agents SDK.
+ * Uses listToolServers to fetch server configs.
+ */
+export declare class McpToolRegistrationService {
+    private readonly configService;
+    private readonly configProvider;
+    private readonly orchestratorName;
+    /**
+     * Construct a McpToolRegistrationService.
+     * @param configProvider Optional configuration provider. Defaults to defaultOpenAIToolingConfigurationProvider if not specified.
+     */
+    constructor(configProvider?: IConfigurationProvider<OpenAIToolingConfiguration>);
+    /**
+     * Registers MCP tool servers and updates agent options with discovered tools and server configs.
+     * Call this to enable dynamic OpenAI tool access based on the current MCP environment.
+     * @param agent The OpenAI Agent instance to which MCP servers will be added.
+     * @param authorization Authorization object for token exchange.
+     * @param authHandlerName The name of the auth handler to use for token exchange.
+     * @param turnContext The TurnContext of the current request.
+     * @param authToken Optional bearer token for MCP server access.
+     * @returns The updated Agent instance with registered MCP servers.
+     */
+    addToolServersToAgent(agent: Agent, authorization: Authorization, authHandlerName: string, turnContext: TurnContext, authToken: string): Promise<Agent>;
+    /**
+     * Sends chat history from an OpenAI Session to the MCP platform for real-time threat protection.
+     *
+     * This method extracts messages from the provided OpenAI Session using `getItems()`,
+     * converts them to the `ChatHistoryMessage` format, and sends them to the MCP platform.
+     *
+     * @param turnContext - The turn context containing conversation information.
+     * @param session - The OpenAI Session instance to extract messages from.
+     * @param limit - Optional limit on the number of messages to retrieve from the session.
+     * @param toolOptions - Optional tool options for customization.
+     * @returns A Promise resolving to an OperationResult indicating success or failure.
+     * @throws Error if turnContext is null/undefined.
+     * @throws Error if session is null/undefined.
+     * @throws Error if required turn context properties are missing.
+     *
+     * @example
+     * ```typescript
+     * const session = new OpenAIConversationsSession(sessionOptions);
+     * const result = await service.sendChatHistoryAsync(turnContext, session, 50);
+     * if (result.succeeded) {
+     *   console.log('Chat history sent successfully');
+     * } else {
+     *   console.error('Failed to send chat history:', result.errors);
+     * }
+     * ```
+     */
+    sendChatHistoryAsync(turnContext: TurnContext, session: OpenAIConversationsSession, limit?: number, toolOptions?: ToolOptions): Promise<OperationResult>;
+    /**
+     * Sends a list of OpenAI messages to the MCP platform for real-time threat protection.
+     *
+     * This method converts the provided AgentInputItem messages to `ChatHistoryMessage` format
+     * and sends them to the MCP platform.
+     *
+     * @param turnContext - The turn context containing conversation information.
+     * @param messages - Array of AgentInputItem messages to send.
+     * @param toolOptions - Optional ToolOptions for customization.
+     * @returns A Promise resolving to an OperationResult indicating success or failure.
+     * @throws Error if turnContext is null/undefined.
+     * @throws Error if messages is null/undefined.
+     * @throws Error if required turn context properties are missing.
+     *
+     * @example
+     * ```typescript
+     * const items = await session.getItems();
+     * const result = await service.sendChatHistoryMessagesAsync(turnContext, items);
+     * ```
+     */
+    sendChatHistoryMessagesAsync(turnContext: TurnContext, messages: AgentInputItem[], toolOptions?: ToolOptions): Promise<OperationResult>;
+    /**
+     * Converts OpenAI AgentInputItem messages to ChatHistoryMessage format.
+     * @param messages - Array of AgentInputItem messages to convert.
+     * @returns Array of successfully converted ChatHistoryMessage objects.
+     */
+    private convertToChatHistoryMessages;
+    /**
+     * Converts a single OpenAI message to ChatHistoryMessage format.
+     * @param message - The AgentInputItem to convert.
+     * @returns A ChatHistoryMessage object, or null if conversion fails.
+     */
+    private convertSingleMessage;
+    /**
+     * Extracts the role from an OpenAI message.
+     * Simply returns message.role directly without any transformation or validation.
+     * @param message - The AgentInputItem to extract the role from.
+     * @returns The role string from the message.
+     */
+    private extractRole;
+    /**
+     * Extracts content from an OpenAI message.
+     * @param message - The AgentInputItem to extract content from.
+     * @returns The extracted content string.
+     * @throws Error if content is empty or cannot be extracted.
+     */
+    private extractContent;
+    /**
+     * Extracts or generates an ID for a message.
+     * @param message - The AgentInputItem to extract or generate an ID for.
+     * @returns The message ID, either existing or newly generated UUID.
+     */
+    private extractId;
+    /**
+     * Extracts or generates a timestamp for a message.
+     * Note: AgentInputItem types do not have a standard timestamp property,
+     * so we always generate the current timestamp.
+     * @param _message - The AgentInputItem (unused, as timestamps are always generated).
+     * @returns The current Date.
+     */
+    private extractTimestamp;
+}
+//# sourceMappingURL=McpToolRegistrationService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"McpToolRegistrationService.d.ts","sourceRoot":"","sources":["../../src/McpToolRegistrationService.ts"],"names":[],"mappings":"AAIA,OAAO,EAA8C,WAAW,EAAsB,MAAM,gCAAgC,CAAC;AAC7H,OAAO,EAAgC,eAAe,EAAkB,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACvI,OAAO,EAAE,0BAA0B,EAA6C,MAAM,iBAAiB,CAAC;AAGxG,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGvE,OAAO,EAAE,KAAK,EAA2B,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;GAGG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqD;IACpF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;IAErD;;;OAGG;gBACS,cAAc,CAAC,EAAE,sBAAsB,CAAC,0BAA0B,CAAC;IAM/E;;;;;;;;;OASG;IACG,qBAAqB,CACzB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,CAAC;IAwCjB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,oBAAoB,CACxB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,0BAA0B,EACnC,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,eAAe,CAAC;IA4B3B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,4BAA4B,CAChC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,cAAc,EAAE,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,eAAe,CAAC;IAgC3B;;;;OAIG;IACH,OAAO,CAAC,4BAA4B;IAMpC;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAKnB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAwCtB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IASjB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;CAKzB"}

package/dist/cjs/McpToolRegistrationService.js

@@ -0,0 +1,265 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpToolRegistrationService = void 0;
+const uuid_1 = require("uuid");
+const agents_a365_tooling_1 = require("@microsoft/agents-a365-tooling");
+const agents_a365_runtime_1 = require("@microsoft/agents-a365-runtime");
+const configuration_1 = require("./configuration");
+// OpenAI Agents SDK
+const agents_1 = require("@openai/agents");
+/**
+ * Discover MCP servers and list tools formatted for the OpenAI Agents SDK.
+ * Uses listToolServers to fetch server configs.
+ */
+class McpToolRegistrationService {
+    /**
+     * Construct a McpToolRegistrationService.
+     * @param configProvider Optional configuration provider. Defaults to defaultOpenAIToolingConfigurationProvider if not specified.
+     */
+    constructor(configProvider) {
+        this.orchestratorName = "OpenAI";
+        this.configProvider = configProvider ?? configuration_1.defaultOpenAIToolingConfigurationProvider;
+        this.configService = new agents_a365_tooling_1.McpToolServerConfigurationService(this.configProvider);
+    }
+    /**
+     * Registers MCP tool servers and updates agent options with discovered tools and server configs.
+     * Call this to enable dynamic OpenAI tool access based on the current MCP environment.
+     * @param agent The OpenAI Agent instance to which MCP servers will be added.
+     * @param authorization Authorization object for token exchange.
+     * @param authHandlerName The name of the auth handler to use for token exchange.
+     * @param turnContext The TurnContext of the current request.
+     * @param authToken Optional bearer token for MCP server access.
+     * @returns The updated Agent instance with registered MCP servers.
+     */
+    async addToolServersToAgent(agent, authorization, authHandlerName, turnContext, authToken) {
+        if (!agent) {
+            throw new Error('Agent is Required');
+        }
+        if (!authToken) {
+            const scope = this.configProvider.getConfiguration().mcpPlatformAuthenticationScope;
+            authToken = await agents_a365_runtime_1.AgenticAuthenticationService.GetAgenticUserToken(authorization, authHandlerName, turnContext, [scope]);
+        }
+        // Validate the authentication token
+        agents_a365_tooling_1.Utility.ValidateAuthToken(authToken);
+        const options = { orchestratorName: this.orchestratorName };
+        const servers = await this.configService.listToolServers(turnContext, authorization, authHandlerName, authToken, options);
+        const mcpServers = [];
+        for (const server of servers) {
+            // Compose headers if values are available
+            const headers = agents_a365_tooling_1.Utility.GetToolRequestHeaders(authToken, turnContext, options);
+            // Create MCPServerStreamableHttp instance for OpenAI agents
+            const mcpServer = new agents_1.MCPServerStreamableHttp({
+                url: server.url,
+                name: server.mcpServerName,
+                requestInit: {
+                    headers: headers,
+                }
+            });
+            mcpServers.push(mcpServer);
+        }
+        agent.mcpServers = agent.mcpServers ?? [];
+        agent.mcpServers.push(...mcpServers);
+        return agent;
+    }
+    /**
+     * Sends chat history from an OpenAI Session to the MCP platform for real-time threat protection.
+     *
+     * This method extracts messages from the provided OpenAI Session using `getItems()`,
+     * converts them to the `ChatHistoryMessage` format, and sends them to the MCP platform.
+     *
+     * @param turnContext - The turn context containing conversation information.
+     * @param session - The OpenAI Session instance to extract messages from.
+     * @param limit - Optional limit on the number of messages to retrieve from the session.
+     * @param toolOptions - Optional tool options for customization.
+     * @returns A Promise resolving to an OperationResult indicating success or failure.
+     * @throws Error if turnContext is null/undefined.
+     * @throws Error if session is null/undefined.
+     * @throws Error if required turn context properties are missing.
+     *
+     * @example
+     * ```typescript
+     * const session = new OpenAIConversationsSession(sessionOptions);
+     * const result = await service.sendChatHistoryAsync(turnContext, session, 50);
+     * if (result.succeeded) {
+     *   console.log('Chat history sent successfully');
+     * } else {
+     *   console.error('Failed to send chat history:', result.errors);
+     * }
+     * ```
+     */
+    async sendChatHistoryAsync(turnContext, session, limit, toolOptions) {
+        // Validate inputs
+        if (!turnContext) {
+            throw new Error('turnContext is required');
+        }
+        if (!session) {
+            throw new Error('session is required');
+        }
+        let items;
+        try {
+            // Extract messages from session
+            items = await session.getItems(limit);
+        }
+        catch (err) {
+            // Convert errors from session.getItems() into a failed OperationResult
+            const error = err;
+            return agents_a365_runtime_1.OperationResult.failed(new agents_a365_runtime_1.OperationError(error));
+        }
+        // Delegate to the list-based method
+        // Validation errors from this method will propagate
+        return await this.sendChatHistoryMessagesAsync(turnContext, items, toolOptions);
+    }
+    /**
+     * Sends a list of OpenAI messages to the MCP platform for real-time threat protection.
+     *
+     * This method converts the provided AgentInputItem messages to `ChatHistoryMessage` format
+     * and sends them to the MCP platform.
+     *
+     * @param turnContext - The turn context containing conversation information.
+     * @param messages - Array of AgentInputItem messages to send.
+     * @param toolOptions - Optional ToolOptions for customization.
+     * @returns A Promise resolving to an OperationResult indicating success or failure.
+     * @throws Error if turnContext is null/undefined.
+     * @throws Error if messages is null/undefined.
+     * @throws Error if required turn context properties are missing.
+     *
+     * @example
+     * ```typescript
+     * const items = await session.getItems();
+     * const result = await service.sendChatHistoryMessagesAsync(turnContext, items);
+     * ```
+     */
+    async sendChatHistoryMessagesAsync(turnContext, messages, toolOptions) {
+        // Validate inputs
+        if (!turnContext) {
+            throw new Error('turnContext is required');
+        }
+        if (!messages) {
+            throw new Error('messages is required');
+        }
+        // Set default options
+        const effectiveOptions = {
+            orchestratorName: toolOptions?.orchestratorName ?? this.orchestratorName
+        };
+        let chatHistoryMessages;
+        try {
+            // Convert OpenAI messages to ChatHistoryMessage format
+            chatHistoryMessages = this.convertToChatHistoryMessages(messages);
+        }
+        catch (err) {
+            // Convert errors from message conversion into a failed OperationResult
+            const error = err;
+            return agents_a365_runtime_1.OperationResult.failed(new agents_a365_runtime_1.OperationError(error));
+        }
+        // Delegate to core service
+        return await this.configService.sendChatHistory(turnContext, chatHistoryMessages, effectiveOptions);
+    }
+    /**
+     * Converts OpenAI AgentInputItem messages to ChatHistoryMessage format.
+     * @param messages - Array of AgentInputItem messages to convert.
+     * @returns Array of successfully converted ChatHistoryMessage objects.
+     */
+    convertToChatHistoryMessages(messages) {
+        return messages
+            .map(msg => this.convertSingleMessage(msg))
+            .filter((msg) => msg !== null);
+    }
+    /**
+     * Converts a single OpenAI message to ChatHistoryMessage format.
+     * @param message - The AgentInputItem to convert.
+     * @returns A ChatHistoryMessage object, or null if conversion fails.
+     */
+    convertSingleMessage(message) {
+        try {
+            return {
+                id: this.extractId(message),
+                role: this.extractRole(message),
+                content: this.extractContent(message),
+                timestamp: this.extractTimestamp(message)
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Extracts the role from an OpenAI message.
+     * Simply returns message.role directly without any transformation or validation.
+     * @param message - The AgentInputItem to extract the role from.
+     * @returns The role string from the message.
+     */
+    extractRole(message) {
+        const { role } = message;
+        return role;
+    }
+    /**
+     * Extracts content from an OpenAI message.
+     * @param message - The AgentInputItem to extract content from.
+     * @returns The extracted content string.
+     * @throws Error if content is empty or cannot be extracted.
+     */
+    extractContent(message) {
+        let content;
+        const messageWithContent = message;
+        const messageWithText = message;
+        // Handle string content
+        if (typeof messageWithContent.content === 'string') {
+            content = messageWithContent.content;
+        }
+        // Handle array content (ContentPart[])
+        else if (Array.isArray(messageWithContent.content)) {
+            const textParts = messageWithContent.content
+                .filter((part) => {
+                if (typeof part === 'string')
+                    return true;
+                return part.type === 'text' || part.type === 'input_text' || (typeof part === 'object' && 'text' in part);
+            })
+                .map(part => {
+                if (typeof part === 'string')
+                    return part;
+                return part.text || '';
+            })
+                .filter(text => text.length > 0);
+            if (textParts.length > 0) {
+                content = textParts.join(' ');
+            }
+        }
+        // Try text property as fallback
+        else if (typeof messageWithText.text === 'string') {
+            content = messageWithText.text;
+        }
+        // Reject empty content
+        if (!content || content.trim().length === 0) {
+            throw new Error('Message content cannot be empty');
+        }
+        return content;
+    }
+    /**
+     * Extracts or generates an ID for a message.
+     * @param message - The AgentInputItem to extract or generate an ID for.
+     * @returns The message ID, either existing or newly generated UUID.
+     */
+    extractId(message) {
+        const messageWithId = message;
+        if (messageWithId.id) {
+            return messageWithId.id;
+        }
+        return (0, uuid_1.v4)();
+    }
+    /**
+     * Extracts or generates a timestamp for a message.
+     * Note: AgentInputItem types do not have a standard timestamp property,
+     * so we always generate the current timestamp.
+     * @param _message - The AgentInputItem (unused, as timestamps are always generated).
+     * @returns The current Date.
+     */
+    extractTimestamp(_message) {
+        // AgentInputItem types do not include timestamp properties.
+        // Always use current UTC time.
+        return new Date();
+    }
+}
+exports.McpToolRegistrationService = McpToolRegistrationService;
+//# sourceMappingURL=McpToolRegistrationService.js.map

package/dist/cjs/McpToolRegistrationService.js.map

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

package/dist/cjs/configuration/OpenAIToolingConfiguration.d.ts

@@ -0,0 +1,42 @@
+import { ToolingConfiguration } from '@microsoft/agents-a365-tooling';
+import { OpenAIToolingConfigurationOptions } from './OpenAIToolingConfigurationOptions';
+/**
+ * Configuration for OpenAI tooling extension package.
+ * Inherits all tooling and runtime settings.
+ *
+ * ## Why This Class Exists
+ *
+ * Although this class currently adds no new settings beyond what ToolingConfiguration
+ * provides, it exists for several important reasons:
+ *
+ * 1. **Type Safety**: Allows OpenAI-specific services to declare their dependency on
+ *    `IConfigurationProvider<OpenAIToolingConfiguration>`, making the configuration
+ *    contract explicit and enabling compile-time checking.
+ *
+ * 2. **Extension Point**: Provides a clear place to add OpenAI-specific settings
+ *    (e.g., Agents SDK timeouts, thread polling intervals, run limits) without
+ *    breaking existing code when those needs arise.
+ *
+ * 3. **Consistent Pattern**: Maintains symmetry with other extension packages
+ *    (Claude, LangChain), making the SDK easier to understand and navigate.
+ *
+ * 4. **Dependency Injection**: Services can be designed to accept this specific
+ *    configuration type, enabling proper IoC patterns and testability.
+ *
+ * @example
+ * ```typescript
+ * // Service declares explicit dependency on OpenAI configuration
+ * class OpenAIService {
+ *   constructor(private configProvider: IConfigurationProvider<OpenAIToolingConfiguration>) {}
+ * }
+ *
+ * // Future: Add OpenAI-specific settings without breaking changes
+ * class OpenAIToolingConfiguration extends ToolingConfiguration {
+ *   get threadPollingInterval(): number { ... }
+ * }
+ * ```
+ */
+export declare class OpenAIToolingConfiguration extends ToolingConfiguration {
+    constructor(overrides?: OpenAIToolingConfigurationOptions);
+}
+//# sourceMappingURL=OpenAIToolingConfiguration.d.ts.map

package/dist/cjs/configuration/OpenAIToolingConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIToolingConfiguration.d.ts","sourceRoot":"","sources":["../../../src/configuration/OpenAIToolingConfiguration.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AAExF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,0BAA2B,SAAQ,oBAAoB;gBACtD,SAAS,CAAC,EAAE,iCAAiC;CAK1D"}

package/dist/cjs/configuration/OpenAIToolingConfiguration.js

@@ -0,0 +1,49 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIToolingConfiguration = void 0;
+const agents_a365_tooling_1 = require("@microsoft/agents-a365-tooling");
+/**
+ * Configuration for OpenAI tooling extension package.
+ * Inherits all tooling and runtime settings.
+ *
+ * ## Why This Class Exists
+ *
+ * Although this class currently adds no new settings beyond what ToolingConfiguration
+ * provides, it exists for several important reasons:
+ *
+ * 1. **Type Safety**: Allows OpenAI-specific services to declare their dependency on
+ *    `IConfigurationProvider<OpenAIToolingConfiguration>`, making the configuration
+ *    contract explicit and enabling compile-time checking.
+ *
+ * 2. **Extension Point**: Provides a clear place to add OpenAI-specific settings
+ *    (e.g., Agents SDK timeouts, thread polling intervals, run limits) without
+ *    breaking existing code when those needs arise.
+ *
+ * 3. **Consistent Pattern**: Maintains symmetry with other extension packages
+ *    (Claude, LangChain), making the SDK easier to understand and navigate.
+ *
+ * 4. **Dependency Injection**: Services can be designed to accept this specific
+ *    configuration type, enabling proper IoC patterns and testability.
+ *
+ * @example
+ * ```typescript
+ * // Service declares explicit dependency on OpenAI configuration
+ * class OpenAIService {
+ *   constructor(private configProvider: IConfigurationProvider<OpenAIToolingConfiguration>) {}
+ * }
+ *
+ * // Future: Add OpenAI-specific settings without breaking changes
+ * class OpenAIToolingConfiguration extends ToolingConfiguration {
+ *   get threadPollingInterval(): number { ... }
+ * }
+ * ```
+ */
+class OpenAIToolingConfiguration extends agents_a365_tooling_1.ToolingConfiguration {
+    constructor(overrides) {
+        super(overrides);
+    }
+}
+exports.OpenAIToolingConfiguration = OpenAIToolingConfiguration;
+//# sourceMappingURL=OpenAIToolingConfiguration.js.map

package/dist/cjs/configuration/OpenAIToolingConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIToolingConfiguration.js","sourceRoot":"","sources":["../../../src/configuration/OpenAIToolingConfiguration.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC,wEAAsE;AAGtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAa,0BAA2B,SAAQ,0CAAoB;IAClE,YAAY,SAA6C;QACvD,KAAK,CAAC,SAAS,CAAC,CAAC;IACnB,CAAC;CAGF;AAND,gEAMC"}

package/dist/cjs/configuration/OpenAIToolingConfigurationOptions.d.ts

@@ -0,0 +1,9 @@
+import { ToolingConfigurationOptions } from '@microsoft/agents-a365-tooling';
+/**
+ * OpenAI tooling configuration options - extends tooling options.
+ * All overrides are functions called on each property access.
+ *
+ * Currently no additional settings; this type exists for future extensibility.
+ */
+export type OpenAIToolingConfigurationOptions = ToolingConfigurationOptions;
+//# sourceMappingURL=OpenAIToolingConfigurationOptions.d.ts.map

package/dist/cjs/configuration/OpenAIToolingConfigurationOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIToolingConfigurationOptions.d.ts","sourceRoot":"","sources":["../../../src/configuration/OpenAIToolingConfigurationOptions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,MAAM,iCAAiC,GAAG,2BAA2B,CAAC"}

package/dist/cjs/configuration/OpenAIToolingConfigurationOptions.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=OpenAIToolingConfigurationOptions.js.map

package/dist/cjs/configuration/OpenAIToolingConfigurationOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIToolingConfigurationOptions.js","sourceRoot":"","sources":["../../../src/configuration/OpenAIToolingConfigurationOptions.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC"}

package/dist/cjs/configuration/index.d.ts

@@ -0,0 +1,9 @@
+import { DefaultConfigurationProvider } from '@microsoft/agents-a365-runtime';
+import { OpenAIToolingConfiguration } from './OpenAIToolingConfiguration';
+export * from './OpenAIToolingConfigurationOptions';
+export * from './OpenAIToolingConfiguration';
+/**
+ * Shared default provider for OpenAIToolingConfiguration.
+ */
+export declare const defaultOpenAIToolingConfigurationProvider: DefaultConfigurationProvider<OpenAIToolingConfiguration>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/configuration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/configuration/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,yCAAyC,0DACoB,CAAC"}

package/dist/cjs/configuration/index.js

@@ -0,0 +1,28 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultOpenAIToolingConfigurationProvider = void 0;
+const agents_a365_runtime_1 = require("@microsoft/agents-a365-runtime");
+const OpenAIToolingConfiguration_1 = require("./OpenAIToolingConfiguration");
+__exportStar(require("./OpenAIToolingConfigurationOptions"), exports);
+__exportStar(require("./OpenAIToolingConfiguration"), exports);
+/**
+ * Shared default provider for OpenAIToolingConfiguration.
+ */
+exports.defaultOpenAIToolingConfigurationProvider = new agents_a365_runtime_1.DefaultConfigurationProvider(() => new OpenAIToolingConfiguration_1.OpenAIToolingConfiguration());
+//# sourceMappingURL=index.js.map

package/dist/cjs/configuration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/configuration/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;;;;;;;;;;;;;;;AAElC,wEAA8E;AAC9E,6EAA0E;AAE1E,sEAAoD;AACpD,+DAA6C;AAE7C;;GAEG;AACU,QAAA,yCAAyC,GACpD,IAAI,kDAA4B,CAAC,GAAG,EAAE,CAAC,IAAI,uDAA0B,EAAE,CAAC,CAAC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,4 @@
+export * from './McpToolRegistrationService';
+export * from './configuration';
+export { OpenAIConversationsSession } from '@openai/agents-openai';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC"}