slashvibe-mcp 0.5.10 → 0.5.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slashvibe-mcp",
-  "version": "0.5.10",
+  "version": "0.5.12",
   "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/store/api.js

@@ -352,7 +352,9 @@ async function getActiveUsers() {
       awayAt: u.awayAt || u.context?.awayAt || null,
       // v2 additions
       isLive: u.isLive || false,
-      isAgent: u.isAgent || false
+      isAgent: u.isAgent || false,
+      // Presence texture (server-enriched): most-recent ship
+      lastShip: u.lastShip || null
     }));
 
     // Sync presence data to local profiles (non-blocking)

package/tools/_shared.js

@@ -202,6 +202,88 @@ async function fetchRelevantUsers(handle, context = 'dm_suggest', limit = 5) {
   }
 }
 
+// ─────────────────────────────────────────────────────────────
+// First-DM activation (dormant users)
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * Has this user ever sent a DM?
+ * Durable signal: a persisted `firstDmSent` flag (set on first successful send
+ * via markFirstDmSent), seeded by the presence of any conversation memory —
+ * existing messagers almost always have memory threads, so they're pre-excluded
+ * and never see the nudge. Self-heals: the moment they send one DM, the flag
+ * flips and the nudge is gone for good.
+ *
+ * @param {Array} threads - result of memory.listThreads()
+ * @returns {boolean}
+ */
+function hasEverMessaged(threads) {
+  try {
+    const cfg = config.load();
+    if (cfg && cfg.firstDmSent) return true;
+  } catch (e) {}
+  return Array.isArray(threads) && threads.length > 0;
+}
+
+/**
+ * Persist the "has sent a first DM" flag so the activation nudge stops.
+ * Called from dm.js on a successful send. Cheap, idempotent, best-effort.
+ */
+function markFirstDmSent() {
+  try {
+    const cfg = config.load();
+    if (!cfg || !cfg.firstDmSent) config.save({ firstDmSent: true });
+  } catch (e) {}
+}
+
+/**
+ * Pick the most-recently-active real human from a presence list, with a
+ * ready-to-paste opener. Filters out agents (is_agent) and self. Warms the
+ * opener from the target's most recent ship (lastShip) when available.
+ *
+ * @param {Array} others - active users (already excludes self by convention)
+ * @returns {{handle: string, opener: string}|null}
+ */
+function pickDormantTarget(others) {
+  const humans = (others || []).filter((u) => u && u.handle && !u.is_agent);
+  if (humans.length === 0) return null;
+  humans.sort(
+    (a, b) => new Date(b.lastSeen || b.last_seen || 0) - new Date(a.lastSeen || a.last_seen || 0)
+  );
+  const pick = humans[0];
+  // The opener is pasted inside a double-quoted `vibe dm @x "..."` command, so
+  // strip any double quotes/backslashes the ship text itself contains (ship
+  // content is arbitrary) and single-quote the snippet — otherwise an embedded
+  // quote closes the command early and breaks the paste.
+  const rawShip = pick.lastShip && pick.lastShip.what;
+  const shipped = rawShip ? String(rawShip).replace(/["\\]/g, '').trim().slice(0, 48) : '';
+  const opener = shipped
+    ? `hey! saw you shipped '${shipped}' — what are you building?`
+    : `hey! what are you building?`;
+  return { handle: pick.handle, opener };
+}
+
+/**
+ * Render the first-DM activation nudge, or '' when it shouldn't show.
+ * Shows only for users who have never sent a DM, and only when a real human is
+ * around right now to receive it. This is the returning-user twin of the
+ * new-user welcome first-message pull — it reaches the dormant existing users
+ * where the actual funnel is.
+ *
+ * @param {Array} others - active users (excludes self)
+ * @param {Array} threads - memory.listThreads()
+ * @returns {string} markdown block (leading blank line) or ''
+ */
+function firstDmNudge(others, threads) {
+  if (hasEverMessaged(threads)) return '';
+  const target = pickDormantTarget(others);
+  if (!target) return '';
+  return (
+    `\n\n**👋 You haven't messaged anyone yet — @${target.handle} is around right now:**` +
+    `\n   vibe dm @${target.handle} "${target.opener}"`
+  );
+}
+
 // ─────────────────────────────────────────────────────────────
 // Exports
 // ─────────────────────────────────────────────────────────────
@@ -230,5 +312,11 @@ module.exports = {
   error,
 
   // API
-  fetchRelevantUsers
+  fetchRelevantUsers,
+
+  // First-DM activation (dormant users)
+  hasEverMessaged,
+  markFirstDmSent,
+  pickDormantTarget,
+  firstDmNudge
 };

package/tools/dm.js

@@ -8,7 +8,7 @@ const memory = require('../memory');
 const userProfiles = require('../store/profiles');
 const patterns = require('../intelligence/patterns');
 const { trackMessage, checkBurst } = require('./summarize');
-const { requireInit, normalizeHandle, truncate, warning, fetchRelevantUsers } = require('./_shared');
+const { requireInit, normalizeHandle, truncate, warning, fetchRelevantUsers, markFirstDmSent } = require('./_shared');
 const { actions, formatActions } = require('./_actions');
 
 const definition = {
@@ -110,6 +110,10 @@ async function handler(args) {
     };
   }
 
+  // Mark that this user has sent a DM — silences the first-DM activation nudge
+  // (vibe start / vibe who) for good. Durable, idempotent, best-effort.
+  markFirstDmSent();
+
   // Log social pattern (quietly, in background)
   patterns.logMessageSent(them);
 

package/tools/init.js

@@ -263,9 +263,13 @@ async function sendWelcomeMessage(handle, one_liner) {
   }
 }
 
+// The exact link a user can click if the browser didn't pop open on its own.
+// Deterministic (fixed callback port), so it's safe to show verbatim anywhere.
+const MANUAL_LOGIN_URL = `https://www.slashvibe.dev/login?redirect=${encodeURIComponent(`http://localhost:${CALLBACK_PORT}/callback`)}`;
+
 const definition = {
   name: 'vibe_init',
-  description: 'Join /vibe social network. Opens browser for GitHub login - NO INPUT NEEDED. Your GitHub username becomes your handle automatically. Just run this and complete the browser auth.',
+  description: `Join /vibe social network. Opens the browser for GitHub sign-in — NO INPUT NEEDED; the user's GitHub username becomes their handle automatically. This BLOCKS for up to 2 minutes waiting for the browser login to finish, so BEFORE it returns the user sees only a spinner. IMPORTANT: right when you call this, tell the user in your own words that their browser is opening to sign in with GitHub, and that if the tab didn't pop open they can click this link instead: ${MANUAL_LOGIN_URL} — then finish the login there and come back.`,
   inputSchema: {
     type: 'object',
     properties: {
@@ -810,44 +814,47 @@ To check messages: \`vibe inbox\`${emailNudge}`
     } catch (err) {
       if (err.message === 'AUTH_IN_PROGRESS') {
         return {
-          display: `## Auth already in progress
+          display: `## A login is already running
 
-Another login is running. Either:
-1. **Complete it** in your browser, or
-2. **Wait 30 seconds** and try again
+You've got a sign-in waiting in your browser. Either:
+1. **Finish it** in the browser tab that opened, or
+2. **Open it yourself** if the tab didn't pop up:
+   ${MANUAL_LOGIN_URL}
 
-If stuck, kill the auth server:
+Still stuck? Clear it and start over:
 \`\`\`
 lsof -ti:9876 | xargs kill
 \`\`\`
-Then run \`vibe init\` again.`
+Then say **"let's vibe"** again.`
         };
       }
 
       if (err.message === 'AUTH_TIMEOUT') {
         return {
-          display: `## Auth timed out
+          display: `## The sign-in timed out
 
-The browser login wasn't completed within 2 minutes.
+The browser login wasn't finished within 2 minutes — no problem, just start it again.
 
-**Try again:**
-Just say "add the vibe mcp server" and complete the browser auth faster this time.
+**1. Say "let's vibe"** to reopen the login.
+**2. If the browser tab doesn't pop up,** click this link yourself:
+   ${MANUAL_LOGIN_URL}
+**3. Sign in with GitHub** in that tab, then come back here.
 
-**Tip:** Keep Claude Code visible so you can see when auth completes.`
+_Tip: keep this window and the browser both visible so you can see when it finishes._`
         };
       }
 
       return {
-        display: `## Failed to authenticate
+        display: `## Couldn't finish sign-in
 
-**Error:** ${err.message}
+**What happened:** ${err.message}
 
-**Quick fixes:**
-1. Check your internet connection
-2. Try again: just say "vibe init"
-3. Check status: slashvibe.dev/status
+**Try this:**
+1. **Click the login link directly:** ${MANUAL_LOGIN_URL}
+2. Finish the GitHub sign-in in that tab, then come back
+3. Or say **"let's vibe"** to try the whole thing again
 
-**Need help?** DM @seth on Twitter or email seth@slashvibe.dev`
+**Still stuck?** Email seth@slashvibe.dev — happy to get you in.`
       };
     }
   }

package/tools/start.js

@@ -17,6 +17,7 @@ const memory = require('../memory');
 const notify = require('../notify');
 const patterns = require('../intelligence/patterns');
 const { actions, formatActions } = require('./_actions');
+const { firstDmNudge } = require('./_shared');
 const init = require('./init');
 const { gatherWithTimeout } = require('./_work-context');
 
@@ -330,6 +331,11 @@ async function handler(args) {
     }
   }
 
+  // First-DM activation nudge (dormant users only): if this user has never sent
+  // a DM, point them at a real human who's around right now with a ready opener.
+  // Gated inside firstDmNudge so we never nag people who already message.
+  display += firstDmNudge(others, threads);
+
   // Add unread messages section (if any)
   if (unreadCount > 0) {
     const unreadSenders = inboxThreads.filter(t => t.unread > 0);

package/tools/who.js

@@ -10,7 +10,8 @@
 const config = require('../config');
 const store = require('../store');
 const notify = require('../notify');
-const { formatTimeAgo, requireInit } = require('./_shared');
+const { formatTimeAgo, requireInit, firstDmNudge } = require('./_shared');
+const memory = require('../memory');
 const { actions, formatActions } = require('./_actions');
 const { enhanceUsersWithInference } = require('../intelligence/infer');
 const { getTopSerendipity, getAllSerendipity } = require('../intelligence/serendipity');
@@ -225,10 +226,25 @@ _Check back in a bit — builders come and go._`
         display += `   ${operatorTag}\n`;
       }
       display += `   ${activity}\n`;
+      // Presence texture: what they last shipped
+      if (u.lastShip && u.lastShip.what) {
+        display += `   _last shipped: "${u.lastShip.what}" ${u.lastShip.ago}_\n`;
+      }
       display += `   _${timeAgo}_\n\n`;
     });
   }
 
+  // First-DM activation nudge (dormant users only): if signed in and this user
+  // has never sent a DM, point them at a real human who's active right now.
+  // firstDmNudge self-gates so people who already message never see it.
+  if (isInit) {
+    let threads = [];
+    try { threads = memory.listThreads(); } catch (e) {}
+    const activeOthers = active.filter(u => u.handle !== myHandle);
+    const nudge = firstDmNudge(activeOthers, threads);
+    if (nudge) display += nudge.replace(/^\n+/, '') + `\n\n`;
+  }
+
   // Away section (expanded with messages if present)
   if (away.length > 0) {
     display += `---\n\n`;

package/version.json

@@ -1,8 +1,10 @@
 {
-  "version": "0.5.10",
+  "version": "0.5.12",
   "updated": "2026-07-03",
-  "changelog": "Play anything. `vibe_play @handle` is the open channel underneath the games — it carries an arbitrary state object over your DM thread and lets you and the other person's Claude improvise the rules to whatever you invent: chess, 20 questions, a co-written story, battleship, a shared drawing, a debate. No built-in game logic — the creativity is yours. `vibe_game`, `vibe_poem`, and `vibe_corpse` are still here as quick on-ramps. Ship together, play together.",
+  "changelog": "First-run just got un-losable. Saying `let's vibe` opens your browser for GitHub sign-in — and now the tool tells you that's happening, hands you a clickable login link if the tab didn't pop, and if anything times out it says exactly what to do (`let's vibe` again) instead of an unrelated hint. No more staring at a silent prompt wondering if it worked.",
   "features": [
+    "Bulletproof first-run — `let's vibe` now narrates the browser sign-in, gives you a clickable fallback login link, and every timeout/error path tells you the correct retry. You can't get stranded",
+    "First-DM nudge — if you've never messaged anyone, vibe start/who surface the most-recently-active real human as a one-tap opener, warmed by their latest ship. Self-heals: disappears the moment you send your first DM",
     "vibe_play — the open primitive: pass any JSON state + a note to another viber, read it back to take your turn, and improvise any activity two sessions can dream up",
     "vibe_corpse — write an exquisite corpse: alternate lines blind to all but the last, then seal for the big reveal",
     "vibe_game — play tic-tac-toe with another viber, move by move, over your DM thread",