agent-swarm-kit 1.0.215 → 1.0.217

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 = "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, {
+                    clientId: payload.clientId,
+                    storageName: payload.storageName,
+                });
+            swarm$1.storageValidationService.validate(payload.storageName, METHOD_NAME_CREATE_NUMERIC_INDEX);
+            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, 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.

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 = "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, {
+                    clientId: payload.clientId,
+                    storageName: payload.storageName,
+                });
+            swarm$1.storageValidationService.validate(payload.storageName, METHOD_NAME_CREATE_NUMERIC_INDEX);
+            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, 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.

package/package.json

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

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.