slashvibe-mcp 0.3.20 → 0.3.21

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
+  };
+}

package/tools/watch.js

@@ -0,0 +1,157 @@
+/**
+ * vibe watch — Watch live broadcasts
+ *
+ * Discover and watch live coding sessions from the /vibe community.
+ *
+ * Commands:
+ * - watch           → List active broadcasts
+ * - watch @handle   → Watch specific person's broadcast
+ * - watch room_xxx  → Watch by room ID
+ */
+
+const config = require('../config');
+
+const definition = {
+  name: 'vibe_watch',
+  description: 'See who\'s live and watch their coding sessions in real-time.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      target: {
+        type: 'string',
+        description: 'Handle (@user) or room ID to watch. Omit to list all live broadcasts.'
+      }
+    }
+  }
+};
+
+async function handler(args) {
+  const apiUrl = config.getApiUrl();
+  const target = args.target;
+
+  // LIST all broadcasts
+  if (!target) {
+    try {
+      const response = await fetch(`${apiUrl}/api/live`, {
+        headers: { 'Accept': 'application/json' }
+      });
+
+      const data = await response.json();
+
+      if (!data.success) {
+        return { display: `⚠️ Failed to fetch live broadcasts: ${data.error}` };
+      }
+
+      if (!data.broadcasts || data.broadcasts.length === 0) {
+        let display = `📺 **No Live Broadcasts**\n\n`;
+        display += `_No one is streaming right now._\n\n`;
+        display += `**Start your own:**\n`;
+        display += `\`vibe broadcast start "What you're building"\`\n\n`;
+        display += `**Browse saved sessions:**\n`;
+        display += `\`vibe session list\``;
+        return { display };
+      }
+
+      const formatDuration = (secs) => {
+        if (secs < 60) return 'just started';
+        if (secs < 3600) return `${Math.floor(secs / 60)}m`;
+        return `${Math.floor(secs / 3600)}h ${Math.floor((secs % 3600) / 60)}m`;
+      };
+
+      let display = `📺 **${data.broadcasts.length} Live Now**\n\n`;
+
+      for (const b of data.broadcasts) {
+        const viewers = b.viewers || 0;
+        const duration = formatDuration(b.duration || 0);
+
+        display += `🔴 **@${b.handle}**`;
+        if (viewers > 0) {
+          display += ` — ${viewers} watching`;
+        }
+        display += ` — ${duration}\n`;
+        display += `   → \`vibe watch ${b.roomId}\`\n\n`;
+      }
+
+      display += `_Watch a stream or start your own with \`vibe broadcast start\`_`;
+
+      return { display };
+
+    } catch (error) {
+      return { display: `## Watch Error\n\n${error.message}` };
+    }
+  }
+
+  // WATCH specific broadcast
+  const isRoomId = target.startsWith('room_');
+  const isHandle = target.startsWith('@') || !target.includes('_');
+
+  try {
+    let roomId = target;
+    let broadcasterHandle = null;
+
+    // If target is a handle, find their room
+    if (isHandle) {
+      broadcasterHandle = target.replace('@', '').toLowerCase();
+
+      // Fetch live broadcasts to find this person's room
+      const liveResponse = await fetch(`${apiUrl}/api/live`, {
+        headers: { 'Accept': 'application/json' }
+      });
+
+      const liveData = await liveResponse.json();
+
+      if (!liveData.success || !liveData.broadcasts) {
+        return { display: `⚠️ Failed to fetch broadcasts` };
+      }
+
+      const broadcast = liveData.broadcasts.find(
+        b => b.handle.toLowerCase() === broadcasterHandle
+      );
+
+      if (!broadcast) {
+        return {
+          display: `📺 @${broadcasterHandle} is not live right now.\n\n_Check who's streaming with \`vibe watch\`_`
+        };
+      }
+
+      roomId = broadcast.roomId;
+    }
+
+    // Get broadcast info
+    const response = await fetch(`${apiUrl}/api/watch?room=${roomId}`);
+    const data = await response.json();
+
+    if (!data.success) {
+      return {
+        display: `📺 Broadcast not found or ended.\n\n_Check live streams with \`vibe watch\`_`
+      };
+    }
+
+    const broadcast = data.broadcast;
+    const duration = broadcast.startedAt
+      ? Math.round((Date.now() - new Date(broadcast.startedAt).getTime()) / 1000)
+      : 0;
+
+    const formatDuration = (secs) => {
+      if (secs < 60) return 'just started';
+      if (secs < 3600) return `${Math.floor(secs / 60)}m`;
+      return `${Math.floor(secs / 3600)}h ${Math.floor((secs % 3600) / 60)}m`;
+    };
+
+    let display = `🔴 **LIVE: @${broadcast.handle}**\n\n`;
+    display += `**Duration:** ${formatDuration(duration)}\n`;
+    display += `**Viewers:** ${broadcast.viewerCount || 0}\n\n`;
+    display += `**Watch in browser:**\n`;
+    display += `https://slashvibe.dev/watch/${roomId}\n\n`;
+    display += `_Open the URL above to watch the live terminal stream._\n\n`;
+    display += `---\n`;
+    display += `_Coming soon: inline terminal replay in Claude Code_`;
+
+    return { display };
+
+  } catch (error) {
+    return { display: `## Watch Error\n\n${error.message}` };
+  }
+}
+
+module.exports = { definition, handler };

package/tools/who.js

@@ -150,6 +150,19 @@ async function handler(args) {
   // Apply smart detection — infer states from context signals
   const users = enhanceUsersWithInference(rawUsers);
   const myHandle = config.getHandle();
+  const apiUrl = config.getApiUrl();
+
+  // Fetch active help requests (non-blocking)
+  let helpRequests = [];
+  try {
+    const helpResponse = await fetch(`${apiUrl}/api/help?limit=5`);
+    const helpData = await helpResponse.json();
+    if (helpData.success && helpData.requests) {
+      helpRequests = helpData.requests;
+    }
+  } catch (e) {
+    // Silent fail - help requests are nice-to-have
+  }
 
   // Check for notifications (presence + messages)
   notify.checkAll(store);
@@ -177,6 +190,17 @@ _Check back in a bit — builders come and go._`
 
   let display = `## Who's Around\n\n`;
 
+  // Help requests section (if any)
+  if (helpRequests.length > 0) {
+    display += `**🆘 Needs Help:**\n`;
+    for (const req of helpRequests.slice(0, 3)) {
+      const urgencyIcon = req.urgency === 'high' ? '🔴' : req.urgency === 'low' ? '🟢' : '🟡';
+      const shortProblem = req.problem.length > 50 ? req.problem.slice(0, 47) + '...' : req.problem;
+      display += `${urgencyIcon} **@${req.handle}**: ${shortProblem}\n`;
+    }
+    display += `→ \`vibe stuck\` to help or ask\n\n---\n\n`;
+  }
+
   // Activity section for active users
   if (active.length > 0) {
     active.forEach(u => {
@@ -190,7 +214,12 @@ _Check back in a bit — builders come and go._`
       const activity = formatActivity(u);
       const timeAgo = formatTimeAgo(u.lastSeen);
 
-      display += `${heat.icon} **@${u.handle}**${agentBadge}${tag}${heatLabel}\n`;
+      // Show availability topics if set
+      const availableFor = u.availableFor && Array.isArray(u.availableFor) && u.availableFor.length > 0
+        ? ` — 🤝 _available for: ${u.availableFor.join(', ')}_`
+        : '';
+
+      display += `${heat.icon} **@${u.handle}**${agentBadge}${tag}${heatLabel}${availableFor}\n`;
       if (operatorTag) {
         display += `   ${operatorTag}\n`;
       }

package/tools/withdraw.js

@@ -0,0 +1,145 @@
+/**
+ * vibe_withdraw - Withdraw earnings from FeeRouter
+ *
+ * Generates transaction data to withdraw accumulated on-chain earnings.
+ * User must sign and submit the transaction with their wallet.
+ *
+ * Examples:
+ * - "vibe withdraw"
+ * - "withdraw my earnings"
+ * - "claim my on-chain balance"
+ */
+
+const fetch = require('node-fetch');
+const config = require('../config');
+
+const definition = {
+  name: 'vibe_withdraw',
+  description: 'Withdraw accumulated earnings from the FeeRouter. Generates transaction data for you to sign.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      to_address: {
+        type: 'string',
+        description: 'Optional destination address (defaults to your registered payout wallet)'
+      },
+      check_only: {
+        type: 'boolean',
+        description: 'Only check balance without generating withdrawal transaction'
+      }
+    }
+  }
+};
+
+async function handler(args) {
+  const { to_address, check_only = false } = args;
+
+  if (!config.isInitialized()) {
+    return {
+      display: 'Run `vibe init` first to set your identity.'
+    };
+  }
+
+  const handle = config.getHandle();
+  const token = config.getToken();
+  const apiUrl = process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
+
+  try {
+    // Check-only mode
+    if (check_only) {
+      const response = await fetch(
+        `${apiUrl}/api/earnings/withdraw?handle=${encodeURIComponent(handle)}`,
+        {
+          headers: token ? {
+            'Authorization': `Bearer ${token}`
+          } : {}
+        }
+      );
+
+      const result = await response.json();
+
+      if (!response.ok) {
+        return {
+          display: `❌ ${result.error || 'Failed to check balance'}`
+        };
+      }
+
+      const statusEmoji = result.can_withdraw ? '🟢' : '🟡';
+      const action = result.can_withdraw
+        ? 'Run "vibe withdraw" to generate withdrawal transaction.'
+        : result.registered
+          ? 'No balance to withdraw yet.'
+          : 'Register on-chain first: vibe register_onchain';
+
+      return {
+        display: `
+💰 Withdrawal Status: @${handle}
+
+Balance: ${result.balance_eth} ETH
+Registered: ${result.registered ? 'Yes' : 'No'}
+Can Withdraw: ${statusEmoji} ${result.can_withdraw ? 'Yes' : 'No'}
+
+${action}
+        `.trim(),
+        data: result
+      };
+    }
+
+    // Generate withdrawal transaction
+    const response = await fetch(
+      `${apiUrl}/api/earnings/withdraw`,
+      {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'Authorization': `Bearer ${token}`
+        },
+        body: JSON.stringify({
+          to_address: to_address || undefined
+        })
+      }
+    );
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      let display = `❌ ${result.error || 'Failed to generate withdrawal'}`;
+      if (result.action) {
+        display += `\n\nNext step: ${result.action}`;
+      }
+      return { display };
+    }
+
+    const destDisplay = result.destination
+      ? `${result.destination.slice(0, 10)}...${result.destination.slice(-8)}`
+      : 'your wallet';
+
+    return {
+      display: `
+💸 Withdrawal Ready: @${handle}
+
+Amount: ${result.balance_display}
+Destination: ${destDisplay}
+Network: ${result.network}
+
+Transaction to sign:
+  To: ${result.transaction.to}
+  Data: ${result.transaction.data?.slice(0, 40)}...
+  Gas: ${result.transaction.gas}
+
+Instructions:
+${result.instructions?.map((i, idx) => `  ${idx + 1}. ${i}`).join('\n')}
+
+Explorer: ${result.explorer}
+      `.trim(),
+      data: result
+    };
+
+  } catch (error) {
+    return {
+      display: `❌ Failed to process withdrawal: ${error.message}`
+    };
+  }
+}
+
+module.exports = { definition, handler };