@varun-ai07/covenant-mcp 1.2.3 → 1.3.2

package/dist/tools/account-abstraction.js

@@ -0,0 +1,364 @@
+/**
+ * Account Abstraction MCP Tools
+ *
+ * corven_create_smart_wallet   — Deploy a new AgentSmartWallet
+ * corven_get_smart_wallet      — Get wallet details (limits, pause, balance)
+ * corven_set_spending_limit    — Controller sets daily/tx limits
+ * corven_set_recipient         — Controller manages whitelist
+ * corven_emergency_pause       — Controller pauses/unpauses
+ */
+import { z } from "zod";
+import { parseEther, formatEther } from "viem";
+import { getAccount, getWalletClient, getPublicClient, getExplorerTxUrl } from "../config.js";
+import { formatReadResult } from "../handlers/transactions.js";
+import { formatSuccess, formatStructuredError, parseContractError } from "../lib/formatResponse.js";
+import { ethAddress, ethAmount } from "../lib/schemaHelpers.js";
+import fs from "node:fs";
+import path from "node:path";
+// ─── Inline ABI for AgentSmartWallet ──────────────────────────
+// Matches the Solidity contract at contracts/v2/core/AgentSmartWallet.sol
+const AgentSmartWalletAbi = [
+    { type: "constructor", inputs: [
+            { name: "_controller", type: "address" },
+            { name: "_dailyLimit", type: "uint256" },
+            { name: "_perTxLimit", type: "uint256" },
+        ], stateMutability: "nonpayable" },
+    { type: "receive", stateMutability: "payable" },
+    { type: "function", name: "controller", inputs: [], outputs: [{ type: "address" }], stateMutability: "view" },
+    { type: "function", name: "dailyLimit", inputs: [], outputs: [{ type: "uint256" }], stateMutability: "view" },
+    { type: "function", name: "perTxLimit", inputs: [], outputs: [{ type: "uint256" }], stateMutability: "view" },
+    { type: "function", name: "dailySpent", inputs: [], outputs: [{ type: "uint256" }], stateMutability: "view" },
+    { type: "function", name: "lastResetDay", inputs: [], outputs: [{ type: "uint256" }], stateMutability: "view" },
+    { type: "function", name: "paused", inputs: [], outputs: [{ type: "bool" }], stateMutability: "view" },
+    { type: "function", name: "allowedRecipients", inputs: [{ name: "", type: "address" }], outputs: [{ type: "bool" }], stateMutability: "view" },
+    { type: "function", name: "owner", inputs: [], outputs: [{ type: "address" }], stateMutability: "view" },
+    { type: "function", name: "getRemainingDailyAllowance", inputs: [], outputs: [{ type: "uint256" }], stateMutability: "view" },
+    { type: "function", name: "getBalance", inputs: [], outputs: [{ type: "uint256" }], stateMutability: "view" },
+    { type: "function", name: "execute", inputs: [
+            { name: "to", type: "address" },
+            { name: "value", type: "uint256" },
+            { name: "data", type: "bytes" },
+        ], outputs: [{ name: "result", type: "bytes" }], stateMutability: "nonpayable" },
+    { type: "function", name: "setDailyLimit", inputs: [{ name: "_limit", type: "uint256" }], outputs: [], stateMutability: "nonpayable" },
+    { type: "function", name: "setPerTxLimit", inputs: [{ name: "_limit", type: "uint256" }], outputs: [], stateMutability: "nonpayable" },
+    { type: "function", name: "setRecipient", inputs: [
+            { name: "_recipient", type: "address" },
+            { name: "_allowed", type: "bool" },
+        ], outputs: [], stateMutability: "nonpayable" },
+    { type: "function", name: "setPaused", inputs: [{ name: "_paused", type: "bool" }], outputs: [], stateMutability: "nonpayable" },
+    { type: "function", name: "setController", inputs: [{ name: "_controller", type: "address" }], outputs: [], stateMutability: "nonpayable" },
+];
+// ─── Bytecode loader ──────────────────────────────────────────
+function loadSmartWalletBytecode() {
+    // Resolve from the MCP package root
+    const candidates = [
+        // Relative to this source file (mcp/src/tools -> mcp -> contracts)
+        path.resolve(process.cwd(), "../contracts/artifacts/contracts/v2/core/AgentSmartWallet.sol/AgentSmartWallet.json"),
+        // Absolute project layout
+        path.resolve(process.cwd(), "contracts/artifacts/contracts/v2/core/AgentSmartWallet.sol/AgentSmartWallet.json"),
+    ];
+    for (const artifactPath of candidates) {
+        if (fs.existsSync(artifactPath)) {
+            const artifact = JSON.parse(fs.readFileSync(artifactPath, "utf-8"));
+            return artifact.bytecode;
+        }
+    }
+    throw new Error("AgentSmartWallet artifact not found. Run: cd /home/vxrun/Projects/varun/contracts && npx hardhat compile");
+}
+// ─── Deploy helper ────────────────────────────────────────────
+async function deploySmartWallet(controller, dailyLimitWei, perTxLimitWei) {
+    const wallet = getWalletClient();
+    const publicClient = getPublicClient();
+    const account = getAccount();
+    if (!wallet || !account) {
+        return { status: "error", error: "No wallet client available. Set PRIVATE_KEY and COVENANT_WALLET_MODE=autonomous." };
+    }
+    try {
+        const bytecode = loadSmartWalletBytecode();
+        const hash = await wallet.deployContract({
+            abi: AgentSmartWalletAbi,
+            bytecode,
+            args: [controller, dailyLimitWei, perTxLimitWei],
+            account,
+        });
+        console.error(`[TX] Deploy AgentSmartWallet: ${hash}`);
+        console.error(`[TX] Explorer: ${getExplorerTxUrl(hash)}`);
+        const receipt = await publicClient.waitForTransactionReceipt({
+            hash,
+            timeout: 60_000,
+        });
+        return {
+            status: "success",
+            txHash: hash,
+            blockNumber: receipt.blockNumber,
+            gasUsed: receipt.gasUsed,
+        };
+    }
+    catch (error) {
+        const msg = error?.message || String(error);
+        return { status: "error", error: msg.slice(0, 500) };
+    }
+}
+// ─── Write helper (for existing contracts) ────────────────────
+async function executeWalletWrite(walletAddress, functionName, args) {
+    const wallet = getWalletClient();
+    const publicClient = getPublicClient();
+    const account = getAccount();
+    if (!wallet || !account) {
+        return { status: "error", error: "No wallet client available. Set PRIVATE_KEY and COVENANT_WALLET_MODE=autonomous." };
+    }
+    try {
+        const { request } = await publicClient.simulateContract({
+            address: walletAddress,
+            abi: AgentSmartWalletAbi,
+            functionName,
+            args: args,
+            account,
+        });
+        const hash = await wallet.writeContract(request);
+        console.error(`[TX] ${functionName}: ${hash}`);
+        const receipt = await publicClient.waitForTransactionReceipt({
+            hash,
+            timeout: 60_000,
+        });
+        return {
+            status: "success",
+            txHash: hash,
+            blockNumber: receipt.blockNumber,
+            gasUsed: receipt.gasUsed,
+        };
+    }
+    catch (error) {
+        const msg = error?.message || String(error);
+        const revertMatch = msg.match(/revert(?:ed| reason)?\s*:?\s*"?([^"\n]+)"?/i);
+        return {
+            status: "error",
+            error: revertMatch ? `Transaction reverted: ${revertMatch[1]}` : msg.slice(0, 500),
+            reason: msg,
+        };
+    }
+}
+// ─── Error helper ─────────────────────────────────────────────
+function txErrorMessage(result) {
+    if (result.status === "error")
+        return result.error;
+    if (result.status === "prepared")
+        return "Transaction prepared but not sent (prepare-only mode).";
+    return "Unknown error.";
+}
+// ─── Register tools ───────────────────────────────────────────
+export function registerAATools(server) {
+    // ──────────────────────────────────────────────────────────────
+    // corven_create_smart_wallet
+    // ──────────────────────────────────────────────────────────────
+    server.registerTool("corven_create_smart_wallet", {
+        title: "Deploy Smart Wallet",
+        description: "Deploy a new AgentSmartWallet for the caller. Creates an ERC-4337 compatible smart account with spending limits, recipient whitelist, and emergency pause.\n" +
+            "USE WHEN: An agent needs a dedicated smart wallet with safety guardrails. The deployer becomes the owner (agent EOA) and controller (human guardian).\n" +
+            "REQUIRES: PRIVATE_KEY set in .env. Wallet needs ~0.001 ETH for gas.\n" +
+            "RETURNS: Wallet address, controller, daily limit, per-tx limit, Basescan link.\n" +
+            "COMES BEFORE: corven_set_recipient to whitelist payment targets. corven_set_spending_limit to adjust limits.\n" +
+            "NOTE: The controller can pause the wallet, change limits, and manage the whitelist. The agent can only execute transactions within the set limits.",
+        inputSchema: {
+            controller: ethAddress.describe("Human controller address (can pause, set limits, manage whitelist)"),
+            dailyLimit: ethAmount.describe("Daily spending limit in ETH (e.g. '1.0')"),
+            perTxLimit: ethAmount.describe("Per-transaction cap in ETH (e.g. '0.1')"),
+        },
+    }, async ({ controller, dailyLimit, perTxLimit }) => {
+        try {
+            const account = getAccount();
+            if (!account) {
+                return formatStructuredError("No private key configured.", "PRIVATE_KEY environment variable is not set.", "Set PRIVATE_KEY in your .env file.", false);
+            }
+            const dailyLimitWei = parseEther(dailyLimit);
+            const perTxLimitWei = parseEther(perTxLimit);
+            const result = await deploySmartWallet(controller, dailyLimitWei, perTxLimitWei);
+            if (result.status === "success") {
+                const publicClient = getPublicClient();
+                const receipt = await publicClient.getTransactionReceipt({ hash: result.txHash });
+                const walletAddr = receipt.contractAddress;
+                return formatSuccess(`AgentSmartWallet deployed. Agent = owner, human = controller.`, {
+                    walletAddress: walletAddr || "Check Basescan for contract address",
+                    owner: account.address,
+                    controller,
+                    dailyLimit: `${dailyLimit} ETH`,
+                    perTxLimit: `${perTxLimit} ETH`,
+                }, result.txHash, [
+                    "Call corven_set_recipient to whitelist addresses the wallet can send to.",
+                    "Call corven_set_spending_limit to adjust daily/tx limits.",
+                    "The controller can call corven_emergency_pause to freeze the wallet.",
+                ]);
+            }
+            return {
+                content: [{ type: "text", text: `Deployment failed: ${txErrorMessage(result)}` }],
+                isError: true,
+            };
+        }
+        catch (e) {
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
+        }
+    });
+    // ──────────────────────────────────────────────────────────────
+    // corven_get_smart_wallet
+    // ──────────────────────────────────────────────────────────────
+    server.registerTool("corven_get_smart_wallet", {
+        title: "Get Smart Wallet Details",
+        description: "Read all details of an AgentSmartWallet: owner, controller, limits, daily spend, pause status, balance.\n" +
+            "USE WHEN: Checking current spending limits. Verifying pause status. Checking remaining daily allowance.\n" +
+            "REQUIRES: Nothing. Free read-only call.\n" +
+            "RETURNS: Owner, controller, daily limit, per-tx limit, daily spent, remaining allowance, pause status, balance.\n" +
+            "NOTE: Daily counter resets at midnight UTC automatically.",
+        inputSchema: {
+            walletAddress: ethAddress.describe("The AgentSmartWallet contract address"),
+        },
+    }, async ({ walletAddress }) => {
+        try {
+            const publicClient = getPublicClient();
+            const addr = walletAddress;
+            const [owner, controller, dailyLimit, perTxLimit, dailySpent, lastResetDay, paused, balance, remainingAllowance] = await Promise.all([
+                publicClient.readContract({ address: addr, abi: AgentSmartWalletAbi, functionName: "owner" }),
+                publicClient.readContract({ address: addr, abi: AgentSmartWalletAbi, functionName: "controller" }),
+                publicClient.readContract({ address: addr, abi: AgentSmartWalletAbi, functionName: "dailyLimit" }),
+                publicClient.readContract({ address: addr, abi: AgentSmartWalletAbi, functionName: "perTxLimit" }),
+                publicClient.readContract({ address: addr, abi: AgentSmartWalletAbi, functionName: "dailySpent" }),
+                publicClient.readContract({ address: addr, abi: AgentSmartWalletAbi, functionName: "lastResetDay" }),
+                publicClient.readContract({ address: addr, abi: AgentSmartWalletAbi, functionName: "paused" }),
+                publicClient.readContract({ address: addr, abi: AgentSmartWalletAbi, functionName: "getBalance" }),
+                publicClient.readContract({ address: addr, abi: AgentSmartWalletAbi, functionName: "getRemainingDailyAllowance" }),
+            ]);
+            return formatReadResult({
+                walletAddress: walletAddress,
+                owner,
+                controller,
+                dailyLimit: formatEther(dailyLimit) + " ETH",
+                perTxLimit: formatEther(perTxLimit) + " ETH",
+                dailySpent: formatEther(dailySpent) + " ETH",
+                remainingDailyAllowance: formatEther(remainingAllowance) + " ETH",
+                lastResetDay: Number(lastResetDay),
+                paused: paused ? "YES" : "NO",
+                balance: formatEther(balance) + " ETH",
+            }, `Smart Wallet ${walletAddress}`);
+        }
+        catch (e) {
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
+        }
+    });
+    // ──────────────────────────────────────────────────────────────
+    // corven_set_spending_limit
+    // ──────────────────────────────────────────────────────────────
+    server.registerTool("corven_set_spending_limit", {
+        title: "Set Spending Limits",
+        description: "Controller sets the daily and/or per-transaction spending limits on an AgentSmartWallet.\n" +
+            "USE WHEN: The agent needs higher/lower limits. Adjusting guardrails for a specific workload.\n" +
+            "REQUIRES: PRIVATE_KEY must be the controller address. Only the human controller can call this.\n" +
+            "RETURNS: Updated limits, transaction confirmation.\n" +
+            "NOTE: The agent (owner) CANNOT call this -- only the controller can adjust limits.",
+        inputSchema: {
+            walletAddress: ethAddress.describe("The AgentSmartWallet contract address"),
+            dailyLimit: ethAmount.optional().describe("New daily spending limit in ETH (omit to keep current)"),
+            perTxLimit: ethAmount.optional().describe("New per-transaction cap in ETH (omit to keep current)"),
+        },
+    }, async ({ walletAddress, dailyLimit, perTxLimit }) => {
+        try {
+            if (!dailyLimit && !perTxLimit) {
+                return formatStructuredError("No limits provided.", "At least one of dailyLimit or perTxLimit must be specified.", "Provide dailyLimit and/or perTxLimit in ETH.", false);
+            }
+            const results = [];
+            if (dailyLimit) {
+                const result = await executeWalletWrite(walletAddress, "setDailyLimit", [parseEther(dailyLimit)]);
+                if (result.status === "success") {
+                    results.push(`Daily limit set to ${dailyLimit} ETH`);
+                }
+                else {
+                    return { content: [{ type: "text", text: `Failed: ${result.status === "error" ? result.error : "unknown error"}` }], isError: true };
+                }
+            }
+            if (perTxLimit) {
+                const result = await executeWalletWrite(walletAddress, "setPerTxLimit", [parseEther(perTxLimit)]);
+                if (result.status === "success") {
+                    results.push(`Per-tx limit set to ${perTxLimit} ETH`);
+                }
+                else {
+                    return { content: [{ type: "text", text: `Failed: ${result.status === "error" ? result.error : "unknown error"}` }], isError: true };
+                }
+            }
+            return formatSuccess(`Spending limits updated.`, {
+                walletAddress,
+                ...(dailyLimit && { dailyLimit: `${dailyLimit} ETH` }),
+                ...(perTxLimit && { perTxLimit: `${perTxLimit} ETH` }),
+                changes: results,
+            });
+        }
+        catch (e) {
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
+        }
+    });
+    // ──────────────────────────────────────────────────────────────
+    // corven_set_recipient
+    // ──────────────────────────────────────────────────────────────
+    server.registerTool("corven_set_recipient", {
+        title: "Manage Recipient Whitelist",
+        description: "Controller adds or removes an address from the wallet's recipient whitelist. The agent can only send ETH to whitelisted addresses.\n" +
+            "USE WHEN: Whitelisting a new payment target (e.g., a worker agent, a contract). Removing a compromised address.\n" +
+            "REQUIRES: PRIVATE_KEY must be the controller address. Only the human controller can call this.\n" +
+            "RETURNS: Recipient address, allowed status, transaction confirmation.\n" +
+            "NOTE: Without whitelisting, the agent's execute() calls will revert with 'Recipient not whitelisted'.",
+        inputSchema: {
+            walletAddress: ethAddress.describe("The AgentSmartWallet contract address"),
+            recipient: ethAddress.describe("Address to add/remove from whitelist"),
+            allowed: z.boolean().describe("true = add to whitelist, false = remove from whitelist"),
+        },
+    }, async ({ walletAddress, recipient, allowed }) => {
+        try {
+            const result = await executeWalletWrite(walletAddress, "setRecipient", [recipient, allowed]);
+            if (result.status === "success") {
+                return formatSuccess(`Recipient ${allowed ? "whitelisted" : "removed"}.`, {
+                    walletAddress,
+                    recipient,
+                    allowed: allowed ? "WHITELISTED" : "REMOVED",
+                }, result.txHash);
+            }
+            return { content: [{ type: "text", text: `Failed: ${result.status === "error" ? result.error : "unknown error"}` }], isError: true };
+        }
+        catch (e) {
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
+        }
+    });
+    // ──────────────────────────────────────────────────────────────
+    // corven_emergency_pause
+    // ──────────────────────────────────────────────────────────────
+    server.registerTool("corven_emergency_pause", {
+        title: "Emergency Pause/Unpause",
+        description: "Controller pauses or unpauses the AgentSmartWallet. When paused, all execute() calls revert -- the agent cannot send any ETH.\n" +
+            "USE WHEN: Suspecting the agent is compromised. Pre-maintenance freeze. Unpausing after resolving an incident.\n" +
+            "REQUIRES: PRIVATE_KEY must be the controller address. Only the human controller can call this.\n" +
+            "RETURNS: Pause status, transaction confirmation.\n" +
+            "NOTE: This is an emergency safety mechanism. The agent cannot unpause itself.",
+        inputSchema: {
+            walletAddress: ethAddress.describe("The AgentSmartWallet contract address"),
+            paused: z.boolean().describe("true = pause (freeze), false = unpause (resume)"),
+        },
+    }, async ({ walletAddress, paused }) => {
+        try {
+            const result = await executeWalletWrite(walletAddress, "setPaused", [paused]);
+            if (result.status === "success") {
+                return formatSuccess(paused
+                    ? "Wallet PAUSED. All outbound transfers are frozen."
+                    : "Wallet UNPAUSED. Agent can resume transactions.", {
+                    walletAddress,
+                    status: paused ? "PAUSED" : "ACTIVE",
+                }, result.txHash);
+            }
+            return { content: [{ type: "text", text: `Failed: ${result.status === "error" ? result.error : "unknown error"}` }], isError: true };
+        }
+        catch (e) {
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
+        }
+    });
+}
+//# sourceMappingURL=account-abstraction.js.map

package/dist/tools/account-abstraction.js.map

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

package/dist/tools/batches.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batches.d.ts","sourceRoot":"","sources":["../../src/tools/batches.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2BzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwO1D"}
+{"version":3,"file":"batches.d.ts","sourceRoot":"","sources":["../../src/tools/batches.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2BzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+P1D"}

package/dist/tools/batches.js

@@ -12,6 +12,8 @@ import { parseEther, formatEther, isAddress } from "viem";
 import { loadAbi, CONTRACTS, getAccount } from "../config.js";
 import { executeOrPrepare, readContract } from "../handlers/wallet.js";
 import { formatTxResult, formatReadResult, formatError } from "../handlers/transactions.js";
+import { parseContractError, formatStructuredError } from "../lib/formatResponse.js";
+import { ethAddress, ethAmount, ipfsCid, unixDeadline } from "../lib/schemaHelpers.js";
 import { stringToBytes32, stringsToBytes32 } from "../utils.js";
 const ABI = loadAbi("ParallelTaskBatch");
 // Batch status enum
@@ -38,14 +40,19 @@ export function registerBatchTools(server) {
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_create_batch", {
         title: "Create Parallel Task Batch",
-        description: "Create a batch of tasks for multiple workers to execute in parallel. " +
-            "All arrays must have the same length. Total ETH sent = sum of payments.",
+        description: "Create a batch of tasks for multiple workers to execute in parallel. All arrays must have the same length. Total ETH sent = sum of payments.\n" +
+            "USE WHEN: You have a large task that can be split across multiple workers for parallel execution.\n" +
+            "REQUIRES: All workers must be registered agents. Your wallet must have enough ETH for the sum of all payments plus gas.\n" +
+            "RETURNS: Transaction hash. The batch ID and individual task IDs are emitted in the event logs.\n" +
+            "COMES AFTER: corven_find_workers to identify available workers for the task.\n" +
+            "COMES BEFORE: corven_check_batch_submitted (poll for completion), corven_aggregate_results (finalize when all done).\n" +
+            "NOTE: All arrays (workers, payments, deadlines, descriptionHashes) must be the same length. Max 50 workers per batch.",
         inputSchema: {
-            workers: z.array(z.string()).describe("Array of worker addresses"),
-            payments: z.array(z.string()).describe("Array of payment amounts in ETH (one per worker)"),
-            deadlines: z.array(z.number()).describe("Array of deadline timestamps (seconds)"),
-            descriptionHashes: z.array(z.string()).describe("Array of IPFS CIDs for task descriptions"),
-            aggregationSpec: z.string().describe("IPFS CID for aggregation specification"),
+            workers: z.array(ethAddress).describe("Array of worker addresses"),
+            payments: z.array(ethAmount).describe("Array of payment amounts in ETH (one per worker)"),
+            deadlines: z.array(unixDeadline).describe("Array of deadline timestamps (seconds)"),
+            descriptionHashes: z.array(ipfsCid).describe("Array of IPFS CIDs for task descriptions"),
+            aggregationSpec: ipfsCid.describe("IPFS CID for aggregation specification"),
         },
     }, async ({ workers, payments, deadlines, descriptionHashes, aggregationSpec }) => {
         try {
@@ -73,20 +80,31 @@ export function registerBatchTools(server) {
             return formatTxResult(result);
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
     // ──────────────────────────────────────────────────────────────
     // get_batch
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_get_batch", {
-        title: "Get Batch Details",
-        description: "Retrieve full details of a task batch including all task IDs.",
+        title: "Get Batch",
+        description: "Get batch details by ID, or total batch count if no ID provided.\n" +
+            "USE WHEN: You need to inspect a batch's tasks, budget, status, or aggregation spec.\n" +
+            "REQUIRES: The batch must exist on-chain.\n" +
+            "RETURNS: Batch details including client, total budget, task IDs, aggregation spec, status, and creation time. If no ID provided, returns total batch count.\n" +
+            "COMES AFTER: corven_create_batch created the batch.\n" +
+            "COMES BEFORE: corven_get_batch_status (check progress), corven_aggregate_results (finalize).\n" +
+            "NOTE: Omit batchId to get the total number of batches.",
         inputSchema: {
-            batchId: z.number().describe("Numeric batch ID"),
+            batchId: z.number().optional().describe("Batch ID. Omit to get total batch count."),
         },
     }, async ({ batchId }) => {
         try {
+            if (batchId === undefined) {
+                const count = await readContract(CONTRACTS.ParallelTaskBatch, ABI, "batchCounter", []);
+                return formatReadResult({ batchCount: Number(count) }, "Total Batches");
+            }
             const data = await readContract(CONTRACTS.ParallelTaskBatch, ABI, "getBatchDetails", [BigInt(batchId)]);
             const enriched = {
                 client: data.client,
@@ -99,7 +117,8 @@ export function registerBatchTools(server) {
             return formatReadResult(enriched, `Batch #${batchId}`);
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
     // ──────────────────────────────────────────────────────────────
@@ -107,7 +126,13 @@ export function registerBatchTools(server) {
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_get_batch_status", {
         title: "Get Batch Status",
-        description: "Get the current status of a batch (Pending/InProgress/Aggregated/etc).",
+        description: "Get the current status of a batch (Pending/InProgress/Aggregated/etc).\n" +
+            "USE WHEN: You need to check whether a batch's tasks are all completed and ready for aggregation.\n" +
+            "REQUIRES: The batch must exist on-chain.\n" +
+            "RETURNS: Batch status as a numeric code and human-readable label (Pending, InProgress, Aggregated, Completed, Failed).\n" +
+            "COMES AFTER: corven_create_batch created the batch.\n" +
+            "COMES BEFORE: corven_aggregate_results (when status shows all tasks are done).\n" +
+            "NOTE: Status 2 (Aggregated) means all tasks completed and results were finalized.",
         inputSchema: {
             batchId: z.number().describe("Numeric batch ID"),
         },
@@ -122,7 +147,8 @@ export function registerBatchTools(server) {
             return formatReadResult(result, `Batch #${batchId} Status`);
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
     // ──────────────────────────────────────────────────────────────
@@ -130,8 +156,13 @@ export function registerBatchTools(server) {
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_aggregate_results", {
         title: "Aggregate Batch Results",
-        description: "Finalize a batch by aggregating all completed task results. " +
-            "Can only be called after all tasks in the batch are Submitted.",
+        description: "Finalize a batch by aggregating all completed task results. Can only be called after all tasks in the batch are Submitted.\n" +
+            "USE WHEN: All workers in the batch have submitted their deliverables and you want to finalize the batch.\n" +
+            "REQUIRES: All tasks in the batch must be in Submitted status. You must be the batch creator.\n" +
+            "RETURNS: Transaction hash. The aggregated result hash is stored on-chain.\n" +
+            "COMES AFTER: corven_check_batch_submitted confirmed all tasks are done.\n" +
+            "COMES BEFORE: corven_get_aggregated_result to retrieve the final combined result.\n" +
+            "NOTE: This releases payments to all workers in the batch.",
         inputSchema: {
             batchId: z.number().describe("Numeric batch ID"),
         },
@@ -145,31 +176,23 @@ export function registerBatchTools(server) {
             return formatTxResult(result);
         }
         catch (e) {
-            return formatError(e);
-        }
-    });
-    // ──────────────────────────────────────────────────────────────
-    // get_batch_counter
-    // ──────────────────────────────────────────────────────────────
-    server.registerTool("corven_get_batch_counter", {
-        title: "Get Batch Counter",
-        description: "Get the total number of batches created on the protocol.",
-        inputSchema: {},
-    }, async () => {
-        try {
-            const count = await readContract(CONTRACTS.ParallelTaskBatch, ABI, "batchCounter", []);
-            return formatReadResult({ count: Number(count) }, "Batch Counter");
-        }
-        catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
+    // get_batch_counter merged into get_batch (returns count when no batchId)
     // ──────────────────────────────────────────────────────────────
     // corven_check_batch_submitted
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_check_batch_submitted", {
         title: "Check Batch All Submitted",
-        description: "Check if all subtasks in a batch have been submitted.",
+        description: "Check if all subtasks in a batch have been submitted.\n" +
+            "USE WHEN: You want to know whether a batch is ready for result aggregation.\n" +
+            "REQUIRES: The batch must exist on-chain.\n" +
+            "RETURNS: Boolean indicating whether all tasks in the batch have been submitted.\n" +
+            "COMES AFTER: corven_create_batch created the batch and workers are executing tasks.\n" +
+            "COMES BEFORE: corven_aggregate_results (call when allSubmitted is true).\n" +
+            "NOTE: Poll this periodically or after workers report completion.",
         inputSchema: { batchId: z.number().describe("Batch ID") },
     }, async ({ batchId }) => {
         try {
@@ -177,7 +200,8 @@ export function registerBatchTools(server) {
             return formatReadResult({ batchId, allSubmitted }, `Batch #${batchId} submission status`);
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
     // ──────────────────────────────────────────────────────────────
@@ -185,7 +209,13 @@ export function registerBatchTools(server) {
     // ──────────────────────────────────────────────────────────────
     server.registerTool("corven_get_aggregated_result", {
         title: "Get Aggregated Result",
-        description: "Get the aggregated result hash after a batch is finalized.",
+        description: "Get the aggregated result hash after a batch is finalized.\n" +
+            "USE WHEN: You need to retrieve the combined result of all tasks in a completed batch.\n" +
+            "REQUIRES: The batch must have been finalized via corven_aggregate_results.\n" +
+            "RETURNS: The aggregated result hash (bytes32) that represents the combined output of all batch tasks.\n" +
+            "COMES AFTER: corven_aggregate_results finalized the batch.\n" +
+            "COMES BEFORE: Use the result hash to verify or store the batch output.\n" +
+            "NOTE: Returns empty/zero hash if the batch has not been aggregated yet.",
         inputSchema: { batchId: z.number().describe("Batch ID") },
     }, async ({ batchId }) => {
         try {
@@ -193,7 +223,8 @@ export function registerBatchTools(server) {
             return formatReadResult({ batchId, aggregatedResult: result }, `Aggregated result for Batch #${batchId}`);
         }
         catch (e) {
-            return formatError(e);
+            const parsed = parseContractError(e);
+            return formatStructuredError(parsed.error, parsed.cause, parsed.fix, parsed.retryable);
         }
     });
 }