slashvibe-mcp 0.2.8 → 0.3.13

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

package/tools/work-summary.js

@@ -0,0 +1,96 @@
+/**
+ * vibe_work_summary — Standalone tool for explicit context gathering
+ *
+ * Use this when you need to:
+ * - Draft a message about what you're working on
+ * - Share your progress with someone
+ * - Get context for composing a "ship" post
+ *
+ * This tool returns structured data about:
+ * - Git state (branch, recent commits, changed files)
+ * - Project info (name, type)
+ * - Pre-formatted suggestions ready for messages/presence
+ */
+
+const { gatherWorkContext } = require('./_work-context');
+
+const definition = {
+  name: 'vibe_work_summary',
+  description: 'Get a summary of what you\'re working on (git state, project info). Use before composing messages about your work.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      detail_level: {
+        type: 'string',
+        enum: ['brief', 'detailed'],
+        description: 'brief = one-liner, detailed = include commits/files'
+      }
+    }
+  }
+};
+
+async function handler(args) {
+  const { detail_level = 'brief' } = args;
+
+  // Gather all context
+  const context = gatherWorkContext();
+
+  // Build display based on detail level
+  let display = '## Work Context\n\n';
+
+  // Project info
+  display += `**Project:** ${context.project.name}`;
+  if (context.project.type !== 'unknown') {
+    display += ` (${context.project.type})`;
+  }
+  display += '\n';
+
+  // Git info
+  if (context.git) {
+    display += `**Branch:** ${context.git.branch}\n`;
+
+    if (detail_level === 'detailed') {
+      // Show recent commits
+      if (context.git.recentCommits.length > 0) {
+        display += '\n**Recent commits:**\n';
+        context.git.recentCommits.forEach(c => {
+          display += `- \`${c.hash}\` ${c.message}\n`;
+        });
+      }
+
+      // Show changed files
+      if (context.git.changedFiles.length > 0) {
+        display += '\n**Changed files:**\n';
+        context.git.changedFiles.forEach(f => {
+          display += `- ${f}\n`;
+        });
+      }
+
+      // Uncommitted changes indicator
+      if (context.git.hasUncommitted) {
+        display += '\n⚠️ _Uncommitted changes_\n';
+      }
+    }
+  } else {
+    display += '_Not in a git repository_\n';
+  }
+
+  // Suggestions
+  display += '\n---\n\n';
+  display += '**Ready to use:**\n';
+  display += `- Brief: "${context.suggestions.brief}"\n`;
+  if (detail_level === 'detailed' && context.suggestions.detailed !== context.suggestions.brief) {
+    display += `- Detailed: "${context.suggestions.detailed}"\n`;
+  }
+
+  display += '\n_Use these in messages, status updates, or ship posts._';
+
+  return {
+    display,
+    // Structured data for Claude to use programmatically
+    ...context,
+    usage_hint: 'Use suggestions.brief for messages, suggestions.detailed for updates.'
+  };
+}
+
+module.exports = { definition, handler };

package/version.json

@@ -1,13 +1,15 @@
 {
-  "version": "0.3.0",
-  "updated": "2026-01-10",
-  "changelog": "Artifacts system - create guides, learnings, workspaces with vibe_create_artifact",
+  "version": "0.3.13",
+  "updated": "2026-01-22",
+  "changelog": "Platform polish: smart inbox, streaks, leaderboards, gig recommendations, mobile dashboard",
   "features": [
-    "vibe_create_artifact - Create social artifacts from conversations",
-    "vibe_view_artifact - View and list artifacts",
-    "Dual-write to KV + Postgres",
-    "HTML rendering at /a/:slug",
-    "Structured blocks: places, schedules, checklists, callouts"
+    "Smart inbox checking - triggers on commits, tests, builds, natural breaks",
+    "Tech stack auto-detection for better connection matching",
+    "Enhanced streak system - 5 badge tiers, freeze preservation",
+    "Leaderboard 2.1 - category rankings, position tracking, movers",
+    "Featured sessions in browse",
+    "Gig recommendations based on proven skills",
+    "Mobile dashboard API for fast loading"
   ],
   "breaking": false,
   "updateUrl": "https://www.slashvibe.dev/api/version"

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Slash Vibe, Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.