@microsoft/agents-a365-tooling 0.1.0-preview.30

package/README.md

@@ -0,0 +1,33 @@
+# @microsoft/agents-a365-tooling
+
+[![npm](https://img.shields.io/npm/v/@microsoft/agents-a365-tooling?label=npm&logo=npm)](https://www.npmjs.com/package/@microsoft/agents-a365-tooling)
+[![npm Downloads](https://img.shields.io/npm/dm/@microsoft/agents-a365-tooling?label=Downloads&logo=npm)](https://www.npmjs.com/package/@microsoft/agents-a365-tooling)
+
+Core tooling functionality for MCP (Model Context Protocol) tool server management in applications built with the Microsoft Agent 365 SDK. This package provides the foundation for discovering, registering, and managing tool servers across different AI frameworks.
+
+## Installation
+
+```bash
+npm install @microsoft/agents-a365-tooling
+```
+
+## 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/McpToolServerConfigurationService.d.ts

@@ -0,0 +1,63 @@
+import { MCPServerConfig, McpClientTool } from './contracts';
+/**
+ * Service responsible for discovering and normalizing MCP (Model Context Protocol)
+ * tool servers and producing configuration objects consumable by the Claude SDK.
+ */
+export declare class McpToolServerConfigurationService {
+    private readonly logger;
+    /**
+     * Construct a McpToolServerConfigurationService.
+     */
+    constructor();
+    /**
+     * Return MCP server definitions for the given agent. In development (NODE_ENV=Development) this reads the local ToolingManifest.json; otherwise it queries the remote tooling gateway.
+     *
+     * @param agenticAppId The agentic app id for which to discover servers.
+     * @param authToken Optional bearer token used when querying the remote tooling gateway.
+     * @returns A promise resolving to an array of normalized MCP server configuration objects.
+     */
+    listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>;
+    /**
+     * Connect to the MCP server and return tools with names prefixed by the server name.
+     * Throws if the server URL is missing or the client fails to list tools.
+     */
+    getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>;
+    /**
+     * Query the tooling gateway for MCP servers for the specified agent and normalize each entry's mcpServerUniqueName into a full URL using Utility.BuildMcpServerUrl.
+     * Throws an error if the gateway call fails.
+     *
+     * @param agenticAppId The agentic app id used by the tooling gateway to scope results.
+     * @param authToken Optional Bearer token to include in the Authorization header when calling the gateway.
+     * @throws Error when the gateway call fails or returns an unexpected payload.
+     */
+    private getMCPServerConfigsFromToolingGateway;
+    /**
+     * Read MCP servers from a local ToolingManifest.json file (development only).
+     * Searches process.cwd() and process.argv[1] for the manifest file.
+     *
+     * Reads MCP server configurations from ToolingManifest.json in the application's content root.
+     * The file should be located at: [ProjectRoot]/ToolingManifest.json
+     *
+     * Example ToolingManifest.json:
+     * {
+     *   "mcpServers": [
+     *     {
+     *       "mcpServerName": "mailMCPServerConfig",
+     *       "mcpServerUniqueName": "mcp_MailTools"
+     *     },
+     *     {
+     *       "mcpServerName": "sharePointMCPServerConfig",
+     *       "mcpServerUniqueName": "mcp_SharePointTools"
+     *     }
+     *   ]
+     * }
+     */
+    private getMCPServerConfigsFromManifest;
+    /**
+     * Detect if the process is running in a development scenario based on environment variables.
+     *
+     * @returns {boolean} True when running in a development environment.
+     */
+    private isDevScenario;
+}
+//# sourceMappingURL=McpToolServerConfigurationService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"McpToolServerConfigurationService.d.ts","sourceRoot":"","sources":["../../src/McpToolServerConfigurationService.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM7D;;;GAGG;AACH,qBAAa,iCAAiC;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAElC;;OAEG;;IAIH;;;;;;OAMG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI1F;;;OAGG;IACG,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA8B1G;;;;;;;OAOG;YACW,qCAAqC;IAwBnD;;;;;;;;;;;;;;;;;;;;OAoBG;YACW,+BAA+B;IA8B7C;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAItB"}

package/dist/cjs/McpToolServerConfigurationService.js

@@ -0,0 +1,146 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpToolServerConfigurationService = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const axios_1 = __importDefault(require("axios"));
+const Utility_1 = require("./Utility");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+/**
+ * Service responsible for discovering and normalizing MCP (Model Context Protocol)
+ * tool servers and producing configuration objects consumable by the Claude SDK.
+ */
+class McpToolServerConfigurationService {
+    /**
+     * Construct a McpToolServerConfigurationService.
+     */
+    constructor() {
+        this.logger = console;
+    }
+    /**
+     * Return MCP server definitions for the given agent. In development (NODE_ENV=Development) this reads the local ToolingManifest.json; otherwise it queries the remote tooling gateway.
+     *
+     * @param agenticAppId The agentic app id for which to discover servers.
+     * @param authToken Optional bearer token used when querying the remote tooling gateway.
+     * @returns A promise resolving to an array of normalized MCP server configuration objects.
+     */
+    async listToolServers(agenticAppId, authToken) {
+        return await (this.isDevScenario() ? this.getMCPServerConfigsFromManifest() : this.getMCPServerConfigsFromToolingGateway(agenticAppId, authToken));
+    }
+    /**
+     * Connect to the MCP server and return tools with names prefixed by the server name.
+     * Throws if the server URL is missing or the client fails to list tools.
+     */
+    async getMcpClientTools(mcpServerName, mcpServerConfig) {
+        if (!mcpServerConfig) {
+            throw new Error('Invalid MCP Server Configuration');
+        }
+        if (!mcpServerConfig.url) {
+            throw new Error('MCP Server URL cannot be null or empty');
+        }
+        const transport = new streamableHttp_js_1.StreamableHTTPClientTransport(new URL(mcpServerConfig.url), {
+            requestInit: {
+                headers: mcpServerConfig.headers
+            }
+        });
+        const mcpClient = new index_js_1.Client({
+            name: mcpServerName + ' Client',
+            version: '1.0',
+        });
+        await mcpClient.connect(transport);
+        const toolsObj = await mcpClient.listTools();
+        await mcpClient.close();
+        return toolsObj.tools;
+    }
+    /**
+     * Query the tooling gateway for MCP servers for the specified agent and normalize each entry's mcpServerUniqueName into a full URL using Utility.BuildMcpServerUrl.
+     * Throws an error if the gateway call fails.
+     *
+     * @param agenticAppId The agentic app id used by the tooling gateway to scope results.
+     * @param authToken Optional Bearer token to include in the Authorization header when calling the gateway.
+     * @throws Error when the gateway call fails or returns an unexpected payload.
+     */
+    async getMCPServerConfigsFromToolingGateway(agenticAppId, authToken) {
+        // Validate the authentication token
+        Utility_1.Utility.ValidateAuthToken(authToken);
+        const configEndpoint = Utility_1.Utility.GetToolingGatewayForDigitalWorker(agenticAppId);
+        try {
+            const response = await axios_1.default.get(configEndpoint, {
+                headers: {
+                    'Authorization': authToken ? `Bearer ${authToken}` : undefined,
+                },
+                timeout: 10000 // 10 seconds timeout
+            });
+            return (response.data) || [];
+        }
+        catch (err) {
+            const error = err;
+            throw new Error(`Failed to read MCP servers from endpoint: ${error.code || 'UNKNOWN'} ${error.message || 'Unknown error'}`);
+        }
+    }
+    /**
+     * Read MCP servers from a local ToolingManifest.json file (development only).
+     * Searches process.cwd() and process.argv[1] for the manifest file.
+     *
+     * Reads MCP server configurations from ToolingManifest.json in the application's content root.
+     * The file should be located at: [ProjectRoot]/ToolingManifest.json
+     *
+     * Example ToolingManifest.json:
+     * {
+     *   "mcpServers": [
+     *     {
+     *       "mcpServerName": "mailMCPServerConfig",
+     *       "mcpServerUniqueName": "mcp_MailTools"
+     *     },
+     *     {
+     *       "mcpServerName": "sharePointMCPServerConfig",
+     *       "mcpServerUniqueName": "mcp_SharePointTools"
+     *     }
+     *   ]
+     * }
+     */
+    async getMCPServerConfigsFromManifest() {
+        let manifestPath = path_1.default.join(process.cwd(), 'ToolingManifest.json');
+        if (!fs_1.default.existsSync(manifestPath)) {
+            this.logger.warn(`ToolingManifest.json not found at ${manifestPath}, checking argv[1] location.`);
+            manifestPath = path_1.default.join(path_1.default.dirname(process.argv[1] || ''), 'ToolingManifest.json');
+        }
+        if (!fs_1.default.existsSync(manifestPath)) {
+            this.logger.warn(`ToolingManifest.json not found at ${manifestPath}`);
+            return [];
+        }
+        try {
+            const jsonContent = fs_1.default.readFileSync(manifestPath, 'utf-8');
+            const manifestData = JSON.parse(jsonContent);
+            const mcpServers = manifestData.mcpServers || [];
+            return mcpServers.map((s) => {
+                return {
+                    mcpServerName: s.mcpServerName,
+                    url: Utility_1.Utility.BuildMcpServerUrl(s.mcpServerName)
+                };
+            });
+        }
+        catch (err) {
+            const error = err;
+            this.logger.error(`Error reading or parsing ToolingManifest.json: ${error.message || 'Unknown error'}`);
+            return [];
+        }
+    }
+    /**
+     * Detect if the process is running in a development scenario based on environment variables.
+     *
+     * @returns {boolean} True when running in a development environment.
+     */
+    isDevScenario() {
+        const environment = process.env.NODE_ENV || 'Development';
+        return environment.toLowerCase() === 'development';
+    }
+}
+exports.McpToolServerConfigurationService = McpToolServerConfigurationService;
+//# sourceMappingURL=McpToolServerConfigurationService.js.map

package/dist/cjs/McpToolServerConfigurationService.js.map

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

package/dist/cjs/Utility.d.ts

@@ -0,0 +1,67 @@
+export declare enum ToolsMode {
+    MockMCPServer = "MockMCPServer",
+    MCPPlatform = "MCPPlatform"
+}
+export declare class Utility {
+    /**
+     * Validates a JWT authentication token.
+     * Checks that the token is a valid JWT and is not expired.
+     *
+     * @param authToken - The JWT token to validate.
+     * @throws Error if the token is invalid or expired.
+     */
+    static ValidateAuthToken(authToken: string | undefined): void;
+    /**
+     * Private helper to validate a JWT authentication token.
+     * Checks that the token is a valid JWT and is not expired.
+     *
+     * @param authToken - The JWT token to validate.
+     * @throws Error if the token is invalid or expired.
+     */
+    private static validateAuthToken;
+    /**
+     * Construct the tooling gateway URL for a given agent identity.
+     * This endpoint is used to discover MCP servers associated with the specified agent identity.
+     *
+     * Example:
+     *   Utility.GetToolingGatewayForDigitalWorker(agenticAppId)
+     *   // => "https://agent365.svc.cloud.microsoft/agents/{agenticAppId}/mcpServers"
+     *
+     * @param agenticAppId - The unique identifier for the agent identity.
+     * @returns A fully-qualified URL pointing at the tooling gateway for the agent.
+     */
+    static GetToolingGatewayForDigitalWorker(agenticAppId: string): string;
+    /**
+     * Get the base URL used to query MCP environments.
+     *
+     * @returns The base MCP environments URL.
+     */
+    static GetMcpBaseUrl(): string;
+    /**
+     * Build the full URL for accessing a specific MCP server.
+     *
+     * Example:
+     *   Utility.BuildMcpServerUrl('MyServer')
+     *   // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
+     *
+     * @param serverName - The MCP server resource name.
+     * @returns The fully-qualified MCP server URL including trailing slash.
+    */
+    static BuildMcpServerUrl(serverName: string): string;
+    static GetToolsMode(): ToolsMode;
+    /**
+     * Reads the current environment name from process.env.
+     * Checks ASPNETCORE_ENVIRONMENT, DOTNET_ENVIRONMENT, and NODE_ENV in that order.
+     * If none are set this returns the string 'Development'.
+     *
+     * @returns The current environment identifier as a string.
+     */
+    private static getCurrentEnvironment;
+    /**
+     * Gets the base URL for MCP platform, defaults to production URL if not set.
+     *
+     * @returns The base URL for MCP platform.
+     */
+    private static getMcpPlatformBaseUrl;
+}
+//# sourceMappingURL=Utility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Utility.d.ts","sourceRoot":"","sources":["../../src/Utility.ts"],"names":[],"mappings":"AAGA,oBAAY,SAAS;IACnB,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;CAC5B;AAKD,qBAAa,OAAO;IAClB;;;;;;OAMG;WACW,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIpE;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAqChC;;;;;;;;;;OAUG;WACW,iCAAiC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAK7E;;;;OAIG;WACW,aAAa,IAAI,MAAM;IAarC;;;;;;;;;MASE;WACY,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAI,MAAM;WAK9C,YAAY,IAAI,SAAS;IAUvC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAOpC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAOrC"}

package/dist/cjs/Utility.js

@@ -0,0 +1,142 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Utility = exports.ToolsMode = void 0;
+var ToolsMode;
+(function (ToolsMode) {
+    ToolsMode["MockMCPServer"] = "MockMCPServer";
+    ToolsMode["MCPPlatform"] = "MCPPlatform";
+})(ToolsMode || (exports.ToolsMode = ToolsMode = {}));
+// Constant for MCP Platform base URL in production
+const MCP_PLATFORM_PROD_BASE_URL = 'https://agent365.svc.cloud.microsoft';
+class Utility {
+    /**
+     * Validates a JWT authentication token.
+     * Checks that the token is a valid JWT and is not expired.
+     *
+     * @param authToken - The JWT token to validate.
+     * @throws Error if the token is invalid or expired.
+     */
+    static ValidateAuthToken(authToken) {
+        return Utility.validateAuthToken(authToken);
+    }
+    /**
+     * Private helper to validate a JWT authentication token.
+     * Checks that the token is a valid JWT and is not expired.
+     *
+     * @param authToken - The JWT token to validate.
+     * @throws Error if the token is invalid or expired.
+     */
+    static validateAuthToken(authToken) {
+        if (!authToken) {
+            throw new Error('Authentication token is required');
+        }
+        // Parse JWT token (format: header.payload.signature)
+        const parts = authToken.split('.');
+        if (parts.length !== 3) {
+            throw new Error('Invalid JWT token format');
+        }
+        let payload;
+        try {
+            // Decode the payload (second part of the JWT)
+            const payloadBase64 = parts[1];
+            // Handle URL-safe base64
+            const paddedBase64 = payloadBase64.padEnd(payloadBase64.length + (4 - payloadBase64.length % 4) % 4, '=');
+            const payloadJson = Buffer.from(paddedBase64.replace(/-/g, '+').replace(/_/g, '/'), 'base64').toString('utf-8');
+            payload = JSON.parse(payloadJson);
+        }
+        catch (error) {
+            throw new Error('Failed to decode JWT token payload');
+        }
+        // Check expiration
+        if (payload.exp) {
+            const currentTimestamp = Math.floor(Date.now() / 1000);
+            if (payload.exp < currentTimestamp) {
+                throw new Error('Authentication token has expired');
+            }
+        }
+        else {
+            throw new Error('Authentication token does not contain expiration claim');
+        }
+    }
+    /**
+     * Construct the tooling gateway URL for a given agent identity.
+     * This endpoint is used to discover MCP servers associated with the specified agent identity.
+     *
+     * Example:
+     *   Utility.GetToolingGatewayForDigitalWorker(agenticAppId)
+     *   // => "https://agent365.svc.cloud.microsoft/agents/{agenticAppId}/mcpServers"
+     *
+     * @param agenticAppId - The unique identifier for the agent identity.
+     * @returns A fully-qualified URL pointing at the tooling gateway for the agent.
+     */
+    static GetToolingGatewayForDigitalWorker(agenticAppId) {
+        // The endpoint needs to be updated based on the environment (prod, dev, etc.)
+        return `${this.getMcpPlatformBaseUrl()}/agents/${agenticAppId}/mcpServers`;
+    }
+    /**
+     * Get the base URL used to query MCP environments.
+     *
+     * @returns The base MCP environments URL.
+     */
+    static GetMcpBaseUrl() {
+        const environment = this.getCurrentEnvironment().toLowerCase();
+        if (environment === 'development') {
+            const toolsMode = this.GetToolsMode();
+            if (toolsMode === ToolsMode.MockMCPServer) {
+                return process.env.MOCK_MCP_SERVER_URL || 'http://localhost:5309/mcp-mock/agents/servers';
+            }
+        }
+        return `${this.getMcpPlatformBaseUrl()}/agents/servers`;
+    }
+    /**
+     * Build the full URL for accessing a specific MCP server.
+     *
+     * Example:
+     *   Utility.BuildMcpServerUrl('MyServer')
+     *   // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
+     *
+     * @param serverName - The MCP server resource name.
+     * @returns The fully-qualified MCP server URL including trailing slash.
+    */
+    static BuildMcpServerUrl(serverName) {
+        const baseUrl = this.GetMcpBaseUrl();
+        return `${baseUrl}/${serverName}`;
+    }
+    static GetToolsMode() {
+        const toolsMode = process.env.TOOLS_MODE || 'MCPPlatform';
+        switch (toolsMode.toLowerCase()) {
+            case 'mockmcpserver':
+                return ToolsMode.MockMCPServer;
+            default:
+                return ToolsMode.MCPPlatform;
+        }
+    }
+    /**
+     * Reads the current environment name from process.env.
+     * Checks ASPNETCORE_ENVIRONMENT, DOTNET_ENVIRONMENT, and NODE_ENV in that order.
+     * If none are set this returns the string 'Development'.
+     *
+     * @returns The current environment identifier as a string.
+     */
+    static getCurrentEnvironment() {
+        return process.env.ASPNETCORE_ENVIRONMENT ||
+            process.env.DOTNET_ENVIRONMENT ||
+            process.env.NODE_ENV ||
+            'Development';
+    }
+    /**
+     * Gets the base URL for MCP platform, defaults to production URL if not set.
+     *
+     * @returns The base URL for MCP platform.
+     */
+    static getMcpPlatformBaseUrl() {
+        if (process.env.MCP_PLATFORM_ENDPOINT) {
+            return process.env.MCP_PLATFORM_ENDPOINT;
+        }
+        return MCP_PLATFORM_PROD_BASE_URL;
+    }
+}
+exports.Utility = Utility;
+//# sourceMappingURL=Utility.js.map

package/dist/cjs/Utility.js.map

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

package/dist/cjs/contracts.d.ts

@@ -0,0 +1,21 @@
+export interface MCPServerConfig {
+    mcpServerName: string;
+    url: string;
+    headers?: Record<string, string>;
+}
+export interface McpClientTool {
+    name: string;
+    description: string;
+    inputSchema: InputSchema;
+}
+export interface InputSchema {
+    type: string;
+    properties: Record<string, {
+        type: string;
+        description?: string;
+        enum?: string[];
+    }>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/contracts.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACpF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/cjs/contracts.js

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

package/dist/cjs/contracts.js.map

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

package/dist/cjs/index.d.ts

@@ -0,0 +1,4 @@
+export * from './Utility';
+export * from './McpToolServerConfigurationService';
+export * from './contracts';
+//# 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":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,qCAAqC,CAAC;AACpD,cAAc,aAAa,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,20 @@
+"use strict";
+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 });
+__exportStar(require("./Utility"), exports);
+__exportStar(require("./McpToolServerConfigurationService"), exports);
+__exportStar(require("./contracts"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,sEAAoD;AACpD,8CAA4B"}

package/dist/esm/McpToolServerConfigurationService.d.ts

@@ -0,0 +1,63 @@
+import { MCPServerConfig, McpClientTool } from './contracts';
+/**
+ * Service responsible for discovering and normalizing MCP (Model Context Protocol)
+ * tool servers and producing configuration objects consumable by the Claude SDK.
+ */
+export declare class McpToolServerConfigurationService {
+    private readonly logger;
+    /**
+     * Construct a McpToolServerConfigurationService.
+     */
+    constructor();
+    /**
+     * Return MCP server definitions for the given agent. In development (NODE_ENV=Development) this reads the local ToolingManifest.json; otherwise it queries the remote tooling gateway.
+     *
+     * @param agenticAppId The agentic app id for which to discover servers.
+     * @param authToken Optional bearer token used when querying the remote tooling gateway.
+     * @returns A promise resolving to an array of normalized MCP server configuration objects.
+     */
+    listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>;
+    /**
+     * Connect to the MCP server and return tools with names prefixed by the server name.
+     * Throws if the server URL is missing or the client fails to list tools.
+     */
+    getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>;
+    /**
+     * Query the tooling gateway for MCP servers for the specified agent and normalize each entry's mcpServerUniqueName into a full URL using Utility.BuildMcpServerUrl.
+     * Throws an error if the gateway call fails.
+     *
+     * @param agenticAppId The agentic app id used by the tooling gateway to scope results.
+     * @param authToken Optional Bearer token to include in the Authorization header when calling the gateway.
+     * @throws Error when the gateway call fails or returns an unexpected payload.
+     */
+    private getMCPServerConfigsFromToolingGateway;
+    /**
+     * Read MCP servers from a local ToolingManifest.json file (development only).
+     * Searches process.cwd() and process.argv[1] for the manifest file.
+     *
+     * Reads MCP server configurations from ToolingManifest.json in the application's content root.
+     * The file should be located at: [ProjectRoot]/ToolingManifest.json
+     *
+     * Example ToolingManifest.json:
+     * {
+     *   "mcpServers": [
+     *     {
+     *       "mcpServerName": "mailMCPServerConfig",
+     *       "mcpServerUniqueName": "mcp_MailTools"
+     *     },
+     *     {
+     *       "mcpServerName": "sharePointMCPServerConfig",
+     *       "mcpServerUniqueName": "mcp_SharePointTools"
+     *     }
+     *   ]
+     * }
+     */
+    private getMCPServerConfigsFromManifest;
+    /**
+     * Detect if the process is running in a development scenario based on environment variables.
+     *
+     * @returns {boolean} True when running in a development environment.
+     */
+    private isDevScenario;
+}
+//# sourceMappingURL=McpToolServerConfigurationService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"McpToolServerConfigurationService.d.ts","sourceRoot":"","sources":["../../src/McpToolServerConfigurationService.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM7D;;;GAGG;AACH,qBAAa,iCAAiC;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAElC;;OAEG;;IAIH;;;;;;OAMG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI1F;;;OAGG;IACG,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA8B1G;;;;;;;OAOG;YACW,qCAAqC;IAwBnD;;;;;;;;;;;;;;;;;;;;OAoBG;YACW,+BAA+B;IA8B7C;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAItB"}

package/dist/esm/McpToolServerConfigurationService.js

@@ -0,0 +1,139 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import fs from 'fs';
+import path from 'path';
+import axios from 'axios';
+import { Utility } from './Utility';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+/**
+ * Service responsible for discovering and normalizing MCP (Model Context Protocol)
+ * tool servers and producing configuration objects consumable by the Claude SDK.
+ */
+export class McpToolServerConfigurationService {
+    /**
+     * Construct a McpToolServerConfigurationService.
+     */
+    constructor() {
+        this.logger = console;
+    }
+    /**
+     * Return MCP server definitions for the given agent. In development (NODE_ENV=Development) this reads the local ToolingManifest.json; otherwise it queries the remote tooling gateway.
+     *
+     * @param agenticAppId The agentic app id for which to discover servers.
+     * @param authToken Optional bearer token used when querying the remote tooling gateway.
+     * @returns A promise resolving to an array of normalized MCP server configuration objects.
+     */
+    async listToolServers(agenticAppId, authToken) {
+        return await (this.isDevScenario() ? this.getMCPServerConfigsFromManifest() : this.getMCPServerConfigsFromToolingGateway(agenticAppId, authToken));
+    }
+    /**
+     * Connect to the MCP server and return tools with names prefixed by the server name.
+     * Throws if the server URL is missing or the client fails to list tools.
+     */
+    async getMcpClientTools(mcpServerName, mcpServerConfig) {
+        if (!mcpServerConfig) {
+            throw new Error('Invalid MCP Server Configuration');
+        }
+        if (!mcpServerConfig.url) {
+            throw new Error('MCP Server URL cannot be null or empty');
+        }
+        const transport = new StreamableHTTPClientTransport(new URL(mcpServerConfig.url), {
+            requestInit: {
+                headers: mcpServerConfig.headers
+            }
+        });
+        const mcpClient = new Client({
+            name: mcpServerName + ' Client',
+            version: '1.0',
+        });
+        await mcpClient.connect(transport);
+        const toolsObj = await mcpClient.listTools();
+        await mcpClient.close();
+        return toolsObj.tools;
+    }
+    /**
+     * Query the tooling gateway for MCP servers for the specified agent and normalize each entry's mcpServerUniqueName into a full URL using Utility.BuildMcpServerUrl.
+     * Throws an error if the gateway call fails.
+     *
+     * @param agenticAppId The agentic app id used by the tooling gateway to scope results.
+     * @param authToken Optional Bearer token to include in the Authorization header when calling the gateway.
+     * @throws Error when the gateway call fails or returns an unexpected payload.
+     */
+    async getMCPServerConfigsFromToolingGateway(agenticAppId, authToken) {
+        // Validate the authentication token
+        Utility.ValidateAuthToken(authToken);
+        const configEndpoint = Utility.GetToolingGatewayForDigitalWorker(agenticAppId);
+        try {
+            const response = await axios.get(configEndpoint, {
+                headers: {
+                    'Authorization': authToken ? `Bearer ${authToken}` : undefined,
+                },
+                timeout: 10000 // 10 seconds timeout
+            });
+            return (response.data) || [];
+        }
+        catch (err) {
+            const error = err;
+            throw new Error(`Failed to read MCP servers from endpoint: ${error.code || 'UNKNOWN'} ${error.message || 'Unknown error'}`);
+        }
+    }
+    /**
+     * Read MCP servers from a local ToolingManifest.json file (development only).
+     * Searches process.cwd() and process.argv[1] for the manifest file.
+     *
+     * Reads MCP server configurations from ToolingManifest.json in the application's content root.
+     * The file should be located at: [ProjectRoot]/ToolingManifest.json
+     *
+     * Example ToolingManifest.json:
+     * {
+     *   "mcpServers": [
+     *     {
+     *       "mcpServerName": "mailMCPServerConfig",
+     *       "mcpServerUniqueName": "mcp_MailTools"
+     *     },
+     *     {
+     *       "mcpServerName": "sharePointMCPServerConfig",
+     *       "mcpServerUniqueName": "mcp_SharePointTools"
+     *     }
+     *   ]
+     * }
+     */
+    async getMCPServerConfigsFromManifest() {
+        let manifestPath = path.join(process.cwd(), 'ToolingManifest.json');
+        if (!fs.existsSync(manifestPath)) {
+            this.logger.warn(`ToolingManifest.json not found at ${manifestPath}, checking argv[1] location.`);
+            manifestPath = path.join(path.dirname(process.argv[1] || ''), 'ToolingManifest.json');
+        }
+        if (!fs.existsSync(manifestPath)) {
+            this.logger.warn(`ToolingManifest.json not found at ${manifestPath}`);
+            return [];
+        }
+        try {
+            const jsonContent = fs.readFileSync(manifestPath, 'utf-8');
+            const manifestData = JSON.parse(jsonContent);
+            const mcpServers = manifestData.mcpServers || [];
+            return mcpServers.map((s) => {
+                return {
+                    mcpServerName: s.mcpServerName,
+                    url: Utility.BuildMcpServerUrl(s.mcpServerName)
+                };
+            });
+        }
+        catch (err) {
+            const error = err;
+            this.logger.error(`Error reading or parsing ToolingManifest.json: ${error.message || 'Unknown error'}`);
+            return [];
+        }
+    }
+    /**
+     * Detect if the process is running in a development scenario based on environment variables.
+     *
+     * @returns {boolean} True when running in a development environment.
+     */
+    isDevScenario() {
+        const environment = process.env.NODE_ENV || 'Development';
+        return environment.toLowerCase() === 'development';
+    }
+}
+//# sourceMappingURL=McpToolServerConfigurationService.js.map

package/dist/esm/McpToolServerConfigurationService.js.map

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

package/dist/esm/Utility.d.ts

@@ -0,0 +1,67 @@
+export declare enum ToolsMode {
+    MockMCPServer = "MockMCPServer",
+    MCPPlatform = "MCPPlatform"
+}
+export declare class Utility {
+    /**
+     * Validates a JWT authentication token.
+     * Checks that the token is a valid JWT and is not expired.
+     *
+     * @param authToken - The JWT token to validate.
+     * @throws Error if the token is invalid or expired.
+     */
+    static ValidateAuthToken(authToken: string | undefined): void;
+    /**
+     * Private helper to validate a JWT authentication token.
+     * Checks that the token is a valid JWT and is not expired.
+     *
+     * @param authToken - The JWT token to validate.
+     * @throws Error if the token is invalid or expired.
+     */
+    private static validateAuthToken;
+    /**
+     * Construct the tooling gateway URL for a given agent identity.
+     * This endpoint is used to discover MCP servers associated with the specified agent identity.
+     *
+     * Example:
+     *   Utility.GetToolingGatewayForDigitalWorker(agenticAppId)
+     *   // => "https://agent365.svc.cloud.microsoft/agents/{agenticAppId}/mcpServers"
+     *
+     * @param agenticAppId - The unique identifier for the agent identity.
+     * @returns A fully-qualified URL pointing at the tooling gateway for the agent.
+     */
+    static GetToolingGatewayForDigitalWorker(agenticAppId: string): string;
+    /**
+     * Get the base URL used to query MCP environments.
+     *
+     * @returns The base MCP environments URL.
+     */
+    static GetMcpBaseUrl(): string;
+    /**
+     * Build the full URL for accessing a specific MCP server.
+     *
+     * Example:
+     *   Utility.BuildMcpServerUrl('MyServer')
+     *   // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
+     *
+     * @param serverName - The MCP server resource name.
+     * @returns The fully-qualified MCP server URL including trailing slash.
+    */
+    static BuildMcpServerUrl(serverName: string): string;
+    static GetToolsMode(): ToolsMode;
+    /**
+     * Reads the current environment name from process.env.
+     * Checks ASPNETCORE_ENVIRONMENT, DOTNET_ENVIRONMENT, and NODE_ENV in that order.
+     * If none are set this returns the string 'Development'.
+     *
+     * @returns The current environment identifier as a string.
+     */
+    private static getCurrentEnvironment;
+    /**
+     * Gets the base URL for MCP platform, defaults to production URL if not set.
+     *
+     * @returns The base URL for MCP platform.
+     */
+    private static getMcpPlatformBaseUrl;
+}
+//# sourceMappingURL=Utility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Utility.d.ts","sourceRoot":"","sources":["../../src/Utility.ts"],"names":[],"mappings":"AAGA,oBAAY,SAAS;IACnB,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;CAC5B;AAKD,qBAAa,OAAO;IAClB;;;;;;OAMG;WACW,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIpE;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAqChC;;;;;;;;;;OAUG;WACW,iCAAiC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAK7E;;;;OAIG;WACW,aAAa,IAAI,MAAM;IAarC;;;;;;;;;MASE;WACY,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAI,MAAM;WAK9C,YAAY,IAAI,SAAS;IAUvC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAOpC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAOrC"}

package/dist/esm/Utility.js

@@ -0,0 +1,138 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export var ToolsMode;
+(function (ToolsMode) {
+    ToolsMode["MockMCPServer"] = "MockMCPServer";
+    ToolsMode["MCPPlatform"] = "MCPPlatform";
+})(ToolsMode || (ToolsMode = {}));
+// Constant for MCP Platform base URL in production
+const MCP_PLATFORM_PROD_BASE_URL = 'https://agent365.svc.cloud.microsoft';
+export class Utility {
+    /**
+     * Validates a JWT authentication token.
+     * Checks that the token is a valid JWT and is not expired.
+     *
+     * @param authToken - The JWT token to validate.
+     * @throws Error if the token is invalid or expired.
+     */
+    static ValidateAuthToken(authToken) {
+        return Utility.validateAuthToken(authToken);
+    }
+    /**
+     * Private helper to validate a JWT authentication token.
+     * Checks that the token is a valid JWT and is not expired.
+     *
+     * @param authToken - The JWT token to validate.
+     * @throws Error if the token is invalid or expired.
+     */
+    static validateAuthToken(authToken) {
+        if (!authToken) {
+            throw new Error('Authentication token is required');
+        }
+        // Parse JWT token (format: header.payload.signature)
+        const parts = authToken.split('.');
+        if (parts.length !== 3) {
+            throw new Error('Invalid JWT token format');
+        }
+        let payload;
+        try {
+            // Decode the payload (second part of the JWT)
+            const payloadBase64 = parts[1];
+            // Handle URL-safe base64
+            const paddedBase64 = payloadBase64.padEnd(payloadBase64.length + (4 - payloadBase64.length % 4) % 4, '=');
+            const payloadJson = Buffer.from(paddedBase64.replace(/-/g, '+').replace(/_/g, '/'), 'base64').toString('utf-8');
+            payload = JSON.parse(payloadJson);
+        }
+        catch (error) {
+            throw new Error('Failed to decode JWT token payload');
+        }
+        // Check expiration
+        if (payload.exp) {
+            const currentTimestamp = Math.floor(Date.now() / 1000);
+            if (payload.exp < currentTimestamp) {
+                throw new Error('Authentication token has expired');
+            }
+        }
+        else {
+            throw new Error('Authentication token does not contain expiration claim');
+        }
+    }
+    /**
+     * Construct the tooling gateway URL for a given agent identity.
+     * This endpoint is used to discover MCP servers associated with the specified agent identity.
+     *
+     * Example:
+     *   Utility.GetToolingGatewayForDigitalWorker(agenticAppId)
+     *   // => "https://agent365.svc.cloud.microsoft/agents/{agenticAppId}/mcpServers"
+     *
+     * @param agenticAppId - The unique identifier for the agent identity.
+     * @returns A fully-qualified URL pointing at the tooling gateway for the agent.
+     */
+    static GetToolingGatewayForDigitalWorker(agenticAppId) {
+        // The endpoint needs to be updated based on the environment (prod, dev, etc.)
+        return `${this.getMcpPlatformBaseUrl()}/agents/${agenticAppId}/mcpServers`;
+    }
+    /**
+     * Get the base URL used to query MCP environments.
+     *
+     * @returns The base MCP environments URL.
+     */
+    static GetMcpBaseUrl() {
+        const environment = this.getCurrentEnvironment().toLowerCase();
+        if (environment === 'development') {
+            const toolsMode = this.GetToolsMode();
+            if (toolsMode === ToolsMode.MockMCPServer) {
+                return process.env.MOCK_MCP_SERVER_URL || 'http://localhost:5309/mcp-mock/agents/servers';
+            }
+        }
+        return `${this.getMcpPlatformBaseUrl()}/agents/servers`;
+    }
+    /**
+     * Build the full URL for accessing a specific MCP server.
+     *
+     * Example:
+     *   Utility.BuildMcpServerUrl('MyServer')
+     *   // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
+     *
+     * @param serverName - The MCP server resource name.
+     * @returns The fully-qualified MCP server URL including trailing slash.
+    */
+    static BuildMcpServerUrl(serverName) {
+        const baseUrl = this.GetMcpBaseUrl();
+        return `${baseUrl}/${serverName}`;
+    }
+    static GetToolsMode() {
+        const toolsMode = process.env.TOOLS_MODE || 'MCPPlatform';
+        switch (toolsMode.toLowerCase()) {
+            case 'mockmcpserver':
+                return ToolsMode.MockMCPServer;
+            default:
+                return ToolsMode.MCPPlatform;
+        }
+    }
+    /**
+     * Reads the current environment name from process.env.
+     * Checks ASPNETCORE_ENVIRONMENT, DOTNET_ENVIRONMENT, and NODE_ENV in that order.
+     * If none are set this returns the string 'Development'.
+     *
+     * @returns The current environment identifier as a string.
+     */
+    static getCurrentEnvironment() {
+        return process.env.ASPNETCORE_ENVIRONMENT ||
+            process.env.DOTNET_ENVIRONMENT ||
+            process.env.NODE_ENV ||
+            'Development';
+    }
+    /**
+     * Gets the base URL for MCP platform, defaults to production URL if not set.
+     *
+     * @returns The base URL for MCP platform.
+     */
+    static getMcpPlatformBaseUrl() {
+        if (process.env.MCP_PLATFORM_ENDPOINT) {
+            return process.env.MCP_PLATFORM_ENDPOINT;
+        }
+        return MCP_PLATFORM_PROD_BASE_URL;
+    }
+}
+//# sourceMappingURL=Utility.js.map

package/dist/esm/Utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utility.js","sourceRoot":"","sources":["../../src/Utility.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,4CAA+B,CAAA;IAC/B,wCAA2B,CAAA;AAC7B,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AAED,mDAAmD;AACnD,MAAM,0BAA0B,GAAG,sCAAsC,CAAC;AAE1E,MAAM,OAAO,OAAO;IAClB;;;;;;OAMG;IACI,MAAM,CAAC,iBAAiB,CAAC,SAA6B;QAC3D,OAAO,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,iBAAiB,CAAC,SAA6B;QAC5D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,qDAAqD;QACrD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,OAEH,CAAC;QAEF,IAAI,CAAC;YACH,8CAA8C;YAC9C,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC/B,yBAAyB;YACzB,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;YAC1G,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAChH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,mBAAmB;QACnB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YACvD,IAAI,OAAO,CAAC,GAAG,GAAG,gBAAgB,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACI,MAAM,CAAC,iCAAiC,CAAC,YAAoB;QAClE,8EAA8E;QAC9E,OAAO,GAAG,IAAI,CAAC,qBAAqB,EAAE,WAAW,YAAY,aAAa,CAAC;IAC7E,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,aAAa;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC,WAAW,EAAE,CAAC;QAE/D,IAAI,WAAW,KAAK,aAAa,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACtC,IAAI,SAAS,KAAK,SAAS,CAAC,aAAa,EAAE,CAAC;gBAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,+CAA+C,CAAC;YAC5F,CAAC;QACH,CAAC;QAED,OAAO,GAAG,IAAI,CAAC,qBAAqB,EAAE,iBAAiB,CAAC;IAC1D,CAAC;IAED;;;;;;;;;MASE;IACK,MAAM,CAAC,iBAAiB,CAAC,UAAkB;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACrC,OAAO,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IACpC,CAAC;IAEM,MAAM,CAAC,YAAY;QACxB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,aAAa,CAAC;QAC1D,QAAQ,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;YAClC,KAAK,eAAe;gBAClB,OAAO,SAAS,CAAC,aAAa,CAAC;YACjC;gBACE,OAAO,SAAS,CAAC,WAAW,CAAC;QAC/B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,qBAAqB;QAClC,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB;YAClC,OAAO,CAAC,GAAG,CAAC,kBAAkB;YAC9B,OAAO,CAAC,GAAG,CAAC,QAAQ;YACpB,aAAa,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,qBAAqB;QAClC,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC;YACtC,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;QAC3C,CAAC;QAED,OAAO,0BAA0B,CAAC;IACpC,CAAC;CACF"}

package/dist/esm/contracts.d.ts

@@ -0,0 +1,21 @@
+export interface MCPServerConfig {
+    mcpServerName: string;
+    url: string;
+    headers?: Record<string, string>;
+}
+export interface McpClientTool {
+    name: string;
+    description: string;
+    inputSchema: InputSchema;
+}
+export interface InputSchema {
+    type: string;
+    properties: Record<string, {
+        type: string;
+        description?: string;
+        enum?: string[];
+    }>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/contracts.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACpF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/esm/contracts.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/esm/contracts.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+export * from './Utility';
+export * from './McpToolServerConfigurationService';
+export * from './contracts';
+//# 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":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,qCAAqC,CAAC;AACpD,cAAc,aAAa,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,4 @@
+export * from './Utility';
+export * from './McpToolServerConfigurationService';
+export * from './contracts';
+//# 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,cAAc,WAAW,CAAC;AAC1B,cAAc,qCAAqC,CAAC;AACpD,cAAc,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@microsoft/agents-a365-tooling",
+  "version": "0.1.0-preview.30",
+  "description": "Agent 365 Tooling SDK for AI agents built with TypeScript/Node.js",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "scripts": {
+    "build:cjs": "npx tsc --project tsconfig.cjs.json",
+    "build:esm": "npx tsc --project tsconfig.esm.json",
+    "build": "npm run build:cjs && npm run build:esm",
+    "build:watch": "npx tsc --watch",
+    "clean": "npx rimraf dist",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "prepublishOnly": "npm run clean && npm run build",
+    "ci": "npm ci",
+    "pack": "npm pack --pack-destination=../"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "azure",
+    "typescript"
+  ],
+  "author": "Microsoft Corporation",
+  "license": "See license file",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/Agent365-nodejs.git",
+    "directory": "packages/agents-a365-tooling"
+  },
+  "dependencies": {
+    "@microsoft/agents-a365-runtime": "0.1.0-preview.30",
+    "@microsoft/agents-hosting": "*",
+    "@modelcontextprotocol/sdk": "*",
+    "express": "*"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.0.0",
+    "rimraf": "^5.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "CHANGELOG.md"
+  ]
+}