@agentxjs/common 0.1.0 → 1.1.3

package/README.md

@@ -0,0 +1,293 @@
+# @agentxjs/common
+
+> Shared infrastructure for AgentX internal packages
+
+## Overview
+
+`@agentxjs/common` provides shared utilities used by AgentX internal packages (`@agentxjs/agent`, `@agentxjs/runtime`, etc.). This is an internal package - application code should not depend on it directly.
+
+**Key Features:**
+
+- **Logger Facade** - Lazy-initialized logging with pluggable backends
+- **Zero Runtime Overhead** - Safe to use at module level
+- **Pluggable Architecture** - Custom loggers via Runtime injection
+
+## Installation
+
+```bash
+pnpm add @agentxjs/common
+```
+
+> **Note**: This package is typically installed transitively as a dependency of other AgentX packages.
+
+---
+
+## Logger
+
+### Quick Start
+
+```typescript
+import { createLogger } from "@agentxjs/common";
+
+// Safe to use at module level (before Runtime configured)
+const logger = createLogger("agent/AgentEngine");
+
+// Later, at runtime
+logger.info("Agent created", { agentId: "agent_123" });
+logger.debug("Processing message", { messageId: "msg_456" });
+logger.error("Failed to process", { error: err.message });
+```
+
+### Features
+
+#### 1. Lazy Initialization
+
+Loggers can be created at module level without errors:
+
+```typescript
+// At module level (before Runtime exists)
+const logger = createLogger("engine/MealyMachine");
+
+// No-op until LoggerFactory is configured
+logger.info("This is buffered");
+
+// Later, when Runtime initializes
+setLoggerFactory(new LoggerFactoryImpl());
+
+// Now logs are emitted
+logger.info("This is logged");
+```
+
+#### 2. Structured Logging
+
+All loggers support structured context:
+
+```typescript
+logger.info("User logged in", {
+  userId: "user_123",
+  timestamp: Date.now(),
+  ip: "192.168.1.1",
+});
+
+// Output (with ConsoleLogger):
+// [INFO] agent/UserService: User logged in {"userId":"user_123",...}
+```
+
+#### 3. Log Levels
+
+Supported log levels (in order of severity):
+
+```typescript
+logger.debug("Detailed debug info"); // Development only
+logger.info("Normal operation"); // General info
+logger.warn("Warning condition"); // Potential issues
+logger.error("Error occurred"); // Errors
+```
+
+### API
+
+#### `createLogger(category: string): Logger`
+
+Creates a new logger instance.
+
+```typescript
+const logger = createLogger("agent/MyAgent");
+```
+
+**Parameters:**
+
+- `category` - Logger category (e.g., `"engine/AgentEngine"`, `"runtime/Container"`)
+
+**Returns:** `Logger` instance
+
+#### `setLoggerFactory(factory: LoggerFactory): void`
+
+Sets the global logger factory (called by Runtime).
+
+```typescript
+import { LoggerFactoryImpl, setLoggerFactory } from "@agentxjs/common";
+
+setLoggerFactory(
+  new LoggerFactoryImpl({
+    level: "debug",
+    enableTimestamp: true,
+  })
+);
+```
+
+### Logger Interface
+
+```typescript
+interface Logger {
+  debug(message: string, context?: LogContext): void;
+  info(message: string, context?: LogContext): void;
+  warn(message: string, context?: LogContext): void;
+  error(message: string, context?: LogContext): void;
+}
+
+type LogContext = Record<string, unknown>;
+```
+
+---
+
+## Built-in Implementations
+
+### ConsoleLogger
+
+Default console-based logger with formatting.
+
+```typescript
+import { ConsoleLogger } from "@agentxjs/common";
+
+const logger = new ConsoleLogger("my-category", {
+  level: "debug",
+  enableTimestamp: true,
+  enableColor: true,
+});
+
+logger.info("Hello", { foo: "bar" });
+// Output: [INFO] my-category: Hello {"foo":"bar"}
+```
+
+**Options:**
+
+```typescript
+interface ConsoleLoggerOptions {
+  level?: LogLevel; // Minimum log level (default: "info")
+  enableTimestamp?: boolean; // Show timestamps (default: false)
+  enableColor?: boolean; // Colorize output (default: true in TTY)
+}
+```
+
+### LoggerFactoryImpl
+
+Default factory that creates `ConsoleLogger` instances.
+
+```typescript
+import { LoggerFactoryImpl } from "@agentxjs/common";
+
+const factory = new LoggerFactoryImpl({
+  level: "info",
+  enableTimestamp: false,
+});
+
+const logger = factory.createLogger("test");
+```
+
+---
+
+## Custom Logger Implementation
+
+You can provide custom loggers for advanced use cases:
+
+```typescript
+import { Logger, LoggerFactory, setLoggerFactory } from "@agentxjs/common";
+
+// Custom logger (e.g., sends logs to external service)
+class RemoteLogger implements Logger {
+  constructor(private category: string) {}
+
+  debug(message: string, context?: LogContext) {
+    this.send("debug", message, context);
+  }
+
+  info(message: string, context?: LogContext) {
+    this.send("info", message, context);
+  }
+
+  warn(message: string, context?: LogContext) {
+    this.send("warn", message, context);
+  }
+
+  error(message: string, context?: LogContext) {
+    this.send("error", message, context);
+  }
+
+  private send(level: string, message: string, context?: LogContext) {
+    fetch("/api/logs", {
+      method: "POST",
+      body: JSON.stringify({ level, category: this.category, message, context }),
+    });
+  }
+}
+
+// Custom factory
+class RemoteLoggerFactory implements LoggerFactory {
+  createLogger(category: string): Logger {
+    return new RemoteLogger(category);
+  }
+}
+
+// Use custom factory
+setLoggerFactory(new RemoteLoggerFactory());
+```
+
+---
+
+## Design Decisions
+
+### Why Lazy Initialization?
+
+AgentX packages create loggers at module level:
+
+```typescript
+// engine/AgentEngine.ts
+import { createLogger } from "@agentxjs/common";
+
+const logger = createLogger("engine/AgentEngine");
+
+export class AgentEngine {
+  // ...
+}
+```
+
+If loggers required immediate factory, this would fail before Runtime initializes. Lazy initialization solves this.
+
+### Why Pluggable?
+
+Different environments need different logging:
+
+- **Development** - Console with colors
+- **Production** - Structured JSON logs
+- **Browser** - Send to analytics service
+- **Testing** - Silent or mock
+
+Runtime provides the logger factory appropriate for the environment.
+
+### Why Not Use console.log Directly?
+
+Direct `console.log` usage causes:
+
+1. **No control** - Can't disable/filter logs
+2. **No structure** - Context is hard to parse
+3. **No routing** - Can't send logs to services
+
+The logger facade solves all these issues.
+
+---
+
+## Package Dependencies
+
+```text
+@agentxjs/types     Type definitions
+       ↑
+@agentxjs/common    This package (logger facade)
+       ↑
+@agentxjs/agent     Uses logger
+       ↑
+@agentxjs/runtime   Uses logger + provides factory
+```
+
+---
+
+## Related Packages
+
+- **[@agentxjs/types](../types)** - Type definitions
+- **[@agentxjs/agent](../agent)** - Agent runtime (uses logger)
+- **[@agentxjs/runtime](../runtime)** - Runtime implementation (provides factory)
+
+---
+
+## License
+
+MIT

package/dist/index.cjs

@@ -23,16 +23,13 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 var index_exports = {};
 __export(index_exports, {
   ConsoleLogger: () => ConsoleLogger,
-  LogLevel: () => import_types3.LogLevel,
   LoggerFactoryImpl: () => LoggerFactoryImpl,
   createLogger: () => createLogger,
   setLoggerFactory: () => setLoggerFactory
 });
 module.exports = __toCommonJS(index_exports);
-var import_types3 = require("@agentxjs/types");
 
 // src/logger/ConsoleLogger.ts
-var import_types = require("@agentxjs/types");
 var _ConsoleLogger = class _ConsoleLogger {
   constructor(name, options = {}) {
     __publicField(this, "name");
@@ -40,7 +37,7 @@ var _ConsoleLogger = class _ConsoleLogger {
     __publicField(this, "colors");
     __publicField(this, "timestamps");
     this.name = name;
-    this.level = options.level ?? import_types.LogLevel.INFO;
+    this.level = options.level ?? "info";
     this.colors = options.colors ?? this.isNodeEnvironment();
     this.timestamps = options.timestamps ?? true;
   }
@@ -69,16 +66,26 @@ var _ConsoleLogger = class _ConsoleLogger {
     }
   }
   isDebugEnabled() {
-    return this.level <= import_types.LogLevel.DEBUG;
+    return this.getLevelValue(this.level) <= this.getLevelValue("debug");
   }
   isInfoEnabled() {
-    return this.level <= import_types.LogLevel.INFO;
+    return this.getLevelValue(this.level) <= this.getLevelValue("info");
   }
   isWarnEnabled() {
-    return this.level <= import_types.LogLevel.WARN;
+    return this.getLevelValue(this.level) <= this.getLevelValue("warn");
   }
   isErrorEnabled() {
-    return this.level <= import_types.LogLevel.ERROR;
+    return this.getLevelValue(this.level) <= this.getLevelValue("error");
+  }
+  getLevelValue(level) {
+    const levels = {
+      debug: 0,
+      info: 1,
+      warn: 2,
+      error: 3,
+      silent: 4
+    };
+    return levels[level];
   }
   log(level, message, context) {
     const parts = [];
@@ -129,8 +136,8 @@ __publicField(_ConsoleLogger, "COLORS", {
 var ConsoleLogger = _ConsoleLogger;
 
 // src/logger/LoggerFactoryImpl.ts
-var import_types2 = require("@agentxjs/types");
 var externalFactory = null;
+var factoryVersion = 0;
 var LoggerFactoryImpl = class {
   static getLogger(nameOrClass) {
     const name = typeof nameOrClass === "string" ? nameOrClass : nameOrClass.name;
@@ -146,20 +153,23 @@ var LoggerFactoryImpl = class {
   }
   static reset() {
     this.loggers.clear();
-    this.config = { defaultLevel: import_types2.LogLevel.INFO };
+    this.config = { defaultLevel: "info" };
     externalFactory = null;
+    factoryVersion++;
   }
   static createLazyLogger(name) {
     let realLogger = null;
+    let loggerVersion = -1;
     const getRealLogger = () => {
-      if (!realLogger) {
+      if (!realLogger || loggerVersion !== factoryVersion) {
         realLogger = this.createLogger(name);
+        loggerVersion = factoryVersion;
       }
       return realLogger;
     };
     return {
       name,
-      level: this.config.defaultLevel || import_types2.LogLevel.INFO,
+      level: this.config.defaultLevel || "info",
       debug: (message, context) => getRealLogger().debug(message, context),
       info: (message, context) => getRealLogger().info(message, context),
       warn: (message, context) => getRealLogger().warn(message, context),
@@ -185,7 +195,7 @@ var LoggerFactoryImpl = class {
 };
 __publicField(LoggerFactoryImpl, "loggers", /* @__PURE__ */ new Map());
 __publicField(LoggerFactoryImpl, "config", {
-  defaultLevel: import_types2.LogLevel.INFO
+  defaultLevel: "info"
 });
 function setLoggerFactory(factory) {
   externalFactory = factory;
@@ -198,7 +208,6 @@ function createLogger(name) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ConsoleLogger,
-  LogLevel,
   LoggerFactoryImpl,
   createLogger,
   setLoggerFactory

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/logger/ConsoleLogger.ts","../src/logger/LoggerFactoryImpl.ts"],"sourcesContent":["/**\n * AgentX Common\n *\n * Internal common infrastructure for AgentX platform.\n * Provides shared utilities used by internal packages (engine, agent, etc.)\n *\n * ## Module Structure\n *\n * | Module   | Purpose                                      |\n * |----------|----------------------------------------------|\n * | logger/  | Lazy-initialized logging with pluggable backends |\n *\n * ## Design Principles\n *\n * 1. **Internal Use**: For AgentX internal packages only\n * 2. **Lazy Initialization**: Safe to use at module level\n * 3. **Pluggable**: External implementations via Runtime injection\n *\n * @example\n * ```typescript\n * import { createLogger } from \"@agentxjs/common\";\n *\n * const logger = createLogger(\"engine/AgentEngine\");\n * logger.info(\"Hello\");\n * ```\n *\n * @packageDocumentation\n */\n\n// Re-export types from agentx-types for convenience\nexport { LogLevel } from \"@agentxjs/types\";\nexport type { Logger, LogContext, LoggerFactory } from \"@agentxjs/types\";\n\n// Logger implementation\nexport {\n  ConsoleLogger,\n  type ConsoleLoggerOptions,\n  LoggerFactoryImpl,\n  type LoggerFactoryConfig,\n  setLoggerFactory,\n  createLogger,\n} from \"./logger\";\n","/**\n * ConsoleLogger - Default logger implementation\n *\n * Simple console-based logger with color support.\n * Used as fallback when no custom LoggerFactory is provided.\n */\n\nimport type { Logger, LogContext, LogLevel } from \"@agentxjs/types\";\nimport { LogLevel as LogLevelEnum } from \"@agentxjs/types\";\n\nexport interface ConsoleLoggerOptions {\n  level?: LogLevel;\n  colors?: boolean;\n  timestamps?: boolean;\n}\n\nexport class ConsoleLogger implements Logger {\n  readonly name: string;\n  readonly level: LogLevel;\n  private readonly colors: boolean;\n  private readonly timestamps: boolean;\n\n  private static readonly COLORS = {\n    DEBUG: \"\\x1b[36m\",\n    INFO: \"\\x1b[32m\",\n    WARN: \"\\x1b[33m\",\n    ERROR: \"\\x1b[31m\",\n    RESET: \"\\x1b[0m\",\n  };\n\n  constructor(name: string, options: ConsoleLoggerOptions = {}) {\n    this.name = name;\n    this.level = options.level ?? LogLevelEnum.INFO;\n    this.colors = options.colors ?? this.isNodeEnvironment();\n    this.timestamps = options.timestamps ?? true;\n  }\n\n  debug(message: string, context?: LogContext): void {\n    if (this.isDebugEnabled()) {\n      this.log(\"DEBUG\", message, context);\n    }\n  }\n\n  info(message: string, context?: LogContext): void {\n    if (this.isInfoEnabled()) {\n      this.log(\"INFO\", message, context);\n    }\n  }\n\n  warn(message: string, context?: LogContext): void {\n    if (this.isWarnEnabled()) {\n      this.log(\"WARN\", message, context);\n    }\n  }\n\n  error(message: string | Error, context?: LogContext): void {\n    if (this.isErrorEnabled()) {\n      if (message instanceof Error) {\n        this.log(\"ERROR\", message.message, { ...context, stack: message.stack });\n      } else {\n        this.log(\"ERROR\", message, context);\n      }\n    }\n  }\n\n  isDebugEnabled(): boolean {\n    return this.level <= LogLevelEnum.DEBUG;\n  }\n\n  isInfoEnabled(): boolean {\n    return this.level <= LogLevelEnum.INFO;\n  }\n\n  isWarnEnabled(): boolean {\n    return this.level <= LogLevelEnum.WARN;\n  }\n\n  isErrorEnabled(): boolean {\n    return this.level <= LogLevelEnum.ERROR;\n  }\n\n  private log(level: string, message: string, context?: LogContext): void {\n    const parts: string[] = [];\n\n    if (this.timestamps) {\n      parts.push(new Date().toISOString());\n    }\n\n    if (this.colors) {\n      const color = ConsoleLogger.COLORS[level as keyof typeof ConsoleLogger.COLORS];\n      parts.push(`${color}${level.padEnd(5)}${ConsoleLogger.COLORS.RESET}`);\n    } else {\n      parts.push(level.padEnd(5));\n    }\n\n    parts.push(`[${this.name}]`);\n    parts.push(message);\n\n    const logLine = parts.join(\" \");\n    const consoleMethod = this.getConsoleMethod(level);\n\n    if (context && Object.keys(context).length > 0) {\n      consoleMethod(logLine, context);\n    } else {\n      consoleMethod(logLine);\n    }\n  }\n\n  private getConsoleMethod(level: string): (...args: unknown[]) => void {\n    switch (level) {\n      case \"DEBUG\":\n        return console.debug.bind(console);\n      case \"INFO\":\n        return console.info.bind(console);\n      case \"WARN\":\n        return console.warn.bind(console);\n      case \"ERROR\":\n        return console.error.bind(console);\n      default:\n        return console.log.bind(console);\n    }\n  }\n\n  private isNodeEnvironment(): boolean {\n    return typeof process !== \"undefined\" && process.versions?.node !== undefined;\n  }\n}\n","/**\n * LoggerFactoryImpl - Central factory for creating logger instances\n *\n * Implements lazy initialization pattern:\n * - createLogger() can be called at module level (before config)\n * - Real logger is created on first use\n * - External LoggerFactory can be injected via Runtime\n */\n\nimport type { Logger, LoggerFactory, LogContext, LogLevel } from \"@agentxjs/types\";\nimport { LogLevel as LogLevelEnum } from \"@agentxjs/types\";\nimport { ConsoleLogger, type ConsoleLoggerOptions } from \"./ConsoleLogger\";\n\n// External factory injected via Runtime\nlet externalFactory: LoggerFactory | null = null;\n\nexport interface LoggerFactoryConfig {\n  defaultImplementation?: (name: string) => Logger;\n  defaultLevel?: LogLevel;\n  consoleOptions?: Omit<ConsoleLoggerOptions, \"level\">;\n}\n\n/**\n * Internal LoggerFactory implementation\n *\n * Uses lazy proxy pattern to allow module-level createLogger() calls.\n */\nexport class LoggerFactoryImpl {\n  private static loggers: Map<string, Logger> = new Map();\n  private static config: LoggerFactoryConfig = {\n    defaultLevel: LogLevelEnum.INFO,\n  };\n\n  static getLogger(nameOrClass: string | (new (...args: unknown[]) => unknown)): Logger {\n    const name = typeof nameOrClass === \"string\" ? nameOrClass : nameOrClass.name;\n\n    if (this.loggers.has(name)) {\n      return this.loggers.get(name)!;\n    }\n\n    const lazyLogger = this.createLazyLogger(name);\n    this.loggers.set(name, lazyLogger);\n    return lazyLogger;\n  }\n\n  static configure(config: LoggerFactoryConfig): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  static reset(): void {\n    this.loggers.clear();\n    this.config = { defaultLevel: LogLevelEnum.INFO };\n    externalFactory = null;\n  }\n\n  private static createLazyLogger(name: string): Logger {\n    let realLogger: Logger | null = null;\n\n    const getRealLogger = (): Logger => {\n      if (!realLogger) {\n        realLogger = this.createLogger(name);\n      }\n      return realLogger;\n    };\n\n    return {\n      name,\n      level: this.config.defaultLevel || LogLevelEnum.INFO,\n      debug: (message: string, context?: LogContext) => getRealLogger().debug(message, context),\n      info: (message: string, context?: LogContext) => getRealLogger().info(message, context),\n      warn: (message: string, context?: LogContext) => getRealLogger().warn(message, context),\n      error: (message: string | Error, context?: LogContext) =>\n        getRealLogger().error(message, context),\n      isDebugEnabled: () => getRealLogger().isDebugEnabled(),\n      isInfoEnabled: () => getRealLogger().isInfoEnabled(),\n      isWarnEnabled: () => getRealLogger().isWarnEnabled(),\n      isErrorEnabled: () => getRealLogger().isErrorEnabled(),\n    };\n  }\n\n  private static createLogger(name: string): Logger {\n    if (externalFactory) {\n      return externalFactory.getLogger(name);\n    }\n\n    if (this.config.defaultImplementation) {\n      return this.config.defaultImplementation(name);\n    }\n\n    return new ConsoleLogger(name, {\n      level: this.config.defaultLevel,\n      ...this.config.consoleOptions,\n    });\n  }\n}\n\n/**\n * Set external LoggerFactory (called by Runtime initialization)\n */\nexport function setLoggerFactory(factory: LoggerFactory): void {\n  externalFactory = factory;\n  LoggerFactoryImpl.reset();\n  externalFactory = factory;\n}\n\n/**\n * Create a logger instance\n *\n * Safe to call at module level before Runtime is configured.\n * Uses lazy initialization - actual logger is created on first use.\n *\n * @param name - Logger name (hierarchical, e.g., \"engine/AgentEngine\")\n * @returns Logger instance (lazy proxy)\n */\nexport function createLogger(name: string): Logger {\n  return LoggerFactoryImpl.getLogger(name);\n}\n"],"mappings":"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","names":["import_types","LogLevelEnum","import_types","LogLevelEnum"]}
+{"version":3,"sources":["../src/index.ts","../src/logger/ConsoleLogger.ts","../src/logger/LoggerFactoryImpl.ts"],"sourcesContent":["/**\n * AgentX Common\n *\n * Internal common infrastructure for AgentX platform.\n * Provides shared utilities used by internal packages (engine, agent, etc.)\n *\n * ## Module Structure\n *\n * | Module   | Purpose                                      |\n * |----------|----------------------------------------------|\n * | logger/  | Lazy-initialized logging with pluggable backends |\n *\n * ## Design Principles\n *\n * 1. **Internal Use**: For AgentX internal packages only\n * 2. **Lazy Initialization**: Safe to use at module level\n * 3. **Pluggable**: External implementations via Runtime injection\n *\n * @example\n * ```typescript\n * import { createLogger } from \"@agentxjs/common\";\n *\n * const logger = createLogger(\"engine/AgentEngine\");\n * logger.info(\"Hello\");\n * ```\n *\n * @packageDocumentation\n */\n\n// Re-export types from agentx-types for convenience\nexport type { LogLevel, Logger, LogContext, LoggerFactory } from \"@agentxjs/types\";\n\n// Logger implementation\nexport {\n  ConsoleLogger,\n  type ConsoleLoggerOptions,\n  LoggerFactoryImpl,\n  type LoggerFactoryConfig,\n  setLoggerFactory,\n  createLogger,\n} from \"./logger\";\n","/**\n * ConsoleLogger - Default logger implementation\n *\n * Simple console-based logger with color support.\n * Used as fallback when no custom LoggerFactory is provided.\n */\n\nimport type { Logger, LogContext, LogLevel } from \"@agentxjs/types\";\n\nexport interface ConsoleLoggerOptions {\n  level?: LogLevel;\n  colors?: boolean;\n  timestamps?: boolean;\n}\n\nexport class ConsoleLogger implements Logger {\n  readonly name: string;\n  readonly level: LogLevel;\n  private readonly colors: boolean;\n  private readonly timestamps: boolean;\n\n  private static readonly COLORS = {\n    DEBUG: \"\\x1b[36m\",\n    INFO: \"\\x1b[32m\",\n    WARN: \"\\x1b[33m\",\n    ERROR: \"\\x1b[31m\",\n    RESET: \"\\x1b[0m\",\n  };\n\n  constructor(name: string, options: ConsoleLoggerOptions = {}) {\n    this.name = name;\n    this.level = options.level ?? \"info\";\n    this.colors = options.colors ?? this.isNodeEnvironment();\n    this.timestamps = options.timestamps ?? true;\n  }\n\n  debug(message: string, context?: LogContext): void {\n    if (this.isDebugEnabled()) {\n      this.log(\"DEBUG\", message, context);\n    }\n  }\n\n  info(message: string, context?: LogContext): void {\n    if (this.isInfoEnabled()) {\n      this.log(\"INFO\", message, context);\n    }\n  }\n\n  warn(message: string, context?: LogContext): void {\n    if (this.isWarnEnabled()) {\n      this.log(\"WARN\", message, context);\n    }\n  }\n\n  error(message: string | Error, context?: LogContext): void {\n    if (this.isErrorEnabled()) {\n      if (message instanceof Error) {\n        this.log(\"ERROR\", message.message, { ...context, stack: message.stack });\n      } else {\n        this.log(\"ERROR\", message, context);\n      }\n    }\n  }\n\n  isDebugEnabled(): boolean {\n    return this.getLevelValue(this.level) <= this.getLevelValue(\"debug\");\n  }\n\n  isInfoEnabled(): boolean {\n    return this.getLevelValue(this.level) <= this.getLevelValue(\"info\");\n  }\n\n  isWarnEnabled(): boolean {\n    return this.getLevelValue(this.level) <= this.getLevelValue(\"warn\");\n  }\n\n  isErrorEnabled(): boolean {\n    return this.getLevelValue(this.level) <= this.getLevelValue(\"error\");\n  }\n\n  private getLevelValue(level: LogLevel): number {\n    const levels: Record<LogLevel, number> = {\n      debug: 0,\n      info: 1,\n      warn: 2,\n      error: 3,\n      silent: 4,\n    };\n    return levels[level];\n  }\n\n  private log(level: string, message: string, context?: LogContext): void {\n    const parts: string[] = [];\n\n    if (this.timestamps) {\n      parts.push(new Date().toISOString());\n    }\n\n    if (this.colors) {\n      const color = ConsoleLogger.COLORS[level as keyof typeof ConsoleLogger.COLORS];\n      parts.push(`${color}${level.padEnd(5)}${ConsoleLogger.COLORS.RESET}`);\n    } else {\n      parts.push(level.padEnd(5));\n    }\n\n    parts.push(`[${this.name}]`);\n    parts.push(message);\n\n    const logLine = parts.join(\" \");\n    const consoleMethod = this.getConsoleMethod(level);\n\n    if (context && Object.keys(context).length > 0) {\n      consoleMethod(logLine, context);\n    } else {\n      consoleMethod(logLine);\n    }\n  }\n\n  private getConsoleMethod(level: string): (...args: unknown[]) => void {\n    switch (level) {\n      case \"DEBUG\":\n        return console.debug.bind(console);\n      case \"INFO\":\n        return console.info.bind(console);\n      case \"WARN\":\n        return console.warn.bind(console);\n      case \"ERROR\":\n        return console.error.bind(console);\n      default:\n        return console.log.bind(console);\n    }\n  }\n\n  private isNodeEnvironment(): boolean {\n    return typeof process !== \"undefined\" && process.versions?.node !== undefined;\n  }\n}\n","/**\n * LoggerFactoryImpl - Central factory for creating logger instances\n *\n * Implements lazy initialization pattern:\n * - createLogger() can be called at module level (before config)\n * - Real logger is created on first use\n * - External LoggerFactory can be injected via Runtime\n */\n\nimport type { Logger, LoggerFactory, LogContext, LogLevel } from \"@agentxjs/types\";\nimport { ConsoleLogger, type ConsoleLoggerOptions } from \"./ConsoleLogger\";\n\n// External factory injected via Runtime\nlet externalFactory: LoggerFactory | null = null;\n\n// Version counter to invalidate cached real loggers\nlet factoryVersion = 0;\n\nexport interface LoggerFactoryConfig {\n  defaultImplementation?: (name: string) => Logger;\n  defaultLevel?: LogLevel;\n  consoleOptions?: Omit<ConsoleLoggerOptions, \"level\">;\n}\n\n/**\n * Internal LoggerFactory implementation\n *\n * Uses lazy proxy pattern to allow module-level createLogger() calls.\n */\nexport class LoggerFactoryImpl {\n  private static loggers: Map<string, Logger> = new Map();\n  private static config: LoggerFactoryConfig = {\n    defaultLevel: \"info\",\n  };\n\n  static getLogger(nameOrClass: string | (new (...args: unknown[]) => unknown)): Logger {\n    const name = typeof nameOrClass === \"string\" ? nameOrClass : nameOrClass.name;\n\n    if (this.loggers.has(name)) {\n      return this.loggers.get(name)!;\n    }\n\n    const lazyLogger = this.createLazyLogger(name);\n    this.loggers.set(name, lazyLogger);\n    return lazyLogger;\n  }\n\n  static configure(config: LoggerFactoryConfig): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  static reset(): void {\n    this.loggers.clear();\n    this.config = { defaultLevel: \"info\" };\n    externalFactory = null;\n    factoryVersion++; // Invalidate all cached real loggers\n  }\n\n  private static createLazyLogger(name: string): Logger {\n    let realLogger: Logger | null = null;\n    let loggerVersion = -1; // Track which factory version created this logger\n\n    const getRealLogger = (): Logger => {\n      // Recreate logger if factory version changed (setLoggerFactory was called)\n      if (!realLogger || loggerVersion !== factoryVersion) {\n        realLogger = this.createLogger(name);\n        loggerVersion = factoryVersion;\n      }\n      return realLogger;\n    };\n\n    return {\n      name,\n      level: this.config.defaultLevel || \"info\",\n      debug: (message: string, context?: LogContext) => getRealLogger().debug(message, context),\n      info: (message: string, context?: LogContext) => getRealLogger().info(message, context),\n      warn: (message: string, context?: LogContext) => getRealLogger().warn(message, context),\n      error: (message: string | Error, context?: LogContext) =>\n        getRealLogger().error(message, context),\n      isDebugEnabled: () => getRealLogger().isDebugEnabled(),\n      isInfoEnabled: () => getRealLogger().isInfoEnabled(),\n      isWarnEnabled: () => getRealLogger().isWarnEnabled(),\n      isErrorEnabled: () => getRealLogger().isErrorEnabled(),\n    };\n  }\n\n  private static createLogger(name: string): Logger {\n    if (externalFactory) {\n      return externalFactory.getLogger(name);\n    }\n\n    if (this.config.defaultImplementation) {\n      return this.config.defaultImplementation(name);\n    }\n\n    return new ConsoleLogger(name, {\n      level: this.config.defaultLevel,\n      ...this.config.consoleOptions,\n    });\n  }\n}\n\n/**\n * Set external LoggerFactory (called by Runtime initialization)\n */\nexport function setLoggerFactory(factory: LoggerFactory): void {\n  externalFactory = factory;\n  LoggerFactoryImpl.reset();\n  externalFactory = factory;\n}\n\n/**\n * Create a logger instance\n *\n * Safe to call at module level before Runtime is configured.\n * Uses lazy initialization - actual logger is created on first use.\n *\n * @param name - Logger name (hierarchical, e.g., \"engine/AgentEngine\")\n * @returns Logger instance (lazy proxy)\n */\nexport function createLogger(name: string): Logger {\n  return LoggerFactoryImpl.getLogger(name);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -28,6 +28,7 @@ declare class ConsoleLogger implements Logger {
     isInfoEnabled(): boolean;
     isWarnEnabled(): boolean;
     isErrorEnabled(): boolean;
+    private getLevelValue;
     private log;
     private getConsoleMethod;
     private isNodeEnvironment;

package/dist/index.d.ts

@@ -28,6 +28,7 @@ declare class ConsoleLogger implements Logger {
     isInfoEnabled(): boolean;
     isWarnEnabled(): boolean;
     isErrorEnabled(): boolean;
+    private getLevelValue;
     private log;
     private getConsoleMethod;
     private isNodeEnvironment;

package/dist/index.js

@@ -2,11 +2,7 @@ var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
-// src/index.ts
-import { LogLevel } from "@agentxjs/types";
-
 // src/logger/ConsoleLogger.ts
-import { LogLevel as LogLevelEnum } from "@agentxjs/types";
 var _ConsoleLogger = class _ConsoleLogger {
   constructor(name, options = {}) {
     __publicField(this, "name");
@@ -14,7 +10,7 @@ var _ConsoleLogger = class _ConsoleLogger {
     __publicField(this, "colors");
     __publicField(this, "timestamps");
     this.name = name;
-    this.level = options.level ?? LogLevelEnum.INFO;
+    this.level = options.level ?? "info";
     this.colors = options.colors ?? this.isNodeEnvironment();
     this.timestamps = options.timestamps ?? true;
   }
@@ -43,16 +39,26 @@ var _ConsoleLogger = class _ConsoleLogger {
     }
   }
   isDebugEnabled() {
-    return this.level <= LogLevelEnum.DEBUG;
+    return this.getLevelValue(this.level) <= this.getLevelValue("debug");
   }
   isInfoEnabled() {
-    return this.level <= LogLevelEnum.INFO;
+    return this.getLevelValue(this.level) <= this.getLevelValue("info");
   }
   isWarnEnabled() {
-    return this.level <= LogLevelEnum.WARN;
+    return this.getLevelValue(this.level) <= this.getLevelValue("warn");
   }
   isErrorEnabled() {
-    return this.level <= LogLevelEnum.ERROR;
+    return this.getLevelValue(this.level) <= this.getLevelValue("error");
+  }
+  getLevelValue(level) {
+    const levels = {
+      debug: 0,
+      info: 1,
+      warn: 2,
+      error: 3,
+      silent: 4
+    };
+    return levels[level];
   }
   log(level, message, context) {
     const parts = [];
@@ -103,8 +109,8 @@ __publicField(_ConsoleLogger, "COLORS", {
 var ConsoleLogger = _ConsoleLogger;
 
 // src/logger/LoggerFactoryImpl.ts
-import { LogLevel as LogLevelEnum2 } from "@agentxjs/types";
 var externalFactory = null;
+var factoryVersion = 0;
 var LoggerFactoryImpl = class {
   static getLogger(nameOrClass) {
     const name = typeof nameOrClass === "string" ? nameOrClass : nameOrClass.name;
@@ -120,20 +126,23 @@ var LoggerFactoryImpl = class {
   }
   static reset() {
     this.loggers.clear();
-    this.config = { defaultLevel: LogLevelEnum2.INFO };
+    this.config = { defaultLevel: "info" };
     externalFactory = null;
+    factoryVersion++;
   }
   static createLazyLogger(name) {
     let realLogger = null;
+    let loggerVersion = -1;
     const getRealLogger = () => {
-      if (!realLogger) {
+      if (!realLogger || loggerVersion !== factoryVersion) {
         realLogger = this.createLogger(name);
+        loggerVersion = factoryVersion;
       }
       return realLogger;
     };
     return {
       name,
-      level: this.config.defaultLevel || LogLevelEnum2.INFO,
+      level: this.config.defaultLevel || "info",
       debug: (message, context) => getRealLogger().debug(message, context),
       info: (message, context) => getRealLogger().info(message, context),
       warn: (message, context) => getRealLogger().warn(message, context),
@@ -159,7 +168,7 @@ var LoggerFactoryImpl = class {
 };
 __publicField(LoggerFactoryImpl, "loggers", /* @__PURE__ */ new Map());
 __publicField(LoggerFactoryImpl, "config", {
-  defaultLevel: LogLevelEnum2.INFO
+  defaultLevel: "info"
 });
 function setLoggerFactory(factory) {
   externalFactory = factory;
@@ -171,7 +180,6 @@ function createLogger(name) {
 }
 export {
   ConsoleLogger,
-  LogLevel,
   LoggerFactoryImpl,
   createLogger,
   setLoggerFactory

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/logger/ConsoleLogger.ts","../src/logger/LoggerFactoryImpl.ts"],"sourcesContent":["/**\n * AgentX Common\n *\n * Internal common infrastructure for AgentX platform.\n * Provides shared utilities used by internal packages (engine, agent, etc.)\n *\n * ## Module Structure\n *\n * | Module   | Purpose                                      |\n * |----------|----------------------------------------------|\n * | logger/  | Lazy-initialized logging with pluggable backends |\n *\n * ## Design Principles\n *\n * 1. **Internal Use**: For AgentX internal packages only\n * 2. **Lazy Initialization**: Safe to use at module level\n * 3. **Pluggable**: External implementations via Runtime injection\n *\n * @example\n * ```typescript\n * import { createLogger } from \"@agentxjs/common\";\n *\n * const logger = createLogger(\"engine/AgentEngine\");\n * logger.info(\"Hello\");\n * ```\n *\n * @packageDocumentation\n */\n\n// Re-export types from agentx-types for convenience\nexport { LogLevel } from \"@agentxjs/types\";\nexport type { Logger, LogContext, LoggerFactory } from \"@agentxjs/types\";\n\n// Logger implementation\nexport {\n  ConsoleLogger,\n  type ConsoleLoggerOptions,\n  LoggerFactoryImpl,\n  type LoggerFactoryConfig,\n  setLoggerFactory,\n  createLogger,\n} from \"./logger\";\n","/**\n * ConsoleLogger - Default logger implementation\n *\n * Simple console-based logger with color support.\n * Used as fallback when no custom LoggerFactory is provided.\n */\n\nimport type { Logger, LogContext, LogLevel } from \"@agentxjs/types\";\nimport { LogLevel as LogLevelEnum } from \"@agentxjs/types\";\n\nexport interface ConsoleLoggerOptions {\n  level?: LogLevel;\n  colors?: boolean;\n  timestamps?: boolean;\n}\n\nexport class ConsoleLogger implements Logger {\n  readonly name: string;\n  readonly level: LogLevel;\n  private readonly colors: boolean;\n  private readonly timestamps: boolean;\n\n  private static readonly COLORS = {\n    DEBUG: \"\\x1b[36m\",\n    INFO: \"\\x1b[32m\",\n    WARN: \"\\x1b[33m\",\n    ERROR: \"\\x1b[31m\",\n    RESET: \"\\x1b[0m\",\n  };\n\n  constructor(name: string, options: ConsoleLoggerOptions = {}) {\n    this.name = name;\n    this.level = options.level ?? LogLevelEnum.INFO;\n    this.colors = options.colors ?? this.isNodeEnvironment();\n    this.timestamps = options.timestamps ?? true;\n  }\n\n  debug(message: string, context?: LogContext): void {\n    if (this.isDebugEnabled()) {\n      this.log(\"DEBUG\", message, context);\n    }\n  }\n\n  info(message: string, context?: LogContext): void {\n    if (this.isInfoEnabled()) {\n      this.log(\"INFO\", message, context);\n    }\n  }\n\n  warn(message: string, context?: LogContext): void {\n    if (this.isWarnEnabled()) {\n      this.log(\"WARN\", message, context);\n    }\n  }\n\n  error(message: string | Error, context?: LogContext): void {\n    if (this.isErrorEnabled()) {\n      if (message instanceof Error) {\n        this.log(\"ERROR\", message.message, { ...context, stack: message.stack });\n      } else {\n        this.log(\"ERROR\", message, context);\n      }\n    }\n  }\n\n  isDebugEnabled(): boolean {\n    return this.level <= LogLevelEnum.DEBUG;\n  }\n\n  isInfoEnabled(): boolean {\n    return this.level <= LogLevelEnum.INFO;\n  }\n\n  isWarnEnabled(): boolean {\n    return this.level <= LogLevelEnum.WARN;\n  }\n\n  isErrorEnabled(): boolean {\n    return this.level <= LogLevelEnum.ERROR;\n  }\n\n  private log(level: string, message: string, context?: LogContext): void {\n    const parts: string[] = [];\n\n    if (this.timestamps) {\n      parts.push(new Date().toISOString());\n    }\n\n    if (this.colors) {\n      const color = ConsoleLogger.COLORS[level as keyof typeof ConsoleLogger.COLORS];\n      parts.push(`${color}${level.padEnd(5)}${ConsoleLogger.COLORS.RESET}`);\n    } else {\n      parts.push(level.padEnd(5));\n    }\n\n    parts.push(`[${this.name}]`);\n    parts.push(message);\n\n    const logLine = parts.join(\" \");\n    const consoleMethod = this.getConsoleMethod(level);\n\n    if (context && Object.keys(context).length > 0) {\n      consoleMethod(logLine, context);\n    } else {\n      consoleMethod(logLine);\n    }\n  }\n\n  private getConsoleMethod(level: string): (...args: unknown[]) => void {\n    switch (level) {\n      case \"DEBUG\":\n        return console.debug.bind(console);\n      case \"INFO\":\n        return console.info.bind(console);\n      case \"WARN\":\n        return console.warn.bind(console);\n      case \"ERROR\":\n        return console.error.bind(console);\n      default:\n        return console.log.bind(console);\n    }\n  }\n\n  private isNodeEnvironment(): boolean {\n    return typeof process !== \"undefined\" && process.versions?.node !== undefined;\n  }\n}\n","/**\n * LoggerFactoryImpl - Central factory for creating logger instances\n *\n * Implements lazy initialization pattern:\n * - createLogger() can be called at module level (before config)\n * - Real logger is created on first use\n * - External LoggerFactory can be injected via Runtime\n */\n\nimport type { Logger, LoggerFactory, LogContext, LogLevel } from \"@agentxjs/types\";\nimport { LogLevel as LogLevelEnum } from \"@agentxjs/types\";\nimport { ConsoleLogger, type ConsoleLoggerOptions } from \"./ConsoleLogger\";\n\n// External factory injected via Runtime\nlet externalFactory: LoggerFactory | null = null;\n\nexport interface LoggerFactoryConfig {\n  defaultImplementation?: (name: string) => Logger;\n  defaultLevel?: LogLevel;\n  consoleOptions?: Omit<ConsoleLoggerOptions, \"level\">;\n}\n\n/**\n * Internal LoggerFactory implementation\n *\n * Uses lazy proxy pattern to allow module-level createLogger() calls.\n */\nexport class LoggerFactoryImpl {\n  private static loggers: Map<string, Logger> = new Map();\n  private static config: LoggerFactoryConfig = {\n    defaultLevel: LogLevelEnum.INFO,\n  };\n\n  static getLogger(nameOrClass: string | (new (...args: unknown[]) => unknown)): Logger {\n    const name = typeof nameOrClass === \"string\" ? nameOrClass : nameOrClass.name;\n\n    if (this.loggers.has(name)) {\n      return this.loggers.get(name)!;\n    }\n\n    const lazyLogger = this.createLazyLogger(name);\n    this.loggers.set(name, lazyLogger);\n    return lazyLogger;\n  }\n\n  static configure(config: LoggerFactoryConfig): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  static reset(): void {\n    this.loggers.clear();\n    this.config = { defaultLevel: LogLevelEnum.INFO };\n    externalFactory = null;\n  }\n\n  private static createLazyLogger(name: string): Logger {\n    let realLogger: Logger | null = null;\n\n    const getRealLogger = (): Logger => {\n      if (!realLogger) {\n        realLogger = this.createLogger(name);\n      }\n      return realLogger;\n    };\n\n    return {\n      name,\n      level: this.config.defaultLevel || LogLevelEnum.INFO,\n      debug: (message: string, context?: LogContext) => getRealLogger().debug(message, context),\n      info: (message: string, context?: LogContext) => getRealLogger().info(message, context),\n      warn: (message: string, context?: LogContext) => getRealLogger().warn(message, context),\n      error: (message: string | Error, context?: LogContext) =>\n        getRealLogger().error(message, context),\n      isDebugEnabled: () => getRealLogger().isDebugEnabled(),\n      isInfoEnabled: () => getRealLogger().isInfoEnabled(),\n      isWarnEnabled: () => getRealLogger().isWarnEnabled(),\n      isErrorEnabled: () => getRealLogger().isErrorEnabled(),\n    };\n  }\n\n  private static createLogger(name: string): Logger {\n    if (externalFactory) {\n      return externalFactory.getLogger(name);\n    }\n\n    if (this.config.defaultImplementation) {\n      return this.config.defaultImplementation(name);\n    }\n\n    return new ConsoleLogger(name, {\n      level: this.config.defaultLevel,\n      ...this.config.consoleOptions,\n    });\n  }\n}\n\n/**\n * Set external LoggerFactory (called by Runtime initialization)\n */\nexport function setLoggerFactory(factory: LoggerFactory): void {\n  externalFactory = factory;\n  LoggerFactoryImpl.reset();\n  externalFactory = factory;\n}\n\n/**\n * Create a logger instance\n *\n * Safe to call at module level before Runtime is configured.\n * Uses lazy initialization - actual logger is created on first use.\n *\n * @param name - Logger name (hierarchical, e.g., \"engine/AgentEngine\")\n * @returns Logger instance (lazy proxy)\n */\nexport function createLogger(name: string): Logger {\n  return LoggerFactoryImpl.getLogger(name);\n}\n"],"mappings":"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","names":["LogLevelEnum","LogLevelEnum"]}
+{"version":3,"sources":["../src/logger/ConsoleLogger.ts","../src/logger/LoggerFactoryImpl.ts"],"sourcesContent":["/**\n * ConsoleLogger - Default logger implementation\n *\n * Simple console-based logger with color support.\n * Used as fallback when no custom LoggerFactory is provided.\n */\n\nimport type { Logger, LogContext, LogLevel } from \"@agentxjs/types\";\n\nexport interface ConsoleLoggerOptions {\n  level?: LogLevel;\n  colors?: boolean;\n  timestamps?: boolean;\n}\n\nexport class ConsoleLogger implements Logger {\n  readonly name: string;\n  readonly level: LogLevel;\n  private readonly colors: boolean;\n  private readonly timestamps: boolean;\n\n  private static readonly COLORS = {\n    DEBUG: \"\\x1b[36m\",\n    INFO: \"\\x1b[32m\",\n    WARN: \"\\x1b[33m\",\n    ERROR: \"\\x1b[31m\",\n    RESET: \"\\x1b[0m\",\n  };\n\n  constructor(name: string, options: ConsoleLoggerOptions = {}) {\n    this.name = name;\n    this.level = options.level ?? \"info\";\n    this.colors = options.colors ?? this.isNodeEnvironment();\n    this.timestamps = options.timestamps ?? true;\n  }\n\n  debug(message: string, context?: LogContext): void {\n    if (this.isDebugEnabled()) {\n      this.log(\"DEBUG\", message, context);\n    }\n  }\n\n  info(message: string, context?: LogContext): void {\n    if (this.isInfoEnabled()) {\n      this.log(\"INFO\", message, context);\n    }\n  }\n\n  warn(message: string, context?: LogContext): void {\n    if (this.isWarnEnabled()) {\n      this.log(\"WARN\", message, context);\n    }\n  }\n\n  error(message: string | Error, context?: LogContext): void {\n    if (this.isErrorEnabled()) {\n      if (message instanceof Error) {\n        this.log(\"ERROR\", message.message, { ...context, stack: message.stack });\n      } else {\n        this.log(\"ERROR\", message, context);\n      }\n    }\n  }\n\n  isDebugEnabled(): boolean {\n    return this.getLevelValue(this.level) <= this.getLevelValue(\"debug\");\n  }\n\n  isInfoEnabled(): boolean {\n    return this.getLevelValue(this.level) <= this.getLevelValue(\"info\");\n  }\n\n  isWarnEnabled(): boolean {\n    return this.getLevelValue(this.level) <= this.getLevelValue(\"warn\");\n  }\n\n  isErrorEnabled(): boolean {\n    return this.getLevelValue(this.level) <= this.getLevelValue(\"error\");\n  }\n\n  private getLevelValue(level: LogLevel): number {\n    const levels: Record<LogLevel, number> = {\n      debug: 0,\n      info: 1,\n      warn: 2,\n      error: 3,\n      silent: 4,\n    };\n    return levels[level];\n  }\n\n  private log(level: string, message: string, context?: LogContext): void {\n    const parts: string[] = [];\n\n    if (this.timestamps) {\n      parts.push(new Date().toISOString());\n    }\n\n    if (this.colors) {\n      const color = ConsoleLogger.COLORS[level as keyof typeof ConsoleLogger.COLORS];\n      parts.push(`${color}${level.padEnd(5)}${ConsoleLogger.COLORS.RESET}`);\n    } else {\n      parts.push(level.padEnd(5));\n    }\n\n    parts.push(`[${this.name}]`);\n    parts.push(message);\n\n    const logLine = parts.join(\" \");\n    const consoleMethod = this.getConsoleMethod(level);\n\n    if (context && Object.keys(context).length > 0) {\n      consoleMethod(logLine, context);\n    } else {\n      consoleMethod(logLine);\n    }\n  }\n\n  private getConsoleMethod(level: string): (...args: unknown[]) => void {\n    switch (level) {\n      case \"DEBUG\":\n        return console.debug.bind(console);\n      case \"INFO\":\n        return console.info.bind(console);\n      case \"WARN\":\n        return console.warn.bind(console);\n      case \"ERROR\":\n        return console.error.bind(console);\n      default:\n        return console.log.bind(console);\n    }\n  }\n\n  private isNodeEnvironment(): boolean {\n    return typeof process !== \"undefined\" && process.versions?.node !== undefined;\n  }\n}\n","/**\n * LoggerFactoryImpl - Central factory for creating logger instances\n *\n * Implements lazy initialization pattern:\n * - createLogger() can be called at module level (before config)\n * - Real logger is created on first use\n * - External LoggerFactory can be injected via Runtime\n */\n\nimport type { Logger, LoggerFactory, LogContext, LogLevel } from \"@agentxjs/types\";\nimport { ConsoleLogger, type ConsoleLoggerOptions } from \"./ConsoleLogger\";\n\n// External factory injected via Runtime\nlet externalFactory: LoggerFactory | null = null;\n\n// Version counter to invalidate cached real loggers\nlet factoryVersion = 0;\n\nexport interface LoggerFactoryConfig {\n  defaultImplementation?: (name: string) => Logger;\n  defaultLevel?: LogLevel;\n  consoleOptions?: Omit<ConsoleLoggerOptions, \"level\">;\n}\n\n/**\n * Internal LoggerFactory implementation\n *\n * Uses lazy proxy pattern to allow module-level createLogger() calls.\n */\nexport class LoggerFactoryImpl {\n  private static loggers: Map<string, Logger> = new Map();\n  private static config: LoggerFactoryConfig = {\n    defaultLevel: \"info\",\n  };\n\n  static getLogger(nameOrClass: string | (new (...args: unknown[]) => unknown)): Logger {\n    const name = typeof nameOrClass === \"string\" ? nameOrClass : nameOrClass.name;\n\n    if (this.loggers.has(name)) {\n      return this.loggers.get(name)!;\n    }\n\n    const lazyLogger = this.createLazyLogger(name);\n    this.loggers.set(name, lazyLogger);\n    return lazyLogger;\n  }\n\n  static configure(config: LoggerFactoryConfig): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  static reset(): void {\n    this.loggers.clear();\n    this.config = { defaultLevel: \"info\" };\n    externalFactory = null;\n    factoryVersion++; // Invalidate all cached real loggers\n  }\n\n  private static createLazyLogger(name: string): Logger {\n    let realLogger: Logger | null = null;\n    let loggerVersion = -1; // Track which factory version created this logger\n\n    const getRealLogger = (): Logger => {\n      // Recreate logger if factory version changed (setLoggerFactory was called)\n      if (!realLogger || loggerVersion !== factoryVersion) {\n        realLogger = this.createLogger(name);\n        loggerVersion = factoryVersion;\n      }\n      return realLogger;\n    };\n\n    return {\n      name,\n      level: this.config.defaultLevel || \"info\",\n      debug: (message: string, context?: LogContext) => getRealLogger().debug(message, context),\n      info: (message: string, context?: LogContext) => getRealLogger().info(message, context),\n      warn: (message: string, context?: LogContext) => getRealLogger().warn(message, context),\n      error: (message: string | Error, context?: LogContext) =>\n        getRealLogger().error(message, context),\n      isDebugEnabled: () => getRealLogger().isDebugEnabled(),\n      isInfoEnabled: () => getRealLogger().isInfoEnabled(),\n      isWarnEnabled: () => getRealLogger().isWarnEnabled(),\n      isErrorEnabled: () => getRealLogger().isErrorEnabled(),\n    };\n  }\n\n  private static createLogger(name: string): Logger {\n    if (externalFactory) {\n      return externalFactory.getLogger(name);\n    }\n\n    if (this.config.defaultImplementation) {\n      return this.config.defaultImplementation(name);\n    }\n\n    return new ConsoleLogger(name, {\n      level: this.config.defaultLevel,\n      ...this.config.consoleOptions,\n    });\n  }\n}\n\n/**\n * Set external LoggerFactory (called by Runtime initialization)\n */\nexport function setLoggerFactory(factory: LoggerFactory): void {\n  externalFactory = factory;\n  LoggerFactoryImpl.reset();\n  externalFactory = factory;\n}\n\n/**\n * Create a logger instance\n *\n * Safe to call at module level before Runtime is configured.\n * Uses lazy initialization - actual logger is created on first use.\n *\n * @param name - Logger name (hierarchical, e.g., \"engine/AgentEngine\")\n * @returns Logger instance (lazy proxy)\n */\nexport function createLogger(name: string): Logger {\n  return LoggerFactoryImpl.getLogger(name);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxjs/common",
-  "version": "0.1.0",
+  "version": "1.1.3",
   "description": "Common utilities for AgentX platform - Logger facade and shared infrastructure",
   "keywords": [
     "agentx",
@@ -30,7 +30,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@agentxjs/types": "0.0.6"
+    "@agentxjs/types": "1.1.3"
   },
   "devDependencies": {
     "@types/node": "^22.19.1",