@loopman/langchain-sdk 1.0.9

package/dist/loopman-agent-wrapper.d.ts

@@ -0,0 +1,70 @@
+import { RunnableConfig } from "@langchain/core/runnables";
+/**
+ * Helper function to invoke a LangChain agent with automatic retry on human feedback
+ *
+ * ⚠️ This is OPTIONAL - use it only if you want automatic retry on feedback.
+ * For manual control, just use `agent.invoke()` directly and handle retries yourself.
+ *
+ * This function monitors agent execution and automatically retries when:
+ * - Human provides feedback (NEEDS_CHANGES status)
+ * - The middleware injects a SystemMessage asking for retry
+ *
+ * Usage:
+ * ```typescript
+ * const agent = createAgent({ ... });
+ *
+ * // Option 1: With auto-retry (helper)
+ * const result = await invokeWithRetry(agent, { messages: [...] }, config);
+ *
+ * // Option 2: Without auto-retry (standard)
+ * const result = await agent.invoke({ messages: [...] }, config);
+ * ```
+ */
+export declare function invokeWithRetry(agent: any, input: any, config?: RunnableConfig, options?: {
+    maxRetries?: number;
+    debug?: boolean;
+}): Promise<any>;
+/**
+ * Helper function to stream a LangChain agent with automatic retry on human feedback
+ *
+ * ⚠️ This is OPTIONAL - use it only if you want automatic retry on feedback.
+ * For manual control, just use `agent.stream()` directly.
+ *
+ * This function monitors agent streaming and automatically retries when:
+ * - Human provides feedback (NEEDS_CHANGES status)
+ * - The middleware injects a SystemMessage asking for retry
+ *
+ * Usage:
+ * ```typescript
+ * const agent = createAgent({ ... });
+ *
+ * // Option 1: With auto-retry (helper)
+ * for await (const chunk of streamWithRetry(agent, { messages: [...] }, config)) {
+ *   console.log(chunk);
+ * }
+ *
+ * // Option 2: Without auto-retry (standard)
+ * for await (const chunk of agent.stream({ messages: [...] }, config)) {
+ *   console.log(chunk);
+ * }
+ * ```
+ */
+export declare function streamWithRetry(agent: any, input: any, config?: RunnableConfig, options?: {
+    maxRetries?: number;
+    debug?: boolean;
+}): AsyncGenerator<any, void, unknown>;
+/**
+ * DEPRECATED: Use `invokeWithRetry()` instead for more explicit control
+ *
+ * Create a wrapped agent that automatically handles Loopman feedback retries
+ *
+ * ⚠️ Warning: This modifies the agent's invoke() behavior. For less intrusive
+ * control, use `invokeWithRetry(agent, input, config, options)` directly.
+ *
+ * @deprecated Use `invokeWithRetry()` directly instead
+ */
+export declare function createLoopmanAgent(agent: any, options?: {
+    maxRetries?: number;
+    debug?: boolean;
+}): any;
+//# sourceMappingURL=loopman-agent-wrapper.d.ts.map

package/dist/loopman-agent-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopman-agent-wrapper.d.ts","sourceRoot":"","sources":["../src/loopman-agent-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,GAAG,EACV,KAAK,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,OAAO,CAAC,GAAG,CAAC,CA0Dd;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAuB,eAAe,CACpC,KAAK,EAAE,GAAG,EACV,KAAK,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CA+DpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,GAAG,EACV,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,OAcF"}

package/dist/loopman-agent-wrapper.js

@@ -0,0 +1,157 @@
+/**
+ * Helper function to invoke a LangChain agent with automatic retry on human feedback
+ *
+ * ⚠️ This is OPTIONAL - use it only if you want automatic retry on feedback.
+ * For manual control, just use `agent.invoke()` directly and handle retries yourself.
+ *
+ * This function monitors agent execution and automatically retries when:
+ * - Human provides feedback (NEEDS_CHANGES status)
+ * - The middleware injects a SystemMessage asking for retry
+ *
+ * Usage:
+ * ```typescript
+ * const agent = createAgent({ ... });
+ *
+ * // Option 1: With auto-retry (helper)
+ * const result = await invokeWithRetry(agent, { messages: [...] }, config);
+ *
+ * // Option 2: Without auto-retry (standard)
+ * const result = await agent.invoke({ messages: [...] }, config);
+ * ```
+ */
+export async function invokeWithRetry(agent, input, config, options) {
+    const maxRetries = options?.maxRetries || 5;
+    const debug = options?.debug || false;
+    if (debug) {
+        console.log("[LoopmanWrapper] Starting agent invocation with auto-retry support");
+    }
+    // First invocation
+    let result = await agent.invoke(input, config);
+    // Check if we need to retry (look for SystemMessage with retry instruction)
+    let retryCount = 0;
+    while (retryCount < maxRetries) {
+        const lastMessage = result.messages[result.messages.length - 1];
+        const messageType = lastMessage._getType();
+        const content = lastMessage.content || "";
+        // Check if this is a retry instruction from Loopman middleware
+        const needsRetry = messageType === "system" &&
+            typeof content === "string" &&
+            content.includes("generate a new corrected tool call");
+        if (!needsRetry) {
+            // No retry needed, return final result
+            if (debug) {
+                console.log("[LoopmanWrapper] No retry needed, returning result");
+            }
+            break;
+        }
+        retryCount++;
+        if (debug) {
+            console.log(`[LoopmanWrapper] Human feedback detected, retrying (${retryCount}/${maxRetries})...`);
+        }
+        // Continue the conversation from the current state
+        // The agent will see the feedback and SystemMessage, and should generate a corrected tool call
+        result = await agent.invoke({
+            messages: [], // Empty to continue from checkpointer state
+        }, config);
+    }
+    if (retryCount >= maxRetries) {
+        console.warn(`[LoopmanWrapper] Max retries (${maxRetries}) reached. Human feedback may require manual intervention.`);
+    }
+    return result;
+}
+/**
+ * Helper function to stream a LangChain agent with automatic retry on human feedback
+ *
+ * ⚠️ This is OPTIONAL - use it only if you want automatic retry on feedback.
+ * For manual control, just use `agent.stream()` directly.
+ *
+ * This function monitors agent streaming and automatically retries when:
+ * - Human provides feedback (NEEDS_CHANGES status)
+ * - The middleware injects a SystemMessage asking for retry
+ *
+ * Usage:
+ * ```typescript
+ * const agent = createAgent({ ... });
+ *
+ * // Option 1: With auto-retry (helper)
+ * for await (const chunk of streamWithRetry(agent, { messages: [...] }, config)) {
+ *   console.log(chunk);
+ * }
+ *
+ * // Option 2: Without auto-retry (standard)
+ * for await (const chunk of agent.stream({ messages: [...] }, config)) {
+ *   console.log(chunk);
+ * }
+ * ```
+ */
+export async function* streamWithRetry(agent, input, config, options) {
+    const maxRetries = options?.maxRetries || 5;
+    const debug = options?.debug || false;
+    if (debug) {
+        console.log("[LoopmanWrapper] Starting agent streaming with auto-retry support");
+    }
+    let retryCount = 0;
+    while (retryCount <= maxRetries) {
+        // Collect chunks to detect retry signal
+        const chunks = [];
+        let needsRetry = false;
+        // Stream the agent response
+        for await (const chunk of agent.stream(input, config)) {
+            chunks.push(chunk);
+            yield chunk; // Forward chunk to caller
+            // Check if this chunk signals a retry is needed
+            if (chunk.messages) {
+                const lastMessage = chunk.messages[chunk.messages.length - 1];
+                if (lastMessage) {
+                    const messageType = lastMessage._getType();
+                    const content = lastMessage.content || "";
+                    needsRetry =
+                        messageType === "system" &&
+                            typeof content === "string" &&
+                            content.includes("generate a new corrected tool call");
+                }
+            }
+        }
+        // If no retry needed, we're done
+        if (!needsRetry) {
+            if (debug) {
+                console.log("[LoopmanWrapper] Streaming completed, no retry needed");
+            }
+            return;
+        }
+        // Retry needed
+        retryCount++;
+        if (debug) {
+            console.log(`[LoopmanWrapper] Human feedback detected in stream, retrying (${retryCount}/${maxRetries})...`);
+        }
+        if (retryCount > maxRetries) {
+            console.warn(`[LoopmanWrapper] Max retries (${maxRetries}) reached during streaming.`);
+            return;
+        }
+        // Continue with empty messages (use checkpointer state)
+        input = { messages: [] };
+    }
+}
+/**
+ * DEPRECATED: Use `invokeWithRetry()` instead for more explicit control
+ *
+ * Create a wrapped agent that automatically handles Loopman feedback retries
+ *
+ * ⚠️ Warning: This modifies the agent's invoke() behavior. For less intrusive
+ * control, use `invokeWithRetry(agent, input, config, options)` directly.
+ *
+ * @deprecated Use `invokeWithRetry()` directly instead
+ */
+export function createLoopmanAgent(agent, options) {
+    console.warn("[Loopman] createLoopmanAgent() is deprecated. Use invokeWithRetry() for explicit control.");
+    return {
+        ...agent,
+        invoke: async (input, config) => {
+            return invokeWithRetry(agent, input, config, options);
+        },
+        // Keep other methods as-is
+        stream: agent.stream,
+        batch: agent.batch,
+    };
+}
+//# sourceMappingURL=loopman-agent-wrapper.js.map

package/dist/loopman-agent-wrapper.js.map

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

package/dist/loopman-middleware.d.ts

@@ -0,0 +1,78 @@
+import { ToolCall } from "@langchain/core/messages";
+import { AgentMiddleware } from "langchain";
+/**
+ * Configuration for Loopman middleware
+ */
+export interface LoopmanMiddlewareConfig {
+    /**
+     * Loopman API key
+     */
+    apiKey: string;
+    /**
+     * Workflow ID for organizing decisions in Loopman
+     */
+    workflowId: string;
+    /**
+     * Execution ID (optional, will be auto-generated if not provided)
+     */
+    executionId?: string;
+    /**
+     * Channel ID for organizing tasks in Loopman (optional)
+     * Used to route tasks to specific channels/teams
+     */
+    channelId?: string;
+    /**
+     * Mapping of tool names to interrupt configuration
+     * - true: interrupt for all tools calls with this name
+     * - false: auto-approve (no human review)
+     */
+    interruptOn?: Record<string, boolean>;
+    /**
+     * Timeout for waiting for human decision (in milliseconds)
+     * Default: 5 minutes
+     */
+    timeout?: number;
+    /**
+     * Polling interval for checking decision status (in milliseconds)
+     * Default: 5 seconds
+     */
+    pollingInterval?: number;
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+    /**
+     * Parent task ID to link tool validation tasks to initial reflection task
+     * This creates a hierarchical relationship between the initial human review
+     * and subsequent tool validation tasks
+     */
+    parentTaskId?: string;
+}
+/**
+ * Loopman decision types
+ */
+export type LoopmanDecision = "APPROVED" | "REJECTED" | "MODIFIED";
+/**
+ * Loopman middleware for LangChain v1.0
+ *
+ * Integrates Human-in-the-Loop validation via Loopman platform
+ * for tool call validation
+ *
+ * @example Basic Usage
+ * ```typescript
+ * loopmanMiddleware({
+ *   apiKey: process.env.LOOPMAN_API_KEY!,
+ *   workflowId: "email-workflow",
+ *   interruptOn: {
+ *     send_email: true,  // Requires validation
+ *     read_email: false  // Auto-approved
+ *   }
+ * })
+ * ```
+ */
+export declare function loopmanMiddleware(config: LoopmanMiddlewareConfig): AgentMiddleware<any, any, any>;
+/**
+ * Export types for external use
+ */
+export type { ToolCall };
+//# sourceMappingURL=loopman-middleware.d.ts.map

package/dist/loopman-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopman-middleware.d.ts","sourceRoot":"","sources":["../src/loopman-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,QAAQ,EAET,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAoB,MAAM,WAAW,CAAC;AAK9D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAEnE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,uBAAuB,GAC9B,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CA8chC;AAED;;GAEG;AACH,YAAY,EAAE,QAAQ,EAAE,CAAC"}