@agentforge/core 0.11.0 → 0.11.2

package/README.md

@@ -151,6 +151,13 @@ pnpm test
 pnpm typecheck
 ```
 
+## 🔗 Links
+
+- [GitHub Repository](https://github.com/TVScoundrel/agentforge)
+- [npm Package](https://www.npmjs.com/package/@agentforge/core)
+- [Changelog](https://tvscoundrel.github.io/agentforge/changelog.html) - See what's new before upgrading
+- [Report Issues](https://github.com/TVScoundrel/agentforge/issues)
+
 ## License
 
 MIT © 2026 Tom Van Schoor

package/dist/index.cjs

@@ -1122,6 +1122,21 @@ var ToolRegistry = class {
    * ```
    */
   registerMany(tools) {
+    const inputNames = /* @__PURE__ */ new Set();
+    const duplicatesInInput = [];
+    for (const tool of tools) {
+      const name = tool.metadata.name;
+      if (inputNames.has(name)) {
+        duplicatesInInput.push(name);
+      } else {
+        inputNames.add(name);
+      }
+    }
+    if (duplicatesInInput.length > 0) {
+      throw new Error(
+        `Cannot register tools: duplicate names in input list: ${duplicatesInInput.join(", ")}`
+      );
+    }
     const conflicts = [];
     for (const tool of tools) {
       if (this.tools.has(tool.metadata.name)) {
@@ -1465,6 +1480,7 @@ var ToolRegistry = class {
 };
 
 // src/tools/executor.ts
+var logger2 = createLogger("agentforge:tools:executor");
 var PRIORITY_ORDER = {
   critical: 0,
   high: 1,
@@ -1511,7 +1527,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 +1658,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 +1690,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 +2659,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 +2676,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 +2689,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 +2725,7 @@ function withLogging2(options) {
 function production(node, options) {
   const {
     nodeName,
-    logger: logger3,
+    logger: logger4,
     enableMetrics = true,
     enableTracing = true,
     enableRetry = true,
@@ -2710,7 +2733,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 +2797,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

@@ -966,6 +966,21 @@ var ToolRegistry = class {
    * ```
    */
   registerMany(tools) {
+    const inputNames = /* @__PURE__ */ new Set();
+    const duplicatesInInput = [];
+    for (const tool of tools) {
+      const name = tool.metadata.name;
+      if (inputNames.has(name)) {
+        duplicatesInInput.push(name);
+      } else {
+        inputNames.add(name);
+      }
+    }
+    if (duplicatesInInput.length > 0) {
+      throw new Error(
+        `Cannot register tools: duplicate names in input list: ${duplicatesInInput.join(", ")}`
+      );
+    }
     const conflicts = [];
     for (const tool of tools) {
       if (this.tools.has(tool.metadata.name)) {
@@ -1309,6 +1324,7 @@ var ToolRegistry = class {
 };
 
 // src/tools/executor.ts
+var logger2 = createLogger("agentforge:tools:executor");
 var PRIORITY_ORDER = {
   critical: 0,
   high: 1,
@@ -1355,7 +1371,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 +1502,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 +1534,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 +2503,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 +2520,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 +2533,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 +2569,7 @@ function withLogging2(options) {
 function production(node, options) {
   const {
     nodeName,
-    logger: logger3,
+    logger: logger4,
     enableMetrics = true,
     enableTracing = true,
     enableRetry = true,
@@ -2554,7 +2577,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 +2641,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.2",
   "description": "Core abstractions for AgentForge - production-ready deep agents framework",
   "type": "module",
   "main": "./dist/index.cjs",