agent-swarm-kit 1.1.136 → 1.1.138

package/build/index.cjs

@@ -4613,6 +4613,12 @@ class ClientAgent {
             clientId: this.params.clientId,
         });
     }
+    /**
+     * Commits a developer message to the history, notifying the system via BusService without triggering execution.
+     * Useful for logging developer notes or debugging information, coordinated with SessionConnectionService.
+     * @param {string} message - The developer message to commit, trimmed before storage.
+     * @returns {Promise<void>} Resolves when the message is committed and the event is emitted.
+     */
     async commitDeveloperMessage(message) {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientAgent agentName=${this.params.agentName} clientId=${this.params.clientId} commitDeveloperMessage`, { message });
@@ -6356,7 +6362,6 @@ class ToolSchemaService {
 
 const AGENT_NEED_FETCH = Symbol("agent-need-fetch");
 const STACK_NEED_FETCH = Symbol("stack-need-fetch");
-const SET_BUSY_FN = Symbol("set-busy-fn");
 /**
  * A no-operation (noop) agent that serves as a fallback when an agent is not found in the swarm.
  * Implements the {@link IAgent} interface and logs calls to its methods, indicating that the requested agent is unavailable,
@@ -6557,7 +6562,6 @@ class NoopAgent {
 const WAIT_FOR_OUTPUT_FN = async (self) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
         self.params.logger.debug(`ClientSwarm swarmName=${self.params.swarmName} clientId=${self.params.clientId} waitForOutput`);
-    self[SET_BUSY_FN](true);
     const [awaiter, { resolve }] = functoolsKit.createAwaiter();
     const getOutput = functoolsKit.cancelable(async () => await Promise.race(self._agentList
         .map(async ([agentName, agent]) => ({
@@ -6595,7 +6599,6 @@ const WAIT_FOR_OUTPUT_FN = async (self) => {
         },
         clientId: self.params.clientId,
     });
-    self[SET_BUSY_FN](false);
     return output;
 };
 /**
@@ -6616,7 +6619,7 @@ class ClientSwarm {
     getCheckBusy() {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} getCheckBusy`);
-        return Promise.resolve(this._isBusy);
+        return Promise.resolve(!!this._isBusy);
     }
     /**
      * Sets the busy state of the swarm.
@@ -6624,10 +6627,10 @@ class ClientSwarm {
      * Enables coordinated state management and debugging.
      * @param {boolean} isBusy - True to mark the swarm as busy, false to mark it as idle.
      */
-    [SET_BUSY_FN](isBusy) {
+    setBusy(isBusy) {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
-            this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} setCheckBusy`, { isBusy });
-        this._isBusy = isBusy;
+            this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} setBusy`, { isBusy });
+        this._isBusy += isBusy ? 1 : -1;
     }
     /**
      * Getter for the list of agent name-agent pairs from the agent map (params.agentMap).
@@ -6644,7 +6647,7 @@ class ClientSwarm {
      */
     constructor(params) {
         this.params = params;
-        this._isBusy = false;
+        this._isBusy = 0;
         /**
          * Subject that emits when an agent reference changes, providing the agent name and instance.
          * Used by setAgentRef to notify subscribers (e.g., waitForOutput) of updates to agent instances.
@@ -7005,6 +7008,19 @@ class SwarmConnectionService {
                 this.loggerService.info(`swarmConnectionService getCheckBusy`);
             return await this.getSwarm(this.methodContextService.context.clientId, this.methodContextService.context.swarmName).getCheckBusy();
         };
+        /**
+         * Sets the busy state of the swarm.
+         * Used to indicate whether the swarm is currently processing an operation, helping manage flow control and debugging.
+         * Delegates to ClientSwarm.setBusy, using context from MethodContextService, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
+         * Mirrors SwarmPublicService’s setBusy, supporting ClientAgent’s busy state management.
+         * @param {boolean} isBusy - True to mark the swarm as busy, false to mark it as idle.
+         * @returns {Promise<void>} A promise resolving when the busy state is set.
+         */
+        this.setBusy = async (isBusy) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info(`swarmConnectionService setBusy`, { isBusy });
+            return await this.getSwarm(this.methodContextService.context.clientId, this.methodContextService.context.swarmName).setBusy(isBusy);
+        };
         /**
          * Cancels the pending output by emitting an empty string, interrupting waitForOutput.
          * Delegates to ClientSwarm.cancelOutput, using context from MethodContextService, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
@@ -7471,9 +7487,11 @@ class ClientSession {
         this.params.onExecute &&
             this.params.onExecute(this.params.clientId, this.params.swarmName, message, mode);
         const agent = await this.params.swarm.getAgent();
+        this.params.swarm.setBusy(true);
         const outputAwaiter = this.params.swarm.waitForOutput();
         agent.execute(message, mode);
         const output = await outputAwaiter;
+        this.params.swarm.setBusy(false);
         await swarm$1.executionValidationService.flushCount(this.params.clientId, this.params.swarmName);
         if (await functoolsKit.not(this.params.policy.validateOutput(output, this.params.clientId, this.params.swarmName))) {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
@@ -9687,6 +9705,37 @@ class SwarmPublicService {
                 computeName: "",
             });
         };
+        /**
+         * Sets the busy state of the swarm, indicating whether it is currently processing an operation.
+         * Wraps SwarmConnectionService.setBusy with MethodContextService, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
+         * Used in ClientAgent (e.g., marking swarm busy during EXECUTE_FN) and SessionPublicService (e.g., managing swarm state in connect).
+         * @param {boolean} isBusy - True to mark the swarm as busy, false to mark it as idle.
+         * @param {string} methodName - The method name for context and logging.
+         * @param {string} clientId - The client ID, scoping the operation to a specific client.
+         * @param {SwarmName} swarmName - The name of the swarm, used in SwarmMetaService context.
+         * @returns {Promise<void>} A promise resolving when the busy state is set.
+         */
+        this.setBusy = async (isBusy, methodName, clientId, swarmName) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("swarmPublicService setBusy", {
+                    isBusy,
+                    clientId,
+                    swarmName,
+                });
+            return await MethodContextService.runInContext(async () => {
+                return await this.swarmConnectionService.setBusy(isBusy);
+            }, {
+                methodName,
+                clientId,
+                swarmName,
+                policyName: "",
+                agentName: "",
+                storageName: "",
+                stateName: "",
+                mcpName: "",
+                computeName: "",
+            });
+        };
         /**
          * Cancels the await of output in the swarm by emitting an empty string, scoped to a client.
          * Wraps SwarmConnectionService.cancelOutput with MethodContextService, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.

package/build/index.mjs

@@ -4611,6 +4611,12 @@ class ClientAgent {
             clientId: this.params.clientId,
         });
     }
+    /**
+     * Commits a developer message to the history, notifying the system via BusService without triggering execution.
+     * Useful for logging developer notes or debugging information, coordinated with SessionConnectionService.
+     * @param {string} message - The developer message to commit, trimmed before storage.
+     * @returns {Promise<void>} Resolves when the message is committed and the event is emitted.
+     */
     async commitDeveloperMessage(message) {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientAgent agentName=${this.params.agentName} clientId=${this.params.clientId} commitDeveloperMessage`, { message });
@@ -6354,7 +6360,6 @@ class ToolSchemaService {
 
 const AGENT_NEED_FETCH = Symbol("agent-need-fetch");
 const STACK_NEED_FETCH = Symbol("stack-need-fetch");
-const SET_BUSY_FN = Symbol("set-busy-fn");
 /**
  * A no-operation (noop) agent that serves as a fallback when an agent is not found in the swarm.
  * Implements the {@link IAgent} interface and logs calls to its methods, indicating that the requested agent is unavailable,
@@ -6555,7 +6560,6 @@ class NoopAgent {
 const WAIT_FOR_OUTPUT_FN = async (self) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
         self.params.logger.debug(`ClientSwarm swarmName=${self.params.swarmName} clientId=${self.params.clientId} waitForOutput`);
-    self[SET_BUSY_FN](true);
     const [awaiter, { resolve }] = createAwaiter();
     const getOutput = cancelable(async () => await Promise.race(self._agentList
         .map(async ([agentName, agent]) => ({
@@ -6593,7 +6597,6 @@ const WAIT_FOR_OUTPUT_FN = async (self) => {
         },
         clientId: self.params.clientId,
     });
-    self[SET_BUSY_FN](false);
     return output;
 };
 /**
@@ -6614,7 +6617,7 @@ class ClientSwarm {
     getCheckBusy() {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} getCheckBusy`);
-        return Promise.resolve(this._isBusy);
+        return Promise.resolve(!!this._isBusy);
     }
     /**
      * Sets the busy state of the swarm.
@@ -6622,10 +6625,10 @@ class ClientSwarm {
      * Enables coordinated state management and debugging.
      * @param {boolean} isBusy - True to mark the swarm as busy, false to mark it as idle.
      */
-    [SET_BUSY_FN](isBusy) {
+    setBusy(isBusy) {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
-            this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} setCheckBusy`, { isBusy });
-        this._isBusy = isBusy;
+            this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} setBusy`, { isBusy });
+        this._isBusy += isBusy ? 1 : -1;
     }
     /**
      * Getter for the list of agent name-agent pairs from the agent map (params.agentMap).
@@ -6642,7 +6645,7 @@ class ClientSwarm {
      */
     constructor(params) {
         this.params = params;
-        this._isBusy = false;
+        this._isBusy = 0;
         /**
          * Subject that emits when an agent reference changes, providing the agent name and instance.
          * Used by setAgentRef to notify subscribers (e.g., waitForOutput) of updates to agent instances.
@@ -7003,6 +7006,19 @@ class SwarmConnectionService {
                 this.loggerService.info(`swarmConnectionService getCheckBusy`);
             return await this.getSwarm(this.methodContextService.context.clientId, this.methodContextService.context.swarmName).getCheckBusy();
         };
+        /**
+         * Sets the busy state of the swarm.
+         * Used to indicate whether the swarm is currently processing an operation, helping manage flow control and debugging.
+         * Delegates to ClientSwarm.setBusy, using context from MethodContextService, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
+         * Mirrors SwarmPublicService’s setBusy, supporting ClientAgent’s busy state management.
+         * @param {boolean} isBusy - True to mark the swarm as busy, false to mark it as idle.
+         * @returns {Promise<void>} A promise resolving when the busy state is set.
+         */
+        this.setBusy = async (isBusy) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info(`swarmConnectionService setBusy`, { isBusy });
+            return await this.getSwarm(this.methodContextService.context.clientId, this.methodContextService.context.swarmName).setBusy(isBusy);
+        };
         /**
          * Cancels the pending output by emitting an empty string, interrupting waitForOutput.
          * Delegates to ClientSwarm.cancelOutput, using context from MethodContextService, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
@@ -7469,9 +7485,11 @@ class ClientSession {
         this.params.onExecute &&
             this.params.onExecute(this.params.clientId, this.params.swarmName, message, mode);
         const agent = await this.params.swarm.getAgent();
+        this.params.swarm.setBusy(true);
         const outputAwaiter = this.params.swarm.waitForOutput();
         agent.execute(message, mode);
         const output = await outputAwaiter;
+        this.params.swarm.setBusy(false);
         await swarm$1.executionValidationService.flushCount(this.params.clientId, this.params.swarmName);
         if (await not(this.params.policy.validateOutput(output, this.params.clientId, this.params.swarmName))) {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
@@ -9685,6 +9703,37 @@ class SwarmPublicService {
                 computeName: "",
             });
         };
+        /**
+         * Sets the busy state of the swarm, indicating whether it is currently processing an operation.
+         * Wraps SwarmConnectionService.setBusy with MethodContextService, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
+         * Used in ClientAgent (e.g., marking swarm busy during EXECUTE_FN) and SessionPublicService (e.g., managing swarm state in connect).
+         * @param {boolean} isBusy - True to mark the swarm as busy, false to mark it as idle.
+         * @param {string} methodName - The method name for context and logging.
+         * @param {string} clientId - The client ID, scoping the operation to a specific client.
+         * @param {SwarmName} swarmName - The name of the swarm, used in SwarmMetaService context.
+         * @returns {Promise<void>} A promise resolving when the busy state is set.
+         */
+        this.setBusy = async (isBusy, methodName, clientId, swarmName) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("swarmPublicService setBusy", {
+                    isBusy,
+                    clientId,
+                    swarmName,
+                });
+            return await MethodContextService.runInContext(async () => {
+                return await this.swarmConnectionService.setBusy(isBusy);
+            }, {
+                methodName,
+                clientId,
+                swarmName,
+                policyName: "",
+                agentName: "",
+                storageName: "",
+                stateName: "",
+                mcpName: "",
+                computeName: "",
+            });
+        };
         /**
          * Cancels the await of output in the swarm by emitting an empty string, scoped to a client.
          * Wraps SwarmConnectionService.cancelOutput with MethodContextService, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.

package/package.json

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

package/types.d.ts

@@ -1330,6 +1330,14 @@ interface ISwarm {
      * @returns {Promise<boolean>} True if the swarm is busy, false otherwise.
      */
     getCheckBusy(): Promise<boolean>;
+    /**
+     * Sets the busy state of the swarm.
+     * This method is used to indicate whether the swarm is currently processing an operation.
+     * It helps manage flow control and debugging by signaling when the swarm is occupied.
+     * @param {boolean} isBusy - True to mark the swarm as busy, false to mark it as idle.
+     * @throws {Error} If setting the busy state fails (e.g., due to internal errors).
+     */
+    setBusy(isBusy: boolean): void;
 }
 /**
  * Type representing the unique name of a swarm within the system.
@@ -4576,6 +4584,12 @@ declare class ClientAgent implements IAgent {
      * @returns {Promise<void>} Resolves when the message is committed and the event is emitted.
      */
     commitSystemMessage(message: string): Promise<void>;
+    /**
+     * Commits a developer message to the history, notifying the system via BusService without triggering execution.
+     * Useful for logging developer notes or debugging information, coordinated with SessionConnectionService.
+     * @param {string} message - The developer message to commit, trimmed before storage.
+     * @returns {Promise<void>} Resolves when the message is committed and the event is emitted.
+     */
     commitDeveloperMessage(message: string): Promise<void>;
     /**
      * Commits a tool request to the agent's history and emits an event via BusService.
@@ -5428,7 +5442,6 @@ declare class ToolSchemaService {
 
 declare const AGENT_NEED_FETCH: unique symbol;
 declare const STACK_NEED_FETCH: unique symbol;
-declare const SET_BUSY_FN: unique symbol;
 /**
  * Manages a collection of agents within a swarm in the swarm system, implementing the ISwarm interface.
  * Handles agent switching, output waiting, and navigation stack management, with queued operations and event-driven updates via BusService.
@@ -5453,7 +5466,7 @@ declare class ClientSwarm implements ISwarm {
      * Enables coordinated state management and debugging.
      * @param {boolean} isBusy - True to mark the swarm as busy, false to mark it as idle.
      */
-    [SET_BUSY_FN](isBusy: boolean): void;
+    setBusy(isBusy: boolean): void;
     /**
      * Subject that emits when an agent reference changes, providing the agent name and instance.
      * Used by setAgentRef to notify subscribers (e.g., waitForOutput) of updates to agent instances.
@@ -5643,6 +5656,15 @@ declare class SwarmConnectionService implements ISwarm {
      * @returns {Promise<boolean>} True if the swarm is busy, false otherwise.
      */
     getCheckBusy: () => Promise<boolean>;
+    /**
+     * Sets the busy state of the swarm.
+     * Used to indicate whether the swarm is currently processing an operation, helping manage flow control and debugging.
+     * Delegates to ClientSwarm.setBusy, using context from MethodContextService, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
+     * Mirrors SwarmPublicService’s setBusy, supporting ClientAgent’s busy state management.
+     * @param {boolean} isBusy - True to mark the swarm as busy, false to mark it as idle.
+     * @returns {Promise<void>} A promise resolving when the busy state is set.
+     */
+    setBusy: (isBusy: boolean) => Promise<void>;
     /**
      * Cancels the pending output by emitting an empty string, interrupting waitForOutput.
      * Delegates to ClientSwarm.cancelOutput, using context from MethodContextService, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
@@ -6777,6 +6799,17 @@ declare class SwarmPublicService implements TSwarmConnectionService {
      * @returns {Promise<boolean>} True if the swarm is busy, false otherwise.
      */
     getCheckBusy: (methodName: string, clientId: string, swarmName: SwarmName) => Promise<boolean>;
+    /**
+     * Sets the busy state of the swarm, indicating whether it is currently processing an operation.
+     * Wraps SwarmConnectionService.setBusy with MethodContextService, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
+     * Used in ClientAgent (e.g., marking swarm busy during EXECUTE_FN) and SessionPublicService (e.g., managing swarm state in connect).
+     * @param {boolean} isBusy - True to mark the swarm as busy, false to mark it as idle.
+     * @param {string} methodName - The method name for context and logging.
+     * @param {string} clientId - The client ID, scoping the operation to a specific client.
+     * @param {SwarmName} swarmName - The name of the swarm, used in SwarmMetaService context.
+     * @returns {Promise<void>} A promise resolving when the busy state is set.
+     */
+    setBusy: (isBusy: boolean, methodName: string, clientId: string, swarmName: SwarmName) => Promise<void>;
     /**
      * Cancels the await of output in the swarm by emitting an empty string, scoped to a client.
      * Wraps SwarmConnectionService.cancelOutput with MethodContextService, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.