slashvibe-mcp 0.2.9 → 0.3.13

package/tools/dm.js

@@ -1,6 +1,5 @@
 /**
  * vibe dm — Send a direct message
- * Supports internal /vibe DMs and external platforms (Gmail, X, Farcaster, etc.)
  */
 
 const config = require('../config');
@@ -9,13 +8,12 @@ const memory = require('../memory');
 const userProfiles = require('../store/profiles');
 const patterns = require('../intelligence/patterns');
 const { trackMessage, checkBurst } = require('./summarize');
-const { requireInit, normalizeHandle, truncate, warning } = require('./_shared');
+const { requireInit, normalizeHandle, truncate, warning, fetchRelevantUsers } = require('./_shared');
 const { actions, formatActions } = require('./_actions');
-const router = require('../../lib/messaging/router');
 
 const definition = {
   name: 'vibe_dm',
-  description: 'Send a direct message to someone. Can include structured payload for games, handoffs, etc.',
+  description: 'Send a direct message to someone. Can include structured payload for games, handoffs, artifact cards, or an instant USDC tip.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -27,9 +25,21 @@ const definition = {
         type: 'string',
         description: 'Your message'
       },
+      artifact_slug: {
+        type: 'string',
+        description: 'Optional artifact slug to share (e.g., "pizza-guide-abc123"). The artifact will be shown as a rich card.'
+      },
       payload: {
         type: 'object',
         description: 'Optional structured data (game state, code review, handoff, etc.)'
+      },
+      reply_to: {
+        type: 'string',
+        description: 'Optional: Message ID to reply to (creates a threaded reply)'
+      },
+      tip_amount_cents: {
+        type: 'number',
+        description: 'Optional: Attach an instant USDC tip (100 = $1, 500 = $5, 1000 = $10)'
       }
     },
     required: ['handle']
@@ -40,7 +50,7 @@ async function handler(args) {
   const initCheck = requireInit();
   if (initCheck) return initCheck;
 
-  const { handle, message, payload } = args;
+  const { handle, message, artifact_slug, payload, reply_to, tip_amount_cents } = args;
   const myHandle = config.getHandle();
   const them = normalizeHandle(handle);
 
@@ -54,82 +64,51 @@ async function handler(args) {
     return { display: 'You can\'t DM yourself.' };
   }
 
-  // Need either message or payload
-  if ((!message || message.trim().length === 0) && !payload) {
-    return { display: 'Need either a message or payload.' };
-  }
-
-  // Check if this is an external platform message (email, X, Farcaster, etc.)
-  const platform = router.detectPlatform(handle);
-
-  if (platform !== 'vibe') {
-    // External platform - route via messaging adapters
+  // Handle artifact sharing
+  let finalPayload = payload;
+  if (artifact_slug) {
     try {
-      const result = await router.send(handle, message, {
-        handle: myHandle,
-        subject: args.subject, // For email
-        platform: args.platform // Allow explicit platform override
-      });
+      // Fetch artifact from API
+      const { getArtifactBySlug } = require('./artifact-view');
+      const artifact = await getArtifactBySlug(artifact_slug);
 
-      // Auth required
-      if (result.authRequired) {
-        return {
-          display: `🔐 Connect ${platform} first
-
-${platform} is not connected yet. Connect it to send messages:
-
-  vibe connect ${platform}
-
-Then you can message:
-  vibe dm ${handle} "${message.slice(0, 50)}..."
-`
-        };
-      }
-
-      // Success
-      if (result.success) {
-        return {
-          display: `✓ Sent via ${platform}
-
-To: ${handle}
-Message: "${truncate(message, 100)}"
-
-${platform === 'gmail' ? `Message ID: ${result.messageId}` : ''}
-`
-        };
+      if (!artifact) {
+        return { display: `Artifact not found: ${artifact_slug}` };
       }
 
-      // Error
-      return {
-        display: `❌ Failed to send via ${platform}
-
-Error: ${result.error}
-
-${platform} may need to be reconnected:
-  vibe connect ${platform} --action status
-`
-      };
+      // Create artifact payload
+      const protocol = require('../protocol');
+      finalPayload = protocol.createArtifactPayload(artifact);
     } catch (error) {
-      return {
-        display: `❌ Error sending via ${platform}
-
-${error.message}
-
-Make sure ${platform} is configured:
-  vibe connect ${platform}
-`
-      };
+      console.error('Failed to load artifact:', error);
+      return { display: `Failed to load artifact: ${error.message}` };
     }
   }
 
-  // Continue with internal /vibe DM logic below...
+  // Need either message or payload
+  if ((!message || message.trim().length === 0) && !finalPayload) {
+    return { display: 'Need either a message, artifact, or payload.' };
+  }
 
   const trimmed = message ? message.trim() : '';
   const MAX_LENGTH = 2000;
   const wasTruncated = trimmed.length > MAX_LENGTH;
   const finalMessage = wasTruncated ? trimmed.substring(0, MAX_LENGTH) : trimmed;
 
-  await store.sendMessage(myHandle, them, finalMessage || null, 'dm', payload);
+  // Send typing indicator (shows "typing..." to recipient while message is being sent)
+  // Non-blocking - we don't wait for this
+  store.sendTypingIndicator(myHandle, them).catch(() => {});
+
+  const result = await store.sendMessage(myHandle, them, finalMessage || null, 'dm', finalPayload, {
+    replyTo: reply_to || null,
+  });
+
+  // Check for errors
+  if (result && result.error) {
+    return {
+      display: `❌ **Failed to send message**\n\n${result.message}\n\n_Please try again. If the problem persists, check your connection._`
+    };
+  }
 
   // Log social pattern (quietly, in background)
   patterns.logMessageSent(them);
@@ -156,13 +135,56 @@ Make sure ${platform} is configured:
     display += ` ${warning(`truncated to ${MAX_LENGTH} chars`)}`;
   }
 
-  // Show message preview or payload type
-  if (finalMessage) {
-    display += `\n\n"${truncate(finalMessage, 100)}"`;
+  // Only show payload type indicator (message already visible in tool call)
+  if (finalPayload) {
+    const payloadType = finalPayload.type || 'data';
+    if (payloadType === 'artifact') {
+      const icon = finalPayload.template === 'guide' ? '📘' : finalPayload.template === 'learning' ? '💡' : finalPayload.template === 'workspace' ? '🗂️' : '📦';
+      display += `\n\n${icon} _Shared artifact: ${finalPayload.title}_`;
+    } else {
+      display += `\n\n📦 _Includes ${payloadType} payload_`;
+    }
   }
-  if (payload) {
-    const payloadType = payload.type || 'data';
-    display += `\n\n📦 _Includes ${payloadType} payload_`;
+
+  // Execute attached tip if specified
+  let tipResult = null;
+  if (tip_amount_cents && tip_amount_cents > 0) {
+    const token = config.getToken();
+    if (token) {
+      try {
+        const apiUrl = config.getApiUrl();
+        // Generate idempotency key to prevent duplicate tips from retries
+        const timeBucket = Math.floor(Date.now() / 60000);
+        const tipIdempotencyKey = `dm:${myHandle}:${them}:${tip_amount_cents}:${timeBucket}`;
+
+        const tipResponse = await fetch(`${apiUrl}/api/tips/instant`, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${token}`,
+            'Idempotency-Key': tipIdempotencyKey
+          },
+          body: JSON.stringify({
+            to: them,
+            amount_cents: tip_amount_cents,
+            message: message ? `${message.substring(0, 50)}...` : null,
+            context: { type: 'dm_reply' }
+          })
+        });
+
+        tipResult = await tipResponse.json();
+
+        if (tipResult.success) {
+          const tipAmount = (tip_amount_cents / 100).toFixed(0);
+          display += `\n\n💸 _Tipped $${tipAmount} USDC — [view tx](${tipResult.explorer_url})_`;
+        } else {
+          display += `\n\n⚠️ _Tip failed: ${tipResult.message || 'Unknown error'}_`;
+        }
+      } catch (tipError) {
+        console.warn('[dm] Tip execution failed:', tipError.message);
+        display += `\n\n⚠️ _Tip failed: ${tipError.message}_`;
+      }
+    }
   }
 
   // Burst notification (5+ messages in one thread)
@@ -192,6 +214,26 @@ Make sure ${platform} is configured:
   // Add guided mode actions
   response.actions = formatActions(actions.afterDm(them));
 
+  // Fetch DM suggestions (async, non-blocking for response)
+  // This adds "You might want to message..." suggestions
+  try {
+    const suggestions = await fetchRelevantUsers(myHandle, 'dm_suggest', 3);
+    if (suggestions && suggestions.matches && suggestions.matches.length > 0) {
+      // Filter out the person we just messaged
+      const others = suggestions.matches.filter(m => m.handle !== them);
+      if (others.length > 0) {
+        response.dm_suggestions = others.map(m => ({
+          handle: m.handle,
+          building: m.building,
+          reasons: m.reasons?.slice(0, 2) || []
+        }));
+      }
+    }
+  } catch (e) {
+    // Don't fail DM if suggestions fail
+    console.log('[dm] dm_suggest fetch error:', e.message);
+  }
+
   return response;
 }
 

package/tools/drawing.js

@@ -86,7 +86,7 @@ async function saveDrawingState(room, state) {
  * Post drawing activity to board
  */
 async function postDrawingActivity(action, room, player, details = '') {
-  const API_URL = process.env.VIBE_API_URL || 'https://slashvibe.dev';
+  const API_URL = process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
 
   try {
     let content;

package/tools/earnings.js

@@ -0,0 +1,126 @@
+/**
+ * vibe_earnings - View unified earnings dashboard
+ *
+ * Shows all revenue sources aggregated:
+ * - Artifact sales
+ * - Session PPV revenue
+ * - Subscription revenue
+ * - Gig completions
+ * - Tips received
+ * - On-chain balance
+ *
+ * Examples:
+ * - "vibe earnings"
+ * - "show my earnings"
+ * - "how much have I made"
+ */
+
+const fetch = require('node-fetch');
+const config = require('../config');
+
+const definition = {
+  name: 'vibe_earnings',
+  description: 'View your unified earnings dashboard - artifact sales, session PPV, subscriptions, gigs, tips, and on-chain balance.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      handle: {
+        type: 'string',
+        description: 'Handle to check earnings for (defaults to your handle)'
+      }
+    }
+  }
+};
+
+async function handler(args) {
+  const { handle } = args;
+
+  if (!config.isInitialized()) {
+    return {
+      display: 'Run `vibe init` first to set your identity.'
+    };
+  }
+
+  const targetHandle = handle || config.getHandle();
+  const apiUrl = process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
+  const token = config.getToken();
+
+  try {
+    const response = await fetch(
+      `${apiUrl}/api/earnings?handle=${encodeURIComponent(targetHandle)}`,
+      {
+        headers: token ? {
+          'Authorization': `Bearer ${token}`
+        } : {}
+      }
+    );
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      return {
+        display: `❌ ${result.error || 'Failed to fetch earnings'}`
+      };
+    }
+
+    const { earnings, total_earned_display, pending_display, on_chain } = result;
+
+    let formatted = `
+┌────────────────────────────────────────────────────────────┐
+│                    💰 EARNINGS DASHBOARD                   │
+│                       @${targetHandle.padEnd(33)}│
+├────────────────────────────────────────────────────────────┤
+│                                                            │
+│  Total Earned: ${(total_earned_display || '$0').padEnd(40)} │
+│  Pending (On-chain): ${(pending_display || '$0').padEnd(34)} │
+│                                                            │
+├────────────────────────────────────────────────────────────┤
+│  📊 Breakdown by Source:                                   │
+│                                                            │
+│  Artifacts:  ${(earnings.artifacts.revenue_display || '$0').padEnd(15)} (${earnings.artifacts.sales || 0} sales)${' '.repeat(17)} │
+│  Sessions:   ${(earnings.sessions.revenue_display || '$0').padEnd(15)} (${earnings.sessions.ppv_sales || 0} PPV)${' '.repeat(18)} │
+│  Gigs:       ${(earnings.gigs.revenue_display || '$0').padEnd(15)} (${earnings.gigs.completed || 0} completed)${' '.repeat(12)} │
+│  Tips:       ${(earnings.tips.revenue_display || '$0').padEnd(15)} (${earnings.tips.received || 0} received)${' '.repeat(13)} │
+│                                                            │
+`.trim();
+
+    if (on_chain) {
+      formatted += `
+├────────────────────────────────────────────────────────────┤
+│  ⛓️ On-Chain Status:                                       │`;
+
+      if (on_chain.registered) {
+        const walletDisplay = on_chain.wallet
+          ? `${on_chain.wallet.slice(0, 10)}...${on_chain.wallet.slice(-8)}`
+          : 'not set';
+        formatted += `
+│                                                            │
+│  Registered: Yes                                           │
+│  Wallet: ${walletDisplay.padEnd(47)} │
+│  Balance: ${(on_chain.balance_eth + ' ETH').padEnd(46)} │`;
+        if (on_chain.can_withdraw) {
+          formatted += `
+│  ✅ Ready to withdraw                                       │`;
+        }
+      } else {
+        formatted += `
+│                                                            │
+│  Registered: No                                            │
+│  ⚠️ Register to receive payments: vibe register_onchain    │`;
+      }
+    }
+
+    formatted += `
+│                                                            │
+└────────────────────────────────────────────────────────────┘`;
+
+    return { display: formatted, data: result };
+
+  } catch (error) {
+    return {
+      display: `❌ Failed to fetch earnings: ${error.message}`
+    };
+  }
+}
+
+module.exports = { definition, handler };

package/tools/echo.js

@@ -12,6 +12,7 @@
 
 const config = require('../config');
 const { formatTimeAgo, requireInit } = require('./_shared');
+const store = require('../store');
 
 const API_URL = process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
 
@@ -186,6 +187,21 @@ async function handler(args) {
     return { display };
   }
 
+  // Track feedback for onboarding checklist
+  try {
+    await fetch(`${API_URL}/api/onboarding/checklist`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        handle: myHandle,
+        taskId: 'leave_feedback',
+        metadata: { anonymous }
+      })
+    });
+  } catch (e) {
+    // Non-critical, continue
+  }
+
   if (anonymous) {
     display += pickRandom(responses.receivedAnon);
   } else {

package/tools/feed.js

@@ -13,7 +13,8 @@
  */
 
 const config = require('../config');
-const { requireInit, header, emptyState, formatTimeAgo, divider } = require('./_shared');
+const { requireInit, header, emptyState, formatTimeAgo, divider, fetchRelevantUsers } = require('./_shared');
+const { actions, formatActions } = require('./_actions');
 
 const definition = {
   name: 'vibe_feed',
@@ -23,7 +24,7 @@ const definition = {
     properties: {
       filter: {
         type: 'string',
-        enum: ['all', 'ideas', 'ships', 'requests', 'riffs'],
+        enum: ['all', 'ideas', 'ships', 'requests', 'riffs', 'observations'],
         description: 'Filter by type (default: all)'
       },
       from: {
@@ -48,6 +49,7 @@ const TYPE_CONFIG = {
   'shipped': { emoji: '🚀', label: 'ship', verb: 'shipped' },
   'request': { emoji: '🔓', label: 'request', verb: 'requested' },
   'claim': { emoji: '🔨', label: 'claim', verb: 'claimed' },
+  'observation': { emoji: '👁️', label: 'observation', verb: 'observed' },
   'general': { emoji: '📝', label: 'post', verb: 'posted' }
 };
 
@@ -55,7 +57,8 @@ const CATEGORY_MAP = {
   'ideas': ['idea', 'riff'],
   'ships': ['shipped'],
   'requests': ['request', 'claim'],
-  'riffs': ['riff']
+  'riffs': ['riff'],
+  'observations': ['observation']
 };
 
 async function handler(args) {
@@ -98,8 +101,27 @@ async function handler(args) {
       );
     }
 
-    // Sort by timestamp (newest first)
-    entries.sort((a, b) => b.timestamp - a.timestamp);
+    // Fetch relevant users to personalize feed
+    // Content from relevant users gets a time boost (appears more recent)
+    const relevantHandles = new Set();
+    try {
+      const relevancy = await fetchRelevantUsers(myHandle, 'feed', 20);
+      if (relevancy && relevancy.matches) {
+        relevancy.matches.forEach(m => relevantHandles.add(m.handle.toLowerCase()));
+      }
+    } catch (e) {
+      // Don't fail feed if relevancy fails
+      console.log('[feed] relevancy fetch error:', e.message);
+    }
+
+    // Sort by timestamp with relevancy boost
+    // Relevant users get a 6-hour boost (their content appears "more recent")
+    const RELEVANCY_BOOST_MS = 6 * 60 * 60 * 1000; // 6 hours in ms
+    entries.sort((a, b) => {
+      const aBoost = relevantHandles.has(a.author.toLowerCase()) ? RELEVANCY_BOOST_MS : 0;
+      const bBoost = relevantHandles.has(b.author.toLowerCase()) ? RELEVANCY_BOOST_MS : 0;
+      return (b.timestamp + bBoost) - (a.timestamp + aBoost);
+    });
 
     // Limit
     entries = entries.slice(0, limit);
@@ -163,17 +185,39 @@ async function handler(args) {
       // Tags (non-system ones)
       if (entry.tags && entry.tags.length > 0) {
         const visibleTags = entry.tags
-          .filter(t => !t.startsWith('inspired:') && !t.startsWith('fulfills:') && !t.startsWith('riff:') && !t.startsWith('claim:'))
+          .filter(t => !t.startsWith('inspired:') && !t.startsWith('fulfills:') && !t.startsWith('riff:') && !t.startsWith('claim:') && !t.startsWith('observation:') && !t.startsWith('type:'))
           .slice(0, 3);
         if (visibleTags.length > 0) {
           display += `   ${visibleTags.map(t => `#${t}`).join(' ')}\n`;
         }
       }
 
+      // Observation metadata
+      if (entry.category === 'observation' && entry.metadata?.observation_type) {
+        display += `   _type: ${entry.metadata.observation_type}_\n`;
+      }
+
+      // ASCII art (if present)
+      if (entry.metadata?.ascii_art) {
+        display += `\n${entry.metadata.ascii_art}\n`;
+        display += `   📊 _includes visualization_\n`;
+      }
+
       display += `   _${timeAgo}_\n\n`;
     });
 
-    return { display };
+    // Build response with tip actions if we have ships
+    const response = { display };
+
+    // Find the most recent ship to offer tip action for
+    const recentShip = entries.find(e => e.category === 'shipped');
+    if (recentShip && recentShip.author.toLowerCase() !== myHandle.toLowerCase()) {
+      response.actions = formatActions(actions.afterShipView(recentShip));
+      response.hint = 'tip_ship_available';
+      response.ship_author = recentShip.author;
+    }
+
+    return response;
 
   } catch (error) {
     return { display: `⚠️ Failed to load feed: ${error.message}` };