@mondaydotcomorg/atp-langchain 0.17.14

package/dist/langgraph-client.js

@@ -0,0 +1,231 @@
+/**
+ * LangGraph-aware ATP Client
+ *
+ * This client integrates ATP execution with LangGraph's interrupt-based
+ * human-in-the-loop (HITL) system. When ATP code calls atp.approval.request(),
+ * it triggers a LangGraph interrupt for production-ready async approval flows.
+ *
+ * Features:
+ * - LangGraph interrupt integration for approvals
+ * - LLM sampling via LangChain models
+ * - Checkpoint-aware state management
+ * - Production-ready async approval workflows
+ */
+import { AgentToolProtocolClient, ClientCallbackError } from '@mondaydotcomorg/atp-client';
+import { HumanMessage, SystemMessage } from '@langchain/core/messages';
+/**
+ * Exception thrown when approval is needed - this triggers LangGraph interrupt
+ */
+export class ApprovalRequiredException extends ClientCallbackError {
+    approvalRequest;
+    constructor(approvalRequest) {
+        super(`Approval required: ${approvalRequest.message}`);
+        this.approvalRequest = approvalRequest;
+        this.name = 'ApprovalRequiredException';
+    }
+}
+/**
+ * LangGraph-aware ATP Client
+ *
+ * Integrates ATP with LangGraph's production-ready interrupt system:
+ * - atp.llm.call() → Routes to LangChain LLM (no interrupt)
+ * - atp.approval.request() → Throws ApprovalRequiredException (triggers LangGraph interrupt)
+ * - Supports checkpoint-based state persistence
+ * - Enables async approval workflows
+ */
+export class LangGraphATPClient {
+    client;
+    llm;
+    embeddings;
+    useLangGraphInterrupts;
+    directApprovalHandler;
+    pendingApprovals = new Map();
+    constructor(options) {
+        const { serverUrl, headers, llm, embeddings, tools, useLangGraphInterrupts = true, approvalHandler, hooks, } = options;
+        this.client = new AgentToolProtocolClient({
+            baseUrl: serverUrl,
+            headers,
+            hooks,
+            serviceProviders: tools ? { tools } : undefined,
+        });
+        this.llm = llm;
+        this.embeddings = embeddings;
+        this.useLangGraphInterrupts = useLangGraphInterrupts;
+        this.directApprovalHandler = approvalHandler;
+        this.client.provideLLM({
+            call: async (prompt, options) => {
+                return await this.handleLLMCall(prompt, options);
+            },
+            extract: async (prompt, schema, options) => {
+                return await this.handleLLMExtract(prompt, schema, options);
+            },
+            classify: async (text, categories, options) => {
+                return await this.handleLLMClassify(text, categories, options);
+            },
+        });
+        if (this.embeddings) {
+            this.client.provideEmbedding({
+                embed: async (text) => {
+                    return await this.handleEmbedding(text);
+                },
+            });
+        }
+        this.client.provideApproval({
+            request: async (message, context) => {
+                return await this.handleApprovalRequest(message, context);
+            },
+        });
+    }
+    /**
+     * Initialize the client connection
+     */
+    async connect() {
+        await this.client.init({ name: 'langgraph-atp-client', version: '1.0.0' });
+        await this.client.connect();
+    }
+    /**
+     * Get TypeScript API definitions
+     */
+    getTypeDefinitions() {
+        return this.client.getTypeDefinitions();
+    }
+    /**
+     * Execute ATP code with LangGraph interrupt support
+     *
+     * When approval is needed:
+     * - If useLangGraphInterrupts=true: Throws ApprovalRequiredException
+     * - If useLangGraphInterrupts=false: Uses direct approval handler
+     *
+     * @throws ApprovalRequiredException when approval is needed (interrupt mode)
+     */
+    async execute(code, config) {
+        const result = await this.client.execute(code, config);
+        return {
+            result,
+            needsApproval: false,
+        };
+    }
+    /**
+     * Resume execution after approval decision
+     *
+     * Call this after LangGraph resumes from interrupt with approval decision.
+     */
+    async resumeWithApproval(executionId, approved, reason) {
+        const approvalResponse = {
+            approved,
+            reason,
+            timestamp: Date.now(),
+        };
+        this.pendingApprovals.delete(executionId);
+        return await this.client.resume(executionId, approvalResponse);
+    }
+    /**
+     * Get pending approval request for an execution
+     */
+    getPendingApproval(executionId) {
+        return this.pendingApprovals.get(executionId);
+    }
+    /**
+     * Handle LLM call - route to LangChain LLM
+     */
+    async handleLLMCall(prompt, options) {
+        const messages = [];
+        if (options?.systemPrompt) {
+            messages.push(new SystemMessage(options.systemPrompt));
+        }
+        messages.push(new HumanMessage(prompt));
+        const response = await this.llm.invoke(messages);
+        return typeof response.content === 'string'
+            ? response.content
+            : JSON.stringify(response.content);
+    }
+    /**
+     * Handle LLM extract - route to LangChain LLM with structured output
+     */
+    async handleLLMExtract(prompt, schema, options) {
+        const structuredLLM = this.llm.withStructuredOutput(schema);
+        const messages = [];
+        if (options?.systemPrompt) {
+            messages.push(new SystemMessage(options.systemPrompt));
+        }
+        messages.push(new HumanMessage(prompt));
+        const result = await structuredLLM.invoke(messages);
+        return result;
+    }
+    /**
+     * Handle LLM classify - route to LangChain LLM
+     */
+    async handleLLMClassify(text, categories, options) {
+        const prompt = `Classify the following text into one of these categories: ${categories.join(', ')}\n\nText: ${text}\n\nCategory:`;
+        const messages = [];
+        if (options?.systemPrompt) {
+            messages.push(new SystemMessage(options.systemPrompt));
+        }
+        messages.push(new HumanMessage(prompt));
+        const response = await this.llm.invoke(messages);
+        const result = typeof response.content === 'string'
+            ? response.content.trim()
+            : JSON.stringify(response.content).trim();
+        if (!categories.includes(result)) {
+            for (const category of categories) {
+                if (result.toLowerCase().includes(category.toLowerCase())) {
+                    return category;
+                }
+            }
+            const fallback = categories[0];
+            if (!fallback) {
+                throw new Error('No categories provided for classification');
+            }
+            return fallback;
+        }
+        return result;
+    }
+    /**
+     * Handle embedding - route to LangChain embeddings model
+     */
+    async handleEmbedding(text) {
+        if (!this.embeddings) {
+            throw new Error('Embeddings model not provided. Pass embeddings option when creating LangGraphATPClient.');
+        }
+        return await this.embeddings.embedQuery(text);
+    }
+    /**
+     * Get the underlying ATP client for advanced usage
+     */
+    getUnderlyingClient() {
+        return this.client;
+    }
+    async handleApprovalRequest(message, context) {
+        const executionId = context?.executionId;
+        const cleanContext = context ? { ...context } : undefined;
+        if (cleanContext) {
+            delete cleanContext.executionId;
+        }
+        if (this.useLangGraphInterrupts) {
+            if (typeof executionId !== 'string' || !executionId) {
+                throw new Error('executionId is missing in approval request context');
+            }
+            const approvalRequest = {
+                message,
+                context: cleanContext,
+                executionId,
+                timestamp: Date.now(),
+            };
+            this.pendingApprovals.set(executionId, approvalRequest);
+            throw new ApprovalRequiredException(approvalRequest);
+        }
+        if (this.directApprovalHandler) {
+            const approved = await this.directApprovalHandler(message, cleanContext);
+            return {
+                approved,
+                timestamp: Date.now(),
+            };
+        }
+        console.warn(`Approval request rejected (no handler): ${message}`);
+        return {
+            approved: false,
+            timestamp: Date.now(),
+        };
+    }
+}
+//# sourceMappingURL=langgraph-client.js.map

package/dist/langgraph-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langgraph-client.js","sourceRoot":"","sources":["../src/langgraph-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAM3F,OAAO,EAAE,YAAY,EAAE,aAAa,EAAa,MAAM,0BAA0B,CAAC;AAsElF;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,mBAAmB;IACrC;IAA5B,YAA4B,eAAgC;QAC3D,KAAK,CAAC,sBAAsB,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAD5B,oBAAe,GAAf,eAAe,CAAiB;QAE3D,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IACzC,CAAC;CACD;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,kBAAkB;IACtB,MAAM,CAA0B;IAChC,GAAG,CAAgB;IACnB,UAAU,CAAc;IACxB,sBAAsB,CAAU;IAChC,qBAAqB,CAGP;IAEd,gBAAgB,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE9D,YAAY,OAAkC;QAC7C,MAAM,EACL,SAAS,EACT,OAAO,EACP,GAAG,EACH,UAAU,EACV,KAAK,EACL,sBAAsB,GAAG,IAAI,EAC7B,eAAe,EACf,KAAK,GACL,GAAG,OAAO,CAAC;QAEZ,IAAI,CAAC,MAAM,GAAG,IAAI,uBAAuB,CAAC;YACzC,OAAO,EAAE,SAAS;YAClB,OAAO;YACP,KAAK;YACL,gBAAgB,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;SAC/C,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,sBAAsB,GAAG,sBAAsB,CAAC;QACrD,IAAI,CAAC,qBAAqB,GAAG,eAAe,CAAC;QAE7C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;YACtB,IAAI,EAAE,KAAK,EAAE,MAAc,EAAE,OAAa,EAAE,EAAE;gBAC7C,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,MAAc,EAAE,MAAW,EAAE,OAAa,EAAE,EAAE;gBAC7D,OAAO,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAC7D,CAAC;YACD,QAAQ,EAAE,KAAK,EAAE,IAAY,EAAE,UAAoB,EAAE,OAAa,EAAE,EAAE;gBACrE,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAChE,CAAC;SACD,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBAC5B,KAAK,EAAE,KAAK,EAAE,IAAY,EAAE,EAAE;oBAC7B,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;gBACzC,CAAC;aACD,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;YAC3B,OAAO,EAAE,KAAK,EAAE,OAAe,EAAE,OAAiC,EAAE,EAAE;gBACrE,OAAO,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC3D,CAAC;SACD,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACZ,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3E,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,kBAAkB;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;IACzC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,MAAiC;QAC5D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEvD,OAAO;YACN,MAAM;YACN,aAAa,EAAE,KAAK;SACpB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,kBAAkB,CACvB,WAAmB,EACnB,QAAiB,EACjB,MAAe;QAEf,MAAM,gBAAgB,GAAqB;YAC1C,QAAQ;YACR,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACrB,CAAC;QAEF,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAE1C,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,WAAmB;QACrC,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,OAAa;QACxD,MAAM,QAAQ,GAAkB,EAAE,CAAC;QAEnC,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QACxD,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAExC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEjD,OAAO,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;YAC1C,CAAC,CAAC,QAAQ,CAAC,OAAO;YAClB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,MAAW,EAAE,OAAa;QACxE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE5D,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QACxD,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAExC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEpD,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAC9B,IAAY,EACZ,UAAoB,EACpB,OAAa;QAEb,MAAM,MAAM,GAAG,6DAA6D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,eAAe,CAAC;QAElI,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QACxD,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAExC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEjD,MAAM,MAAM,GACX,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;YACnC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE;YACzB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAE5C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;gBACnC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBAC3D,OAAO,QAAQ,CAAC;gBACjB,CAAC;YACF,CAAC;YACD,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO,QAAQ,CAAC;QACjB,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAAC,IAAY;QACzC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACd,yFAAyF,CACzF,CAAC;QACH,CAAC;QAED,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,mBAAmB;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,qBAAqB,CAClC,OAAe,EACf,OAAiC;QAEjC,MAAM,WAAW,GAAI,OAAe,EAAE,WAAW,CAAC;QAClD,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1D,IAAI,YAAY,EAAE,CAAC;YAClB,OAAQ,YAAoB,CAAC,WAAW,CAAC;QAC1C,CAAC;QAED,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACjC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;YACvE,CAAC;YAED,MAAM,eAAe,GAAoB;gBACxC,OAAO;gBACP,OAAO,EAAE,YAAY;gBACrB,WAAW;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC;YAEF,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;YAExD,MAAM,IAAI,yBAAyB,CAAC,eAAe,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YACzE,OAAO;gBACN,QAAQ;gBACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC;QACH,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,2CAA2C,OAAO,EAAE,CAAC,CAAC;QACnE,OAAO;YACN,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACrB,CAAC;IACH,CAAC;CACD"}

package/dist/langgraph-tools.d.ts

@@ -0,0 +1,79 @@
+/**
+ * LangGraph Tools Integration for ATP
+ *
+ * Creates LangChain-compatible tools from ATP with full support for:
+ * - LangGraph interrupts for human-in-the-loop approvals
+ * - LLM sampling via LangChain models
+ * - Checkpoint-based state persistence
+ */
+import { Tool, DynamicStructuredTool } from '@langchain/core/tools';
+import { LangGraphATPClient, type LangGraphATPClientOptions, ApprovalRequiredException } from './langgraph-client.js';
+import { type ExecutionConfig } from '@mondaydotcomorg/atp-protocol';
+/**
+ * Options for creating ATP tools with LangGraph integration
+ */
+export interface CreateATPToolsOptions extends Omit<LangGraphATPClientOptions, 'serverUrl'> {
+    /** ATP server URL */
+    serverUrl: string;
+    /**
+     * Default execution config for all ATP code executions
+     */
+    defaultExecutionConfig?: Partial<ExecutionConfig>;
+}
+/**
+ * Result of creating ATP tools
+ */
+export interface ATPToolsResult {
+    /** The LangGraph-aware ATP client */
+    client: LangGraphATPClient;
+    /** LangChain tools for agent use */
+    tools: (Tool | DynamicStructuredTool)[];
+    /**
+     * Helper to check if an error is an approval request
+     */
+    isApprovalRequired: (error: any) => error is ApprovalRequiredException;
+    /**
+     * Helper to resume after approval
+     */
+    resumeWithApproval: (executionId: string, approved: boolean, reason?: string) => Promise<any>;
+}
+/**
+ * Creates LangChain tools from ATP server with LangGraph interrupt support
+ *
+ * Example usage with LangGraph:
+ * ```typescript
+ * import { StateGraph } from "@langchain/langgraph";
+ * import { MemorySaver } from "@langchain/langgraph";
+ * import { ChatOpenAI } from "@langchain/openai";
+ *
+ * const llm = new ChatOpenAI({ modelName: "gpt-4" });
+ * const { client, tools, isApprovalRequired, resumeWithApproval } = await createATPTools({
+ *   serverUrl: 'http://localhost:3333',
+ *   headers: { Authorization: 'Bearer test-key' }, // Optional
+ *   llm,
+ * });
+ *
+ * // Use tools in LangGraph agent
+ * const graph = new StateGraph({...})
+ *   .addNode("agent", agentNode)
+ *   .addNode("approval", async (state) => {
+ *     // Human reviews state.approvalRequest
+ *     return interrupt({ value: state.approvalRequest });
+ *   });
+ *
+ * const checkpointer = new MemorySaver();
+ * const app = graph.compile({
+ *   checkpointer,
+ *   interruptBefore: ["approval"]
+ * });
+ * ```
+ */
+export declare function createATPTools(options: CreateATPToolsOptions): Promise<ATPToolsResult>;
+/**
+ * Helper to create a simple ATP tool for existing LangGraph agents
+ *
+ * This creates a single tool that can execute ATP code. For more control,
+ * use createATPTools() directly.
+ */
+export declare function createSimpleATPTool(serverUrl: string, llm: any, headers?: Record<string, string>): Promise<Tool | DynamicStructuredTool>;
+//# sourceMappingURL=langgraph-tools.d.ts.map

package/dist/langgraph-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langgraph-tools.d.ts","sourceRoot":"","sources":["../src/langgraph-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAe,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EACN,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,yBAAyB,EACzB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,yBAAyB,EAAE,WAAW,CAAC;IAC1F,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,qCAAqC;IACrC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,oCAAoC;IACpC,KAAK,EAAE,CAAC,IAAI,GAAG,qBAAqB,CAAC,EAAE,CAAC;IACxC;;OAEG;IACH,kBAAkB,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,KAAK,IAAI,yBAAyB,CAAC;IACvE;;OAEG;IACH,kBAAkB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAC9F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CA+G5F;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACxC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,IAAI,GAAG,qBAAqB,CAAC,CAWvC"}

package/dist/langgraph-tools.js

@@ -0,0 +1,149 @@
+/**
+ * LangGraph Tools Integration for ATP
+ *
+ * Creates LangChain-compatible tools from ATP with full support for:
+ * - LangGraph interrupts for human-in-the-loop approvals
+ * - LLM sampling via LangChain models
+ * - Checkpoint-based state persistence
+ */
+import { Tool, DynamicStructuredTool } from '@langchain/core/tools';
+import { LangGraphATPClient, ApprovalRequiredException, } from './langgraph-client.js';
+import { createToolsFromATPClient, ToolNames, } from '@mondaydotcomorg/atp-client';
+import { ExecutionStatus } from '@mondaydotcomorg/atp-protocol';
+/**
+ * Creates LangChain tools from ATP server with LangGraph interrupt support
+ *
+ * Example usage with LangGraph:
+ * ```typescript
+ * import { StateGraph } from "@langchain/langgraph";
+ * import { MemorySaver } from "@langchain/langgraph";
+ * import { ChatOpenAI } from "@langchain/openai";
+ *
+ * const llm = new ChatOpenAI({ modelName: "gpt-4" });
+ * const { client, tools, isApprovalRequired, resumeWithApproval } = await createATPTools({
+ *   serverUrl: 'http://localhost:3333',
+ *   headers: { Authorization: 'Bearer test-key' }, // Optional
+ *   llm,
+ * });
+ *
+ * // Use tools in LangGraph agent
+ * const graph = new StateGraph({...})
+ *   .addNode("agent", agentNode)
+ *   .addNode("approval", async (state) => {
+ *     // Human reviews state.approvalRequest
+ *     return interrupt({ value: state.approvalRequest });
+ *   });
+ *
+ * const checkpointer = new MemorySaver();
+ * const app = graph.compile({
+ *   checkpointer,
+ *   interruptBefore: ["approval"]
+ * });
+ * ```
+ */
+export async function createATPTools(options) {
+    const { serverUrl, defaultExecutionConfig, ...clientOptions } = options;
+    const client = new LangGraphATPClient({
+        serverUrl,
+        ...clientOptions,
+    });
+    await client.connect();
+    const atpTools = createToolsFromATPClient(client.getUnderlyingClient());
+    const tools = atpTools.map((atpTool) => {
+        if (atpTool.name === ToolNames.EXECUTE_CODE) {
+            class ATPExecuteTool extends Tool {
+                name = `atp_${atpTool.name}`;
+                description = atpTool.description || 'Execute TypeScript code in ATP sandbox';
+                async _call(input) {
+                    try {
+                        let code;
+                        try {
+                            const parsed = JSON.parse(input);
+                            code = parsed.code || input;
+                        }
+                        catch {
+                            code = input;
+                        }
+                        const result = await client.execute(code, defaultExecutionConfig);
+                        if (result.result.status === ExecutionStatus.COMPLETED) {
+                            return JSON.stringify({
+                                success: true,
+                                result: result.result.result,
+                                stats: result.result.stats,
+                            }, null, 2);
+                        }
+                        else if (result.result.status === ExecutionStatus.FAILED) {
+                            return JSON.stringify({
+                                success: false,
+                                error: result.result.error,
+                                stats: result.result.stats,
+                            }, null, 2);
+                        }
+                        else {
+                            return JSON.stringify({
+                                success: false,
+                                error: 'Execution in unexpected state: ' + result.result.status,
+                            }, null, 2);
+                        }
+                    }
+                    catch (error) {
+                        if (error instanceof ApprovalRequiredException) {
+                            throw error;
+                        }
+                        return JSON.stringify({
+                            success: false,
+                            error: error.message || 'Unknown error',
+                        }, null, 2);
+                    }
+                }
+            }
+            return new ATPExecuteTool();
+        }
+        return new DynamicStructuredTool({
+            name: `atp_${atpTool.name}`,
+            description: atpTool.description || '',
+            schema: atpTool.zodSchema || atpTool.inputSchema,
+            func: async (input) => {
+                try {
+                    const result = await atpTool.func(input);
+                    return typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+                }
+                catch (error) {
+                    return JSON.stringify({
+                        success: false,
+                        error: error.message,
+                    }, null, 2);
+                }
+            },
+        });
+    });
+    return {
+        client,
+        tools,
+        isApprovalRequired: (error) => {
+            return error instanceof ApprovalRequiredException;
+        },
+        resumeWithApproval: async (executionId, approved, reason) => {
+            return await client.resumeWithApproval(executionId, approved, reason);
+        },
+    };
+}
+/**
+ * Helper to create a simple ATP tool for existing LangGraph agents
+ *
+ * This creates a single tool that can execute ATP code. For more control,
+ * use createATPTools() directly.
+ */
+export async function createSimpleATPTool(serverUrl, llm, headers) {
+    const result = await createATPTools({
+        serverUrl,
+        headers,
+        llm,
+    });
+    const tool = result.tools.find((t) => t.name === `atp_${ToolNames.EXECUTE_CODE}`);
+    if (!tool) {
+        throw new Error('Failed to create ATP execute_code tool');
+    }
+    return tool;
+}
+//# sourceMappingURL=langgraph-tools.js.map

package/dist/langgraph-tools.js.map

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

package/dist/node.d.ts

@@ -0,0 +1,29 @@
+import { AgentToolProtocolClient } from '@mondaydotcomorg/atp-client';
+/**
+ * LangGraph-compatible node for ATP execution
+ */
+export declare class ATPExecutionNode {
+    private client;
+    constructor(client: AgentToolProtocolClient);
+    /**
+     * Execute code from the state and update the state with results
+     */
+    execute(state: {
+        code?: string;
+        messages?: any[];
+        [key: string]: any;
+    }): Promise<any>;
+    /**
+     * Create a function suitable for LangGraph node
+     */
+    asFunction(): (state: {
+        code?: string;
+        messages?: any[];
+        [key: string]: any;
+    }) => Promise<any>;
+}
+/**
+ * Helper to create a simple ATP execution node function
+ */
+export declare function createATPNode(client: AgentToolProtocolClient): (state: any) => Promise<any>;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGtE;;GAEG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,EAAE,uBAAuB;IAI3C;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAgB3F;;OAEG;IACH,UAAU,YAnBW;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,KAAG,OAAO,CAAC,GAAG,CAAC;CAsB3F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,uBAAuB,IAC9C,OAAO,GAAG,kBAexB"}

package/dist/node.js

@@ -0,0 +1,49 @@
+import { ExecutionStatus } from '@mondaydotcomorg/atp-protocol';
+/**
+ * LangGraph-compatible node for ATP execution
+ */
+export class ATPExecutionNode {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Execute code from the state and update the state with results
+     */
+    async execute(state) {
+        if (!state.code) {
+            throw new Error('No code provided in state');
+        }
+        const result = await this.client.execute(state.code);
+        return {
+            ...state,
+            executionResult: result,
+            lastExecutionStatus: result.status,
+            lastExecutionOutput: result.status === ExecutionStatus.COMPLETED ? result.result : result.error,
+        };
+    }
+    /**
+     * Create a function suitable for LangGraph node
+     */
+    asFunction() {
+        return this.execute.bind(this);
+    }
+}
+/**
+ * Helper to create a simple ATP execution node function
+ */
+export function createATPNode(client) {
+    return async (state) => {
+        if (!state.code) {
+            throw new Error('No code provided in state');
+        }
+        const result = await client.execute(state.code);
+        return {
+            ...state,
+            executionResult: result,
+            lastExecutionStatus: result.status,
+            lastExecutionOutput: result.status === ExecutionStatus.COMPLETED ? result.result : result.error,
+        };
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACpB,MAAM,CAA0B;IAExC,YAAY,MAA+B;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,KAA8D;QAC3E,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAErD,OAAO;YACN,GAAG,KAAK;YACR,eAAe,EAAE,MAAM;YACvB,mBAAmB,EAAE,MAAM,CAAC,MAAM;YAClC,mBAAmB,EAClB,MAAM,CAAC,MAAM,KAAK,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK;SAC3E,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACD;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC5D,OAAO,KAAK,EAAE,KAAU,EAAE,EAAE;QAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhD,OAAO;YACN,GAAG,KAAK;YACR,eAAe,EAAE,MAAM;YACvB,mBAAmB,EAAE,MAAM,CAAC,MAAM;YAClC,mBAAmB,EAClB,MAAM,CAAC,MAAM,KAAK,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK;SAC3E,CAAC;IACH,CAAC,CAAC;AACH,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,39 @@
+/**
+ * LangChain Integration for Agent Tool Protocol
+ *
+ * Converts ATP client tools into LangChain DynamicTool instances
+ */
+import { AgentToolProtocolClient, type Tool, type ClientHooks } from '@mondaydotcomorg/atp-client';
+import { DynamicTool } from '@langchain/core/tools';
+/**
+ * Creates ATP client and returns LangChain-compatible DynamicTool instances
+ * The client is automatically connected and ready to use.
+ *
+ * @param serverUrl - ATP server URL (e.g. 'http://localhost:3333')
+ * @param headers - Optional headers for authentication (e.g. { Authorization: 'Bearer token' })
+ * @param hooks - Optional hooks for intercepting and modifying client behavior
+ * @returns Promise of { client, tools } where tools is an array of LangChain DynamicTools
+ *
+ * @example
+ * ```typescript
+ * const { client, tools } = await createATPTools('http://localhost:3333', {
+ *   Authorization: 'Bearer api-key'
+ * });
+ *
+ * // Use tools with any LangChain agent
+ * const agent = await createReactAgent({ llm, tools, prompt });
+ * const executor = new AgentExecutor({ agent, tools });
+ * ```
+ */
+export declare function createATPTools(serverUrl: string, headers?: Record<string, string>, hooks?: ClientHooks): Promise<{
+    client: AgentToolProtocolClient;
+    tools: DynamicTool<string>[];
+}>;
+/**
+ * Converts generic ATP tools into LangChain DynamicTool instances
+ *
+ * @param tools - Array of ATP tools (with inputSchema and func)
+ * @returns Array of LangChain DynamicTools
+ */
+export declare function convertToLangChainTools(tools: Tool[]): DynamicTool[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,uBAAuB,EAEvB,KAAK,IAAI,EACT,KAAK,WAAW,EAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,cAAc,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,KAAK,CAAC,EAAE,WAAW;;;GAiBnB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CASpE"}

package/dist/tools.js

@@ -0,0 +1,52 @@
+/**
+ * LangChain Integration for Agent Tool Protocol
+ *
+ * Converts ATP client tools into LangChain DynamicTool instances
+ */
+import { AgentToolProtocolClient, createToolsFromATPClient, } from '@mondaydotcomorg/atp-client';
+import { DynamicTool } from '@langchain/core/tools';
+/**
+ * Creates ATP client and returns LangChain-compatible DynamicTool instances
+ * The client is automatically connected and ready to use.
+ *
+ * @param serverUrl - ATP server URL (e.g. 'http://localhost:3333')
+ * @param headers - Optional headers for authentication (e.g. { Authorization: 'Bearer token' })
+ * @param hooks - Optional hooks for intercepting and modifying client behavior
+ * @returns Promise of { client, tools } where tools is an array of LangChain DynamicTools
+ *
+ * @example
+ * ```typescript
+ * const { client, tools } = await createATPTools('http://localhost:3333', {
+ *   Authorization: 'Bearer api-key'
+ * });
+ *
+ * // Use tools with any LangChain agent
+ * const agent = await createReactAgent({ llm, tools, prompt });
+ * const executor = new AgentExecutor({ agent, tools });
+ * ```
+ */
+export async function createATPTools(serverUrl, headers, hooks) {
+    const client = new AgentToolProtocolClient({ baseUrl: serverUrl, headers, hooks });
+    await client.connect();
+    const atpTools = createToolsFromATPClient(client);
+    const tools = atpTools.map((tool) => new DynamicTool({
+        name: tool.name,
+        description: tool.description || '',
+        func: tool.func,
+    }));
+    return { client, tools };
+}
+/**
+ * Converts generic ATP tools into LangChain DynamicTool instances
+ *
+ * @param tools - Array of ATP tools (with inputSchema and func)
+ * @returns Array of LangChain DynamicTools
+ */
+export function convertToLangChainTools(tools) {
+    return tools.map((tool) => new DynamicTool({
+        name: tool.name,
+        description: tool.description || '',
+        func: tool.func,
+    }));
+}
+//# sourceMappingURL=tools.js.map