agent-swarm-kit 1.1.64 → 1.1.66

package/README.md

@@ -448,7 +448,7 @@ The **Agent Tune Dataset Constructor** is a React-based tool designed for crafti
 
 - ✅ **Validation**: Ensures tool consistency, message order, and data integrity. 🛡️
 
-- 🚀 **Ease of Use**: Navigate with breadcrumbs, save drafts, and export directly for fine-tuning with commands like openai api fine_tunes.create. 📤
+- 🚀 **Ease of Use**: Navigate with breadcrumbs, save drafts, and export directly for fine-tuning with commands like openai api [fine_tunes.create](https://platform.openai.com/docs/api-reference/fine-tuning). 📤
 
 #### Use Case
 Perfect for preparing training data to fine-tune agents within `agent-swarm-kit`, Agent Tune lets you define precise behaviors—like how a sales agent responds or a triage agent routes requests—before integrating them into your swarm. Export your dataset and fine-tune your models to enhance performance across your agent network. 🌐

package/build/index.cjs

@@ -3425,7 +3425,7 @@ class AgentSchemaService {
             if (!agentSchema.operator && typeof agentSchema.completion !== "string") {
                 throw new Error(`agent-swarm agent schema validation failed: missing completion for agentName=${agentSchema.agentName}`);
             }
-            if (!agentSchema.operator && typeof agentSchema.prompt !== "string") {
+            if (!agentSchema.operator && agentSchema.prompt === undefined) {
                 throw new Error(`agent-swarm agent schema validation failed: missing prompt for agentName=${agentSchema.agentName}`);
             }
             if (agentSchema.system && !Array.isArray(agentSchema.system)) {
@@ -3801,7 +3801,10 @@ 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 prompt = typeof self.params.prompt === "string"
+        ? self.params.prompt
+        : await self.params.prompt(self.params.clientId, self.params.agentName);
+    const messages = await self.params.history.toArrayForAgent(prompt, await self._resolveSystemPrompt());
     messages.push({
         agentName: self.params.agentName,
         content: incoming,
@@ -4337,7 +4340,10 @@ class ClientAgent {
     async getCompletion(mode, tools) {
         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 prompt = typeof this.params.prompt === "string"
+            ? this.params.prompt
+            : await this.params.prompt(this.params.clientId, this.params.agentName);
+        const messages = await this.params.history.toArrayForAgent(prompt, await this._resolveSystemPrompt());
         const args = {
             clientId: this.params.clientId,
             agentName: this.params.agentName,
@@ -4381,7 +4387,10 @@ 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 prompt = typeof this.params.prompt === "string"
+                ? this.params.prompt
+                : await this.params.prompt(this.params.clientId, this.params.agentName);
+            const messages = await this.params.history.toArrayForAgent(prompt, await this._resolveSystemPrompt());
             const args = {
                 clientId: this.params.clientId,
                 agentName: this.params.agentName,
@@ -6169,7 +6178,7 @@ class ToolSchemaService {
             if (toolSchema.validate && typeof toolSchema.validate !== "function") {
                 throw new Error(`agent-swarm tool schema validation failed: missing validate for toolName=${toolSchema.toolName}`);
             }
-            if (!functoolsKit.isObject(toolSchema.function)) {
+            if (!functoolsKit.isObject(toolSchema.function) && typeof toolSchema.function !== "function") {
                 throw new Error(`agent-swarm tool schema validation failed: missing function for toolName=${toolSchema.toolName}`);
             }
         };
@@ -13325,7 +13334,7 @@ class DocService {
                     result.push("");
                 }
             }
-            if (agentSchema.prompt) {
+            if (typeof agentSchema.prompt === "string") {
                 result.push(`## Main prompt`);
                 result.push("");
                 result.push("```");
@@ -21575,7 +21584,10 @@ const getAgentHistoryInternal = beginContext(async (clientId, agentName) => {
     swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$b);
     swarm$1.agentValidationService.validate(agentName, METHOD_NAME$b);
     // Retrieve the agent's prompt configuration from the agent schema service
-    const { prompt } = swarm$1.agentSchemaService.get(agentName);
+    const { prompt: upperPrompt } = swarm$1.agentSchemaService.get(agentName);
+    const prompt = typeof upperPrompt === "string"
+        ? upperPrompt
+        : await upperPrompt(clientId, agentName);
     // Fetch the agent's history using the prompt and rescue tweaks via the history public service
     const history = await swarm$1.historyPublicService.toArrayForAgent(prompt, METHOD_NAME$b, clientId, agentName);
     // Return a shallow copy of the history array
@@ -23181,11 +23193,12 @@ const ChatInstance = functoolsKit.makeExtendable(class {
      * @param {Partial<IChatInstanceCallbacks>} callbacks - Event callbacks
      * @param {DisposeFn} onDispose - Dispose callback function
      */
-    constructor(clientId, swarmName, onDispose, callbacks) {
+    constructor(clientId, swarmName, onDispose, callbacks, payload) {
         this.clientId = clientId;
         this.swarmName = swarmName;
         this.onDispose = onDispose;
         this.callbacks = callbacks;
+        this.payload = payload;
         /** @private */
         this._disposeSubject = new functoolsKit.Subject();
         /** @private */
@@ -23302,7 +23315,7 @@ class ChatUtils {
          * @param {SwarmName} swarmName - Name of the swarm
          * @returns {IChatInstance} The chat instance for the given client
          */
-        this.getChatInstance = (clientId, swarmName) => {
+        this.getChatInstance = (clientId, swarmName, payload = {}) => {
             return this._chats.has(clientId)
                 ? this._chats.get(clientId)
                 : this._chats
@@ -23311,6 +23324,7 @@ class ChatUtils {
                     swarmName,
                     () => this._chats.delete(clientId),
                     this.ChatInstanceCallbacks,
+                    payload,
                 ]))
                     .get(clientId);
         };
@@ -23320,14 +23334,14 @@ class ChatUtils {
          * @param {SwarmName} swarmName - Name of the swarm
          * @returns {Promise<void>}
          */
-        this.beginChat = async (clientId, swarmName) => {
+        this.beginChat = async (clientId, swarmName, payload = {}) => {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
                 swarm$1.loggerService.log("ChatUtils.beginChat", {
                     clientId,
                     swarmName,
                 });
             this.initializeCleanup();
-            return await this.getChatInstance(clientId, swarmName).beginChat();
+            return await this.getChatInstance(clientId, swarmName, payload).beginChat();
         };
         /**
          * Sends a message for a client

package/build/index.mjs

@@ -3423,7 +3423,7 @@ class AgentSchemaService {
             if (!agentSchema.operator && typeof agentSchema.completion !== "string") {
                 throw new Error(`agent-swarm agent schema validation failed: missing completion for agentName=${agentSchema.agentName}`);
             }
-            if (!agentSchema.operator && typeof agentSchema.prompt !== "string") {
+            if (!agentSchema.operator && agentSchema.prompt === undefined) {
                 throw new Error(`agent-swarm agent schema validation failed: missing prompt for agentName=${agentSchema.agentName}`);
             }
             if (agentSchema.system && !Array.isArray(agentSchema.system)) {
@@ -3799,7 +3799,10 @@ 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 prompt = typeof self.params.prompt === "string"
+        ? self.params.prompt
+        : await self.params.prompt(self.params.clientId, self.params.agentName);
+    const messages = await self.params.history.toArrayForAgent(prompt, await self._resolveSystemPrompt());
     messages.push({
         agentName: self.params.agentName,
         content: incoming,
@@ -4335,7 +4338,10 @@ class ClientAgent {
     async getCompletion(mode, tools) {
         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 prompt = typeof this.params.prompt === "string"
+            ? this.params.prompt
+            : await this.params.prompt(this.params.clientId, this.params.agentName);
+        const messages = await this.params.history.toArrayForAgent(prompt, await this._resolveSystemPrompt());
         const args = {
             clientId: this.params.clientId,
             agentName: this.params.agentName,
@@ -4379,7 +4385,10 @@ 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 prompt = typeof this.params.prompt === "string"
+                ? this.params.prompt
+                : await this.params.prompt(this.params.clientId, this.params.agentName);
+            const messages = await this.params.history.toArrayForAgent(prompt, await this._resolveSystemPrompt());
             const args = {
                 clientId: this.params.clientId,
                 agentName: this.params.agentName,
@@ -6167,7 +6176,7 @@ class ToolSchemaService {
             if (toolSchema.validate && typeof toolSchema.validate !== "function") {
                 throw new Error(`agent-swarm tool schema validation failed: missing validate for toolName=${toolSchema.toolName}`);
             }
-            if (!isObject$1(toolSchema.function)) {
+            if (!isObject$1(toolSchema.function) && typeof toolSchema.function !== "function") {
                 throw new Error(`agent-swarm tool schema validation failed: missing function for toolName=${toolSchema.toolName}`);
             }
         };
@@ -13323,7 +13332,7 @@ class DocService {
                     result.push("");
                 }
             }
-            if (agentSchema.prompt) {
+            if (typeof agentSchema.prompt === "string") {
                 result.push(`## Main prompt`);
                 result.push("");
                 result.push("```");
@@ -21573,7 +21582,10 @@ const getAgentHistoryInternal = beginContext(async (clientId, agentName) => {
     swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$b);
     swarm$1.agentValidationService.validate(agentName, METHOD_NAME$b);
     // Retrieve the agent's prompt configuration from the agent schema service
-    const { prompt } = swarm$1.agentSchemaService.get(agentName);
+    const { prompt: upperPrompt } = swarm$1.agentSchemaService.get(agentName);
+    const prompt = typeof upperPrompt === "string"
+        ? upperPrompt
+        : await upperPrompt(clientId, agentName);
     // Fetch the agent's history using the prompt and rescue tweaks via the history public service
     const history = await swarm$1.historyPublicService.toArrayForAgent(prompt, METHOD_NAME$b, clientId, agentName);
     // Return a shallow copy of the history array
@@ -23179,11 +23191,12 @@ const ChatInstance = makeExtendable(class {
      * @param {Partial<IChatInstanceCallbacks>} callbacks - Event callbacks
      * @param {DisposeFn} onDispose - Dispose callback function
      */
-    constructor(clientId, swarmName, onDispose, callbacks) {
+    constructor(clientId, swarmName, onDispose, callbacks, payload) {
         this.clientId = clientId;
         this.swarmName = swarmName;
         this.onDispose = onDispose;
         this.callbacks = callbacks;
+        this.payload = payload;
         /** @private */
         this._disposeSubject = new Subject();
         /** @private */
@@ -23300,7 +23313,7 @@ class ChatUtils {
          * @param {SwarmName} swarmName - Name of the swarm
          * @returns {IChatInstance} The chat instance for the given client
          */
-        this.getChatInstance = (clientId, swarmName) => {
+        this.getChatInstance = (clientId, swarmName, payload = {}) => {
             return this._chats.has(clientId)
                 ? this._chats.get(clientId)
                 : this._chats
@@ -23309,6 +23322,7 @@ class ChatUtils {
                     swarmName,
                     () => this._chats.delete(clientId),
                     this.ChatInstanceCallbacks,
+                    payload,
                 ]))
                     .get(clientId);
         };
@@ -23318,14 +23332,14 @@ class ChatUtils {
          * @param {SwarmName} swarmName - Name of the swarm
          * @returns {Promise<void>}
          */
-        this.beginChat = async (clientId, swarmName) => {
+        this.beginChat = async (clientId, swarmName, payload = {}) => {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
                 swarm$1.loggerService.log("ChatUtils.beginChat", {
                     clientId,
                     swarmName,
                 });
             this.initializeCleanup();
-            return await this.getChatInstance(clientId, swarmName).beginChat();
+            return await this.getChatInstance(clientId, swarmName, payload).beginChat();
         };
         /**
          * Sends a message for a client

package/package.json

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

package/types.d.ts

@@ -3572,7 +3572,7 @@ interface IAgentSchemaInternal {
     /** The name of the completion mechanism used by the agent. REQUIRED WHEN AGENT IS NOT OPERATOR */
     completion?: CompletionName;
     /** The primary prompt guiding the agent's behavior. REQUIRED WHEN AGENT IS NOT OPERATOR */
-    prompt?: string;
+    prompt?: string | ((clientId: string, agentName: AgentName) => (Promise<string> | string));
     /** Optional array of system prompts, typically used for tool-calling protocols. */
     system?: string[];
     /** Optional array of system prompts, alias for `system` */
@@ -14323,14 +14323,14 @@ interface IChatControl {
 /**
  * @typedef {new (clientId: SessionId, swarmName: SwarmName, callbacks: IChatInstanceCallbacks, onDispose: DisposeFn) => IChatInstance} TChatInstanceCtor
  */
-type TChatInstanceCtor = new (clientId: SessionId, swarmName: SwarmName, onDispose: DisposeFn, callbacks: IChatInstanceCallbacks) => IChatInstance;
+type TChatInstanceCtor = new <Payload extends any = any>(clientId: SessionId, swarmName: SwarmName, onDispose: DisposeFn, callbacks: IChatInstanceCallbacks, payload: Payload) => IChatInstance;
 /**
  * @class ChatInstance
  * @implements {IChatInstance}
  * @description Implementation of a single chat instance
  */
 declare const ChatInstance: {
-    new (clientId: SessionId, swarmName: SwarmName, onDispose: DisposeFn, callbacks: Partial<IChatInstanceCallbacks>): {
+    new <Payload extends unknown = any>(clientId: SessionId, swarmName: SwarmName, onDispose: DisposeFn, callbacks: Partial<IChatInstanceCallbacks>, payload: Payload): {
         /** @private */
         _disposeSubject: Subject<string>;
         /** @private */
@@ -14341,6 +14341,7 @@ declare const ChatInstance: {
         readonly swarmName: SwarmName;
         readonly onDispose: DisposeFn;
         readonly callbacks: Partial<IChatInstanceCallbacks>;
+        readonly payload: Payload;
         /**
          * Checks if the chat has been active within the timeout period
          * @param {number} now - Current timestamp
@@ -14408,7 +14409,7 @@ declare class ChatUtils implements IChatControl {
      * @param {SwarmName} swarmName - Name of the swarm
      * @returns {Promise<void>}
      */
-    beginChat: (clientId: SessionId, swarmName: SwarmName) => Promise<void>;
+    beginChat: <Payload extends unknown = any>(clientId: SessionId, swarmName: SwarmName, payload?: Payload) => Promise<void>;
     /**
      * Sends a message for a client
      * @param {SessionId} clientId - Unique client identifier