agentpay-mcp 1.2.0 → 4.0.0

package/dist/tools/transfers.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBalancesTool = exports.GetBalancesSchema = exports.sendTokenTool = exports.SendTokenSchema = void 0;
+exports.handleSendToken = handleSendToken;
+exports.handleGetBalances = handleGetBalances;
+/**
+ * transfers.ts — send_token, get_balances tools.
+ *
+ * Wraps agentwallet-sdk v6 agentTransferToken + getBalances.
+ */
+const zod_1 = require("zod");
+const agentwallet_sdk_1 = require("agentwallet-sdk");
+const client_js_1 = require("../utils/client.js");
+const format_js_1 = require("../utils/format.js");
+// ─── send_token ────────────────────────────────────────────────────────────
+exports.SendTokenSchema = zod_1.z.object({
+    tokenSymbol: zod_1.z.string().describe('Token symbol, e.g. "USDC"'),
+    chainId: zod_1.z.number().int().describe('Chain ID where the token lives, e.g. 8453'),
+    recipientAddress: zod_1.z.string().describe('Recipient wallet address (0x-prefixed)'),
+    amount: zod_1.z
+        .string()
+        .describe('Amount in human-readable units, e.g. "10.5" for 10.5 USDC'),
+});
+exports.sendTokenTool = {
+    name: 'send_token',
+    description: 'Send any ERC-20 token from the Agent Wallet to a recipient. ' +
+        'Resolves the token address and decimals from the global registry, ' +
+        'then calls agentTransferToken through the AgentAccountV2 contract. ' +
+        'Subject to configured spend limits.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenSymbol: { type: 'string', description: 'Token symbol (e.g. "USDC", "WETH")' },
+            chainId: { type: 'number', description: 'Chain ID (e.g. 8453 for Base Mainnet)' },
+            recipientAddress: { type: 'string', description: 'Recipient address (0x-prefixed)' },
+            amount: { type: 'string', description: 'Amount in human-readable units (e.g. "10.5")' },
+        },
+        required: ['tokenSymbol', 'chainId', 'recipientAddress', 'amount'],
+    },
+};
+async function handleSendToken(input) {
+    try {
+        const wallet = (0, client_js_1.getWallet)();
+        const registry = (0, agentwallet_sdk_1.getGlobalRegistry)();
+        const token = registry.getToken(input.tokenSymbol.toUpperCase(), input.chainId);
+        if (!token) {
+            throw new Error(`Token "${input.tokenSymbol}" not found for chain ${input.chainId}. ` +
+                'Use add_custom_token to register it first.');
+        }
+        const rawAmount = (0, agentwallet_sdk_1.parseAmount)(input.amount, token.decimals);
+        const txHash = await (0, agentwallet_sdk_1.agentTransferToken)(wallet, {
+            token: token.address,
+            to: input.recipientAddress,
+            amount: rawAmount,
+        });
+        return {
+            content: [
+                (0, format_js_1.textContent)(JSON.stringify({
+                    success: true,
+                    txHash,
+                    token: token.symbol,
+                    to: input.recipientAddress,
+                    amount: input.amount,
+                    rawAmount: rawAmount.toString(),
+                    chainId: input.chainId,
+                })),
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'send_token'))],
+            isError: true,
+        };
+    }
+}
+// ─── get_balances ──────────────────────────────────────────────────────────
+exports.GetBalancesSchema = zod_1.z.object({
+    chainId: zod_1.z
+        .number()
+        .int()
+        .optional()
+        .describe('Chain ID to query balances on. Defaults to the configured wallet chain.'),
+});
+exports.getBalancesTool = {
+    name: 'get_balances',
+    description: 'Get all ERC-20 token balances for the configured Agent Wallet address. ' +
+        'Uses the global token registry to enumerate tokens for the given chain.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            chainId: {
+                type: 'number',
+                description: 'Chain ID (defaults to the configured wallet chain)',
+            },
+        },
+        required: [],
+    },
+};
+async function handleGetBalances(input) {
+    try {
+        const wallet = (0, client_js_1.getWallet)();
+        const config = (0, client_js_1.getConfig)();
+        const chainId = input.chainId ?? config.chainId;
+        const ctx = {
+            publicClient: wallet.publicClient,
+            walletClient: wallet.walletClient,
+            account: wallet.walletClient.account.address,
+            chainId,
+        };
+        const balances = await (0, agentwallet_sdk_1.getBalances)(ctx);
+        // Serialize bigints to strings for JSON
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const serialized = balances.map((b) => ({
+            ...b,
+            rawBalance: typeof b.rawBalance === 'bigint' ? b.rawBalance.toString() : b.rawBalance,
+        }));
+        return {
+            content: [
+                (0, format_js_1.textContent)(JSON.stringify({
+                    walletAddress: wallet.walletClient.account.address,
+                    chainId,
+                    count: serialized.length,
+                    balances: serialized,
+                })),
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'get_balances'))],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=transfers.js.map

package/dist/tools/transfers.js.map

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

package/dist/tools/wallet.d.ts

@@ -0,0 +1,107 @@
+/**
+ * wallet.ts — get_wallet_info, check_spend_limit, queue_approval tools.
+ */
+import { z } from 'zod';
+export declare const GetWalletInfoSchema: z.ZodObject<{
+    token: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    token?: string | undefined;
+}, {
+    token?: string | undefined;
+}>;
+export type GetWalletInfoInput = z.infer<typeof GetWalletInfoSchema>;
+export declare const getWalletInfoTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handleGetWalletInfo(input: GetWalletInfoInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const CheckSpendLimitSchema: z.ZodObject<{
+    amount_eth: z.ZodString;
+    token: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount_eth: string;
+    token?: string | undefined;
+}, {
+    amount_eth: string;
+    token?: string | undefined;
+}>;
+export type CheckSpendLimitInput = z.infer<typeof CheckSpendLimitSchema>;
+export declare const checkSpendLimitTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            amount_eth: {
+                type: string;
+                description: string;
+            };
+            token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleCheckSpendLimit(input: CheckSpendLimitInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const QueueApprovalSchema: z.ZodObject<{
+    action: z.ZodEnum<["list", "approve", "cancel"]>;
+    tx_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    action: "list" | "approve" | "cancel";
+    tx_id?: string | undefined;
+}, {
+    action: "list" | "approve" | "cancel";
+    tx_id?: string | undefined;
+}>;
+export type QueueApprovalInput = z.infer<typeof QueueApprovalSchema>;
+export declare const queueApprovalTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            tx_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleQueueApproval(input: QueueApprovalInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=wallet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/tools/wallet.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8BxB,eAAO,MAAM,mBAAmB;;;;;;EAS9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAiB7B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAsDhF;AAID,eAAO,MAAM,qBAAqB;;;;;;;;;EAWhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;CAoB/B,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAkDhF;AAID,eAAO,MAAM,mBAAmB;;;;;;;;;EAY9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;CAsB7B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA2EhF"}

package/dist/tools/wallet.js

@@ -0,0 +1,271 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queueApprovalTool = exports.QueueApprovalSchema = exports.checkSpendLimitTool = exports.CheckSpendLimitSchema = exports.getWalletInfoTool = exports.GetWalletInfoSchema = void 0;
+exports.handleGetWalletInfo = handleGetWalletInfo;
+exports.handleCheckSpendLimit = handleCheckSpendLimit;
+exports.handleQueueApproval = handleQueueApproval;
+/**
+ * wallet.ts — get_wallet_info, check_spend_limit, queue_approval tools.
+ */
+const zod_1 = require("zod");
+const viem_1 = require("viem");
+const agentwallet_sdk_1 = require("agentwallet-sdk");
+const client_js_1 = require("../utils/client.js");
+const format_js_1 = require("../utils/format.js");
+// ─── NATIVE_TOKEN constant ────────────────────────────────────────────────
+const NATIVE_TOKEN = viem_1.zeroAddress;
+// ─── get_wallet_info ───────────────────────────────────────────────────────
+exports.GetWalletInfoSchema = zod_1.z.object({
+    token: zod_1.z
+        .string()
+        .optional()
+        .describe('Token address to check budget for. ' +
+        'Use "0x0000000000000000000000000000000000000000" for ETH (default). ' +
+        'Or use a USDC/ERC20 contract address.'),
+});
+exports.getWalletInfoTool = {
+    name: 'get_wallet_info',
+    description: 'Get comprehensive wallet information including address, on-chain balance, ' +
+        'spend limits, remaining period allowance, and queue depth. ' +
+        'Use token parameter to check budget for a specific ERC20 (defaults to ETH).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            token: {
+                type: 'string',
+                description: 'Token address to check. Use "0x0000000000000000000000000000000000000000" for ETH (default).',
+            },
+        },
+        required: [],
+    },
+};
+async function handleGetWalletInfo(input) {
+    try {
+        const wallet = (0, client_js_1.getWallet)();
+        const config = (0, client_js_1.getConfig)();
+        const token = input.token ?? NATIVE_TOKEN;
+        const tokenLabel = token === NATIVE_TOKEN ? 'ETH' : token;
+        // Parallel fetches for speed
+        const [forecast, health, ethBalance] = await Promise.all([
+            (0, agentwallet_sdk_1.getBudgetForecast)(wallet, token).catch(() => null),
+            (0, agentwallet_sdk_1.getWalletHealth)(wallet, [], [token]).catch(() => null),
+            wallet.publicClient.getBalance({ address: config.walletAddress }).catch(() => null),
+        ]);
+        const explorerUrl = (0, format_js_1.explorerAddressUrl)(config.walletAddress, config.chainId);
+        const cname = (0, format_js_1.chainName)(config.chainId);
+        let out = `📊 **Agent Wallet Info**\n\n`;
+        out += `📍 Address: ${config.walletAddress}\n`;
+        out += `🌐 Chain: ${cname}\n`;
+        out += `🔗 Explorer: ${explorerUrl}\n\n`;
+        if (ethBalance !== null) {
+            out += `💰 ETH Balance: ${(0, format_js_1.formatEth)(ethBalance)}\n\n`;
+        }
+        if (forecast) {
+            const badge = (0, format_js_1.utilizationBadge)(forecast.utilizationPercent);
+            out += `📈 **Spend Limits (${tokenLabel})**\n`;
+            out += `  Per-tx limit:     ${(0, format_js_1.formatSpendLimit)(forecast.perTxLimit)}\n`;
+            out += `  Period limit:     ${(0, format_js_1.formatSpendLimit)(forecast.periodLimit)}\n`;
+            out += `  Period spent:     ${(0, format_js_1.formatEth)(forecast.periodSpent)}\n`;
+            out += `  Remaining:        ${(0, format_js_1.formatEth)(forecast.remainingInPeriod)}\n`;
+            out += `  Utilization:      ${forecast.utilizationPercent}% ${badge}\n`;
+            out += `  Period length:    ${(0, format_js_1.formatDuration)(forecast.periodLength)}\n`;
+            out += `  Period started:   ${(0, format_js_1.formatTimestamp)(forecast.periodStart)}\n`;
+            out += `  Resets in:        ${(0, format_js_1.formatDuration)(forecast.secondsUntilReset)}\n\n`;
+        }
+        if (health) {
+            out += `🔧 **Wallet Health**\n`;
+            out += `  NFT contract:     ${health.tokenContract}\n`;
+            out += `  NFT token ID:     ${health.tokenId.toString()}\n`;
+            out += `  Operator epoch:   ${health.operatorEpoch.toString()}\n`;
+            out += `  Pending queue:    ${health.pendingQueueDepth} transaction(s) awaiting approval\n`;
+        }
+        return { content: [(0, format_js_1.textContent)(out)] };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'get_wallet_info'))],
+            isError: true,
+        };
+    }
+}
+// ─── check_spend_limit ─────────────────────────────────────────────────────
+exports.CheckSpendLimitSchema = zod_1.z.object({
+    amount_eth: zod_1.z
+        .string()
+        .describe('Amount in ETH to check (e.g. "0.01"). Use this for native ETH payments.'),
+    token: zod_1.z
+        .string()
+        .optional()
+        .describe('Token contract address to check against. ' +
+        'Omit or use zero address for ETH.'),
+});
+exports.checkSpendLimitTool = {
+    name: 'check_spend_limit',
+    description: 'Check whether a proposed payment amount is within the wallet\'s autonomous spend limits. ' +
+        'Returns a clear yes/no with remaining budget details. ' +
+        'Use this before send_payment to avoid surprise queuing.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            amount_eth: {
+                type: 'string',
+                description: 'Amount in ETH to check (e.g. "0.01")',
+            },
+            token: {
+                type: 'string',
+                description: 'Token address. Omit for native ETH.',
+            },
+        },
+        required: ['amount_eth'],
+    },
+};
+async function handleCheckSpendLimit(input) {
+    try {
+        const wallet = (0, client_js_1.getWallet)();
+        const token = input.token ?? NATIVE_TOKEN;
+        const tokenLabel = token === NATIVE_TOKEN ? 'ETH' : token;
+        // Parse amount (ETH string → wei bigint)
+        const amountEth = parseFloat(input.amount_eth);
+        if (isNaN(amountEth) || amountEth <= 0) {
+            throw new Error(`Invalid amount: "${input.amount_eth}". Must be a positive number.`);
+        }
+        const amountWei = BigInt(Math.round(amountEth * 1e18));
+        const budget = await (0, agentwallet_sdk_1.checkBudget)(wallet, token);
+        const forecast = await (0, agentwallet_sdk_1.getBudgetForecast)(wallet, token);
+        const perTxOk = amountWei <= budget.perTxLimit && budget.perTxLimit > 0n;
+        const periodOk = amountWei <= budget.remainingInPeriod && budget.remainingInPeriod > 0n;
+        const canExecute = perTxOk && periodOk;
+        let out = `🔍 **Spend Limit Check**\n\n`;
+        out += `  Token:            ${tokenLabel}\n`;
+        out += `  Amount:           ${(0, format_js_1.formatEth)(amountWei)}\n\n`;
+        out += `  Per-tx limit:     ${(0, format_js_1.formatSpendLimit)(budget.perTxLimit)}\n`;
+        out += `  Within per-tx:    ${perTxOk ? '✅ Yes' : '❌ No (exceeds per-tx limit)'}\n\n`;
+        out += `  Remaining period: ${(0, format_js_1.formatEth)(budget.remainingInPeriod)}\n`;
+        out += `  Within period:    ${periodOk ? '✅ Yes' : '❌ No (would exceed period budget)'}\n\n`;
+        out += `  Resets in:        ${(0, format_js_1.formatDuration)(forecast.secondsUntilReset)}\n\n`;
+        if (canExecute) {
+            out += `✅ **APPROVED** — This payment can execute autonomously.\n`;
+        }
+        else if (budget.perTxLimit === 0n) {
+            out += `🚫 **BLOCKED** — No spend policy configured for ${tokenLabel}. Set a spend policy first.\n`;
+        }
+        else {
+            out += `⏳ **QUEUED** — This payment will be queued for owner approval.\n`;
+            if (!perTxOk) {
+                out += `   Reason: Amount exceeds per-tx limit of ${(0, format_js_1.formatEth)(budget.perTxLimit)}.\n`;
+            }
+            else {
+                out += `   Reason: Amount exceeds remaining period budget of ${(0, format_js_1.formatEth)(budget.remainingInPeriod)}.\n`;
+                out += `   Budget resets in: ${(0, format_js_1.formatDuration)(forecast.secondsUntilReset)}\n`;
+            }
+        }
+        return { content: [(0, format_js_1.textContent)(out)] };
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'check_spend_limit'))],
+            isError: true,
+        };
+    }
+}
+// ─── queue_approval ────────────────────────────────────────────────────────
+exports.QueueApprovalSchema = zod_1.z.object({
+    action: zod_1.z
+        .enum(['list', 'approve', 'cancel'])
+        .describe('"list" — show all pending transactions awaiting approval. ' +
+        '"approve" — approve a queued transaction by ID. ' +
+        '"cancel" — cancel a queued transaction by ID.'),
+    tx_id: zod_1.z
+        .string()
+        .optional()
+        .describe('Transaction queue ID (required for approve and cancel actions).'),
+});
+exports.queueApprovalTool = {
+    name: 'queue_approval',
+    description: 'Manage over-limit transactions queued for owner review. ' +
+        'Use action="list" to see pending transactions, ' +
+        '"approve" to approve one by ID, or "cancel" to cancel one by ID. ' +
+        'Approve/cancel require the agent key to have owner privileges.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: ['list', 'approve', 'cancel'],
+                description: 'Action: "list", "approve", or "cancel"',
+            },
+            tx_id: {
+                type: 'string',
+                description: 'Transaction queue ID (required for approve/cancel)',
+            },
+        },
+        required: ['action'],
+    },
+};
+async function handleQueueApproval(input) {
+    try {
+        const wallet = (0, client_js_1.getWallet)();
+        const config = (0, client_js_1.getConfig)();
+        if (input.action === 'list') {
+            const pending = await (0, agentwallet_sdk_1.getPendingApprovals)(wallet, 0n);
+            if (pending.length === 0) {
+                return {
+                    content: [
+                        (0, format_js_1.textContent)(`📋 **Pending Approvals**\n\nNo transactions awaiting approval. ✅`),
+                    ],
+                };
+            }
+            let out = `📋 **Pending Approvals** (${pending.length} transaction${pending.length > 1 ? 's' : ''})\n\n`;
+            for (const tx of pending) {
+                out += `─────────────────────────\n`;
+                out += `  Queue ID:   ${tx.txId.toString()}\n`;
+                out += `  To:         ${tx.to}\n`;
+                out += `  Value:      ${(0, format_js_1.formatEth)(tx.value)}\n`;
+                out += `  Token:      ${tx.token === NATIVE_TOKEN ? 'ETH' : tx.token}\n`;
+                if (tx.token !== NATIVE_TOKEN) {
+                    out += `  Amount:     ${tx.amount.toString()} (base units)\n`;
+                }
+                out += `  Queued at:  ${(0, format_js_1.formatTimestamp)(tx.createdAt)}\n`;
+                out += '\n';
+            }
+            out += `Use action="approve" with tx_id to approve, or action="cancel" to cancel.`;
+            return { content: [(0, format_js_1.textContent)(out)] };
+        }
+        if (input.action === 'approve' || input.action === 'cancel') {
+            if (!input.tx_id) {
+                throw new Error(`tx_id is required for action="${input.action}"`);
+            }
+            const txId = BigInt(input.tx_id);
+            let txHash;
+            if (input.action === 'approve') {
+                txHash = await (0, agentwallet_sdk_1.approveTransaction)(wallet, txId);
+                return {
+                    content: [
+                        (0, format_js_1.textContent)((0, format_js_1.formatSuccess)(`Transaction ${txId.toString()} approved!`, {
+                            'Approval TX': txHash,
+                            'Chain': (0, format_js_1.chainName)(config.chainId),
+                        })),
+                    ],
+                };
+            }
+            else {
+                txHash = await (0, agentwallet_sdk_1.cancelTransaction)(wallet, txId);
+                return {
+                    content: [
+                        (0, format_js_1.textContent)((0, format_js_1.formatSuccess)(`Transaction ${txId.toString()} cancelled.`, {
+                            'Cancel TX': txHash,
+                        })),
+                    ],
+                };
+            }
+        }
+        throw new Error(`Unknown action: ${input.action}`);
+    }
+    catch (error) {
+        return {
+            content: [(0, format_js_1.textContent)((0, format_js_1.formatError)(error, 'queue_approval'))],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=wallet.js.map

package/dist/tools/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src/tools/wallet.ts"],"names":[],"mappings":";;;AAiEA,kDAwDC;AAyCD,sDAoDC;AA4CD,kDA6EC;AA/UD;;GAEG;AACH,6BAAwB;AACxB,+BAAiD;AACjD,qDAOyB;AACzB,kDAA0D;AAC1D,kDAW4B;AAE5B,6EAA6E;AAE7E,MAAM,YAAY,GAAG,kBAAW,CAAC;AAEjC,8EAA8E;AAEjE,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qCAAqC;QACrC,sEAAsE;QACtE,uCAAuC,CACxC;CACJ,CAAC,CAAC;AAIU,QAAA,iBAAiB,GAAG;IAC/B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,4EAA4E;QAC5E,6DAA6D;QAC7D,6EAA6E;IAC/E,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6FAA6F;aAChG;SACF;QACD,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAEK,KAAK,UAAU,mBAAmB,CACvC,KAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,qBAAS,GAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAA,qBAAS,GAAE,CAAC;QAC3B,MAAM,KAAK,GAAI,KAAK,CAAC,KAA6B,IAAI,YAAY,CAAC;QACnE,MAAM,UAAU,GAAG,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QAE1D,6BAA6B;QAC7B,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACvD,IAAA,mCAAiB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;YAClD,IAAA,iCAAe,EAAC,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;YACtD,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;SACpF,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,IAAA,8BAAkB,EAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,IAAA,qBAAS,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAExC,IAAI,GAAG,GAAG,8BAA8B,CAAC;QACzC,GAAG,IAAI,eAAe,MAAM,CAAC,aAAa,IAAI,CAAC;QAC/C,GAAG,IAAI,aAAa,KAAK,IAAI,CAAC;QAC9B,GAAG,IAAI,gBAAgB,WAAW,MAAM,CAAC;QAEzC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,GAAG,IAAI,mBAAmB,IAAA,qBAAS,EAAC,UAAU,CAAC,MAAM,CAAC;QACxD,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,IAAA,4BAAgB,EAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;YAC5D,GAAG,IAAI,sBAAsB,UAAU,OAAO,CAAC;YAC/C,GAAG,IAAI,uBAAuB,IAAA,4BAAgB,EAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;YACxE,GAAG,IAAI,uBAAuB,IAAA,4BAAgB,EAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;YACzE,GAAG,IAAI,uBAAuB,IAAA,qBAAS,EAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;YAClE,GAAG,IAAI,uBAAuB,IAAA,qBAAS,EAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC;YACxE,GAAG,IAAI,uBAAuB,QAAQ,CAAC,kBAAkB,KAAK,KAAK,IAAI,CAAC;YACxE,GAAG,IAAI,uBAAuB,IAAA,0BAAc,EAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC;YACxE,GAAG,IAAI,uBAAuB,IAAA,2BAAe,EAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;YACxE,GAAG,IAAI,uBAAuB,IAAA,0BAAc,EAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC;QACjF,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,IAAI,wBAAwB,CAAC;YAChC,GAAG,IAAI,uBAAuB,MAAM,CAAC,aAAa,IAAI,CAAC;YACvD,GAAG,IAAI,uBAAuB,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;YAC5D,GAAG,IAAI,uBAAuB,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC;YAClE,GAAG,IAAI,uBAAuB,MAAM,CAAC,iBAAiB,qCAAqC,CAAC;QAC9F,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,IAAA,uBAAW,EAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,CAAC,IAAA,uBAAW,EAAC,IAAA,uBAAW,EAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC;YAC7D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAEjE,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE,OAAC;SACV,MAAM,EAAE;SACR,QAAQ,CAAC,yEAAyE,CAAC;IACtF,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,2CAA2C;QAC3C,mCAAmC,CACpC;CACJ,CAAC,CAAC;AAIU,QAAA,mBAAmB,GAAG;IACjC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,2FAA2F;QAC3F,wDAAwD;QACxD,yDAAyD;IAC3D,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;CACF,CAAC;AAEK,KAAK,UAAU,qBAAqB,CACzC,KAA2B;IAE3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,qBAAS,GAAE,CAAC;QAC3B,MAAM,KAAK,GAAI,KAAK,CAAC,KAA6B,IAAI,YAAY,CAAC;QACnE,MAAM,UAAU,GAAG,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QAE1D,yCAAyC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,CAAC,UAAU,+BAA+B,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAW,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,MAAM,IAAA,mCAAiB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAExD,MAAM,OAAO,GAAG,SAAS,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC;QACzE,MAAM,QAAQ,GAAG,SAAS,IAAI,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,iBAAiB,GAAG,EAAE,CAAC;QACxF,MAAM,UAAU,GAAG,OAAO,IAAI,QAAQ,CAAC;QAEvC,IAAI,GAAG,GAAG,8BAA8B,CAAC;QACzC,GAAG,IAAI,uBAAuB,UAAU,IAAI,CAAC;QAC7C,GAAG,IAAI,uBAAuB,IAAA,qBAAS,EAAC,SAAS,CAAC,MAAM,CAAC;QACzD,GAAG,IAAI,uBAAuB,IAAA,4BAAgB,EAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;QACtE,GAAG,IAAI,uBAAuB,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,MAAM,CAAC;QACtF,GAAG,IAAI,uBAAuB,IAAA,qBAAS,EAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACtE,GAAG,IAAI,uBAAuB,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,mCAAmC,MAAM,CAAC;QAC7F,GAAG,IAAI,uBAAuB,IAAA,0BAAc,EAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC;QAE/E,IAAI,UAAU,EAAE,CAAC;YACf,GAAG,IAAI,2DAA2D,CAAC;QACrE,CAAC;aAAM,IAAI,MAAM,CAAC,UAAU,KAAK,EAAE,EAAE,CAAC;YACpC,GAAG,IAAI,mDAAmD,UAAU,+BAA+B,CAAC;QACtG,CAAC;aAAM,CAAC;YACN,GAAG,IAAI,kEAAkE,CAAC;YAC1E,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,GAAG,IAAI,6CAA6C,IAAA,qBAAS,EAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;YACxF,CAAC;iBAAM,CAAC;gBACN,GAAG,IAAI,wDAAwD,IAAA,qBAAS,EAAC,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC;gBACxG,GAAG,IAAI,wBAAwB,IAAA,0BAAc,EAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC;YAChF,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,IAAA,uBAAW,EAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,CAAC,IAAA,uBAAW,EAAC,IAAA,uBAAW,EAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC;YAC/D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAEjE,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,OAAC;SACN,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;SACnC,QAAQ,CACP,4DAA4D;QAC5D,kDAAkD;QAClD,+CAA+C,CAChD;IACH,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,iEAAiE,CAAC;CAC/E,CAAC,CAAC;AAIU,QAAA,iBAAiB,GAAG;IAC/B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,0DAA0D;QAC1D,iDAAiD;QACjD,mEAAmE;QACnE,gEAAgE;IAClE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;gBACnC,WAAW,EAAE,wCAAwC;aACtD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oDAAoD;aAClE;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;CACF,CAAC;AAEK,KAAK,UAAU,mBAAmB,CACvC,KAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,qBAAS,GAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAA,qBAAS,GAAE,CAAC;QAE3B,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,MAAM,IAAA,qCAAmB,EAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAEtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE;wBACP,IAAA,uBAAW,EAAC,kEAAkE,CAAC;qBAChF;iBACF,CAAC;YACJ,CAAC;YAED,IAAI,GAAG,GAAG,6BAA6B,OAAO,CAAC,MAAM,eAAe,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;YACzG,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;gBACzB,GAAG,IAAI,6BAA6B,CAAC;gBACrC,GAAG,IAAI,iBAAiB,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC;gBAC/C,GAAG,IAAI,iBAAiB,EAAE,CAAC,EAAE,IAAI,CAAC;gBAClC,GAAG,IAAI,iBAAiB,IAAA,qBAAS,EAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;gBAChD,GAAG,IAAI,iBAAiB,EAAE,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;gBACzE,IAAI,EAAE,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;oBAC9B,GAAG,IAAI,iBAAiB,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;gBAChE,CAAC;gBACD,GAAG,IAAI,iBAAiB,IAAA,2BAAe,EAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1D,GAAG,IAAI,IAAI,CAAC;YACd,CAAC;YACD,GAAG,IAAI,2EAA2E,CAAC;YAEnF,OAAO,EAAE,OAAO,EAAE,CAAC,IAAA,uBAAW,EAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACzC,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC5D,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YACpE,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,MAAc,CAAC;YAEnB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,GAAG,MAAM,IAAA,oCAAkB,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBAChD,OAAO;oBACL,OAAO,EAAE;wBACP,IAAA,uBAAW,EACT,IAAA,yBAAa,EAAC,eAAe,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE;4BACxD,aAAa,EAAE,MAAM;4BACrB,OAAO,EAAE,IAAA,qBAAS,EAAC,MAAM,CAAC,OAAO,CAAC;yBACnC,CAAC,CACH;qBACF;iBACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,MAAM,IAAA,mCAAiB,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBAC/C,OAAO;oBACL,OAAO,EAAE;wBACP,IAAA,uBAAW,EACT,IAAA,yBAAa,EAAC,eAAe,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE;4BACzD,WAAW,EAAE,MAAM;yBACpB,CAAC,CACH;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,CAAC,IAAA,uBAAW,EAAC,IAAA,uBAAW,EAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC;YAC5D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/x402.d.ts

@@ -0,0 +1,90 @@
+/**
+ * x402.ts — x402_pay tool.
+ *
+ * Fetches a URL, automatically handling 402 Payment Required responses
+ * by paying with the Agent Wallet and retrying the request.
+ *
+ * v1.1.0: Auto-session detection. If an active x402 V2 session covers the
+ * requested URL, session headers are injected and no new payment is made.
+ * Pass skip_session_check=true to force a fresh payment regardless.
+ */
+import { z } from 'zod';
+export declare const X402PaySchema: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodString>;
+    max_payment_eth: z.ZodOptional<z.ZodString>;
+    timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    skip_session_check: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    timeout_ms: number;
+    url: string;
+    skip_session_check: boolean;
+    body?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    max_payment_eth?: string | undefined;
+}, {
+    url: string;
+    body?: string | undefined;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+    headers?: Record<string, string> | undefined;
+    max_payment_eth?: string | undefined;
+    timeout_ms?: number | undefined;
+    skip_session_check?: boolean | undefined;
+}>;
+export type X402PayInput = z.infer<typeof X402PaySchema>;
+export declare const x402PayTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            url: {
+                type: string;
+                description: string;
+            };
+            method: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            headers: {
+                type: string;
+                additionalProperties: {
+                    type: string;
+                };
+                description: string;
+            };
+            body: {
+                type: string;
+                description: string;
+            };
+            max_payment_eth: {
+                type: string;
+                description: string;
+            };
+            timeout_ms: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            skip_session_check: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleX402Pay(input: X402PayInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=x402.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../../src/tools/x402.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;EA2CxB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIzD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDvB,CAAC;AAIF,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAgLhF"}