agent-swarm-kit 1.1.109 → 1.1.111

package/build/index.cjs

@@ -3652,6 +3652,12 @@ const TOOL_ERROR_SYMBOL = Symbol("tool-error");
 const TOOL_STOP_SYMBOL = Symbol("tool-stop");
 const TOOL_NO_OUTPUT_WARNING_TIMEOUT = 15000;
 const TOOL_NO_OUTPUT_WARNING_SYMBOL = Symbol("tool-warning-timeout");
+/**
+ * This tool availability function is used as a default for tools that do not specify their availability.
+ * It always returns true, indicating that the tool is available by default.
+ * @returns {boolean} A function that always returns true, indicating the tool is available by default.
+ */
+const TOOL_AVAILABLE_DEFAULT = () => true;
 /**
  * A utility class for managing the lifecycle of an `AbortController` instance.
  * Provides a mechanism to signal and handle abort events for asynchronous operations.
@@ -4129,12 +4135,16 @@ class ClientAgent {
         const agentToolList = [];
         if (this.params.tools) {
             await Promise.all(this.params.tools.map(async (tool) => {
-                const { function: upperFn, ...other } = tool;
+                const { toolName, function: upperFn, isAvailable = TOOL_AVAILABLE_DEFAULT, ...other } = tool;
+                if (await functoolsKit.not(isAvailable(this.params.clientId, this.params.agentName, toolName))) {
+                    return;
+                }
                 const fn = typeof upperFn === "function"
                     ? await upperFn(this.params.clientId, this.params.agentName)
                     : upperFn;
                 agentToolList.push({
                     ...other,
+                    toolName,
                     function: fn,
                 });
             }));
@@ -6197,8 +6207,11 @@ class ToolSchemaService {
             if (typeof toolSchema.call !== "function") {
                 throw new Error(`agent-swarm tool schema validation failed: missing call for toolName=${toolSchema.toolName}`);
             }
+            if (toolSchema.isAvailable && typeof toolSchema.isAvailable !== "function") {
+                throw new Error(`agent-swarm tool schema validation failed: invalid isAvailable for toolName=${toolSchema.toolName}`);
+            }
             if (toolSchema.validate && typeof toolSchema.validate !== "function") {
-                throw new Error(`agent-swarm tool schema validation failed: missing validate for toolName=${toolSchema.toolName}`);
+                throw new Error(`agent-swarm tool schema validation failed: invalid validate for toolName=${toolSchema.toolName}`);
             }
             if (!functoolsKit.isObject(toolSchema.function) && typeof toolSchema.function !== "function") {
                 throw new Error(`agent-swarm tool schema validation failed: missing function for toolName=${toolSchema.toolName}`);

package/build/index.mjs

@@ -3650,6 +3650,12 @@ const TOOL_ERROR_SYMBOL = Symbol("tool-error");
 const TOOL_STOP_SYMBOL = Symbol("tool-stop");
 const TOOL_NO_OUTPUT_WARNING_TIMEOUT = 15000;
 const TOOL_NO_OUTPUT_WARNING_SYMBOL = Symbol("tool-warning-timeout");
+/**
+ * This tool availability function is used as a default for tools that do not specify their availability.
+ * It always returns true, indicating that the tool is available by default.
+ * @returns {boolean} A function that always returns true, indicating the tool is available by default.
+ */
+const TOOL_AVAILABLE_DEFAULT = () => true;
 /**
  * A utility class for managing the lifecycle of an `AbortController` instance.
  * Provides a mechanism to signal and handle abort events for asynchronous operations.
@@ -4127,12 +4133,16 @@ class ClientAgent {
         const agentToolList = [];
         if (this.params.tools) {
             await Promise.all(this.params.tools.map(async (tool) => {
-                const { function: upperFn, ...other } = tool;
+                const { toolName, function: upperFn, isAvailable = TOOL_AVAILABLE_DEFAULT, ...other } = tool;
+                if (await not(isAvailable(this.params.clientId, this.params.agentName, toolName))) {
+                    return;
+                }
                 const fn = typeof upperFn === "function"
                     ? await upperFn(this.params.clientId, this.params.agentName)
                     : upperFn;
                 agentToolList.push({
                     ...other,
+                    toolName,
                     function: fn,
                 });
             }));
@@ -6195,8 +6205,11 @@ class ToolSchemaService {
             if (typeof toolSchema.call !== "function") {
                 throw new Error(`agent-swarm tool schema validation failed: missing call for toolName=${toolSchema.toolName}`);
             }
+            if (toolSchema.isAvailable && typeof toolSchema.isAvailable !== "function") {
+                throw new Error(`agent-swarm tool schema validation failed: invalid isAvailable for toolName=${toolSchema.toolName}`);
+            }
             if (toolSchema.validate && typeof toolSchema.validate !== "function") {
-                throw new Error(`agent-swarm tool schema validation failed: missing validate for toolName=${toolSchema.toolName}`);
+                throw new Error(`agent-swarm tool schema validation failed: invalid validate for toolName=${toolSchema.toolName}`);
             }
             if (!isObject$1(toolSchema.function) && typeof toolSchema.function !== "function") {
                 throw new Error(`agent-swarm tool schema validation failed: missing function for toolName=${toolSchema.toolName}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-swarm-kit",
-  "version": "1.1.109",
+  "version": "1.1.111",
   "description": "A TypeScript library for building orchestrated framework-agnostic multi-agent AI systems",
   "author": {
     "name": "Petr Tripolsky",
@@ -81,7 +81,7 @@
   "dependencies": {
     "di-kit": "^1.0.18",
     "di-scoped": "^1.0.20",
-    "functools-kit": "^1.0.87",
+    "functools-kit": "^1.0.88",
     "get-moment-stamp": "^1.1.1",
     "lodash-es": "4.17.21",
     "xml2js": "0.6.2"

package/types.d.ts

@@ -3396,6 +3396,15 @@ interface IAgentTool<T = Record<string, ToolValue>> {
         callReason: string;
         isLast: boolean;
     }): Promise<void>;
+    /**
+     * Checks if the tool is available for execution.
+     * This method can be used to determine if the tool can be executed based on the current context.
+     * @param {string} clientId - The ID of the client invoking the tool.
+     * @param {AgentName} agentName - The name of the agent using the tool.
+     * @param {ToolName} toolName - The name of the tool to check availability for.
+     * @returns {boolean | Promise<boolean>} True if the tool is available, false otherwise
+     */
+    isAvailable?: (clientId: string, agentName: AgentName, toolName: ToolName) => (boolean | Promise<boolean>);
     /**
      * Validates the tool parameters before execution.
      * Can return synchronously or asynchronously based on validation complexity.