@agentforge/core 0.16.10 → 0.16.11

package/dist/index.d.cts

@@ -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

@@ -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/package.json

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