agent-swarm-kit 1.0.47 → 1.0.48

package/build/index.cjs

@@ -4222,6 +4222,23 @@ var getAgentHistory = function (clientId, agentName) { return __awaiter(void 0,
     });
 }); };
 
+/**
+ * Return the session mode (`"session" | "makeConnection" | "complete"`) for clientId
+ *
+ * @param {string} clientId - The client ID of the session.
+ */
+var getSessionMode = function (clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName;
+    return __generator(this, function (_a) {
+        swarm.loggerService.log("function getSessionMode", {
+            clientId: clientId,
+        });
+        swarmName = swarm.sessionValidationService.getSwarm(clientId);
+        swarm.swarmValidationService.validate(swarmName, "getSessionMode");
+        return [2 /*return*/, swarm.sessionValidationService.getSessionMode(clientId)];
+    });
+}); };
+
 /**
  * Commits the tool output to the active agent in a swarm session
  *
@@ -4408,10 +4425,10 @@ var emit = function (content, clientId, agentName) { return __awaiter(void 0, vo
                 if (swarm.sessionValidationService.getSessionMode(clientId) !== "makeConnection") {
                     throw new Error("agent-swarm-kit emit session is not makeConnection clientId=".concat(clientId));
                 }
-                swarm.agentValidationService.validate(agentName, "execute");
-                swarm.sessionValidationService.validate(clientId, "execute");
+                swarm.agentValidationService.validate(agentName, "emit");
+                swarm.sessionValidationService.validate(clientId, "emit");
                 swarmName = swarm.sessionValidationService.getSwarm(clientId);
-                swarm.swarmValidationService.validate(swarmName, "execute");
+                swarm.swarmValidationService.validate(swarmName, "emit");
                 return [4 /*yield*/, swarm.swarmPublicService.getAgentName(clientId, swarmName)];
             case 1:
                 currentAgentName = _a.sent();
@@ -4429,6 +4446,144 @@ var emit = function (content, clientId, agentName) { return __awaiter(void 0, vo
     });
 }); };
 
+/**
+ * Commits the tool output to the active agent in a swarm session without checking active agent
+ *
+ * @param {string} content - The content to be committed.
+ * @param {string} clientId - The client ID associated with the session.
+ * @returns {Promise<void>} - A promise that resolves when the operation is complete.
+ */
+var commitToolOutputForce = function (toolId, content, clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                swarm.loggerService.log('function commitToolOutputForce', {
+                    toolId: toolId,
+                    content: content,
+                    clientId: clientId,
+                });
+                swarm.sessionValidationService.validate(clientId, "commitToolOutputForce");
+                swarmName = swarm.sessionValidationService.getSwarm(clientId);
+                swarm.swarmValidationService.validate(swarmName, "commitToolOutputForce");
+                return [4 /*yield*/, swarm.sessionPublicService.commitToolOutput(toolId, content, clientId, swarmName)];
+            case 1:
+                _a.sent();
+                return [2 /*return*/];
+        }
+    });
+}); };
+
+/**
+ * Commits a system message to the active agent in as swarm without checking active agent.
+ *
+ * @param {string} content - The content of the system message.
+ * @param {string} clientId - The ID of the client.
+ * @returns {Promise<void>} - A promise that resolves when the message is committed.
+ */
+var commitSystemMessageForce = function (content, clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                swarm.loggerService.log('function commitSystemMessageForce', {
+                    content: content,
+                    clientId: clientId,
+                });
+                swarm.sessionValidationService.validate(clientId, "commitSystemMessageForce");
+                swarmName = swarm.sessionValidationService.getSwarm(clientId);
+                swarm.swarmValidationService.validate(swarmName, "commitSystemMessageForce");
+                return [4 /*yield*/, swarm.sessionPublicService.commitSystemMessage(content, clientId, swarmName)];
+            case 1:
+                _a.sent();
+                return [2 /*return*/];
+        }
+    });
+}); };
+
+/**
+ * Commits flush of agent history without active agent check
+ *
+ * @param {string} clientId - The ID of the client.
+ * @returns {Promise<void>} - A promise that resolves when the message is committed.
+ */
+var commitFlushForce = function (clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                swarm.loggerService.log('function commitFlushForce', {
+                    clientId: clientId,
+                });
+                swarm.sessionValidationService.validate(clientId, "commitFlushForce");
+                swarmName = swarm.sessionValidationService.getSwarm(clientId);
+                swarm.swarmValidationService.validate(swarmName, "commitFlushForce");
+                return [4 /*yield*/, swarm.sessionPublicService.commitFlush(clientId, swarmName)];
+            case 1:
+                _a.sent();
+                return [2 /*return*/];
+        }
+    });
+}); };
+
+/**
+ * Commits a user message to the active agent history in as swarm without answer and checking active agent
+ *
+ * @param {string} content - The content of the message.
+ * @param {string} clientId - The ID of the client.
+ * @returns {Promise<void>} - A promise that resolves when the message is committed.
+ */
+var commitUserMessageForce = function (content, clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                swarm.loggerService.log('function commitSystemMessage', {
+                    content: content,
+                    clientId: clientId,
+                });
+                swarm.sessionValidationService.validate(clientId, "commitUserMessageForce");
+                swarmName = swarm.sessionValidationService.getSwarm(clientId);
+                swarm.swarmValidationService.validate(swarmName, "commitUserMessageForce");
+                return [4 /*yield*/, swarm.sessionPublicService.commitUserMessage(content, clientId, swarmName)];
+            case 1:
+                _a.sent();
+                return [2 /*return*/];
+        }
+    });
+}); };
+
+/**
+ * Emits a string constant as the model output without executing incoming message and checking active agent
+ * Works only for `makeConnection`
+ *
+ * @param {string} content - The content to be emitted.
+ * @param {string} clientId - The client ID of the session.
+ * @param {AgentName} agentName - The name of the agent to emit the content to.
+ * @throws Will throw an error if the session mode is not "makeConnection".
+ * @returns {Promise<void>} A promise that resolves when the content is emitted.
+ */
+var emitForce = function (content, clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                swarm.loggerService.log("function emitForce", {
+                    content: content,
+                    clientId: clientId,
+                });
+                if (swarm.sessionValidationService.getSessionMode(clientId) !== "makeConnection") {
+                    throw new Error("agent-swarm-kit emitForce session is not makeConnection clientId=".concat(clientId));
+                }
+                swarm.sessionValidationService.validate(clientId, "emitForce");
+                swarmName = swarm.sessionValidationService.getSwarm(clientId);
+                swarm.swarmValidationService.validate(swarmName, "emitForce");
+                return [4 /*yield*/, swarm.sessionPublicService.emit(content, clientId, swarmName)];
+            case 1: return [2 /*return*/, _a.sent()];
+        }
+    });
+}); };
+
 /**
  * Retrieves the last message sent by the user from the client's message history.
  *
@@ -4618,12 +4773,17 @@ exports.addSwarm = addSwarm;
 exports.addTool = addTool;
 exports.changeAgent = changeAgent;
 exports.commitFlush = commitFlush;
+exports.commitFlushForce = commitFlushForce;
 exports.commitSystemMessage = commitSystemMessage;
+exports.commitSystemMessageForce = commitSystemMessageForce;
 exports.commitToolOutput = commitToolOutput;
+exports.commitToolOutputForce = commitToolOutputForce;
 exports.commitUserMessage = commitUserMessage;
+exports.commitUserMessageForce = commitUserMessageForce;
 exports.complete = complete;
 exports.disposeConnection = disposeConnection;
 exports.emit = emit;
+exports.emitForce = emitForce;
 exports.execute = execute;
 exports.getAgentHistory = getAgentHistory;
 exports.getAgentName = getAgentName;
@@ -4632,6 +4792,7 @@ exports.getLastAssistantMessage = getLastAssistantMessage;
 exports.getLastSystemMessage = getLastSystemMessage;
 exports.getLastUserMessage = getLastUserMessage;
 exports.getRawHistory = getRawHistory;
+exports.getSessionMode = getSessionMode;
 exports.getUserHistory = getUserHistory;
 exports.makeAutoDispose = makeAutoDispose;
 exports.makeConnection = makeConnection;

package/build/index.mjs

@@ -4220,6 +4220,23 @@ var getAgentHistory = function (clientId, agentName) { return __awaiter(void 0,
     });
 }); };
 
+/**
+ * Return the session mode (`"session" | "makeConnection" | "complete"`) for clientId
+ *
+ * @param {string} clientId - The client ID of the session.
+ */
+var getSessionMode = function (clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName;
+    return __generator(this, function (_a) {
+        swarm.loggerService.log("function getSessionMode", {
+            clientId: clientId,
+        });
+        swarmName = swarm.sessionValidationService.getSwarm(clientId);
+        swarm.swarmValidationService.validate(swarmName, "getSessionMode");
+        return [2 /*return*/, swarm.sessionValidationService.getSessionMode(clientId)];
+    });
+}); };
+
 /**
  * Commits the tool output to the active agent in a swarm session
  *
@@ -4406,10 +4423,10 @@ var emit = function (content, clientId, agentName) { return __awaiter(void 0, vo
                 if (swarm.sessionValidationService.getSessionMode(clientId) !== "makeConnection") {
                     throw new Error("agent-swarm-kit emit session is not makeConnection clientId=".concat(clientId));
                 }
-                swarm.agentValidationService.validate(agentName, "execute");
-                swarm.sessionValidationService.validate(clientId, "execute");
+                swarm.agentValidationService.validate(agentName, "emit");
+                swarm.sessionValidationService.validate(clientId, "emit");
                 swarmName = swarm.sessionValidationService.getSwarm(clientId);
-                swarm.swarmValidationService.validate(swarmName, "execute");
+                swarm.swarmValidationService.validate(swarmName, "emit");
                 return [4 /*yield*/, swarm.swarmPublicService.getAgentName(clientId, swarmName)];
             case 1:
                 currentAgentName = _a.sent();
@@ -4427,6 +4444,144 @@ var emit = function (content, clientId, agentName) { return __awaiter(void 0, vo
     });
 }); };
 
+/**
+ * Commits the tool output to the active agent in a swarm session without checking active agent
+ *
+ * @param {string} content - The content to be committed.
+ * @param {string} clientId - The client ID associated with the session.
+ * @returns {Promise<void>} - A promise that resolves when the operation is complete.
+ */
+var commitToolOutputForce = function (toolId, content, clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                swarm.loggerService.log('function commitToolOutputForce', {
+                    toolId: toolId,
+                    content: content,
+                    clientId: clientId,
+                });
+                swarm.sessionValidationService.validate(clientId, "commitToolOutputForce");
+                swarmName = swarm.sessionValidationService.getSwarm(clientId);
+                swarm.swarmValidationService.validate(swarmName, "commitToolOutputForce");
+                return [4 /*yield*/, swarm.sessionPublicService.commitToolOutput(toolId, content, clientId, swarmName)];
+            case 1:
+                _a.sent();
+                return [2 /*return*/];
+        }
+    });
+}); };
+
+/**
+ * Commits a system message to the active agent in as swarm without checking active agent.
+ *
+ * @param {string} content - The content of the system message.
+ * @param {string} clientId - The ID of the client.
+ * @returns {Promise<void>} - A promise that resolves when the message is committed.
+ */
+var commitSystemMessageForce = function (content, clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                swarm.loggerService.log('function commitSystemMessageForce', {
+                    content: content,
+                    clientId: clientId,
+                });
+                swarm.sessionValidationService.validate(clientId, "commitSystemMessageForce");
+                swarmName = swarm.sessionValidationService.getSwarm(clientId);
+                swarm.swarmValidationService.validate(swarmName, "commitSystemMessageForce");
+                return [4 /*yield*/, swarm.sessionPublicService.commitSystemMessage(content, clientId, swarmName)];
+            case 1:
+                _a.sent();
+                return [2 /*return*/];
+        }
+    });
+}); };
+
+/**
+ * Commits flush of agent history without active agent check
+ *
+ * @param {string} clientId - The ID of the client.
+ * @returns {Promise<void>} - A promise that resolves when the message is committed.
+ */
+var commitFlushForce = function (clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                swarm.loggerService.log('function commitFlushForce', {
+                    clientId: clientId,
+                });
+                swarm.sessionValidationService.validate(clientId, "commitFlushForce");
+                swarmName = swarm.sessionValidationService.getSwarm(clientId);
+                swarm.swarmValidationService.validate(swarmName, "commitFlushForce");
+                return [4 /*yield*/, swarm.sessionPublicService.commitFlush(clientId, swarmName)];
+            case 1:
+                _a.sent();
+                return [2 /*return*/];
+        }
+    });
+}); };
+
+/**
+ * Commits a user message to the active agent history in as swarm without answer and checking active agent
+ *
+ * @param {string} content - The content of the message.
+ * @param {string} clientId - The ID of the client.
+ * @returns {Promise<void>} - A promise that resolves when the message is committed.
+ */
+var commitUserMessageForce = function (content, clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                swarm.loggerService.log('function commitSystemMessage', {
+                    content: content,
+                    clientId: clientId,
+                });
+                swarm.sessionValidationService.validate(clientId, "commitUserMessageForce");
+                swarmName = swarm.sessionValidationService.getSwarm(clientId);
+                swarm.swarmValidationService.validate(swarmName, "commitUserMessageForce");
+                return [4 /*yield*/, swarm.sessionPublicService.commitUserMessage(content, clientId, swarmName)];
+            case 1:
+                _a.sent();
+                return [2 /*return*/];
+        }
+    });
+}); };
+
+/**
+ * Emits a string constant as the model output without executing incoming message and checking active agent
+ * Works only for `makeConnection`
+ *
+ * @param {string} content - The content to be emitted.
+ * @param {string} clientId - The client ID of the session.
+ * @param {AgentName} agentName - The name of the agent to emit the content to.
+ * @throws Will throw an error if the session mode is not "makeConnection".
+ * @returns {Promise<void>} A promise that resolves when the content is emitted.
+ */
+var emitForce = function (content, clientId) { return __awaiter(void 0, void 0, void 0, function () {
+    var swarmName;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                swarm.loggerService.log("function emitForce", {
+                    content: content,
+                    clientId: clientId,
+                });
+                if (swarm.sessionValidationService.getSessionMode(clientId) !== "makeConnection") {
+                    throw new Error("agent-swarm-kit emitForce session is not makeConnection clientId=".concat(clientId));
+                }
+                swarm.sessionValidationService.validate(clientId, "emitForce");
+                swarmName = swarm.sessionValidationService.getSwarm(clientId);
+                swarm.swarmValidationService.validate(swarmName, "emitForce");
+                return [4 /*yield*/, swarm.sessionPublicService.emit(content, clientId, swarmName)];
+            case 1: return [2 /*return*/, _a.sent()];
+        }
+    });
+}); };
+
 /**
  * Retrieves the last message sent by the user from the client's message history.
  *
@@ -4609,4 +4764,4 @@ var makeAutoDispose = function (clientId, swarmName, _a) {
     };
 };
 
-export { ContextService, addAgent, addCompletion, addSwarm, addTool, changeAgent, commitFlush, commitSystemMessage, commitToolOutput, commitUserMessage, complete, disposeConnection, emit, execute, getAgentHistory, getAgentName, getAssistantHistory, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getRawHistory, getUserHistory, makeAutoDispose, makeConnection, session, setConfig, swarm };
+export { ContextService, addAgent, addCompletion, addSwarm, addTool, changeAgent, commitFlush, commitFlushForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitUserMessage, commitUserMessageForce, complete, disposeConnection, emit, emitForce, execute, getAgentHistory, getAgentName, getAssistantHistory, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getRawHistory, getSessionMode, getUserHistory, makeAutoDispose, makeConnection, session, setConfig, swarm };

package/package.json

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

package/types.d.ts

@@ -1947,6 +1947,13 @@ declare const getRawHistory: (clientId: string) => Promise<IModelMessage[]>;
  */
 declare const getAgentHistory: (clientId: string, agentName: AgentName) => Promise<IModelMessage[]>;
 
+/**
+ * Return the session mode (`"session" | "makeConnection" | "complete"`) for clientId
+ *
+ * @param {string} clientId - The client ID of the session.
+ */
+declare const getSessionMode: (clientId: string) => Promise<SessionMode>;
+
 /**
  * Commits the tool output to the active agent in a swarm session
  *
@@ -1976,6 +1983,16 @@ declare const commitSystemMessage: (content: string, clientId: string, agentName
  */
 declare const commitFlush: (clientId: string, agentName: string) => Promise<void>;
 
+/**
+ * Commits a user message to the active agent history in as swarm without answer.
+ *
+ * @param {string} content - The content of the message.
+ * @param {string} clientId - The ID of the client.
+ * @param {string} agentName - The name of the agent.
+ * @returns {Promise<void>} - A promise that resolves when the message is committed.
+ */
+declare const commitUserMessage: (content: string, clientId: string, agentName: string) => Promise<void>;
+
 /**
  * Send the message to the active agent in the swarm content like it income from client side
  * Should be used to review tool output and initiate conversation from the model side to client
@@ -2000,22 +2017,59 @@ declare const execute: (content: string, clientId: string, agentName: AgentName)
 declare const emit: (content: string, clientId: string, agentName: AgentName) => Promise<void>;
 
 /**
- * Retrieves the last message sent by the user from the client's message history.
+ * Commits the tool output to the active agent in a swarm session without checking active agent
  *
- * @param {string} clientId - The ID of the client whose message history is being retrieved.
- * @returns {Promise<string | null>} - The content of the last user message, or null if no user message is found.
+ * @param {string} content - The content to be committed.
+ * @param {string} clientId - The client ID associated with the session.
+ * @returns {Promise<void>} - A promise that resolves when the operation is complete.
  */
-declare const getLastUserMessage: (clientId: string) => Promise<string>;
+declare const commitToolOutputForce: (toolId: string, content: string, clientId: string) => Promise<void>;
 
 /**
- * Commits a user message to the active agent history in as swarm without answer.
+ * Commits a system message to the active agent in as swarm without checking active agent.
+ *
+ * @param {string} content - The content of the system message.
+ * @param {string} clientId - The ID of the client.
+ * @returns {Promise<void>} - A promise that resolves when the message is committed.
+ */
+declare const commitSystemMessageForce: (content: string, clientId: string) => Promise<void>;
+
+/**
+ * Commits flush of agent history without active agent check
+ *
+ * @param {string} clientId - The ID of the client.
+ * @returns {Promise<void>} - A promise that resolves when the message is committed.
+ */
+declare const commitFlushForce: (clientId: string) => Promise<void>;
+
+/**
+ * Commits a user message to the active agent history in as swarm without answer and checking active agent
  *
  * @param {string} content - The content of the message.
  * @param {string} clientId - The ID of the client.
- * @param {string} agentName - The name of the agent.
  * @returns {Promise<void>} - A promise that resolves when the message is committed.
  */
-declare const commitUserMessage: (content: string, clientId: string, agentName: string) => Promise<void>;
+declare const commitUserMessageForce: (content: string, clientId: string) => Promise<void>;
+
+/**
+ * Emits a string constant as the model output without executing incoming message and checking active agent
+ * Works only for `makeConnection`
+ *
+ * @param {string} content - The content to be emitted.
+ * @param {string} clientId - The client ID of the session.
+ * @param {AgentName} agentName - The name of the agent to emit the content to.
+ * @throws Will throw an error if the session mode is not "makeConnection".
+ * @returns {Promise<void>} A promise that resolves when the content is emitted.
+ */
+declare const emitForce: (content: string, clientId: string) => Promise<void>;
+
+/**
+ * Retrieves the last message sent by the user from the client's message history.
+ *
+ * @param {string} clientId - The ID of the client whose message history is being retrieved.
+ * @returns {Promise<string | null>} - The content of the last user message, or null if no user message is found.
+ */
+declare const getLastUserMessage: (clientId: string) => Promise<string>;
 
 /**
  * Retrieves the agent name for a given client ID.
@@ -2108,4 +2162,4 @@ declare const GLOBAL_CONFIG: {
 };
 declare const setConfig: (config: Partial<typeof GLOBAL_CONFIG>) => void;
 
-export { ContextService, type IAgentSchema, type IAgentTool, type ICompletionArgs, type ICompletionSchema, type IIncomingMessage, type IMakeConnectionConfig, type IMakeDisposeParams, type IModelMessage, type IOutgoingMessage, type ISessionConfig, type ISwarmSchema, type ITool, type IToolCall, type ReceiveMessageFn, type SendMessageFn$1 as SendMessageFn, addAgent, addCompletion, addSwarm, addTool, changeAgent, commitFlush, commitSystemMessage, commitToolOutput, commitUserMessage, complete, disposeConnection, emit, execute, getAgentHistory, getAgentName, getAssistantHistory, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getRawHistory, getUserHistory, makeAutoDispose, makeConnection, session, setConfig, swarm };
+export { ContextService, type IAgentSchema, type IAgentTool, type ICompletionArgs, type ICompletionSchema, type IIncomingMessage, type IMakeConnectionConfig, type IMakeDisposeParams, type IModelMessage, type IOutgoingMessage, type ISessionConfig, type ISwarmSchema, type ITool, type IToolCall, type ReceiveMessageFn, type SendMessageFn$1 as SendMessageFn, addAgent, addCompletion, addSwarm, addTool, changeAgent, commitFlush, commitFlushForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitUserMessage, commitUserMessageForce, complete, disposeConnection, emit, emitForce, execute, getAgentHistory, getAgentName, getAssistantHistory, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getRawHistory, getSessionMode, getUserHistory, makeAutoDispose, makeConnection, session, setConfig, swarm };