agent-swarm-kit 1.1.139 → 1.1.141

package/build/index.cjs

@@ -6632,6 +6632,18 @@ class ClientSwarm {
             this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} setBusy`, { isBusy });
         this._isBusy += isBusy ? 1 : -1;
     }
+    /**
+     * Getter for the busy state of the swarm.
+     * Used internally for optimizing performance and flow control.
+     * Returns true if the swarm is currently busy with an operation, false otherwise.
+     * Supports debugging and flow control in client applications.
+     * @returns {boolean} True if the swarm is busy, false otherwise.
+     */
+    getBusy() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} getBusy`);
+        return !!this._isBusy;
+    }
     /**
      * Getter for the list of agent name-agent pairs from the agent map (params.agentMap).
      * Provides a snapshot of available agents, used internally by waitForOutput to monitor outputs.
@@ -7381,6 +7393,22 @@ class CompletionSchemaService {
     }
 }
 
+const BUSY_DELAY = 100;
+const AQUIRE_LOCK_FN = async (self) => {
+    GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+        self.params.logger.debug(`ClientSession clientId=${self.params.clientId} AQUIRE_LOCK_FN`);
+    const swarm = self.params.swarm;
+    while (swarm.getBusy()) {
+        await functoolsKit.sleep(BUSY_DELAY);
+    }
+    swarm.setBusy(true);
+};
+const RELEASE_LOCK_FN = async (self) => {
+    GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+        self.params.logger.debug(`ClientSession clientId=${self.params.clientId} RELEASE_LOCK_FN`);
+    const swarm = self.params.swarm;
+    swarm.setBusy(false);
+};
 /**
  * Represents a client session in the swarm system, implementing the ISession interface.
  * Manages message execution, emission, and agent interactions for a client within a swarm, with policy enforcement via ClientPolicy
@@ -7398,6 +7426,7 @@ class ClientSession {
     constructor(params) {
         this.params = params;
         this._notifySubject = new functoolsKit.Subject();
+        this.AQUIRE_LOCK = functoolsKit.queued(AQUIRE_LOCK_FN);
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientSession clientId=${this.params.clientId} CTOR`, {
                 params,
@@ -7487,7 +7516,9 @@ 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);
+        if (mode === "user") {
+            await this.AQUIRE_LOCK(this);
+        }
         const outputAwaiter = this.params.swarm.waitForOutput();
         agent.execute(message, mode);
         let output = "";
@@ -7495,7 +7526,9 @@ class ClientSession {
             output = await outputAwaiter;
         }
         finally {
-            this.params.swarm.setBusy(false);
+            if (mode === "user") {
+                await RELEASE_LOCK_FN(this);
+            }
         }
         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))) {

package/build/index.mjs

@@ -6630,6 +6630,18 @@ class ClientSwarm {
             this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} setBusy`, { isBusy });
         this._isBusy += isBusy ? 1 : -1;
     }
+    /**
+     * Getter for the busy state of the swarm.
+     * Used internally for optimizing performance and flow control.
+     * Returns true if the swarm is currently busy with an operation, false otherwise.
+     * Supports debugging and flow control in client applications.
+     * @returns {boolean} True if the swarm is busy, false otherwise.
+     */
+    getBusy() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} getBusy`);
+        return !!this._isBusy;
+    }
     /**
      * Getter for the list of agent name-agent pairs from the agent map (params.agentMap).
      * Provides a snapshot of available agents, used internally by waitForOutput to monitor outputs.
@@ -7379,6 +7391,22 @@ class CompletionSchemaService {
     }
 }
 
+const BUSY_DELAY = 100;
+const AQUIRE_LOCK_FN = async (self) => {
+    GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+        self.params.logger.debug(`ClientSession clientId=${self.params.clientId} AQUIRE_LOCK_FN`);
+    const swarm = self.params.swarm;
+    while (swarm.getBusy()) {
+        await sleep(BUSY_DELAY);
+    }
+    swarm.setBusy(true);
+};
+const RELEASE_LOCK_FN = async (self) => {
+    GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+        self.params.logger.debug(`ClientSession clientId=${self.params.clientId} RELEASE_LOCK_FN`);
+    const swarm = self.params.swarm;
+    swarm.setBusy(false);
+};
 /**
  * Represents a client session in the swarm system, implementing the ISession interface.
  * Manages message execution, emission, and agent interactions for a client within a swarm, with policy enforcement via ClientPolicy
@@ -7396,6 +7424,7 @@ class ClientSession {
     constructor(params) {
         this.params = params;
         this._notifySubject = new Subject();
+        this.AQUIRE_LOCK = queued(AQUIRE_LOCK_FN);
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientSession clientId=${this.params.clientId} CTOR`, {
                 params,
@@ -7485,7 +7514,9 @@ 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);
+        if (mode === "user") {
+            await this.AQUIRE_LOCK(this);
+        }
         const outputAwaiter = this.params.swarm.waitForOutput();
         agent.execute(message, mode);
         let output = "";
@@ -7493,7 +7524,9 @@ class ClientSession {
             output = await outputAwaiter;
         }
         finally {
-            this.params.swarm.setBusy(false);
+            if (mode === "user") {
+                await RELEASE_LOCK_FN(this);
+            }
         }
         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))) {

package/package.json

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

package/types.d.ts

@@ -5467,6 +5467,14 @@ declare class ClientSwarm implements ISwarm {
      * @param {boolean} isBusy - True to mark the swarm as busy, false to mark it as idle.
      */
     setBusy(isBusy: boolean): void;
+    /**
+     * Getter for the busy state of the swarm.
+     * Used internally for optimizing performance and flow control.
+     * Returns true if the swarm is currently busy with an operation, false otherwise.
+     * Supports debugging and flow control in client applications.
+     * @returns {boolean} True if the swarm is busy, false otherwise.
+     */
+    getBusy(): boolean;
     /**
      * 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.
@@ -5900,6 +5908,7 @@ declare class CompletionSchemaService {
 declare class ClientSession implements ISession {
     readonly params: ISessionParams;
     private _notifySubject;
+    private AQUIRE_LOCK;
     /**
      * Constructs a new ClientSession instance with the provided parameters.
      * Invokes the onInit callback if defined and logs construction if debugging is enabled.