@agentforge/core 0.15.6 → 0.15.7

package/dist/index.cjs

@@ -794,21 +794,42 @@ function toolBuilder() {
 // src/langchain/converter.ts
 var import_tools = require("@langchain/core/tools");
 var import_zod_to_json_schema = require("zod-to-json-schema");
+function serializeToolResult(result) {
+  if (typeof result === "string") {
+    return result;
+  }
+  if (typeof result === "object" && result !== null) {
+    return JSON.stringify(result, null, 2);
+  }
+  return String(result);
+}
+function isJsonSchemaObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isJsonSchemaDefinitionMap(value) {
+  if (!isJsonSchemaObject(value)) {
+    return false;
+  }
+  return Object.values(value).every(isJsonSchemaObject);
+}
+function extractToolSchema(jsonSchema) {
+  if (!isJsonSchemaObject(jsonSchema)) {
+    return {};
+  }
+  const ref = jsonSchema.$ref;
+  const definitions = jsonSchema.definitions;
+  if (typeof ref !== "string" || !isJsonSchemaDefinitionMap(definitions)) {
+    return jsonSchema;
+  }
+  const refName = ref.replace("#/definitions/", "");
+  return definitions[refName] ?? jsonSchema;
+}
 function toLangChainTool(tool) {
   return new import_tools.DynamicStructuredTool({
     name: tool.metadata.name,
     description: tool.metadata.description,
     schema: tool.schema,
-    func: async (input) => {
-      const result = await tool.invoke(input);
-      if (typeof result === "string") {
-        return result;
-      }
-      if (typeof result === "object" && result !== null) {
-        return JSON.stringify(result, null, 2);
-      }
-      return String(result);
-    }
+    func: async (input) => serializeToolResult(await tool.invoke(input))
   });
 }
 function toLangChainTools(tools) {
@@ -820,11 +841,7 @@ function getToolJsonSchema(tool) {
     $refStrategy: "none"
     // Don't use $ref for nested schemas
   });
-  if (jsonSchema.$ref && jsonSchema.definitions) {
-    const refName = jsonSchema.$ref.replace("#/definitions/", "");
-    return jsonSchema.definitions[refName] || jsonSchema;
-  }
-  return jsonSchema;
+  return extractToolSchema(jsonSchema);
 }
 function getToolDescription(tool) {
   const { metadata } = tool;

package/dist/index.d.cts

@@ -1794,6 +1794,13 @@ declare function createToolSimulator(config: ToolSimulatorConfig): {
  * ```
  */
 
+type RuntimeSchema<TInput = unknown> = z.ZodSchema<TInput>;
+type JsonSchemaObject = Record<string, unknown>;
+interface LangChainConvertibleTool<TInput = unknown, TOutput = unknown> {
+    metadata: ToolMetadata;
+    schema: RuntimeSchema<TInput>;
+    invoke(input: TInput): Promise<TOutput>;
+}
 /**
  * Convert an AgentForge tool to a LangChain DynamicStructuredTool
  *
@@ -1826,7 +1833,7 @@ declare function createToolSimulator(config: ToolSimulatorConfig): {
  * });
  * ```
  */
-declare function toLangChainTool(tool: Tool<any, any>): DynamicStructuredTool<any>;
+declare function toLangChainTool<TInput, TOutput>(tool: Tool<TInput, TOutput>): DynamicStructuredTool<RuntimeSchema<TInput>, TInput, TInput, string>;
 /**
  * Convert multiple AgentForge tools to LangChain tools
  *
@@ -1844,7 +1851,7 @@ declare function toLangChainTool(tool: Tool<any, any>): DynamicStructuredTool<an
  * });
  * ```
  */
-declare function toLangChainTools(tools: Tool<any, any>[]): DynamicStructuredTool<any>[];
+declare function toLangChainTools(tools: readonly LangChainConvertibleTool[]): DynamicStructuredTool[];
 /**
  * Get the JSON Schema representation of a tool's input schema
  *
@@ -1859,7 +1866,7 @@ declare function toLangChainTools(tools: Tool<any, any>[]): DynamicStructuredToo
  * console.log(JSON.stringify(schema, null, 2));
  * ```
  */
-declare function getToolJsonSchema(tool: Tool<any, any>): Record<string, any>;
+declare function getToolJsonSchema<TInput, TOutput>(tool: Tool<TInput, TOutput>): JsonSchemaObject;
 /**
  * Get tool metadata in a format suitable for LLM prompts
  *
@@ -1880,7 +1887,7 @@ declare function getToolJsonSchema(tool: Tool<any, any>): Record<string, any>;
  * // ...
  * ```
  */
-declare function getToolDescription(tool: Tool<any, any>): string;
+declare function getToolDescription<TInput, TOutput>(tool: Tool<TInput, TOutput>): string;
 
 /**
  * LangGraph State Utilities

package/dist/index.d.ts

@@ -1794,6 +1794,13 @@ declare function createToolSimulator(config: ToolSimulatorConfig): {
  * ```
  */
 
+type RuntimeSchema<TInput = unknown> = z.ZodSchema<TInput>;
+type JsonSchemaObject = Record<string, unknown>;
+interface LangChainConvertibleTool<TInput = unknown, TOutput = unknown> {
+    metadata: ToolMetadata;
+    schema: RuntimeSchema<TInput>;
+    invoke(input: TInput): Promise<TOutput>;
+}
 /**
  * Convert an AgentForge tool to a LangChain DynamicStructuredTool
  *
@@ -1826,7 +1833,7 @@ declare function createToolSimulator(config: ToolSimulatorConfig): {
  * });
  * ```
  */
-declare function toLangChainTool(tool: Tool<any, any>): DynamicStructuredTool<any>;
+declare function toLangChainTool<TInput, TOutput>(tool: Tool<TInput, TOutput>): DynamicStructuredTool<RuntimeSchema<TInput>, TInput, TInput, string>;
 /**
  * Convert multiple AgentForge tools to LangChain tools
  *
@@ -1844,7 +1851,7 @@ declare function toLangChainTool(tool: Tool<any, any>): DynamicStructuredTool<an
  * });
  * ```
  */
-declare function toLangChainTools(tools: Tool<any, any>[]): DynamicStructuredTool<any>[];
+declare function toLangChainTools(tools: readonly LangChainConvertibleTool[]): DynamicStructuredTool[];
 /**
  * Get the JSON Schema representation of a tool's input schema
  *
@@ -1859,7 +1866,7 @@ declare function toLangChainTools(tools: Tool<any, any>[]): DynamicStructuredToo
  * console.log(JSON.stringify(schema, null, 2));
  * ```
  */
-declare function getToolJsonSchema(tool: Tool<any, any>): Record<string, any>;
+declare function getToolJsonSchema<TInput, TOutput>(tool: Tool<TInput, TOutput>): JsonSchemaObject;
 /**
  * Get tool metadata in a format suitable for LLM prompts
  *
@@ -1880,7 +1887,7 @@ declare function getToolJsonSchema(tool: Tool<any, any>): Record<string, any>;
  * // ...
  * ```
  */
-declare function getToolDescription(tool: Tool<any, any>): string;
+declare function getToolDescription<TInput, TOutput>(tool: Tool<TInput, TOutput>): string;
 
 /**
  * LangGraph State Utilities

package/dist/index.js

@@ -619,21 +619,42 @@ function toolBuilder() {
 // src/langchain/converter.ts
 import { DynamicStructuredTool } from "@langchain/core/tools";
 import { zodToJsonSchema } from "zod-to-json-schema";
+function serializeToolResult(result) {
+  if (typeof result === "string") {
+    return result;
+  }
+  if (typeof result === "object" && result !== null) {
+    return JSON.stringify(result, null, 2);
+  }
+  return String(result);
+}
+function isJsonSchemaObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isJsonSchemaDefinitionMap(value) {
+  if (!isJsonSchemaObject(value)) {
+    return false;
+  }
+  return Object.values(value).every(isJsonSchemaObject);
+}
+function extractToolSchema(jsonSchema) {
+  if (!isJsonSchemaObject(jsonSchema)) {
+    return {};
+  }
+  const ref = jsonSchema.$ref;
+  const definitions = jsonSchema.definitions;
+  if (typeof ref !== "string" || !isJsonSchemaDefinitionMap(definitions)) {
+    return jsonSchema;
+  }
+  const refName = ref.replace("#/definitions/", "");
+  return definitions[refName] ?? jsonSchema;
+}
 function toLangChainTool(tool) {
   return new DynamicStructuredTool({
     name: tool.metadata.name,
     description: tool.metadata.description,
     schema: tool.schema,
-    func: async (input) => {
-      const result = await tool.invoke(input);
-      if (typeof result === "string") {
-        return result;
-      }
-      if (typeof result === "object" && result !== null) {
-        return JSON.stringify(result, null, 2);
-      }
-      return String(result);
-    }
+    func: async (input) => serializeToolResult(await tool.invoke(input))
   });
 }
 function toLangChainTools(tools) {
@@ -645,11 +666,7 @@ function getToolJsonSchema(tool) {
     $refStrategy: "none"
     // Don't use $ref for nested schemas
   });
-  if (jsonSchema.$ref && jsonSchema.definitions) {
-    const refName = jsonSchema.$ref.replace("#/definitions/", "");
-    return jsonSchema.definitions[refName] || jsonSchema;
-  }
-  return jsonSchema;
+  return extractToolSchema(jsonSchema);
 }
 function getToolDescription(tool) {
   const { metadata } = tool;

package/package.json

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