@fiber-pay/agent 0.1.0-rc.1

package/dist/mcp-tools.js

@@ -0,0 +1,443 @@
+// src/mcp-tools.ts
+var MCP_TOOLS = {
+  fiber_pay: {
+    name: "fiber_pay",
+    description: `Pay an invoice or send CKB directly to a node on the Lightning Network.
+    
+Examples:
+- Pay an invoice: fiber_pay({ invoice: "fibt1..." })
+- Send directly: fiber_pay({ recipientNodeId: "QmXXX...", amountCkb: 10 })
+
+Returns payment status and tracking hash.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        invoice: {
+          type: "string",
+          description: "Lightning invoice string to pay (starts with fibt or fibb)"
+        },
+        recipientNodeId: {
+          type: "string",
+          description: "Recipient node ID for direct payment (keysend)"
+        },
+        amountCkb: {
+          type: "number",
+          description: "Amount to send in CKB (required for keysend)"
+        },
+        maxFeeCkb: {
+          type: "number",
+          description: "Maximum fee willing to pay in CKB"
+        }
+      },
+      oneOf: [{ required: ["invoice"] }, { required: ["recipientNodeId", "amountCkb"] }]
+    }
+  },
+  fiber_create_invoice: {
+    name: "fiber_create_invoice",
+    description: `Create an invoice to receive payment.
+    
+Example: fiber_create_invoice({ amountCkb: 10, description: "For coffee" })
+
+Returns invoice string to share with payer.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        amountCkb: {
+          type: "number",
+          description: "Amount to receive in CKB"
+        },
+        description: {
+          type: "string",
+          description: "Description for the payer"
+        },
+        expiryMinutes: {
+          type: "number",
+          description: "Invoice expiry time in minutes (default: 60)"
+        }
+      },
+      required: ["amountCkb"]
+    }
+  },
+  fiber_get_balance: {
+    name: "fiber_get_balance",
+    description: `Get current balance information including:
+- Total balance in CKB
+- Available to send
+- Available to receive
+- Number of channels
+- Remaining spending allowance
+
+No parameters required.`,
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  fiber_get_payment_status: {
+    name: "fiber_get_payment_status",
+    description: `Check the status of a payment by its hash.
+    
+Example: fiber_get_payment_status({ paymentHash: "0x..." })`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        paymentHash: {
+          type: "string",
+          description: "Payment hash to check"
+        }
+      },
+      required: ["paymentHash"]
+    }
+  },
+  fiber_get_invoice_status: {
+    name: "fiber_get_invoice_status",
+    description: `Check the status of an invoice (whether it's been paid).
+    
+Example: fiber_get_invoice_status({ paymentHash: "0x..." })`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        paymentHash: {
+          type: "string",
+          description: "Payment hash of the invoice"
+        }
+      },
+      required: ["paymentHash"]
+    }
+  },
+  fiber_list_channels: {
+    name: "fiber_list_channels",
+    description: `List all payment channels with their balances and states.
+
+No parameters required.`,
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  fiber_open_channel: {
+    name: "fiber_open_channel",
+    description: `Open a new payment channel with a peer.
+    
+Example: fiber_open_channel({ 
+  peer: "/ip4/x.x.x.x/tcp/8228/p2p/QmXXX...", 
+  fundingCkb: 100 
+})
+
+Note: This requires on-chain CKB for funding.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        peer: {
+          type: "string",
+          description: "Peer multiaddr or node ID"
+        },
+        fundingCkb: {
+          type: "number",
+          description: "Amount of CKB to fund the channel"
+        },
+        isPublic: {
+          type: "boolean",
+          description: "Whether to make the channel public (default: true)"
+        }
+      },
+      required: ["peer", "fundingCkb"]
+    }
+  },
+  fiber_close_channel: {
+    name: "fiber_close_channel",
+    description: `Close a payment channel and settle funds on-chain.
+    
+Example: fiber_close_channel({ channelId: "0x..." })
+
+Use force: true only if peer is unresponsive.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        channelId: {
+          type: "string",
+          description: "Channel ID to close"
+        },
+        force: {
+          type: "boolean",
+          description: "Force close (unilateral, use only if peer unresponsive)"
+        }
+      },
+      required: ["channelId"]
+    }
+  },
+  fiber_get_node_info: {
+    name: "fiber_get_node_info",
+    description: `Get information about this node including node ID, public key, and statistics.
+
+No parameters required.`,
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  fiber_get_spending_allowance: {
+    name: "fiber_get_spending_allowance",
+    description: `Get remaining spending allowance based on security policy.
+
+Returns:
+- Per-transaction limit in CKB
+- Remaining allowance for current time window
+
+No parameters required.`,
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  fiber_download_binary: {
+    name: "fiber_download_binary",
+    description: `Download and install the Fiber Network Node (fnn) binary for the current platform.
+
+This is required before using any Fiber payment features. The binary will be automatically 
+downloaded from GitHub releases and installed to the data directory.
+
+Examples:
+- Download latest: fiber_download_binary({})
+- Download specific version: fiber_download_binary({ version: "v0.4.0" })
+- Force re-download: fiber_download_binary({ force: true })
+
+Returns the path to the installed binary.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        version: {
+          type: "string",
+          description: 'Specific version to download (e.g., "v0.4.0"). Defaults to latest.'
+        },
+        force: {
+          type: "boolean",
+          description: "Force re-download even if binary already exists"
+        }
+      }
+    }
+  },
+  fiber_validate_invoice: {
+    name: "fiber_validate_invoice",
+    description: `Validate an invoice before payment. Checks format, cryptographic correctness, expiry, 
+amount, and peer connectivity. Returns recommendation to proceed, warn, or reject.
+
+Use this BEFORE paying an invoice to ensure safety.
+
+Example: fiber_validate_invoice({ invoice: "fibt1..." })
+
+Returns:
+- valid: boolean (overall validity)
+- details: parsed invoice details (amount, expiry, payment hash)
+- checks: individual validation results (format, expiry, amount, preimage, peer)
+- issues: list of warnings and critical issues found
+- recommendation: 'proceed' | 'warn' | 'reject'
+- reason: human-readable recommendation reason`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        invoice: {
+          type: "string",
+          description: "Invoice string to validate (starts with fibt or fibb)"
+        }
+      },
+      required: ["invoice"]
+    }
+  },
+  fiber_get_payment_proof: {
+    name: "fiber_get_payment_proof",
+    description: `Get cryptographic proof of payment execution. Useful for audit trail and reconciliation.
+
+Example: fiber_get_payment_proof({ paymentHash: "0x..." })
+
+Returns stored payment proof including:
+- Invoice original
+- Preimage (if available)
+- Fee breakdown
+- Verification status
+- Proof metadata`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        paymentHash: {
+          type: "string",
+          description: "Payment hash to retrieve proof for"
+        }
+      },
+      required: ["paymentHash"]
+    }
+  },
+  fiber_analyze_liquidity: {
+    name: "fiber_analyze_liquidity",
+    description: `Comprehensive liquidity analysis across all channels. Provides health metrics,
+identifies issues, and generates recommendations for rebalancing and funding.
+
+Use this to:
+- Understand current channel health
+- Identify liquidity gaps
+- Get rebalancing recommendations
+- Estimate available runway
+
+No parameters required.
+
+Returns:
+- balance: total, available to send/receive
+- channels: health metrics for each channel
+- liquidity: gaps and runway estimation
+- recommendations: rebalance suggestions and funding needs
+- summary: human-readable status`,
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  fiber_can_send: {
+    name: "fiber_can_send",
+    description: `Check if you have enough liquidity to send a specific amount. Returns shortfall 
+if insufficient and recommendations.
+
+Use this BEFORE attempting a payment to verify you have enough liquidity.
+
+Example: fiber_can_send({ amountCkb: 100 })
+
+Returns:
+- canSend: boolean
+- shortfallCkb: missing amount (0 if can send)
+- availableCkb: current available balance
+- recommendation: what to do if insufficient`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        amountCkb: {
+          type: "number",
+          description: "Amount in CKB to check"
+        }
+      },
+      required: ["amountCkb"]
+    }
+  },
+  fiber_create_hold_invoice: {
+    name: "fiber_create_hold_invoice",
+    description: `Create a hold invoice for escrow or conditional payments.
+    
+A hold invoice locks the payer's funds until you explicitly settle with the preimage,
+or the invoice expires. This enables escrow patterns without a trusted third party.
+
+Example: fiber_create_hold_invoice({ 
+  amountCkb: 10, 
+  paymentHash: "0x...", 
+  description: "Escrow for service delivery" 
+})
+
+Flow:
+1. Generate a secret preimage and compute its SHA-256 hash
+2. Create hold invoice with the hash
+3. Share invoice with payer \u2014 their funds are held when they pay
+4. When conditions are met, call fiber_settle_invoice with the preimage
+5. If conditions are NOT met, let the invoice expire (funds return to payer)
+
+Returns invoice string and payment hash.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        amountCkb: {
+          type: "number",
+          description: "Amount to receive in CKB"
+        },
+        paymentHash: {
+          type: "string",
+          description: "SHA-256 hash of your secret preimage (0x-prefixed hex)"
+        },
+        description: {
+          type: "string",
+          description: "Description for the payer"
+        },
+        expiryMinutes: {
+          type: "number",
+          description: "Invoice expiry time in minutes (default: 60)"
+        }
+      },
+      required: ["amountCkb", "paymentHash"]
+    }
+  },
+  fiber_settle_invoice: {
+    name: "fiber_settle_invoice",
+    description: `Settle a hold invoice by revealing the preimage.
+    
+This releases the held funds to you. Only call this after conditions are met.
+The preimage must hash (SHA-256) to the payment_hash used when creating the hold invoice.
+
+Example: fiber_settle_invoice({ 
+  paymentHash: "0x...", 
+  preimage: "0x..." 
+})`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        paymentHash: {
+          type: "string",
+          description: "Payment hash of the hold invoice"
+        },
+        preimage: {
+          type: "string",
+          description: "Secret preimage (0x-prefixed hex, 32 bytes)"
+        }
+      },
+      required: ["paymentHash", "preimage"]
+    }
+  },
+  fiber_wait_for_payment: {
+    name: "fiber_wait_for_payment",
+    description: `Wait for a payment to complete (reach Success or Failed status).
+    
+Polls the payment status until it reaches a terminal state. Useful after sending
+a payment to wait for confirmation.
+
+Example: fiber_wait_for_payment({ paymentHash: "0x...", timeoutMs: 60000 })
+
+Returns the final payment status.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        paymentHash: {
+          type: "string",
+          description: "Payment hash to wait for"
+        },
+        timeoutMs: {
+          type: "number",
+          description: "Timeout in milliseconds (default: 120000 = 2 min)"
+        }
+      },
+      required: ["paymentHash"]
+    }
+  },
+  fiber_wait_for_channel_ready: {
+    name: "fiber_wait_for_channel_ready",
+    description: `Wait for a channel to become ready after opening.
+    
+After opening a channel, it takes time for the funding transaction to be confirmed
+on-chain. This tool polls until the channel reaches ChannelReady state.
+
+Example: fiber_wait_for_channel_ready({ channelId: "0x...", timeoutMs: 300000 })
+
+Returns channel info once ready.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        channelId: {
+          type: "string",
+          description: "Channel ID to wait for"
+        },
+        timeoutMs: {
+          type: "number",
+          description: "Timeout in milliseconds (default: 300000 = 5 min)"
+        }
+      },
+      required: ["channelId"]
+    }
+  }
+};
+export {
+  MCP_TOOLS
+};
+//# sourceMappingURL=mcp-tools.js.map

package/dist/mcp-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp-tools.ts"],"sourcesContent":["/**\n * MCP (Model Context Protocol) Tool Definitions\n * These schemas are compatible with Claude, OpenClaw, and other MCP agents\n */\n\nimport type {\n  AgentResult,\n  BalanceInfo,\n  ChannelSummary,\n  HoldInvoiceResult,\n  InvoiceResult,\n  PaymentResult,\n} from './fiber-pay.js';\n\n// =============================================================================\n// MCP Tool Schema Definitions\n// =============================================================================\n\n/**\n * Tool definitions for MCP integration\n * Each tool has:\n * - name: unique identifier\n * - description: what the tool does (shown to the LLM)\n * - inputSchema: JSON Schema for parameters\n */\nexport const MCP_TOOLS = {\n  fiber_pay: {\n    name: 'fiber_pay',\n    description: `Pay an invoice or send CKB directly to a node on the Lightning Network.\n    \nExamples:\n- Pay an invoice: fiber_pay({ invoice: \"fibt1...\" })\n- Send directly: fiber_pay({ recipientNodeId: \"QmXXX...\", amountCkb: 10 })\n\nReturns payment status and tracking hash.`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        invoice: {\n          type: 'string',\n          description: 'Lightning invoice string to pay (starts with fibt or fibb)',\n        },\n        recipientNodeId: {\n          type: 'string',\n          description: 'Recipient node ID for direct payment (keysend)',\n        },\n        amountCkb: {\n          type: 'number',\n          description: 'Amount to send in CKB (required for keysend)',\n        },\n        maxFeeCkb: {\n          type: 'number',\n          description: 'Maximum fee willing to pay in CKB',\n        },\n      },\n      oneOf: [{ required: ['invoice'] }, { required: ['recipientNodeId', 'amountCkb'] }],\n    },\n  },\n\n  fiber_create_invoice: {\n    name: 'fiber_create_invoice',\n    description: `Create an invoice to receive payment.\n    \nExample: fiber_create_invoice({ amountCkb: 10, description: \"For coffee\" })\n\nReturns invoice string to share with payer.`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        amountCkb: {\n          type: 'number',\n          description: 'Amount to receive in CKB',\n        },\n        description: {\n          type: 'string',\n          description: 'Description for the payer',\n        },\n        expiryMinutes: {\n          type: 'number',\n          description: 'Invoice expiry time in minutes (default: 60)',\n        },\n      },\n      required: ['amountCkb'],\n    },\n  },\n\n  fiber_get_balance: {\n    name: 'fiber_get_balance',\n    description: `Get current balance information including:\n- Total balance in CKB\n- Available to send\n- Available to receive\n- Number of channels\n- Remaining spending allowance\n\nNo parameters required.`,\n    inputSchema: {\n      type: 'object',\n      properties: {},\n    },\n  },\n\n  fiber_get_payment_status: {\n    name: 'fiber_get_payment_status',\n    description: `Check the status of a payment by its hash.\n    \nExample: fiber_get_payment_status({ paymentHash: \"0x...\" })`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        paymentHash: {\n          type: 'string',\n          description: 'Payment hash to check',\n        },\n      },\n      required: ['paymentHash'],\n    },\n  },\n\n  fiber_get_invoice_status: {\n    name: 'fiber_get_invoice_status',\n    description: `Check the status of an invoice (whether it's been paid).\n    \nExample: fiber_get_invoice_status({ paymentHash: \"0x...\" })`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        paymentHash: {\n          type: 'string',\n          description: 'Payment hash of the invoice',\n        },\n      },\n      required: ['paymentHash'],\n    },\n  },\n\n  fiber_list_channels: {\n    name: 'fiber_list_channels',\n    description: `List all payment channels with their balances and states.\n\nNo parameters required.`,\n    inputSchema: {\n      type: 'object',\n      properties: {},\n    },\n  },\n\n  fiber_open_channel: {\n    name: 'fiber_open_channel',\n    description: `Open a new payment channel with a peer.\n    \nExample: fiber_open_channel({ \n  peer: \"/ip4/x.x.x.x/tcp/8228/p2p/QmXXX...\", \n  fundingCkb: 100 \n})\n\nNote: This requires on-chain CKB for funding.`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        peer: {\n          type: 'string',\n          description: 'Peer multiaddr or node ID',\n        },\n        fundingCkb: {\n          type: 'number',\n          description: 'Amount of CKB to fund the channel',\n        },\n        isPublic: {\n          type: 'boolean',\n          description: 'Whether to make the channel public (default: true)',\n        },\n      },\n      required: ['peer', 'fundingCkb'],\n    },\n  },\n\n  fiber_close_channel: {\n    name: 'fiber_close_channel',\n    description: `Close a payment channel and settle funds on-chain.\n    \nExample: fiber_close_channel({ channelId: \"0x...\" })\n\nUse force: true only if peer is unresponsive.`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        channelId: {\n          type: 'string',\n          description: 'Channel ID to close',\n        },\n        force: {\n          type: 'boolean',\n          description: 'Force close (unilateral, use only if peer unresponsive)',\n        },\n      },\n      required: ['channelId'],\n    },\n  },\n\n  fiber_get_node_info: {\n    name: 'fiber_get_node_info',\n    description: `Get information about this node including node ID, public key, and statistics.\n\nNo parameters required.`,\n    inputSchema: {\n      type: 'object',\n      properties: {},\n    },\n  },\n\n  fiber_get_spending_allowance: {\n    name: 'fiber_get_spending_allowance',\n    description: `Get remaining spending allowance based on security policy.\n\nReturns:\n- Per-transaction limit in CKB\n- Remaining allowance for current time window\n\nNo parameters required.`,\n    inputSchema: {\n      type: 'object',\n      properties: {},\n    },\n  },\n\n  fiber_download_binary: {\n    name: 'fiber_download_binary',\n    description: `Download and install the Fiber Network Node (fnn) binary for the current platform.\n\nThis is required before using any Fiber payment features. The binary will be automatically \ndownloaded from GitHub releases and installed to the data directory.\n\nExamples:\n- Download latest: fiber_download_binary({})\n- Download specific version: fiber_download_binary({ version: \"v0.4.0\" })\n- Force re-download: fiber_download_binary({ force: true })\n\nReturns the path to the installed binary.`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        version: {\n          type: 'string',\n          description: 'Specific version to download (e.g., \"v0.4.0\"). Defaults to latest.',\n        },\n        force: {\n          type: 'boolean',\n          description: 'Force re-download even if binary already exists',\n        },\n      },\n    },\n  },\n\n  fiber_validate_invoice: {\n    name: 'fiber_validate_invoice',\n    description: `Validate an invoice before payment. Checks format, cryptographic correctness, expiry, \namount, and peer connectivity. Returns recommendation to proceed, warn, or reject.\n\nUse this BEFORE paying an invoice to ensure safety.\n\nExample: fiber_validate_invoice({ invoice: \"fibt1...\" })\n\nReturns:\n- valid: boolean (overall validity)\n- details: parsed invoice details (amount, expiry, payment hash)\n- checks: individual validation results (format, expiry, amount, preimage, peer)\n- issues: list of warnings and critical issues found\n- recommendation: 'proceed' | 'warn' | 'reject'\n- reason: human-readable recommendation reason`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        invoice: {\n          type: 'string',\n          description: 'Invoice string to validate (starts with fibt or fibb)',\n        },\n      },\n      required: ['invoice'],\n    },\n  },\n\n  fiber_get_payment_proof: {\n    name: 'fiber_get_payment_proof',\n    description: `Get cryptographic proof of payment execution. Useful for audit trail and reconciliation.\n\nExample: fiber_get_payment_proof({ paymentHash: \"0x...\" })\n\nReturns stored payment proof including:\n- Invoice original\n- Preimage (if available)\n- Fee breakdown\n- Verification status\n- Proof metadata`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        paymentHash: {\n          type: 'string',\n          description: 'Payment hash to retrieve proof for',\n        },\n      },\n      required: ['paymentHash'],\n    },\n  },\n\n  fiber_analyze_liquidity: {\n    name: 'fiber_analyze_liquidity',\n    description: `Comprehensive liquidity analysis across all channels. Provides health metrics,\nidentifies issues, and generates recommendations for rebalancing and funding.\n\nUse this to:\n- Understand current channel health\n- Identify liquidity gaps\n- Get rebalancing recommendations\n- Estimate available runway\n\nNo parameters required.\n\nReturns:\n- balance: total, available to send/receive\n- channels: health metrics for each channel\n- liquidity: gaps and runway estimation\n- recommendations: rebalance suggestions and funding needs\n- summary: human-readable status`,\n    inputSchema: {\n      type: 'object',\n      properties: {},\n    },\n  },\n\n  fiber_can_send: {\n    name: 'fiber_can_send',\n    description: `Check if you have enough liquidity to send a specific amount. Returns shortfall \nif insufficient and recommendations.\n\nUse this BEFORE attempting a payment to verify you have enough liquidity.\n\nExample: fiber_can_send({ amountCkb: 100 })\n\nReturns:\n- canSend: boolean\n- shortfallCkb: missing amount (0 if can send)\n- availableCkb: current available balance\n- recommendation: what to do if insufficient`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        amountCkb: {\n          type: 'number',\n          description: 'Amount in CKB to check',\n        },\n      },\n      required: ['amountCkb'],\n    },\n  },\n\n  fiber_create_hold_invoice: {\n    name: 'fiber_create_hold_invoice',\n    description: `Create a hold invoice for escrow or conditional payments.\n    \nA hold invoice locks the payer's funds until you explicitly settle with the preimage,\nor the invoice expires. This enables escrow patterns without a trusted third party.\n\nExample: fiber_create_hold_invoice({ \n  amountCkb: 10, \n  paymentHash: \"0x...\", \n  description: \"Escrow for service delivery\" \n})\n\nFlow:\n1. Generate a secret preimage and compute its SHA-256 hash\n2. Create hold invoice with the hash\n3. Share invoice with payer — their funds are held when they pay\n4. When conditions are met, call fiber_settle_invoice with the preimage\n5. If conditions are NOT met, let the invoice expire (funds return to payer)\n\nReturns invoice string and payment hash.`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        amountCkb: {\n          type: 'number',\n          description: 'Amount to receive in CKB',\n        },\n        paymentHash: {\n          type: 'string',\n          description: 'SHA-256 hash of your secret preimage (0x-prefixed hex)',\n        },\n        description: {\n          type: 'string',\n          description: 'Description for the payer',\n        },\n        expiryMinutes: {\n          type: 'number',\n          description: 'Invoice expiry time in minutes (default: 60)',\n        },\n      },\n      required: ['amountCkb', 'paymentHash'],\n    },\n  },\n\n  fiber_settle_invoice: {\n    name: 'fiber_settle_invoice',\n    description: `Settle a hold invoice by revealing the preimage.\n    \nThis releases the held funds to you. Only call this after conditions are met.\nThe preimage must hash (SHA-256) to the payment_hash used when creating the hold invoice.\n\nExample: fiber_settle_invoice({ \n  paymentHash: \"0x...\", \n  preimage: \"0x...\" \n})`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        paymentHash: {\n          type: 'string',\n          description: 'Payment hash of the hold invoice',\n        },\n        preimage: {\n          type: 'string',\n          description: 'Secret preimage (0x-prefixed hex, 32 bytes)',\n        },\n      },\n      required: ['paymentHash', 'preimage'],\n    },\n  },\n\n  fiber_wait_for_payment: {\n    name: 'fiber_wait_for_payment',\n    description: `Wait for a payment to complete (reach Success or Failed status).\n    \nPolls the payment status until it reaches a terminal state. Useful after sending\na payment to wait for confirmation.\n\nExample: fiber_wait_for_payment({ paymentHash: \"0x...\", timeoutMs: 60000 })\n\nReturns the final payment status.`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        paymentHash: {\n          type: 'string',\n          description: 'Payment hash to wait for',\n        },\n        timeoutMs: {\n          type: 'number',\n          description: 'Timeout in milliseconds (default: 120000 = 2 min)',\n        },\n      },\n      required: ['paymentHash'],\n    },\n  },\n\n  fiber_wait_for_channel_ready: {\n    name: 'fiber_wait_for_channel_ready',\n    description: `Wait for a channel to become ready after opening.\n    \nAfter opening a channel, it takes time for the funding transaction to be confirmed\non-chain. This tool polls until the channel reaches ChannelReady state.\n\nExample: fiber_wait_for_channel_ready({ channelId: \"0x...\", timeoutMs: 300000 })\n\nReturns channel info once ready.`,\n    inputSchema: {\n      type: 'object',\n      properties: {\n        channelId: {\n          type: 'string',\n          description: 'Channel ID to wait for',\n        },\n        timeoutMs: {\n          type: 'number',\n          description: 'Timeout in milliseconds (default: 300000 = 5 min)',\n        },\n      },\n      required: ['channelId'],\n    },\n  },\n} as const;\n\n// =============================================================================\n// Type Helpers\n// =============================================================================\n\nexport type McpToolName = keyof typeof MCP_TOOLS;\ntype EmptyInput = Record<string, never>;\n\nexport type McpToolInput<T extends McpToolName> = T extends 'fiber_pay'\n  ? {\n      invoice?: string;\n      recipientNodeId?: string;\n      amountCkb?: number;\n      maxFeeCkb?: number;\n      customRecords?: Record<string, string>;\n      maxParts?: number;\n    }\n  : T extends 'fiber_create_invoice'\n    ? { amountCkb: number; description?: string; expiryMinutes?: number }\n    : T extends 'fiber_get_balance'\n      ? EmptyInput\n      : T extends 'fiber_get_payment_status'\n        ? { paymentHash: string }\n        : T extends 'fiber_get_invoice_status'\n          ? { paymentHash: string }\n          : T extends 'fiber_list_channels'\n            ? EmptyInput\n            : T extends 'fiber_open_channel'\n              ? { peer: string; fundingCkb: number; isPublic?: boolean }\n              : T extends 'fiber_close_channel'\n                ? { channelId: string; force?: boolean }\n                : T extends 'fiber_get_node_info'\n                  ? EmptyInput\n                  : T extends 'fiber_get_spending_allowance'\n                    ? EmptyInput\n                    : T extends 'fiber_download_binary'\n                      ? { version?: string; force?: boolean }\n                      : T extends 'fiber_validate_invoice'\n                        ? { invoice: string }\n                        : T extends 'fiber_get_payment_proof'\n                          ? { paymentHash: string }\n                          : T extends 'fiber_analyze_liquidity'\n                            ? EmptyInput\n                            : T extends 'fiber_can_send'\n                              ? { amountCkb: number }\n                              : T extends 'fiber_create_hold_invoice'\n                                ? {\n                                    amountCkb: number;\n                                    paymentHash: string;\n                                    description?: string;\n                                    expiryMinutes?: number;\n                                  }\n                                : T extends 'fiber_settle_invoice'\n                                  ? { paymentHash: string; preimage: string }\n                                  : T extends 'fiber_wait_for_payment'\n                                    ? { paymentHash: string; timeoutMs?: number }\n                                    : T extends 'fiber_wait_for_channel_ready'\n                                      ? { channelId: string; timeoutMs?: number }\n                                      : never;\n\nexport type McpToolResult<T extends McpToolName> = T extends 'fiber_pay'\n  ? AgentResult<PaymentResult>\n  : T extends 'fiber_create_invoice'\n    ? AgentResult<InvoiceResult>\n    : T extends 'fiber_get_balance'\n      ? AgentResult<BalanceInfo>\n      : T extends 'fiber_get_payment_status'\n        ? AgentResult<PaymentResult>\n        : T extends 'fiber_get_invoice_status'\n          ? AgentResult<InvoiceResult>\n          : T extends 'fiber_list_channels'\n            ? AgentResult<ChannelSummary[]>\n            : T extends 'fiber_open_channel'\n              ? AgentResult<{ channelId: string }>\n              : T extends 'fiber_close_channel'\n                ? AgentResult<void>\n                : T extends 'fiber_get_node_info'\n                  ? AgentResult<{\n                      nodeId: string;\n                      publicKey: string;\n                      version: string;\n                      channelCount: number;\n                      peersCount: number;\n                    }>\n                  : T extends 'fiber_get_spending_allowance'\n                    ? { perTransactionCkb: number; perWindowCkb: number }\n                    : T extends 'fiber_download_binary'\n                      ? AgentResult<{\n                          path: string;\n                          version: string;\n                          platform: string;\n                          arch: string;\n                        }>\n                      : T extends 'fiber_validate_invoice'\n                        ? AgentResult<import('./fiber-pay.js').InvoiceValidationResult>\n                        : T extends 'fiber_get_payment_proof'\n                          ? AgentResult<{\n                              proof: import('./fiber-pay.js').PaymentProof | null;\n                              verified: boolean;\n                              status: string;\n                            }>\n                          : T extends 'fiber_analyze_liquidity'\n                            ? AgentResult<import('./fiber-pay.js').LiquidityAnalysisResult>\n                            : T extends 'fiber_can_send'\n                              ? AgentResult<{\n                                  canSend: boolean;\n                                  shortfallCkb: number;\n                                  availableCkb: number;\n                                  recommendation: string;\n                                }>\n                              : T extends 'fiber_create_hold_invoice'\n                                ? AgentResult<HoldInvoiceResult>\n                                : T extends 'fiber_settle_invoice'\n                                  ? AgentResult<void>\n                                  : T extends 'fiber_wait_for_payment'\n                                    ? AgentResult<PaymentResult>\n                                    : T extends 'fiber_wait_for_channel_ready'\n                                      ? AgentResult<ChannelSummary>\n                                      : never;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@fiber-pay/agent",
+  "version": "0.1.0-rc.1",
+  "description": "AI agent orchestration layer for Fiber Network with MCP tools",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./mcp": {
+      "import": "./dist/mcp-tools.js",
+      "types": "./dist/mcp-tools.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "ckb",
+    "lightning",
+    "fiber",
+    "ai-agent",
+    "mcp",
+    "nervos"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@fiber-pay/sdk": "0.1.0-rc.1",
+    "@fiber-pay/runtime": "0.1.0-rc.1",
+    "@fiber-pay/node": "0.1.0-rc.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}