@t402/mcp 2.4.0 → 2.6.0

package/dist/cjs/tools/index.d.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod';
-import { S as SupportedNetwork, C as ChainBalance, a as PaymentResult, G as GaslessPaymentResult, B as BridgeFeeQuote, b as BridgeResult } from '../types-CWK2p9_n.js';
+import { S as SupportedNetwork, C as ChainBalance, b as PaymentResult, G as GaslessPaymentResult, B as BridgeFeeQuote, a as BridgeResult } from '../ton-bridge-BN3RKhNy.js';
+export { d as TON_BRIDGE_TOOLS, e as TonMcpBridgeConfig, f as createTonBridgeToolSet, g as executeTonBridgeTool } from '../ton-bridge-BN3RKhNy.js';
+import { T402WDK } from '@t402/wdk';
 import 'viem';
 
 /**
@@ -244,12 +246,518 @@ declare function executeBridge(input: BridgeInput, options: BridgeOptions): Prom
  */
 declare function formatBridgeResult(result: BridgeResult): string;
 
+/**
+ * wdk/getWallet - Get wallet info from WDK
+ */
+
+/**
+ * Input schema for wdk/getWallet tool
+ */
+declare const wdkGetWalletInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+type WdkGetWalletInput = z.infer<typeof wdkGetWalletInputSchema>;
+/**
+ * Wallet info result
+ */
+interface WdkWalletInfo {
+    /** EVM address */
+    evmAddress: string;
+    /** Supported chains */
+    chains: string[];
+}
+/**
+ * Execute wdk/getWallet tool
+ *
+ * @param _input - Empty input (no params needed)
+ * @param wdk - T402WDK instance
+ * @returns Wallet info
+ */
+declare function executeWdkGetWallet(_input: WdkGetWalletInput, wdk: T402WDK): Promise<WdkWalletInfo>;
+/**
+ * Execute wdk/getWallet in demo mode
+ *
+ * @returns Demo wallet info
+ */
+declare function executeWdkGetWalletDemo(): WdkWalletInfo;
+/**
+ * Format wallet info for display
+ *
+ * @param info - Wallet info
+ * @returns Formatted string
+ */
+declare function formatWdkWalletResult(info: WdkWalletInfo): string;
+
+/**
+ * wdk/getBalances - Get multi-chain balances via WDK
+ */
+
+/**
+ * Input schema for wdk/getBalances tool
+ */
+declare const wdkGetBalancesInputSchema: z.ZodObject<{
+    chains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    chains?: string[] | undefined;
+}, {
+    chains?: string[] | undefined;
+}>;
+type WdkGetBalancesInput = z.infer<typeof wdkGetBalancesInputSchema>;
+/**
+ * WDK balance result
+ */
+interface WdkBalancesResult {
+    /** Per-chain balances */
+    chains: Array<{
+        chain: string;
+        usdt0: string;
+        usdc: string;
+        native: string;
+    }>;
+    /** Total USDT0 across all chains */
+    totalUsdt0: string;
+    /** Total USDC across all chains */
+    totalUsdc: string;
+}
+/**
+ * Execute wdk/getBalances tool
+ *
+ * @param input - Input with optional chains filter
+ * @param wdk - T402WDK instance
+ * @returns Multi-chain balances
+ */
+declare function executeWdkGetBalances(input: WdkGetBalancesInput, wdk: T402WDK): Promise<WdkBalancesResult>;
+/**
+ * Execute wdk/getBalances in demo mode
+ *
+ * @returns Demo balances
+ */
+declare function executeWdkGetBalancesDemo(): WdkBalancesResult;
+/**
+ * Format balances for display
+ *
+ * @param result - Balances result
+ * @returns Formatted string
+ */
+declare function formatWdkBalancesResult(result: WdkBalancesResult): string;
+
+/**
+ * wdk/transfer - Send tokens via WDK
+ */
+
+/**
+ * Input schema for wdk/transfer tool
+ */
+declare const wdkTransferInputSchema: z.ZodObject<{
+    to: z.ZodString;
+    amount: z.ZodString;
+    token: z.ZodEnum<["USDC", "USDT", "USDT0"]>;
+    chain: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    to: string;
+    amount: string;
+    chain: string;
+    token: "USDC" | "USDT" | "USDT0";
+}, {
+    to: string;
+    amount: string;
+    chain: string;
+    token: "USDC" | "USDT" | "USDT0";
+}>;
+type WdkTransferInput = z.infer<typeof wdkTransferInputSchema>;
+/**
+ * Transfer result
+ */
+interface WdkTransferResult {
+    /** Transaction hash */
+    txHash: string;
+    /** Amount transferred */
+    amount: string;
+    /** Token transferred */
+    token: string;
+    /** Chain used */
+    chain: string;
+    /** Recipient */
+    to: string;
+    /** Explorer URL */
+    explorerUrl: string;
+}
+/**
+ * Execute wdk/transfer tool
+ *
+ * @param input - Transfer parameters
+ * @param wdk - T402WDK instance
+ * @returns Transfer result
+ */
+declare function executeWdkTransfer(input: WdkTransferInput, wdk: T402WDK): Promise<WdkTransferResult>;
+/**
+ * Execute wdk/transfer in demo mode
+ *
+ * @param input - Transfer parameters
+ * @returns Demo transfer result
+ */
+declare function executeWdkTransferDemo(input: WdkTransferInput): WdkTransferResult;
+/**
+ * Format transfer result for display
+ *
+ * @param result - Transfer result
+ * @returns Formatted string
+ */
+declare function formatWdkTransferResult(result: WdkTransferResult): string;
+
+/**
+ * wdk/swap - Swap tokens via WDK
+ */
+
+/**
+ * Input schema for wdk/swap tool
+ */
+declare const wdkSwapInputSchema: z.ZodObject<{
+    fromToken: z.ZodString;
+    toToken: z.ZodString;
+    amount: z.ZodString;
+    chain: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    chain: string;
+    fromToken: string;
+    toToken: string;
+}, {
+    amount: string;
+    chain: string;
+    fromToken: string;
+    toToken: string;
+}>;
+type WdkSwapInput = z.infer<typeof wdkSwapInputSchema>;
+/**
+ * Swap result
+ */
+interface WdkSwapResult {
+    /** Input amount */
+    fromAmount: string;
+    /** Input token */
+    fromToken: string;
+    /** Output amount (estimated or actual) */
+    toAmount: string;
+    /** Output token */
+    toToken: string;
+    /** Chain */
+    chain: string;
+    /** Transaction hash (if executed) */
+    txHash?: string;
+}
+/**
+ * Execute wdk/swap tool
+ *
+ * @param input - Swap parameters
+ * @param wdk - T402WDK instance
+ * @returns Swap result
+ */
+declare function executeWdkSwap(input: WdkSwapInput, wdk: T402WDK): Promise<WdkSwapResult>;
+/**
+ * Execute wdk/swap in demo mode
+ *
+ * @param input - Swap parameters
+ * @returns Demo swap result
+ */
+declare function executeWdkSwapDemo(input: WdkSwapInput): WdkSwapResult;
+/**
+ * Format swap result for display
+ *
+ * @param result - Swap result
+ * @returns Formatted string
+ */
+declare function formatWdkSwapResult(result: WdkSwapResult): string;
+
+/**
+ * t402/autoPay - Smart payment orchestrator
+ *
+ * Fetches a URL, detects 402 payment requirements, checks WDK balances,
+ * signs payment, and returns the paid content.
+ */
+
+/**
+ * Input schema for t402/autoPay tool
+ */
+declare const autoPayInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    maxAmount: z.ZodOptional<z.ZodString>;
+    preferredChain: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    maxAmount?: string | undefined;
+    preferredChain?: string | undefined;
+}, {
+    url: string;
+    maxAmount?: string | undefined;
+    preferredChain?: string | undefined;
+}>;
+type AutoPayInput = z.infer<typeof autoPayInputSchema>;
+/**
+ * AutoPay result
+ */
+interface AutoPayResult {
+    /** Whether the resource was successfully accessed */
+    success: boolean;
+    /** HTTP status code */
+    statusCode: number;
+    /** Response body (truncated if large) */
+    body: string;
+    /** Content type of the response */
+    contentType?: string;
+    /** Payment details (if payment was made) */
+    payment?: {
+        network: string;
+        scheme: string;
+        amount: string;
+        payTo: string;
+    };
+    /** Error message (if failed) */
+    error?: string;
+}
+/**
+ * Execute t402/autoPay tool
+ *
+ * @param input - AutoPay parameters
+ * @param wdk - T402WDK instance
+ * @returns AutoPay result
+ */
+declare function executeAutoPay(input: AutoPayInput, wdk: T402WDK): Promise<AutoPayResult>;
+/**
+ * Execute t402/autoPay in demo mode
+ *
+ * @param input - AutoPay parameters
+ * @returns Demo autopay result
+ */
+declare function executeAutoPayDemo(input: AutoPayInput): AutoPayResult;
+/**
+ * Format autopay result for display
+ *
+ * @param result - AutoPay result
+ * @returns Formatted string
+ */
+declare function formatAutoPayResult(result: AutoPayResult): string;
+
+/**
+ * Unified MCP Toolkit - Combines WDK wallet tools with t402 payment tools.
+ *
+ * Agent workflow: check price -> check balance -> bridge if needed -> pay
+ * All in one MCP session with a single server.
+ */
+
+/**
+ * Configuration for unified MCP mode
+ */
+interface UnifiedMcpConfig {
+    /** WDK seed phrase for wallet management */
+    wdkSeedPhrase?: string;
+    /** Chain RPC configurations */
+    chains?: Record<string, string | string[]>;
+    /** Enable auto-pay mode (automatic balance check + bridge + pay) */
+    autoPayEnabled?: boolean;
+}
+/**
+ * SmartPay input schema
+ */
+declare const smartPayInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    maxBridgeFee: z.ZodOptional<z.ZodString>;
+    preferredNetwork: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    maxBridgeFee?: string | undefined;
+    preferredNetwork?: string | undefined;
+}, {
+    url: string;
+    maxBridgeFee?: string | undefined;
+    preferredNetwork?: string | undefined;
+}>;
+type SmartPayInput = z.infer<typeof smartPayInputSchema>;
+/**
+ * SmartPay result
+ */
+interface SmartPayResult {
+    /** Whether the resource was successfully accessed */
+    success: boolean;
+    /** HTTP status code */
+    statusCode: number;
+    /** Response body (truncated if large) */
+    body: string;
+    /** Content type of the response */
+    contentType?: string;
+    /** Steps taken during smart payment */
+    steps: SmartPayStep[];
+    /** Payment details (if payment was made) */
+    payment?: {
+        network: string;
+        scheme: string;
+        amount: string;
+        payTo: string;
+    };
+    /** Error message (if failed) */
+    error?: string;
+}
+/**
+ * A step in the smart payment flow
+ */
+interface SmartPayStep {
+    action: 'check_price' | 'check_balance' | 'bridge' | 'pay' | 'fetch';
+    status: 'success' | 'skipped' | 'failed';
+    detail: string;
+}
+/**
+ * PaymentPlan input schema
+ */
+declare const paymentPlanInputSchema: z.ZodObject<{
+    paymentRequired: z.ZodObject<{
+        scheme: z.ZodOptional<z.ZodString>;
+        network: z.ZodOptional<z.ZodString>;
+        maxAmountRequired: z.ZodOptional<z.ZodString>;
+        resource: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        payTo: z.ZodOptional<z.ZodString>;
+        maxDeadline: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        scheme: z.ZodOptional<z.ZodString>;
+        network: z.ZodOptional<z.ZodString>;
+        maxAmountRequired: z.ZodOptional<z.ZodString>;
+        resource: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        payTo: z.ZodOptional<z.ZodString>;
+        maxDeadline: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        scheme: z.ZodOptional<z.ZodString>;
+        network: z.ZodOptional<z.ZodString>;
+        maxAmountRequired: z.ZodOptional<z.ZodString>;
+        resource: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        payTo: z.ZodOptional<z.ZodString>;
+        maxDeadline: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>;
+}, "strip", z.ZodTypeAny, {
+    paymentRequired: {
+        network?: string | undefined;
+        description?: string | undefined;
+        scheme?: string | undefined;
+        payTo?: string | undefined;
+        maxAmountRequired?: string | undefined;
+        resource?: string | undefined;
+        maxDeadline?: number | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+}, {
+    paymentRequired: {
+        network?: string | undefined;
+        description?: string | undefined;
+        scheme?: string | undefined;
+        payTo?: string | undefined;
+        maxAmountRequired?: string | undefined;
+        resource?: string | undefined;
+        maxDeadline?: number | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+}>;
+type PaymentPlanInput = z.infer<typeof paymentPlanInputSchema>;
+/**
+ * Payment plan result
+ */
+interface PaymentPlanResult {
+    /** Whether a viable plan was found */
+    viable: boolean;
+    /** Recommended network to pay on */
+    recommendedNetwork?: string;
+    /** Available balance on that network */
+    availableBalance?: string;
+    /** Whether bridging is needed */
+    bridgeRequired: boolean;
+    /** Bridge details if needed */
+    bridgeDetails?: {
+        fromChain: string;
+        toChain: string;
+        amount: string;
+        estimatedFee: string;
+    };
+    /** Balances across all chains */
+    balances: Array<{
+        chain: string;
+        usdt0: string;
+        usdc: string;
+    }>;
+    /** Reason if not viable */
+    reason?: string;
+}
+/**
+ * Unified tool definitions (additional tools beyond base + WDK)
+ */
+declare const UNIFIED_TOOL_DEFINITIONS: {
+    readonly 't402/smartPay': {
+        readonly name: "t402/smartPay";
+        readonly description: "Intelligent payment that automatically checks balance, bridges if needed, and pays. Handles the entire payment flow for 402-protected resources.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly url: {
+                    readonly type: "string";
+                    readonly description: "URL of the 402-protected resource";
+                };
+                readonly maxBridgeFee: {
+                    readonly type: "string";
+                    readonly description: "Maximum acceptable bridge fee in native token (optional)";
+                };
+                readonly preferredNetwork: {
+                    readonly type: "string";
+                    readonly description: "Preferred network for payment (optional)";
+                };
+            };
+            readonly required: readonly ["url"];
+        };
+    };
+    readonly 't402/paymentPlan': {
+        readonly name: "t402/paymentPlan";
+        readonly description: "Analyze a 402 response and create an optimal payment plan considering balances across all chains. Returns recommended network, bridge requirements, and balance overview.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly paymentRequired: {
+                    readonly type: "object";
+                    readonly description: "The 402 PaymentRequired response";
+                };
+            };
+            readonly required: readonly ["paymentRequired"];
+        };
+    };
+};
+/**
+ * Execute t402/smartPay tool
+ */
+declare function executeSmartPay(input: SmartPayInput, wdk: T402WDK): Promise<SmartPayResult>;
+/**
+ * Execute t402/smartPay in demo mode
+ */
+declare function executeSmartPayDemo(input: SmartPayInput): SmartPayResult;
+/**
+ * Execute t402/paymentPlan tool
+ */
+declare function executePaymentPlan(input: PaymentPlanInput, wdk: T402WDK): Promise<PaymentPlanResult>;
+/**
+ * Execute t402/paymentPlan in demo mode
+ */
+declare function executePaymentPlanDemo(_input: PaymentPlanInput): PaymentPlanResult;
+/**
+ * Format smartPay result for display
+ */
+declare function formatSmartPayResult(result: SmartPayResult): string;
+/**
+ * Format paymentPlan result for display
+ */
+declare function formatPaymentPlanResult(result: PaymentPlanResult): string;
+
 /**
  * t402 MCP Tools - Export all payment tools
  */
 
 /**
- * Tool definitions for MCP server registration
+ * Base tool definitions (always available)
  */
 declare const TOOL_DEFINITIONS: {
     't402/getBalance': {
@@ -420,5 +928,114 @@ declare const TOOL_DEFINITIONS: {
         };
     };
 };
+/**
+ * WDK tool definitions (only available when WDK seed phrase is configured)
+ */
+declare const WDK_TOOL_DEFINITIONS: {
+    'wdk/getWallet': {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: string[];
+        };
+    };
+    'wdk/getBalances': {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                chains: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    'wdk/transfer': {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                to: {
+                    type: string;
+                    description: string;
+                };
+                amount: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+                token: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                chain: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    'wdk/swap': {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                fromToken: {
+                    type: string;
+                    description: string;
+                };
+                toToken: {
+                    type: string;
+                    description: string;
+                };
+                amount: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+                chain: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    't402/autoPay': {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                url: {
+                    type: string;
+                    description: string;
+                };
+                maxAmount: {
+                    type: string;
+                    pattern: string;
+                    description: string;
+                };
+                preferredChain: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+};
 
-export { type AllBalancesResult, type BridgeInput, type BridgeOptions, GASLESS_SUPPORTED_NETWORKS, type GetAllBalancesInput, type GetBalanceInput, type GetBridgeFeeInput, type PayGaslessInput, type PayGaslessOptions, type PayInput, type PayOptions, TOOL_DEFINITIONS, bridgeInputSchema, executeBridge, executeGetAllBalances, executeGetBalance, executeGetBridgeFee, executePay, executePayGasless, formatAllBalancesResult, formatBalanceResult, formatBridgeFeeResult, formatBridgeResult, formatGaslessPaymentResult, formatPaymentResult, getAllBalancesInputSchema, getBalanceInputSchema, getBridgeFeeInputSchema, payGaslessInputSchema, payInputSchema };
+export { type AllBalancesResult, type AutoPayInput, type AutoPayResult, type BridgeInput, type BridgeOptions, GASLESS_SUPPORTED_NETWORKS, type GetAllBalancesInput, type GetBalanceInput, type GetBridgeFeeInput, type PayGaslessInput, type PayGaslessOptions, type PayInput, type PayOptions, type PaymentPlanInput, type PaymentPlanResult, type SmartPayInput, type SmartPayResult, type SmartPayStep, TOOL_DEFINITIONS, UNIFIED_TOOL_DEFINITIONS, type UnifiedMcpConfig, WDK_TOOL_DEFINITIONS, type WdkBalancesResult, type WdkGetBalancesInput, type WdkGetWalletInput, type WdkSwapInput, type WdkSwapResult, type WdkTransferInput, type WdkTransferResult, type WdkWalletInfo, autoPayInputSchema, bridgeInputSchema, executeAutoPay, executeAutoPayDemo, executeBridge, executeGetAllBalances, executeGetBalance, executeGetBridgeFee, executePay, executePayGasless, executePaymentPlan, executePaymentPlanDemo, executeSmartPay, executeSmartPayDemo, executeWdkGetBalances, executeWdkGetBalancesDemo, executeWdkGetWallet, executeWdkGetWalletDemo, executeWdkSwap, executeWdkSwapDemo, executeWdkTransfer, executeWdkTransferDemo, formatAllBalancesResult, formatAutoPayResult, formatBalanceResult, formatBridgeFeeResult, formatBridgeResult, formatGaslessPaymentResult, formatPaymentPlanResult, formatPaymentResult, formatSmartPayResult, formatWdkBalancesResult, formatWdkSwapResult, formatWdkTransferResult, formatWdkWalletResult, getAllBalancesInputSchema, getBalanceInputSchema, getBridgeFeeInputSchema, payGaslessInputSchema, payInputSchema, paymentPlanInputSchema, smartPayInputSchema, wdkGetBalancesInputSchema, wdkGetWalletInputSchema, wdkSwapInputSchema, wdkTransferInputSchema };