@paytaca/opencode-plugin 0.1.16 → 0.2.1

package/README.md

@@ -34,6 +34,73 @@ Once installed and configured in your OpenCode settings, the plugin automaticall
 - Creates a wallet on first run (recovery phrase is printed — save it securely)
 - Starts a local proxy that manages x402 payment flows transparently
 - Provides the `paytaca-ai` provider with the `deepseek/deepseek-v4-flash` model
+- Registers a local MCP server (`paytaca`) whose tools let the assistant work with real Paytaca data — AI account (credits, models, plan pricing) and wallet (balance, transactions, addresses, tokens, sending)
+
+### Asking about your account and wallet
+
+Because the MCP server is loaded automatically, you can ask in plain language:
+
+- "How many credits do I have left?"
+- "What models are available?"
+- "How much does DeepSeek V4 Pro cost?"
+- "What's my wallet balance?"
+- "Show my latest transactions"
+- "What's my receiving address?"
+
+The assistant answers using live data via these tools:
+
+| Tool | Description |
+|---|---|
+| `get_credits` | Remaining time credits per active model session |
+| `get_balance` | BCH balance of the Paytaca wallet |
+| `get_models` | Available models (id, display name, tier) |
+| `get_plans` | Plan pricing grouped by tier (minutes, USD, BCH) |
+| `buy_plan` | Buy time credits for any model + plan duration (spends BCH) |
+| `get_transactions` | Recent wallet transactions (filter by direction, page) |
+| `get_receiving_address` | Receiving address, optionally as a BIP21 URI with amount |
+| `get_tokens` | CashToken holdings, or details for one token category |
+
+### Buying a plan
+
+You can ask the assistant to buy a plan for any model — even one not active in
+the current session ("buy the 30-minute DeepSeek V4 Flash plan"). The assistant
+shows pricing with `get_plans`, then purchases via `buy_plan`, which runs the
+same x402 payment flow as the interactive proxy prompt. Because this spends
+real funds, opencode always asks for approval before the tool runs (the plugin
+sets the `paytaca_buy_plan` permission to `ask`).
+
+### Sending funds
+
+You can ask the assistant to send BCH or CashTokens ("send 0.01 BCH to
+bitcoincash:qp..."). Because that spends real funds, opencode will always
+prompt you for approval before the `send` tool executes — the plugin sets the
+`paytaca_send` permission to `ask` (an explicit choice in your own config is
+respected). Token amounts are in base units and recipients should use
+token-aware (z-prefix) addresses.
+
+### Proxy chatter never reaches the model
+
+Payment prompts, tier-selection menus, credits output, and payment notices
+produced by the proxy stay visible in your session for you — but they are
+stripped from the context sent to the LLM, so coding conversations are not
+polluted by payment flow messages. Your replies in those flows (e.g. picking
+a plan tier) are also excluded, while all genuine coding messages pass
+through untouched.
+
+### Automatic updates
+
+The plugin keeps itself installable and up to date without manual cleanup:
+
+- At startup it checks npm for a newer published version (5s timeout, fully
+  offline-safe). If one exists, it clears everything that would keep opencode
+  resolving the old one — semver-pinned dependency specs, stale lockfiles, and
+  stale plugin cache entries — so the next session or install picks it up.
+- Every install re-pins the dependency spec to the exact installed version
+  (avoids the `^0.x` semver trap that hides new releases) and removes
+  other-version cache entries.
+
+Set `PAYTACA_SELF_UPDATE=0` to disable the startup check. Activity is logged
+to `~/.opencode-paytaca/selfheal.log`.
 
 ### Wallet management
 

package/dist/bundled/mcp.d.ts

@@ -0,0 +1,2 @@
+export declare const MCP_SERVER_CONTENT = "#!/usr/bin/env node\n/**\n * Paytaca MCP Server\n *\n * Registers Paytaca tools with opencode so the assistant can work with real\n * data instead of guessing. Two groups:\n * - Paytaca AI account (backend): credits, models, plan pricing\n * - Paytaca wallet (paytaca CLI): balance, transactions, receiving address,\n *   token holdings, and sending funds\n *\n * The send tool moves real funds \u2014 opencode is configured (via the plugin's\n * config hook) to require explicit user approval before it runs.\n *\n * Loaded automatically via the plugin's config hook (cfg.mcp['paytaca']).\n * Uses only Node.js built-in modules.\n */\n\nconst http = require('http');\nconst https = require('https');\nconst { spawn } = require('child_process');\nconst fs = require('fs');\nconst path = require('path');\nconst os = require('os');\n\nconst CONFIG_DIR = process.env.PAYTACA_CONFIG_DIR || path.join(os.homedir(), '.opencode-paytaca');\nconst PAYTACA_CMD = process.env.PAYTACA_CMD || 'paytaca';\nconst DEFAULT_BACKEND = process.env.PAYTACA_BACKEND_URL || 'https://api.paytaca.ai';\n\nconst PROTOCOL_VERSION = '2025-06-18';\n\n// Logging setup\nconst LOG_FILE = path.join(CONFIG_DIR, 'mcp.log');\nconst logStream = fs.createWriteStream(LOG_FILE, { flags: 'a' });\nfunction log(message) {\n  const timestamp = new Date().toISOString();\n  logStream.write(timestamp + ' [MCP] ' + message + '\\n');\n}\n\n// Load fresh config on every call so walletHash/backendUrl never go stale\nfunction loadConfig() {\n  try {\n    return JSON.parse(fs.readFileSync(path.join(CONFIG_DIR, 'config.json'), 'utf8'));\n  } catch (e) {\n    return {};\n  }\n}\n\nlet BACKEND_URL = DEFAULT_BACKEND;\nlet WALLET_HASH = '';\nfunction refreshConfig() {\n  const cfg = loadConfig();\n  BACKEND_URL = process.env.PAYTACA_BACKEND_URL || cfg.backendUrl || DEFAULT_BACKEND;\n  WALLET_HASH = cfg.walletHash || '';\n}\n\n// Fetch a JSON payload over HTTP(S)\nfunction getJson(url, headers) {\n  return new Promise((resolve, reject) => {\n    let u;\n    try {\n      u = new URL(url);\n    } catch (e) {\n      return reject(new Error('Invalid URL: ' + url));\n    }\n    const requester = u.protocol === 'https:' ? https : http;\n    const req = requester.get({\n      hostname: u.hostname,\n      port: u.port || (u.protocol === 'https:' ? 443 : 80),\n      path: u.pathname + u.search,\n      headers: headers || {},\n    }, (res) => {\n      let data = '';\n      res.on('data', (chunk) => { data += chunk; });\n      res.on('end', () => {\n        if (res.statusCode >= 400) {\n          reject(new Error('HTTP ' + res.statusCode + ': ' + data.substring(0, 200)));\n          return;\n        }\n        try {\n          resolve(JSON.parse(data));\n        } catch (e) {\n          reject(new Error('Invalid JSON response'));\n        }\n      });\n    });\n    req.on('error', reject);\n    req.setTimeout(15000, () => {\n      req.destroy();\n      reject(new Error('Request timed out'));\n    });\n  });\n}\n\n// Run a shell command with a timeout\nfunction runCommand(cmd, args, timeoutMs) {\n  return new Promise((resolve, reject) => {\n    const child = spawn(cmd, args, { shell: false });\n    let stdout = '';\n    let stderr = '';\n    let settled = false;\n    const timer = setTimeout(() => {\n      if (settled) return;\n      settled = true;\n      try { child.kill(); } catch (e) {}\n      reject(new Error('Command timed out'));\n    }, timeoutMs || 15000);\n    child.stdout.on('data', (d) => { stdout += d.toString(); });\n    child.stderr.on('data', (d) => { stderr += d.toString(); });\n    child.on('close', (code) => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      if (code === 0) resolve(stdout.trim());\n      else reject(new Error(stderr.trim() || 'Command exited with code ' + code));\n    });\n    child.on('error', (err) => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      reject(err);\n    });\n  });\n}\n\n// Format seconds as MM:SS or HH:MM:SS\nfunction formatDuration(totalSeconds) {\n  const hours = Math.floor(totalSeconds / 3600);\n  const minutes = Math.floor((totalSeconds % 3600) / 60);\n  const secs = totalSeconds % 60;\n  if (hours > 0) {\n    return hours + ':' + String(minutes).padStart(2, '0') + ':' + String(secs).padStart(2, '0');\n  }\n  return minutes + ':' + String(secs).padStart(2, '0');\n}\n\n// Remaining time credits per model session\nasync function getCredits() {\n  const data = await getJson(BACKEND_URL + '/v1/wallet/status', { 'X-Wallet-Hash': WALLET_HASH });\n  const sessions = Array.isArray(data.sessions) ? data.sessions : [];\n  const active = sessions.filter((s) => s.time_remaining_seconds > 0 && s.model_active);\n  const inactive = sessions.filter((s) => s.time_remaining_seconds > 0 && !s.model_active);\n  const parts = [];\n  if (active.length > 0) {\n    parts.push('Active time credits:');\n    for (const s of active) {\n      const total = formatDuration(s.time_credits_seconds);\n      const remaining = formatDuration(s.time_remaining_seconds);\n      const used = formatDuration(s.time_used_seconds);\n      parts.push('- ' + (s.display_name || s.ai_model) + ': ' + remaining + ' remaining of ' + total + ' (' + used + ' used)');\n    }\n  }\n  if (inactive.length > 0) {\n    parts.push('');\n    parts.push('Inactive models (credits but session not active):');\n    for (const s of inactive) {\n      parts.push('- ' + (s.display_name || s.ai_model) + ': ' + formatDuration(s.time_remaining_seconds) + ' remaining');\n    }\n  }\n  if (parts.length === 0) {\n    return 'No active time credits.';\n  }\n  return parts.join('\\n');\n}\n\n// Wallet BCH balance via the paytaca CLI\nasync function getBalance() {\n  const out = await runCommand(PAYTACA_CMD, ['wallet', 'info']);\n  const match = out.match(/Balance:\\s*([\\d.]+)\\s*BCH/i);\n  if (match) {\n    return 'Wallet balance: ' + match[1] + ' BCH.';\n  }\n  return 'Could not parse balance. Raw output:\\n' + out.split('\\n').slice(0, 5).join('\\n');\n}\n\n// List all available models\nasync function getModels() {\n  const data = await getJson(BACKEND_URL + '/v1/config', {});\n  const models = Array.isArray(data.models) ? data.models : [];\n  const lines = ['Available models:'];\n  for (const m of models) {\n    let line = m.id || 'unknown';\n    if (m.display_name && m.display_name !== m.id) line += ' (' + m.display_name + ')';\n    if (m.tier) line += ' [' + m.tier + ']';\n    lines.push('- ' + line);\n  }\n  return lines.join('\\n');\n}\n\n// Plan pricing grouped by tier, optionally filtered to one model\nasync function getPlans(filterModel) {\n  const data = await getJson(BACKEND_URL + '/v1/config', {});\n  let models = Array.isArray(data.models) ? data.models : [];\n  if (filterModel) {\n    const f = String(filterModel).toLowerCase();\n    models = models.filter((m) => {\n      const id = String(m.id || '').toLowerCase();\n      const name = String(m.display_name || '').toLowerCase();\n      return id.indexOf(f) !== -1 || name.indexOf(f) !== -1;\n    });\n  }\n  const groups = { budget: [], premium: [], frontier: [], other: [] };\n  for (const m of models) {\n    const key = String(m.tier || '').toLowerCase();\n    const groupKey = (key === 'budget' || key === 'premium' || key === 'frontier') ? key : 'other';\n    groups[groupKey].push(m);\n  }\n  const lines = ['Paytaca AI \u2014 Model Pricing'];\n  const order = [\n    { key: 'budget', label: 'Budget' },\n    { key: 'premium', label: 'Premium' },\n    { key: 'frontier', label: 'Frontier' },\n    { key: 'other', label: 'Other' },\n  ];\n  let any = false;\n  for (const g of order) {\n    const group = groups[g.key];\n    if (group.length === 0) continue;\n    any = true;\n    lines.push('');\n    lines.push(g.label);\n    for (const m of group) {\n      lines.push('');\n      const tiers = Array.isArray(m.price_tiers) ? m.price_tiers : [];\n      if (tiers.length === 0) {\n        lines.push('- ' + (m.display_name || m.id) + ': no pricing configured');\n        continue;\n      }\n      const sorted = tiers.slice().sort((a, b) => (a.minutes || 0) - (b.minutes || 0));\n      lines.push((m.display_name || m.id) + ':');\n      for (const t of sorted) {\n        const sats = typeof t.price_sats === 'number' ? t.price_sats : 0;\n        const bch = (sats / 100000000).toFixed(8);\n        const usd = typeof t.price_usd === 'number' ? t.price_usd.toFixed(4) : '?.??';\n        lines.push('  ' + (t.minutes || 0) + ' minutes \u2014 USD ' + usd + ' (' + bch + ' BCH)');\n      }\n    }\n  }\n  if (!any) {\n    lines.push('No models available.');\n  }\n  return lines.join('\\n');\n}\n\n// Resolve a model (by id or display name) and its price tier by minutes.\n// Uses the same /v1/config data as get_plans.\nasync function resolvePlan(modelFilter, minutes) {\n  const data = await getJson(BACKEND_URL + '/v1/config', {});\n  const models = Array.isArray(data.models) ? data.models : [];\n  const f = String(modelFilter || '').toLowerCase();\n  const matches = models.filter((m) => {\n    const id = String(m.id || '').toLowerCase();\n    const name = String(m.display_name || '').toLowerCase();\n    return id.indexOf(f) !== -1 || name.indexOf(f) !== -1;\n  });\n  if (matches.length === 0) {\n    const ids = models.map((m) => m.id).join(', ');\n    throw new Error('Model not found: ' + modelFilter + '. Available models: ' + ids);\n  }\n  const model = matches[0];\n  const tiers = Array.isArray(model.price_tiers) ? model.price_tiers : [];\n  const want = Number(minutes);\n  const tier = tiers.find((t) => Number(t.minutes) === want);\n  if (!tier) {\n    const avail = tiers.map((t) => t.minutes).join(', ');\n    throw new Error('No ' + minutes + '-minute plan for ' + (model.display_name || model.id) + '. Available minutes: ' + avail);\n  }\n  return { model, tier };\n}\n\n// Wallet balance in sats (mirrors the proxy's pre-payment check)\nasync function getBalanceSats() {\n  const out = await runCommand(PAYTACA_CMD, ['wallet', 'info'], 20000);\n  const match = out.match(/Balance:\\s*([\\d.]+)\\s*BCH/i);\n  if (!match) return null;\n  return Math.floor(parseFloat(match[1]) * 100000000);\n}\n\n// Purchase time credits for a specific model and plan duration. Reuses the\n// same payment wrapper the proxy runs on a 402 (x402 payment + retry with the\n// PAYMENT-SIGNATURE header), but works for ANY model/tier the user picks \u2014\n// not just the model active in the current session. Spends real BCH.\nasync function buyPlan(args) {\n  const modelFilter = String(args.model || '').trim();\n  const minutes = Number(args.minutes);\n  if (!modelFilter) {\n    throw new Error('Missing model. Pass the model id or display name (e.g. deepseek/deepseek-v4-flash).');\n  }\n  if (isNaN(minutes) || minutes <= 0) {\n    throw new Error('Missing or invalid minutes. Pass the plan duration, e.g. 30 for the 30-minute plan.');\n  }\n\n  const { model, tier } = await resolvePlan(modelFilter, minutes);\n  const priceSats = Number(tier.price_sats) || 0;\n\n  // Fail fast on insufficient balance instead of sending a txn that cannot\n  // fund the plan (mirrors the proxy's 402 flow).\n  const balanceSats = await getBalanceSats();\n  if (balanceSats !== null && balanceSats < priceSats) {\n    const addr = await getReceivingAddress({});\n    const shortfall = (priceSats - balanceSats) / 100000000;\n    throw new Error('Insufficient balance: ' + (balanceSats / 100000000).toFixed(8) + ' BCH available but the ' + minutes + '-minute plan costs ' + (priceSats / 100000000).toFixed(8) + ' BCH. Top up at least ' + shortfall.toFixed(8) + ' BCH to: ' + addr);\n  }\n\n  const wrapper = path.join(CONFIG_DIR, 'paytaca-pay-wrapper.mjs');\n  if (!fs.existsSync(wrapper)) {\n    throw new Error('Payment wrapper not found at ' + wrapper + '. Restart opencode so the plugin writes it.');\n  }\n\n  // Minimal chat request for the target model; the payment flow only needs a\n  // valid request that triggers the x402 PaymentRequired for that model.\n  const body = JSON.stringify({\n    model: model.id,\n    messages: [{ role: 'user', content: 'Purchase plan' }],\n    stream: false,\n  });\n\n  const url = BACKEND_URL + '/v1/chat/completions?wallet_hash=' + encodeURIComponent(WALLET_HASH || '');\n  const extraHeaders = {\n    'X-Model-Id': model.id,\n    'X-Duration-Minutes': String(tier.minutes),\n  };\n\n  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'paytaca-buy-plan-'));\n  const bodyFile = path.join(tmpDir, 'body.json');\n  const configFile = path.join(tmpDir, 'config.json');\n  try {\n    fs.writeFileSync(bodyFile, body, 'utf8');\n    fs.writeFileSync(configFile, JSON.stringify({\n      url: url,\n      method: 'POST',\n      headers: Object.assign({ 'Content-Type': 'application/json' }, extraHeaders),\n      bodyFile: bodyFile,\n      confirmed: true,\n    }), 'utf8');\n  } catch (e) {\n    try { fs.rmdirSync(tmpDir); } catch (e2) {}\n    throw new Error('Failed to write payment files: ' + e.message);\n  }\n\n  log('Buy plan requested: ' + model.id + ' ' + tier.minutes + ' min');\n  let stdout;\n  try {\n    stdout = await runCommand('node', [wrapper, configFile], 250000);\n  } finally {\n    try { fs.unlinkSync(bodyFile); } catch (e2) {}\n    try { fs.unlinkSync(configFile); } catch (e2) {}\n    try { fs.rmdirSync(tmpDir); } catch (e2) {}\n  }\n\n  let result;\n  try {\n    result = JSON.parse(stdout);\n  } catch (e) {\n    throw new Error('Could not parse payment result: ' + stdout.substring(0, 200));\n  }\n\n  if (result.timeout) {\n    return 'Payment was processed but the response timed out. Check your credits with get_credits.';\n  }\n  if (!result.success) {\n    throw new Error(result.error || 'Payment failed (status ' + result.status + ').');\n  }\n\n  const lines = ['Plan purchased for ' + (model.display_name || model.id) + ': ' + tier.minutes + ' minutes.'];\n  if (result.payment && result.payment.txid) {\n    lines.push('Transaction: ' + result.payment.txid);\n  }\n  try {\n    const status = await getJson(BACKEND_URL + '/v1/wallet/status', { 'X-Wallet-Hash': WALLET_HASH });\n    const sessions = Array.isArray(status.sessions) ? status.sessions : [];\n    const found = sessions.find((s) => s.ai_model === model.id);\n    if (found && found.time_remaining_seconds > 0) {\n      lines.push('Credits: ' + formatDuration(found.time_remaining_seconds) + ' remaining.');\n    }\n  } catch (e) {}\n  return lines.join('\\n');\n}\n\n// Recent wallet transactions via the paytaca CLI\nasync function getTransactions(args) {\n  const cmdArgs = ['history'];\n  if (args.type === 'incoming' || args.type === 'outgoing') {\n    cmdArgs.push('--type', args.type);\n  }\n  const page = parseInt(args.page, 10);\n  if (!isNaN(page) && page > 0) {\n    cmdArgs.push('--page', String(page));\n  }\n  const out = await runCommand(PAYTACA_CMD, cmdArgs, 30000);\n  return out || 'No transactions found.';\n}\n\n// Receiving address via the paytaca CLI (QR art suppressed)\nasync function getReceivingAddress(args) {\n  const cmdArgs = ['receive', '--no-qr'];\n  const amount = parseFloat(args.amount);\n  if (!isNaN(amount) && amount > 0) {\n    cmdArgs.push('--amount', String(amount));\n  }\n  const out = await runCommand(PAYTACA_CMD, cmdArgs, 30000);\n  return out.trim() || 'Could not get receiving address.';\n}\n\n// CashToken holdings via the paytaca CLI (all tokens, or one category)\nasync function getTokens(args) {\n  const category = args.category ? String(args.category).trim() : '';\n  const cmdArgs = category ? ['token', 'info', category] : ['token', 'list'];\n  const out = await runCommand(PAYTACA_CMD, cmdArgs, 30000);\n  return out.trim() || (category ? 'Token not found: ' + category : 'No tokens found.');\n}\n\n// Send BCH or CashTokens. This spends real funds \u2014 opencode requires manual\n// user approval for this tool (permission 'paytaca_send' set to 'ask' by the\n// plugin's config hook), so it must never be called without the user asking\n// for the send.\nasync function sendFunds(args) {\n  const address = String(args.address || '').trim();\n  const amount = String(args.amount || '').trim();\n  const unit = args.unit === 'sats' ? 'sats' : 'bch';\n  const tokenCategory = args.token_category ? String(args.token_category).trim() : '';\n  if (!address) {\n    throw new Error('Missing recipient address.');\n  }\n  if (!amount || isNaN(Number(amount)) || Number(amount) <= 0) {\n    throw new Error('Missing or invalid amount.');\n  }\n  const cmdArgs = tokenCategory\n    ? ['token', 'send', address, amount, '--token', tokenCategory]\n    : ['send', address, amount];\n  if (!tokenCategory && unit === 'sats') {\n    cmdArgs.push('--unit', 'sats');\n  }\n  log('Send requested: ' + cmdArgs.join(' '));\n  const out = await runCommand(PAYTACA_CMD, cmdArgs, 90000);\n  log('Send completed');\n  return 'Transaction sent.\\n\\n' + out;\n}\n\n// Tool schemas (concise descriptions so MCP tool context stays small)\nconst TOOLS = [\n  {\n    name: 'get_credits',\n    description: 'Get remaining Paytaca AI time credits (active model sessions, time left). Use when the user asks about credits, remaining time, session status, or how much usage they have left.',\n    inputSchema: { type: 'object', properties: {} },\n  },\n  {\n    name: 'get_balance',\n    description: 'Get the BCH balance of the user\\'s Paytaca wallet. Use when the user asks about wallet balance or funds.',\n    inputSchema: { type: 'object', properties: {} },\n  },\n  {\n    name: 'get_models',\n    description: 'List the AI models available on Paytaca AI (id, display name, tier). Use when the user asks which models are available.',\n    inputSchema: { type: 'object', properties: {} },\n  },\n  {\n    name: 'get_plans',\n    description: 'Get Paytaca AI plan pricing: time tiers in minutes with USD and BCH prices, grouped by tier. Optionally pass a model id/name to filter one model. Use when the user asks about plans, pricing, costs, or how much a model costs.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        model: { type: 'string', description: 'Optional model id or display name to filter pricing to a single model.' },\n      },\n    },\n  },\n  {\n    name: 'buy_plan',\n    description: 'Purchase Paytaca AI time credits for a specific model and plan duration. SPENDS BCH FROM THE WALLET \u2014 only call when the user explicitly asks to buy, purchase, or pay for a plan; opencode prompts the user for approval. Show pricing with get_plans first, then call with the model and minutes the user picked. Works for any model, even one not active in the current session.',\n    inputSchema: {\n      type: 'object',\n      required: ['model', 'minutes'],\n      properties: {\n        model: { type: 'string', description: 'Model id or display name, e.g. deepseek/deepseek-v4-flash or DeepSeek V4 Flash.' },\n        minutes: { type: 'number', description: 'Plan duration in minutes, e.g. 30 for the 30-minute tier.' },\n      },\n    },\n  },\n  {\n    name: 'get_transactions',\n    description: 'Get recent Paytaca wallet transactions (sent/received BCH). Use when the user asks about transaction history or latest transactions.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        type: { type: 'string', enum: ['incoming', 'outgoing'], description: 'Optional direction filter.' },\n        page: { type: 'number', description: 'Optional 1-based page number for older history.' },\n      },\n    },\n  },\n  {\n    name: 'get_receiving_address',\n    description: 'Get a Paytaca wallet receiving address for depositing BCH, optionally as a BIP21 URI with an amount. Use when the user wants to fund the wallet or needs their address.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        amount: { type: 'number', description: 'Optional BCH amount to embed in a BIP21 payment URI.' },\n      },\n    },\n  },\n  {\n    name: 'get_tokens',\n    description: 'List CashToken holdings of the Paytaca wallet, or get details (name, symbol, balance, NFTs) for one token category. Use when the user asks about tokens or NFTs.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        category: { type: 'string', description: 'Optional token category id for details of a single token.' },\n      },\n    },\n  },\n  {\n    name: 'send',\n    description: 'Send BCH or CashTokens from the Paytaca wallet to an address. SPENDS REAL FUNDS \u2014 only call when the user explicitly asks to send; opencode will prompt the user for approval and that prompt must never be bypassed. Token amounts are in base units; recipients of tokens should use token-aware (z-prefix) addresses.',\n    inputSchema: {\n      type: 'object',\n      required: ['address', 'amount'],\n      properties: {\n        address: { type: 'string', description: 'Recipient CashAddr (e.g. bitcoincash:qp...).' },\n        amount: { type: 'string', description: 'Amount to send.' },\n        unit: { type: 'string', enum: ['bch', 'sats'], description: 'Amount unit, default bch. Ignored for token sends.' },\n        token_category: { type: 'string', description: 'Token category id to send CashTokens instead of BCH.' },\n      },\n    },\n  },\n];\n\n// JSON-RPC over stdio (newline-delimited)\nlet buffer = '';\nfunction handleMessage(msg) {\n  if (msg.method === 'initialize') {\n    const requestedVersion = msg.params && msg.params.protocolVersion;\n    send(msg.id, {\n      protocolVersion: requestedVersion || PROTOCOL_VERSION,\n      capabilities: { tools: {} },\n      serverInfo: { name: 'paytaca', version: '1.2.0' },\n    });\n    return;\n  }\n  if (msg.method === 'notifications/initialized') {\n    return;\n  }\n  if (msg.method === 'ping') {\n    send(msg.id, {});\n    return;\n  }\n  if (msg.method === 'tools/list') {\n    send(msg.id, { tools: TOOLS });\n    return;\n  }\n  if (msg.method === 'tools/call') {\n    const name = msg.params && msg.params.name;\n    const args = (msg.params && msg.params.arguments) || {};\n    refreshConfig();\n    (async () => {\n      let text;\n      try {\n        switch (name) {\n          case 'get_credits': text = await getCredits(); break;\n          case 'get_balance': text = await getBalance(); break;\n          case 'get_models': text = await getModels(); break;\n          case 'get_plans': text = await getPlans(args.model); break;\n          case 'buy_plan': text = await buyPlan(args); break;\n          case 'get_transactions': text = await getTransactions(args); break;\n          case 'get_receiving_address': text = await getReceivingAddress(args); break;\n          case 'get_tokens': text = await getTokens(args); break;\n          case 'send': text = await sendFunds(args); break;\n          default: throw new Error('Unknown tool: ' + name);\n        }\n        send(msg.id, { content: [{ type: 'text', text: text }] });\n      } catch (e) {\n        log('Tool ' + name + ' failed: ' + e.message);\n        send(msg.id, { content: [{ type: 'text', text: 'Error: ' + e.message }], isError: true });\n      }\n    })();\n    return;\n  }\n  // Unknown request \u2014 respond with an empty result so the client never hangs\n  if (typeof msg.id !== 'undefined' && msg.id !== null) {\n    send(msg.id, {});\n  }\n}\n\nfunction send(id, result) {\n  const payload = { jsonrpc: '2.0', id, result };\n  process.stdout.write(JSON.stringify(payload) + '\\n');\n}\n\nprocess.stdin.on('data', (chunk) => {\n  buffer += chunk.toString();\n  let idx;\n  while ((idx = buffer.indexOf('\\n')) !== -1) {\n    const line = buffer.substring(0, idx).trim();\n    buffer = buffer.substring(idx + 1);\n    if (!line) continue;\n    let msg;\n    try {\n      msg = JSON.parse(line);\n    } catch (e) {\n      continue;\n    }\n    try {\n      handleMessage(msg);\n    } catch (e) {\n      log('handleMessage error: ' + e.message);\n    }\n  }\n});\n\nrefreshConfig();\nlog('MCP server started (backend=' + BACKEND_URL + ')');\n";
+//# sourceMappingURL=mcp.d.ts.map

package/dist/bundled/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/bundled/mcp.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,q7uBAgmB9B,CAAC"}