agent-swarm-kit 1.0.105 → 1.0.106

package/build/index.cjs

@@ -343,7 +343,7 @@ var _a$1;
 var HISTORY_INSTANCE_WAIT_FOR_INIT = Symbol("wait-for-init");
 var INSTANCE_METHOD_NAME_WAIT_FOR_INIT = "HistoryInstance.waitForInit";
 var INSTANCE_METHOD_NAME_CTOR = "HistoryInstance.CTOR";
-var INSTANCE_METHOD_NAME_ITERATE_CONDITION = "HistoryInstance.iterate condition";
+var INSTANCE_METHOD_NAME_ITERATE_CONDITION = "HistoryInstance.iterate_condition";
 var INSTANCE_METHOD_NAME_ITERATE = "HistoryInstance.iterate";
 var INSTANCE_METHOD_NAME_PUSH = "HistoryInstance.push";
 var INSTANCE_METHOD_NAME_DISPOSE = "HistoryInstance.dispose";
@@ -1395,14 +1395,18 @@ var CC_EMPTY_OUTPUT_PLACEHOLDERS = [
     "I didn’t hear you properly. Can you say that again?",
     "Could you please repeat that? I didn’t catch it.",
 ];
-var CC_SWARM_AGENT_CHANGED = function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
-    return [2 /*return*/, Promise.resolve()];
-}); }); };
+var CC_SWARM_AGENT_CHANGED = function () { return Promise.resolve(); };
 var CC_SWARM_DEFAULT_AGENT = function (_a, _b, defaultAgent_1) { return __awaiter(void 0, [_a, _b, defaultAgent_1], void 0, function (_c, _d, defaultAgent) {
     return __generator(this, function (_e) {
         return [2 /*return*/, defaultAgent];
     });
 }); };
+var CC_SWARM_STACK_CHANGED = function () { return Promise.resolve(); };
+var CC_SWARM_DEFAULT_STACK = function () { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        return [2 /*return*/, []];
+    });
+}); };
 var CC_AGENT_DEFAULT_VALIDATION = validateDefault;
 var CC_AGENT_DISALLOWED_TAGS = ["tool_call", "toolcall", "tool"];
 var CC_AGENT_DISALLOWED_SYMBOLS = ["{", "}"];
@@ -1440,6 +1444,8 @@ var GLOBAL_CONFIG = {
     CC_GET_CLIENT_LOGGER_ADAPTER: CC_GET_CLIENT_LOGGER_ADAPTER,
     CC_SWARM_AGENT_CHANGED: CC_SWARM_AGENT_CHANGED,
     CC_SWARM_DEFAULT_AGENT: CC_SWARM_DEFAULT_AGENT,
+    CC_SWARM_DEFAULT_STACK: CC_SWARM_DEFAULT_STACK,
+    CC_SWARM_STACK_CHANGED: CC_SWARM_STACK_CHANGED,
     CC_AGENT_DEFAULT_VALIDATION: CC_AGENT_DEFAULT_VALIDATION,
     CC_AGENT_HISTORY_FILTER: CC_AGENT_HISTORY_FILTER,
     CC_AGENT_OUTPUT_TRANSFORM: CC_AGENT_OUTPUT_TRANSFORM,
@@ -2833,6 +2839,7 @@ var ToolSchemaService = /** @class */ (function () {
 }());
 
 var AGENT_NEED_FETCH = Symbol("agent-need-fetch");
+var STACK_NEED_FETCH = Symbol("stack-need-fetch");
 /**
  * ClientSwarm class implements the ISwarm interface and manages agents within a swarm.
  */
@@ -2846,7 +2853,34 @@ var ClientSwarm = /** @class */ (function () {
         this.params = params;
         this._agentChangedSubject = new functoolsKit.Subject();
         this._activeAgent = AGENT_NEED_FETCH;
+        this._navigationStack = STACK_NEED_FETCH;
         this._cancelOutputSubject = new functoolsKit.Subject();
+        /**
+         * Pop the navigation stack or return default agent
+         * @returns {Promise<string>} - The pending agent for navigation
+         */
+        this.navigationPop = function () { return __awaiter(_this, void 0, void 0, function () {
+            var _a, prevAgent;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+                            this.params.logger.debug("ClientSwarm swarmName=".concat(this.params.swarmName, " clientId=").concat(this.params.clientId, " navigationPop"));
+                        if (!(this._navigationStack === STACK_NEED_FETCH)) return [3 /*break*/, 2];
+                        _a = this;
+                        return [4 /*yield*/, this.params.getNavigationStack(this.params.clientId, this.params.swarmName)];
+                    case 1:
+                        _a._navigationStack = _b.sent();
+                        _b.label = 2;
+                    case 2:
+                        prevAgent = this._navigationStack.pop();
+                        return [4 /*yield*/, this.params.setNavigationStack(this.params.clientId, this._navigationStack, this.params.swarmName)];
+                    case 3:
+                        _b.sent();
+                        return [2 /*return*/, prevAgent ? prevAgent : this.params.defaultAgent];
+                }
+            });
+        }); };
         /**
          * Cancel the await of output by emit of empty string
          * @returns {Promise<string>} - The output from the active agent.
@@ -3072,18 +3106,30 @@ var ClientSwarm = /** @class */ (function () {
          */
         this.setAgentName = function (agentName) { return __awaiter(_this, void 0, void 0, function () {
             var _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            var _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
                     case 0:
                         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
                             this.params.logger.debug("ClientSwarm swarmName=".concat(this.params.swarmName, " clientId=").concat(this.params.clientId, " setAgentName agentName=").concat(agentName));
                         this._activeAgent = agentName;
                         return [4 /*yield*/, this.params.setActiveAgent(this.params.clientId, agentName, this.params.swarmName)];
                     case 1:
-                        _b.sent();
-                        if ((_a = this.params.callbacks) === null || _a === void 0 ? void 0 : _a.onAgentChanged) {
+                        _c.sent();
+                        if ((_b = this.params.callbacks) === null || _b === void 0 ? void 0 : _b.onAgentChanged) {
                             this.params.callbacks.onAgentChanged(this.params.clientId, agentName, this.params.swarmName);
                         }
+                        if (!(this._navigationStack === STACK_NEED_FETCH)) return [3 /*break*/, 3];
+                        _a = this;
+                        return [4 /*yield*/, this.params.getNavigationStack(this.params.clientId, this.params.swarmName)];
+                    case 2:
+                        _a._navigationStack = _c.sent();
+                        _c.label = 3;
+                    case 3:
+                        this._navigationStack.push(agentName);
+                        return [4 /*yield*/, this.params.setNavigationStack(this.params.clientId, this._navigationStack, this.params.swarmName)];
+                    case 4:
+                        _c.sent();
                         return [4 /*yield*/, this.params.bus.emit(this.params.clientId, {
                                 type: "set-agent-name",
                                 source: "swarm-bus",
@@ -3096,8 +3142,8 @@ var ClientSwarm = /** @class */ (function () {
                                 },
                                 clientId: this.params.clientId,
                             })];
-                    case 2:
-                        _b.sent();
+                    case 5:
+                        _c.sent();
                         return [2 /*return*/];
                 }
             });
@@ -3140,7 +3186,7 @@ var SwarmConnectionService = /** @class */ (function () {
             return "".concat(clientId, "-").concat(swarmName);
         }, function (clientId, swarmName) {
             var e_1, _a;
-            var _b = _this.swarmSchemaService.get(swarmName), agentList = _b.agentList, defaultAgent = _b.defaultAgent, callbacks = _b.callbacks, _c = _b.getActiveAgent, getActiveAgent = _c === void 0 ? GLOBAL_CONFIG.CC_SWARM_DEFAULT_AGENT : _c, _d = _b.setActiveAgent, setActiveAgent = _d === void 0 ? GLOBAL_CONFIG.CC_SWARM_AGENT_CHANGED : _d;
+            var _b = _this.swarmSchemaService.get(swarmName), agentList = _b.agentList, defaultAgent = _b.defaultAgent, callbacks = _b.callbacks, _c = _b.getActiveAgent, getActiveAgent = _c === void 0 ? GLOBAL_CONFIG.CC_SWARM_DEFAULT_AGENT : _c, _d = _b.setActiveAgent, setActiveAgent = _d === void 0 ? GLOBAL_CONFIG.CC_SWARM_AGENT_CHANGED : _d, _e = _b.getNavigationStack, getNavigationStack = _e === void 0 ? GLOBAL_CONFIG.CC_SWARM_DEFAULT_STACK : _e, _f = _b.setNavigationStack, setNavigationStack = _f === void 0 ? GLOBAL_CONFIG.CC_SWARM_STACK_CHANGED : _f;
             var agentMap = {};
             try {
                 for (var agentList_1 = __values(agentList), agentList_1_1 = agentList_1.next(); !agentList_1_1.done; agentList_1_1 = agentList_1.next()) {
@@ -3164,9 +3210,26 @@ var SwarmConnectionService = /** @class */ (function () {
                 bus: _this.busService,
                 getActiveAgent: getActiveAgent,
                 setActiveAgent: setActiveAgent,
+                getNavigationStack: getNavigationStack,
+                setNavigationStack: setNavigationStack,
                 callbacks: callbacks,
             });
         });
+        /**
+         * Pop the navigation stack or return default agent
+         * @returns {Promise<string>} - The pending agent for navigation
+         */
+        this.navigationPop = function () { return __awaiter(_this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                            this.loggerService.info("swarmConnectionService navigationPop");
+                        return [4 /*yield*/, this.getSwarm(this.methodContextService.context.clientId, this.methodContextService.context.swarmName).navigationPop()];
+                    case 1: return [2 /*return*/, _a.sent()];
+                }
+            });
+        }); };
         /**
          * Cancel the await of output by emit of empty string
          * @returns {Promise<void>}
@@ -4684,6 +4747,39 @@ var SwarmPublicService = /** @class */ (function () {
         var _this = this;
         this.loggerService = inject(TYPES.loggerService);
         this.swarmConnectionService = inject(TYPES.swarmConnectionService);
+        /**
+         * Pop the navigation stack or return default agent
+         * @returns {Promise<string>} - The pending agent for navigation
+         */
+        this.navigationPop = function (methodName, clientId, swarmName) { return __awaiter(_this, void 0, void 0, function () {
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                            this.loggerService.info("swarmPublicService navigationPop", {
+                                clientId: clientId,
+                                swarmName: swarmName,
+                            });
+                        return [4 /*yield*/, MethodContextService.runInContext(function () { return __awaiter(_this, void 0, void 0, function () {
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0: return [4 /*yield*/, this.swarmConnectionService.navigationPop()];
+                                        case 1: return [2 /*return*/, _a.sent()];
+                                    }
+                                });
+                            }); }, {
+                                methodName: methodName,
+                                clientId: clientId,
+                                swarmName: swarmName,
+                                agentName: "",
+                                storageName: "",
+                                stateName: "",
+                            })];
+                    case 1: return [2 /*return*/, _a.sent()];
+                }
+            });
+        }); };
         /**
          * Cancel the await of output by emit of empty string
          * @param {string} clientId - The client ID.
@@ -7968,7 +8064,7 @@ var swarm = __assign(__assign(__assign(__assign(__assign(__assign(__assign({}, b
 init();
 var swarm$1 = swarm;
 
-var METHOD_NAME$F = "cli.dumpDocs";
+var METHOD_NAME$H = "cli.dumpDocs";
 /**
  * Dumps the documentation for the agents and swarms.
  *
@@ -7979,7 +8075,7 @@ var METHOD_NAME$F = "cli.dumpDocs";
 var dumpDocs = function (dirName, PlantUML) {
     if (dirName === void 0) { dirName = "./docs/chat"; }
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$F, {
+        swarm$1.loggerService.log(METHOD_NAME$H, {
             dirName: dirName,
         });
     if (PlantUML) {
@@ -7990,12 +8086,12 @@ var dumpDocs = function (dirName, PlantUML) {
     swarm$1.agentValidationService
         .getAgentList()
         .forEach(function (agentName) {
-        return swarm$1.agentValidationService.validate(agentName, METHOD_NAME$F);
+        return swarm$1.agentValidationService.validate(agentName, METHOD_NAME$H);
     });
     swarm$1.swarmValidationService
         .getSwarmList()
         .forEach(function (swarmName) {
-        return swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$F);
+        return swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$H);
     });
     swarm$1.agentValidationService.getAgentList().forEach(function (agentName) {
         var dependsOn = swarm$1.agentSchemaService.get(agentName).dependsOn;
@@ -8006,7 +8102,7 @@ var dumpDocs = function (dirName, PlantUML) {
     return swarm$1.docService.dumpDocs(dirName);
 };
 
-var METHOD_NAME$E = "cli.dumpAgent";
+var METHOD_NAME$G = "cli.dumpAgent";
 /**
  * Dumps the agent information into PlantUML format.
  *
@@ -8016,14 +8112,14 @@ var METHOD_NAME$E = "cli.dumpAgent";
 var dumpAgent = function (agentName, _a) {
     var _b = _a === void 0 ? {} : _a, _c = _b.withSubtree, withSubtree = _c === void 0 ? false : _c;
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$E, {
+        swarm$1.loggerService.log(METHOD_NAME$G, {
             agentName: agentName,
         });
-    swarm$1.agentValidationService.validate(agentName, METHOD_NAME$E);
+    swarm$1.agentValidationService.validate(agentName, METHOD_NAME$G);
     return swarm$1.agentMetaService.toUML(agentName, withSubtree);
 };
 
-var METHOD_NAME$D = "cli.dumpSwarm";
+var METHOD_NAME$F = "cli.dumpSwarm";
 /**
  * Dumps the swarm information into PlantUML format.
  *
@@ -8032,14 +8128,14 @@ var METHOD_NAME$D = "cli.dumpSwarm";
  */
 var dumpSwarm = function (swarmName) {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$D, {
+        swarm$1.loggerService.log(METHOD_NAME$F, {
             swarmName: swarmName,
         });
-    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$D);
+    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$F);
     return swarm$1.swarmMetaService.toUML(swarmName);
 };
 
-var METHOD_NAME$C = "function.addAgent";
+var METHOD_NAME$E = "function.addAgent";
 /**
  * Adds a new agent to the agent registry. The swarm takes only those agents which was registered
  *
@@ -8048,7 +8144,7 @@ var METHOD_NAME$C = "function.addAgent";
  */
 var addAgent = function (agentSchema) {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$C, {
+        swarm$1.loggerService.log(METHOD_NAME$E, {
             agentSchema: agentSchema,
         });
     swarm$1.agentValidationService.addAgent(agentSchema.agentName, agentSchema);
@@ -8056,7 +8152,7 @@ var addAgent = function (agentSchema) {
     return agentSchema.agentName;
 };
 
-var METHOD_NAME$B = "function.addCompletion";
+var METHOD_NAME$D = "function.addCompletion";
 /**
  * Adds a completion engine for agents. Agents could use different models and
  * framewords for completion like: mock, gpt4all, ollama, openai
@@ -8066,7 +8162,7 @@ var METHOD_NAME$B = "function.addCompletion";
  */
 var addCompletion = function (completionSchema) {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$B, {
+        swarm$1.loggerService.log(METHOD_NAME$D, {
             completionSchema: completionSchema,
         });
     swarm$1.completionValidationService.addCompletion(completionSchema.completionName);
@@ -8074,7 +8170,7 @@ var addCompletion = function (completionSchema) {
     return completionSchema.completionName;
 };
 
-var METHOD_NAME$A = "function.addSwarm";
+var METHOD_NAME$C = "function.addSwarm";
 /**
  * Adds a new swarm to the system. The swarm is a root for starting client session
  *
@@ -8083,7 +8179,7 @@ var METHOD_NAME$A = "function.addSwarm";
  */
 var addSwarm = function (swarmSchema) {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$A, {
+        swarm$1.loggerService.log(METHOD_NAME$C, {
             swarmSchema: swarmSchema,
         });
     swarm$1.swarmValidationService.addSwarm(swarmSchema.swarmName, swarmSchema);
@@ -8091,7 +8187,7 @@ var addSwarm = function (swarmSchema) {
     return swarmSchema.swarmName;
 };
 
-var METHOD_NAME$z = "function.addTool";
+var METHOD_NAME$B = "function.addTool";
 /**
  * Adds a new tool for agents in a swarm. Tool should be registered in `addAgent`
  * declaration
@@ -8101,7 +8197,7 @@ var METHOD_NAME$z = "function.addTool";
  */
 var addTool = function (toolSchema) {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$z, {
+        swarm$1.loggerService.log(METHOD_NAME$B, {
             toolSchema: toolSchema,
         });
     swarm$1.toolValidationService.addTool(toolSchema.toolName, toolSchema);
@@ -8109,7 +8205,7 @@ var addTool = function (toolSchema) {
     return toolSchema.toolName;
 };
 
-var METHOD_NAME$y = "function.addState";
+var METHOD_NAME$A = "function.addState";
 /**
  * Adds a new state to the state registry. The swarm takes only those states which was registered
  *
@@ -8118,7 +8214,7 @@ var METHOD_NAME$y = "function.addState";
  */
 var addState = function (stateSchema) {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$y, {
+        swarm$1.loggerService.log(METHOD_NAME$A, {
             stateSchema: stateSchema,
         });
     swarm$1.stateSchemaService.register(stateSchema.stateName, stateSchema);
@@ -8130,7 +8226,7 @@ var addState = function (stateSchema) {
     return stateSchema.stateName;
 };
 
-var METHOD_NAME$x = "function.addEmbedding";
+var METHOD_NAME$z = "function.addEmbedding";
 /**
  * Adds a new embedding to the embedding registry. The swarm takes only those embeddings which was registered
  *
@@ -8139,7 +8235,7 @@ var METHOD_NAME$x = "function.addEmbedding";
  */
 var addEmbedding = function (embeddingSchema) {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$x, {
+        swarm$1.loggerService.log(METHOD_NAME$z, {
             embeddingSchema: embeddingSchema,
         });
     swarm$1.embeddingValidationService.addEmbedding(embeddingSchema.embeddingName, embeddingSchema);
@@ -8147,7 +8243,7 @@ var addEmbedding = function (embeddingSchema) {
     return embeddingSchema.embeddingName;
 };
 
-var METHOD_NAME$w = "function.addStorage";
+var METHOD_NAME$y = "function.addStorage";
 /**
  * Adds a new storage to the storage registry. The swarm takes only those storages which was registered
  *
@@ -8156,7 +8252,7 @@ var METHOD_NAME$w = "function.addStorage";
  */
 var addStorage = function (storageSchema) {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$w, {
+        swarm$1.loggerService.log(METHOD_NAME$y, {
             storageSchema: storageSchema,
         });
     swarm$1.storageValidationService.addStorage(storageSchema.storageName, storageSchema);
@@ -8169,7 +8265,7 @@ var addStorage = function (storageSchema) {
     return storageSchema.storageName;
 };
 
-var METHOD_NAME$v = "function.commitSystemMessage";
+var METHOD_NAME$x = "function.commitSystemMessage";
 /**
  * Commits a user message to the active agent history in as swarm without answer.
  *
@@ -8184,16 +8280,16 @@ var commitUserMessage = function (content, clientId, agentName) { return __await
         switch (_a.label) {
             case 0:
                 GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-                    swarm$1.loggerService.log(METHOD_NAME$v, {
+                    swarm$1.loggerService.log(METHOD_NAME$x, {
                         content: content,
                         clientId: clientId,
                         agentName: agentName,
                     });
-                swarm$1.agentValidationService.validate(agentName, METHOD_NAME$v);
-                swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$v);
+                swarm$1.agentValidationService.validate(agentName, METHOD_NAME$x);
+                swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$x);
                 swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
-                swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$v);
-                return [4 /*yield*/, swarm$1.swarmPublicService.getAgentName(METHOD_NAME$v, clientId, swarmName)];
+                swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$x);
+                return [4 /*yield*/, swarm$1.swarmPublicService.getAgentName(METHOD_NAME$x, clientId, swarmName)];
             case 1:
                 currentAgentName = _a.sent();
                 if (currentAgentName !== agentName) {
@@ -8205,7 +8301,7 @@ var commitUserMessage = function (content, clientId, agentName) { return __await
                         });
                     return [2 /*return*/];
                 }
-                return [4 /*yield*/, swarm$1.sessionPublicService.commitUserMessage(content, METHOD_NAME$v, clientId, swarmName)];
+                return [4 /*yield*/, swarm$1.sessionPublicService.commitUserMessage(content, METHOD_NAME$x, clientId, swarmName)];
             case 2:
                 _a.sent();
                 return [2 /*return*/];
@@ -8213,7 +8309,7 @@ var commitUserMessage = function (content, clientId, agentName) { return __await
     });
 }); };
 
-var METHOD_NAME$u = "function.getAgentName";
+var METHOD_NAME$w = "function.getAgentName";
 /**
  * Retrieves the agent name for a given client ID.
  *
@@ -8227,20 +8323,20 @@ var getAgentName = function (clientId) { return __awaiter(void 0, void 0, void 0
         switch (_a.label) {
             case 0:
                 GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-                    swarm$1.loggerService.log(METHOD_NAME$u, {
+                    swarm$1.loggerService.log(METHOD_NAME$w, {
                         clientId: clientId,
                     });
-                swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$u);
+                swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$w);
                 swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
-                swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$u);
-                return [4 /*yield*/, swarm$1.swarmPublicService.getAgentName(METHOD_NAME$u, clientId, swarmName)];
+                swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$w);
+                return [4 /*yield*/, swarm$1.swarmPublicService.getAgentName(METHOD_NAME$w, clientId, swarmName)];
             case 1: return [2 /*return*/, _a.sent()];
         }
     });
 }); };
 
 var SCHEDULED_DELAY$1 = 1000;
-var METHOD_NAME$t = "function.makeConnection";
+var METHOD_NAME$v = "function.makeConnection";
 /**
  * A connection factory for a client to a swarm and returns a function to send messages.
  *
@@ -8251,25 +8347,25 @@ var METHOD_NAME$t = "function.makeConnection";
  */
 var makeConnection = function (connector, clientId, swarmName) {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-        swarm$1.loggerService.log(METHOD_NAME$t, {
+        swarm$1.loggerService.log(METHOD_NAME$v, {
             clientId: clientId,
             swarmName: swarmName,
         });
-    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$t);
+    swarm$1.swarmValidationService.validate(swarmName, METHOD_NAME$v);
     swarm$1.sessionValidationService.addSession(clientId, swarmName, "makeConnection");
-    var send = swarm$1.sessionPublicService.connect(connector, METHOD_NAME$t, clientId, swarmName);
+    var send = swarm$1.sessionPublicService.connect(connector, METHOD_NAME$v, clientId, swarmName);
     return functoolsKit.queued(function (outgoing) { return __awaiter(void 0, void 0, void 0, function () {
         var _a;
         var _b;
         return __generator(this, function (_c) {
             switch (_c.label) {
                 case 0:
-                    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$t);
+                    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$v);
                     _a = send;
                     _b = {
                         data: outgoing
                     };
-                    return [4 /*yield*/, swarm$1.swarmPublicService.getAgentName(METHOD_NAME$t, clientId, swarmName)];
+                    return [4 /*yield*/, swarm$1.swarmPublicService.getAgentName(METHOD_NAME$v, clientId, swarmName)];
                 case 1: return [4 /*yield*/, _a.apply(void 0, [(_b.agentName = _c.sent(),
                             _b.clientId = clientId,
                             _b)])];
@@ -8355,26 +8451,26 @@ makeConnection.scheduled = function (connector, clientId, swarmName, _a) {
     }); };
 };
 
-var METHOD_NAME$s = "function.changeAgent";
+var METHOD_NAME$u = "function.changeToAgent";
 /**
  * Time-to-live for the change agent function in milliseconds.
  * @constant {number}
  */
-var CHANGE_AGENT_TTL = 15 * 60 * 1000;
+var CHANGE_AGENT_TTL$2 = 15 * 60 * 1000;
 /**
  * Garbage collection interval for the change agent function in milliseconds.
  * @constant {number}
  */
-var CHANGE_AGENT_GC = 60 * 1000;
+var CHANGE_AGENT_GC$2 = 60 * 1000;
 /**
  * Creates a change agent function with TTL and queuing.
  * @function
  * @param {string} clientId - The client ID.
- * @returns {TChangeAgentRun} - The change agent function.
+ * @returns {TChangeToAgentRun} - The change agent function.
  */
-var createChangeAgent = functoolsKit.ttl(function (clientId) {
+var createChangeToAgent = functoolsKit.ttl(function (clientId) {
     return functoolsKit.queued(function (methodName, agentName, swarmName) { return __awaiter(void 0, void 0, void 0, function () {
-        var _a, _b, _c;
+        var agentName_1, _a, _b, _c;
         return __generator(this, function (_d) {
             switch (_d.label) {
                 case 0: return [4 /*yield*/, Promise.all(swarm$1.swarmValidationService
@@ -8391,23 +8487,26 @@ var createChangeAgent = functoolsKit.ttl(function (clientId) {
                     }); }))];
                 case 1:
                     _d.sent();
-                    return [4 /*yield*/, swarm$1.agentPublicService.dispose(methodName, clientId, agentName)];
+                    return [4 /*yield*/, swarm$1.swarmPublicService.getAgentName(METHOD_NAME$u, clientId, swarmName)];
                 case 2:
-                    _d.sent();
-                    return [4 /*yield*/, swarm$1.historyPublicService.dispose(methodName, clientId, agentName)];
+                    agentName_1 = _d.sent();
+                    return [4 /*yield*/, swarm$1.agentPublicService.dispose(methodName, clientId, agentName_1)];
                 case 3:
+                    _d.sent();
+                    return [4 /*yield*/, swarm$1.historyPublicService.dispose(methodName, clientId, agentName_1)];
+                case 4:
                     _d.sent();
                     _b = (_a = swarm$1.swarmPublicService).setAgentRef;
                     _c = [methodName,
                         clientId,
                         swarmName,
-                        agentName];
-                    return [4 /*yield*/, swarm$1.agentPublicService.createAgentRef(methodName, clientId, agentName)];
-                case 4: return [4 /*yield*/, _b.apply(_a, _c.concat([_d.sent()]))];
-                case 5:
+                        agentName_1];
+                    return [4 /*yield*/, swarm$1.agentPublicService.createAgentRef(methodName, clientId, agentName_1)];
+                case 5: return [4 /*yield*/, _b.apply(_a, _c.concat([_d.sent()]))];
+                case 6:
                     _d.sent();
                     return [4 /*yield*/, swarm$1.swarmPublicService.setAgentName(agentName, methodName, clientId, swarmName)];
-                case 6:
+                case 7:
                     _d.sent();
                     return [2 /*return*/];
             }
@@ -8418,16 +8517,16 @@ var createChangeAgent = functoolsKit.ttl(function (clientId) {
         var _b = __read(_a, 1), clientId = _b[0];
         return "".concat(clientId);
     },
-    timeout: CHANGE_AGENT_TTL,
+    timeout: CHANGE_AGENT_TTL$2,
 });
 /**
  * Creates a garbage collector for the change agent function.
  * @function
  * @returns {Promise<void>} - A promise that resolves when the garbage collector is created.
  */
-var createGc$1 = functoolsKit.singleshot(function () { return __awaiter(void 0, void 0, void 0, function () {
+var createGc$3 = functoolsKit.singleshot(function () { return __awaiter(void 0, void 0, void 0, function () {
     return __generator(this, function (_a) {
-        setInterval(createChangeAgent.gc, CHANGE_AGENT_GC);
+        setInterval(createChangeToAgent.gc, CHANGE_AGENT_GC$2);
         return [2 /*return*/];
     });
 }); });
@@ -8439,31 +8538,255 @@ var createGc$1 = functoolsKit.singleshot(function () { return __awaiter(void 0,
  * @param {string} clientId - The client ID.
  * @returns {Promise<void>} - A promise that resolves when the agent is changed.
  */
-var changeAgent = function (agentName, clientId) { return __awaiter(void 0, void 0, void 0, function () {
+var changeToAgent = function (agentName, clientId) { return __awaiter(void 0, void 0, void 0, function () {
     var swarmName, activeAgent, run;
     return __generator(this, function (_a) {
         switch (_a.label) {
             case 0:
                 GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
-                    swarm$1.loggerService.log(METHOD_NAME$s, {
+                    swarm$1.loggerService.log(METHOD_NAME$u, {
                         agentName: agentName,
                         clientId: clientId,
                     });
                 swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
-                swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$s);
-                swarm$1.agentValidationService.validate(agentName, METHOD_NAME$s);
-                return [4 /*yield*/, swarm$1.swarmPublicService.getAgentName(METHOD_NAME$s, clientId, swarmName)];
+                swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$u);
+                swarm$1.agentValidationService.validate(agentName, METHOD_NAME$u);
+                return [4 /*yield*/, swarm$1.swarmPublicService.getAgentName(METHOD_NAME$u, clientId, swarmName)];
             case 1:
                 activeAgent = _a.sent();
                 if (!swarm$1.agentValidationService.hasDependency(activeAgent, agentName)) {
                     console.error("agent-swarm missing dependency detected for activeAgent=".concat(activeAgent, " dependencyAgent=").concat(agentName));
                 }
-                return [4 /*yield*/, createChangeAgent(clientId)];
+                return [4 /*yield*/, createChangeToAgent(clientId)];
+            case 2:
+                run = _a.sent();
+                createGc$3();
+                return [4 /*yield*/, run(METHOD_NAME$u, agentName, swarmName)];
+            case 3: return [2 /*return*/, _a.sent()];
+        }
+    });
+}); };
+
+var METHOD_NAME$t = "function.changeToPrevAgent";
+/**
+ * Time-to-live for the change agent function in milliseconds.
+ * @constant {number}
+ */
+var CHANGE_AGENT_TTL$1 = 15 * 60 * 1000;
+/**
+ * Garbage collection interval for the change agent function in milliseconds.
+ * @constant {number}
+ */
+var CHANGE_AGENT_GC$1 = 60 * 1000;
+/**
+ * Creates a change agent function with TTL and queuing.
+ * @function
+ * @param {string} clientId - The client ID.
+ * @returns {TChangeToPrevAgentRun} - The change agent function.
+ */
+var createChangeToPrevAgent = functoolsKit.ttl(function (clientId) {
+    return functoolsKit.queued(function (methodName, agentName, swarmName) { return __awaiter(void 0, void 0, void 0, function () {
+        var agentName_1, _a, _b, _c;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0: return [4 /*yield*/, Promise.all(swarm$1.swarmValidationService
+                        .getAgentList(swarmName)
+                        .map(function (agentName) { return __awaiter(void 0, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0: return [4 /*yield*/, swarm$1.agentPublicService.commitAgentChange(methodName, clientId, agentName)];
+                                case 1:
+                                    _a.sent();
+                                    return [2 /*return*/];
+                            }
+                        });
+                    }); }))];
+                case 1:
+                    _d.sent();
+                    return [4 /*yield*/, swarm$1.swarmPublicService.getAgentName(METHOD_NAME$t, clientId, swarmName)];
+                case 2:
+                    agentName_1 = _d.sent();
+                    return [4 /*yield*/, swarm$1.agentPublicService.dispose(methodName, clientId, agentName_1)];
+                case 3:
+                    _d.sent();
+                    return [4 /*yield*/, swarm$1.historyPublicService.dispose(methodName, clientId, agentName_1)];
+                case 4:
+                    _d.sent();
+                    _b = (_a = swarm$1.swarmPublicService).setAgentRef;
+                    _c = [methodName,
+                        clientId,
+                        swarmName,
+                        agentName_1];
+                    return [4 /*yield*/, swarm$1.agentPublicService.createAgentRef(methodName, clientId, agentName_1)];
+                case 5: return [4 /*yield*/, _b.apply(_a, _c.concat([_d.sent()]))];
+                case 6:
+                    _d.sent();
+                    return [4 /*yield*/, swarm$1.swarmPublicService.setAgentName(agentName, methodName, clientId, swarmName)];
+                case 7:
+                    _d.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+}, {
+    key: function (_a) {
+        var _b = __read(_a, 1), clientId = _b[0];
+        return "".concat(clientId);
+    },
+    timeout: CHANGE_AGENT_TTL$1,
+});
+/**
+ * Creates a garbage collector for the change agent function.
+ * @function
+ * @returns {Promise<void>} - A promise that resolves when the garbage collector is created.
+ */
+var createGc$2 = functoolsKit.singleshot(function () { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        setInterval(createChangeToPrevAgent.gc, CHANGE_AGENT_GC$1);
+        return [2 /*return*/];
+    });
+}); });
+/**
+ * Navigates back to the previous or default agent
+ * @async
+ * @function
+ * @param {string} clientId - The client ID.
+ * @returns {Promise<void>} - A promise that resolves when the agent is changed.
+ */
+var changeToPrevAgent = function (clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName, agentName, run;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
+                    swarm$1.loggerService.log(METHOD_NAME$t, {
+                        clientId: clientId,
+                    });
+                swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
+                return [4 /*yield*/, swarm$1.swarmPublicService.navigationPop(METHOD_NAME$t, clientId, swarmName)];
+            case 1:
+                agentName = _a.sent();
+                {
+                    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$t);
+                    swarm$1.agentValidationService.validate(agentName, METHOD_NAME$t);
+                }
+                return [4 /*yield*/, createChangeToPrevAgent(clientId)];
             case 2:
+                run = _a.sent();
+                createGc$2();
+                return [4 /*yield*/, run(METHOD_NAME$t, agentName, swarmName)];
+            case 3: return [2 /*return*/, _a.sent()];
+        }
+    });
+}); };
+
+var METHOD_NAME$s = "function.changeToDefaultAgent";
+/**
+ * Time-to-live for the change agent function in milliseconds.
+ * @constant {number}
+ */
+var CHANGE_AGENT_TTL = 15 * 60 * 1000;
+/**
+ * Garbage collection interval for the change agent function in milliseconds.
+ * @constant {number}
+ */
+var CHANGE_AGENT_GC = 60 * 1000;
+/**
+ * Creates a change agent function with TTL and queuing.
+ * @function
+ * @param {string} clientId - The client ID.
+ * @returns {TChangeToDefaultAgentRun} - The change agent function.
+ */
+var createChangeToDefaultAgent = functoolsKit.ttl(function (clientId) {
+    return functoolsKit.queued(function (methodName, agentName, swarmName) { return __awaiter(void 0, void 0, void 0, function () {
+        var agentName_1, _a, _b, _c;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0: return [4 /*yield*/, Promise.all(swarm$1.swarmValidationService
+                        .getAgentList(swarmName)
+                        .map(function (agentName) { return __awaiter(void 0, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0: return [4 /*yield*/, swarm$1.agentPublicService.commitAgentChange(methodName, clientId, agentName)];
+                                case 1:
+                                    _a.sent();
+                                    return [2 /*return*/];
+                            }
+                        });
+                    }); }))];
+                case 1:
+                    _d.sent();
+                    return [4 /*yield*/, swarm$1.swarmPublicService.getAgentName(METHOD_NAME$s, clientId, swarmName)];
+                case 2:
+                    agentName_1 = _d.sent();
+                    return [4 /*yield*/, swarm$1.agentPublicService.dispose(methodName, clientId, agentName_1)];
+                case 3:
+                    _d.sent();
+                    return [4 /*yield*/, swarm$1.historyPublicService.dispose(methodName, clientId, agentName_1)];
+                case 4:
+                    _d.sent();
+                    _b = (_a = swarm$1.swarmPublicService).setAgentRef;
+                    _c = [methodName,
+                        clientId,
+                        swarmName,
+                        agentName_1];
+                    return [4 /*yield*/, swarm$1.agentPublicService.createAgentRef(methodName, clientId, agentName_1)];
+                case 5: return [4 /*yield*/, _b.apply(_a, _c.concat([_d.sent()]))];
+                case 6:
+                    _d.sent();
+                    return [4 /*yield*/, swarm$1.swarmPublicService.setAgentName(agentName, methodName, clientId, swarmName)];
+                case 7:
+                    _d.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+}, {
+    key: function (_a) {
+        var _b = __read(_a, 1), clientId = _b[0];
+        return "".concat(clientId);
+    },
+    timeout: CHANGE_AGENT_TTL,
+});
+/**
+ * Creates a garbage collector for the change agent function.
+ * @function
+ * @returns {Promise<void>} - A promise that resolves when the garbage collector is created.
+ */
+var createGc$1 = functoolsKit.singleshot(function () { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        setInterval(createChangeToDefaultAgent.gc, CHANGE_AGENT_GC);
+        return [2 /*return*/];
+    });
+}); });
+/**
+ * Navigates back to the default agent
+ * @async
+ * @function
+ * @param {string} clientId - The client ID.
+ * @returns {Promise<void>} - A promise that resolves when the agent is changed.
+ */
+var changeToDefaultAgent = function (clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName, agentName, run;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
+                    swarm$1.loggerService.log(METHOD_NAME$s, {
+                        clientId: clientId,
+                    });
+                swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
+                agentName = swarm$1.swarmSchemaService.get(swarmName).defaultAgent;
+                {
+                    swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$s);
+                    swarm$1.agentValidationService.validate(agentName, METHOD_NAME$s);
+                }
+                return [4 /*yield*/, createChangeToDefaultAgent(clientId)];
+            case 1:
                 run = _a.sent();
                 createGc$1();
                 return [4 /*yield*/, run(METHOD_NAME$s, agentName, swarmName)];
-            case 3: return [2 /*return*/, _a.sent()];
+            case 2: return [2 /*return*/, _a.sent()];
         }
     });
 }); };
@@ -10316,7 +10639,9 @@ exports.addSwarm = addSwarm;
 exports.addTool = addTool;
 exports.cancelOutput = cancelOutput;
 exports.cancelOutputForce = cancelOutputForce;
-exports.changeAgent = changeAgent;
+exports.changeToAgent = changeToAgent;
+exports.changeToDefaultAgent = changeToDefaultAgent;
+exports.changeToPrevAgent = changeToPrevAgent;
 exports.commitFlush = commitFlush;
 exports.commitFlushForce = commitFlushForce;
 exports.commitSystemMessage = commitSystemMessage;