slashvibe-mcp 0.5.3 → 0.5.5

package/index.js

@@ -248,6 +248,9 @@ const coreTools = {
   vibe_inbox: require('./tools/inbox'),
   vibe_reply: require('./tools/reply'),
 
+  // Return loop — get pinged about DMs you miss while away
+  vibe_email: require('./tools/email'),
+
   // Ship — share what you built
   vibe_ship: require('./tools/ship'),
   vibe_feed: require('./tools/feed'),
@@ -356,7 +359,11 @@ class VibeMCPServer {
           const actionName = params.name.replace('vibe_', '');
           const initTool = tools['vibe_init'];
           try {
-            const initResult = await initTool.handler({});
+            // Forward the first command's args into init rather than dropping them.
+            // vibe_init reads only {handle, one_liner, auth_method} and ignores any
+            // extra keys, so this is safe for every command yet lets relevant
+            // context (e.g. a handle the caller already supplied) carry into auth.
+            const initResult = await initTool.handler(params.arguments || {});
             const initDisplay = initResult.display || JSON.stringify(initResult, null, 2);
 
             // After auth, emit tools/list_changed so Claude sees full toolset

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slashvibe-mcp",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "mcpName": "io.github.vibecodinginc/vibe",
   "description": "Social layer for Claude Code - DMs, presence, Matrix multiplayer rooms, and connection between AI-assisted developers",
   "main": "index.js",

package/tools/email.js

@@ -0,0 +1,117 @@
+/**
+ * vibe_email — Add (or view) the email where /vibe pings you about DMs you miss
+ *
+ * The return loop: when someone DMs you while you're away from Claude Code,
+ * /vibe emails you so you actually come back. That only works if we have your
+ * address — GitHub doesn't hand us a verified email, so this is the one-time
+ * opt-in that arms it. Offline-only, 6h cooldown, one-click unsubscribe.
+ *
+ * Examples:
+ * - "vibe email me@example.com"   → set it
+ * - "vibe email"                  → show what's on file
+ */
+
+const config = require('../config');
+const { requireInit } = require('./_shared');
+
+// Same shape the server validates with (api/profile/update.js isValidEmail)
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+
+const definition = {
+  name: 'vibe_email',
+  description: "Set the email where /vibe alerts you about DMs you miss while away. No address on file → no offline pings. Call with no args to see what's set.",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      email: {
+        type: 'string',
+        description: 'Your email address. Omit to view the address currently on file.'
+      }
+    }
+  }
+};
+
+async function handler(args) {
+  const initCheck = requireInit();
+  if (initCheck) return initCheck;
+
+  const token = config.getAuthToken();
+  if (!token) {
+    return {
+      display: '❌ **Not authenticated**\n\nRun `vibe init` to sign in with GitHub first.'
+    };
+  }
+
+  const apiUrl = config.getApiUrl();
+  const authHeaders = {
+    'Content-Type': 'application/json',
+    'Authorization': `Bearer ${token}`
+  };
+
+  const { email } = args;
+
+  // ─── No arg: show what's on file ──────────────────────────────────────
+  if (!email || !String(email).trim()) {
+    try {
+      const r = await fetch(`${apiUrl}/api/profile/update`, { headers: authHeaders });
+      if (r.ok) {
+        const me = await r.json();
+        if (me.email) {
+          return {
+            display: `📧 **Email on file:** ${me.email}\n\n` +
+              "You'll get a heads-up here when someone DMs you while you're away from Claude Code.\n\n" +
+              '_Change it: `vibe email new@address.com` · stop alerts via the unsubscribe link in any email._'
+          };
+        }
+      }
+    } catch (e) {
+      // fall through to the prompt
+    }
+    return {
+      display: '📧 **No email on file yet**\n\n' +
+        "Add one and /vibe will ping you when someone DMs you while you're away — so you actually come back.\n\n" +
+        '`vibe email you@example.com`\n\n' +
+        '_Offline DMs only · max one every 6h · one-click unsubscribe in every email._'
+    };
+  }
+
+  // ─── Arg given: validate + save ───────────────────────────────────────
+  const addr = String(email).trim();
+  if (!EMAIL_RE.test(addr)) {
+    return {
+      display: `❌ **That doesn't look like an email**\n\nGot: \`${addr}\`\n\nTry again: \`vibe email you@example.com\``
+    };
+  }
+
+  try {
+    const r = await fetch(`${apiUrl}/api/profile/update`, {
+      method: 'PATCH',
+      headers: authHeaders,
+      body: JSON.stringify({ email: addr })
+    });
+    const result = await r.json().catch(() => ({}));
+
+    if (!r.ok) {
+      if (r.status === 400 && result.error === 'Invalid email format') {
+        return { display: `❌ **Invalid email format**\n\nGot: \`${addr}\`` };
+      }
+      if (r.status === 401) {
+        return { display: '❌ **Session expired**\n\nRun `vibe init` to sign in again, then retry.' };
+      }
+      return { display: `❌ **Couldn't save email**\n\n${result.error || 'Please try again.'}` };
+    }
+
+    return {
+      display: `✅ **Email saved:** ${addr}\n\n` +
+        "Next time someone DMs you while you're away from Claude Code, you'll get an email so you don't miss it.\n\n" +
+        '_Offline DMs only · max one every 6h · one-click unsubscribe in every email._'
+    };
+  } catch (error) {
+    console.error('[email] Error:', error);
+    return {
+      display: `❌ **Couldn't save email**\n\nError: ${error.message}\n\nPlease try again.`
+    };
+  }
+}
+
+module.exports = { definition, handler };

package/tools/init.js

@@ -22,24 +22,43 @@ const CALLBACK_PORT = 9876;
 const API_BASE = 'https://www.slashvibe.dev';
 
 /**
- * Fetch online count from presence API
+ * Fetch presence from the API, split into humans vs agents.
+ * The green dot should mean something — so we count real builders
+ * separately from agents and let callers frame each honestly.
  */
-async function getOnlineCount() {
+async function getPresenceCounts() {
   try {
     const response = await fetch(`${API_BASE}/api/presence`);
-    if (!response.ok) return 0;
+    if (!response.ok) return { online: 0, humans: 0, agents: 0 };
     const data = await response.json();
-    return (data.active?.length || 0) + (data.away?.length || 0);
+    const everyone = [...(data.active || []), ...(data.away || [])];
+    const humans = everyone.filter(u => !u.isAgent).length;
+    const agents = everyone.filter(u => u.isAgent).length;
+    return { online: everyone.length, humans, agents };
   } catch (e) {
-    return 0;
+    return { online: 0, humans: 0, agents: 0 };
   }
 }
 
+/**
+ * Short presence label that distinguishes humans from agents, e.g.
+ * "2 builders · 7 agents", "3 builders online", "8 agents online".
+ * Returns null when nobody is around (callers pick their own empty copy).
+ */
+function formatPresenceLabel({ humans = 0, agents = 0 } = {}) {
+  const plural = (n, w) => `${n} ${w}${n === 1 ? '' : 's'}`;
+  if (humans > 0 && agents > 0) return `${plural(humans, 'builder')} · ${plural(agents, 'agent')}`;
+  if (humans > 0) return `${plural(humans, 'builder')} online`;
+  if (agents > 0) return `${plural(agents, 'agent')} online`;
+  return null;
+}
+
 /**
  * Generate welcome banner for new users (pre-auth, no handle yet)
  */
-function generatePreAuthBanner(onlineCount) {
-  const onlineText = onlineCount > 0 ? `🟢 ${onlineCount} online now` : '🟢 join the crew';
+function generatePreAuthBanner(presence) {
+  const label = formatPresenceLabel(presence);
+  const onlineText = label ? `🟢 ${label}` : '🟢 join the crew';
   return `
   █░█ █ █▄▄ █▀▀     🚀 ship together
   ▀▄▀ █ █▄█ ██▄     ${onlineText}
@@ -50,14 +69,15 @@ function generatePreAuthBanner(onlineCount) {
 /**
  * Generate welcome banner for authenticated users (with handle + unread)
  */
-function generateAuthBanner(handle, unreadCount, onlineCount) {
+function generateAuthBanner(handle, unreadCount, presence) {
   // Format: logo | handle + unread | tagline + online
   // Keep alignment consistent with original banner
   const handleCol = `@${handle}`.padEnd(16);
   const unreadCol = unreadCount > 0 ? `📬 ${unreadCount} unread`.padEnd(14) : `📬 0 messages`.padEnd(14);
+  const onlineText = formatPresenceLabel(presence) || 'just you so far';
 
   return `  █░█ █ █▄▄ █▀▀   ${handleCol}  🚀 ship together
-  ▀▄▀ █ █▄█ ██▄   ${unreadCol}  🟢 ${onlineCount} online
+  ▀▄▀ █ █▄█ ██▄   ${unreadCol}  🟢 ${onlineText}
   ──────────────────────────────────────────────────`;
 }
 
@@ -162,6 +182,31 @@ async function fetchGitHubFriends(handle) {
   }
 }
 
+/**
+ * Does this freshly-authed user have an email on file?
+ *
+ * GitHub email capture (callback.js) fills this for most users, but accounts
+ * with a private GitHub email come back NULL — and a null-email user is exactly
+ * the one we can't reach when a DM lands while they're away. We only nudge that
+ * gap population, so people who already gave us an address aren't nagged.
+ *
+ * Returns true (has email), false (no email → nudge), or null (unknown → stay
+ * quiet rather than guess).
+ */
+async function fetchHasEmail(token) {
+  if (!token) return null;
+  try {
+    const r = await fetch(`${API_BASE}/api/profile/update`, {
+      headers: { 'Authorization': `Bearer ${token}` }
+    });
+    if (!r.ok) return null;
+    const me = await r.json();
+    return !!me.email;
+  } catch (e) {
+    return null;
+  }
+}
+
 /**
  * Send personalized welcome from @seth
  * Returns the welcome message content so we can show it inline
@@ -609,8 +654,8 @@ To check messages: \`vibe inbox\``
   // ===========================================
   // Show welcome banner (pre-auth)
   // ===========================================
-  const onlineCount = await getOnlineCount();
-  const welcomeBanner = generatePreAuthBanner(onlineCount);
+  const presence = await getPresenceCounts();
+  const welcomeBanner = generatePreAuthBanner(presence);
 
   // ===========================================
   // BROWSER AUTH (Default): GitHub OAuth
@@ -663,8 +708,18 @@ To check messages: \`vibe inbox\``
         ]);
       } catch (e) {}
 
+      // Do we have an email to reach them at when a DM lands while away?
+      // (non-blocking, 2s timeout — never hold up onboarding for this)
+      let hasEmail = null;
+      try {
+        hasEmail = await Promise.race([
+          fetchHasEmail(config.getAuthToken()),
+          new Promise(resolve => setTimeout(() => resolve(null), 2000))
+        ]);
+      } catch (e) {}
+
       // Generate authenticated banner with handle + unread (3 lines only - won't collapse)
-      const authBanner = generateAuthBanner(result.handle, unreadCount, onlineCount);
+      const authBanner = generateAuthBanner(result.handle, unreadCount, presence);
 
       // Build friends section if we have data
       let friendsSection = '';
@@ -687,8 +742,11 @@ To check messages: \`vibe inbox\``
       // landing in someone else's terminal. Only commands that exist (who /
       // @handle / ship). Avoid pointing the reply at a specific founder handle
       // here — it can misroute; reading the inbox is the safe path to reply.
-      const whoNudge = onlineCount > 1
-        ? `**"vibe who"** — see the ${onlineCount} builders online right now`
+      // Only promise a crowd of *humans* when there's actually one to meet —
+      // presence skews agent-heavy, and overselling an empty room is how the
+      // green dot stops meaning anything. Agents still show in `vibe who`.
+      const whoNudge = presence.humans > 1
+        ? `**"vibe who"** — see the ${presence.humans} builders online right now`
         : `**"vibe who"** — see who's building right now`;
       const nextSteps = `\n\n---\n**Your first 60 seconds**\n`
         + `1. ${whoNudge}\n`
@@ -696,8 +754,15 @@ To check messages: \`vibe inbox\``
         + `3. **"vibe ship <what you're building>"** — put yourself on the board\n\n`
         + `_Stuck? Say **"vibe help"**._`;
 
+      // One-time email nudge — only for users we can't otherwise reach (no
+      // address on file). This is the return loop: a DM that lands while you're
+      // away from Claude Code emails you so you actually come back.
+      const emailNudge = hasEmail === false
+        ? `\n\n---\n📧 **Don't miss a DM** — add an email and /vibe pings you when someone messages you while you're away:\n**"vibe email you@example.com"** _(offline only · one-click unsubscribe)_`
+        : '';
+
       return {
-        display: authBanner + friendsSection + welcomeSection + nextSteps,
+        display: authBanner + friendsSection + welcomeSection + nextSteps + emailNudge,
         onboarding: {
           isNewUser: true,
           handle: result.handle,

package/version.json

@@ -1,11 +1,11 @@
 {
-  "version": "0.5.3",
+  "version": "0.5.5",
   "updated": "2026-06-29",
-  "changelog": "Stronger first 60 seconds. After sign-in, /vibe now closes on a concrete next-steps guide — see who's online, send your first DM, ship to the board — instead of trailing off. Welcome DM quality improved.",
+  "changelog": "Presence now tells the truth: builders and agents are counted separately, so the green dot means something. Onboarding only promises a room full of people when real humans are actually online.",
   "features": [
-    "Post-init 'Your first 60 seconds' guide: vibe who → vibe @someone → vibe ship",
-    "Removed a reply CTA that could misroute; reading your inbox is the safe reply path",
-    "Welcome DM now generated with a current, higher-quality model"
+    "Presence banner shows the human/agent split (e.g. '2 builders · 7 agents') instead of one blended count",
+    "First-60s 'vibe who' nudge promises a crowd only when 2+ humans are online; agents still appear in vibe who",
+    "Honest empty-room copy when you're the first one in"
   ],
   "deprecated": [
     "vibe_pair — use Matrix room invites",