@agentforge/core 0.6.3 → 0.6.4

package/dist/index.cjs

@@ -803,7 +803,103 @@ Examples:`);
   return parts.join("\n");
 }
 
+// src/langgraph/observability/logger.ts
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2["DEBUG"] = "debug";
+  LogLevel2["INFO"] = "info";
+  LogLevel2["WARN"] = "warn";
+  LogLevel2["ERROR"] = "error";
+  return LogLevel2;
+})(LogLevel || {});
+var LOG_LEVEL_PRIORITY = {
+  ["debug" /* DEBUG */]: 0,
+  ["info" /* INFO */]: 1,
+  ["warn" /* WARN */]: 2,
+  ["error" /* ERROR */]: 3
+};
+var LoggerImpl = class _LoggerImpl {
+  name;
+  options;
+  context;
+  constructor(name, options = {}, context = {}) {
+    this.name = name;
+    this.context = context;
+    this.options = {
+      level: options.level ?? "info" /* INFO */,
+      format: options.format ?? "pretty",
+      destination: options.destination ?? process.stdout,
+      includeTimestamp: options.includeTimestamp ?? true,
+      includeContext: options.includeContext ?? true
+    };
+  }
+  debug(message, data) {
+    this.log("debug" /* DEBUG */, message, data);
+  }
+  info(message, data) {
+    this.log("info" /* INFO */, message, data);
+  }
+  warn(message, data) {
+    this.log("warn" /* WARN */, message, data);
+  }
+  error(message, data) {
+    this.log("error" /* ERROR */, message, data);
+  }
+  isDebugEnabled() {
+    return this.isLevelEnabled("debug" /* DEBUG */);
+  }
+  isLevelEnabled(level) {
+    return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[this.options.level];
+  }
+  withContext(context) {
+    return new _LoggerImpl(this.name, this.options, { ...this.context, ...context });
+  }
+  log(level, message, data) {
+    if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.options.level]) {
+      return;
+    }
+    const entry = {
+      level,
+      name: this.name,
+      message
+    };
+    if (this.options.includeTimestamp) {
+      entry.timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    }
+    if (this.options.includeContext && Object.keys(this.context).length > 0) {
+      entry.context = this.context;
+    }
+    if (data) {
+      entry.data = data;
+    }
+    const output = this.format(entry);
+    this.options.destination.write(output + "\n");
+  }
+  format(entry) {
+    if (this.options.format === "json") {
+      return JSON.stringify(entry);
+    }
+    const parts = [];
+    if (entry.timestamp) {
+      parts.push(`[${entry.timestamp}]`);
+    }
+    parts.push(`[${entry.level.toUpperCase()}]`);
+    parts.push(`[${entry.name}]`);
+    parts.push(entry.message);
+    if (entry.context) {
+      parts.push(`context=${JSON.stringify(entry.context)}`);
+    }
+    if (entry.data) {
+      parts.push(`data=${JSON.stringify(entry.data)}`);
+    }
+    return parts.join(" ");
+  }
+};
+function createLogger(name, options) {
+  return new LoggerImpl(name, options);
+}
+
 // src/tools/registry.ts
+var logger = createLogger("agentforge:core:tools:registry", { level: "info" /* INFO */ });
 var RegistryEvent = /* @__PURE__ */ ((RegistryEvent2) => {
   RegistryEvent2["TOOL_REGISTERED"] = "tool:registered";
   RegistryEvent2["TOOL_REMOVED"] = "tool:removed";
@@ -1095,7 +1191,11 @@ var ToolRegistry = class {
         try {
           handler(data);
         } catch (error) {
-          console.error(`Error in event handler for ${event}:`, error);
+          logger.error("Event handler error", {
+            event,
+            error: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : void 0
+          });
         }
       });
     }
@@ -1493,6 +1593,7 @@ function createToolExecutor(config = {}) {
 }
 
 // src/tools/lifecycle.ts
+var logger2 = createLogger("agentforge:core:tools:lifecycle", { level: "info" /* INFO */ });
 var ManagedTool = class {
   name;
   description;
@@ -1523,7 +1624,13 @@ var ManagedTool = class {
     this._context = config.context;
     if (this.autoCleanup) {
       process.on("beforeExit", () => {
-        this.cleanup().catch(console.error);
+        this.cleanup().catch(
+          (err) => logger2.error("Cleanup failed", {
+            toolName: this.name,
+            error: err instanceof Error ? err.message : String(err),
+            stack: err instanceof Error ? err.stack : void 0
+          })
+        );
       });
     }
   }
@@ -2393,95 +2500,6 @@ function withTracing(node, options) {
   };
 }
 
-// src/langgraph/observability/logger.ts
-var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
-  LogLevel2["DEBUG"] = "debug";
-  LogLevel2["INFO"] = "info";
-  LogLevel2["WARN"] = "warn";
-  LogLevel2["ERROR"] = "error";
-  return LogLevel2;
-})(LogLevel || {});
-var LOG_LEVEL_PRIORITY = {
-  ["debug" /* DEBUG */]: 0,
-  ["info" /* INFO */]: 1,
-  ["warn" /* WARN */]: 2,
-  ["error" /* ERROR */]: 3
-};
-var LoggerImpl = class _LoggerImpl {
-  name;
-  options;
-  context;
-  constructor(name, options = {}, context = {}) {
-    this.name = name;
-    this.context = context;
-    this.options = {
-      level: options.level ?? "info" /* INFO */,
-      format: options.format ?? "pretty",
-      destination: options.destination ?? process.stdout,
-      includeTimestamp: options.includeTimestamp ?? true,
-      includeContext: options.includeContext ?? true
-    };
-  }
-  debug(message, data) {
-    this.log("debug" /* DEBUG */, message, data);
-  }
-  info(message, data) {
-    this.log("info" /* INFO */, message, data);
-  }
-  warn(message, data) {
-    this.log("warn" /* WARN */, message, data);
-  }
-  error(message, data) {
-    this.log("error" /* ERROR */, message, data);
-  }
-  withContext(context) {
-    return new _LoggerImpl(this.name, this.options, { ...this.context, ...context });
-  }
-  log(level, message, data) {
-    if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.options.level]) {
-      return;
-    }
-    const entry = {
-      level,
-      name: this.name,
-      message
-    };
-    if (this.options.includeTimestamp) {
-      entry.timestamp = (/* @__PURE__ */ new Date()).toISOString();
-    }
-    if (this.options.includeContext && Object.keys(this.context).length > 0) {
-      entry.context = this.context;
-    }
-    if (data) {
-      entry.data = data;
-    }
-    const output = this.format(entry);
-    this.options.destination.write(output + "\n");
-  }
-  format(entry) {
-    if (this.options.format === "json") {
-      return JSON.stringify(entry);
-    }
-    const parts = [];
-    if (entry.timestamp) {
-      parts.push(`[${entry.timestamp}]`);
-    }
-    parts.push(`[${entry.level.toUpperCase()}]`);
-    parts.push(`[${entry.name}]`);
-    parts.push(entry.message);
-    if (entry.context) {
-      parts.push(`context=${JSON.stringify(entry.context)}`);
-    }
-    if (entry.data) {
-      parts.push(`data=${JSON.stringify(entry.data)}`);
-    }
-    return parts.join(" ");
-  }
-};
-function createLogger(name, options) {
-  return new LoggerImpl(name, options);
-}
-
 // src/langgraph/observability/metrics.ts
 var MetricType = /* @__PURE__ */ ((MetricType2) => {
   MetricType2["COUNTER"] = "counter";
@@ -2791,14 +2809,14 @@ var withLogging = (options) => {
     onComplete,
     onError
   } = options;
-  const logger = providedLogger || createLogger(name, { level });
+  const logger3 = providedLogger || createLogger(name, { level });
   return (node) => {
     return async (state) => {
       const startTime = Date.now();
       try {
         if (logInput) {
           const data = extractData ? extractData(state) : { state };
-          logger.info("Node execution started", data);
+          logger3.info("Node execution started", data);
         }
         if (onStart) {
           onStart(state);
@@ -2808,9 +2826,9 @@ var withLogging = (options) => {
         if (logOutput) {
           const data = extractData ? extractData(result) : { result };
           if (logDuration) {
-            logger.info(`Node execution completed (${duration}ms)`, data);
+            logger3.info(`Node execution completed (${duration}ms)`, data);
           } else {
-            logger.info("Node execution completed", data);
+            logger3.info("Node execution completed", data);
           }
         }
         if (onComplete) {
@@ -2821,7 +2839,7 @@ var withLogging = (options) => {
         const duration = Date.now() - startTime;
         const err = error instanceof Error ? error : new Error(String(error));
         if (logErrors) {
-          logger.error(`Node execution failed (${duration}ms)`, {
+          logger3.error(`Node execution failed (${duration}ms)`, {
             error: err.message,
             stack: err.stack
           });
@@ -2857,7 +2875,7 @@ function withLogging2(options) {
 function production(node, options) {
   const {
     nodeName,
-    logger,
+    logger: logger3,
     enableMetrics = true,
     enableTracing = true,
     enableRetry = true,
@@ -2865,7 +2883,7 @@ function production(node, options) {
     retryOptions = {},
     errorOptions = {}
   } = options;
-  const actualLogger = logger || createLogger(nodeName, { level: "info" /* INFO */ });
+  const actualLogger = logger3 || createLogger(nodeName, { level: "info" /* INFO */ });
   const middleware = [];
   middleware.push(
     withLogging2({
@@ -2929,9 +2947,9 @@ function development(node, options) {
   const {
     nodeName,
     verbose = true,
-    logger
+    logger: logger3
   } = options;
-  const actualLogger = logger || createLogger(nodeName, { level: "debug" /* DEBUG */ });
+  const actualLogger = logger3 || createLogger(nodeName, { level: "debug" /* DEBUG */ });
   return withLogging2({
     logger: actualLogger,
     name: nodeName,

package/dist/index.d.cts

@@ -3013,6 +3013,15 @@ interface Logger {
      * Log an error message
      */
     error(message: string, data?: Record<string, any>): void;
+    /**
+     * Check if debug logging is enabled
+     * Useful for avoiding expensive computations when debug is disabled
+     */
+    isDebugEnabled(): boolean;
+    /**
+     * Check if a specific log level is enabled
+     */
+    isLevelEnabled(level: LogLevel): boolean;
     /**
      * Create a child logger with additional context
      */
@@ -3022,6 +3031,7 @@ interface Logger {
  * Create a structured logger.
  *
  * @example
+ * Basic usage:
  * ```typescript
  * import { createLogger, LogLevel } from '@agentforge/core';
  *
@@ -3034,6 +3044,16 @@ interface Logger {
  * logger.error('Request failed', { error: err.message });
  * ```
  *
+ * @example
+ * Performance optimization with isDebugEnabled:
+ * ```typescript
+ * // Avoid expensive computations when debug is disabled
+ * if (logger.isDebugEnabled()) {
+ *   const expensiveData = computeExpensiveDebugInfo();
+ *   logger.debug('Debug info', expensiveData);
+ * }
+ * ```
+ *
  * @param name - Logger name (typically the agent or component name)
  * @param options - Logger configuration options
  * @returns A logger instance

package/dist/index.d.ts

@@ -3013,6 +3013,15 @@ interface Logger {
      * Log an error message
      */
     error(message: string, data?: Record<string, any>): void;
+    /**
+     * Check if debug logging is enabled
+     * Useful for avoiding expensive computations when debug is disabled
+     */
+    isDebugEnabled(): boolean;
+    /**
+     * Check if a specific log level is enabled
+     */
+    isLevelEnabled(level: LogLevel): boolean;
     /**
      * Create a child logger with additional context
      */
@@ -3022,6 +3031,7 @@ interface Logger {
  * Create a structured logger.
  *
  * @example
+ * Basic usage:
  * ```typescript
  * import { createLogger, LogLevel } from '@agentforge/core';
  *
@@ -3034,6 +3044,16 @@ interface Logger {
  * logger.error('Request failed', { error: err.message });
  * ```
  *
+ * @example
+ * Performance optimization with isDebugEnabled:
+ * ```typescript
+ * // Avoid expensive computations when debug is disabled
+ * if (logger.isDebugEnabled()) {
+ *   const expensiveData = computeExpensiveDebugInfo();
+ *   logger.debug('Debug info', expensiveData);
+ * }
+ * ```
+ *
  * @param name - Logger name (typically the agent or component name)
  * @param options - Logger configuration options
  * @returns A logger instance

package/dist/index.js

@@ -647,7 +647,103 @@ Examples:`);
   return parts.join("\n");
 }
 
+// src/langgraph/observability/logger.ts
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2["DEBUG"] = "debug";
+  LogLevel2["INFO"] = "info";
+  LogLevel2["WARN"] = "warn";
+  LogLevel2["ERROR"] = "error";
+  return LogLevel2;
+})(LogLevel || {});
+var LOG_LEVEL_PRIORITY = {
+  ["debug" /* DEBUG */]: 0,
+  ["info" /* INFO */]: 1,
+  ["warn" /* WARN */]: 2,
+  ["error" /* ERROR */]: 3
+};
+var LoggerImpl = class _LoggerImpl {
+  name;
+  options;
+  context;
+  constructor(name, options = {}, context = {}) {
+    this.name = name;
+    this.context = context;
+    this.options = {
+      level: options.level ?? "info" /* INFO */,
+      format: options.format ?? "pretty",
+      destination: options.destination ?? process.stdout,
+      includeTimestamp: options.includeTimestamp ?? true,
+      includeContext: options.includeContext ?? true
+    };
+  }
+  debug(message, data) {
+    this.log("debug" /* DEBUG */, message, data);
+  }
+  info(message, data) {
+    this.log("info" /* INFO */, message, data);
+  }
+  warn(message, data) {
+    this.log("warn" /* WARN */, message, data);
+  }
+  error(message, data) {
+    this.log("error" /* ERROR */, message, data);
+  }
+  isDebugEnabled() {
+    return this.isLevelEnabled("debug" /* DEBUG */);
+  }
+  isLevelEnabled(level) {
+    return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[this.options.level];
+  }
+  withContext(context) {
+    return new _LoggerImpl(this.name, this.options, { ...this.context, ...context });
+  }
+  log(level, message, data) {
+    if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.options.level]) {
+      return;
+    }
+    const entry = {
+      level,
+      name: this.name,
+      message
+    };
+    if (this.options.includeTimestamp) {
+      entry.timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    }
+    if (this.options.includeContext && Object.keys(this.context).length > 0) {
+      entry.context = this.context;
+    }
+    if (data) {
+      entry.data = data;
+    }
+    const output = this.format(entry);
+    this.options.destination.write(output + "\n");
+  }
+  format(entry) {
+    if (this.options.format === "json") {
+      return JSON.stringify(entry);
+    }
+    const parts = [];
+    if (entry.timestamp) {
+      parts.push(`[${entry.timestamp}]`);
+    }
+    parts.push(`[${entry.level.toUpperCase()}]`);
+    parts.push(`[${entry.name}]`);
+    parts.push(entry.message);
+    if (entry.context) {
+      parts.push(`context=${JSON.stringify(entry.context)}`);
+    }
+    if (entry.data) {
+      parts.push(`data=${JSON.stringify(entry.data)}`);
+    }
+    return parts.join(" ");
+  }
+};
+function createLogger(name, options) {
+  return new LoggerImpl(name, options);
+}
+
 // src/tools/registry.ts
+var logger = createLogger("agentforge:core:tools:registry", { level: "info" /* INFO */ });
 var RegistryEvent = /* @__PURE__ */ ((RegistryEvent2) => {
   RegistryEvent2["TOOL_REGISTERED"] = "tool:registered";
   RegistryEvent2["TOOL_REMOVED"] = "tool:removed";
@@ -939,7 +1035,11 @@ var ToolRegistry = class {
         try {
           handler(data);
         } catch (error) {
-          console.error(`Error in event handler for ${event}:`, error);
+          logger.error("Event handler error", {
+            event,
+            error: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : void 0
+          });
         }
       });
     }
@@ -1337,6 +1437,7 @@ function createToolExecutor(config = {}) {
 }
 
 // src/tools/lifecycle.ts
+var logger2 = createLogger("agentforge:core:tools:lifecycle", { level: "info" /* INFO */ });
 var ManagedTool = class {
   name;
   description;
@@ -1367,7 +1468,13 @@ var ManagedTool = class {
     this._context = config.context;
     if (this.autoCleanup) {
       process.on("beforeExit", () => {
-        this.cleanup().catch(console.error);
+        this.cleanup().catch(
+          (err) => logger2.error("Cleanup failed", {
+            toolName: this.name,
+            error: err instanceof Error ? err.message : String(err),
+            stack: err instanceof Error ? err.stack : void 0
+          })
+        );
       });
     }
   }
@@ -2237,95 +2344,6 @@ function withTracing(node, options) {
   };
 }
 
-// src/langgraph/observability/logger.ts
-var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
-  LogLevel2["DEBUG"] = "debug";
-  LogLevel2["INFO"] = "info";
-  LogLevel2["WARN"] = "warn";
-  LogLevel2["ERROR"] = "error";
-  return LogLevel2;
-})(LogLevel || {});
-var LOG_LEVEL_PRIORITY = {
-  ["debug" /* DEBUG */]: 0,
-  ["info" /* INFO */]: 1,
-  ["warn" /* WARN */]: 2,
-  ["error" /* ERROR */]: 3
-};
-var LoggerImpl = class _LoggerImpl {
-  name;
-  options;
-  context;
-  constructor(name, options = {}, context = {}) {
-    this.name = name;
-    this.context = context;
-    this.options = {
-      level: options.level ?? "info" /* INFO */,
-      format: options.format ?? "pretty",
-      destination: options.destination ?? process.stdout,
-      includeTimestamp: options.includeTimestamp ?? true,
-      includeContext: options.includeContext ?? true
-    };
-  }
-  debug(message, data) {
-    this.log("debug" /* DEBUG */, message, data);
-  }
-  info(message, data) {
-    this.log("info" /* INFO */, message, data);
-  }
-  warn(message, data) {
-    this.log("warn" /* WARN */, message, data);
-  }
-  error(message, data) {
-    this.log("error" /* ERROR */, message, data);
-  }
-  withContext(context) {
-    return new _LoggerImpl(this.name, this.options, { ...this.context, ...context });
-  }
-  log(level, message, data) {
-    if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.options.level]) {
-      return;
-    }
-    const entry = {
-      level,
-      name: this.name,
-      message
-    };
-    if (this.options.includeTimestamp) {
-      entry.timestamp = (/* @__PURE__ */ new Date()).toISOString();
-    }
-    if (this.options.includeContext && Object.keys(this.context).length > 0) {
-      entry.context = this.context;
-    }
-    if (data) {
-      entry.data = data;
-    }
-    const output = this.format(entry);
-    this.options.destination.write(output + "\n");
-  }
-  format(entry) {
-    if (this.options.format === "json") {
-      return JSON.stringify(entry);
-    }
-    const parts = [];
-    if (entry.timestamp) {
-      parts.push(`[${entry.timestamp}]`);
-    }
-    parts.push(`[${entry.level.toUpperCase()}]`);
-    parts.push(`[${entry.name}]`);
-    parts.push(entry.message);
-    if (entry.context) {
-      parts.push(`context=${JSON.stringify(entry.context)}`);
-    }
-    if (entry.data) {
-      parts.push(`data=${JSON.stringify(entry.data)}`);
-    }
-    return parts.join(" ");
-  }
-};
-function createLogger(name, options) {
-  return new LoggerImpl(name, options);
-}
-
 // src/langgraph/observability/metrics.ts
 var MetricType = /* @__PURE__ */ ((MetricType2) => {
   MetricType2["COUNTER"] = "counter";
@@ -2635,14 +2653,14 @@ var withLogging = (options) => {
     onComplete,
     onError
   } = options;
-  const logger = providedLogger || createLogger(name, { level });
+  const logger3 = providedLogger || createLogger(name, { level });
   return (node) => {
     return async (state) => {
       const startTime = Date.now();
       try {
         if (logInput) {
           const data = extractData ? extractData(state) : { state };
-          logger.info("Node execution started", data);
+          logger3.info("Node execution started", data);
         }
         if (onStart) {
           onStart(state);
@@ -2652,9 +2670,9 @@ var withLogging = (options) => {
         if (logOutput) {
           const data = extractData ? extractData(result) : { result };
           if (logDuration) {
-            logger.info(`Node execution completed (${duration}ms)`, data);
+            logger3.info(`Node execution completed (${duration}ms)`, data);
           } else {
-            logger.info("Node execution completed", data);
+            logger3.info("Node execution completed", data);
           }
         }
         if (onComplete) {
@@ -2665,7 +2683,7 @@ var withLogging = (options) => {
         const duration = Date.now() - startTime;
         const err = error instanceof Error ? error : new Error(String(error));
         if (logErrors) {
-          logger.error(`Node execution failed (${duration}ms)`, {
+          logger3.error(`Node execution failed (${duration}ms)`, {
             error: err.message,
             stack: err.stack
           });
@@ -2701,7 +2719,7 @@ function withLogging2(options) {
 function production(node, options) {
   const {
     nodeName,
-    logger,
+    logger: logger3,
     enableMetrics = true,
     enableTracing = true,
     enableRetry = true,
@@ -2709,7 +2727,7 @@ function production(node, options) {
     retryOptions = {},
     errorOptions = {}
   } = options;
-  const actualLogger = logger || createLogger(nodeName, { level: "info" /* INFO */ });
+  const actualLogger = logger3 || createLogger(nodeName, { level: "info" /* INFO */ });
   const middleware = [];
   middleware.push(
     withLogging2({
@@ -2773,9 +2791,9 @@ function development(node, options) {
   const {
     nodeName,
     verbose = true,
-    logger
+    logger: logger3
   } = options;
-  const actualLogger = logger || createLogger(nodeName, { level: "debug" /* DEBUG */ });
+  const actualLogger = logger3 || createLogger(nodeName, { level: "debug" /* DEBUG */ });
   return withLogging2({
     logger: actualLogger,
     name: nodeName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge/core",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "Core abstractions for AgentForge - production-ready deep agents framework",
   "type": "module",
   "main": "./dist/index.cjs",