n8n-nodes-agnicwallet 1.0.10 → 1.0.12

package/README.md

@@ -33,18 +33,31 @@ AgnicWallet is a non-custodial Web3 wallet service that handles blockchain payme
 
 ## Installation
 
-### For self-hosted N8N:
+### For self-hosted n8n (Recommended Method):
+
+Install in the n8n custom nodes directory:
 
 ```bash
-npm install -g n8n-nodes-agnicwallet
+cd ~/.n8n/nodes
+npm init -y  # Only needed first time
+npm install n8n-nodes-agnicwallet --legacy-peer-deps
 ```
 
-Then restart N8N:
+Then restart n8n:
 
 ```bash
 n8n start
 ```
 
+> **Why `--legacy-peer-deps`?**
+>
+> This flag prevents npm from installing conflicting versions of `langchain`. Our node uses n8n's built-in `langchain@0.3.x`, but other community nodes may require `langchain@1.x`. Without this flag, npm may fail with dependency conflicts or install an incompatible version.
+>
+> You can also set this globally:
+> ```bash
+> echo "legacy-peer-deps=true" >> ~/.npmrc
+> ```
+
 ### For Docker:
 
 Add to your Dockerfile:
@@ -53,13 +66,21 @@ Add to your Dockerfile:
 FROM n8nio/n8n:latest
 
 USER root
-RUN npm install -g n8n-nodes-agnicwallet
+RUN cd /home/node/.n8n/nodes && \
+    npm init -y && \
+    npm install n8n-nodes-agnicwallet --legacy-peer-deps
 USER node
 ```
 
+### Global Installation (Alternative):
+
+```bash
+npm install -g n8n-nodes-agnicwallet --legacy-peer-deps
+```
+
 ### For n8n.cloud:
 
-Not yet available. This node must first be approved as a community node by the N8N team.
+Not yet available. This node must first be approved as a community node by the n8n team.
 
 ## Setup
 
@@ -234,6 +255,30 @@ This is standard practice and well-documented in the node's README.
 
 ## Troubleshooting
 
+### "ERESOLVE unable to resolve dependency tree" or "Package subpath './agents' is not defined"
+
+**Cause:**
+Conflicting `langchain` versions between community nodes. Some nodes require `langchain@1.x` while our AI Agent tools require `langchain@0.3.x` (n8n's built-in version).
+
+**Solution:**
+Always install with `--legacy-peer-deps`:
+```bash
+cd ~/.n8n/nodes
+npm install n8n-nodes-agnicwallet --legacy-peer-deps
+```
+
+Or set it globally:
+```bash
+echo "legacy-peer-deps=true" >> ~/.npmrc
+```
+
+If you already installed without this flag, clean up and reinstall:
+```bash
+cd ~/.n8n/nodes
+rm -rf node_modules package-lock.json
+npm install --legacy-peer-deps
+```
+
 ### "Payment signing failed"
 
 **Causes:**
@@ -242,7 +287,7 @@ This is standard practice and well-documented in the node's README.
 - Backend server down
 
 **Solutions:**
-1. Reconnect credentials in N8N
+1. Reconnect credentials in n8n
 2. Check balance at [AgnicWallet](https://app.agnicpay.xyz)
 3. Check backend status
 

package/dist/nodes/AgnicMCPTool/AgnicMCPTool.node.js

@@ -5,8 +5,20 @@ const n8n_workflow_1 = require("n8n-workflow");
 const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
 const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
 const tools_1 = require("@langchain/core/tools");
+const agents_1 = require("langchain/agents");
 const zod_1 = require("zod");
 const json_schema_to_zod_1 = require("@n8n/json-schema-to-zod");
+/**
+ * Toolkit class that wraps MCP tools for n8n AI Agent.
+ * MUST extend Toolkit for n8n's instanceof check to pass.
+ * Resolves to n8n's bundled langchain@0.3.x at runtime.
+ */
+class AgnicMcpToolkit extends agents_1.Toolkit {
+    constructor(tools) {
+        super();
+        this.tools = tools;
+    }
+}
 // Pre-configured AgnicPay MCP endpoint (uses HTTP Streamable transport)
 const AGNIC_MCP_ENDPOINT = "https://mcp.agnicpay.xyz/sse";
 /**
@@ -306,16 +318,16 @@ class AgnicMCPTool {
                 return result;
             };
             // Convert MCP tools to LangChain DynamicStructuredTools
-            // Returns tools directly - n8n's getConnectedTools handles both
-            // Toolkit instances and raw tool arrays via flatMap
             const langchainTools = mcpTools.map((tool) => mcpToolToDynamicTool(tool, callTool));
+            // Wrap in Toolkit for n8n AI Agent compatibility
+            // n8n checks: toolkit instanceof Toolkit, then calls getTools()
+            const toolkit = new AgnicMcpToolkit(langchainTools);
             // Store references for cleanup
             const clientRef = client;
             const transportRef = transport;
-            // Return tools directly (not wrapped in Toolkit)
-            // This avoids langchain version conflicts with other community nodes
+            // Return toolkit with cleanup function
             return {
-                response: langchainTools,
+                response: toolkit,
                 closeFunction: async () => {
                     try {
                         await clientRef.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-agnicwallet",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "n8n community node for AgnicWallet - automated Web3 payments for X402 APIs",
   "keywords": [
     "n8n-community-node-package",
@@ -70,6 +70,7 @@
     "eslint": "^8.54.0",
     "eslint-plugin-n8n-nodes-base": "^1.16.1",
     "gulp": "^4.0.2",
+    "langchain": "^0.3.33",
     "n8n-workflow": "^1.40.0",
     "prettier": "^3.1.0",
     "typescript": "^5.3.0"