agent-swarm-kit 2.0.0 → 2.1.0

package/build/index.cjs

@@ -677,7 +677,7 @@ class PersistBase {
      * Creates a new `PersistBase` instance for managing persistent storage of entities.
      * Sets up the storage directory based on the entity name (e.g., `SwarmName` for swarm-specific data) and base directory.
      */
-    constructor(entityName, baseDir = path.join(process.cwd(), "logs/data")) {
+    constructor(entityName, baseDir = path.join(process.cwd(), "dump/agent")) {
         this.entityName = entityName;
         this.baseDir = baseDir;
         /**
@@ -1048,7 +1048,7 @@ class PersistSwarmUtils {
          */
         this.getActiveAgentStorage = functoolsKit.memoize(([swarmName]) => `${swarmName}`, (swarmName) => Reflect.construct(this.PersistActiveAgentFactory, [
             swarmName,
-            `./logs/data/swarm/active_agent/`,
+            `./dump/agent/swarm/active_agent/`,
         ]));
         /**
          * Memoized function to create or retrieve storage for navigation stacks.
@@ -1057,7 +1057,7 @@ class PersistSwarmUtils {
          */
         this.getNavigationStackStorage = functoolsKit.memoize(([swarmName]) => `${swarmName}`, (swarmName) => Reflect.construct(this.PersistNavigationStackFactory, [
             swarmName,
-            `./logs/data/swarm/navigation_stack/`,
+            `./dump/agent/swarm/navigation_stack/`,
         ]));
         /**
          * Retrieves the active agent for a client within a swarm, falling back to a default if not set.
@@ -1177,7 +1177,7 @@ class PersistStateUtils {
          */
         this.getStateStorage = functoolsKit.memoize(([stateName]) => `${stateName}`, (stateName) => Reflect.construct(this.PersistStateFactory, [
             stateName,
-            `./logs/data/state/`,
+            `./dump/agent/state/`,
         ]));
         /**
          * Sets the state for a client under a specific state name, persisting it for future retrieval.
@@ -1253,7 +1253,7 @@ class PersistStorageUtils {
          */
         this.getPersistStorage = functoolsKit.memoize(([storageName]) => `${storageName}`, (storageName) => Reflect.construct(this.PersistStorageFactory, [
             storageName,
-            `./logs/data/storage/`,
+            `./dump/agent/storage/`,
         ]));
         /**
          * Retrieves the data for a client from a specific storage, falling back to a default if unset.
@@ -1329,7 +1329,7 @@ class PersistMemoryUtils {
          */
         this.getMemoryStorage = functoolsKit.memoize(([clientId]) => `${clientId}`, (clientId) => Reflect.construct(this.PersistMemoryFactory, [
             clientId,
-            `./logs/data/memory/`,
+            `./dump/agent/memory/`,
         ]));
         /**
          * Sets the memory data for a client, persisting it for future retrieval.
@@ -1424,7 +1424,7 @@ class PersistAliveUtils {
          */
         this.getAliveStorage = functoolsKit.memoize(([swarmName]) => `${swarmName}`, (swarmName) => Reflect.construct(this.PersistAliveFactory, [
             swarmName,
-            `./logs/data/alive/`,
+            `./dump/agent/alive/`,
         ]));
         /**
          * Marks a client as online, persisting the status for future retrieval.
@@ -1511,7 +1511,7 @@ class PersistPolicyUtils {
          */
         this.getPolicyStorage = functoolsKit.memoize(([swarmName]) => `${swarmName}`, (swarmName) => Reflect.construct(this.PersistPolicyFactory, [
             swarmName,
-            `./logs/data/policy/`,
+            `./dump/agent/policy/`,
         ]));
         /**
          * Retrieves the list of banned clients for a specific policy, defaulting to an empty array if unset.
@@ -1579,7 +1579,7 @@ class PersistEmbeddingUtils {
          */
         this.getEmbeddingStorage = functoolsKit.memoize(([embeddingName]) => `${embeddingName}`, (embeddingName) => Reflect.construct(this.PersistEmbeddingFactory, [
             embeddingName,
-            `./logs/data/embedding/`,
+            `./dump/agent/embedding/`,
         ]));
         /**
          * Retrieves the embedding vector for a specific string hash, returning null if not found.
@@ -1735,7 +1735,7 @@ class HistoryPersistInstance {
             swarm$1.loggerService.debug(HISTORY_PERSIST_INSTANCE_METHOD_NAME_CTOR, {
                 clientId: this.clientId,
             });
-        this._persistStorage = new PersistList(this.clientId, `./logs/data/history`);
+        this._persistStorage = new PersistList(this.clientId, `./dump/agent/history`);
         if (callbacks.onInit) {
             callbacks.onInit(clientId);
         }
@@ -12935,9 +12935,9 @@ class DocService {
         /**
          * Dumps system-wide performance data to a JSON file using PerfService.toRecord.
          * Ensures the output directory exists, then writes a timestamped file, logging the process if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
-         * Outputs to dirName/[momentStamp].[timeStamp].json (default: "logs/meta"), providing a snapshot of system performance (e.g., tied to ClientAgent executions).
+         * Outputs to dirName/[momentStamp].[timeStamp].json (default: "dump/agent/meta"), providing a snapshot of system performance (e.g., tied to ClientAgent executions).
          */
-        this.dumpPerfomance = async (dirName = path.join(process.cwd(), "logs/meta")) => {
+        this.dumpPerfomance = async (dirName = path.join(process.cwd(), "dump/agent/meta")) => {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
                 this.loggerService.info("docService dumpPerfomance", {
                     dirName,
@@ -12950,9 +12950,9 @@ class DocService {
         /**
          * Dumps performance data for a specific client to a JSON file using PerfService.toClientRecord.
          * Ensures the output directory exists, then writes a client-specific timestamped file, logging the process if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
-         * Outputs to dirName/[clientId].[momentStamp].json (default: "logs/client"), documenting client-specific metrics (e.g., ClientAgent session performance).
+         * Outputs to dirName/[clientId].[momentStamp].json (default: "dump/agent/client"), documenting client-specific metrics (e.g., ClientAgent session performance).
          */
-        this.dumpClientPerfomance = async (clientId, dirName = path.join(process.cwd(), "logs/client")) => {
+        this.dumpClientPerfomance = async (clientId, dirName = path.join(process.cwd(), "dump/agent/client")) => {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
                 this.loggerService.info("docService dumpPerfomance", {
                     dirName,
@@ -17182,7 +17182,7 @@ const METHOD_NAME_INTERVAL = "cli.dumpPerfomance.interval";
 /**
  * The internal HOF for handling the performance dump
 */
-const dumpPerfomanceInternal = beginContext(async (dirName = "./logs/meta") => {
+const dumpPerfomanceInternal = beginContext(async (dirName = "./dump/agent/meta") => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME_INTERNAL$1);
     return await swarm$1.docService.dumpPerfomance(dirName);
@@ -17192,7 +17192,7 @@ const dumpPerfomanceInternal = beginContext(async (dirName = "./logs/meta") => {
  * Logs the method name if logging is enabled in the global configuration.
  *
 */
-const dumpPerfomance = async (dirName = "./logs/meta") => {
+const dumpPerfomance = async (dirName = "./dump/agent/meta") => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG && swarm$1.loggerService.log(METHOD_NAME$1B);
     await dumpPerfomanceInternal(dirName);
 };
@@ -17201,7 +17201,7 @@ const dumpPerfomance = async (dirName = "./logs/meta") => {
  * Logs the method name if logging is enabled in the global configuration.
  *
 */
-dumpPerfomance.runInterval = beginContext((dirName = "./logs/meta", interval = 30000) => {
+dumpPerfomance.runInterval = beginContext((dirName = "./dump/agent/meta", interval = 30000) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME_INTERVAL);
     return functoolsKit.Source.fromInterval(interval).connect(() => dumpPerfomance(dirName));
@@ -17252,7 +17252,7 @@ const METHOD_NAME_EXECUTE = "cli.dumpClientPerformance.execute";
  * The internal HOF for handling the performance dump
  *
 */
-const dumpClientPerformanceInternal = beginContext(async (clientId, dirName = "./logs/client") => {
+const dumpClientPerformanceInternal = beginContext(async (clientId, dirName = "./dump/agent/client") => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME_INTERNAL);
     return await swarm$1.docService.dumpClientPerfomance(clientId, dirName);
@@ -17262,7 +17262,7 @@ const dumpClientPerformanceInternal = beginContext(async (clientId, dirName = ".
  * Logs the method name if logging is enabled in the global configuration.
  *
 */
-const dumpClientPerformance = async (clientId, dirName = "./logs/client") => {
+const dumpClientPerformance = async (clientId, dirName = "./dump/agent/client") => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG && swarm$1.loggerService.log(METHOD_NAME$1A);
     await dumpClientPerformanceInternal(clientId, dirName);
 };
@@ -17271,7 +17271,7 @@ const dumpClientPerformance = async (clientId, dirName = "./logs/client") => {
  * Logs the method name if logging is enabled in the global configuration.
  *
 */
-dumpClientPerformance.runAfterExecute = beginContext(async (dirName = "./logs/client") => {
+dumpClientPerformance.runAfterExecute = beginContext(async (dirName = "./dump/agent/client") => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME_EXECUTE);
     return listenExecutionEvent("*", async ({ type, clientId }) => {

package/build/index.mjs

@@ -657,7 +657,7 @@ class PersistBase {
      * Creates a new `PersistBase` instance for managing persistent storage of entities.
      * Sets up the storage directory based on the entity name (e.g., `SwarmName` for swarm-specific data) and base directory.
      */
-    constructor(entityName, baseDir = join(process.cwd(), "logs/data")) {
+    constructor(entityName, baseDir = join(process.cwd(), "dump/agent")) {
         this.entityName = entityName;
         this.baseDir = baseDir;
         /**
@@ -1028,7 +1028,7 @@ class PersistSwarmUtils {
          */
         this.getActiveAgentStorage = memoize(([swarmName]) => `${swarmName}`, (swarmName) => Reflect.construct(this.PersistActiveAgentFactory, [
             swarmName,
-            `./logs/data/swarm/active_agent/`,
+            `./dump/agent/swarm/active_agent/`,
         ]));
         /**
          * Memoized function to create or retrieve storage for navigation stacks.
@@ -1037,7 +1037,7 @@ class PersistSwarmUtils {
          */
         this.getNavigationStackStorage = memoize(([swarmName]) => `${swarmName}`, (swarmName) => Reflect.construct(this.PersistNavigationStackFactory, [
             swarmName,
-            `./logs/data/swarm/navigation_stack/`,
+            `./dump/agent/swarm/navigation_stack/`,
         ]));
         /**
          * Retrieves the active agent for a client within a swarm, falling back to a default if not set.
@@ -1157,7 +1157,7 @@ class PersistStateUtils {
          */
         this.getStateStorage = memoize(([stateName]) => `${stateName}`, (stateName) => Reflect.construct(this.PersistStateFactory, [
             stateName,
-            `./logs/data/state/`,
+            `./dump/agent/state/`,
         ]));
         /**
          * Sets the state for a client under a specific state name, persisting it for future retrieval.
@@ -1233,7 +1233,7 @@ class PersistStorageUtils {
          */
         this.getPersistStorage = memoize(([storageName]) => `${storageName}`, (storageName) => Reflect.construct(this.PersistStorageFactory, [
             storageName,
-            `./logs/data/storage/`,
+            `./dump/agent/storage/`,
         ]));
         /**
          * Retrieves the data for a client from a specific storage, falling back to a default if unset.
@@ -1309,7 +1309,7 @@ class PersistMemoryUtils {
          */
         this.getMemoryStorage = memoize(([clientId]) => `${clientId}`, (clientId) => Reflect.construct(this.PersistMemoryFactory, [
             clientId,
-            `./logs/data/memory/`,
+            `./dump/agent/memory/`,
         ]));
         /**
          * Sets the memory data for a client, persisting it for future retrieval.
@@ -1404,7 +1404,7 @@ class PersistAliveUtils {
          */
         this.getAliveStorage = memoize(([swarmName]) => `${swarmName}`, (swarmName) => Reflect.construct(this.PersistAliveFactory, [
             swarmName,
-            `./logs/data/alive/`,
+            `./dump/agent/alive/`,
         ]));
         /**
          * Marks a client as online, persisting the status for future retrieval.
@@ -1491,7 +1491,7 @@ class PersistPolicyUtils {
          */
         this.getPolicyStorage = memoize(([swarmName]) => `${swarmName}`, (swarmName) => Reflect.construct(this.PersistPolicyFactory, [
             swarmName,
-            `./logs/data/policy/`,
+            `./dump/agent/policy/`,
         ]));
         /**
          * Retrieves the list of banned clients for a specific policy, defaulting to an empty array if unset.
@@ -1559,7 +1559,7 @@ class PersistEmbeddingUtils {
          */
         this.getEmbeddingStorage = memoize(([embeddingName]) => `${embeddingName}`, (embeddingName) => Reflect.construct(this.PersistEmbeddingFactory, [
             embeddingName,
-            `./logs/data/embedding/`,
+            `./dump/agent/embedding/`,
         ]));
         /**
          * Retrieves the embedding vector for a specific string hash, returning null if not found.
@@ -1715,7 +1715,7 @@ class HistoryPersistInstance {
             swarm$1.loggerService.debug(HISTORY_PERSIST_INSTANCE_METHOD_NAME_CTOR, {
                 clientId: this.clientId,
             });
-        this._persistStorage = new PersistList(this.clientId, `./logs/data/history`);
+        this._persistStorage = new PersistList(this.clientId, `./dump/agent/history`);
         if (callbacks.onInit) {
             callbacks.onInit(clientId);
         }
@@ -12915,9 +12915,9 @@ class DocService {
         /**
          * Dumps system-wide performance data to a JSON file using PerfService.toRecord.
          * Ensures the output directory exists, then writes a timestamped file, logging the process if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
-         * Outputs to dirName/[momentStamp].[timeStamp].json (default: "logs/meta"), providing a snapshot of system performance (e.g., tied to ClientAgent executions).
+         * Outputs to dirName/[momentStamp].[timeStamp].json (default: "dump/agent/meta"), providing a snapshot of system performance (e.g., tied to ClientAgent executions).
          */
-        this.dumpPerfomance = async (dirName = join(process.cwd(), "logs/meta")) => {
+        this.dumpPerfomance = async (dirName = join(process.cwd(), "dump/agent/meta")) => {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
                 this.loggerService.info("docService dumpPerfomance", {
                     dirName,
@@ -12930,9 +12930,9 @@ class DocService {
         /**
          * Dumps performance data for a specific client to a JSON file using PerfService.toClientRecord.
          * Ensures the output directory exists, then writes a client-specific timestamped file, logging the process if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
-         * Outputs to dirName/[clientId].[momentStamp].json (default: "logs/client"), documenting client-specific metrics (e.g., ClientAgent session performance).
+         * Outputs to dirName/[clientId].[momentStamp].json (default: "dump/agent/client"), documenting client-specific metrics (e.g., ClientAgent session performance).
          */
-        this.dumpClientPerfomance = async (clientId, dirName = join(process.cwd(), "logs/client")) => {
+        this.dumpClientPerfomance = async (clientId, dirName = join(process.cwd(), "dump/agent/client")) => {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
                 this.loggerService.info("docService dumpPerfomance", {
                     dirName,
@@ -17162,7 +17162,7 @@ const METHOD_NAME_INTERVAL = "cli.dumpPerfomance.interval";
 /**
  * The internal HOF for handling the performance dump
 */
-const dumpPerfomanceInternal = beginContext(async (dirName = "./logs/meta") => {
+const dumpPerfomanceInternal = beginContext(async (dirName = "./dump/agent/meta") => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME_INTERNAL$1);
     return await swarm$1.docService.dumpPerfomance(dirName);
@@ -17172,7 +17172,7 @@ const dumpPerfomanceInternal = beginContext(async (dirName = "./logs/meta") => {
  * Logs the method name if logging is enabled in the global configuration.
  *
 */
-const dumpPerfomance = async (dirName = "./logs/meta") => {
+const dumpPerfomance = async (dirName = "./dump/agent/meta") => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG && swarm$1.loggerService.log(METHOD_NAME$1B);
     await dumpPerfomanceInternal(dirName);
 };
@@ -17181,7 +17181,7 @@ const dumpPerfomance = async (dirName = "./logs/meta") => {
  * Logs the method name if logging is enabled in the global configuration.
  *
 */
-dumpPerfomance.runInterval = beginContext((dirName = "./logs/meta", interval = 30000) => {
+dumpPerfomance.runInterval = beginContext((dirName = "./dump/agent/meta", interval = 30000) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME_INTERVAL);
     return Source.fromInterval(interval).connect(() => dumpPerfomance(dirName));
@@ -17232,7 +17232,7 @@ const METHOD_NAME_EXECUTE = "cli.dumpClientPerformance.execute";
  * The internal HOF for handling the performance dump
  *
 */
-const dumpClientPerformanceInternal = beginContext(async (clientId, dirName = "./logs/client") => {
+const dumpClientPerformanceInternal = beginContext(async (clientId, dirName = "./dump/agent/client") => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME_INTERNAL);
     return await swarm$1.docService.dumpClientPerfomance(clientId, dirName);
@@ -17242,7 +17242,7 @@ const dumpClientPerformanceInternal = beginContext(async (clientId, dirName = ".
  * Logs the method name if logging is enabled in the global configuration.
  *
 */
-const dumpClientPerformance = async (clientId, dirName = "./logs/client") => {
+const dumpClientPerformance = async (clientId, dirName = "./dump/agent/client") => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG && swarm$1.loggerService.log(METHOD_NAME$1A);
     await dumpClientPerformanceInternal(clientId, dirName);
 };
@@ -17251,7 +17251,7 @@ const dumpClientPerformance = async (clientId, dirName = "./logs/client") => {
  * Logs the method name if logging is enabled in the global configuration.
  *
 */
-dumpClientPerformance.runAfterExecute = beginContext(async (dirName = "./logs/client") => {
+dumpClientPerformance.runAfterExecute = beginContext(async (dirName = "./dump/agent/client") => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME_EXECUTE);
     return listenExecutionEvent("*", async ({ type, clientId }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-swarm-kit",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "A TypeScript library for building orchestrated framework-agnostic multi-agent AI systems",
   "author": {
     "name": "Petr Tripolsky",
@@ -73,7 +73,7 @@
     "tslib": "2.7.0",
     "typedoc": "0.27.9",
     "undici": "6.21.2",
-    "worker-testbed": "1.0.12"
+    "worker-testbed": "2.0.0"
   },
   "peerDependencies": {
     "typescript": "^5.0.0"

package/types.d.ts

@@ -1501,7 +1501,7 @@ type TPersistBaseCtor<EntityName extends string = string, Entity extends IEntity
 declare class PersistBase<EntityName extends string = string> implements IPersistBase {
     readonly entityName: EntityName;
     readonly baseDir: string;
-    /** @private The directory path where entity files are stored (e.g., `./logs/data/alive/` for alive status)*/
+    /** @private The directory path where entity files are stored (e.g., `./dump/agent/alive/` for alive status)*/
     _directory: string;
     /**
      * Creates a new `PersistBase` instance for managing persistent storage of entities.
@@ -7011,13 +7011,13 @@ declare class DocService {
     /**
      * Dumps system-wide performance data to a JSON file using PerfService.toRecord.
      * Ensures the output directory exists, then writes a timestamped file, logging the process if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
-     * Outputs to dirName/[momentStamp].[timeStamp].json (default: "logs/meta"), providing a snapshot of system performance (e.g., tied to ClientAgent executions).
+     * Outputs to dirName/[momentStamp].[timeStamp].json (default: "dump/agent/meta"), providing a snapshot of system performance (e.g., tied to ClientAgent executions).
      */
     dumpPerfomance: (dirName?: string) => Promise<void>;
     /**
      * Dumps performance data for a specific client to a JSON file using PerfService.toClientRecord.
      * Ensures the output directory exists, then writes a client-specific timestamped file, logging the process if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
-     * Outputs to dirName/[clientId].[momentStamp].json (default: "logs/client"), documenting client-specific metrics (e.g., ClientAgent session performance).
+     * Outputs to dirName/[clientId].[momentStamp].json (default: "dump/agent/client"), documenting client-specific metrics (e.g., ClientAgent session performance).
      */
     dumpClientPerfomance: (clientId: string, dirName?: string) => Promise<void>;
 }