@agentforge/core 0.6.4 → 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
    * 

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
      *

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
      *

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
    * 

package/package.json

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