@agentforge/core 0.16.12 → 0.16.13

package/dist/index.cjs

@@ -841,96 +841,29 @@ function toolBuilder() {
   return new 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);
+// src/tools/registry-collection.ts
+function getAllRegistryTools(tools) {
+  return Array.from(tools.values());
 }
-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 getRegistryToolNames(tools) {
+  return Array.from(tools.keys());
 }
-function toLangChainTool(tool) {
-  return new import_tools.DynamicStructuredTool({
-    name: tool.metadata.name,
-    description: tool.metadata.description,
-    schema: tool.schema,
-    func: async (input) => serializeToolResult(await tool.invoke(input))
-  });
+function getRegistryToolsByCategory(tools, category) {
+  return getAllRegistryTools(tools).filter((tool) => tool.metadata.category === category);
 }
-function toLangChainTools(tools) {
-  return tools.map(toLangChainTool);
+function getRegistryToolsByTag(tools, tag) {
+  return getAllRegistryTools(tools).filter((tool) => tool.metadata.tags?.includes(tag));
 }
-function getToolJsonSchema(tool) {
-  const jsonSchema = (0, import_zod_to_json_schema.zodToJsonSchema)(tool.schema, {
-    name: tool.metadata.name,
-    $refStrategy: "none"
-    // Don't use $ref for nested schemas
+function searchRegistryTools(tools, query) {
+  const lowerQuery = query.toLowerCase();
+  return getAllRegistryTools(tools).filter((tool) => {
+    const name = tool.metadata.name.toLowerCase();
+    const displayName = tool.metadata.displayName?.toLowerCase() ?? "";
+    const description = tool.metadata.description.toLowerCase();
+    return name.includes(lowerQuery) || displayName.includes(lowerQuery) || description.includes(lowerQuery);
   });
-  return extractToolSchema(jsonSchema);
-}
-function getToolDescription(tool) {
-  const { metadata } = tool;
-  const parts = [];
-  parts.push(`${metadata.name}: ${metadata.description}`);
-  if (metadata.displayName) {
-    parts.push(`Display Name: ${metadata.displayName}`);
-  }
-  parts.push(`Category: ${metadata.category}`);
-  if (metadata.tags && metadata.tags.length > 0) {
-    parts.push(`Tags: ${metadata.tags.join(", ")}`);
-  }
-  if (metadata.usageNotes) {
-    parts.push(`
-Usage Notes: ${metadata.usageNotes}`);
-  }
-  if (metadata.limitations && metadata.limitations.length > 0) {
-    parts.push(`
-Limitations:`);
-    metadata.limitations.forEach((limit) => {
-      parts.push(`  - ${limit}`);
-    });
-  }
-  if (metadata.examples && metadata.examples.length > 0) {
-    parts.push(`
-Examples:`);
-    metadata.examples.forEach((example, i) => {
-      parts.push(`  ${i + 1}. ${example.description}`);
-      if (example.explanation) {
-        parts.push(`     ${example.explanation}`);
-      }
-    });
-  }
-  return parts.join("\n");
 }
 
-// src/tools/registry.ts
-var import_zod3 = require("zod");
-
 // src/langgraph/observability/logger.ts
 var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
   LogLevel2["DEBUG"] = "debug";
@@ -1026,31 +959,301 @@ function createLogger(name, options) {
   return new LoggerImpl(name, options);
 }
 
-// src/tools/registry-collection.ts
-function getAllRegistryTools(tools) {
-  return Array.from(tools.values());
+// src/tools/registry-events.ts
+var logger = createLogger("agentforge:core:tools:registry", { level: "info" /* INFO */ });
+function addRegistryEventHandler(eventHandlers, event, handler) {
+  if (!eventHandlers.has(event)) {
+    eventHandlers.set(event, /* @__PURE__ */ new Set());
+  }
+  eventHandlers.get(event).add(handler);
 }
-function getRegistryToolNames(tools) {
-  return Array.from(tools.keys());
+function removeRegistryEventHandler(eventHandlers, event, handler) {
+  const handlers = eventHandlers.get(event);
+  if (handlers) {
+    handlers.delete(handler);
+  }
 }
-function getRegistryToolsByCategory(tools, category) {
-  return getAllRegistryTools(tools).filter((tool) => tool.metadata.category === category);
+function emitRegistryEvent(eventHandlers, event, data) {
+  const handlers = eventHandlers.get(event);
+  if (!handlers) {
+    return;
+  }
+  handlers.forEach((handler) => {
+    try {
+      handler(data);
+    } catch (error) {
+      logger.error("Event handler error", {
+        event: String(event),
+        error: error instanceof Error ? error.message : String(error),
+        ...error instanceof Error && error.stack ? { stack: error.stack } : {}
+      });
+    }
+  });
 }
-function getRegistryToolsByTag(tools, tag) {
-  return getAllRegistryTools(tools).filter((tool) => tool.metadata.tags?.includes(tag));
+
+// src/tools/registry-prompt.ts
+var import_zod3 = require("zod");
+
+// 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 searchRegistryTools(tools, query) {
-  const lowerQuery = query.toLowerCase();
-  return getAllRegistryTools(tools).filter((tool) => {
-    const name = tool.metadata.name.toLowerCase();
-    const displayName = tool.metadata.displayName?.toLowerCase() ?? "";
-    const description = tool.metadata.description.toLowerCase();
-    return name.includes(lowerQuery) || displayName.includes(lowerQuery) || description.includes(lowerQuery);
+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) => serializeToolResult(await tool.invoke(input))
   });
 }
+function toLangChainTools(tools) {
+  return tools.map(toLangChainTool);
+}
+function getToolJsonSchema(tool) {
+  const jsonSchema = (0, import_zod_to_json_schema.zodToJsonSchema)(tool.schema, {
+    name: tool.metadata.name,
+    $refStrategy: "none"
+    // Don't use $ref for nested schemas
+  });
+  return extractToolSchema(jsonSchema);
+}
+function getToolDescription(tool) {
+  const { metadata } = tool;
+  const parts = [];
+  parts.push(`${metadata.name}: ${metadata.description}`);
+  if (metadata.displayName) {
+    parts.push(`Display Name: ${metadata.displayName}`);
+  }
+  parts.push(`Category: ${metadata.category}`);
+  if (metadata.tags && metadata.tags.length > 0) {
+    parts.push(`Tags: ${metadata.tags.join(", ")}`);
+  }
+  if (metadata.usageNotes) {
+    parts.push(`
+Usage Notes: ${metadata.usageNotes}`);
+  }
+  if (metadata.limitations && metadata.limitations.length > 0) {
+    parts.push(`
+Limitations:`);
+    metadata.limitations.forEach((limit) => {
+      parts.push(`  - ${limit}`);
+    });
+  }
+  if (metadata.examples && metadata.examples.length > 0) {
+    parts.push(`
+Examples:`);
+    metadata.examples.forEach((example, i) => {
+      parts.push(`  ${i + 1}. ${example.description}`);
+      if (example.explanation) {
+        parts.push(`     ${example.explanation}`);
+      }
+    });
+  }
+  return parts.join("\n");
+}
+
+// src/tools/registry-prompt.ts
+function convertRegistryToolsToLangChain(tools) {
+  return toLangChainTools(tools);
+}
+function generateRegistryPrompt(tools, options = {}) {
+  const {
+    includeExamples = false,
+    includeNotes = false,
+    includeLimitations = false,
+    includeRelations = false,
+    groupByCategory = false,
+    categories,
+    maxExamplesPerTool,
+    minimal = false
+  } = options;
+  let toolsToInclude = tools;
+  if (categories && categories.length > 0) {
+    toolsToInclude = toolsToInclude.filter(
+      (tool) => categories.includes(tool.metadata.category)
+    );
+  }
+  if (toolsToInclude.length === 0) {
+    return "No tools available.";
+  }
+  const lines = ["Available Tools:", ""];
+  if (groupByCategory) {
+    const toolsByCategory = /* @__PURE__ */ new Map();
+    for (const tool of toolsToInclude) {
+      const category = tool.metadata.category;
+      if (!toolsByCategory.has(category)) {
+        toolsByCategory.set(category, []);
+      }
+      toolsByCategory.get(category).push(tool);
+    }
+    for (const [category, categoryTools] of toolsByCategory) {
+      lines.push(`${category.toUpperCase().replace(/-/g, " ")} TOOLS:`);
+      for (const tool of categoryTools) {
+        lines.push(...formatToolForPrompt(tool, {
+          includeExamples,
+          includeNotes,
+          includeLimitations,
+          includeRelations,
+          maxExamplesPerTool,
+          minimal
+        }));
+      }
+      lines.push("");
+    }
+  } else {
+    for (const tool of toolsToInclude) {
+      lines.push(...formatToolForPrompt(tool, {
+        includeExamples,
+        includeNotes,
+        includeLimitations,
+        includeRelations,
+        maxExamplesPerTool,
+        minimal
+      }));
+      lines.push("");
+    }
+  }
+  return lines.join("\n").trim();
+}
+function formatToolForPrompt(tool, options) {
+  const { metadata } = tool;
+  const lines = [];
+  if (options.minimal) {
+    lines.push(`## ${metadata.name}`);
+    let hasContent = false;
+    if (options.includeRelations && metadata.relations) {
+      const relationLines = formatRelations(metadata.relations);
+      if (relationLines.length > 0) {
+        lines.push(...relationLines);
+        hasContent = true;
+      }
+    }
+    if (options.includeExamples && metadata.examples && metadata.examples.length > 0) {
+      const maxExamples = options.maxExamplesPerTool || metadata.examples.length;
+      const examples = metadata.examples.slice(0, maxExamples);
+      for (const example of examples) {
+        lines.push(`  Example: ${example.description}`);
+        lines.push(`    Input: ${JSON.stringify(example.input)}`);
+        if (example.explanation) {
+          lines.push(`    ${example.explanation}`);
+        }
+        hasContent = true;
+      }
+    }
+    if (options.includeNotes && metadata.usageNotes) {
+      lines.push(`  Notes: ${metadata.usageNotes}`);
+      hasContent = true;
+    }
+    if (options.includeLimitations && metadata.limitations && metadata.limitations.length > 0) {
+      lines.push("  Limitations:");
+      for (const limitation of metadata.limitations) {
+        lines.push(`    - ${limitation}`);
+      }
+      hasContent = true;
+    }
+    if (!hasContent) {
+      return [];
+    }
+    return lines;
+  }
+  lines.push(`- ${metadata.name}: ${metadata.description}`);
+  const schemaShape = getSchemaShape(tool.schema);
+  if (schemaShape) {
+    const params = Object.keys(schemaShape);
+    if (params.length > 0) {
+      const paramDescriptions = params.map((param) => {
+        const field = schemaShape[param];
+        const typeName = field._def.typeName;
+        const type = typeName.replace("Zod", "").toLowerCase();
+        return `${param} (${type})`;
+      });
+      lines.push(`  Parameters: ${paramDescriptions.join(", ")}`);
+    }
+  }
+  if (options.includeRelations && metadata.relations) {
+    const relationLines = formatRelations(metadata.relations);
+    if (relationLines.length > 0) {
+      lines.push(...relationLines);
+    }
+  }
+  if (options.includeNotes && metadata.usageNotes) {
+    lines.push(`  Notes: ${metadata.usageNotes}`);
+  }
+  if (options.includeExamples && metadata.examples && metadata.examples.length > 0) {
+    const maxExamples = options.maxExamplesPerTool || metadata.examples.length;
+    const examples = metadata.examples.slice(0, maxExamples);
+    for (const example of examples) {
+      lines.push(`  Example: ${example.description}`);
+      lines.push(`    Input: ${JSON.stringify(example.input)}`);
+      if (example.explanation) {
+        lines.push(`    ${example.explanation}`);
+      }
+    }
+  }
+  if (options.includeLimitations && metadata.limitations && metadata.limitations.length > 0) {
+    lines.push("  Limitations:");
+    for (const limitation of metadata.limitations) {
+      lines.push(`    - ${limitation}`);
+    }
+  }
+  return lines;
+}
+function formatRelations(relations) {
+  const lines = [];
+  if (relations.requires && relations.requires.length > 0) {
+    lines.push(`  Requires: ${relations.requires.join(", ")}`);
+  }
+  if (relations.suggests && relations.suggests.length > 0) {
+    lines.push(`  Suggests: ${relations.suggests.join(", ")}`);
+  }
+  if (relations.conflicts && relations.conflicts.length > 0) {
+    lines.push(`  Conflicts: ${relations.conflicts.join(", ")}`);
+  }
+  if (relations.follows && relations.follows.length > 0) {
+    lines.push(`  Follows: ${relations.follows.join(", ")}`);
+  }
+  if (relations.precedes && relations.precedes.length > 0) {
+    lines.push(`  Precedes: ${relations.precedes.join(", ")}`);
+  }
+  return lines;
+}
+function getSchemaShape(schema) {
+  if (schema instanceof import_zod3.z.ZodObject) {
+    return schema.shape;
+  }
+  return void 0;
+}
 
 // src/tools/registry.ts
-var logger = createLogger("agentforge:core:tools:registry", { level: "info" /* INFO */ });
 var RegistryEvent = /* @__PURE__ */ ((RegistryEvent2) => {
   RegistryEvent2["TOOL_REGISTERED"] = "tool:registered";
   RegistryEvent2["TOOL_REMOVED"] = "tool:removed";
@@ -1323,10 +1526,7 @@ var ToolRegistry = class {
    * ```
    */
   on(event, handler) {
-    if (!this.eventHandlers.has(event)) {
-      this.eventHandlers.set(event, /* @__PURE__ */ new Set());
-    }
-    this.eventHandlers.get(event).add(handler);
+    addRegistryEventHandler(this.eventHandlers, event, handler);
   }
   /**
    * Unregister an event handler
@@ -1342,10 +1542,7 @@ var ToolRegistry = class {
    * ```
    */
   off(event, handler) {
-    const handlers = this.eventHandlers.get(event);
-    if (handlers) {
-      handlers.delete(handler);
-    }
+    removeRegistryEventHandler(this.eventHandlers, event, handler);
   }
   /**
    * Emit an event to all registered handlers
@@ -1355,20 +1552,7 @@ var ToolRegistry = class {
    * @private
    */
   emit(event, data) {
-    const handlers = this.eventHandlers.get(event);
-    if (handlers) {
-      handlers.forEach((handler) => {
-        try {
-          handler(data);
-        } catch (error) {
-          logger.error("Event handler error", {
-            event,
-            error: error instanceof Error ? error.message : String(error),
-            ...error instanceof Error && error.stack ? { stack: error.stack } : {}
-          });
-        }
-      });
-    }
+    emitRegistryEvent(this.eventHandlers, event, data);
   }
   /**
    * Convert all registered tools to LangChain format
@@ -1391,7 +1575,7 @@ var ToolRegistry = class {
    * ```
    */
   toLangChainTools() {
-    return toLangChainTools(this.getAll());
+    return convertRegistryToolsToLangChain(this.getAll());
   }
   /**
    * Generate a formatted prompt describing all tools
@@ -1422,184 +1606,7 @@ var ToolRegistry = class {
    * ```
    */
   generatePrompt(options = {}) {
-    const {
-      includeExamples = false,
-      includeNotes = false,
-      includeLimitations = false,
-      includeRelations = false,
-      groupByCategory = false,
-      categories,
-      maxExamplesPerTool,
-      minimal = false
-    } = options;
-    let tools = this.getAll();
-    if (categories && categories.length > 0) {
-      tools = tools.filter((tool) => categories.includes(tool.metadata.category));
-    }
-    if (tools.length === 0) {
-      return "No tools available.";
-    }
-    const lines = ["Available Tools:", ""];
-    if (groupByCategory) {
-      const toolsByCategory = /* @__PURE__ */ new Map();
-      for (const tool of tools) {
-        const category = tool.metadata.category;
-        if (!toolsByCategory.has(category)) {
-          toolsByCategory.set(category, []);
-        }
-        toolsByCategory.get(category).push(tool);
-      }
-      for (const [category, categoryTools] of toolsByCategory) {
-        lines.push(`${category.toUpperCase().replace(/-/g, " ")} TOOLS:`);
-        for (const tool of categoryTools) {
-          lines.push(...this.formatToolForPrompt(tool, {
-            includeExamples,
-            includeNotes,
-            includeLimitations,
-            includeRelations,
-            maxExamplesPerTool,
-            minimal
-          }));
-        }
-        lines.push("");
-      }
-    } else {
-      for (const tool of tools) {
-        lines.push(...this.formatToolForPrompt(tool, {
-          includeExamples,
-          includeNotes,
-          includeLimitations,
-          includeRelations,
-          maxExamplesPerTool,
-          minimal
-        }));
-        lines.push("");
-      }
-    }
-    return lines.join("\n").trim();
-  }
-  /**
-   * Format a single tool for inclusion in a prompt
-   *
-   * @param tool - The tool to format
-   * @param options - Formatting options
-   * @returns Array of formatted lines
-   * @private
-   */
-  formatToolForPrompt(tool, options) {
-    const { metadata } = tool;
-    const lines = [];
-    if (options.minimal) {
-      lines.push(`## ${metadata.name}`);
-      let hasContent = false;
-      if (options.includeRelations && metadata.relations) {
-        const relationLines = this.formatRelations(metadata.relations);
-        if (relationLines.length > 0) {
-          lines.push(...relationLines);
-          hasContent = true;
-        }
-      }
-      if (options.includeExamples && metadata.examples && metadata.examples.length > 0) {
-        const maxExamples = options.maxExamplesPerTool || metadata.examples.length;
-        const examples = metadata.examples.slice(0, maxExamples);
-        for (const example of examples) {
-          lines.push(`  Example: ${example.description}`);
-          lines.push(`    Input: ${JSON.stringify(example.input)}`);
-          if (example.explanation) {
-            lines.push(`    ${example.explanation}`);
-          }
-          hasContent = true;
-        }
-      }
-      if (options.includeNotes && metadata.usageNotes) {
-        lines.push(`  Notes: ${metadata.usageNotes}`);
-        hasContent = true;
-      }
-      if (options.includeLimitations && metadata.limitations && metadata.limitations.length > 0) {
-        lines.push(`  Limitations:`);
-        for (const limitation of metadata.limitations) {
-          lines.push(`    - ${limitation}`);
-        }
-        hasContent = true;
-      }
-      if (!hasContent) {
-        return [];
-      }
-      return lines;
-    }
-    lines.push(`- ${metadata.name}: ${metadata.description}`);
-    const schemaShape = this.getSchemaShape(tool.schema);
-    if (schemaShape) {
-      const params = Object.keys(schemaShape);
-      if (params.length > 0) {
-        const paramDescriptions = params.map((param) => {
-          const field = schemaShape[param];
-          const typeName = field._def.typeName;
-          const type = typeName.replace("Zod", "").toLowerCase();
-          return `${param} (${type})`;
-        });
-        lines.push(`  Parameters: ${paramDescriptions.join(", ")}`);
-      }
-    }
-    if (options.includeRelations && metadata.relations) {
-      const relationLines = this.formatRelations(metadata.relations);
-      if (relationLines.length > 0) {
-        lines.push(...relationLines);
-      }
-    }
-    if (options.includeNotes && metadata.usageNotes) {
-      lines.push(`  Notes: ${metadata.usageNotes}`);
-    }
-    if (options.includeExamples && metadata.examples && metadata.examples.length > 0) {
-      const maxExamples = options.maxExamplesPerTool || metadata.examples.length;
-      const examples = metadata.examples.slice(0, maxExamples);
-      for (const example of examples) {
-        lines.push(`  Example: ${example.description}`);
-        lines.push(`    Input: ${JSON.stringify(example.input)}`);
-        if (example.explanation) {
-          lines.push(`    ${example.explanation}`);
-        }
-      }
-    }
-    if (options.includeLimitations && metadata.limitations && metadata.limitations.length > 0) {
-      lines.push(`  Limitations:`);
-      for (const limitation of metadata.limitations) {
-        lines.push(`    - ${limitation}`);
-      }
-    }
-    return lines;
-  }
-  /**
-   * Format tool relations for inclusion in a prompt
-   *
-   * @param relations - The relations to format
-   * @returns Array of formatted lines
-   * @private
-   */
-  formatRelations(relations) {
-    const lines = [];
-    if (relations.requires && relations.requires.length > 0) {
-      lines.push(`  Requires: ${relations.requires.join(", ")}`);
-    }
-    if (relations.suggests && relations.suggests.length > 0) {
-      lines.push(`  Suggests: ${relations.suggests.join(", ")}`);
-    }
-    if (relations.conflicts && relations.conflicts.length > 0) {
-      lines.push(`  Conflicts: ${relations.conflicts.join(", ")}`);
-    }
-    if (relations.follows && relations.follows.length > 0) {
-      lines.push(`  Follows: ${relations.follows.join(", ")}`);
-    }
-    if (relations.precedes && relations.precedes.length > 0) {
-      lines.push(`  Precedes: ${relations.precedes.join(", ")}`);
-    }
-    return lines;
-  }
-  getSchemaShape(schema) {
-    if (schema instanceof import_zod3.z.ZodObject) {
-      return schema.shape;
-    }
-    return void 0;
+    return generateRegistryPrompt(this.getAll(), options);
   }
 };