@agentforge/core 0.6.3 → 0.7.0

package/dist/index.cjs

@@ -688,13 +688,51 @@ var ToolBuilder = class {
   }
   /**
    * Set the implementation function (required)
-   * 
+   *
    * @param execute - Async function that implements the tool
    */
   implement(execute) {
     this._execute = execute;
     return this;
   }
+  /**
+   * Set the implementation function with automatic error handling
+   *
+   * Wraps the implementation in a try-catch block and returns a standardized
+   * result object with success/error information.
+   *
+   * @param execute - Async function that implements the tool
+   * @returns ToolBuilder with safe result type { success: boolean; data?: T; error?: string }
+   *
+   * @example
+   * ```ts
+   * const tool = toolBuilder()
+   *   .name('read-file')
+   *   .schema(z.object({ path: z.string() }))
+   *   .implementSafe(async ({ path }) => {
+   *     return await fs.readFile(path, 'utf-8');
+   *   })
+   *   .build();
+   *
+   * // Result will be: { success: true, data: "file content" }
+   * // Or on error: { success: false, error: "ENOENT: no such file..." }
+   * ```
+   */
+  implementSafe(execute) {
+    const safeExecute = async (input) => {
+      try {
+        const data = await execute(input);
+        return { success: true, data };
+      } catch (error) {
+        return {
+          success: false,
+          error: error instanceof Error ? error.message : String(error)
+        };
+      }
+    };
+    this._execute = safeExecute;
+    return this;
+  }
   /**
    * Build the tool with validation
    * 
@@ -803,7 +841,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 +1229,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 +1631,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 +1662,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 +2538,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 +2847,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 +2864,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 +2877,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 +2913,7 @@ function withLogging2(options) {
 function production(node, options) {
   const {
     nodeName,
-    logger,
+    logger: logger3,
     enableMetrics = true,
     enableTracing = true,
     enableRetry = true,
@@ -2865,7 +2921,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 +2985,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

@@ -1070,6 +1070,34 @@ declare class ToolBuilder<TInput = unknown, TOutput = unknown> {
      * @param execute - Async function that implements the tool
      */
     implement<T>(execute: (input: TInput) => Promise<T>): ToolBuilder<TInput, T>;
+    /**
+     * Set the implementation function with automatic error handling
+     *
+     * Wraps the implementation in a try-catch block and returns a standardized
+     * result object with success/error information.
+     *
+     * @param execute - Async function that implements the tool
+     * @returns ToolBuilder with safe result type { success: boolean; data?: T; error?: string }
+     *
+     * @example
+     * ```ts
+     * const tool = toolBuilder()
+     *   .name('read-file')
+     *   .schema(z.object({ path: z.string() }))
+     *   .implementSafe(async ({ path }) => {
+     *     return await fs.readFile(path, 'utf-8');
+     *   })
+     *   .build();
+     *
+     * // Result will be: { success: true, data: "file content" }
+     * // Or on error: { success: false, error: "ENOENT: no such file..." }
+     * ```
+     */
+    implementSafe<T>(execute: (input: TInput) => Promise<T>): ToolBuilder<TInput, {
+        success: boolean;
+        data?: T;
+        error?: string;
+    }>;
     /**
      * Build the tool with validation
      *
@@ -3013,6 +3041,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 +3059,7 @@ interface Logger {
  * Create a structured logger.
  *
  * @example
+ * Basic usage:
  * ```typescript
  * import { createLogger, LogLevel } from '@agentforge/core';
  *
@@ -3034,6 +3072,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

@@ -1070,6 +1070,34 @@ declare class ToolBuilder<TInput = unknown, TOutput = unknown> {
      * @param execute - Async function that implements the tool
      */
     implement<T>(execute: (input: TInput) => Promise<T>): ToolBuilder<TInput, T>;
+    /**
+     * Set the implementation function with automatic error handling
+     *
+     * Wraps the implementation in a try-catch block and returns a standardized
+     * result object with success/error information.
+     *
+     * @param execute - Async function that implements the tool
+     * @returns ToolBuilder with safe result type { success: boolean; data?: T; error?: string }
+     *
+     * @example
+     * ```ts
+     * const tool = toolBuilder()
+     *   .name('read-file')
+     *   .schema(z.object({ path: z.string() }))
+     *   .implementSafe(async ({ path }) => {
+     *     return await fs.readFile(path, 'utf-8');
+     *   })
+     *   .build();
+     *
+     * // Result will be: { success: true, data: "file content" }
+     * // Or on error: { success: false, error: "ENOENT: no such file..." }
+     * ```
+     */
+    implementSafe<T>(execute: (input: TInput) => Promise<T>): ToolBuilder<TInput, {
+        success: boolean;
+        data?: T;
+        error?: string;
+    }>;
     /**
      * Build the tool with validation
      *
@@ -3013,6 +3041,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 +3059,7 @@ interface Logger {
  * Create a structured logger.
  *
  * @example
+ * Basic usage:
  * ```typescript
  * import { createLogger, LogLevel } from '@agentforge/core';
  *
@@ -3034,6 +3072,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

@@ -532,13 +532,51 @@ var ToolBuilder = class {
   }
   /**
    * Set the implementation function (required)
-   * 
+   *
    * @param execute - Async function that implements the tool
    */
   implement(execute) {
     this._execute = execute;
     return this;
   }
+  /**
+   * Set the implementation function with automatic error handling
+   *
+   * Wraps the implementation in a try-catch block and returns a standardized
+   * result object with success/error information.
+   *
+   * @param execute - Async function that implements the tool
+   * @returns ToolBuilder with safe result type { success: boolean; data?: T; error?: string }
+   *
+   * @example
+   * ```ts
+   * const tool = toolBuilder()
+   *   .name('read-file')
+   *   .schema(z.object({ path: z.string() }))
+   *   .implementSafe(async ({ path }) => {
+   *     return await fs.readFile(path, 'utf-8');
+   *   })
+   *   .build();
+   *
+   * // Result will be: { success: true, data: "file content" }
+   * // Or on error: { success: false, error: "ENOENT: no such file..." }
+   * ```
+   */
+  implementSafe(execute) {
+    const safeExecute = async (input) => {
+      try {
+        const data = await execute(input);
+        return { success: true, data };
+      } catch (error) {
+        return {
+          success: false,
+          error: error instanceof Error ? error.message : String(error)
+        };
+      }
+    };
+    this._execute = safeExecute;
+    return this;
+  }
   /**
    * Build the tool with validation
    * 
@@ -647,7 +685,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 +1073,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 +1475,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 +1506,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 +2382,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 +2691,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 +2708,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 +2721,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 +2757,7 @@ function withLogging2(options) {
 function production(node, options) {
   const {
     nodeName,
-    logger,
+    logger: logger3,
     enableMetrics = true,
     enableTracing = true,
     enableRetry = true,
@@ -2709,7 +2765,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 +2829,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.7.0",
   "description": "Core abstractions for AgentForge - production-ready deep agents framework",
   "type": "module",
   "main": "./dist/index.cjs",