@agentforge/core 0.16.10 → 0.16.12

package/dist/index.cjs

@@ -1026,6 +1026,29 @@ function createLogger(name, options) {
   return new LoggerImpl(name, options);
 }
 
+// src/tools/registry-collection.ts
+function getAllRegistryTools(tools) {
+  return Array.from(tools.values());
+}
+function getRegistryToolNames(tools) {
+  return Array.from(tools.keys());
+}
+function getRegistryToolsByCategory(tools, category) {
+  return getAllRegistryTools(tools).filter((tool) => tool.metadata.category === category);
+}
+function getRegistryToolsByTag(tools, tag) {
+  return getAllRegistryTools(tools).filter((tool) => tool.metadata.tags?.includes(tag));
+}
+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);
+  });
+}
+
 // src/tools/registry.ts
 var logger = createLogger("agentforge:core:tools:registry", { level: "info" /* INFO */ });
 var RegistryEvent = /* @__PURE__ */ ((RegistryEvent2) => {
@@ -1156,7 +1179,7 @@ var ToolRegistry = class {
    * ```
    */
   getAll() {
-    return Array.from(this.tools.values());
+    return getAllRegistryTools(this.tools);
   }
   /**
    * Get tools by category
@@ -1170,7 +1193,7 @@ var ToolRegistry = class {
    * ```
    */
   getByCategory(category) {
-    return this.getAll().filter((tool) => tool.metadata.category === category);
+    return getRegistryToolsByCategory(this.tools, category);
   }
   /**
    * Get tools by tag
@@ -1184,9 +1207,7 @@ var ToolRegistry = class {
    * ```
    */
   getByTag(tag) {
-    return this.getAll().filter(
-      (tool) => tool.metadata.tags?.includes(tag)
-    );
+    return getRegistryToolsByTag(this.tools, tag);
   }
   /**
    * Search tools by name or description
@@ -1203,13 +1224,7 @@ var ToolRegistry = class {
    * ```
    */
   search(query) {
-    const lowerQuery = query.toLowerCase();
-    return this.getAll().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 searchRegistryTools(this.tools, query);
   }
   /**
    * Register multiple tools at once
@@ -1292,7 +1307,7 @@ var ToolRegistry = class {
    * ```
    */
   getNames() {
-    return Array.from(this.tools.keys());
+    return getRegistryToolNames(this.tools);
   }
   /**
    * Register an event handler

package/dist/index.d.cts

@@ -1177,8 +1177,8 @@ declare enum RegistryEvent {
  * Event handler type
  */
 type EventHandler = (data: unknown) => void;
-type RegistryTool = Tool<unknown, unknown>;
 type RegisterManyTool = Tool<never, unknown>;
+type RegistryTool = Tool<unknown, unknown>;
 /**
  * Options for generating tool prompts
  */
@@ -4182,6 +4182,7 @@ declare function createErrorReporter(options: ErrorReporterOptions): ErrorReport
  * Types for LangGraph interrupt handling
  * @module langgraph/interrupts/types
  */
+
 /**
  * Priority level for human requests
  */
@@ -4205,7 +4206,7 @@ interface HumanRequest {
     /**
      * Optional context
      */
-    context?: Record<string, any>;
+    context?: JsonObject;
     /**
      * Priority level
      */
@@ -4243,14 +4244,22 @@ interface HumanRequest {
  * Interrupt type - identifies what kind of interrupt occurred
  */
 type InterruptType = 'human_request' | 'approval_required' | 'custom';
+/**
+ * Shared interrupt metadata contract.
+ */
+type InterruptMetadata = JsonObject;
+/**
+ * JSON-safe payload allowed in generic interrupt and resume flows.
+ */
+type InterruptPayload = JsonValue;
 /**
  * Interrupt data stored in the checkpoint
  */
-interface InterruptData {
+interface InterruptData<TType extends InterruptType = InterruptType, TData = unknown, TMetadata extends InterruptMetadata = InterruptMetadata> {
     /**
      * Type of interrupt
      */
-    type: InterruptType;
+    type: TType;
     /**
      * Unique ID for this interrupt
      */
@@ -4262,37 +4271,32 @@ interface InterruptData {
     /**
      * The data associated with this interrupt
      */
-    data: any;
+    data: TData;
     /**
      * Optional metadata
      */
-    metadata?: Record<string, any>;
+    metadata?: TMetadata;
 }
 /**
- * Human request interrupt data
+ * Approval request payload.
  */
-interface HumanRequestInterrupt extends InterruptData {
-    type: 'human_request';
-    data: HumanRequest;
+interface ApprovalRequiredData {
+    action: string;
+    description: string;
+    context?: JsonObject;
 }
+/**
+ * Human request interrupt data
+ */
+type HumanRequestInterrupt = InterruptData<'human_request', HumanRequest>;
 /**
  * Approval required interrupt data
  */
-interface ApprovalRequiredInterrupt extends InterruptData {
-    type: 'approval_required';
-    data: {
-        action: string;
-        description: string;
-        context?: Record<string, any>;
-    };
-}
+type ApprovalRequiredInterrupt = InterruptData<'approval_required', ApprovalRequiredData>;
 /**
  * Custom interrupt data
  */
-interface CustomInterrupt extends InterruptData {
-    type: 'custom';
-    data: any;
-}
+type CustomInterrupt<TData extends InterruptPayload = InterruptPayload, TMetadata extends InterruptMetadata = InterruptMetadata> = InterruptData<'custom', TData, TMetadata>;
 /**
  * Union type of all interrupt types
  */
@@ -4300,15 +4304,15 @@ type AnyInterrupt = HumanRequestInterrupt | ApprovalRequiredInterrupt | CustomIn
 /**
  * Resume command for continuing after an interrupt
  */
-interface ResumeCommand {
+interface ResumeCommand<TResume extends InterruptPayload = InterruptPayload, TMetadata extends InterruptMetadata = InterruptMetadata> {
     /**
      * The response to the interrupt
      */
-    resume: any;
+    resume: TResume;
     /**
      * Optional metadata about the response
      */
-    metadata?: Record<string, any>;
+    metadata?: TMetadata;
 }
 /**
  * Thread status
@@ -4337,7 +4341,7 @@ interface ThreadInfo {
     /**
      * Optional metadata
      */
-    metadata?: Record<string, any>;
+    metadata?: InterruptMetadata;
 }
 /**
  * Options for checking interrupt status
@@ -4367,11 +4371,11 @@ interface ResumeOptions {
     /**
      * The response/value to resume with
      */
-    value: any;
+    value: InterruptPayload;
     /**
      * Optional metadata
      */
-    metadata?: Record<string, any>;
+    metadata?: InterruptMetadata;
 }
 
 /**
@@ -4415,7 +4419,7 @@ declare function createHumanRequestInterrupt(request: HumanRequest): HumanReques
  * );
  * ```
  */
-declare function createApprovalRequiredInterrupt(action: string, description: string, context?: Record<string, any>): ApprovalRequiredInterrupt;
+declare function createApprovalRequiredInterrupt(action: string, description: string, context?: JsonObject): ApprovalRequiredInterrupt;
 /**
  * Create a custom interrupt
  *
@@ -4432,7 +4436,7 @@ declare function createApprovalRequiredInterrupt(action: string, description: st
  * );
  * ```
  */
-declare function createCustomInterrupt(id: string, data: any, metadata?: Record<string, any>): CustomInterrupt;
+declare function createCustomInterrupt<TData extends InterruptPayload, TMetadata extends InterruptMetadata = InterruptMetadata>(id: string, data: TData, metadata?: TMetadata): CustomInterrupt<TData, TMetadata>;
 /**
  * Check if an interrupt is a human request
  *

package/dist/index.d.ts

@@ -1177,8 +1177,8 @@ declare enum RegistryEvent {
  * Event handler type
  */
 type EventHandler = (data: unknown) => void;
-type RegistryTool = Tool<unknown, unknown>;
 type RegisterManyTool = Tool<never, unknown>;
+type RegistryTool = Tool<unknown, unknown>;
 /**
  * Options for generating tool prompts
  */
@@ -4182,6 +4182,7 @@ declare function createErrorReporter(options: ErrorReporterOptions): ErrorReport
  * Types for LangGraph interrupt handling
  * @module langgraph/interrupts/types
  */
+
 /**
  * Priority level for human requests
  */
@@ -4205,7 +4206,7 @@ interface HumanRequest {
     /**
      * Optional context
      */
-    context?: Record<string, any>;
+    context?: JsonObject;
     /**
      * Priority level
      */
@@ -4243,14 +4244,22 @@ interface HumanRequest {
  * Interrupt type - identifies what kind of interrupt occurred
  */
 type InterruptType = 'human_request' | 'approval_required' | 'custom';
+/**
+ * Shared interrupt metadata contract.
+ */
+type InterruptMetadata = JsonObject;
+/**
+ * JSON-safe payload allowed in generic interrupt and resume flows.
+ */
+type InterruptPayload = JsonValue;
 /**
  * Interrupt data stored in the checkpoint
  */
-interface InterruptData {
+interface InterruptData<TType extends InterruptType = InterruptType, TData = unknown, TMetadata extends InterruptMetadata = InterruptMetadata> {
     /**
      * Type of interrupt
      */
-    type: InterruptType;
+    type: TType;
     /**
      * Unique ID for this interrupt
      */
@@ -4262,37 +4271,32 @@ interface InterruptData {
     /**
      * The data associated with this interrupt
      */
-    data: any;
+    data: TData;
     /**
      * Optional metadata
      */
-    metadata?: Record<string, any>;
+    metadata?: TMetadata;
 }
 /**
- * Human request interrupt data
+ * Approval request payload.
  */
-interface HumanRequestInterrupt extends InterruptData {
-    type: 'human_request';
-    data: HumanRequest;
+interface ApprovalRequiredData {
+    action: string;
+    description: string;
+    context?: JsonObject;
 }
+/**
+ * Human request interrupt data
+ */
+type HumanRequestInterrupt = InterruptData<'human_request', HumanRequest>;
 /**
  * Approval required interrupt data
  */
-interface ApprovalRequiredInterrupt extends InterruptData {
-    type: 'approval_required';
-    data: {
-        action: string;
-        description: string;
-        context?: Record<string, any>;
-    };
-}
+type ApprovalRequiredInterrupt = InterruptData<'approval_required', ApprovalRequiredData>;
 /**
  * Custom interrupt data
  */
-interface CustomInterrupt extends InterruptData {
-    type: 'custom';
-    data: any;
-}
+type CustomInterrupt<TData extends InterruptPayload = InterruptPayload, TMetadata extends InterruptMetadata = InterruptMetadata> = InterruptData<'custom', TData, TMetadata>;
 /**
  * Union type of all interrupt types
  */
@@ -4300,15 +4304,15 @@ type AnyInterrupt = HumanRequestInterrupt | ApprovalRequiredInterrupt | CustomIn
 /**
  * Resume command for continuing after an interrupt
  */
-interface ResumeCommand {
+interface ResumeCommand<TResume extends InterruptPayload = InterruptPayload, TMetadata extends InterruptMetadata = InterruptMetadata> {
     /**
      * The response to the interrupt
      */
-    resume: any;
+    resume: TResume;
     /**
      * Optional metadata about the response
      */
-    metadata?: Record<string, any>;
+    metadata?: TMetadata;
 }
 /**
  * Thread status
@@ -4337,7 +4341,7 @@ interface ThreadInfo {
     /**
      * Optional metadata
      */
-    metadata?: Record<string, any>;
+    metadata?: InterruptMetadata;
 }
 /**
  * Options for checking interrupt status
@@ -4367,11 +4371,11 @@ interface ResumeOptions {
     /**
      * The response/value to resume with
      */
-    value: any;
+    value: InterruptPayload;
     /**
      * Optional metadata
      */
-    metadata?: Record<string, any>;
+    metadata?: InterruptMetadata;
 }
 
 /**
@@ -4415,7 +4419,7 @@ declare function createHumanRequestInterrupt(request: HumanRequest): HumanReques
  * );
  * ```
  */
-declare function createApprovalRequiredInterrupt(action: string, description: string, context?: Record<string, any>): ApprovalRequiredInterrupt;
+declare function createApprovalRequiredInterrupt(action: string, description: string, context?: JsonObject): ApprovalRequiredInterrupt;
 /**
  * Create a custom interrupt
  *
@@ -4432,7 +4436,7 @@ declare function createApprovalRequiredInterrupt(action: string, description: st
  * );
  * ```
  */
-declare function createCustomInterrupt(id: string, data: any, metadata?: Record<string, any>): CustomInterrupt;
+declare function createCustomInterrupt<TData extends InterruptPayload, TMetadata extends InterruptMetadata = InterruptMetadata>(id: string, data: TData, metadata?: TMetadata): CustomInterrupt<TData, TMetadata>;
 /**
  * Check if an interrupt is a human request
  *

package/dist/index.js

@@ -851,6 +851,29 @@ function createLogger(name, options) {
   return new LoggerImpl(name, options);
 }
 
+// src/tools/registry-collection.ts
+function getAllRegistryTools(tools) {
+  return Array.from(tools.values());
+}
+function getRegistryToolNames(tools) {
+  return Array.from(tools.keys());
+}
+function getRegistryToolsByCategory(tools, category) {
+  return getAllRegistryTools(tools).filter((tool) => tool.metadata.category === category);
+}
+function getRegistryToolsByTag(tools, tag) {
+  return getAllRegistryTools(tools).filter((tool) => tool.metadata.tags?.includes(tag));
+}
+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);
+  });
+}
+
 // src/tools/registry.ts
 var logger = createLogger("agentforge:core:tools:registry", { level: "info" /* INFO */ });
 var RegistryEvent = /* @__PURE__ */ ((RegistryEvent2) => {
@@ -981,7 +1004,7 @@ var ToolRegistry = class {
    * ```
    */
   getAll() {
-    return Array.from(this.tools.values());
+    return getAllRegistryTools(this.tools);
   }
   /**
    * Get tools by category
@@ -995,7 +1018,7 @@ var ToolRegistry = class {
    * ```
    */
   getByCategory(category) {
-    return this.getAll().filter((tool) => tool.metadata.category === category);
+    return getRegistryToolsByCategory(this.tools, category);
   }
   /**
    * Get tools by tag
@@ -1009,9 +1032,7 @@ var ToolRegistry = class {
    * ```
    */
   getByTag(tag) {
-    return this.getAll().filter(
-      (tool) => tool.metadata.tags?.includes(tag)
-    );
+    return getRegistryToolsByTag(this.tools, tag);
   }
   /**
    * Search tools by name or description
@@ -1028,13 +1049,7 @@ var ToolRegistry = class {
    * ```
    */
   search(query) {
-    const lowerQuery = query.toLowerCase();
-    return this.getAll().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 searchRegistryTools(this.tools, query);
   }
   /**
    * Register multiple tools at once
@@ -1117,7 +1132,7 @@ var ToolRegistry = class {
    * ```
    */
   getNames() {
-    return Array.from(this.tools.keys());
+    return getRegistryToolNames(this.tools);
   }
   /**
    * Register an event handler

package/package.json

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