@t402/mcp 2.5.0 → 2.6.0

package/dist/cjs/{types-CwwW_c2B.d.ts → ton-bridge-BN3RKhNy.d.ts}

@@ -135,6 +135,12 @@ interface McpServerConfig {
     seedPhrase?: string;
     /** WDK chains to support (e.g., ['ethereum', 'arbitrum']) */
     wdkChains?: string[];
+    /** Enable unified mode (base + WDK + unified tools) */
+    unifiedMode?: boolean;
+    /** @ton/mcp server URL for TON bridge tools */
+    tonMcpEndpoint?: string;
+    /** TON API key for direct TON bridge tool execution */
+    tonApiKey?: string;
 }
 /**
  * Tool execution context
@@ -148,4 +154,86 @@ interface ToolContext {
     getPublicClient: (network: SupportedNetwork) => Promise<unknown>;
 }
 
-export type { BridgeFeeQuote as B, ChainBalance as C, GaslessPaymentResult as G, McpServerConfig as M, PaymentParams as P, SupportedNetwork as S, TokenBalance as T, BridgeResult as a, PaymentResult as b, ToolContext as c };
+/**
+ * TON MCP Bridge - Connects @ton/mcp tools with @t402/mcp
+ *
+ * Enables AI agents to perform end-to-end TON payment flows by
+ * proxying @ton/mcp's 15 blockchain tools through the t402 MCP server.
+ */
+/**
+ * Configuration for the TON MCP bridge
+ */
+interface TonMcpBridgeConfig {
+    /** @ton/mcp server URL or SSE endpoint */
+    tonMcpEndpoint?: string;
+    /** TON API key for direct calls (e.g., toncenter.com API key) */
+    tonApiKey?: string;
+    /** Enable demo mode (simulates calls without executing) */
+    demoMode?: boolean;
+}
+/**
+ * Tool input/output schema type
+ */
+interface ToolSchema {
+    type: 'object';
+    properties: Record<string, {
+        type: string;
+        description: string;
+        enum?: string[];
+    }>;
+    required: string[];
+}
+/**
+ * TON bridge tool definition
+ */
+interface TonBridgeTool {
+    name: string;
+    description: string;
+    inputSchema: ToolSchema;
+}
+/**
+ * Proxy tool definitions from @ton/mcp
+ *
+ * These map to the tools available in the @ton/mcp server.
+ * When registered, they proxy requests to the @ton/mcp endpoint.
+ */
+declare const TON_BRIDGE_TOOLS: Record<string, TonBridgeTool>;
+/**
+ * Execute a TON bridge tool call
+ *
+ * Proxies the tool call to the @ton/mcp endpoint or executes it
+ * directly using the TON API key.
+ *
+ * @param toolName - Name of the tool to execute
+ * @param args - Tool arguments
+ * @param config - Bridge configuration
+ * @returns Tool execution result
+ */
+declare function executeTonBridgeTool(toolName: string, args: Record<string, unknown>, config: TonMcpBridgeConfig): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+/**
+ * Register TON bridge tools on a t402 MCP server
+ *
+ * This function adds the TON bridge tools to the server's tool registry,
+ * enabling AI agents to use TON blockchain operations alongside t402 payment tools.
+ *
+ * @param config - Bridge configuration
+ * @returns Tool definitions and handler
+ */
+declare function createTonBridgeToolSet(config: TonMcpBridgeConfig): {
+    definitions: Record<string, TonBridgeTool>;
+    handleToolCall(name: string, args: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+};
+
+export { type BridgeFeeQuote as B, type ChainBalance as C, type GaslessPaymentResult as G, type McpServerConfig as M, type PaymentParams as P, type SupportedNetwork as S, type TokenBalance as T, type BridgeResult as a, type PaymentResult as b, type ToolContext as c, TON_BRIDGE_TOOLS as d, type TonMcpBridgeConfig as e, createTonBridgeToolSet as f, executeTonBridgeTool as g };

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

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { S as SupportedNetwork, C as ChainBalance, b as PaymentResult, G as GaslessPaymentResult, B as BridgeFeeQuote, a as BridgeResult } from '../types-CwwW_c2B.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';
 
@@ -535,6 +536,222 @@ declare function executeAutoPayDemo(input: AutoPayInput): AutoPayResult;
  */
 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
  */
@@ -821,4 +1038,4 @@ declare const WDK_TOOL_DEFINITIONS: {
     };
 };
 
-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, TOOL_DEFINITIONS, 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, executeWdkGetBalances, executeWdkGetBalancesDemo, executeWdkGetWallet, executeWdkGetWalletDemo, executeWdkSwap, executeWdkSwapDemo, executeWdkTransfer, executeWdkTransferDemo, formatAllBalancesResult, formatAutoPayResult, formatBalanceResult, formatBridgeFeeResult, formatBridgeResult, formatGaslessPaymentResult, formatPaymentResult, formatWdkBalancesResult, formatWdkSwapResult, formatWdkTransferResult, formatWdkWalletResult, getAllBalancesInputSchema, getBalanceInputSchema, getBridgeFeeInputSchema, payGaslessInputSchema, payInputSchema, wdkGetBalancesInputSchema, wdkGetWalletInputSchema, wdkSwapInputSchema, wdkTransferInputSchema };
+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 };