@agentforge/core 0.16.8 → 0.16.10

package/dist/index.cjs

@@ -494,10 +494,50 @@ function validateTool(tool) {
 }
 
 // src/tools/builder.ts
-var ToolBuilder = class {
-  metadata = {};
-  _schema;
-  _invoke;
+function cloneRelations(relations) {
+  if (!relations) {
+    return void 0;
+  }
+  return {
+    requires: relations.requires ? [...relations.requires] : void 0,
+    suggests: relations.suggests ? [...relations.suggests] : void 0,
+    conflicts: relations.conflicts ? [...relations.conflicts] : void 0,
+    follows: relations.follows ? [...relations.follows] : void 0,
+    precedes: relations.precedes ? [...relations.precedes] : void 0
+  };
+}
+function cloneExampleValue(value, exampleIndex, field) {
+  try {
+    return structuredClone(value);
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    throw new TypeError(
+      `Invalid tool example at index ${exampleIndex}: "${field}" must be a structured-cloneable value. Received a non-cloneable value while building the tool metadata. Original error: ${reason}`
+    );
+  }
+}
+function cloneExamples(examples) {
+  return examples?.map((example, index) => ({
+    ...example,
+    input: cloneExampleValue(example.input, index, "input"),
+    output: example.output === void 0 ? void 0 : cloneExampleValue(example.output, index, "output")
+  }));
+}
+function cloneMetadata(metadata) {
+  return {
+    ...metadata,
+    tags: metadata.tags ? [...metadata.tags] : void 0,
+    examples: cloneExamples(metadata.examples),
+    limitations: metadata.limitations ? [...metadata.limitations] : void 0,
+    relations: cloneRelations(metadata.relations)
+  };
+}
+var ToolBuilder = class _ToolBuilder {
+  constructor(metadata = {}, _schema, _invoke) {
+    this.metadata = metadata;
+    this._schema = _schema;
+    this._invoke = _invoke;
+  }
   /**
    * Set the tool name (required)
    * 
@@ -697,14 +737,13 @@ var ToolBuilder = class {
   }
   /**
    * Set the input schema (required)
-   * 
+   *
    * All fields MUST have .describe() for LLM understanding!
-   * 
+   *
    * @param schema - Zod schema for input validation
    */
   schema(schema) {
-    this._schema = schema;
-    return this;
+    return new _ToolBuilder(cloneMetadata(this.metadata), schema, this._invoke);
   }
   /**
    * Set the implementation function (required)
@@ -712,8 +751,10 @@ var ToolBuilder = class {
    * @param invoke - Async function that implements the tool
    */
   implement(invoke) {
-    this._invoke = invoke;
-    return this;
+    const wrappedInvoke = async function(input) {
+      return invoke.call(this, input);
+    };
+    return new _ToolBuilder(cloneMetadata(this.metadata), this._schema, wrappedInvoke);
   }
   /**
    * Set the implementation function with automatic error handling
@@ -739,9 +780,9 @@ var ToolBuilder = class {
    * ```
    */
   implementSafe(invoke) {
-    const safeInvoke = async (input) => {
+    const safeInvoke = async function(input) {
       try {
-        const data = await invoke(input);
+        const data = await invoke.call(this, input);
         return { success: true, data };
       } catch (error) {
         return {
@@ -750,8 +791,14 @@ var ToolBuilder = class {
         };
       }
     };
-    this._invoke = safeInvoke;
-    return this;
+    const wrappedInvoke = async function(input) {
+      return safeInvoke.call(this, input);
+    };
+    return new _ToolBuilder(
+      cloneMetadata(this.metadata),
+      this._schema,
+      wrappedInvoke
+    );
   }
   /**
    * Build the tool with validation
@@ -780,10 +827,13 @@ var ToolBuilder = class {
     if (!this._invoke) {
       throw new Error("Tool implementation is required. Use .implement() to set it.");
     }
+    const invoke = this._invoke;
     return createTool(
       this.metadata,
       this._schema,
-      this._invoke
+      async function(input) {
+        return invoke.call(this, input);
+      }
     );
   }
 };

package/dist/index.d.cts

@@ -941,6 +941,7 @@ declare function validateTool(tool: Tool): {
  * ```
  */
 
+type ToolInvoke<TOutput> = (this: unknown, input: unknown) => Promise<TOutput>;
 /**
  * Builder for creating tools with a fluent API
  *
@@ -951,6 +952,7 @@ declare class ToolBuilder<TInput = unknown, TOutput = unknown> {
     private metadata;
     private _schema?;
     private _invoke?;
+    constructor(metadata?: Partial<ToolMetadata>, _schema?: z.ZodSchema<TInput> | undefined, _invoke?: ToolInvoke<TOutput> | undefined);
     /**
      * Set the tool name (required)
      *

package/dist/index.d.ts

@@ -941,6 +941,7 @@ declare function validateTool(tool: Tool): {
  * ```
  */
 
+type ToolInvoke<TOutput> = (this: unknown, input: unknown) => Promise<TOutput>;
 /**
  * Builder for creating tools with a fluent API
  *
@@ -951,6 +952,7 @@ declare class ToolBuilder<TInput = unknown, TOutput = unknown> {
     private metadata;
     private _schema?;
     private _invoke?;
+    constructor(metadata?: Partial<ToolMetadata>, _schema?: z.ZodSchema<TInput> | undefined, _invoke?: ToolInvoke<TOutput> | undefined);
     /**
      * Set the tool name (required)
      *

package/dist/index.js

@@ -319,10 +319,50 @@ function validateTool(tool) {
 }
 
 // src/tools/builder.ts
-var ToolBuilder = class {
-  metadata = {};
-  _schema;
-  _invoke;
+function cloneRelations(relations) {
+  if (!relations) {
+    return void 0;
+  }
+  return {
+    requires: relations.requires ? [...relations.requires] : void 0,
+    suggests: relations.suggests ? [...relations.suggests] : void 0,
+    conflicts: relations.conflicts ? [...relations.conflicts] : void 0,
+    follows: relations.follows ? [...relations.follows] : void 0,
+    precedes: relations.precedes ? [...relations.precedes] : void 0
+  };
+}
+function cloneExampleValue(value, exampleIndex, field) {
+  try {
+    return structuredClone(value);
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    throw new TypeError(
+      `Invalid tool example at index ${exampleIndex}: "${field}" must be a structured-cloneable value. Received a non-cloneable value while building the tool metadata. Original error: ${reason}`
+    );
+  }
+}
+function cloneExamples(examples) {
+  return examples?.map((example, index) => ({
+    ...example,
+    input: cloneExampleValue(example.input, index, "input"),
+    output: example.output === void 0 ? void 0 : cloneExampleValue(example.output, index, "output")
+  }));
+}
+function cloneMetadata(metadata) {
+  return {
+    ...metadata,
+    tags: metadata.tags ? [...metadata.tags] : void 0,
+    examples: cloneExamples(metadata.examples),
+    limitations: metadata.limitations ? [...metadata.limitations] : void 0,
+    relations: cloneRelations(metadata.relations)
+  };
+}
+var ToolBuilder = class _ToolBuilder {
+  constructor(metadata = {}, _schema, _invoke) {
+    this.metadata = metadata;
+    this._schema = _schema;
+    this._invoke = _invoke;
+  }
   /**
    * Set the tool name (required)
    * 
@@ -522,14 +562,13 @@ var ToolBuilder = class {
   }
   /**
    * Set the input schema (required)
-   * 
+   *
    * All fields MUST have .describe() for LLM understanding!
-   * 
+   *
    * @param schema - Zod schema for input validation
    */
   schema(schema) {
-    this._schema = schema;
-    return this;
+    return new _ToolBuilder(cloneMetadata(this.metadata), schema, this._invoke);
   }
   /**
    * Set the implementation function (required)
@@ -537,8 +576,10 @@ var ToolBuilder = class {
    * @param invoke - Async function that implements the tool
    */
   implement(invoke) {
-    this._invoke = invoke;
-    return this;
+    const wrappedInvoke = async function(input) {
+      return invoke.call(this, input);
+    };
+    return new _ToolBuilder(cloneMetadata(this.metadata), this._schema, wrappedInvoke);
   }
   /**
    * Set the implementation function with automatic error handling
@@ -564,9 +605,9 @@ var ToolBuilder = class {
    * ```
    */
   implementSafe(invoke) {
-    const safeInvoke = async (input) => {
+    const safeInvoke = async function(input) {
       try {
-        const data = await invoke(input);
+        const data = await invoke.call(this, input);
         return { success: true, data };
       } catch (error) {
         return {
@@ -575,8 +616,14 @@ var ToolBuilder = class {
         };
       }
     };
-    this._invoke = safeInvoke;
-    return this;
+    const wrappedInvoke = async function(input) {
+      return safeInvoke.call(this, input);
+    };
+    return new _ToolBuilder(
+      cloneMetadata(this.metadata),
+      this._schema,
+      wrappedInvoke
+    );
   }
   /**
    * Build the tool with validation
@@ -605,10 +652,13 @@ var ToolBuilder = class {
     if (!this._invoke) {
       throw new Error("Tool implementation is required. Use .implement() to set it.");
     }
+    const invoke = this._invoke;
     return createTool(
       this.metadata,
       this._schema,
-      this._invoke
+      async function(input) {
+        return invoke.call(this, input);
+      }
     );
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge/core",
-  "version": "0.16.8",
+  "version": "0.16.10",
   "description": "Production-ready TypeScript agent framework built on LangGraph with orchestration, middleware, and typed abstractions.",
   "type": "module",
   "main": "./dist/index.cjs",