agent-swarm-kit 1.1.25 → 1.1.26

package/build/index.cjs

@@ -4912,6 +4912,7 @@ const getAgentName = beginContext(async (clientId) => {
     return await swarm$1.swarmPublicService.getAgentName(METHOD_NAME$1c, clientId, swarmName);
 });
 
+const METHOD_NAME_UPDATE$2 = "McpUtils.update";
 /**
  * A no-operation implementation of the IMCP interface.
  * This class provides empty or error-throwing implementations of MCP methods.
@@ -4938,6 +4939,24 @@ class NoopMCP {
             });
         return [];
     }
+    /**
+     * Updates the list of tools for a specific client.
+     * @param clientId - The ID of the client whose tools are to be updated.
+     */
+    async updateToolsForAll() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`NoopMCP updateToolsForAll agentName=${this.agentName}`);
+    }
+    /**
+     * Updates the list of tools for a specific client.
+     * @param clientId - The ID of the client whose tools are to be updated.
+     */
+    async updateToolsForClient(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`NoopMCP updateToolsForClient agentName=${this.agentName}`, {
+                clientId,
+            });
+    }
     /**
      * Checks if a specific tool exists for a given client.
      * @param toolName - The name of the tool to check.
@@ -5020,6 +5039,30 @@ class MergeMCP {
         }
         return false;
     }
+    /**
+     * Updates the list of tools for all clients across all merged MCPs.
+     * @returns A promise resolving when the tool update is complete.
+     */
+    async updateToolsForAll() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`MergeMCP updateToolsForAll agentName=${this.agentName}`);
+        for (const mcp of this.mcpList) {
+            await mcp.updateToolsForAll();
+        }
+    }
+    /**
+     * Updates the list of tools for a specific client across all merged MCPs.
+     * @param clientId - The ID of the client whose tools are to be updated.
+     */
+    async updateToolsForClient(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`MergeMCP updateToolsForClient agentName=${this.agentName}`, {
+                clientId,
+            });
+        for (const mcp of this.mcpList) {
+            await mcp.updateToolsForClient(clientId);
+        }
+    }
     /**
      * Calls a tool from one of the merged MCPs if it exists.
      * @param toolName - The name of the tool to call.
@@ -5055,6 +5098,35 @@ class MergeMCP {
         throw new Error(`MergeMCP callTool agentName=${this.agentName} tool not found toolName=${toolName}`);
     }
 }
+/**
+ * Utility class for managing MCP updates.
+ * This class provides methods to update tools for all clients or a specific client.
+ * It is used in the context of the MCP (Multi-Client Protocol) system.
+ */
+class MCPUtils {
+    /**
+     * Updates the list of tools for all clients or a specific client.
+     * @param mcpName - The name of the MCP to update.
+     * @param clientId - Optional client ID to update tools for a specific client.
+     * @returns A promise resolving when the update is complete.
+     */
+    async update(mcpName, clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            swarm$1.loggerService.info(METHOD_NAME_UPDATE$2, {
+                mcpName,
+                clientId,
+            });
+        swarm$1.mcpValidationService.validate(mcpName, METHOD_NAME_UPDATE$2);
+        if (clientId) {
+            return await swarm$1.mcpPublicService.updateToolsForClient(METHOD_NAME_UPDATE$2, clientId, mcpName);
+        }
+        return await swarm$1.mcpPublicService.updateToolsForAll(METHOD_NAME_UPDATE$2, mcpName);
+    }
+}
+/**
+ * Singleton instance of the MCPUtils class.
+ */
+const MCP = new MCPUtils();
 
 /**
  * Service class for managing agent connections and operations in the swarm system.
@@ -15263,6 +15335,30 @@ class ClientMCP {
         const toolMap = await this.fetchTools(clientId);
         return toolMap.has(toolName);
     }
+    /**
+     * Updates the list of tools by clearing the cache and invoking the update callback.
+     * @returns A promise resolving when the update is complete.
+     */
+    async updateToolsForClient(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientMCP mcpName=${this.params.mcpName} updateToolsForClient`, { clientId });
+        this.fetchTools.clear(clientId);
+        if (this.params.callbacks?.onUpdate) {
+            this.params.callbacks.onUpdate(this.params.mcpName, clientId);
+        }
+    }
+    /**
+     * Updates the list of tools for all clients by clearing the cache and invoking the update callback.
+     * @returns A promise resolving when the update is complete.
+     */
+    async updateToolsForAll() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientMCP mcpName=${this.params.mcpName} updateToolsForAll`, {});
+        this.fetchTools.clear();
+        if (this.params.callbacks?.onUpdate) {
+            this.params.callbacks.onUpdate(this.params.mcpName, undefined);
+        }
+    }
     /**
      * Calls a specific tool with the provided parameters.
      * @param toolName - The name of the tool to call.
@@ -15352,6 +15448,27 @@ class MCPConnectionService {
             });
         return await this.getMCP(this.methodContextService.context.mcpName).listTools(clientId);
     }
+    /**
+     * Updates the list of tools for all clients.
+     * @returns A promise resolving when the tool update is complete.
+     */
+    async updateToolsForAll() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpConnectionService updateToolsForAll`, {});
+        return await this.getMCP(this.methodContextService.context.mcpName).updateToolsForAll();
+    }
+    /**
+     * Updates the list of tools for a specific client.
+     * @param clientId - The ID of the client whose tools are to be updated.
+     * @returns
+     */
+    async updateToolsForClient(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpConnectionService updateToolsForClient`, {
+                clientId,
+            });
+        return await this.getMCP(this.methodContextService.context.mcpName).updateToolsForClient(clientId);
+    }
     /**
      * Checks if a specific tool exists for a given client.
      * @param toolName - The name of the tool to check.
@@ -15510,6 +15627,57 @@ class MCPPublicService {
             computeName: "",
         });
     }
+    /**
+     * Updates the list of tools for all clients within a specified context.
+     * @param methodName - The name of the method for context tracking.
+     * @param mcpName - The name of the MCP to query.
+     * @returns A promise resolving when the update is complete.
+     */
+    async updateToolsForAll(methodName, mcpName) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpPublicService updateToolsForAll`, {
+                mcpName,
+            });
+        return await MethodContextService.runInContext(async () => {
+            return await this.mcpConnectionService.updateToolsForAll();
+        }, {
+            methodName,
+            clientId: "",
+            mcpName,
+            agentName: "",
+            swarmName: "",
+            storageName: "",
+            stateName: "",
+            policyName: "",
+            computeName: "",
+        });
+    }
+    /**
+     * Updates the list of tools for a specific client within a specified context.
+     * @param methodName - The name of the method for context tracking.
+     * @param clientId - The ID of the client whose tools are to be updated.
+     * @param mcpName - The name of the MCP to query.
+     * @returns A promise resolving when the update is complete.
+     */
+    async updateToolsForClient(methodName, clientId, mcpName) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpPublicService updateToolsForClient`, {
+                clientId,
+            });
+        return await MethodContextService.runInContext(async () => {
+            return await this.mcpConnectionService.updateToolsForClient(clientId);
+        }, {
+            methodName,
+            clientId,
+            mcpName,
+            agentName: "",
+            swarmName: "",
+            storageName: "",
+            stateName: "",
+            policyName: "",
+            computeName: "",
+        });
+    }
     /**
      * Checks if a specific tool exists for a given client within a specified context.
      * @param methodName - The name of the method for context tracking.
@@ -22324,6 +22492,7 @@ exports.HistoryMemoryInstance = HistoryMemoryInstance;
 exports.HistoryPersistInstance = HistoryPersistInstance;
 exports.Logger = Logger;
 exports.LoggerInstance = LoggerInstance;
+exports.MCP = MCP;
 exports.MethodContextService = MethodContextService;
 exports.Operator = Operator;
 exports.OperatorInstance = OperatorInstance;

package/build/index.mjs

@@ -4910,6 +4910,7 @@ const getAgentName = beginContext(async (clientId) => {
     return await swarm$1.swarmPublicService.getAgentName(METHOD_NAME$1c, clientId, swarmName);
 });
 
+const METHOD_NAME_UPDATE$2 = "McpUtils.update";
 /**
  * A no-operation implementation of the IMCP interface.
  * This class provides empty or error-throwing implementations of MCP methods.
@@ -4936,6 +4937,24 @@ class NoopMCP {
             });
         return [];
     }
+    /**
+     * Updates the list of tools for a specific client.
+     * @param clientId - The ID of the client whose tools are to be updated.
+     */
+    async updateToolsForAll() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`NoopMCP updateToolsForAll agentName=${this.agentName}`);
+    }
+    /**
+     * Updates the list of tools for a specific client.
+     * @param clientId - The ID of the client whose tools are to be updated.
+     */
+    async updateToolsForClient(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`NoopMCP updateToolsForClient agentName=${this.agentName}`, {
+                clientId,
+            });
+    }
     /**
      * Checks if a specific tool exists for a given client.
      * @param toolName - The name of the tool to check.
@@ -5018,6 +5037,30 @@ class MergeMCP {
         }
         return false;
     }
+    /**
+     * Updates the list of tools for all clients across all merged MCPs.
+     * @returns A promise resolving when the tool update is complete.
+     */
+    async updateToolsForAll() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`MergeMCP updateToolsForAll agentName=${this.agentName}`);
+        for (const mcp of this.mcpList) {
+            await mcp.updateToolsForAll();
+        }
+    }
+    /**
+     * Updates the list of tools for a specific client across all merged MCPs.
+     * @param clientId - The ID of the client whose tools are to be updated.
+     */
+    async updateToolsForClient(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(`MergeMCP updateToolsForClient agentName=${this.agentName}`, {
+                clientId,
+            });
+        for (const mcp of this.mcpList) {
+            await mcp.updateToolsForClient(clientId);
+        }
+    }
     /**
      * Calls a tool from one of the merged MCPs if it exists.
      * @param toolName - The name of the tool to call.
@@ -5053,6 +5096,35 @@ class MergeMCP {
         throw new Error(`MergeMCP callTool agentName=${this.agentName} tool not found toolName=${toolName}`);
     }
 }
+/**
+ * Utility class for managing MCP updates.
+ * This class provides methods to update tools for all clients or a specific client.
+ * It is used in the context of the MCP (Multi-Client Protocol) system.
+ */
+class MCPUtils {
+    /**
+     * Updates the list of tools for all clients or a specific client.
+     * @param mcpName - The name of the MCP to update.
+     * @param clientId - Optional client ID to update tools for a specific client.
+     * @returns A promise resolving when the update is complete.
+     */
+    async update(mcpName, clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            swarm$1.loggerService.info(METHOD_NAME_UPDATE$2, {
+                mcpName,
+                clientId,
+            });
+        swarm$1.mcpValidationService.validate(mcpName, METHOD_NAME_UPDATE$2);
+        if (clientId) {
+            return await swarm$1.mcpPublicService.updateToolsForClient(METHOD_NAME_UPDATE$2, clientId, mcpName);
+        }
+        return await swarm$1.mcpPublicService.updateToolsForAll(METHOD_NAME_UPDATE$2, mcpName);
+    }
+}
+/**
+ * Singleton instance of the MCPUtils class.
+ */
+const MCP = new MCPUtils();
 
 /**
  * Service class for managing agent connections and operations in the swarm system.
@@ -15261,6 +15333,30 @@ class ClientMCP {
         const toolMap = await this.fetchTools(clientId);
         return toolMap.has(toolName);
     }
+    /**
+     * Updates the list of tools by clearing the cache and invoking the update callback.
+     * @returns A promise resolving when the update is complete.
+     */
+    async updateToolsForClient(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientMCP mcpName=${this.params.mcpName} updateToolsForClient`, { clientId });
+        this.fetchTools.clear(clientId);
+        if (this.params.callbacks?.onUpdate) {
+            this.params.callbacks.onUpdate(this.params.mcpName, clientId);
+        }
+    }
+    /**
+     * Updates the list of tools for all clients by clearing the cache and invoking the update callback.
+     * @returns A promise resolving when the update is complete.
+     */
+    async updateToolsForAll() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientMCP mcpName=${this.params.mcpName} updateToolsForAll`, {});
+        this.fetchTools.clear();
+        if (this.params.callbacks?.onUpdate) {
+            this.params.callbacks.onUpdate(this.params.mcpName, undefined);
+        }
+    }
     /**
      * Calls a specific tool with the provided parameters.
      * @param toolName - The name of the tool to call.
@@ -15350,6 +15446,27 @@ class MCPConnectionService {
             });
         return await this.getMCP(this.methodContextService.context.mcpName).listTools(clientId);
     }
+    /**
+     * Updates the list of tools for all clients.
+     * @returns A promise resolving when the tool update is complete.
+     */
+    async updateToolsForAll() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpConnectionService updateToolsForAll`, {});
+        return await this.getMCP(this.methodContextService.context.mcpName).updateToolsForAll();
+    }
+    /**
+     * Updates the list of tools for a specific client.
+     * @param clientId - The ID of the client whose tools are to be updated.
+     * @returns
+     */
+    async updateToolsForClient(clientId) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpConnectionService updateToolsForClient`, {
+                clientId,
+            });
+        return await this.getMCP(this.methodContextService.context.mcpName).updateToolsForClient(clientId);
+    }
     /**
      * Checks if a specific tool exists for a given client.
      * @param toolName - The name of the tool to check.
@@ -15508,6 +15625,57 @@ class MCPPublicService {
             computeName: "",
         });
     }
+    /**
+     * Updates the list of tools for all clients within a specified context.
+     * @param methodName - The name of the method for context tracking.
+     * @param mcpName - The name of the MCP to query.
+     * @returns A promise resolving when the update is complete.
+     */
+    async updateToolsForAll(methodName, mcpName) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpPublicService updateToolsForAll`, {
+                mcpName,
+            });
+        return await MethodContextService.runInContext(async () => {
+            return await this.mcpConnectionService.updateToolsForAll();
+        }, {
+            methodName,
+            clientId: "",
+            mcpName,
+            agentName: "",
+            swarmName: "",
+            storageName: "",
+            stateName: "",
+            policyName: "",
+            computeName: "",
+        });
+    }
+    /**
+     * Updates the list of tools for a specific client within a specified context.
+     * @param methodName - The name of the method for context tracking.
+     * @param clientId - The ID of the client whose tools are to be updated.
+     * @param mcpName - The name of the MCP to query.
+     * @returns A promise resolving when the update is complete.
+     */
+    async updateToolsForClient(methodName, clientId, mcpName) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+            this.loggerService.info(`mcpPublicService updateToolsForClient`, {
+                clientId,
+            });
+        return await MethodContextService.runInContext(async () => {
+            return await this.mcpConnectionService.updateToolsForClient(clientId);
+        }, {
+            methodName,
+            clientId,
+            mcpName,
+            agentName: "",
+            swarmName: "",
+            storageName: "",
+            stateName: "",
+            policyName: "",
+            computeName: "",
+        });
+    }
     /**
      * Checks if a specific tool exists for a given client within a specified context.
      * @param methodName - The name of the method for context tracking.
@@ -22313,4 +22481,4 @@ const Utils = {
     PersistEmbeddingUtils,
 };
 
-export { Adapter, Chat, Compute, ExecutionContextService, History, HistoryMemoryInstance, HistoryPersistInstance, Logger, LoggerInstance, MethodContextService, Operator, OperatorInstance, PayloadContextService, PersistAlive, PersistBase, PersistEmbedding, PersistList, PersistMemory, PersistPolicy, PersistState, PersistStorage, PersistSwarm, Policy, RoundRobin, Schema, SharedCompute, SharedState, SharedStorage, State, Storage, Utils, addAgent, addAgentNavigation, addCompletion, addCompute, addEmbedding, addMCP, addPolicy, addState, addStorage, addSwarm, addTool, addTriageNavigation, addWiki, beginContext, cancelOutput, cancelOutputForce, changeToAgent, changeToDefaultAgent, changeToPrevAgent, commitAssistantMessage, commitAssistantMessageForce, commitFlush, commitFlushForce, commitStopTools, commitStopToolsForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitUserMessage, commitUserMessageForce, complete, createNavigateToAgent, createNavigateToTriageAgent, disposeConnection, dumpAgent, dumpClientPerformance, dumpDocs, dumpPerfomance, dumpSwarm, emit, emitForce, event, execute, executeForce, getAgentHistory, getAgentName, getAssistantHistory, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getNavigationRoute, getPayload, getRawHistory, getSessionContext, getSessionMode, getUserHistory, hasNavigation, hasSession, listenAgentEvent, listenAgentEventOnce, listenEvent, listenEventOnce, listenExecutionEvent, listenExecutionEventOnce, listenHistoryEvent, listenHistoryEventOnce, listenPolicyEvent, listenPolicyEventOnce, listenSessionEvent, listenSessionEventOnce, listenStateEvent, listenStateEventOnce, listenStorageEvent, listenStorageEventOnce, listenSwarmEvent, listenSwarmEventOnce, makeAutoDispose, makeConnection, markOffline, markOnline, notify, notifyForce, overrideAgent, overrideCompletion, overrideCompute, overrideEmbeding, overrideMCP, overridePolicy, overrideState, overrideStorage, overrideSwarm, overrideTool, overrideWiki, question, questionForce, runStateless, runStatelessForce, session, setConfig, swarm };
+export { Adapter, Chat, Compute, ExecutionContextService, History, HistoryMemoryInstance, HistoryPersistInstance, Logger, LoggerInstance, MCP, MethodContextService, Operator, OperatorInstance, PayloadContextService, PersistAlive, PersistBase, PersistEmbedding, PersistList, PersistMemory, PersistPolicy, PersistState, PersistStorage, PersistSwarm, Policy, RoundRobin, Schema, SharedCompute, SharedState, SharedStorage, State, Storage, Utils, addAgent, addAgentNavigation, addCompletion, addCompute, addEmbedding, addMCP, addPolicy, addState, addStorage, addSwarm, addTool, addTriageNavigation, addWiki, beginContext, cancelOutput, cancelOutputForce, changeToAgent, changeToDefaultAgent, changeToPrevAgent, commitAssistantMessage, commitAssistantMessageForce, commitFlush, commitFlushForce, commitStopTools, commitStopToolsForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitUserMessage, commitUserMessageForce, complete, createNavigateToAgent, createNavigateToTriageAgent, disposeConnection, dumpAgent, dumpClientPerformance, dumpDocs, dumpPerfomance, dumpSwarm, emit, emitForce, event, execute, executeForce, getAgentHistory, getAgentName, getAssistantHistory, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getNavigationRoute, getPayload, getRawHistory, getSessionContext, getSessionMode, getUserHistory, hasNavigation, hasSession, listenAgentEvent, listenAgentEventOnce, listenEvent, listenEventOnce, listenExecutionEvent, listenExecutionEventOnce, listenHistoryEvent, listenHistoryEventOnce, listenPolicyEvent, listenPolicyEventOnce, listenSessionEvent, listenSessionEventOnce, listenStateEvent, listenStateEventOnce, listenStorageEvent, listenStorageEventOnce, listenSwarmEvent, listenSwarmEventOnce, makeAutoDispose, makeConnection, markOffline, markOnline, notify, notifyForce, overrideAgent, overrideCompletion, overrideCompute, overrideEmbeding, overrideMCP, overridePolicy, overrideState, overrideStorage, overrideSwarm, overrideTool, overrideWiki, question, questionForce, runStateless, runStatelessForce, session, setConfig, swarm };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-swarm-kit",
-  "version": "1.1.25",
+  "version": "1.1.26",
   "description": "A TypeScript library for building orchestrated framework-agnostic multi-agent AI systems",
   "author": {
     "name": "Petr Tripolsky",

package/types.d.ts

@@ -3170,6 +3170,16 @@ interface IMCP {
      * @returns A promise resolving when the tool call is complete.
      */
     callTool<T extends MCPToolValue = MCPToolValue>(toolName: string, dto: IMCPToolCallDto<T>): Promise<MCPToolOutput>;
+    /**
+     * Updates the list of tools by clearing the cache and invoking the update callback.
+     * @returns A promise resolving when the update is complete.
+     */
+    updateToolsForAll(): Promise<void>;
+    /**
+     * Updates the list of tools by clearing the cache and invoking the update callback.
+     * @returns A promise resolving when the update is complete.
+     */
+    updateToolsForClient(clientId: string): Promise<void>;
 }
 /**
  * Interface for MCP callback functions triggered during various lifecycle events.
@@ -3198,6 +3208,11 @@ interface IMCPCallbacks {
      * @param dto - The data transfer object containing tool call parameters.
      */
     onCall<T extends MCPToolValue = MCPToolValue>(toolName: string, dto: IMCPToolCallDto<T>): void;
+    /**
+     * Called when the list of tools is updated.
+     * @param clientId - The ID of the client.
+     */
+    onUpdate(mcpName: MCPName, clientId: string | undefined): void;
 }
 /**
  * Interface for the MCP schema, defining the structure and behavior of an MCP.
@@ -9135,6 +9150,16 @@ declare class ClientMCP implements IMCP {
      * @returns A promise resolving to true if the tool exists, false otherwise.
      */
     hasTool(toolName: string, clientId: string): Promise<boolean>;
+    /**
+     * Updates the list of tools by clearing the cache and invoking the update callback.
+     * @returns A promise resolving when the update is complete.
+     */
+    updateToolsForClient(clientId: string): Promise<void>;
+    /**
+     * Updates the list of tools for all clients by clearing the cache and invoking the update callback.
+     * @returns A promise resolving when the update is complete.
+     */
+    updateToolsForAll(): Promise<void>;
     /**
      * Calls a specific tool with the provided parameters.
      * @param toolName - The name of the tool to call.
@@ -9174,6 +9199,17 @@ declare class MCPConnectionService implements IMCP {
      * @returns A promise resolving to an array of IMCPTool objects.
      */
     listTools(clientId: string): Promise<IMCPTool[]>;
+    /**
+     * Updates the list of tools for all clients.
+     * @returns A promise resolving when the tool update is complete.
+     */
+    updateToolsForAll(): Promise<void>;
+    /**
+     * Updates the list of tools for a specific client.
+     * @param clientId - The ID of the client whose tools are to be updated.
+     * @returns
+     */
+    updateToolsForClient(clientId: string): Promise<void>;
     /**
      * Checks if a specific tool exists for a given client.
      * @param toolName - The name of the tool to check.
@@ -9258,6 +9294,21 @@ declare class MCPPublicService implements TMCPConnectionService {
      * @returns A promise resolving to an array of IMCPTool objects.
      */
     listTools(methodName: string, clientId: string, mcpName: string): Promise<IMCPTool[]>;
+    /**
+     * Updates the list of tools for all clients within a specified context.
+     * @param methodName - The name of the method for context tracking.
+     * @param mcpName - The name of the MCP to query.
+     * @returns A promise resolving when the update is complete.
+     */
+    updateToolsForAll(methodName: string, mcpName: string): Promise<void>;
+    /**
+     * Updates the list of tools for a specific client within a specified context.
+     * @param methodName - The name of the method for context tracking.
+     * @param clientId - The ID of the client whose tools are to be updated.
+     * @param mcpName - The name of the MCP to query.
+     * @returns A promise resolving when the update is complete.
+     */
+    updateToolsForClient(methodName: string, clientId: string, mcpName: string): Promise<void>;
     /**
      * Checks if a specific tool exists for a given client within a specified context.
      * @param methodName - The name of the method for context tracking.
@@ -13001,6 +13052,25 @@ declare class RoundRobin<T, Token = string | symbol | {
     private call;
 }
 
+/**
+ * Utility class for managing MCP updates.
+ * This class provides methods to update tools for all clients or a specific client.
+ * It is used in the context of the MCP (Multi-Client Protocol) system.
+ */
+declare class MCPUtils {
+    /**
+     * Updates the list of tools for all clients or a specific client.
+     * @param mcpName - The name of the MCP to update.
+     * @param clientId - Optional client ID to update tools for a specific client.
+     * @returns A promise resolving when the update is complete.
+     */
+    update(mcpName: MCPName, clientId?: string): Promise<void>;
+}
+/**
+ * Singleton instance of the MCPUtils class.
+ */
+declare const MCP: MCPUtils;
+
 /**
  * Utility class providing methods to manage client bans within a swarm policy context.
  * All methods validate inputs and execute within a context for logging and tracking.
@@ -13802,4 +13872,4 @@ declare const Utils: {
     PersistEmbeddingUtils: typeof PersistEmbeddingUtils;
 };
 
-export { Adapter, Chat, Compute, type EventSource, ExecutionContextService, History, HistoryMemoryInstance, HistoryPersistInstance, type IAgentSchema, type IAgentTool, type IBaseEvent, type IBusEvent, type IBusEventContext, type IChatArgs, type IChatInstance, type IChatInstanceCallbacks, type ICompletionArgs, type ICompletionSchema, type IComputeSchema, type ICustomEvent, type IEmbeddingSchema, type IGlobalConfig, type IHistoryAdapter, type IHistoryControl, type IHistoryInstance, type IHistoryInstanceCallbacks, type IIncomingMessage, type ILoggerAdapter, type ILoggerInstance, type ILoggerInstanceCallbacks, type IMCPSchema, type IMCPTool, type IMakeConnectionConfig, type IMakeDisposeParams, type IModelMessage, type INavigateToAgentParams, type INavigateToTriageParams, type IOutgoingMessage, type IPersistActiveAgentData, type IPersistAliveData, type IPersistBase, type IPersistEmbeddingData, type IPersistMemoryData, type IPersistNavigationStackData, type IPersistPolicyData, type IPersistStateData, type IPersistStorageData, type IPolicySchema, type ISessionConfig, type IStateSchema, type IStorageData, type IStorageSchema, type ISwarmSchema, type ITool, type IToolCall, type IWikiSchema, Logger, LoggerInstance, type MCPToolProperties, MethodContextService, Operator, OperatorInstance, PayloadContextService, PersistAlive, PersistBase, PersistEmbedding, PersistList, PersistMemory, PersistPolicy, PersistState, PersistStorage, PersistSwarm, Policy, type ReceiveMessageFn, RoundRobin, Schema, type SendMessageFn, SharedCompute, SharedState, SharedStorage, State, Storage, type THistoryInstanceCtor, type THistoryMemoryInstance, type THistoryPersistInstance, type TLoggerInstance, type TOperatorInstance, type TPersistBase, type TPersistBaseCtor, type TPersistList, type ToolValue, Utils, addAgent, addAgentNavigation, addCompletion, addCompute, addEmbedding, addMCP, addPolicy, addState, addStorage, addSwarm, addTool, addTriageNavigation, addWiki, beginContext, cancelOutput, cancelOutputForce, changeToAgent, changeToDefaultAgent, changeToPrevAgent, commitAssistantMessage, commitAssistantMessageForce, commitFlush, commitFlushForce, commitStopTools, commitStopToolsForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitUserMessage, commitUserMessageForce, complete, createNavigateToAgent, createNavigateToTriageAgent, disposeConnection, dumpAgent, dumpClientPerformance, dumpDocs, dumpPerfomance, dumpSwarm, emit, emitForce, event, execute, executeForce, getAgentHistory, getAgentName, getAssistantHistory, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getNavigationRoute, getPayload, getRawHistory, getSessionContext, getSessionMode, getUserHistory, hasNavigation, hasSession, listenAgentEvent, listenAgentEventOnce, listenEvent, listenEventOnce, listenExecutionEvent, listenExecutionEventOnce, listenHistoryEvent, listenHistoryEventOnce, listenPolicyEvent, listenPolicyEventOnce, listenSessionEvent, listenSessionEventOnce, listenStateEvent, listenStateEventOnce, listenStorageEvent, listenStorageEventOnce, listenSwarmEvent, listenSwarmEventOnce, makeAutoDispose, makeConnection, markOffline, markOnline, notify, notifyForce, overrideAgent, overrideCompletion, overrideCompute, overrideEmbeding, overrideMCP, overridePolicy, overrideState, overrideStorage, overrideSwarm, overrideTool, overrideWiki, question, questionForce, runStateless, runStatelessForce, session, setConfig, swarm };
+export { Adapter, Chat, Compute, type EventSource, ExecutionContextService, History, HistoryMemoryInstance, HistoryPersistInstance, type IAgentSchema, type IAgentTool, type IBaseEvent, type IBusEvent, type IBusEventContext, type IChatArgs, type IChatInstance, type IChatInstanceCallbacks, type ICompletionArgs, type ICompletionSchema, type IComputeSchema, type ICustomEvent, type IEmbeddingSchema, type IGlobalConfig, type IHistoryAdapter, type IHistoryControl, type IHistoryInstance, type IHistoryInstanceCallbacks, type IIncomingMessage, type ILoggerAdapter, type ILoggerInstance, type ILoggerInstanceCallbacks, type IMCPSchema, type IMCPTool, type IMakeConnectionConfig, type IMakeDisposeParams, type IModelMessage, type INavigateToAgentParams, type INavigateToTriageParams, type IOutgoingMessage, type IPersistActiveAgentData, type IPersistAliveData, type IPersistBase, type IPersistEmbeddingData, type IPersistMemoryData, type IPersistNavigationStackData, type IPersistPolicyData, type IPersistStateData, type IPersistStorageData, type IPolicySchema, type ISessionConfig, type IStateSchema, type IStorageData, type IStorageSchema, type ISwarmSchema, type ITool, type IToolCall, type IWikiSchema, Logger, LoggerInstance, MCP, type MCPToolProperties, MethodContextService, Operator, OperatorInstance, PayloadContextService, PersistAlive, PersistBase, PersistEmbedding, PersistList, PersistMemory, PersistPolicy, PersistState, PersistStorage, PersistSwarm, Policy, type ReceiveMessageFn, RoundRobin, Schema, type SendMessageFn, SharedCompute, SharedState, SharedStorage, State, Storage, type THistoryInstanceCtor, type THistoryMemoryInstance, type THistoryPersistInstance, type TLoggerInstance, type TOperatorInstance, type TPersistBase, type TPersistBaseCtor, type TPersistList, type ToolValue, Utils, addAgent, addAgentNavigation, addCompletion, addCompute, addEmbedding, addMCP, addPolicy, addState, addStorage, addSwarm, addTool, addTriageNavigation, addWiki, beginContext, cancelOutput, cancelOutputForce, changeToAgent, changeToDefaultAgent, changeToPrevAgent, commitAssistantMessage, commitAssistantMessageForce, commitFlush, commitFlushForce, commitStopTools, commitStopToolsForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitUserMessage, commitUserMessageForce, complete, createNavigateToAgent, createNavigateToTriageAgent, disposeConnection, dumpAgent, dumpClientPerformance, dumpDocs, dumpPerfomance, dumpSwarm, emit, emitForce, event, execute, executeForce, getAgentHistory, getAgentName, getAssistantHistory, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getNavigationRoute, getPayload, getRawHistory, getSessionContext, getSessionMode, getUserHistory, hasNavigation, hasSession, listenAgentEvent, listenAgentEventOnce, listenEvent, listenEventOnce, listenExecutionEvent, listenExecutionEventOnce, listenHistoryEvent, listenHistoryEventOnce, listenPolicyEvent, listenPolicyEventOnce, listenSessionEvent, listenSessionEventOnce, listenStateEvent, listenStateEventOnce, listenStorageEvent, listenStorageEventOnce, listenSwarmEvent, listenSwarmEventOnce, makeAutoDispose, makeConnection, markOffline, markOnline, notify, notifyForce, overrideAgent, overrideCompletion, overrideCompute, overrideEmbeding, overrideMCP, overridePolicy, overrideState, overrideStorage, overrideSwarm, overrideTool, overrideWiki, question, questionForce, runStateless, runStatelessForce, session, setConfig, swarm };