agent-swarm-kit 1.0.225 → 1.0.227

package/build/index.cjs

@@ -2936,6 +2936,23 @@ const NOOP_LOGGER = {
     info() {
     },
 };
+/**
+ * A scoped context class for client-specific logging.
+ * Provides a structured context containing method and execution-level metadata,
+ * enabling traceability and context-aware logging for client-specific operations.
+ *
+ * This class is used to encapsulate and manage the logging context for a specific client,
+ * ensuring that logs are enriched with relevant contextual information such as method and execution contexts.
+ *
+ * @param {Object} context - The logging context object.
+ * @param {IMethodContext} context.methodContext - The method-level context, typically containing metadata like clientId.
+ * @param {IExecutionContext} context.executionContext - The execution-level context, typically containing metadata like clientId.
+ */
+const ClientLoggerContext = diScoped.scoped(class {
+    constructor(context) {
+        this.context = context;
+    }
+});
 /**
  * Service class implementing the ILogger interface to provide logging functionality in the swarm system.
  * Handles log, debug, and info messages with context awareness using MethodContextService and ExecutionContextService, routing logs to both a client-specific logger (via GLOBAL_CONFIG.CC_GET_CLIENT_LOGGER_ADAPTER) and a common logger.
@@ -2980,7 +2997,10 @@ class LoggerService {
          * @param {...any[]} args - The message content and optional additional data (e.g., objects, strings).
          * @returns {void}
          */
-        this.log = (topic, ...args) => {
+        this.log = async (topic, ...args) => {
+            if (ClientLoggerContext.hasContext()) {
+                return;
+            }
             const methodContext = MethodContextService.hasContext()
                 ? this.methodContextService.context
                 : null;
@@ -2992,8 +3012,12 @@ class LoggerService {
                 methodContext,
                 executionContext,
             };
-            clientId && this.getLoggerAdapter().log(clientId, topic, ...args, context);
-            this._commonLogger.log(topic, ...args, context);
+            return await ClientLoggerContext.runInContext(async () => {
+                if (clientId) {
+                    await this.getLoggerAdapter().log(clientId, topic, ...args, context);
+                }
+                await this._commonLogger.log(topic, ...args, context);
+            }, context);
         };
         /**
          * Logs messages at the debug level, routing to both the client-specific logger (if clientId exists) and the common logger.
@@ -3002,7 +3026,10 @@ class LoggerService {
          * @param {...any[]} args - The debug content and optional additional data (e.g., objects, strings).
          * @returns {void}
          */
-        this.debug = (topic, ...args) => {
+        this.debug = async (topic, ...args) => {
+            if (ClientLoggerContext.hasContext()) {
+                return;
+            }
             const methodContext = MethodContextService.hasContext()
                 ? this.methodContextService.context
                 : null;
@@ -3014,9 +3041,12 @@ class LoggerService {
                 methodContext,
                 executionContext,
             };
-            clientId &&
-                this.getLoggerAdapter().debug(clientId, topic, ...args, context);
-            this._commonLogger.debug(topic, ...args, context);
+            return await ClientLoggerContext.runInContext(async () => {
+                if (clientId) {
+                    await this.getLoggerAdapter().debug(clientId, topic, ...args, context);
+                }
+                await this._commonLogger.debug(topic, ...args, context);
+            }, context);
         };
         /**
          * Logs messages at the info level, routing to both the client-specific logger (if clientId exists) and the common logger.
@@ -3025,7 +3055,10 @@ class LoggerService {
          * @param {...any[]} args - The info content and optional additional data (e.g., objects, strings).
          * @returns {void}
          */
-        this.info = (topic, ...args) => {
+        this.info = async (topic, ...args) => {
+            if (ClientLoggerContext.hasContext()) {
+                return;
+            }
             const methodContext = MethodContextService.hasContext()
                 ? this.methodContextService.context
                 : null;
@@ -3037,8 +3070,12 @@ class LoggerService {
                 methodContext,
                 executionContext,
             };
-            clientId && this.getLoggerAdapter().info(clientId, topic, ...args, context);
-            this._commonLogger.info(topic, ...args, context);
+            return await ClientLoggerContext.runInContext(async () => {
+                if (clientId) {
+                    await this.getLoggerAdapter().info(clientId, topic, ...args, context);
+                }
+                await this._commonLogger.info(topic, ...args, context);
+            }, context);
         };
         /**
          * Sets a new common logger instance, replacing the default NOOP_LOGGER or previous logger.
@@ -7859,7 +7896,7 @@ class AgentValidationService {
             });
             agent.wikiList?.forEach((wikiName) => {
                 if (typeof wikiName !== "string") {
-                    throw new Error(`agent-swarm agent ${agentName} storage list is invalid (wikiName=${String(wikiName)}) source=${source}`);
+                    throw new Error(`agent-swarm agent ${agentName} wiki list is invalid (wikiName=${String(wikiName)}) source=${source}`);
                 }
                 this.wikiValidationService.validate(wikiName, source);
             });

package/build/index.mjs

@@ -2934,6 +2934,23 @@ const NOOP_LOGGER = {
     info() {
     },
 };
+/**
+ * A scoped context class for client-specific logging.
+ * Provides a structured context containing method and execution-level metadata,
+ * enabling traceability and context-aware logging for client-specific operations.
+ *
+ * This class is used to encapsulate and manage the logging context for a specific client,
+ * ensuring that logs are enriched with relevant contextual information such as method and execution contexts.
+ *
+ * @param {Object} context - The logging context object.
+ * @param {IMethodContext} context.methodContext - The method-level context, typically containing metadata like clientId.
+ * @param {IExecutionContext} context.executionContext - The execution-level context, typically containing metadata like clientId.
+ */
+const ClientLoggerContext = scoped(class {
+    constructor(context) {
+        this.context = context;
+    }
+});
 /**
  * Service class implementing the ILogger interface to provide logging functionality in the swarm system.
  * Handles log, debug, and info messages with context awareness using MethodContextService and ExecutionContextService, routing logs to both a client-specific logger (via GLOBAL_CONFIG.CC_GET_CLIENT_LOGGER_ADAPTER) and a common logger.
@@ -2978,7 +2995,10 @@ class LoggerService {
          * @param {...any[]} args - The message content and optional additional data (e.g., objects, strings).
          * @returns {void}
          */
-        this.log = (topic, ...args) => {
+        this.log = async (topic, ...args) => {
+            if (ClientLoggerContext.hasContext()) {
+                return;
+            }
             const methodContext = MethodContextService.hasContext()
                 ? this.methodContextService.context
                 : null;
@@ -2990,8 +3010,12 @@ class LoggerService {
                 methodContext,
                 executionContext,
             };
-            clientId && this.getLoggerAdapter().log(clientId, topic, ...args, context);
-            this._commonLogger.log(topic, ...args, context);
+            return await ClientLoggerContext.runInContext(async () => {
+                if (clientId) {
+                    await this.getLoggerAdapter().log(clientId, topic, ...args, context);
+                }
+                await this._commonLogger.log(topic, ...args, context);
+            }, context);
         };
         /**
          * Logs messages at the debug level, routing to both the client-specific logger (if clientId exists) and the common logger.
@@ -3000,7 +3024,10 @@ class LoggerService {
          * @param {...any[]} args - The debug content and optional additional data (e.g., objects, strings).
          * @returns {void}
          */
-        this.debug = (topic, ...args) => {
+        this.debug = async (topic, ...args) => {
+            if (ClientLoggerContext.hasContext()) {
+                return;
+            }
             const methodContext = MethodContextService.hasContext()
                 ? this.methodContextService.context
                 : null;
@@ -3012,9 +3039,12 @@ class LoggerService {
                 methodContext,
                 executionContext,
             };
-            clientId &&
-                this.getLoggerAdapter().debug(clientId, topic, ...args, context);
-            this._commonLogger.debug(topic, ...args, context);
+            return await ClientLoggerContext.runInContext(async () => {
+                if (clientId) {
+                    await this.getLoggerAdapter().debug(clientId, topic, ...args, context);
+                }
+                await this._commonLogger.debug(topic, ...args, context);
+            }, context);
         };
         /**
          * Logs messages at the info level, routing to both the client-specific logger (if clientId exists) and the common logger.
@@ -3023,7 +3053,10 @@ class LoggerService {
          * @param {...any[]} args - The info content and optional additional data (e.g., objects, strings).
          * @returns {void}
          */
-        this.info = (topic, ...args) => {
+        this.info = async (topic, ...args) => {
+            if (ClientLoggerContext.hasContext()) {
+                return;
+            }
             const methodContext = MethodContextService.hasContext()
                 ? this.methodContextService.context
                 : null;
@@ -3035,8 +3068,12 @@ class LoggerService {
                 methodContext,
                 executionContext,
             };
-            clientId && this.getLoggerAdapter().info(clientId, topic, ...args, context);
-            this._commonLogger.info(topic, ...args, context);
+            return await ClientLoggerContext.runInContext(async () => {
+                if (clientId) {
+                    await this.getLoggerAdapter().info(clientId, topic, ...args, context);
+                }
+                await this._commonLogger.info(topic, ...args, context);
+            }, context);
         };
         /**
          * Sets a new common logger instance, replacing the default NOOP_LOGGER or previous logger.
@@ -7857,7 +7894,7 @@ class AgentValidationService {
             });
             agent.wikiList?.forEach((wikiName) => {
                 if (typeof wikiName !== "string") {
-                    throw new Error(`agent-swarm agent ${agentName} storage list is invalid (wikiName=${String(wikiName)}) source=${source}`);
+                    throw new Error(`agent-swarm agent ${agentName} wiki list is invalid (wikiName=${String(wikiName)}) source=${source}`);
                 }
                 this.wikiValidationService.validate(wikiName, source);
             });

package/package.json

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

package/types.d.ts

@@ -3449,7 +3449,7 @@ declare class LoggerService implements ILogger {
      * @param {...any[]} args - The message content and optional additional data (e.g., objects, strings).
      * @returns {void}
      */
-    log: (topic: string, ...args: any[]) => void;
+    log: (topic: string, ...args: any[]) => Promise<void>;
     /**
      * Logs messages at the debug level, routing to both the client-specific logger (if clientId exists) and the common logger.
      * Attaches method and execution context for detailed debugging, heavily used in ClientAgent (e.g., RUN_FN, EXECUTE_FN) when GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG is true.
@@ -3457,7 +3457,7 @@ declare class LoggerService implements ILogger {
      * @param {...any[]} args - The debug content and optional additional data (e.g., objects, strings).
      * @returns {void}
      */
-    debug: (topic: string, ...args: any[]) => void;
+    debug: (topic: string, ...args: any[]) => Promise<void>;
     /**
      * Logs messages at the info level, routing to both the client-specific logger (if clientId exists) and the common logger.
      * Attaches method and execution context for informational tracking, used in PerfService (e.g., startExecution) and DocService (e.g., dumpDocs) when GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
@@ -3465,7 +3465,7 @@ declare class LoggerService implements ILogger {
      * @param {...any[]} args - The info content and optional additional data (e.g., objects, strings).
      * @returns {void}
      */
-    info: (topic: string, ...args: any[]) => void;
+    info: (topic: string, ...args: any[]) => Promise<void>;
     /**
      * Sets a new common logger instance, replacing the default NOOP_LOGGER or previous logger.
      * Allows runtime customization of system-wide logging behavior, potentially used in testing or advanced configurations (e.g., redirecting logs to a file or console).