slashvibe-mcp 0.5.4 → 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.4",
+  "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

@@ -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
@@ -683,6 +708,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 +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,5 +1,5 @@
 {
-  "version": "0.5.4",
+  "version": "0.5.5",
   "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.",
   "features": [