@microsoft/agents-a365-tooling-extensions-langchain 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-langchain
+
+[![npm](https://img.shields.io/npm/v/@microsoft/agents-a365-tooling-extensions-langchain?label=npm&logo=npm)](https://www.npmjs.com/package/@microsoft/agents-a365-tooling-extensions-langchain)
+[![npm Downloads](https://img.shields.io/npm/dm/@microsoft/agents-a365-tooling-extensions-langchain?label=Downloads&logo=npm)](https://www.npmjs.com/package/@microsoft/agents-a365-tooling-extensions-langchain)
+
+LangChain integration for the Microsoft Agent 365 Tooling SDK. This package enables seamless integration of MCP (Model Context Protocol) tool servers with LangChain agents, providing automatic tool discovery and registration as DynamicStructuredTool instances.
+
+## Installation
+
+```bash
+npm install @microsoft/agents-a365-tooling-extensions-langchain
+```
+
+## 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,172 @@
+import { ToolOptions } from '@microsoft/agents-a365-tooling';
+import { OperationResult, IConfigurationProvider } from '@microsoft/agents-a365-runtime';
+import { LangChainToolingConfiguration } from './configuration';
+import { TurnContext, Authorization } from '@microsoft/agents-hosting';
+import { ReactAgent } from 'langchain';
+import { BaseMessage } from '@langchain/core/messages';
+import { BaseChatMessageHistory } from '@langchain/core/chat_history';
+import { RunnableConfig } from '@langchain/core/runnables';
+import type { CompiledStateGraph, StateSnapshot } from '@langchain/langgraph';
+/**
+ * Discover MCP servers and list tools formatted for the LangChain Orchestrator.
+ * Uses listToolServers to fetch server configs and getTools to enumerate tools.
+ *
+ * Also provides methods to send chat history to the MCP platform for
+ * real-time threat protection (RTP) analysis.
+ */
+export declare class McpToolRegistrationService {
+    private readonly configService;
+    private readonly configProvider;
+    private readonly orchestratorName;
+    /**
+     * Construct a McpToolRegistrationService.
+     * @param configProvider Optional configuration provider. Defaults to defaultLangChainToolingConfigurationProvider if not specified.
+     */
+    constructor(configProvider?: IConfigurationProvider<LangChainToolingConfiguration>);
+    /**
+     * Registers MCP tool servers and updates agent options with discovered tools and server configs.
+     * Call this to enable dynamic LangChain tool access based on the current MCP environment.
+     * @param agent The LangChain 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: ReactAgent, authorization: Authorization, authHandlerName: string, turnContext: TurnContext, authToken: string): Promise<ReactAgent>;
+    /**
+     * Sends chat history from a LangGraph CompiledStateGraph to the MCP platform.
+     *
+     * This is the highest-level and easiest-to-use API. It retrieves the current state
+     * from the graph, extracts messages, converts them to ChatHistoryMessage format,
+     * and sends them to the MCP platform for real-time threat protection.
+     *
+     * @param turnContext - The turn context containing conversation information.
+     * @param graph - The LangGraph CompiledStateGraph instance. The graph state must contain a 'messages' array.
+     * @param config - The RunnableConfig containing thread_id and other configuration.
+     * @param limit - Optional limit on the number of messages to send.
+     * @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 graph is null/undefined.
+     * @throws Error if config is null/undefined.
+     *
+     * @example
+     * ```typescript
+     * const config = { configurable: { thread_id: '1' } };
+     * const result = await service.sendChatHistoryAsync(turnContext, graph, config);
+     * if (result.succeeded) {
+     *   console.log('Chat history sent successfully');
+     * }
+     * ```
+     */
+    sendChatHistoryAsync(turnContext: TurnContext, graph: CompiledStateGraph<unknown, unknown, string>, config: RunnableConfig, limit?: number, toolOptions?: ToolOptions): Promise<OperationResult>;
+    /**
+     * Extracts messages from a LangGraph StateSnapshot and sends them to the MCP platform.
+     *
+     * Use this API when you already have a StateSnapshot (e.g., from a previous
+     * `graph.getState()` call) and want to avoid fetching state again.
+     *
+     * @param turnContext - The turn context containing conversation information.
+     * @param stateSnapshot - The LangGraph StateSnapshot containing message state.
+     * @param limit - Optional limit on the number of messages to send.
+     * @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 stateSnapshot is null/undefined.
+     * @throws Error if stateSnapshot does not contain a messages array.
+     *
+     * @example
+     * ```typescript
+     * const config = { configurable: { thread_id: '1' } };
+     * const stateSnapshot = await graph.getState(config);
+     * const result = await service.sendChatHistoryFromStateAsync(turnContext, stateSnapshot);
+     * ```
+     */
+    sendChatHistoryFromStateAsync(turnContext: TurnContext, stateSnapshot: StateSnapshot, limit?: number, toolOptions?: ToolOptions): Promise<OperationResult>;
+    /**
+     * Retrieves messages from a BaseChatMessageHistory instance and sends them to the MCP platform.
+     *
+     * Use this API when working with LangChain's memory abstractions (e.g., InMemoryChatMessageHistory,
+     * RedisChatMessageHistory, etc.).
+     *
+     * @param turnContext - The turn context containing conversation information.
+     * @param chatHistory - The BaseChatMessageHistory instance to retrieve messages from.
+     * @param limit - Optional limit on the number of messages to send.
+     * @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 chatHistory is null/undefined.
+     *
+     * @example
+     * ```typescript
+     * const chatHistory = new InMemoryChatMessageHistory();
+     * // ... add messages to history ...
+     * const result = await service.sendChatHistoryFromChatHistoryAsync(turnContext, chatHistory);
+     * ```
+     */
+    sendChatHistoryFromChatHistoryAsync(turnContext: TurnContext, chatHistory: BaseChatMessageHistory, limit?: number, toolOptions?: ToolOptions): Promise<OperationResult>;
+    /**
+     * Sends an array of LangChain messages to the MCP platform for real-time threat protection.
+     *
+     * This is the lowest-level API that accepts raw BaseMessage arrays. Use this when you
+     * have already extracted messages or have a custom message source not covered by the
+     * higher-level APIs.
+     *
+     * This method converts the provided BaseMessage array to ChatHistoryMessage format
+     * and sends them to the MCP platform. Empty arrays are sent as-is to register the
+     * user message with the platform.
+     *
+     * @param turnContext - The turn context containing conversation information.
+     * @param messages - Array of LangChain BaseMessage objects to send.
+     * @param limit - Optional limit on the number of messages to send.
+     * @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 messages is null/undefined.
+     * @throws Error if required turn context properties are missing.
+     *
+     * @example
+     * ```typescript
+     * const messages = await messageHistory.getMessages();
+     * const result = await service.sendChatHistoryFromMessagesAsync(turnContext, messages, 50);
+     * if (result.succeeded) {
+     *   console.log('Chat history sent successfully');
+     * } else {
+     *   console.error('Failed to send chat history:', result.errors);
+     * }
+     * ```
+     */
+    sendChatHistoryFromMessagesAsync(turnContext: TurnContext, messages: BaseMessage[], limit?: number, toolOptions?: ToolOptions): Promise<OperationResult>;
+    /**
+     * Converts an array of BaseMessage to ChatHistoryMessage format.
+     * Messages that fail conversion are silently skipped.
+     *
+     * @param messages - Array of LangChain BaseMessage objects to convert.
+     * @returns Array of ChatHistoryMessage objects.
+     */
+    private convertToChatHistoryMessages;
+    /**
+     * Converts a single BaseMessage to ChatHistoryMessage format.
+     *
+     * @param message - The LangChain BaseMessage to convert.
+     * @returns ChatHistoryMessage or null if conversion fails.
+     */
+    private convertSingleMessage;
+    /**
+     * Maps a LangChain message type to a standard role string.
+     *
+     * @param message - The LangChain BaseMessage to map.
+     * @returns The mapped role string.
+     */
+    private mapRole;
+    /**
+     * Extracts text content from a LangChain message.
+     * Handles both string content and ContentPart arrays.
+     *
+     * @param message - The LangChain BaseMessage to extract content from.
+     * @returns The extracted text content as a string.
+     */
+    private extractContent;
+}
+//# 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,6BAA6B,EAAgD,MAAM,iBAAiB,CAAC;AAG9G,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGvE,OAAO,EAAe,UAAU,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAO3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;;;;;GAMG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwD;IACvF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;IAExD;;;OAGG;gBACS,cAAc,CAAC,EAAE,sBAAsB,CAAC,6BAA6B,CAAC;IAKlF;;;;;;;;;OASG;IACG,qBAAqB,CACzB,KAAK,EAAE,UAAU,EACjB,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC;IAkDtB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,oBAAoB,CACxB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EACnD,MAAM,EAAE,cAAc,EACtB,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,eAAe,CAAC;IAwB3B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,6BAA6B,CACjC,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,EAC5B,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,eAAe,CAAC;IAiB3B;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,mCAAmC,CACvC,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,sBAAsB,EACnC,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,eAAe,CAAC;IAoB3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,gCAAgC,CACpC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,eAAe,CAAC;IAmC3B;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IAMpC;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAuBf;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;CAgCvB"}

package/dist/cjs/McpToolRegistrationService.js

@@ -0,0 +1,358 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpToolRegistrationService = void 0;
+// Microsoft Agent 365 SDK
+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");
+// LangChain SDKs
+const langchain_1 = require("langchain");
+const mcp_adapters_1 = require("@langchain/mcp-adapters");
+// UUID for generating message IDs
+const uuid_1 = require("uuid");
+/**
+ * Discover MCP servers and list tools formatted for the LangChain Orchestrator.
+ * Uses listToolServers to fetch server configs and getTools to enumerate tools.
+ *
+ * Also provides methods to send chat history to the MCP platform for
+ * real-time threat protection (RTP) analysis.
+ */
+class McpToolRegistrationService {
+    /**
+     * Construct a McpToolRegistrationService.
+     * @param configProvider Optional configuration provider. Defaults to defaultLangChainToolingConfigurationProvider if not specified.
+     */
+    constructor(configProvider) {
+        this.orchestratorName = "LangChain";
+        this.configProvider = configProvider ?? configuration_1.defaultLangChainToolingConfigurationProvider;
+        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 LangChain tool access based on the current MCP environment.
+     * @param agent The LangChain 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('Langchain 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 Connection instance for LangChain agents
+            mcpServers[server.mcpServerName] = {
+                type: 'http',
+                url: server.url,
+                headers: headers
+            };
+        }
+        const mcpClientConfig = {};
+        mcpClientConfig.mcpServers = Object.assign(mcpClientConfig.mcpServers ?? {}, mcpServers);
+        const multiServerMcpClient = new mcp_adapters_1.MultiServerMCPClient(mcpClientConfig);
+        const mcpTools = await multiServerMcpClient.getTools();
+        // Merge existing agent tools with MCP tools
+        const existingTools = agent.options.tools ?? [];
+        const allTools = [...existingTools, ...mcpTools];
+        // Create the agent with existing options and combined tools
+        return (0, langchain_1.createAgent)({
+            ...agent.options,
+            tools: allTools,
+        });
+    }
+    // ============================================================================
+    // Send Chat History API Methods
+    // ============================================================================
+    /**
+     * Sends chat history from a LangGraph CompiledStateGraph to the MCP platform.
+     *
+     * This is the highest-level and easiest-to-use API. It retrieves the current state
+     * from the graph, extracts messages, converts them to ChatHistoryMessage format,
+     * and sends them to the MCP platform for real-time threat protection.
+     *
+     * @param turnContext - The turn context containing conversation information.
+     * @param graph - The LangGraph CompiledStateGraph instance. The graph state must contain a 'messages' array.
+     * @param config - The RunnableConfig containing thread_id and other configuration.
+     * @param limit - Optional limit on the number of messages to send.
+     * @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 graph is null/undefined.
+     * @throws Error if config is null/undefined.
+     *
+     * @example
+     * ```typescript
+     * const config = { configurable: { thread_id: '1' } };
+     * const result = await service.sendChatHistoryAsync(turnContext, graph, config);
+     * if (result.succeeded) {
+     *   console.log('Chat history sent successfully');
+     * }
+     * ```
+     */
+    async sendChatHistoryAsync(turnContext, graph, config, limit, toolOptions) {
+        // Validate inputs
+        if (!turnContext) {
+            throw new Error('turnContext is required');
+        }
+        if (!graph) {
+            throw new Error('graph is required');
+        }
+        if (!config) {
+            throw new Error('config is required');
+        }
+        // Get state from graph - wrap in try-catch as this is an external call
+        let stateSnapshot;
+        try {
+            stateSnapshot = await graph.getState(config);
+        }
+        catch (err) {
+            return agents_a365_runtime_1.OperationResult.failed(new agents_a365_runtime_1.OperationError(err));
+        }
+        // Delegate to state-based method
+        return this.sendChatHistoryFromStateAsync(turnContext, stateSnapshot, limit, toolOptions);
+    }
+    /**
+     * Extracts messages from a LangGraph StateSnapshot and sends them to the MCP platform.
+     *
+     * Use this API when you already have a StateSnapshot (e.g., from a previous
+     * `graph.getState()` call) and want to avoid fetching state again.
+     *
+     * @param turnContext - The turn context containing conversation information.
+     * @param stateSnapshot - The LangGraph StateSnapshot containing message state.
+     * @param limit - Optional limit on the number of messages to send.
+     * @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 stateSnapshot is null/undefined.
+     * @throws Error if stateSnapshot does not contain a messages array.
+     *
+     * @example
+     * ```typescript
+     * const config = { configurable: { thread_id: '1' } };
+     * const stateSnapshot = await graph.getState(config);
+     * const result = await service.sendChatHistoryFromStateAsync(turnContext, stateSnapshot);
+     * ```
+     */
+    async sendChatHistoryFromStateAsync(turnContext, stateSnapshot, limit, toolOptions) {
+        if (!turnContext) {
+            throw new Error('turnContext is required');
+        }
+        if (!stateSnapshot) {
+            throw new Error('stateSnapshot is required');
+        }
+        const values = stateSnapshot.values;
+        const messages = values?.messages;
+        if (!messages || !Array.isArray(messages)) {
+            throw new Error('stateSnapshot must contain messages array in values');
+        }
+        return this.sendChatHistoryFromMessagesAsync(turnContext, messages, limit, toolOptions);
+    }
+    /**
+     * Retrieves messages from a BaseChatMessageHistory instance and sends them to the MCP platform.
+     *
+     * Use this API when working with LangChain's memory abstractions (e.g., InMemoryChatMessageHistory,
+     * RedisChatMessageHistory, etc.).
+     *
+     * @param turnContext - The turn context containing conversation information.
+     * @param chatHistory - The BaseChatMessageHistory instance to retrieve messages from.
+     * @param limit - Optional limit on the number of messages to send.
+     * @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 chatHistory is null/undefined.
+     *
+     * @example
+     * ```typescript
+     * const chatHistory = new InMemoryChatMessageHistory();
+     * // ... add messages to history ...
+     * const result = await service.sendChatHistoryFromChatHistoryAsync(turnContext, chatHistory);
+     * ```
+     */
+    async sendChatHistoryFromChatHistoryAsync(turnContext, chatHistory, limit, toolOptions) {
+        if (!turnContext) {
+            throw new Error('turnContext is required');
+        }
+        if (!chatHistory) {
+            throw new Error('chatHistory is required');
+        }
+        // Retrieve messages from the chat history - wrap in try-catch as this is an external call
+        let messages;
+        try {
+            messages = await chatHistory.getMessages();
+        }
+        catch (err) {
+            return agents_a365_runtime_1.OperationResult.failed(new agents_a365_runtime_1.OperationError(err));
+        }
+        // Delegate to messages-based method
+        return this.sendChatHistoryFromMessagesAsync(turnContext, messages, limit, toolOptions);
+    }
+    /**
+     * Sends an array of LangChain messages to the MCP platform for real-time threat protection.
+     *
+     * This is the lowest-level API that accepts raw BaseMessage arrays. Use this when you
+     * have already extracted messages or have a custom message source not covered by the
+     * higher-level APIs.
+     *
+     * This method converts the provided BaseMessage array to ChatHistoryMessage format
+     * and sends them to the MCP platform. Empty arrays are sent as-is to register the
+     * user message with the platform.
+     *
+     * @param turnContext - The turn context containing conversation information.
+     * @param messages - Array of LangChain BaseMessage objects to send.
+     * @param limit - Optional limit on the number of messages to send.
+     * @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 messages is null/undefined.
+     * @throws Error if required turn context properties are missing.
+     *
+     * @example
+     * ```typescript
+     * const messages = await messageHistory.getMessages();
+     * const result = await service.sendChatHistoryFromMessagesAsync(turnContext, messages, 50);
+     * if (result.succeeded) {
+     *   console.log('Chat history sent successfully');
+     * } else {
+     *   console.error('Failed to send chat history:', result.errors);
+     * }
+     * ```
+     */
+    async sendChatHistoryFromMessagesAsync(turnContext, messages, limit, toolOptions) {
+        // Validate inputs
+        if (!turnContext) {
+            throw new Error('turnContext is required');
+        }
+        if (!messages) {
+            throw new Error('messages is required');
+        }
+        // Apply limit if specified
+        const messagesToProcess = limit !== undefined && limit >= 0 ? messages.slice(0, limit) : messages;
+        // Set default options, preserving any additional properties from toolOptions
+        const effectiveOptions = {
+            orchestratorName: this.orchestratorName,
+            ...toolOptions
+        };
+        // Convert messages (may result in empty array - that's OK)
+        // convertToChatHistoryMessages handles errors internally and never throws
+        const chatHistoryMessages = this.convertToChatHistoryMessages(messagesToProcess);
+        // IMPORTANT: Always send to API, even if empty array
+        // Empty array is required to register the user message with RTP
+        return this.configService.sendChatHistory(turnContext, chatHistoryMessages, effectiveOptions);
+    }
+    // ============================================================================
+    // Private Helper Methods
+    // ============================================================================
+    /**
+     * Converts an array of BaseMessage to ChatHistoryMessage format.
+     * Messages that fail conversion are silently skipped.
+     *
+     * @param messages - Array of LangChain BaseMessage objects to convert.
+     * @returns Array of ChatHistoryMessage objects.
+     */
+    convertToChatHistoryMessages(messages) {
+        return messages
+            .map(msg => this.convertSingleMessage(msg))
+            .filter((msg) => msg !== null);
+    }
+    /**
+     * Converts a single BaseMessage to ChatHistoryMessage format.
+     *
+     * @param message - The LangChain BaseMessage to convert.
+     * @returns ChatHistoryMessage or null if conversion fails.
+     */
+    convertSingleMessage(message) {
+        try {
+            const content = this.extractContent(message);
+            if (!content || content.trim().length === 0) {
+                return null;
+            }
+            return {
+                id: message.id ?? (0, uuid_1.v4)(),
+                role: this.mapRole(message),
+                content: content,
+                timestamp: new Date()
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Maps a LangChain message type to a standard role string.
+     *
+     * @param message - The LangChain BaseMessage to map.
+     * @returns The mapped role string.
+     */
+    mapRole(message) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- LangChain API deprecation, not our code
+        const type = message.getType();
+        switch (type) {
+            case 'human':
+                return 'user';
+            case 'ai':
+                return 'assistant';
+            case 'system':
+                return 'system';
+            case 'tool':
+                return 'tool';
+            case 'function':
+                return 'function';
+            case 'chat':
+                // ChatMessage has a role property
+                return message.role ?? 'user';
+            default:
+                return 'user';
+        }
+    }
+    /**
+     * Extracts text content from a LangChain message.
+     * Handles both string content and ContentPart arrays.
+     *
+     * @param message - The LangChain BaseMessage to extract content from.
+     * @returns The extracted text content as a string.
+     */
+    extractContent(message) {
+        // Try the text accessor first (handles ContentPart arrays)
+        try {
+            const text = message.text;
+            if (text && text.trim().length > 0) {
+                return text;
+            }
+        }
+        catch {
+            // text accessor might throw for non-text content
+        }
+        // Fallback to content property
+        if (typeof message.content === 'string') {
+            return message.content;
+        }
+        // Handle ContentPart array
+        if (Array.isArray(message.content)) {
+            const textParts = message.content
+                .filter((part) => typeof part === 'object' && part !== null && 'text' in part)
+                .map(part => part.text)
+                .filter(text => text && text.length > 0);
+            if (textParts.length > 0) {
+                return textParts.join(' ');
+            }
+        }
+        return '';
+    }
+}
+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/LangChainToolingConfiguration.d.ts

@@ -0,0 +1,42 @@
+import { ToolingConfiguration } from '@microsoft/agents-a365-tooling';
+import { LangChainToolingConfigurationOptions } from './LangChainToolingConfigurationOptions';
+/**
+ * Configuration for LangChain 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 LangChain-specific services to declare their dependency on
+ *    `IConfigurationProvider<LangChainToolingConfiguration>`, making the configuration
+ *    contract explicit and enabling compile-time checking.
+ *
+ * 2. **Extension Point**: Provides a clear place to add LangChain-specific settings
+ *    (e.g., graph execution timeouts, checkpoint intervals, memory limits) without
+ *    breaking existing code when those needs arise.
+ *
+ * 3. **Consistent Pattern**: Maintains symmetry with other extension packages
+ *    (Claude, OpenAI), 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 LangChain configuration
+ * class LangChainService {
+ *   constructor(private configProvider: IConfigurationProvider<LangChainToolingConfiguration>) {}
+ * }
+ *
+ * // Future: Add LangChain-specific settings without breaking changes
+ * class LangChainToolingConfiguration extends ToolingConfiguration {
+ *   get graphExecutionTimeout(): number { ... }
+ * }
+ * ```
+ */
+export declare class LangChainToolingConfiguration extends ToolingConfiguration {
+    constructor(overrides?: LangChainToolingConfigurationOptions);
+}
+//# sourceMappingURL=LangChainToolingConfiguration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LangChainToolingConfiguration.d.ts","sourceRoot":"","sources":["../../../src/configuration/LangChainToolingConfiguration.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC;AAE9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,6BAA8B,SAAQ,oBAAoB;gBACzD,SAAS,CAAC,EAAE,oCAAoC;CAK7D"}