@agentforge/core 0.6.4 → 0.8.0

package/README.md

@@ -12,7 +12,7 @@
 
 ## ✨ Features
 
-### 🛠️ Tool System (Phase 1)
+### 🛠️ Tool System
 - **Rich Metadata** - Categories, tags, examples, and detailed descriptions
 - **Fluent Builder API** - Easy tool creation with `createTool()`
 - **Tool Registry** - Centralized management with querying and events
@@ -20,7 +20,7 @@
 - **Prompt Generation** - Automatic LLM-friendly prompt generation
 - **113 tests** - Comprehensive test coverage
 
-### 📊 LangGraph Utilities (Phase 2)
+### 📊 LangGraph Utilities
 - **State Management** - Type-safe state annotations with Zod validation
 - **Workflow Builders** - Sequential, parallel, and conditional patterns
 - **Error Handling** - Retry, error handling, and timeout utilities
@@ -29,13 +29,13 @@
 - **Observability** - LangSmith integration, metrics, logging, error reporting
 - **158 tests** - Full coverage of all utilities
 
-### � Middleware System (Phase 4)
+### � Middleware System
 - **Composable Middleware** - Caching, rate limiting, validation, concurrency control
 - **Production Presets** - Ready-to-use middleware stacks
 - **Development Tools** - Logging, debugging, and testing middleware
 - **94 tests** - Comprehensive middleware testing
 
-### 🌊 Streaming & Real-time (Phase 5.1)
+### 🌊 Streaming & Real-time
 - **Stream Transformers** - Filter, map, batch, debounce, throttle
 - **Stream Aggregators** - Collect, reduce, window operations
 - **SSE Support** - Server-Sent Events for real-time updates
@@ -43,25 +43,25 @@
 - **Progress Tracking** - Monitor long-running operations
 - **68 tests** - Full streaming coverage
 
-### 🛠️ Advanced Tools (Phase 5.2)
+### 🛠️ Advanced Tools
 - **Async Execution** - Parallel and sequential tool execution
 - **Lifecycle Management** - Setup, teardown, and cleanup hooks
 - **Tool Composition** - Combine tools into pipelines
 - **Testing Utilities** - Mock tools and test helpers
 
-### 📦 Resource Management (Phase 5.3)
+### 📦 Resource Management
 - **Connection Pooling** - Efficient resource reuse
 - **Memory Management** - Automatic cleanup and limits
 - **Batch Processing** - Efficient bulk operations
 - **Circuit Breaker** - Fault tolerance and resilience
 
-### � Monitoring (Phase 5.4)
+### � Monitoring
 - **Health Checks** - System and component health monitoring
 - **Profiling** - Performance metrics and bottleneck detection
 - **Alerts** - Configurable alerting system
 - **Audit Logging** - Comprehensive activity tracking
 
-### 🚀 Deployment (Phase 5.5)
+### 🚀 Deployment
 - **Docker Support** - Production-ready containers
 - **Kubernetes** - Deployment manifests and guides
 - **CI/CD Templates** - GitHub Actions, GitLab CI

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.8.0",
   "description": "Core abstractions for AgentForge - production-ready deep agents framework",
   "type": "module",
   "main": "./dist/index.cjs",