@agentforge/core 0.11.0 → 0.11.1

package/dist/index.cjs

@@ -1465,6 +1465,7 @@ var ToolRegistry = class {
 };
 
 // src/tools/executor.ts
+var logger2 = createLogger("agentforge:tools:executor");
 var PRIORITY_ORDER = {
   critical: 0,
   high: 1,
@@ -1511,7 +1512,14 @@ function createToolExecutor(config = {}) {
   async function executeWithRetry(tool, input, policy) {
     const executeFn = tool.invoke || tool.execute;
     if (!executeFn) {
-      throw new Error("Tool must implement either invoke() or execute() method");
+      throw new Error(
+        "Tool must implement invoke() method. Tools created with createTool() or toolBuilder automatically have this method. If you are manually constructing a tool, ensure it has an invoke() method."
+      );
+    }
+    if (!tool.invoke && tool.execute) {
+      logger2.warn(
+        `Tool "${tool.metadata?.name || "unknown"}" only implements execute() which is deprecated. Please update to implement invoke() as the primary method. execute() will be removed in v1.0.0.`
+      );
     }
     if (!policy) {
       return await executeFn.call(tool, input);
@@ -1635,7 +1643,7 @@ function createToolExecutor(config = {}) {
 }
 
 // src/tools/lifecycle.ts
-var logger2 = createLogger("agentforge:core:tools:lifecycle", { level: "info" /* INFO */ });
+var logger3 = createLogger("agentforge:core:tools:lifecycle", { level: "info" /* INFO */ });
 var ManagedTool = class {
   name;
   description;
@@ -1667,7 +1675,7 @@ var ManagedTool = class {
     if (this.autoCleanup) {
       process.on("beforeExit", () => {
         this.cleanup().catch(
-          (err) => logger2.error("Cleanup failed", {
+          (err) => logger3.error("Cleanup failed", {
             toolName: this.name,
             error: err instanceof Error ? err.message : String(err),
             stack: err instanceof Error ? err.stack : void 0
@@ -2636,14 +2644,14 @@ var withLogging = (options) => {
     onComplete,
     onError
   } = options;
-  const logger3 = providedLogger || createLogger(name, { level });
+  const logger4 = providedLogger || createLogger(name, { level });
   return (node) => {
     return async (state) => {
       const startTime = Date.now();
       try {
         if (logInput) {
           const data = extractData ? extractData(state) : { state };
-          logger3.info("Node execution started", data);
+          logger4.info("Node execution started", data);
         }
         if (onStart) {
           onStart(state);
@@ -2653,9 +2661,9 @@ var withLogging = (options) => {
         if (logOutput) {
           const data = extractData ? extractData(result) : { result };
           if (logDuration) {
-            logger3.info(`Node execution completed (${duration}ms)`, data);
+            logger4.info(`Node execution completed (${duration}ms)`, data);
           } else {
-            logger3.info("Node execution completed", data);
+            logger4.info("Node execution completed", data);
           }
         }
         if (onComplete) {
@@ -2666,7 +2674,7 @@ var withLogging = (options) => {
         const duration = Date.now() - startTime;
         const err = error instanceof Error ? error : new Error(String(error));
         if (logErrors) {
-          logger3.error(`Node execution failed (${duration}ms)`, {
+          logger4.error(`Node execution failed (${duration}ms)`, {
             error: err.message,
             stack: err.stack
           });
@@ -2702,7 +2710,7 @@ function withLogging2(options) {
 function production(node, options) {
   const {
     nodeName,
-    logger: logger3,
+    logger: logger4,
     enableMetrics = true,
     enableTracing = true,
     enableRetry = true,
@@ -2710,7 +2718,7 @@ function production(node, options) {
     retryOptions = {},
     errorOptions = {}
   } = options;
-  const actualLogger = logger3 || createLogger(nodeName, { level: "info" /* INFO */ });
+  const actualLogger = logger4 || createLogger(nodeName, { level: "info" /* INFO */ });
   const middleware = [];
   middleware.push(
     withLogging2({
@@ -2774,9 +2782,9 @@ function development(node, options) {
   const {
     nodeName,
     verbose = true,
-    logger: logger3
+    logger: logger4
   } = options;
-  const actualLogger = logger3 || createLogger(nodeName, { level: "debug" /* DEBUG */ });
+  const actualLogger = logger4 || createLogger(nodeName, { level: "debug" /* DEBUG */ });
   return withLogging2({
     logger: actualLogger,
     name: nodeName,

package/dist/index.js

@@ -1309,6 +1309,7 @@ var ToolRegistry = class {
 };
 
 // src/tools/executor.ts
+var logger2 = createLogger("agentforge:tools:executor");
 var PRIORITY_ORDER = {
   critical: 0,
   high: 1,
@@ -1355,7 +1356,14 @@ function createToolExecutor(config = {}) {
   async function executeWithRetry(tool, input, policy) {
     const executeFn = tool.invoke || tool.execute;
     if (!executeFn) {
-      throw new Error("Tool must implement either invoke() or execute() method");
+      throw new Error(
+        "Tool must implement invoke() method. Tools created with createTool() or toolBuilder automatically have this method. If you are manually constructing a tool, ensure it has an invoke() method."
+      );
+    }
+    if (!tool.invoke && tool.execute) {
+      logger2.warn(
+        `Tool "${tool.metadata?.name || "unknown"}" only implements execute() which is deprecated. Please update to implement invoke() as the primary method. execute() will be removed in v1.0.0.`
+      );
     }
     if (!policy) {
       return await executeFn.call(tool, input);
@@ -1479,7 +1487,7 @@ function createToolExecutor(config = {}) {
 }
 
 // src/tools/lifecycle.ts
-var logger2 = createLogger("agentforge:core:tools:lifecycle", { level: "info" /* INFO */ });
+var logger3 = createLogger("agentforge:core:tools:lifecycle", { level: "info" /* INFO */ });
 var ManagedTool = class {
   name;
   description;
@@ -1511,7 +1519,7 @@ var ManagedTool = class {
     if (this.autoCleanup) {
       process.on("beforeExit", () => {
         this.cleanup().catch(
-          (err) => logger2.error("Cleanup failed", {
+          (err) => logger3.error("Cleanup failed", {
             toolName: this.name,
             error: err instanceof Error ? err.message : String(err),
             stack: err instanceof Error ? err.stack : void 0
@@ -2480,14 +2488,14 @@ var withLogging = (options) => {
     onComplete,
     onError
   } = options;
-  const logger3 = providedLogger || createLogger(name, { level });
+  const logger4 = providedLogger || createLogger(name, { level });
   return (node) => {
     return async (state) => {
       const startTime = Date.now();
       try {
         if (logInput) {
           const data = extractData ? extractData(state) : { state };
-          logger3.info("Node execution started", data);
+          logger4.info("Node execution started", data);
         }
         if (onStart) {
           onStart(state);
@@ -2497,9 +2505,9 @@ var withLogging = (options) => {
         if (logOutput) {
           const data = extractData ? extractData(result) : { result };
           if (logDuration) {
-            logger3.info(`Node execution completed (${duration}ms)`, data);
+            logger4.info(`Node execution completed (${duration}ms)`, data);
           } else {
-            logger3.info("Node execution completed", data);
+            logger4.info("Node execution completed", data);
           }
         }
         if (onComplete) {
@@ -2510,7 +2518,7 @@ var withLogging = (options) => {
         const duration = Date.now() - startTime;
         const err = error instanceof Error ? error : new Error(String(error));
         if (logErrors) {
-          logger3.error(`Node execution failed (${duration}ms)`, {
+          logger4.error(`Node execution failed (${duration}ms)`, {
             error: err.message,
             stack: err.stack
           });
@@ -2546,7 +2554,7 @@ function withLogging2(options) {
 function production(node, options) {
   const {
     nodeName,
-    logger: logger3,
+    logger: logger4,
     enableMetrics = true,
     enableTracing = true,
     enableRetry = true,
@@ -2554,7 +2562,7 @@ function production(node, options) {
     retryOptions = {},
     errorOptions = {}
   } = options;
-  const actualLogger = logger3 || createLogger(nodeName, { level: "info" /* INFO */ });
+  const actualLogger = logger4 || createLogger(nodeName, { level: "info" /* INFO */ });
   const middleware = [];
   middleware.push(
     withLogging2({
@@ -2618,9 +2626,9 @@ function development(node, options) {
   const {
     nodeName,
     verbose = true,
-    logger: logger3
+    logger: logger4
   } = options;
-  const actualLogger = logger3 || createLogger(nodeName, { level: "debug" /* DEBUG */ });
+  const actualLogger = logger4 || createLogger(nodeName, { level: "debug" /* DEBUG */ });
   return withLogging2({
     logger: actualLogger,
     name: nodeName,

package/package.json

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