agent-swarm-kit 1.0.240 → 1.0.242

package/build/index.cjs

@@ -3572,7 +3572,7 @@ const RUN_FN = async (incoming, self) => {
         self.params.logger.debug(`ClientAgent agentName=${self.params.agentName} clientId=${self.params.clientId} run begin`, { incoming });
     self.params.onRun &&
         self.params.onRun(self.params.clientId, self.params.agentName, incoming);
-    const messages = await self.params.history.toArrayForAgent(self.params.prompt, await self._resolveSystemPrompt());
+    const messages = await self.params.history.toArrayForAgent(self.params.prompt ?? "", await self._resolveSystemPrompt());
     messages.push({
         agentName: self.params.agentName,
         content: incoming,
@@ -4049,7 +4049,7 @@ class ClientAgent {
     async getCompletion(mode) {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientAgent agentName=${this.params.agentName} clientId=${this.params.clientId} getCompletion`);
-        const messages = await this.params.history.toArrayForAgent(this.params.prompt, await this._resolveSystemPrompt());
+        const messages = await this.params.history.toArrayForAgent(this.params.prompt ?? "", await this._resolveSystemPrompt());
         const args = {
             clientId: this.params.clientId,
             agentName: this.params.agentName,
@@ -4093,7 +4093,7 @@ class ClientAgent {
                 agentName: this.params.agentName,
                 content: GLOBAL_CONFIG.CC_TOOL_CALL_EXCEPTION_RECOMPLETE_PROMPT,
             });
-            const messages = await this.params.history.toArrayForAgent(this.params.prompt, await this._resolveSystemPrompt());
+            const messages = await this.params.history.toArrayForAgent(this.params.prompt ?? "", await this._resolveSystemPrompt());
             const args = {
                 clientId: this.params.clientId,
                 agentName: this.params.agentName,
@@ -4990,7 +4990,7 @@ class ClientHistory {
         });
         const promptMessages = [];
         {
-            promptMessages.push({
+            prompt && promptMessages.push({
                 agentName: this.params.agentName,
                 mode: "tool",
                 content: prompt,
@@ -5467,6 +5467,9 @@ class ClientSwarm {
             this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} getAgent`);
         const agentName = await this.getAgentName();
         const result = this.params.agentMap[agentName];
+        if (!result) {
+            throw new Error(`agent-swarm ClientSwarm getAgent current agent is not in the swarm agentName=${agentName} clientId=${this.params.clientId} swarmName=${this.params.swarmName}`);
+        }
         await this.params.bus.emit(this.params.clientId, {
             type: "get-agent",
             source: "swarm-bus",
@@ -8919,6 +8922,24 @@ class SwarmValidationService {
             }
             return swarm.agentList;
         };
+        /**
+         * Retrieves the set of agent names associated with a given swarm.
+         * Logs the operation and validates swarm existence, supporting ClientSwarm’s agent management.
+         * @param {SwarmName} swarmName - The name of the swarm to query, sourced from Swarm.interface.
+         * @returns {string[]} An array of agent names from the swarm’s schema.
+         * @throws {Error} If the swarm is not found in _swarmMap.
+         */
+        this.getAgentSet = functoolsKit.memoize(([swarmName]) => `${swarmName}`, (swarmName) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("swarmValidationService getAgentSet", {
+                    swarmName,
+                });
+            const swarm = this._swarmMap.get(swarmName);
+            if (!swarm) {
+                throw new Error(`agent-swarm swarm ${swarmName} not found`);
+            }
+            return new Set(swarm.agentList);
+        });
         /**
          * Retrieves the list of policy names associated with a given swarm.
          * Logs the operation and validates swarm existence, supporting ClientSwarm’s policy enforcement.
@@ -11500,10 +11521,14 @@ class DocService {
                 }
                 result.push("");
             }
-            {
+            if (agentSchema.completion) {
                 result.push(`**Completion:** \`${agentSchema.completion}\``);
                 result.push("");
             }
+            {
+                result.push(`*Operator:* [${agentSchema.operator ? "x" : " "}]`);
+                result.push("");
+            }
             {
                 const umlSchema = this.agentMetaService.toUML(agentSchema.agentName, true);
                 const umlName = `agent_schema_${agentSchema.agentName}.svg`;
@@ -17112,6 +17137,14 @@ const changeToAgent = beginContext(async (agentName, clientId) => {
             console.error(`agent-swarm missing dependency detected for activeAgent=${activeAgent} dependencyAgent=${agentName}`);
         }
     }
+    if (!swarm$1.swarmValidationService.getAgentSet(swarmName).has(agentName)) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
+            swarm$1.loggerService.log('function "changeToAgent" skipped due to the agent is not in the swarm', {
+                agentName,
+                clientId,
+            });
+        return false;
+    }
     // Execute the agent change with TTL and queuing
     const run = await createChangeToAgent(clientId);
     createGc$2();

package/build/index.mjs

@@ -3570,7 +3570,7 @@ const RUN_FN = async (incoming, self) => {
         self.params.logger.debug(`ClientAgent agentName=${self.params.agentName} clientId=${self.params.clientId} run begin`, { incoming });
     self.params.onRun &&
         self.params.onRun(self.params.clientId, self.params.agentName, incoming);
-    const messages = await self.params.history.toArrayForAgent(self.params.prompt, await self._resolveSystemPrompt());
+    const messages = await self.params.history.toArrayForAgent(self.params.prompt ?? "", await self._resolveSystemPrompt());
     messages.push({
         agentName: self.params.agentName,
         content: incoming,
@@ -4047,7 +4047,7 @@ class ClientAgent {
     async getCompletion(mode) {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientAgent agentName=${this.params.agentName} clientId=${this.params.clientId} getCompletion`);
-        const messages = await this.params.history.toArrayForAgent(this.params.prompt, await this._resolveSystemPrompt());
+        const messages = await this.params.history.toArrayForAgent(this.params.prompt ?? "", await this._resolveSystemPrompt());
         const args = {
             clientId: this.params.clientId,
             agentName: this.params.agentName,
@@ -4091,7 +4091,7 @@ class ClientAgent {
                 agentName: this.params.agentName,
                 content: GLOBAL_CONFIG.CC_TOOL_CALL_EXCEPTION_RECOMPLETE_PROMPT,
             });
-            const messages = await this.params.history.toArrayForAgent(this.params.prompt, await this._resolveSystemPrompt());
+            const messages = await this.params.history.toArrayForAgent(this.params.prompt ?? "", await this._resolveSystemPrompt());
             const args = {
                 clientId: this.params.clientId,
                 agentName: this.params.agentName,
@@ -4988,7 +4988,7 @@ class ClientHistory {
         });
         const promptMessages = [];
         {
-            promptMessages.push({
+            prompt && promptMessages.push({
                 agentName: this.params.agentName,
                 mode: "tool",
                 content: prompt,
@@ -5465,6 +5465,9 @@ class ClientSwarm {
             this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} getAgent`);
         const agentName = await this.getAgentName();
         const result = this.params.agentMap[agentName];
+        if (!result) {
+            throw new Error(`agent-swarm ClientSwarm getAgent current agent is not in the swarm agentName=${agentName} clientId=${this.params.clientId} swarmName=${this.params.swarmName}`);
+        }
         await this.params.bus.emit(this.params.clientId, {
             type: "get-agent",
             source: "swarm-bus",
@@ -8917,6 +8920,24 @@ class SwarmValidationService {
             }
             return swarm.agentList;
         };
+        /**
+         * Retrieves the set of agent names associated with a given swarm.
+         * Logs the operation and validates swarm existence, supporting ClientSwarm’s agent management.
+         * @param {SwarmName} swarmName - The name of the swarm to query, sourced from Swarm.interface.
+         * @returns {string[]} An array of agent names from the swarm’s schema.
+         * @throws {Error} If the swarm is not found in _swarmMap.
+         */
+        this.getAgentSet = memoize(([swarmName]) => `${swarmName}`, (swarmName) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("swarmValidationService getAgentSet", {
+                    swarmName,
+                });
+            const swarm = this._swarmMap.get(swarmName);
+            if (!swarm) {
+                throw new Error(`agent-swarm swarm ${swarmName} not found`);
+            }
+            return new Set(swarm.agentList);
+        });
         /**
          * Retrieves the list of policy names associated with a given swarm.
          * Logs the operation and validates swarm existence, supporting ClientSwarm’s policy enforcement.
@@ -11498,10 +11519,14 @@ class DocService {
                 }
                 result.push("");
             }
-            {
+            if (agentSchema.completion) {
                 result.push(`**Completion:** \`${agentSchema.completion}\``);
                 result.push("");
             }
+            {
+                result.push(`*Operator:* [${agentSchema.operator ? "x" : " "}]`);
+                result.push("");
+            }
             {
                 const umlSchema = this.agentMetaService.toUML(agentSchema.agentName, true);
                 const umlName = `agent_schema_${agentSchema.agentName}.svg`;
@@ -17110,6 +17135,14 @@ const changeToAgent = beginContext(async (agentName, clientId) => {
             console.error(`agent-swarm missing dependency detected for activeAgent=${activeAgent} dependencyAgent=${agentName}`);
         }
     }
+    if (!swarm$1.swarmValidationService.getAgentSet(swarmName).has(agentName)) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
+            swarm$1.loggerService.log('function "changeToAgent" skipped due to the agent is not in the swarm', {
+                agentName,
+                clientId,
+            });
+        return false;
+    }
     // Execute the agent change with TTL and queuing
     const run = await createChangeToAgent(clientId);
     createGc$2();

package/package.json

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

package/types.d.ts

@@ -5887,6 +5887,14 @@ declare class SwarmValidationService {
      * @throws {Error} If the swarm is not found in _swarmMap.
      */
     getAgentList: (swarmName: SwarmName) => string[];
+    /**
+     * Retrieves the set of agent names associated with a given swarm.
+     * Logs the operation and validates swarm existence, supporting ClientSwarm’s agent management.
+     * @param {SwarmName} swarmName - The name of the swarm to query, sourced from Swarm.interface.
+     * @returns {string[]} An array of agent names from the swarm’s schema.
+     * @throws {Error} If the swarm is not found in _swarmMap.
+     */
+    getAgentSet: ((swarmName: SwarmName) => Set<string>) & functools_kit.IClearableMemoize<string> & functools_kit.IControlMemoize<string, Set<string>>;
     /**
      * Retrieves the list of policy names associated with a given swarm.
      * Logs the operation and validates swarm existence, supporting ClientSwarm’s policy enforcement.