slashvibe-mcp 0.2.8 → 0.3.13

package/tools/tip.js

@@ -1,20 +1,32 @@
 /**
- * vibe_tip - Send a tip to another user
+ * vibe_tip - Send an instant on-chain USDC tip
  *
- * Makes the entire payment layer accessible from Claude Code conversations
+ * Real crypto tips with instant settlement on Base Sepolia.
+ * No fees - creator gets 100% of the tip.
+ * Gas is sponsored by /vibe.
  *
  * Examples:
  * - "tip @alice $5 for helping debug"
- * - "send @bob $10 thanks for the intro"
- * - "vibe tip @charlie 2.50"
+ * - "send @bob $1 thanks for the intro"
+ * - "vibe tip @charlie 10"
+ *
+ * Preset amounts: $1 (default), $5, $10
  */
 
-const fetch = require('node-fetch');
+const config = require('../config');
+const { requireInit, normalizeHandle, displayHandle } = require('./_shared');
+const { actions, formatActions } = require('./_actions');
 
-module.exports = {
-  name: 'vibe_tip',
-  description: 'Send a tip to another user. Tips are instant payments via blockchain (2.5% fee). Example: vibe_tip @alice 5 "thanks for the help!"',
+// Preset tip amounts in cents
+const TIP_PRESETS = {
+  1: 100,   // $1
+  5: 500,   // $5
+  10: 1000  // $10
+};
 
+const definition = {
+  name: 'vibe_tip',
+  description: 'Send an instant on-chain USDC tip. 0% fee - creator gets 100%. Gas is sponsored. Amounts: $1 (default), $5, $10.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -24,97 +36,158 @@ module.exports = {
       },
       amount: {
         type: 'number',
-        description: 'Amount in USD (e.g., 5.00). Min $0.01, Max $100'
+        description: 'Amount in USD (1, 5, or 10). Default: 1'
       },
       message: {
         type: 'string',
         description: 'Optional message to include with the tip'
+      },
+      context: {
+        type: 'object',
+        description: 'Optional context (type: dm_reply|ship|profile|gig_bonus, reference_id)',
+        properties: {
+          type: {
+            type: 'string',
+            enum: ['dm_reply', 'ship', 'profile', 'gig_bonus']
+          },
+          reference_id: {
+            type: 'string'
+          }
+        }
       }
     },
-    required: ['to', 'amount']
-  },
+    required: ['to']
+  }
+};
+
+async function handler(args) {
+  const initCheck = requireInit();
+  if (initCheck) return initCheck;
+
+  const { to, message, context } = args;
+  let { amount = 1 } = args;
+
+  const myHandle = config.getHandle();
+  const token = config.getToken();
+
+  if (!token) {
+    return {
+      display: '❌ **Not authenticated**\n\nRun `vibe init` to authenticate with GitHub first.'
+    };
+  }
+
+  // Normalize recipient handle
+  const recipient = normalizeHandle(to);
+  if (!recipient) {
+    return {
+      display: '❌ **Missing recipient**\n\nPlease specify who to tip (e.g., `tip @alice 5`).'
+    };
+  }
+
+  // Validate and normalize amount to preset
+  amount = parseFloat(amount);
+  if (isNaN(amount) || amount <= 0) {
+    amount = 1;
+  }
+
+  // Round to nearest preset
+  let amountCents;
+  if (amount >= 7.5) {
+    amountCents = TIP_PRESETS[10];
+    amount = 10;
+  } else if (amount >= 3) {
+    amountCents = TIP_PRESETS[5];
+    amount = 5;
+  } else {
+    amountCents = TIP_PRESETS[1];
+    amount = 1;
+  }
 
-  async execute({ to, amount, message }, context) {
-    try {
-      const from = context.handle;
+  // Call instant tip API
+  const apiUrl = config.getApiUrl();
 
-      if (!from) {
+  // Generate idempotency key to prevent duplicate tips from retries
+  // Key is based on: sender + recipient + amount + timestamp (1-minute bucket)
+  const timeBucket = Math.floor(Date.now() / 60000); // 1-minute buckets
+  const idempotencyKey = `${myHandle}:${recipient}:${amountCents}:${timeBucket}`;
+
+  try {
+    const response = await fetch(`${apiUrl}/api/tips/instant`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${token}`,
+        'Idempotency-Key': idempotencyKey
+      },
+      body: JSON.stringify({
+        to: recipient,
+        amount_cents: amountCents,
+        message,
+        context
+      })
+    });
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      // Handle specific error cases
+      if (result.error === 'insufficient_balance') {
         return {
-          success: false,
-          error: 'Not authenticated. Use vibe init first.'
+          display: `❌ **Insufficient USDC balance**\n\nYou need USDC to tip. Your balance: $${result.balance_usdc}\n\n` +
+            `Get USDC at [bridge.base.org](${result.help_url})`
         };
       }
 
-      // Validate amount
-      if (amount <= 0 || amount > 100) {
+      if (result.error === 'recipient_no_wallet') {
         return {
-          success: false,
-          error: 'Amount must be between $0.01 and $100'
+          display: `❌ **${displayHandle(recipient)} can't receive tips yet**\n\n` +
+            `They need to complete their wallet setup first.`
         };
       }
 
-      // Call payment API
-      const apiUrl = process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
-
-      const response = await fetch(`${apiUrl}/api/payments/tip`, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'Authorization': `Bearer ${context.token}`
-        },
-        body: JSON.stringify({
-          from,
-          to,
-          amount,
-          message
-        })
-      });
-
-      const result = await response.json();
-
-      if (!response.ok) {
+      if (result.error === 'rate_limited') {
         return {
-          success: false,
-          error: result.error || 'Tip failed',
-          details: result.details
+          display: `⏳ **Rate limit reached**\n\n${result.message}\n\nTry again in ${Math.ceil(result.reset_in_seconds / 60)} minutes.`
         };
       }
 
-      // Format success message
-      const fee = result.fee || (amount * 0.025);
-      const net = amount - fee;
-
       return {
-        success: true,
-        message: `💰 Tipped ${to} $${amount}`,
-        details: {
-          recipient: to,
-          amount: `$${amount}`,
-          fee: `$${fee.toFixed(2)} (2.5%)`,
-          net_to_recipient: `$${net.toFixed(2)}`,
-          tx_hash: result.tx_hash,
-          status: result.status,
-          explorer_url: `https://sepolia.basescan.org/tx/${result.tx_hash}`
-        },
-        formatted: `
-✓ Tip sent!
-  To: ${to}
-  Amount: $${amount}
-  Fee: $${fee.toFixed(2)}
-  Net: $${net.toFixed(2)}
-  ${message ? `Message: "${message}"` : ''}
-
-  Tx: ${result.tx_hash?.substring(0, 10)}...
-  Status: ${result.status}
-        `.trim()
+        display: `❌ **Tip failed**\n\n${result.message || 'Please try again.'}`
       };
+    }
 
-    } catch (error) {
-      return {
-        success: false,
-        error: 'Tip failed',
-        details: error.message
-      };
+    // Success!
+    let display = `✅ **Tipped ${displayHandle(recipient)} $${amount} USDC**\n\n`;
+
+    display += `💰 Amount: $${amount}.00\n`;
+    display += `📤 To: ${displayHandle(recipient)}\n`;
+    display += `📥 Fee: $0.00 (0%)\n`;
+    display += `✨ Net to creator: $${amount}.00\n`;
+
+    if (message) {
+      display += `\n💬 _"${message}"_\n`;
     }
+
+    display += `\n🔗 [View on Explorer](${result.explorer_url})`;
+
+    // Build response with actions
+    const response_obj = {
+      display,
+      tx_hash: result.tx_hash,
+      explorer_url: result.explorer_url
+    };
+
+    // Add follow-up actions
+    response_obj.actions = formatActions(actions.afterTip ? actions.afterTip(recipient) : actions.afterDm(recipient));
+
+    return response_obj;
+
+  } catch (error) {
+    console.error('[tip] Error:', error);
+    return {
+      display: `❌ **Tip failed**\n\nError: ${error.message}\n\nPlease try again.`
+    };
   }
-};
+}
+
+module.exports = { definition, handler };

package/tools/token.js

@@ -1,5 +1,5 @@
 /**
- * vibe token — Set Privy auth token after browser OAuth
+ * vibe token — Set auth token after GitHub OAuth
  *
  * Usage:
  *   vibe token <paste-token-here>
@@ -44,7 +44,7 @@ If you haven't authenticated yet:
   }
 
   // Verify token with server
-  const verification = await store.verifyPrivyToken(token.trim());
+  const verification = await store.verifyAuthToken(token.trim());
 
   if (!verification.valid) {
     return {
@@ -60,7 +60,7 @@ The token may be expired or invalid. Try authenticating again:
   }
 
   // Save token
-  config.savePrivyToken(token.trim());
+  config.saveAuthToken(token.trim());
 
   // Update session identity with verified handle
   const handle = verification.handle;
@@ -96,7 +96,7 @@ You're ready to vibe! Try:
 • \`vibe dm @someone "hello"\` — Send a message`,
     handle,
     github: verification.github,
-    authMethod: 'privy'
+    authMethod: 'github'
   };
 }
 

package/tools/update.js

@@ -49,7 +49,7 @@ async function handler(args) {
     display += `Your install doesn't support automatic updates.\n\n`;
     display += `To update, re-run the installer:\n`;
     display += `\`\`\`\n`;
-    display += `curl -fsSL https://raw.githubusercontent.com/brightseth/vibe/main/install.sh | bash\n`;
+    display += `curl -fsSL https://raw.githubusercontent.com/VibeCodingInc/vibe-mcp/main/install.sh | bash\n`;
     display += `\`\`\`\n\n`;
     display += `This will migrate you to the git-based installer for future updates.\n\n`;
     display += `---\n`;

package/tools/wallet.js

@@ -1,37 +1,42 @@
 /**
- * vibe_wallet - Check wallet balance and transaction history
+ * vibe_wallet - Unified wallet dashboard
  *
- * View your economic state: balance, recent transactions, earnings
+ * The "smoothbrain" view - everything in one place:
+ * - USD earnings (fiat)
+ * - $VIBE tokens (engagement currency)
+ * - Vesting schedule
+ * - Quick actions
  *
  * Examples:
  * - "vibe wallet"
  * - "check my balance"
- * - "show recent transactions"
+ * - "show my $VIBE"
  */
 
 const fetch = require('node-fetch');
 
 module.exports = {
   name: 'vibe_wallet',
-  description: 'Check your wallet balance and recent transactions. Shows tips sent/received, escrows, and current balance.',
+  description: 'Check your wallet: USD earnings, $VIBE tokens, vesting schedule, and available actions.',
 
   inputSchema: {
     type: 'object',
     properties: {
+      view: {
+        type: 'string',
+        description: 'Which view: dashboard (default), vesting, history',
+        enum: ['dashboard', 'vesting', 'history'],
+        default: 'dashboard'
+      },
       limit: {
         type: 'number',
-        description: 'Number of recent transactions to show (default 10, max 50)',
+        description: 'Number of transactions/items to show (for history view)',
         default: 10
-      },
-      show_balance: {
-        type: 'boolean',
-        description: 'Show current balance (default true)',
-        default: true
       }
     }
   },
 
-  async execute({ limit = 10, show_balance = true }, context) {
+  async execute({ view = 'dashboard', limit = 10 }, context) {
     try {
       const handle = context.handle;
 
@@ -44,77 +49,17 @@ module.exports = {
 
       const apiUrl = process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
 
-      // Fetch transaction history
-      const historyResponse = await fetch(
-        `${apiUrl}/api/payments/history?handle=${handle}&limit=${Math.min(limit, 50)}`,
-        {
-          headers: {
-            'Authorization': `Bearer ${context.token}`
-          }
-        }
-      );
-
-      const historyResult = await historyResponse.json();
-
-      if (!historyResponse.ok) {
-        return {
-          success: false,
-          error: 'Failed to fetch wallet data',
-          details: historyResult.error
-        };
+      // Handle different views
+      if (view === 'vesting') {
+        return await fetchVestingSchedule(apiUrl, handle, context.token);
       }
 
-      const transactions = historyResult.transactions || [];
-
-      // Calculate balance from transactions (simplified)
-      let balance = 0;
-      let totalReceived = 0;
-      let totalSent = 0;
-
-      transactions.forEach(tx => {
-        if (tx.type?.includes('received') || tx.type === 'escrow_completed') {
-          totalReceived += tx.amount || 0;
-        } else if (tx.type?.includes('sent') || tx.type === 'escrow_created') {
-          totalSent += tx.amount || 0;
-        }
-      });
-
-      balance = totalReceived - totalSent;
-
-      // Format transactions
-      const formattedTxs = transactions.slice(0, limit).map(tx => {
-        const isReceived = tx.type?.includes('received') || tx.type === 'escrow_completed';
-        const icon = isReceived ? '↓' : '↑';
-        const peer = isReceived ? tx.from : tx.to;
-        const amountStr = isReceived
-          ? `+$${tx.amount?.toFixed(2) || '0.00'}`
-          : `-$${tx.amount?.toFixed(2) || '0.00'}`;
-
-        return `${icon} ${amountStr.padEnd(10)} ${peer || 'unknown'} (${tx.status})`;
-      });
+      if (view === 'history') {
+        return await fetchHistory(apiUrl, handle, limit, context.token);
+      }
 
-      return {
-        success: true,
-        wallet: {
-          handle,
-          balance: `$${balance.toFixed(2)}`,
-          total_received: `$${totalReceived.toFixed(2)}`,
-          total_sent: `$${totalSent.toFixed(2)}`,
-          transaction_count: transactions.length
-        },
-        formatted: `
-💰 Wallet: ${handle}
-
-Balance: $${balance.toFixed(2)}
-  Received: $${totalReceived.toFixed(2)}
-  Sent: $${totalSent.toFixed(2)}
-
-Recent Transactions (${Math.min(limit, transactions.length)}):
-${formattedTxs.length > 0 ? formattedTxs.join('\n') : '  No transactions yet'}
-
-${historyResult.has_more ? `\n(${transactions.length - limit} more transactions...)` : ''}
-        `.trim()
-      };
+      // Default: dashboard view
+      return await fetchDashboard(apiUrl, handle, context.token);
 
     } catch (error) {
       return {
@@ -125,3 +70,200 @@ ${historyResult.has_more ? `\n(${transactions.length - limit} more transactions.
     }
   }
 };
+
+/**
+ * Fetch unified dashboard
+ */
+async function fetchDashboard(apiUrl, handle, token) {
+  const response = await fetch(
+    `${apiUrl}/api/wallet/dashboard?handle=${handle}`,
+    { headers: { 'Authorization': `Bearer ${token}` } }
+  );
+
+  const result = await response.json();
+
+  if (!response.ok) {
+    return {
+      success: false,
+      error: 'Failed to fetch wallet dashboard',
+      details: result.error
+    };
+  }
+
+  // Build formatted output
+  const usd = result.usd;
+  const vibe = result.vibe;
+  const summary = result.summary;
+  const actions = result.actions || [];
+
+  // USD section
+  const usdSection = usd.available.cents > 0
+    ? `💵 USD Earnings
+   Available: ${usd.available.display}
+   ${usd.held.cents > 0 ? `Held: ${usd.held.display}\n   ` : ''}Total earned: ${usd.total_earned.display}
+   ${usd.can_withdraw ? '✅ Ready to withdraw' : usd.payout_enabled ? '⏳ No balance to withdraw' : '⚠️  Connect bank to withdraw'}`
+    : `💵 USD Earnings
+   No earnings yet. Complete gigs to earn!`;
+
+  // $VIBE section
+  const vibeSection = `
+💜 $VIBE Tokens
+   Spendable: ${vibe.liquid} $VIBE
+   Vesting: ${vibe.vesting} $VIBE
+   ─────────────────
+   Total: ${vibe.total} $VIBE
+
+   ${vibe.upcoming.this_week > 0 ? `📅 +${vibe.upcoming.this_week} unlocks this week` : ''}
+   ${vibe.upcoming.this_month > 0 && vibe.upcoming.this_month !== vibe.upcoming.this_week ? `📅 +${vibe.upcoming.this_month} unlocks this month` : ''}
+   ${vibe.next_unlock ? `⏰ Next: ${vibe.next_unlock.amount} $VIBE in ${vibe.next_unlock.days} days` : ''}
+
+   Daily: ${vibe.daily.earned}/${vibe.daily.cap} earned today
+   ${'█'.repeat(Math.floor(vibe.daily.percent / 10))}${'░'.repeat(10 - Math.floor(vibe.daily.percent / 10))} ${vibe.daily.percent}%`;
+
+  // Actions section
+  const actionsSection = actions.length > 0
+    ? `\n🎯 Actions\n${actions.slice(0, 3).map(a => `   • ${a.label}: ${a.description}`).join('\n')}`
+    : '';
+
+  const formatted = `
+╭───────────────────────────────────╮
+│     💰 WALLET: @${handle.padEnd(17)}│
+╰───────────────────────────────────╯
+
+${usdSection}
+
+${vibeSection.trim()}
+${actionsSection}
+
+Tip: Use "vibe wallet --view vesting" for full schedule
+`.trim();
+
+  return {
+    success: true,
+    handle,
+    usd: result.usd,
+    vibe: result.vibe,
+    actions: result.actions,
+    formatted
+  };
+}
+
+/**
+ * Fetch vesting schedule
+ */
+async function fetchVestingSchedule(apiUrl, handle, token) {
+  const response = await fetch(
+    `${apiUrl}/api/vibe/vesting?handle=${handle}`,
+    { headers: { 'Authorization': `Bearer ${token}` } }
+  );
+
+  const result = await response.json();
+
+  if (!response.ok) {
+    return {
+      success: false,
+      error: 'Failed to fetch vesting schedule',
+      details: result.error
+    };
+  }
+
+  // Format vesting schedule
+  const summary = result.summary;
+  const unlocks = result.unlock_schedule || [];
+  const breakdown = result.activity_breakdown || [];
+
+  const scheduleLines = unlocks.slice(0, 8).map(week => {
+    const bar = '█'.repeat(Math.min(10, Math.ceil(week.total_amount / 10)));
+    return `   ${week.week_label.padEnd(12)} +${week.total_amount} $VIBE ${bar}`;
+  });
+
+  const breakdownLines = breakdown.slice(0, 5).map(act => {
+    return `   ${act.reason_display.padEnd(24)} ${act.amount} $VIBE`;
+  });
+
+  const formatted = `
+╭───────────────────────────────────╮
+│    📅 VESTING SCHEDULE: @${handle.padEnd(10)}│
+╰───────────────────────────────────╯
+
+Summary
+   Liquid (spendable): ${summary.liquid} $VIBE
+   Vesting (locked):   ${summary.vesting} $VIBE
+   ─────────────────────────────
+   Total:              ${summary.total} $VIBE
+
+${result.next_unlock ? `Next Unlock
+   ${result.next_unlock.amount} $VIBE in ${result.next_unlock.days_remaining} days
+   (earned from: ${result.next_unlock.reason})
+` : ''}
+Upcoming Unlocks by Week
+${scheduleLines.length > 0 ? scheduleLines.join('\n') : '   No tokens vesting'}
+
+Earned By Activity
+${breakdownLines.length > 0 ? breakdownLines.join('\n') : '   No activity yet'}
+
+ℹ️  Tokens vest over ${result.vesting_period_days} days to reward long-term builders.
+`.trim();
+
+  return {
+    success: true,
+    handle,
+    summary: result.summary,
+    schedule: result.unlock_schedule,
+    breakdown: result.activity_breakdown,
+    formatted
+  };
+}
+
+/**
+ * Fetch transaction history
+ */
+async function fetchHistory(apiUrl, handle, limit, token) {
+  const response = await fetch(
+    `${apiUrl}/api/vibe/history?handle=${handle}&limit=${limit}`,
+    { headers: { 'Authorization': `Bearer ${token}` } }
+  );
+
+  const result = await response.json();
+
+  if (!response.ok) {
+    return {
+      success: false,
+      error: 'Failed to fetch history',
+      details: result.error
+    };
+  }
+
+  const transactions = result.transactions || [];
+
+  const txLines = transactions.map(tx => {
+    const icon = tx.amount > 0 ? '↓' : '↑';
+    const sign = tx.amount > 0 ? '+' : '';
+    const status = tx.status === 'vesting' ? '🔒' : '✓';
+    const date = new Date(tx.created_at).toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
+    return `   ${icon} ${sign}${tx.amount} $VIBE  ${tx.reason.padEnd(20)} ${status} ${date}`;
+  });
+
+  const formatted = `
+╭───────────────────────────────────╮
+│    📜 HISTORY: @${handle.padEnd(17)}│
+╰───────────────────────────────────╯
+
+Balance: ${result.balance.liquid} liquid / ${result.balance.vesting} vesting
+
+Recent Transactions
+${txLines.length > 0 ? txLines.join('\n') : '   No transactions yet'}
+
+${result.pagination.has_more ? `\n(showing ${limit} of more...)` : ''}
+
+Legend: ↓ earned  ↑ spent  🔒 vesting  ✓ liquid
+`.trim();
+
+  return {
+    success: true,
+    handle,
+    balance: result.balance,
+    transactions: result.transactions,
+    formatted
+  };
+}