@loopman/langchain-sdk 1.17.1 → 1.17.3

package/README.md

@@ -342,6 +342,33 @@ const workflow = new StateGraph(LoopmanGraphState)
 const app = workflow.compile({ checkpointer: new MemorySaver() });
 ```
 
+#### Task Options
+
+Pass task-specific options when invoking the validation node:
+
+```typescript
+const validationNode = createLoopmanValidationNode({
+  apiKey: process.env.LOOPMAN_API_KEY!,
+  workflowId: "my-workflow",
+  debug: true,
+});
+
+workflow.addNode("loopman_validation", (state, config) =>
+  validationNode(state, {
+    taskTitle: `Approve ${state.currentAction}`,
+    taskMessage: `Review action for user ${state.userId}`,
+    businessContext: (s) => `Risk: ${s.riskLevel}, Cost: $${s.estimatedCost}`,
+    proposedDecision: (s) => `Execute ${s.currentAction} on ${s.targetResource}`,
+  })
+);
+```
+
+**Options:**
+- `taskTitle`, `taskMessage` - Custom task information
+- `businessContext`, `proposedDecision`, `decisionReasoning` - Context (string or function)
+- `formatState` - Custom formatter
+- `includeFullState` - Include state (default: `true`)
+
 **🔄 Feedback Loop in Action:**
 
 When a human rejects a decision with status `NEEDS_CHANGES`:
@@ -531,15 +558,28 @@ Creates a LangGraph node that loads guidelines and decision history.
 
 Creates a LangGraph node that handles human validation.
 
-**Parameters:**
+**Configuration:**
 
-- `config.apiKey` (string, required): Loopman API key
-- `config.workflowId` (string, required): Workflow identifier
-- `config.timeout` (number, optional): Decision timeout in ms (default: 5 minutes)
-- `config.pollingInterval` (number, optional): Polling interval in ms (default: 5 seconds)
-- `config.debug` (boolean, optional): Enable debug logging
+- `apiKey` (string, required): Loopman API key
+- `workflowId` (string, required): Workflow identifier
+- `executionId` (string, optional): Execution ID (auto-generated)
+- `category` (string, optional): Category filter for guidelines
+- `timeout` (number, optional): Timeout in ms (default: 5 min)
+- `pollingInterval` (number, optional): Polling interval (default: 5 sec)
+- `debug` (boolean, optional): Enable debug logging
 
-**Returns:** LangGraph node function
+**Task Options (passed at invocation):**
+
+- `taskTitle` (string): Task title
+- `taskMessage` (string): Task description
+- `businessContext` (string | function): Business context
+- `proposedDecision` (string | function): Proposed decision
+- `decisionReasoning` (string | function): Decision reasoning
+- `includeFullState` (boolean): Include state (default: true)
+- `formatState` (function): Custom state formatter
+- `extractToolCall` (function): Custom tool call extractor
+
+**Returns:** Node function `(state, options?) => Promise<StateUpdate>`
 
 #### `createLoopmanConditionalEdge(config)`
 

package/dist/langgraph/index.d.ts

@@ -7,7 +7,7 @@
 export { LoopmanGraphState } from "./types";
 export type { LoopmanGuideline, LoopmanDecision } from "./types";
 export { createLoopmanValidationNode } from "./loopman-validation-node";
-export type { LoopmanValidationNodeConfig } from "./loopman-validation-node";
+export type { LoopmanValidationNodeConfig, LoopmanValidationTaskOptions, } from "./loopman-validation-node";
 export { createLoopmanConditionalEdge } from "./loopman-conditional-edge";
 export { createLoopmanContextNode } from "./loopman-context-node";
 export type { LoopmanContextNodeConfig } from "./loopman-context-node";

package/dist/langgraph/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/langgraph/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,YAAY,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAG7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAG1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGvE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/langgraph/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAG1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGvE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC"}

package/dist/langgraph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/langgraph/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yBAAyB;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5C,yBAAyB;AACzB,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAGxE,0BAA0B;AAC1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAE1E,sBAAsB;AACtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGlE,0BAA0B;AAC1B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/langgraph/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yBAAyB;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5C,yBAAyB;AACzB,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAMxE,0BAA0B;AAC1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAE1E,sBAAsB;AACtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGlE,0BAA0B;AAC1B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,WAAW,CAAC"}

package/dist/langgraph/loopman-validation-node.d.ts

@@ -9,7 +9,7 @@
  */
 import { TaskInformation } from "../types";
 /**
- * Configuration for Loopman validation node
+ * Configuration for Loopman validation node (service-level config)
  */
 export interface LoopmanValidationNodeConfig {
     /** Loopman API key for authentication */
@@ -26,6 +26,11 @@ export interface LoopmanValidationNodeConfig {
     pollingInterval?: number;
     /** Enable debug logging */
     debug?: boolean;
+}
+/**
+ * Task-specific options that can be passed when invoking the validation node
+ */
+export interface LoopmanValidationTaskOptions {
     /** Custom title for the task (default: "Tool validation") */
     taskTitle?: string;
     /** Custom message/description to display when creating task */
@@ -42,9 +47,9 @@ export interface LoopmanValidationNodeConfig {
     proposedDecision?: string | ((state: any) => string);
     /** Decision reasoning to include in the task (or function to extract from state) */
     decisionReasoning?: string | ((state: any) => string);
-    /** Whether to include full state in task information (default: false) */
+    /** Whether to include full state in task information (default: true) */
     includeFullState?: boolean;
-    /** Custom function to format state for task information (if not provided, uses JSON.stringify) */
+    /** Custom function to format state for task information (if not provided, uses default converter) */
     formatState?: (state: any) => TaskInformation[];
 }
 /**
@@ -68,56 +73,42 @@ export interface LoopmanValidationNodeConfig {
  * and adds `guidelines` and `decisionContext` to the state, making them
  * available for the agent on retry (NEEDS_CHANGES) or subsequent executions.
  *
- * **State Inclusion**: You can include the full agent state in the task information
- * by setting `includeFullState: true`. This helps human reviewers understand the
- * complete context of the decision. You can also provide custom formatters.
+ * **State Inclusion**: By default, the full agent state is included in the task information
+ * to help human reviewers understand the complete context of the decision.
+ * You can disable this by setting `includeFullState: false`, or provide a custom
+ * `formatState` function to control how state is formatted.
  *
  * **Decision Context**: You can provide business context, proposed decisions, and
  * reasoning either as static strings or as functions that extract from the state.
  *
- * @example Basic usage with LoopmanGraphState
+ * @example Basic usage
  * ```typescript
  * import { createLoopmanValidationNode, LoopmanGraphState } from "loopman-langchain-sdk";
  *
  * const loopmanNode = createLoopmanValidationNode({
  *   apiKey: process.env.LOOPMAN_API_KEY!,
  *   workflowId: "my-workflow",
- *   executionId: `exec-${Date.now()}`,
- *   timeout: 5 * 60 * 1000,
- *   pollingInterval: 5000,
  *   debug: true,
- *   taskTitle: "Email Validation", // Custom title
- *   taskMessage: "Please review this action" // Custom description
  * });
  *
- * workflow.addNode("loopman_validation", loopmanNode);
- * ```
- *
- * @example With full state and decision context
- * ```typescript
- * const loopmanNode = createLoopmanValidationNode({
- *   apiKey: process.env.LOOPMAN_API_KEY!,
- *   workflowId: "my-workflow",
- *   includeFullState: true, // Include all state in task information
- *   businessContext: (state) => `Processing user request: ${state.userQuery}`,
- *   proposedDecision: (state) => `Execute ${state.currentAction} on ${state.targetResource}`,
- *   decisionReasoning: (state) => state.reasoning || "No specific reasoning provided",
- * });
+ * workflow.addNode("loopman_validation", (state, config) =>
+ *   loopmanNode(state, {
+ *     taskTitle: "Email Validation",
+ *     taskMessage: "Please review this action",
+ *   })
+ * );
  * ```
  *
- * @example With custom state formatter
+ * @example With dynamic context
  * ```typescript
- * const loopmanNode = createLoopmanValidationNode({
- *   apiKey: process.env.LOOPMAN_API_KEY!,
- *   workflowId: "my-workflow",
- *   includeFullState: true,
- *   formatState: (state) => [
- *     { type: "text", label: "User", value: state.userId },
- *     { type: "text", label: "Action", value: state.action },
- *     { type: "bulletPoints", label: "Parameters", value: Object.keys(state.params) },
- *   ],
- * });
+ * workflow.addNode("loopman_validation", (state, config) =>
+ *   loopmanNode(state, {
+ *     businessContext: (s) => `Processing user request: ${s.userQuery}`,
+ *     proposedDecision: (s) => `Execute ${s.currentAction} on ${s.targetResource}`,
+ *     includeFullState: state.riskLevel === "HIGH",
+ *   })
+ * );
  * ```
  */
-export declare function createLoopmanValidationNode(config: LoopmanValidationNodeConfig): (state: any) => Promise<any>;
+export declare function createLoopmanValidationNode(config: LoopmanValidationNodeConfig): (state: any, options?: LoopmanValidationTaskOptions) => Promise<any>;
 //# sourceMappingURL=loopman-validation-node.d.ts.map

package/dist/langgraph/loopman-validation-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loopman-validation-node.d.ts","sourceRoot":"","sources":["../../src/langgraph/loopman-validation-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK;QACrC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,GAAG,CAAC;QACV,EAAE,EAAE,MAAM,CAAC;KACZ,GAAG,IAAI,CAAC;IACT,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IACpD,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IACrD,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IACtD,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kGAAkG;IAClG,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,eAAe,EAAE,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,2BAA2B,IAerB,OAAO,GAAG,kBAqMzB"}
+{"version":3,"file":"loopman-validation-node.d.ts","sourceRoot":"","sources":["../../src/langgraph/loopman-validation-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK;QACrC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,GAAG,CAAC;QACV,EAAE,EAAE,MAAM,CAAC;KACZ,GAAG,IAAI,CAAC;IACT,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IACpD,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IACrD,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IACtD,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qGAAqG;IACrG,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,eAAe,EAAE,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,2BAA2B,IAerB,OAAO,GAAG,EAAE,UAAS,4BAAiC,kBAsMrE"}

package/dist/langgraph/loopman-validation-node.js

@@ -31,55 +31,41 @@ import { createLoopmanContextNode } from "./loopman-context-node.js";
  * and adds `guidelines` and `decisionContext` to the state, making them
  * available for the agent on retry (NEEDS_CHANGES) or subsequent executions.
  *
- * **State Inclusion**: You can include the full agent state in the task information
- * by setting `includeFullState: true`. This helps human reviewers understand the
- * complete context of the decision. You can also provide custom formatters.
+ * **State Inclusion**: By default, the full agent state is included in the task information
+ * to help human reviewers understand the complete context of the decision.
+ * You can disable this by setting `includeFullState: false`, or provide a custom
+ * `formatState` function to control how state is formatted.
  *
  * **Decision Context**: You can provide business context, proposed decisions, and
  * reasoning either as static strings or as functions that extract from the state.
  *
- * @example Basic usage with LoopmanGraphState
+ * @example Basic usage
  * ```typescript
  * import { createLoopmanValidationNode, LoopmanGraphState } from "loopman-langchain-sdk";
  *
  * const loopmanNode = createLoopmanValidationNode({
  *   apiKey: process.env.LOOPMAN_API_KEY!,
  *   workflowId: "my-workflow",
- *   executionId: `exec-${Date.now()}`,
- *   timeout: 5 * 60 * 1000,
- *   pollingInterval: 5000,
  *   debug: true,
- *   taskTitle: "Email Validation", // Custom title
- *   taskMessage: "Please review this action" // Custom description
  * });
  *
- * workflow.addNode("loopman_validation", loopmanNode);
+ * workflow.addNode("loopman_validation", (state, config) =>
+ *   loopmanNode(state, {
+ *     taskTitle: "Email Validation",
+ *     taskMessage: "Please review this action",
+ *   })
+ * );
  * ```
  *
- * @example With full state and decision context
+ * @example With dynamic context
  * ```typescript
- * const loopmanNode = createLoopmanValidationNode({
- *   apiKey: process.env.LOOPMAN_API_KEY!,
- *   workflowId: "my-workflow",
- *   includeFullState: true, // Include all state in task information
- *   businessContext: (state) => `Processing user request: ${state.userQuery}`,
- *   proposedDecision: (state) => `Execute ${state.currentAction} on ${state.targetResource}`,
- *   decisionReasoning: (state) => state.reasoning || "No specific reasoning provided",
- * });
- * ```
- *
- * @example With custom state formatter
- * ```typescript
- * const loopmanNode = createLoopmanValidationNode({
- *   apiKey: process.env.LOOPMAN_API_KEY!,
- *   workflowId: "my-workflow",
- *   includeFullState: true,
- *   formatState: (state) => [
- *     { type: "text", label: "User", value: state.userId },
- *     { type: "text", label: "Action", value: state.action },
- *     { type: "bulletPoints", label: "Parameters", value: Object.keys(state.params) },
- *   ],
- * });
+ * workflow.addNode("loopman_validation", (state, config) =>
+ *   loopmanNode(state, {
+ *     businessContext: (s) => `Processing user request: ${s.userQuery}`,
+ *     proposedDecision: (s) => `Execute ${s.currentAction} on ${s.targetResource}`,
+ *     includeFullState: state.riskLevel === "HIGH",
+ *   })
+ * );
  * ```
  */
 export function createLoopmanValidationNode(config) {
@@ -94,14 +80,14 @@ export function createLoopmanValidationNode(config) {
         pollingInterval: config.pollingInterval,
         debug: config.debug,
     });
-    return async (state) => {
+    return async (state, options = {}) => {
         const { messages, loopmanTaskId } = state;
         const { debug } = config;
         const logger = loopmanService.logger;
         // Extract tool call from last message (optional - can be used without tool calls)
         const lastMessage = messages[messages.length - 1];
-        const toolCall = config.extractToolCall
-            ? config.extractToolCall(messages)
+        const toolCall = options.extractToolCall
+            ? options.extractToolCall(messages)
             : extractDefaultToolCall(lastMessage);
         // Step 1: Check if we're retrying an existing task (NEEDS_CHANGES scenario)
         const isRetry = !!loopmanTaskId;
@@ -124,27 +110,28 @@ export function createLoopmanValidationNode(config) {
             logger.debug("[LoopmanNode] No tool call found, creating generic validation task");
         }
         // Step 2: Create or update task in Loopman
-        const taskTitle = config.taskTitle ||
+        const taskTitle = options.taskTitle ||
             (toolCall ? `Validation: ${toolCall.name}` : "Human validation required");
-        const taskMessage = config.taskMessage ||
+        const taskMessage = options.taskMessage ||
             (toolCall
                 ? `Validation required for tool: ${toolCall.name}`
                 : "Human validation required for this decision");
         // Extract businessContext, proposedDecision, and decisionReasoning
-        const businessContext = typeof config.businessContext === "function"
-            ? config.businessContext(state)
-            : config.businessContext;
-        const proposedDecision = typeof config.proposedDecision === "function"
-            ? config.proposedDecision(state)
-            : config.proposedDecision;
-        const decisionReasoning = typeof config.decisionReasoning === "function"
-            ? config.decisionReasoning(state)
-            : config.decisionReasoning;
-        // Prepare additional information from state if configured
+        const businessContext = typeof options.businessContext === "function"
+            ? options.businessContext(state)
+            : options.businessContext;
+        const proposedDecision = typeof options.proposedDecision === "function"
+            ? options.proposedDecision(state)
+            : options.proposedDecision;
+        const decisionReasoning = typeof options.decisionReasoning === "function"
+            ? options.decisionReasoning(state)
+            : options.decisionReasoning;
+        // Prepare additional information from state (enabled by default)
         let additionalInformation;
-        if (config.includeFullState) {
-            if (config.formatState) {
-                additionalInformation = config.formatState(state);
+        const shouldIncludeState = options.includeFullState !== false; // Default to true
+        if (shouldIncludeState) {
+            if (options.formatState) {
+                additionalInformation = options.formatState(state);
             }
             else {
                 additionalInformation = convertStateToInformation(state);

package/dist/langgraph/loopman-validation-node.js.map

@@ -1 +1 @@
-{"version":3,"file":"loopman-validation-node.js","sourceRoot":"","sources":["../../src/langgraph/loopman-validation-node.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loopman-validation-node.js","sourceRoot":"","sources":["../../src/langgraph/loopman-validation-node.ts"],"names":[],"mappings":"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"}

package/dist/templates.json

@@ -1,19 +1,19 @@
 {
   "langgraph-hello-world": {
     "index.ts": "import { HumanMessage, ToolMessage } from \"@langchain/core/messages\";\nimport { END, MemorySaver, START, StateGraph } from \"@langchain/langgraph\";\nimport { ChatOpenAI } from \"@langchain/openai\";\nimport { config } from \"dotenv\";\nimport { tool } from \"langchain\";\nimport * as z from \"zod\";\n\nimport {\n  LoopmanGraphState,\n  createLoopmanConditionalEdge,\n  createLoopmanContextNode,\n  createLoopmanValidationNode,\n  enrichSystemPrompt,\n} from \"@loopman/langchain-sdk\";\n\nconfig();\n\n// Define your tools\nconst sayHello = tool(\n  ({ name }) => {\n    console.log(`Hello, ${name}!`);\n    return `Hello, ${name}! Welcome to Loopman.`;\n  },\n  {\n    name: \"say_hello\",\n    description: \"Say hello to someone\",\n    schema: z.object({\n      name: z.string().describe(\"The name of the person to greet\"),\n    }),\n  }\n);\n\n// Agent node with context enrichment\nasync function agentNode(state: typeof LoopmanGraphState.State) {\n  const { messages, guidelines, decisionContext } = state;\n\n  // Enrich system prompt with guidelines and decision history\n  const systemPrompt = enrichSystemPrompt(\n    \"You are a helpful assistant that greets people ....\",\n    { guidelines, decisionContext },\n    { maxDecisions: 3 }\n  );\n\n  const model = new ChatOpenAI({ model: \"gpt-4o-mini\" });\n  const modelWithTools = model.bindTools([sayHello]);\n\n  const messagesWithContext =\n    (guidelines && guidelines.length > 0) ||\n    (decisionContext && decisionContext.length > 0)\n      ? [{ role: \"system\", content: systemPrompt }, ...messages]\n      : messages;\n\n  const response = await modelWithTools.invoke(messagesWithContext);\n\n  return {\n    messages: [response],\n  };\n}\n\n// Tool execution node\nasync function toolNode(state: typeof LoopmanGraphState.State) {\n  const { messages } = state;\n  const lastMessage = messages[messages.length - 1];\n\n  if (!lastMessage.tool_calls || lastMessage.tool_calls.length === 0) {\n    return {};\n  }\n\n  const toolCall = lastMessage.tool_calls[0];\n  const result = await sayHello.invoke(toolCall.args);\n\n  return {\n    messages: [\n      new ToolMessage({\n        content: String(result),\n        tool_call_id: toolCall.id,\n      }),\n    ],\n  };\n}\n\n// Build the graph with context loading\nconst workflow = new StateGraph(LoopmanGraphState)\n  .addNode(\n    \"load_context\",\n    createLoopmanContextNode({\n      apiKey: process.env.LOOPMAN_API_KEY!,\n      workflowId: \"hello-world-workflow\",\n      category: \"hello-world\",\n      debug: true,\n    })\n  )\n  .addNode(\"agent\", agentNode)\n  .addNode(\n    \"loopman_validation\",\n    createLoopmanValidationNode({\n      apiKey: process.env.LOOPMAN_API_KEY!,\n      workflowId: \"hello-world-workflow\",\n      debug: true,\n    })\n  )\n  .addNode(\"tools\", toolNode)\n  .addEdge(START, \"load_context\")\n  .addEdge(\"load_context\", \"agent\")\n  .addEdge(\"agent\", \"loopman_validation\")\n  .addConditionalEdges(\n    \"loopman_validation\",\n    createLoopmanConditionalEdge({ debug: true }),\n    {\n      execute: \"tools\",\n      rejected: END,\n      retry: \"agent\",\n      timeout: END,\n      error: END,\n    }\n  )\n  .addEdge(\"tools\", END);\n\n// Compile and run\nconst checkpointer = new MemorySaver();\nconst app = workflow.compile({ checkpointer });\n\nasync function main() {\n  const config = { configurable: { thread_id: \"hello-world-thread\" } };\n  const inputs = {\n    messages: [new HumanMessage(\"Say hello to Alice\")],\n  };\n\n  console.log(\"Starting LangGraph workflow with context enrichment...\");\n\n  for await (const output of await app.stream(inputs, config)) {\n    const nodeName = Object.keys(output)[0];\n    console.log(`Step: ${nodeName}`);\n  }\n\n  const finalState = await app.getState(config);\n  console.log(\"Final status:\", finalState.values.loopmanTaskStatus);\n  console.log(\"Guidelines loaded:\", finalState.values.guidelines?.length || 0);\n  console.log(\n    \"Decision context loaded:\",\n    finalState.values.decisionContext?.length || 0\n  );\n  console.log(\"Workflow completed!\");\n}\n\nmain().catch(console.error);\n",
-    "package.json": "{\n  \"name\": \"loopman-langgraph-hello-world\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Loopman LangGraph Hello World Example\",\n  \"main\": \"index.ts\",\n  \"type\": \"module\",\n  \"scripts\": {\n    \"start\": \"tsx index.ts\",\n    \"dev\": \"tsx index.ts\",\n    \"build\": \"tsc\",\n    \"run\": \"node dist/index.js\"\n  },\n  \"dependencies\": {\n    \"@langchain/core\": \"^1.0.2\",\n    \"@langchain/langgraph\": \"^1.0.7\",\n    \"@langchain/openai\": \"^1.0.0\",\n    \"@loopman/langchain-sdk\": \"^1.17.1\",\n    \"dotenv\": \"^17.2.3\",\n    \"langchain\": \"^1.0.2\",\n    \"tsx\": \"^4.20.6\",\n    \"typescript\": \"^5.9.3\",\n    \"zod\": \"^3.25.76\"\n  },\n  \"devDependencies\": {\n    \"@types/node\": \"^24.9.2\"\n  }\n}\n",
+    "package.json": "{\n  \"name\": \"loopman-langgraph-hello-world\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Loopman LangGraph Hello World Example\",\n  \"main\": \"index.ts\",\n  \"type\": \"module\",\n  \"scripts\": {\n    \"start\": \"tsx index.ts\",\n    \"dev\": \"tsx index.ts\",\n    \"build\": \"tsc\",\n    \"run\": \"node dist/index.js\"\n  },\n  \"dependencies\": {\n    \"@langchain/core\": \"^1.0.2\",\n    \"@langchain/langgraph\": \"^1.0.7\",\n    \"@langchain/openai\": \"^1.0.0\",\n    \"@loopman/langchain-sdk\": \"^1.17.3\",\n    \"dotenv\": \"^17.2.3\",\n    \"langchain\": \"^1.0.2\",\n    \"tsx\": \"^4.20.6\",\n    \"typescript\": \"^5.9.3\",\n    \"zod\": \"^3.25.76\"\n  },\n  \"devDependencies\": {\n    \"@types/node\": \"^24.9.2\"\n  }\n}\n",
     "tsconfig.json": "{\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"module\": \"ES2022\",\n    \"lib\": [\"ES2022\"],\n    \"moduleResolution\": \"bundler\",\n    \"resolveJsonModule\": true,\n    \"allowJs\": true,\n    \"outDir\": \"./dist\",\n    \"rootDir\": \"./\",\n    \"strict\": true,\n    \"esModuleInterop\": true,\n    \"skipLibCheck\": true,\n    \"forceConsistentCasingInFileNames\": true,\n    \"declaration\": true,\n    \"declarationMap\": true,\n    \"sourceMap\": true,\n    \"types\": [\"node\"]\n  },\n  \"include\": [\"**/*.ts\"],\n  \"exclude\": [\"node_modules\", \"dist\"]\n}\n",
     "README.md": "# Loopman LangGraph Hello World\n\nThis project demonstrates how to integrate Loopman with LangGraph using Context Enrichment / Feedback Loop mode.\n\n## About LangGraph\n\nLangGraph is LangChain's official framework for building stateful, multi-actor applications with LLMs. It provides:\n\n- **Stateful workflows**: Explicit state management across nodes\n- **Conditional routing**: Dynamic edges based on state\n- **Streaming support**: Real-time updates during execution\n- **Visual debugging**: Graph visualization and inspection\n\n## Setup\n\n1. Install dependencies:\n```bash\nnpm install\n```\n\n2. Copy .env.example to .env and configure your keys:\n```bash\ncp .env.example .env\n```\n\nEdit the .env file and replace the placeholders with your actual values:\n- `OPENAI_API_KEY`: Your OpenAI API key\n- `LOOPMAN_API_KEY`: Your Loopman API key\n- `LOOPMAN_WORKFLOW_ID`: Your workflow ID from Loopman\n\n3. Run the example:\n```bash\nnpm start\n```\n\n## Graph Architecture\n\nThe workflow follows this pattern:\n\n```\nSTART\n  ↓\nload_context (load guidelines and decision history)\n  ↓\nagent (LLM decides action)\n  ↓\nloopman_validation (create task + poll)\n  ↓\n[conditional edge based on status]\n  ↓\n├─→ tools (APPROVED: execute)\n├─→ agent (NEEDS_CHANGES: retry)\n└─→ END (REJECTED/TIMEOUT/ERROR: end)\n  ↓\nEND\n```\n\n## Key Features\n\n- **Context Enrichment**: Loads validation guidelines and historical decisions\n- **Prompt Enhancement**: Automatically enriches system prompts with context\n- **Learning from History**: Agent learns from past human decisions\n- **Category Filtering**: Guidelines filtered by category for relevance\n- **Feedback Loop**: Human feedback is stored and used to improve future decisions\n\n## Learn More\n\n- [LangGraph Documentation](https://js.langchain.com/docs/langgraph/)\n- [Loopman LangGraph Integration Guide](https://github.com/loopman/loopman-langchain-sdk/blob/main/docs/LANGGRAPH_INTEGRATION.md)\n- [Loopman Documentation](https://loopman.dev/docs)\n\n"
   },
   "langchain-tool-validation": {
     "index.ts": "import { MemorySaver } from \"@langchain/langgraph\";\nimport { config } from \"dotenv\";\nimport { createAgent, tool } from \"langchain\";\nimport * as z from \"zod\";\nimport { loopmanMiddleware } from \"@loopman/langchain-sdk\";\n\n// Load environment variables\nconfig();\n\n// Simple hello world tool\nconst sayHello = tool(\n  ({ name }) => {\n    console.log(`Hello, ${name}!`);\n    return `Hello, ${name}! Welcome to Loopman.`;\n  },\n  {\n    name: \"say_hello\",\n    description: \"Say hello to someone\",\n    schema: z.object({\n      name: z.string().describe(\"The name of the person to greet\"),\n    }),\n  }\n);\n\n// Create agent with Loopman middleware\nconst checkpointer = new MemorySaver();\n\nconst agent = createAgent({\n  model: \"openai:gpt-4o-mini\",\n  systemPrompt: \"You are a helpful assistant that greets people.\",\n  tools: [sayHello],\n  middleware: [\n    loopmanMiddleware({\n      apiKey: process.env.LOOPMAN_API_KEY!,\n      workflowId: process.env.LOOPMAN_WORKFLOW_ID!,\n      interruptOn: {\n        say_hello: true, // Requires human validation\n      },\n      debug: true,\n    }),\n  ],\n  checkpointer,\n});\n\n// Run the agent\nasync function main() {\n  const config = { configurable: { thread_id: \"hello-world-thread\" } };\n\n  const result = await agent.invoke(\n    {\n      messages: [\n        {\n          role: \"user\",\n          content: \"Say hello to Alice\",\n        },\n      ],\n    },\n    config\n  );\n\n  console.log(\"Agent response:\", result.messages[result.messages.length - 1].content);\n}\n\nmain().catch(console.error);\n\n",
-    "package.json": "{\n  \"name\": \"loopman-langchain-tool-validation\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Loopman LangChain Tool Validation Example\",\n  \"main\": \"index.ts\",\n  \"type\": \"module\",\n  \"scripts\": {\n    \"start\": \"tsx index.ts\",\n    \"dev\": \"tsx index.ts\",\n    \"build\": \"tsc\",\n    \"run\": \"node dist/index.js\"\n  },\n  \"dependencies\": {\n    \"@langchain/core\": \"^1.0.2\",\n    \"@langchain/mcp-adapters\": \"^1.0.0\",\n    \"@langchain/langgraph\": \"^1.0.7\",\n    \"@langchain/openai\": \"^1.0.0\",\n    \"@loopman/langchain-sdk\": \"^1.17.1\",\n    \"dotenv\": \"^17.2.3\",\n    \"langchain\": \"^1.0.2\",\n    \"tsx\": \"^4.20.6\",\n    \"typescript\": \"^5.9.3\",\n    \"zod\": \"^3.25.76\"\n  },\n  \"devDependencies\": {\n    \"@types/node\": \"^24.9.2\"\n  }\n}\n",
+    "package.json": "{\n  \"name\": \"loopman-langchain-tool-validation\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Loopman LangChain Tool Validation Example\",\n  \"main\": \"index.ts\",\n  \"type\": \"module\",\n  \"scripts\": {\n    \"start\": \"tsx index.ts\",\n    \"dev\": \"tsx index.ts\",\n    \"build\": \"tsc\",\n    \"run\": \"node dist/index.js\"\n  },\n  \"dependencies\": {\n    \"@langchain/core\": \"^1.0.2\",\n    \"@langchain/mcp-adapters\": \"^1.0.0\",\n    \"@langchain/langgraph\": \"^1.0.7\",\n    \"@langchain/openai\": \"^1.0.0\",\n    \"@loopman/langchain-sdk\": \"^1.17.3\",\n    \"dotenv\": \"^17.2.3\",\n    \"langchain\": \"^1.0.2\",\n    \"tsx\": \"^4.20.6\",\n    \"typescript\": \"^5.9.3\",\n    \"zod\": \"^3.25.76\"\n  },\n  \"devDependencies\": {\n    \"@types/node\": \"^24.9.2\"\n  }\n}\n",
     "tsconfig.json": "{\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"module\": \"ES2022\",\n    \"lib\": [\"ES2022\"],\n    \"moduleResolution\": \"bundler\",\n    \"resolveJsonModule\": true,\n    \"allowJs\": true,\n    \"outDir\": \"./dist\",\n    \"rootDir\": \"./\",\n    \"strict\": true,\n    \"esModuleInterop\": true,\n    \"skipLibCheck\": true,\n    \"forceConsistentCasingInFileNames\": true,\n    \"declaration\": true,\n    \"declarationMap\": true,\n    \"sourceMap\": true\n  },\n  \"include\": [\"**/*.ts\"],\n  \"exclude\": [\"node_modules\", \"dist\"]\n}\n\n",
     "README.md": "# Loopman LangChain - Tool Validation Mode\n\nThis project demonstrates how to integrate Loopman with LangChain using **Tool Validation** mode.\n\n## About Tool Validation Mode\n\nIn this mode, Loopman middleware intercepts specific tool calls and requires human validation before execution. This is useful when:\n- Certain actions need human approval (e.g., sending emails, making payments)\n- You want to validate AI decisions before they affect real systems\n- Compliance requires human oversight for specific operations\n\n## Setup\n\n1. Install dependencies:\n```bash\nnpm install\n```\n\n2. Copy .env.example to .env and configure your keys:\n```bash\ncp .env.example .env\n```\n\nEdit the .env file and replace the placeholders with your actual values:\n- `OPENAI_API_KEY`: Your OpenAI API key\n- `LOOPMAN_API_KEY`: Your Loopman API key\n- `LOOPMAN_WORKFLOW_ID`: Your workflow ID from Loopman\n\n3. Run the example:\n```bash\nnpm start\n```\n\n## How It Works\n\n### 1. Define Tools\n\n```typescript\nconst sayHello = tool(\n  ({ name }) => {\n    console.log(`Hello, ${name}!`);\n    return `Hello, ${name}! Welcome to Loopman.`;\n  },\n  {\n    name: \"say_hello\",\n    description: \"Say hello to someone\",\n    schema: z.object({\n      name: z.string().describe(\"The name of the person to greet\"),\n    }),\n  }\n);\n```\n\n### 2. Add Loopman Middleware\n\n```typescript\nconst agent = createAgent({\n  model: \"openai:gpt-4o-mini\",\n  tools: [sayHello],\n  middleware: [\n    loopmanMiddleware({\n      apiKey: process.env.LOOPMAN_API_KEY!,\n      workflowId: process.env.LOOPMAN_WORKFLOW_ID!,\n      interruptOn: {\n        say_hello: true, // Requires human validation\n      },\n      debug: true,\n    }),\n  ],\n  checkpointer,\n});\n```\n\n### 3. Run the Agent\n\n```typescript\nconst result = await agent.invoke(\n  {\n    messages: [{ role: \"user\", content: \"Say hello to Alice\" }],\n  },\n  config\n);\n```\n\n## Key Features\n\n- **Selective Validation**: Only specified tools require approval\n- **Automatic Interception**: Middleware handles validation workflow\n- **Stateful**: Uses checkpointer to maintain conversation state\n- **Debug Mode**: Verbose logging for development\n\n## Workflow\n\n```\n1. User sends message\n   ↓\n2. Agent generates tool call (say_hello)\n   ↓\n3. Loopman middleware intercepts\n   ↓\n4. Creates validation task\n   ↓\n5. Waits for human decision\n   ↓\n6. If approved → Execute tool\n   If rejected → Return to agent with feedback\n```\n\n## Configuration Options\n\n### interruptOn\n\nSpecify which tools require validation:\n\n```typescript\ninterruptOn: {\n  say_hello: true,        // Always validate\n  send_email: true,       // Always validate\n  get_weather: false,     // Never validate (auto-execute)\n}\n```\n\n### debug\n\nEnable/disable verbose logging:\n\n```typescript\ndebug: true  // Show detailed logs\ndebug: false // Production mode\n```\n\n## Learn More\n\n- [Loopman Middleware Documentation](https://github.com/loopman/loopman-langchain-sdk/blob/main/docs/TOOL_VALIDATION_MODE.md)\n- [LangChain Agent Documentation](https://js.langchain.com/docs/how_to/agent_executor)\n- [Loopman Documentation](https://loopman.dev/docs)\n\n"
   },
   "langchain-full-review": {
     "index.ts": "import { config } from \"dotenv\";\nimport { tool } from \"langchain\";\nimport * as z from \"zod\";\nimport { createLoopmanAgent } from \"@loopman/langchain-sdk\";\n\n// Load environment variables\nconfig();\n\n// Simple hello world tool\nconst sayHello = tool(\n  ({ name }) => {\n    console.log(`Hello, ${name}!`);\n    return `Hello, ${name}! Welcome to Loopman.`;\n  },\n  {\n    name: \"say_hello\",\n    description: \"Say hello to someone\",\n    schema: z.object({\n      name: z.string().describe(\"The name of the person to greet\"),\n    }),\n  }\n);\n\n// Create Loopman agent with full human review process\nconst agent = createLoopmanAgent({\n  apiKey: process.env.LOOPMAN_API_KEY!,\n  workflowId: process.env.LOOPMAN_WORKFLOW_ID!,\n  model: \"openai:gpt-4o-mini\",\n  systemPrompt: \"You are a helpful assistant that greets people.\",\n  category: \"hello-world\",\n  additionalTools: [sayHello],\n  requireApprovalForTools: [\"say_hello\"], // Requires validation\n  debug: true,\n});\n\n// Run the agent\nasync function main() {\n  const result = await agent.processWithHumanValidation({\n    input: \"Say hello to Alice\",\n  });\n\n  console.log(\"Agent response:\", result.response);\n  if (result.decision) {\n    console.log(\"Decision status:\", result.decision.status);\n    if (result.decision.feedback) {\n      console.log(\"Human feedback:\", result.decision.feedback);\n    }\n  }\n\n  await agent.disconnect();\n}\n\nmain().catch(console.error);\n\n",
-    "package.json": "{\n  \"name\": \"loopman-langchain-full-review\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Loopman LangChain Full Human Review Example\",\n  \"main\": \"index.ts\",\n  \"type\": \"module\",\n  \"scripts\": {\n    \"start\": \"tsx index.ts\",\n    \"dev\": \"tsx index.ts\",\n    \"build\": \"tsc\",\n    \"run\": \"node dist/index.js\"\n  },\n  \"dependencies\": {\n    \"@langchain/core\": \"^1.0.2\",\n    \"@langchain/mcp-adapters\": \"^1.0.0\",\n    \"@langchain/langgraph\": \"^1.0.7\",\n    \"@langchain/openai\": \"^1.0.0\",\n    \"@loopman/langchain-sdk\": \"^1.17.1\",\n    \"dotenv\": \"^17.2.3\",\n    \"langchain\": \"^1.0.2\",\n    \"tsx\": \"^4.20.6\",\n    \"typescript\": \"^5.9.3\",\n    \"zod\": \"^3.25.76\"\n  },\n  \"devDependencies\": {\n    \"@types/node\": \"^24.9.2\"\n  }\n}\n",
+    "package.json": "{\n  \"name\": \"loopman-langchain-full-review\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Loopman LangChain Full Human Review Example\",\n  \"main\": \"index.ts\",\n  \"type\": \"module\",\n  \"scripts\": {\n    \"start\": \"tsx index.ts\",\n    \"dev\": \"tsx index.ts\",\n    \"build\": \"tsc\",\n    \"run\": \"node dist/index.js\"\n  },\n  \"dependencies\": {\n    \"@langchain/core\": \"^1.0.2\",\n    \"@langchain/mcp-adapters\": \"^1.0.0\",\n    \"@langchain/langgraph\": \"^1.0.7\",\n    \"@langchain/openai\": \"^1.0.0\",\n    \"@loopman/langchain-sdk\": \"^1.17.3\",\n    \"dotenv\": \"^17.2.3\",\n    \"langchain\": \"^1.0.2\",\n    \"tsx\": \"^4.20.6\",\n    \"typescript\": \"^5.9.3\",\n    \"zod\": \"^3.25.76\"\n  },\n  \"devDependencies\": {\n    \"@types/node\": \"^24.9.2\"\n  }\n}\n",
     "tsconfig.json": "{\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"module\": \"ES2022\",\n    \"lib\": [\"ES2022\"],\n    \"moduleResolution\": \"bundler\",\n    \"resolveJsonModule\": true,\n    \"allowJs\": true,\n    \"outDir\": \"./dist\",\n    \"rootDir\": \"./\",\n    \"strict\": true,\n    \"esModuleInterop\": true,\n    \"skipLibCheck\": true,\n    \"forceConsistentCasingInFileNames\": true,\n    \"declaration\": true,\n    \"declarationMap\": true,\n    \"sourceMap\": true\n  },\n  \"include\": [\"**/*.ts\"],\n  \"exclude\": [\"node_modules\", \"dist\"]\n}\n\n",
     "README.md": "# Loopman LangChain - Full Human Review Mode\n\nThis project demonstrates how to integrate Loopman with LangChain using **Full Human Review Process** mode.\n\n## About Full Human Review Mode\n\nIn this mode, the Loopman Agent handles the entire workflow including:\n- Creating validation tasks\n- Waiting for human approval\n- Handling feedback and retries\n- Managing the complete lifecycle\n\nThis is useful when:\n- You want a complete HITL (Human-In-The-Loop) solution\n- The agent should wait for human decisions before proceeding\n- You need full control over the validation workflow\n\n## Setup\n\n1. Install dependencies:\n```bash\nnpm install\n```\n\n2. Copy .env.example to .env and configure your keys:\n```bash\ncp .env.example .env\n```\n\nEdit the .env file and replace the placeholders with your actual values:\n- `OPENAI_API_KEY`: Your OpenAI API key\n- `LOOPMAN_API_KEY`: Your Loopman API key\n- `LOOPMAN_WORKFLOW_ID`: Your workflow ID from Loopman\n\n3. Run the example:\n```bash\nnpm start\n```\n\n## How It Works\n\n### 1. Define Tools\n\n```typescript\nconst sayHello = tool(\n  ({ name }) => {\n    console.log(`Hello, ${name}!`);\n    return `Hello, ${name}! Welcome to Loopman.`;\n  },\n  {\n    name: \"say_hello\",\n    description: \"Say hello to someone\",\n    schema: z.object({\n      name: z.string().describe(\"The name of the person to greet\"),\n    }),\n  }\n);\n```\n\n### 2. Create Loopman Agent\n\n```typescript\nconst agent = createLoopmanAgent({\n  apiKey: process.env.LOOPMAN_API_KEY!,\n  workflowId: process.env.LOOPMAN_WORKFLOW_ID!,\n  model: \"openai:gpt-4o-mini\",\n  systemPrompt: \"You are a helpful assistant that greets people.\",\n  category: \"hello-world\",\n  additionalTools: [sayHello],\n  requireApprovalForTools: [\"say_hello\"],\n  debug: true,\n});\n```\n\n### 3. Process with Human Validation\n\n```typescript\nconst result = await agent.processWithHumanValidation({\n  input: \"Say hello to Alice\",\n});\n\nconsole.log(\"Agent response:\", result.response);\nif (result.decision) {\n  console.log(\"Decision status:\", result.decision.status);\n  console.log(\"Human feedback:\", result.decision.feedback);\n}\n```\n\n## Key Features\n\n- **Complete HITL Workflow**: Agent manages the entire validation lifecycle\n- **Automatic Polling**: Waits for human decisions\n- **Feedback Handling**: Processes human feedback and retries if needed\n- **Category Support**: Organize validations by category\n- **Debug Mode**: Verbose logging for development\n\n## Workflow\n\n```\n1. User sends message\n   ↓\n2. Agent processes with LLM\n   ↓\n3. Agent generates tool call\n   ↓\n4. Creates Loopman validation task\n   ↓\n5. Polls for human decision\n   ↓\n6. If approved → Execute and return result\n   If rejected → Process feedback and retry\n   If timeout → Handle timeout\n```\n\n## Configuration Options\n\n### requireApprovalForTools\n\nSpecify which tools require validation:\n\n```typescript\nrequireApprovalForTools: [\"say_hello\", \"send_email\"]\n// Only these tools will require human approval\n```\n\n### category\n\nOrganize validations by category:\n\n```typescript\ncategory: \"hello-world\"\n// Helps filter and organize validation tasks\n```\n\n### debug\n\nEnable/disable verbose logging:\n\n```typescript\ndebug: true  // Show detailed logs\ndebug: false // Production mode\n```\n\n## Response Structure\n\nThe `processWithHumanValidation` method returns:\n\n```typescript\n{\n  response: string,           // Final agent response\n  decision?: {\n    status: \"APPROVED\" | \"REJECTED\" | \"NEEDS_CHANGES\",\n    feedback?: string,        // Human feedback if provided\n    createdAt: Date,\n    updatedAt: Date,\n  }\n}\n```\n\n## Learn More\n\n- [Loopman Agent Documentation](https://github.com/loopman/loopman-langchain-sdk/blob/main/docs/LOOPMAN_AGENT.md)\n- [LangChain Documentation](https://js.langchain.com/docs)\n- [Loopman Documentation](https://loopman.dev/docs)\n\n"
   }

package/examples/templates/langchain-full-review/package.json

@@ -15,7 +15,7 @@
     "@langchain/mcp-adapters": "^1.0.0",
     "@langchain/langgraph": "^1.0.7",
     "@langchain/openai": "^1.0.0",
-    "@loopman/langchain-sdk": "^1.17.1",
+    "@loopman/langchain-sdk": "^1.17.3",
     "dotenv": "^17.2.3",
     "langchain": "^1.0.2",
     "tsx": "^4.20.6",

package/examples/templates/langchain-tool-validation/package.json

@@ -15,7 +15,7 @@
     "@langchain/mcp-adapters": "^1.0.0",
     "@langchain/langgraph": "^1.0.7",
     "@langchain/openai": "^1.0.0",
-    "@loopman/langchain-sdk": "^1.17.1",
+    "@loopman/langchain-sdk": "^1.17.3",
     "dotenv": "^17.2.3",
     "langchain": "^1.0.2",
     "tsx": "^4.20.6",

package/examples/templates/langgraph-hello-world/package.json

@@ -14,7 +14,7 @@
     "@langchain/core": "^1.0.2",
     "@langchain/langgraph": "^1.0.7",
     "@langchain/openai": "^1.0.0",
-    "@loopman/langchain-sdk": "^1.17.1",
+    "@loopman/langchain-sdk": "^1.17.3",
     "dotenv": "^17.2.3",
     "langchain": "^1.0.2",
     "tsx": "^4.20.6",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loopman/langchain-sdk",
-  "version": "1.17.1",
+  "version": "1.17.3",
   "description": "LangChain TypeScript SDK - Human-in-the-Loop validation via Loopman platform",
   "type": "module",
   "main": "dist/index.js",