slashvibe-mcp 0.5.4 → 0.5.6

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.4",
+  "version": "0.5.6",
   "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

@@ -182,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
@@ -616,12 +641,45 @@ async function handler(args) {
   if (config.hasOAuth()) {
     const existingHandle = config.getHandle();
     if (existingHandle) {
+      // Enrich the returning-user surface — this fires on every `vibe` for an
+      // already-authed user, so it's our highest-frequency touchpoint. Surface
+      // unread (the reason to come back) and, if we have no email on file, nudge
+      // the return loop right at the teachable moment. Both are best-effort with
+      // tight timeouts — never hold up the response; degrade to the plain message.
+      let unreadCount = 0;
+      let hasEmail = null;
+      try {
+        [unreadCount, hasEmail] = await Promise.all([
+          Promise.race([
+            store.getUnreadCount(existingHandle),
+            new Promise(resolve => setTimeout(() => resolve(0), 1500))
+          ]).catch(() => 0),
+          Promise.race([
+            fetchHasEmail(config.getAuthToken()),
+            new Promise(resolve => setTimeout(() => resolve(null), 1500))
+          ]).catch(() => null)
+        ]);
+      } catch (e) {}
+
+      const unreadLine = unreadCount > 0
+        ? `\n\n📬 **${unreadCount} unread** — say \`vibe inbox\` to read ${unreadCount > 1 ? 'them' : 'it'}.`
+        : '';
+
+      // Only nudge when we genuinely can't reach them out-of-band. If they have
+      // unread right now, the value is concrete: "these landed while you were
+      // away — next time we'll email you." Otherwise it's a gentle one-liner.
+      const emailNudge = hasEmail === false
+        ? (unreadCount > 0
+            ? `\n\n📧 These landed while you were away. Add an email and /vibe pings you next time — say **"vibe email you@example.com"** _(offline only · one-click unsubscribe)_.`
+            : `\n\n📧 **Don't miss a DM** — add an email and /vibe pings you when someone messages you while you're away: **"vibe email you@example.com"** _(offline only · one-click unsubscribe)_.`)
+        : '';
+
       return {
-        display: `## Already signed in as @${existingHandle}
+        display: `## Already signed in as @${existingHandle}${unreadLine}
 
 To sign out and re-authenticate: \`vibe logout\`
 To see who's online: \`vibe who\`
-To check messages: \`vibe inbox\``
+To check messages: \`vibe inbox\`${emailNudge}`
       };
     }
   }
@@ -683,6 +741,16 @@ 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, presence);
 
@@ -719,8 +787,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.4",
-  "updated": "2026-06-29",
-  "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.",
+  "version": "0.5.6",
+  "updated": "2026-06-30",
+  "changelog": "Come back to what you missed. Returning to /vibe now shows your unread count right away, and if we don't have an email to reach you at, we offer to arm the return-loop ping at the moment it matters — when a DM just landed while you were away.",
   "features": [
-    "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"
+    "Returning 'already signed in' surface now shows your unread count instead of a static line",
+    "Contextual email nudge on return: if a DM landed while you were away and we can't reach you, we offer 'vibe email' right then",
+    "One-line, offline-only, one-click unsubscribe — the return loop only pings when you're actually gone"
   ],
   "deprecated": [
     "vibe_pair — use Matrix room invites",