slashvibe-mcp 0.3.21 → 0.3.23

package/tools/session-fork.js

@@ -0,0 +1,97 @@
+/**
+ * vibe session-fork — Fork someone else's session
+ *
+ * Creates a fork of an existing session, giving you a copy to build on.
+ * Supports 3 temporal destinations: session (replay), branch (code), or live (broadcast).
+ *
+ * Part of the core demo loop:
+ * Code with AI -> Session captured -> Replayable -> Discoverable -> Forkable -> Reputation accrues
+ *
+ * API: POST /api/sessions/fork
+ */
+
+const config = require('../config');
+const { requireInit } = require('./_shared');
+
+const definition = {
+  name: 'vibe_session_fork',
+  description: 'Fork an existing session to build on it. Creates a copy you can extend.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      session_id: {
+        type: 'string',
+        description: 'Session ID to fork (e.g., ses_xxx)'
+      },
+      fork_to: {
+        type: 'string',
+        enum: ['session', 'branch', 'live'],
+        description: 'Fork destination: session (replay copy), branch (code copy), live (start broadcast from fork)'
+      }
+    },
+    required: ['session_id']
+  }
+};
+
+async function handler(args) {
+  const initCheck = requireInit();
+  if (initCheck) return initCheck;
+
+  const { session_id, fork_to } = args;
+  const myHandle = config.getHandle();
+  const apiUrl = config.getApiUrl();
+
+  try {
+    const body = {
+      parentSessionId: session_id,
+      forkerHandle: myHandle,
+      forkTo: fork_to || 'session'
+    };
+
+    const response = await fetch(`${apiUrl}/api/sessions/fork`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body)
+    });
+
+    const data = await response.json();
+
+    if (!response.ok || data.error) {
+      return {
+        display: `## Fork Failed\n\n${data.error || `HTTP ${response.status}`}\n\nMake sure the session ID is valid. Try \`vibe feed\` to browse sessions.`
+      };
+    }
+
+    const forkId = data.forkId || data.id || 'unknown';
+    const destination = data.destination || fork_to || 'session';
+    const forkUrl = data.url || `https://slashvibe.dev/sessions/${forkId}`;
+
+    let display = `## Session Forked\n\n`;
+    display += `**Forked from:** \`${session_id}\`\n`;
+    display += `**Fork ID:** \`${forkId}\`\n`;
+    display += `**Destination:** ${destination}\n`;
+    display += `**URL:** ${forkUrl}\n\n`;
+
+    switch (destination) {
+      case 'session':
+        display += `Your fork is saved as a new session. You can replay or extend it.`;
+        break;
+      case 'branch':
+        display += `Code copy created. Start building on top of the original session.`;
+        break;
+      case 'live':
+        display += `Live broadcast started from fork. Others can watch you build on this.`;
+        break;
+    }
+
+    display += `\n\nThe original author gets credit — fork lineage is tracked.`;
+
+    return { display };
+  } catch (error) {
+    return {
+      display: `## Fork Error\n\n${error.message}\n\nRun \`vibe doctor\` to diagnose connectivity issues.`
+    };
+  }
+}
+
+module.exports = { definition, handler };

package/tools/session-save.js

@@ -0,0 +1,109 @@
+/**
+ * vibe session-save — Save your current session
+ *
+ * Persists a coding session to the platform so it becomes
+ * replayable, discoverable, and forkable.
+ *
+ * Part of the core demo loop:
+ * Code with AI -> Session captured -> Replayable -> Discoverable -> Forkable -> Reputation accrues
+ *
+ * API: POST /api/sessions
+ */
+
+const config = require('../config');
+const { requireInit } = require('./_shared');
+
+const definition = {
+  name: 'vibe_session_save',
+  description: 'Save your current coding session. Makes it replayable, discoverable, and forkable on slashvibe.dev.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      title: {
+        type: 'string',
+        description: 'Session title (e.g., "Building auth with OAuth")'
+      },
+      description: {
+        type: 'string',
+        description: 'Brief description of what happened in the session'
+      },
+      from_broadcast: {
+        type: 'string',
+        description: 'Room ID if saving from a live broadcast'
+      },
+      visibility: {
+        type: 'string',
+        enum: ['public', 'unlisted', 'private'],
+        description: 'Session visibility (default: public)'
+      }
+    },
+    required: ['title']
+  }
+};
+
+async function handler(args) {
+  const initCheck = requireInit();
+  if (initCheck) return initCheck;
+
+  const { title, description, from_broadcast, visibility } = args;
+  const myHandle = config.getHandle();
+  const apiUrl = config.getApiUrl();
+
+  try {
+    const body = {
+      author_handle: myHandle,
+      title,
+      visibility: visibility || 'public'
+    };
+
+    if (description) {
+      body.description = description;
+    }
+
+    if (from_broadcast) {
+      body.fromBroadcast = from_broadcast;
+    }
+
+    const response = await fetch(`${apiUrl}/api/sessions`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body)
+    });
+
+    const data = await response.json();
+
+    if (!response.ok || data.error) {
+      return {
+        display: `## Session Save Failed\n\n${data.error || `HTTP ${response.status}`}\n\nCheck \`vibe doctor\` if this persists.`
+      };
+    }
+
+    const session = data.session || data;
+    const sessionId = session.id || session.sessionId || 'unknown';
+    const sessionUrl = session.url || `https://slashvibe.dev/sessions/${sessionId}`;
+
+    let display = `## Session Saved\n\n`;
+    display += `**${title}**\n`;
+    if (description) {
+      display += `${description}\n`;
+    }
+    display += `\n`;
+    display += `**ID:** \`${sessionId}\`\n`;
+    display += `**URL:** ${sessionUrl}\n`;
+    display += `**Visibility:** ${visibility || 'public'}\n`;
+    if (from_broadcast) {
+      display += `**From broadcast:** \`${from_broadcast}\`\n`;
+    }
+    display += `\n`;
+    display += `Others can now replay, discover, and fork this session.\n`;
+    display += `Share: \`${sessionUrl}\``;
+
+    return { display };
+  } catch (error) {
+    return {
+      display: `## Session Save Error\n\n${error.message}\n\nMake sure you're connected to the internet. Run \`vibe doctor\` to diagnose.`
+    };
+  }
+}
+
+module.exports = { definition, handler };

package/tools/settings.js

@@ -6,15 +6,14 @@
  * - guided: on | off (dashboard mode)
  * - github_activity: on | off (show GitHub shipping status)
  * - github_activity_privacy: full | status_only | off
- * - mute: 1h | 2h | 4h | forever | off (merged from vibe_mute)
- * - auto_context: on | off (ambient work context gathering)
  */
 
 const config = require('../config');
 
 const definition = {
   name: 'vibe_settings',
-  description: 'Configure /vibe preferences. Set notification level, toggle guided mode, enable GitHub activity signals, or mute alerts.',
+  description:
+    'Configure /vibe preferences. Set notification level, toggle guided mode, or enable GitHub activity signals.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -35,14 +34,6 @@ const definition = {
         type: 'string',
         enum: ['full', 'status_only', 'off'],
         description: 'Privacy level: full (repos/commits), status_only (just badge), off'
-      },
-      mute: {
-        type: 'string',
-        description: 'Mute presence alerts: "1h", "2h", "4h", "forever", or "off" to unmute'
-      },
-      auto_context: {
-        type: 'boolean',
-        description: 'Enable/disable automatic work context gathering (git branch, recent commits shown in presence)'
       }
     }
   }
@@ -75,68 +66,12 @@ async function handler(args) {
     changes.push('github activity privacy → **' + args.github_activity_privacy + '**');
   }
 
-  // Handle mute setting (merged from vibe_mute)
-  if (args.mute) {
-    const duration = args.mute;
-
-    // UNMUTE
-    if (duration === 'off' || duration === 'unmute') {
-      config.set('mutedUntil', null);
-      config.set('focusMode', false);
-      changes.push('alerts → **unmuted**');
-    }
-    // MUTE FOREVER
-    else if (duration === 'forever' || duration === 'disable') {
-      config.set('presenceAgentEnabled', false);
-      config.set('mutedUntil', null);
-      changes.push('alerts → **disabled**');
-    }
-    // PARSE DURATION
-    else {
-      let ms = 0;
-      const match = duration.match(/^(\d+)(h|m|min|hour|hours|minutes)$/);
-
-      if (match) {
-        const amount = parseInt(match[1]);
-        const unit = match[2];
-
-        if (unit === 'h' || unit === 'hour' || unit === 'hours') {
-          ms = amount * 60 * 60 * 1000;
-        } else if (unit === 'm' || unit === 'min' || unit === 'minutes') {
-          ms = amount * 60 * 1000;
-        }
-      } else {
-        // Default to 1 hour if can't parse
-        ms = 60 * 60 * 1000;
-      }
-
-      const mutedUntil = Date.now() + ms;
-      config.set('mutedUntil', mutedUntil);
-
-      const until = new Date(mutedUntil).toLocaleTimeString();
-      const durationText = ms >= 3600000
-        ? `${Math.floor(ms / 3600000)} hour${Math.floor(ms / 3600000) > 1 ? 's' : ''}`
-        : `${Math.floor(ms / 60000)} minutes`;
-
-      changes.push(`alerts → **muted for ${durationText}** (until ${until})`);
-    }
-  }
-
-  // Update auto context if provided
-  if (args.auto_context !== undefined) {
-    config.set('autoContext', args.auto_context);
-    changes.push('auto context → **' + (args.auto_context ? 'on' : 'off') + '**');
-  }
-
   // If no args, show current settings
   if (changes.length === 0) {
     const notifications = config.getNotifications();
     const guided = config.getGuidedMode();
     const githubActivity = config.getGithubActivityEnabled();
     const githubPrivacy = config.getGithubActivityPrivacy();
-    const mutedUntil = config.get('mutedUntil');
-    const presenceEnabled = config.get('presenceAgentEnabled') !== false;
-    const autoContext = config.get('autoContext', true); // Default to true
 
     const notifyDesc = {
       all: 'All notifications (messages, mentions, presence)',
@@ -150,49 +85,45 @@ async function handler(args) {
       off: 'Disabled'
     };
 
-    // Determine mute status
-    let muteStatus = 'off';
-    let muteDesc = 'Alerts enabled';
-    if (!presenceEnabled) {
-      muteStatus = 'disabled';
-      muteDesc = 'Presence alerts permanently disabled';
-    } else if (mutedUntil) {
-      const remaining = mutedUntil - Date.now();
-      if (remaining > 0) {
-        const mins = Math.floor(remaining / 60000);
-        const hours = Math.floor(mins / 60);
-        muteStatus = hours > 0 ? `${hours}h ${mins % 60}m` : `${mins}m`;
-        muteDesc = `Muted until ${new Date(mutedUntil).toLocaleTimeString()}`;
-      }
-    }
-
     return {
-      display: '## /vibe Settings\n\n' +
-        '**Notifications:** ' + notifications + '\n' +
-        '_' + notifyDesc[notifications] + '_\n\n' +
-        '**Guided Mode:** ' + (guided ? 'on' : 'off') + '\n' +
-        '_' + (guided ? 'Shows dashboard menus' : 'Freeform mode') + '_\n\n' +
-        '**Alert Mute:** ' + muteStatus + '\n' +
-        '_' + muteDesc + '_\n\n' +
-        '**GitHub Activity:** ' + (githubActivity ? 'on' : 'off') + '\n' +
-        '_' + (githubActivity ? 'Shows shipping status from your GitHub commits' : 'Not sharing GitHub activity') + '_\n\n' +
+      display:
+        '## /vibe Settings\n\n' +
+        '**Notifications:** ' +
+        notifications +
+        '\n' +
+        '_' +
+        notifyDesc[notifications] +
+        '_\n\n' +
+        '**Guided Mode:** ' +
+        (guided ? 'on' : 'off') +
+        '\n' +
+        '_' +
+        (guided ? 'Shows dashboard menus' : 'Freeform mode') +
+        '_\n\n' +
+        '**GitHub Activity:** ' +
+        (githubActivity ? 'on' : 'off') +
+        '\n' +
+        '_' +
+        (githubActivity ? 'Shows shipping status from your GitHub commits' : 'Not sharing GitHub activity') +
+        '_\n\n' +
         (githubActivity ? '**GitHub Privacy:** ' + githubPrivacy + '\n_' + privacyDesc[githubPrivacy] + '_\n\n' : '') +
-        '**Auto Context:** ' + (autoContext ? 'on' : 'off') + '\n' +
-        '_' + (autoContext ? 'Git branch & work summary shared in presence' : 'Work context not auto-shared') + '_\n\n' +
         '---\n\n' +
         '**Change settings:**\n' +
         '• "set notifications to mentions" — less noisy\n' +
         '• "turn off guided mode" — no menus\n' +
-        '• "mute for 2h" — silence alerts temporarily\n' +
         '• "enable github activity" — show when you\'re shipping\n' +
-        '• "set github privacy to status_only" — just badge, no details\n' +
-        '• "disable auto context" — stop sharing git branch/work'
+        '• "set github privacy to status_only" — just badge, no details'
     };
   }
 
   return {
-    display: '## Settings Updated\n\n' +
-      changes.map(function(c) { return '✓ ' + c; }).join('\n') +
+    display:
+      '## Settings Updated\n\n' +
+      changes
+        .map(function (c) {
+          return '✓ ' + c;
+        })
+        .join('\n') +
       '\n\n_Changes take effect immediately._'
   };
 }

package/tools/ship.js

@@ -1,29 +1,42 @@
 /**
- * vibe ship — Announce what you just shipped
+ * vibe ship — Share with the community
  *
- * Share your wins with the community and update your profile.
- * Tracks your shipping history for better discovery matches.
+ * Unified creative entry point with type parameter:
+ * - type: "ship" (default) — Announce what you shipped
+ * - type: "idea" — Post a raw idea for others to riff on
+ * - type: "request" — Post a build request / wish
  *
- * Usage:
- * - ship "Built a new feature for my AI chat app"
- * - ship "Deployed my portfolio website"
- * - ship "Published blog post about React patterns"
+ * Absorbs former vibe_idea and vibe_request tools.
  */
 
 const config = require('../config');
 const userProfiles = require('../store/profiles');
 const patterns = require('../intelligence/patterns');
-const { requireInit, formatTimeAgo } = require('./_shared');
+const { requireInit, normalizeHandle, formatTimeAgo, debug } = require('./_shared');
+
+// Delegate handlers for absorbed tools
+const ideaTool = require('./idea');
+const requestTool = require('./request');
 
 const definition = {
   name: 'vibe_ship',
-  description: 'Announce something you just shipped to the community board and update your profile.',
+  description:
+    'Share with the community. type="ship" (default): announce what you shipped. type="idea": post an idea for others to riff on. type="request": post a build request.',
   inputSchema: {
     type: 'object',
     properties: {
+      type: {
+        type: 'string',
+        enum: ['ship', 'idea', 'request'],
+        description: 'What to share: ship (default), idea, or request'
+      },
       what: {
         type: 'string',
-        description: 'What you shipped (brief description)'
+        description: 'What you shipped (for type=ship)'
+      },
+      content: {
+        type: 'string',
+        description: 'Content for idea or request (for type=idea/request)'
       },
       url: {
         type: 'string',
@@ -41,9 +54,20 @@ const definition = {
         type: 'array',
         items: { type: 'string' },
         description: 'Tags for discovery (e.g., ["ai", "mcp", "tools"])'
+      },
+      riff_on: {
+        type: 'string',
+        description: 'Handle to riff on (for type=idea)'
+      },
+      claim: {
+        type: 'string',
+        description: 'Request ID to claim (for type=request)'
+      },
+      bounty: {
+        type: 'string',
+        description: "What you're offering for a request (for type=request)"
       }
-    },
-    required: ['what']
+    }
   }
 };
 
@@ -51,8 +75,18 @@ async function handler(args) {
   const initCheck = requireInit();
   if (initCheck) return initCheck;
 
+  // Route to absorbed tools by type
+  const type = args.type || 'ship';
+  if (type === 'idea') {
+    return ideaTool.handler(args);
+  }
+  if (type === 'request') {
+    return requestTool.handler(args);
+  }
+
+  // Default: ship
   if (!args.what) {
-    return { error: 'Please tell us what you shipped: ship "Built a new feature"' };
+    return { display: 'Please tell us what you shipped: ship "Built a new feature"' };
   }
 
   const myHandle = config.getHandle();
@@ -70,7 +104,7 @@ async function handler(args) {
       metaParts.push(`🔗 ${args.url}`);
     }
     if (args.inspired_by) {
-      const inspiree = args.inspired_by.replace('@', '').toLowerCase();
+      const inspiree = normalizeHandle(args.inspired_by);
       metaParts.push(`✨ inspired by @${inspiree}`);
     }
     if (args.for_request) {
@@ -84,22 +118,16 @@ async function handler(args) {
     // Build tags with attribution
     const tags = args.tags || [];
     if (args.inspired_by) {
-      tags.push(`inspired:${args.inspired_by.replace('@', '')}`);
+      tags.push(`inspired:${normalizeHandle(args.inspired_by)}`);
     }
     if (args.for_request) {
       tags.push(`fulfills:${args.for_request}`);
     }
 
-    // Post to board (with auth token)
-    const authToken = config.getAuthToken();
-    const headers = { 'Content-Type': 'application/json' };
-    if (authToken) {
-      headers['Authorization'] = `Bearer ${authToken}`;
-    }
-
+    // Post to board
     const response = await fetch(`${apiUrl}/api/board`, {
       method: 'POST',
-      headers,
+      headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({
         author: myHandle,
         content,
@@ -120,30 +148,17 @@ async function handler(args) {
       patterns.logInspiredBy(args.inspired_by);
     }
 
-    let display = `🚀 **Shipped!**\n\n${args.what}`;
+    // Push ship event to subscribed agent gateways
+    const { pushToAgents } = require('../notify');
+    pushToAgents('ship', { author: myHandle, what: args.what, url: args.url, tags }).catch(() => {});
+
+    let display = `🚀 shipped\n\n${args.what}`;
 
     if (args.url) {
-      display += `\n🔗 ${args.url}`;
+      display += `\n${args.url}`;
     }
     if (args.inspired_by) {
-      display += `\n✨ _via @${args.inspired_by.replace('@', '')}_`;
-    }
-
-    // Add share URL for viral distribution
-    if (data.shareUrl) {
-      display += `\n\n**📣 Share your ship:**\n${data.shareUrl}`;
-
-      // Use the twitterShareUrl from API response (tracked for K-factor)
-      if (data.twitterShareUrl) {
-        display += `\n\n**🐦 Share on Twitter** (helps others discover /vibe!)`;
-        display += `\n${data.twitterShareUrl}`;
-      } else {
-        // Fallback to inline URL if API didn't return one
-        const shareText = encodeURIComponent(`🚀 Just shipped: ${args.what.substring(0, 80)}\n\nBuilding with /vibe`);
-        const encodedUrl = encodeURIComponent(data.shareUrl);
-        display += `\n\n**Quick share:**`;
-        display += `\n• Twitter: https://twitter.com/intent/tweet?text=${shareText}&url=${encodedUrl}&hashtags=buildinpublic,vibecoders`;
-      }
+      display += `\n_via @${normalizeHandle(args.inspired_by)}_`;
     }
 
     display += '\n';
@@ -151,11 +166,13 @@ async function handler(args) {
     // Quiet awareness of similar builders
     const suggestions = await findSimilarShippers(myHandle, args.what);
     if (suggestions.length > 0) {
-      display += `\n_similar builders: @${suggestions.slice(0, 2).map(s => s.handle).join(', @')}_`;
+      display += `\n_similar: @${suggestions
+        .slice(0, 2)
+        .map(s => s.handle)
+        .join(', @')}_`;
     }
 
     return { display };
-
   } catch (error) {
     return { display: `## Ship Error\n\n${error.message}` };
   }
@@ -165,7 +182,10 @@ async function handler(args) {
 async function findSimilarShippers(myHandle, whatIShipped) {
   try {
     const allProfiles = await userProfiles.getAllProfiles();
-    const myWords = whatIShipped.toLowerCase().split(/\s+/).filter(w => w.length > 3);
+    const myWords = whatIShipped
+      .toLowerCase()
+      .split(/\s+/)
+      .filter(w => w.length > 3);
     const suggestions = [];
 
     for (const profile of allProfiles) {
@@ -175,7 +195,7 @@ async function findSimilarShippers(myHandle, whatIShipped) {
       for (const ship of profile.ships) {
         const shipWords = ship.what.toLowerCase().split(/\s+/);
         const overlap = myWords.filter(w => shipWords.includes(w));
-        
+
         if (overlap.length > 0) {
           suggestions.push({
             handle: profile.handle,
@@ -189,17 +209,15 @@ async function findSimilarShippers(myHandle, whatIShipped) {
     }
 
     // Sort by overlap and recency
-    return suggestions
-      .sort((a, b) => {
-        const overlapDiff = b.overlap - a.overlap;
-        if (overlapDiff !== 0) return overlapDiff;
-        return b.timestamp - a.timestamp;
-      });
-
+    return suggestions.sort((a, b) => {
+      const overlapDiff = b.overlap - a.overlap;
+      if (overlapDiff !== 0) return overlapDiff;
+      return b.timestamp - a.timestamp;
+    });
   } catch (error) {
-    console.warn('Error finding similar shippers:', error);
+    debug('ship', 'Error finding similar shippers:', error);
     return [];
   }
 }
 
-module.exports = { definition, handler };
+module.exports = { definition, handler };