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

package/dist/esm/Utility.js

@@ -0,0 +1,188 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { Utility as RuntimeUtility } from '@microsoft/agents-a365-runtime';
+import { defaultToolingConfigurationProvider } from './configuration';
+export class Utility {
+    /**
+     * Compose standard headers for MCP tooling requests.
+     * Includes Authorization bearer token when provided, and optionally includes channel and subchannel identifiers for routing.
+     *
+     * @param authToken Bearer token for Authorization header.
+     * @param turnContext Optional TurnContext object from which channel and subchannel IDs are extracted.
+     * @param options Optional ToolOptions object for additional request configuration.
+     * @returns A headers record suitable for HTTP requests.
+     */
+    static GetToolRequestHeaders(authToken, turnContext, options) {
+        const headers = {};
+        if (authToken) {
+            headers['Authorization'] = `Bearer ${authToken}`;
+            // Add x-ms-agentid header with priority fallback (only when authToken present)
+            const agentId = this.resolveAgentIdForHeader(authToken, turnContext);
+            if (agentId) {
+                headers[Utility.HEADER_AGENT_ID] = agentId;
+            }
+        }
+        const channelId = turnContext?.activity?.channelId;
+        const subChannelId = turnContext?.activity?.channelIdSubChannel;
+        if (channelId) {
+            headers[Utility.HEADER_CHANNEL_ID] = channelId;
+        }
+        if (subChannelId) {
+            headers[Utility.HEADER_SUBCHANNEL_ID] = subChannelId;
+        }
+        if (options?.orchestratorName) {
+            headers[Utility.HEADER_USER_AGENT] = RuntimeUtility.GetUserAgentHeader(options.orchestratorName);
+        }
+        return headers;
+    }
+    /**
+     * Resolves the best available agent identifier for the x-ms-agentid header.
+     * Priority: TurnContext.agenticAppBlueprintId > token claims (xms_par_app_azp > appid > azp) > application name
+     *
+     * Note: This differs from RuntimeUtility.ResolveAgentIdentity() which resolves the agenticAppId
+     * for URL construction. This method resolves the identifier specifically for the x-ms-agentid header.
+     *
+     * @param authToken The authentication token to extract claims from.
+     * @param turnContext Optional TurnContext to extract agent blueprint ID from.
+     * @returns Agent ID string or undefined if not available.
+     */
+    static resolveAgentIdForHeader(authToken, turnContext) {
+        // Priority 1: Agent Blueprint ID from TurnContext
+        // The 'from' property may include agenticAppBlueprintId when the request originates from an agentic app
+        const blueprintId = turnContext?.activity?.from?.agenticAppBlueprintId;
+        if (blueprintId) {
+            return blueprintId;
+        }
+        // Priority 2 & 3: Agent ID from token (xms_par_app_azp > appid > azp)
+        // Single decode, checks claims in priority order
+        const agentId = RuntimeUtility.getAgentIdFromToken(authToken);
+        if (agentId) {
+            return agentId;
+        }
+        // Priority 4: Application name from npm_package_name or package.json
+        return RuntimeUtility.getApplicationName();
+    }
+    /**
+     * 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.
+     * @param configProvider - Optional configuration provider. Defaults to defaultToolingConfigurationProvider.
+     * @returns A fully-qualified URL pointing at the tooling gateway for the agent.
+     * @deprecated This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
+     */
+    static GetToolingGatewayForDigitalWorker(agenticAppId, configProvider) {
+        return `${this.getMcpPlatformBaseUrl(configProvider)}/agents/${agenticAppId}/mcpServers`;
+    }
+    /**
+     * Get the base URL used to query MCP environments.
+     *
+     * @param configProvider - Optional configuration provider. Defaults to defaultToolingConfigurationProvider.
+     * @returns The base MCP environments URL.
+     * @deprecated This method is for internal use only. Use McpToolServerConfigurationService instead.
+     */
+    static GetMcpBaseUrl(configProvider) {
+        return `${this.getMcpPlatformBaseUrl(configProvider)}/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.
+     * @param configProvider - Optional configuration provider. Defaults to defaultToolingConfigurationProvider.
+     * @returns The fully-qualified MCP server URL including trailing slash.
+     * @deprecated This method is for internal use only. Use McpToolServerConfigurationService instead.
+    */
+    static BuildMcpServerUrl(serverName, configProvider) {
+        const baseUrl = this.GetMcpBaseUrl(configProvider);
+        return `${baseUrl}/${serverName}/`;
+    }
+    /**
+     * Gets the base URL for MCP platform from configuration.
+     *
+     * @param configProvider - Optional configuration provider. Defaults to defaultToolingConfigurationProvider.
+     * @returns The base URL for MCP platform.
+     * @deprecated This method is for internal use only. Use ToolingConfiguration.mcpPlatformEndpoint instead.
+     */
+    static getMcpPlatformBaseUrl(configProvider) {
+        const provider = configProvider ?? defaultToolingConfigurationProvider;
+        return provider.getConfiguration().mcpPlatformEndpoint;
+    }
+    /**
+     * Constructs the endpoint URL for sending chat history to the MCP platform for real-time threat protection.
+     *
+     * @param configProvider - Optional configuration provider. Defaults to defaultToolingConfigurationProvider.
+     * @returns An absolute URL that tooling components can use to send or retrieve chat messages for
+     * real-time threat protection scenarios.
+     * @remarks
+     * Call this method when constructing HTTP requests that need to access the chat-message history
+     * for real-time threat protection. The returned URL already includes the MCP platform base address
+     * and the fixed path segment `/agents/real-time-threat-protection/chat-message`.
+     * @deprecated This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
+     */
+    static GetChatHistoryEndpoint(configProvider) {
+        return `${this.getMcpPlatformBaseUrl(configProvider)}/agents/real-time-threat-protection/chat-message`;
+    }
+}
+Utility.HEADER_CHANNEL_ID = 'x-ms-channel-id';
+Utility.HEADER_SUBCHANNEL_ID = 'x-ms-subchannel-id';
+Utility.HEADER_USER_AGENT = 'User-Agent';
+/** Header name for sending the agent identifier to MCP platform for logging/analytics. */
+Utility.HEADER_AGENT_ID = 'x-ms-agentid';
+//# 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":"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"}

package/dist/esm/configuration/ToolingConfiguration.d.ts

@@ -0,0 +1,24 @@
+import { RuntimeConfiguration } from '@microsoft/agents-a365-runtime';
+import { ToolingConfigurationOptions } from './ToolingConfigurationOptions';
+/**
+ * Configuration for tooling package.
+ * Inherits runtime settings and adds tooling-specific settings.
+ */
+export declare class ToolingConfiguration extends RuntimeConfiguration {
+    protected get toolingOverrides(): ToolingConfigurationOptions;
+    constructor(overrides?: ToolingConfigurationOptions);
+    get mcpPlatformEndpoint(): string;
+    /**
+     * Whether to use the ToolingManifest.json file instead of gateway discovery.
+     * Returns true when NODE_ENV is set to 'development' (case-insensitive), or
+     * when explicitly overridden via configuration.
+     */
+    get useToolingManifest(): boolean;
+    /**
+     * Gets the MCP platform authentication scope.
+     * Used by AgenticAuthenticationService for token exchange.
+     * Trims whitespace to prevent token exchange failures.
+     */
+    get mcpPlatformAuthenticationScope(): string;
+}
+//# sourceMappingURL=ToolingConfiguration.d.ts.map

package/dist/esm/configuration/ToolingConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolingConfiguration.d.ts","sourceRoot":"","sources":["../../../src/configuration/ToolingConfiguration.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAc5E;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,oBAAoB;IAE5D,SAAS,KAAK,gBAAgB,IAAI,2BAA2B,CAE5D;gBAEW,SAAS,CAAC,EAAE,2BAA2B;IAMnD,IAAI,mBAAmB,IAAI,MAAM,CAQhC;IAED;;;;OAIG;IACH,IAAI,kBAAkB,IAAI,OAAO,CAKhC;IAED;;;;OAIG;IACH,IAAI,8BAA8B,IAAI,MAAM,CAQ3C;CACF"}

package/dist/esm/configuration/ToolingConfiguration.js

@@ -0,0 +1,62 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { RuntimeConfiguration } from '@microsoft/agents-a365-runtime';
+// Constants for tooling-specific settings
+const MCP_PLATFORM_PROD_BASE_URL = 'https://agent365.svc.cloud.microsoft';
+const PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE = 'ea9ffc3e-8a23-4a7d-836d-234d7c7565c1/.default';
+/**
+ * Normalize URL by trimming whitespace and removing trailing slashes.
+ * Prevents double-slash issues in URL construction (e.g., "https://example.com//api").
+ */
+function normalizeUrl(url) {
+    return url.trim().replace(/\/+$/, '');
+}
+/**
+ * Configuration for tooling package.
+ * Inherits runtime settings and adds tooling-specific settings.
+ */
+export class ToolingConfiguration extends RuntimeConfiguration {
+    // Type-safe access to tooling overrides
+    get toolingOverrides() {
+        return this.overrides;
+    }
+    constructor(overrides) {
+        super(overrides);
+    }
+    // Inherited: clusterCategory, isDevelopmentEnvironment, isNodeEnvDevelopment
+    get mcpPlatformEndpoint() {
+        const override = this.toolingOverrides.mcpPlatformEndpoint?.();
+        if (override)
+            return normalizeUrl(override);
+        const envValue = process.env.MCP_PLATFORM_ENDPOINT?.trim();
+        if (envValue)
+            return normalizeUrl(envValue);
+        return MCP_PLATFORM_PROD_BASE_URL;
+    }
+    /**
+     * Whether to use the ToolingManifest.json file instead of gateway discovery.
+     * Returns true when NODE_ENV is set to 'development' (case-insensitive), or
+     * when explicitly overridden via configuration.
+     */
+    get useToolingManifest() {
+        const override = this.toolingOverrides.useToolingManifest?.();
+        if (override !== undefined)
+            return override;
+        return this.isNodeEnvDevelopment;
+    }
+    /**
+     * Gets the MCP platform authentication scope.
+     * Used by AgenticAuthenticationService for token exchange.
+     * Trims whitespace to prevent token exchange failures.
+     */
+    get mcpPlatformAuthenticationScope() {
+        const override = this.toolingOverrides.mcpPlatformAuthenticationScope?.()?.trim();
+        if (override)
+            return override;
+        const envValue = process.env.MCP_PLATFORM_AUTHENTICATION_SCOPE?.trim();
+        if (envValue)
+            return envValue;
+        return PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE;
+    }
+}
+//# sourceMappingURL=ToolingConfiguration.js.map

package/dist/esm/configuration/ToolingConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolingConfiguration.js","sourceRoot":"","sources":["../../../src/configuration/ToolingConfiguration.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAGtE,0CAA0C;AAC1C,MAAM,0BAA0B,GAAG,sCAAsC,CAAC;AAC1E,MAAM,sCAAsC,GAAG,+CAA+C,CAAC;AAE/F;;;GAGG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,oBAAoB;IAC5D,wCAAwC;IACxC,IAAc,gBAAgB;QAC5B,OAAO,IAAI,CAAC,SAAwC,CAAC;IACvD,CAAC;IAED,YAAY,SAAuC;QACjD,KAAK,CAAC,SAAS,CAAC,CAAC;IACnB,CAAC;IAED,6EAA6E;IAE7E,IAAI,mBAAmB;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,EAAE,CAAC;QAC/D,IAAI,QAAQ;YAAE,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;QAE5C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAC;QAC3D,IAAI,QAAQ;YAAE,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;QAE5C,OAAO,0BAA0B,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,IAAI,kBAAkB;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC9D,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAE5C,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,IAAI,8BAA8B;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,8BAA8B,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QAClF,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,IAAI,EAAE,CAAC;QACvE,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,OAAO,sCAAsC,CAAC;IAChD,CAAC;CACF"}

package/dist/esm/configuration/ToolingConfigurationOptions.d.ts

@@ -0,0 +1,23 @@
+import { RuntimeConfigurationOptions } from '@microsoft/agents-a365-runtime';
+/**
+ * Tooling configuration options - extends runtime options.
+ * All overrides are functions called on each property access.
+ *
+ * Inherited from RuntimeConfigurationOptions:
+ * - clusterCategory
+ * - isNodeEnvDevelopment
+ */
+export type ToolingConfigurationOptions = RuntimeConfigurationOptions & {
+    mcpPlatformEndpoint?: () => string;
+    /**
+     * Override for using ToolingManifest.json vs gateway discovery.
+     * Falls back to inherited isNodeEnvDevelopment.
+     */
+    useToolingManifest?: () => boolean;
+    /**
+     * Override for MCP platform authentication scope.
+     * Falls back to MCP_PLATFORM_AUTHENTICATION_SCOPE env var, then production default.
+     */
+    mcpPlatformAuthenticationScope?: () => string;
+};
+//# sourceMappingURL=ToolingConfigurationOptions.d.ts.map

package/dist/esm/configuration/ToolingConfigurationOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolingConfigurationOptions.d.ts","sourceRoot":"","sources":["../../../src/configuration/ToolingConfigurationOptions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,MAAM,2BAA2B,GAAG,2BAA2B,GAAG;IACtE,mBAAmB,CAAC,EAAE,MAAM,MAAM,CAAC;IACnC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC;IACnC;;;OAGG;IACH,8BAA8B,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/C,CAAC"}

package/dist/esm/configuration/ToolingConfigurationOptions.js

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

package/dist/esm/configuration/ToolingConfigurationOptions.js.map

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

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

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

package/dist/esm/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,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,mCAAmC,oDACoB,CAAC"}

package/dist/esm/configuration/index.js

@@ -0,0 +1,11 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { DefaultConfigurationProvider } from '@microsoft/agents-a365-runtime';
+import { ToolingConfiguration } from './ToolingConfiguration';
+export * from './ToolingConfigurationOptions';
+export * from './ToolingConfiguration';
+/**
+ * Shared default provider for ToolingConfiguration.
+ */
+export const defaultToolingConfigurationProvider = new DefaultConfigurationProvider(() => new ToolingConfiguration());
+//# sourceMappingURL=index.js.map

package/dist/esm/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,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAC9C,IAAI,4BAA4B,CAAC,GAAG,EAAE,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/esm/contracts.d.ts

@@ -0,0 +1,30 @@
+export interface MCPServerConfig {
+    mcpServerName: string;
+    url: string;
+    headers?: Record<string, string>;
+}
+export type MCPServerManifestEntry = {
+    url?: string;
+    headers?: Record<string, string>;
+} & ({
+    mcpServerName: string;
+    mcpServerUniqueName?: string;
+} | {
+    mcpServerUniqueName: string;
+    mcpServerName?: string;
+});
+export interface McpClientTool {
+    name: string;
+    description?: string;
+    inputSchema: InputSchema;
+}
+export interface InputSchema {
+    type: string;
+    properties?: Record<string, object>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+export interface ToolOptions {
+    orchestratorName?: string;
+}
+//# 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,MAAM,sBAAsB,GAAG;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GAAG,CACA;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,mBAAmB,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAC1D,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

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,6 @@
+export * from './Utility';
+export * from './McpToolServerConfigurationService';
+export * from './contracts';
+export * from './models';
+export * from './configuration';
+//# 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":"AAGA,cAAc,WAAW,CAAC;AAC1B,cAAc,qCAAqC,CAAC;AACpD,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,8 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export * from './Utility';
+export * from './McpToolServerConfigurationService';
+export * from './contracts';
+export * from './models';
+export * from './configuration';
+//# 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,uCAAuC;AACvC,kCAAkC;AAElC,cAAc,WAAW,CAAC;AAC1B,cAAc,qCAAqC,CAAC;AACpD,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/dist/esm/models/ChatHistoryMessage.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Represents a single message in the chat history.
+ */
+export interface ChatHistoryMessage {
+    /**
+     * The unique identifier for the chat message.
+     */
+    id: string;
+    /**
+     * The role of the message sender (e.g., "user", "assistant", "system").
+     */
+    role: string;
+    /**
+     * The content of the chat message.
+     */
+    content: string;
+    /**
+     * The timestamp of when the message was sent.
+     */
+    timestamp: Date;
+}
+//# sourceMappingURL=ChatHistoryMessage.d.ts.map

package/dist/esm/models/ChatHistoryMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatHistoryMessage.d.ts","sourceRoot":"","sources":["../../../src/models/ChatHistoryMessage.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;CACjB"}

package/dist/esm/models/ChatHistoryMessage.js

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

package/dist/esm/models/ChatHistoryMessage.js.map

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

package/dist/esm/models/ChatMessageRequest.d.ts

@@ -0,0 +1,23 @@
+import { ChatHistoryMessage } from './ChatHistoryMessage';
+/**
+ * Represents the request payload for a real-time threat protection check on a chat message.
+ */
+export interface ChatMessageRequest {
+    /**
+     * The unique identifier for the conversation.
+     */
+    conversationId: string;
+    /**
+     * The unique identifier for the message within the conversation.
+     */
+    messageId: string;
+    /**
+     * The content of the user's message.
+     */
+    userMessage: string;
+    /**
+     * The chat history messages.
+     */
+    chatHistory: ChatHistoryMessage[];
+}
+//# sourceMappingURL=ChatMessageRequest.d.ts.map

package/dist/esm/models/ChatMessageRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatMessageRequest.d.ts","sourceRoot":"","sources":["../../../src/models/ChatMessageRequest.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC"}

package/dist/esm/models/ChatMessageRequest.js

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

package/dist/esm/models/ChatMessageRequest.js.map

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

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

@@ -0,0 +1,3 @@
+export * from './ChatHistoryMessage';
+export * from './ChatMessageRequest';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":"AAGA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/esm/models/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export * from './ChatHistoryMessage';
+export * from './ChatMessageRequest';
+//# sourceMappingURL=index.js.map

package/dist/esm/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@microsoft/agents-a365-tooling",
+  "version": "0.1.0-preview.103",
+  "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",
+  "keywords": [
+    "ai",
+    "agents",
+    "azure",
+    "typescript"
+  ],
+  "author": "Microsoft Corporation",
+  "license": "MIT",
+  "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.103",
+    "@microsoft/agents-hosting": "^1.1.0-alpha.85",
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "express": "^5.2.0",
+    "hono": "^4.11.7"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.17.0",
+    "@typescript-eslint/eslint-plugin": "^8.47.0",
+    "@typescript-eslint/parser": "^8.47.0",
+    "eslint": "^9.39.1",
+    "jest": "^30.2.0",
+    "rimraf": "^6.0.0",
+    "ts-jest": "^29.4.5",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.47.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE.md"
+  ],
+  "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",
+    "lint:fix": "eslint src --fix",
+    "ci": "npm ci",
+    "pack": "node ../../copyFiles.js . && pnpm pack --pack-destination=../"
+  }
+}