agent-swarm-kit 1.0.214 → 1.0.216

package/README.md

@@ -22,7 +22,7 @@ Unleash the power of collaborative AI with `agent-swarm-kit`! This library empow
 
 ## 🚀 Getting Started
 
-**Want a real-world demo?** Check out our **[REPL Phone Seller App](https://github.com/tripolskypetr/agent-swarm-kit/blob/master/demo/repl-phone-seller/src/logic/agent/sales.agent.ts)**—a practical example of a sales agent in action!
+**Want a real-world demo?** Check out our **[Binance Candle Chat](https://github.com/tripolskypetr/agent-swarm-kit/blob/master/demo/binance-candle-chat/src/lib/swarm.ts)**—a practical example of a sales agent in action!
 
 ### Installation
 
@@ -290,6 +290,35 @@ Storage.take<PhoneModel>({
 }).then((phones) => console.log(phones));
 ```
 
+---
+
+## 🧩 Demo Projects
+
+Here’s a rundown of the demo projects showcasing `agent-swarm-kit` in action:
+
+- [**binance-candle-chat**](./demo/binance-candle-chat/): A cryptocurrency trading swarm with a triage agent routing to specialized trader agents (BTC, ETH, BNB, XRP, SOL) that calculate buy/sell orders and predict trends using OpenAI completion.
+
+- [**it-consulting-swarm**](./demo/it-consulting-swarm/): A multi-agent system with a triage agent routing queries to specialized agents for tech trends, cybersecurity, environment, health, and finance, all powered by OpenAI completion.
+
+- [**langchain-stream**](./demo/langchain-stream/): A pharma sales demo with a triage agent using Cohere completion and LangChain for real-time token streaming, alongside Ollama and LMStudio, to assist with consultations and cart operations.
+
+- [**redis-persist-chat**](./demo/redis-persist-chat/): A chat system with a triage agent using Saiga Yandex GPT, persisting chat history and states (like Tic-tac-toe) in Redis, with policies to restrict sensitive topics.
+
+- [**nginx-balancer-chat**](./demo/nginx-balancer-chat/): A test environment demonstrating load balancing across 5 chat instances via Nginx, with a single agent reporting the server port using OpenAI completion.
+
+- [**cohere-token-rotate**](./demo/cohere-token-rotate/): A pharma sales system with a triage agent using Cohere completion and a token rotation mechanism (10 trial tokens in parallel) for optimized API performance.
+
+- [**whisper-voice-chat**](./demo/whisper-voice-chat/): A voice-based chat system using Whisper for real-time transcription and a single test agent powered by Nemotron Mini (via Ollama) to handle user interactions.
+
+- [**telegram-ollama-chat**](./demo/telegram-ollama-chat/): A Telegram-based pharma sales chatbot with a triage agent routing requests to a sales agent, both using Ollama for natural conversations and managing product data from a shared storage.
+
+- [**repl-phone-seller**](./demo/repl-phone-seller/): A REPL terminal app featuring a sales agent that helps users add phones to a cart, leveraging Ollama completions and tools for searching phones by keywords or diagonal size.
+
+- [**client-server-chat**](./demo/client-server-chat/): A WebSocket-based pharma sales demo with a single test agent using Saiga Yandex GPT to provide consultations and manage a cart.
+
+---
+
+
 ## ❓ Orchestration Principles
 
 1. Several chatgpt sessions (agents) [execute tool calls](https://ollama.com/blog/tool-support). Each agent can use different model, for example, [mistral 7b](https://ollama.com/library/mistral) for small talk, [nemotron](https://ollama.com/library/nemotron) for business conversation

package/build/index.cjs

@@ -17384,6 +17384,8 @@ const METHOD_NAME_REMOVE$1 = "StorageUtils.remove";
 const METHOD_NAME_GET$1 = "StorageUtils.get";
 /** @private Constant for logging the list method in StorageUtils */
 const METHOD_NAME_LIST$1 = "StorageUtils.list";
+/** @private Constant for logging the createNumericIndex method in SharedStorageUtils */
+const METHOD_NAME_CREATE_NUMERIC_INDEX$1 = "StorageUtils.createNumericIndex";
 /** @private Constant for logging the clear method in StorageUtils */
 const METHOD_NAME_CLEAR$1 = "StorageUtils.clear";
 /**
@@ -17529,6 +17531,31 @@ class StorageUtils {
             }
             return await swarm$1.storagePublicService.list(METHOD_NAME_LIST$1, payload.clientId, payload.storageName, payload.filter);
         });
+        /**
+         * Creates a numeric index for the storage of a given client and agent.
+         * Validates the storage name and agent-storage registration before calculating the index.
+         * Executes within a context for logging.
+         * The numeric index is determined based on the current number of items in the storage.
+         * @param {Object} payload - The payload containing client, agent, and storage details.
+         * @param {string} payload.clientId - The ID of the client whose storage is being indexed.
+         * @param {AgentName} payload.agentName - The name of the agent associated with the storage.
+         * @param {StorageName} payload.storageName - The name of the storage to index.
+         * @returns {Promise<number>} A promise resolving to the next numeric index for the storage.
+         * @throws {Error} If storage validation fails, the storage is not registered in the agent, or the storage service encounters an error.
+         */
+        this.createNumericIndex = beginContext(async (payload) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
+                swarm$1.loggerService.log(METHOD_NAME_CREATE_NUMERIC_INDEX$1, {
+                    clientId: payload.clientId,
+                    storageName: payload.storageName,
+                });
+            swarm$1.storageValidationService.validate(payload.storageName, METHOD_NAME_CREATE_NUMERIC_INDEX$1);
+            if (!swarm$1.agentValidationService.hasStorage(payload.agentName, payload.storageName)) {
+                throw new Error(`agent-swarm StorageUtils ${payload.storageName} not registered in ${payload.agentName} (createNumericIndex)`);
+            }
+            const { length } = await swarm$1.storagePublicService.list(METHOD_NAME_CREATE_NUMERIC_INDEX$1, payload.clientId, payload.storageName);
+            return length + 1;
+        });
         /**
          * Clears all items from the storage for a given client and agent.
          * Validates the storage name and agent-storage registration before clearing via the storage service.
@@ -17570,6 +17597,8 @@ const METHOD_NAME_REMOVE = "SharedStorageUtils.remove";
 const METHOD_NAME_GET = "SharedStorageUtils.get";
 /** @private Constant for logging the list method in SharedStorageUtils */
 const METHOD_NAME_LIST = "SharedStorageUtils.list";
+/** @private Constant for logging the createNumericIndex method in SharedStorageUtils */
+const METHOD_NAME_CREATE_NUMERIC_INDEX = "SharedStorageUtils.createNumericIndex";
 /** @private Constant for logging the clear method in SharedStorageUtils */
 const METHOD_NAME_CLEAR = "SharedStorageUtils.clear";
 /**
@@ -17672,6 +17701,24 @@ class SharedStorageUtils {
             swarm$1.storageValidationService.validate(storageName, METHOD_NAME_LIST);
             return await swarm$1.sharedStoragePublicService.list(METHOD_NAME_LIST, storageName, filter);
         });
+        /**
+         * Creates a new numeric index for the specified storage.
+         * Executes within a context for logging and validation, ensuring the storage name is valid.
+         * The numeric index is determined based on the current number of items in the storage.
+         *
+         * @param {StorageName} storageName - The name of the storage for which to create the numeric index.
+         * @returns {Promise<number>} A promise resolving to the newly created numeric index.
+         * @throws {Error} If storage validation fails or the shared storage service encounters an error.
+         */
+        this.createNumericIndex = beginContext(async (storageName) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
+                swarm$1.loggerService.log(METHOD_NAME_CREATE_NUMERIC_INDEX, {
+                    storageName,
+                });
+            swarm$1.storageValidationService.validate(storageName, METHOD_NAME_CREATE_NUMERIC_INDEX);
+            const { length } = await swarm$1.sharedStoragePublicService.list(METHOD_NAME_CREATE_NUMERIC_INDEX, storageName);
+            return length + 1;
+        });
         /**
          * Clears all items from the storage.
          * Executes within a context for logging and validation, ensuring the storage name is valid.

package/build/index.mjs

@@ -17382,6 +17382,8 @@ const METHOD_NAME_REMOVE$1 = "StorageUtils.remove";
 const METHOD_NAME_GET$1 = "StorageUtils.get";
 /** @private Constant for logging the list method in StorageUtils */
 const METHOD_NAME_LIST$1 = "StorageUtils.list";
+/** @private Constant for logging the createNumericIndex method in SharedStorageUtils */
+const METHOD_NAME_CREATE_NUMERIC_INDEX$1 = "StorageUtils.createNumericIndex";
 /** @private Constant for logging the clear method in StorageUtils */
 const METHOD_NAME_CLEAR$1 = "StorageUtils.clear";
 /**
@@ -17527,6 +17529,31 @@ class StorageUtils {
             }
             return await swarm$1.storagePublicService.list(METHOD_NAME_LIST$1, payload.clientId, payload.storageName, payload.filter);
         });
+        /**
+         * Creates a numeric index for the storage of a given client and agent.
+         * Validates the storage name and agent-storage registration before calculating the index.
+         * Executes within a context for logging.
+         * The numeric index is determined based on the current number of items in the storage.
+         * @param {Object} payload - The payload containing client, agent, and storage details.
+         * @param {string} payload.clientId - The ID of the client whose storage is being indexed.
+         * @param {AgentName} payload.agentName - The name of the agent associated with the storage.
+         * @param {StorageName} payload.storageName - The name of the storage to index.
+         * @returns {Promise<number>} A promise resolving to the next numeric index for the storage.
+         * @throws {Error} If storage validation fails, the storage is not registered in the agent, or the storage service encounters an error.
+         */
+        this.createNumericIndex = beginContext(async (payload) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
+                swarm$1.loggerService.log(METHOD_NAME_CREATE_NUMERIC_INDEX$1, {
+                    clientId: payload.clientId,
+                    storageName: payload.storageName,
+                });
+            swarm$1.storageValidationService.validate(payload.storageName, METHOD_NAME_CREATE_NUMERIC_INDEX$1);
+            if (!swarm$1.agentValidationService.hasStorage(payload.agentName, payload.storageName)) {
+                throw new Error(`agent-swarm StorageUtils ${payload.storageName} not registered in ${payload.agentName} (createNumericIndex)`);
+            }
+            const { length } = await swarm$1.storagePublicService.list(METHOD_NAME_CREATE_NUMERIC_INDEX$1, payload.clientId, payload.storageName);
+            return length + 1;
+        });
         /**
          * Clears all items from the storage for a given client and agent.
          * Validates the storage name and agent-storage registration before clearing via the storage service.
@@ -17568,6 +17595,8 @@ const METHOD_NAME_REMOVE = "SharedStorageUtils.remove";
 const METHOD_NAME_GET = "SharedStorageUtils.get";
 /** @private Constant for logging the list method in SharedStorageUtils */
 const METHOD_NAME_LIST = "SharedStorageUtils.list";
+/** @private Constant for logging the createNumericIndex method in SharedStorageUtils */
+const METHOD_NAME_CREATE_NUMERIC_INDEX = "SharedStorageUtils.createNumericIndex";
 /** @private Constant for logging the clear method in SharedStorageUtils */
 const METHOD_NAME_CLEAR = "SharedStorageUtils.clear";
 /**
@@ -17670,6 +17699,24 @@ class SharedStorageUtils {
             swarm$1.storageValidationService.validate(storageName, METHOD_NAME_LIST);
             return await swarm$1.sharedStoragePublicService.list(METHOD_NAME_LIST, storageName, filter);
         });
+        /**
+         * Creates a new numeric index for the specified storage.
+         * Executes within a context for logging and validation, ensuring the storage name is valid.
+         * The numeric index is determined based on the current number of items in the storage.
+         *
+         * @param {StorageName} storageName - The name of the storage for which to create the numeric index.
+         * @returns {Promise<number>} A promise resolving to the newly created numeric index.
+         * @throws {Error} If storage validation fails or the shared storage service encounters an error.
+         */
+        this.createNumericIndex = beginContext(async (storageName) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
+                swarm$1.loggerService.log(METHOD_NAME_CREATE_NUMERIC_INDEX, {
+                    storageName,
+                });
+            swarm$1.storageValidationService.validate(storageName, METHOD_NAME_CREATE_NUMERIC_INDEX);
+            const { length } = await swarm$1.sharedStoragePublicService.list(METHOD_NAME_CREATE_NUMERIC_INDEX, storageName);
+            return length + 1;
+        });
         /**
          * Clears all items from the storage.
          * Executes within a context for logging and validation, ensuring the storage name is valid.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-swarm-kit",
-  "version": "1.0.214",
+  "version": "1.0.216",
   "description": "A TypeScript library for building orchestrated framework-agnostic multi-agent AI systems",
   "author": {
     "name": "Petr Tripolsky",
@@ -46,6 +46,7 @@
     "docs:www": "rimraf docs/wwwroot && typedoc && node ./packages/typedoc-yandex-metrica/index.mjs",
     "docs:demo:win": ".\\scripts\\win\\build_demo_docs.bat",
     "docs:demo": "sh ./scripts/linux/build_demo_docs.sh",
+    "docs:demo:concat": "node ./packages/concat-demo-docs/index.mjs",
     "repl": "dotenv -e .env -- npm run build && node -e \"import('./scripts/repl.mjs')\" --interactive"
   },
   "main": "build/index.cjs",

package/types.d.ts

@@ -11054,6 +11054,23 @@ declare class StorageUtils implements TStorage {
         storageName: StorageName;
         filter?: (item: T) => boolean;
     }) => Promise<T[]>;
+    /**
+     * Creates a numeric index for the storage of a given client and agent.
+     * Validates the storage name and agent-storage registration before calculating the index.
+     * Executes within a context for logging.
+     * The numeric index is determined based on the current number of items in the storage.
+     * @param {Object} payload - The payload containing client, agent, and storage details.
+     * @param {string} payload.clientId - The ID of the client whose storage is being indexed.
+     * @param {AgentName} payload.agentName - The name of the agent associated with the storage.
+     * @param {StorageName} payload.storageName - The name of the storage to index.
+     * @returns {Promise<number>} A promise resolving to the next numeric index for the storage.
+     * @throws {Error} If storage validation fails, the storage is not registered in the agent, or the storage service encounters an error.
+     */
+    createNumericIndex: (payload: {
+        clientId: string;
+        agentName: AgentName;
+        storageName: StorageName;
+    }) => Promise<number>;
     /**
      * Clears all items from the storage for a given client and agent.
      * Validates the storage name and agent-storage registration before clearing via the storage service.
@@ -11147,6 +11164,16 @@ declare class SharedStorageUtils implements TSharedStorage {
      * @throws {Error} If storage validation fails or the shared storage service encounters an error.
      */
     list: <T extends IStorageData = IStorageData>(storageName: StorageName, filter?: (item: T) => boolean) => Promise<T[]>;
+    /**
+     * Creates a new numeric index for the specified storage.
+     * Executes within a context for logging and validation, ensuring the storage name is valid.
+     * The numeric index is determined based on the current number of items in the storage.
+     *
+     * @param {StorageName} storageName - The name of the storage for which to create the numeric index.
+     * @returns {Promise<number>} A promise resolving to the newly created numeric index.
+     * @throws {Error} If storage validation fails or the shared storage service encounters an error.
+     */
+    createNumericIndex: (storageName: string) => Promise<number>;
     /**
      * Clears all items from the storage.
      * Executes within a context for logging and validation, ensuring the storage name is valid.