slashvibe-mcp 0.3.21 → 0.3.22

package/protocol/index.js

@@ -34,7 +34,7 @@ const PROTOCOL_VERSION = '0.1.0';
 const GAME_SCHEMA = {
   type: 'game',
   required: ['game', 'state'],
-  validate: (payload) => {
+  validate: payload => {
     if (!payload.game || typeof payload.game !== 'string') {
       return { valid: false, error: 'Missing or invalid game name' };
     }
@@ -65,7 +65,7 @@ const GAME_SCHEMA = {
 const HANDOFF_SCHEMA = {
   type: 'handoff',
   required: ['task', 'context'],
-  validate: (payload) => {
+  validate: payload => {
     if (!payload.task || typeof payload.task !== 'string') {
       return { valid: false, error: 'Missing or invalid task type' };
     }
@@ -90,7 +90,7 @@ const HANDOFF_SCHEMA = {
 const ACK_SCHEMA = {
   type: 'ack',
   required: ['replyTo', 'status'],
-  validate: (payload) => {
+  validate: payload => {
     if (!payload.replyTo || typeof payload.replyTo !== 'string') {
       return { valid: false, error: 'Missing or invalid replyTo' };
     }
@@ -119,7 +119,7 @@ const ACK_SCHEMA = {
 const ARTIFACT_SCHEMA = {
   type: 'artifact',
   required: ['artifactId', 'slug', 'title', 'template', 'url'],
-  validate: (payload) => {
+  validate: payload => {
     if (!payload.artifactId || typeof payload.artifactId !== 'string') {
       return { valid: false, error: 'Missing or invalid artifactId' };
     }
@@ -139,11 +139,56 @@ const ARTIFACT_SCHEMA = {
   }
 };
 
+/**
+ * Agent wire schema — For agent-to-agent communication on the wire
+ *
+ * Used when external agents (Clawdbot, @seth) communicate via /vibe.
+ * AIRC-signed for identity verification.
+ *
+ * Example:
+ * {
+ *   type: 'agent',
+ *   version: '0.1.0',
+ *   action: 'session_sync',
+ *   idempotencyKey: 'agent_seth_session_abc',
+ *   source: { platform: 'telegram', gateway: 'clawdbot' },
+ *   context: {
+ *     session: 'NODE logistics',
+ *     mood: 'shipping',
+ *     file: 'node365/submit/page.tsx'
+ *   }
+ * }
+ */
+const AGENT_SCHEMA = {
+  type: 'agent',
+  required: ['action'],
+  validate: payload => {
+    if (!payload.action || typeof payload.action !== 'string') {
+      return { valid: false, error: 'Missing or invalid action' };
+    }
+    const validActions = [
+      'session_sync',   // Sync session state to /vibe presence
+      'event_subscribe', // Subscribe to event pushes
+      'memory_query',   // Query local memory
+      'memory_store',   // Store observation
+      'identity_verify', // AIRC identity verification
+      'heartbeat',      // Agent heartbeat
+      'capability_announce' // Announce agent capabilities
+    ];
+    // Allow unknown actions for forward compat
+    if (!validActions.includes(payload.action)) {
+      return { valid: true, unknown_action: true };
+    }
+    return { valid: true };
+  }
+};
+
 const SCHEMAS = {
   game: GAME_SCHEMA,
   handoff: HANDOFF_SCHEMA,
   ack: ACK_SCHEMA,
-  artifact: ARTIFACT_SCHEMA
+  artifact: ARTIFACT_SCHEMA,
+  agent: AGENT_SCHEMA
 };
 
 // ============ PROTOCOL FUNCTIONS ============
@@ -230,10 +275,14 @@ function generateIdempotencyKey(prefix, context = '') {
  * @returns {Object} - Game payload
  */
 function createGamePayload(game, state, options = {}) {
-  return createPayload('game', { game, state }, {
-    idempotencyKey: options.idempotencyKey || generateIdempotencyKey('game', game),
-    ...options
-  });
+  return createPayload(
+    'game',
+    { game, state },
+    {
+      idempotencyKey: options.idempotencyKey || generateIdempotencyKey('game', game),
+      ...options
+    }
+  );
 }
 
 /**
@@ -263,10 +312,14 @@ function createTicTacToePayload(board, turn, moves, winner = null) {
  * @returns {Object} - Handoff payload
  */
 function createHandoffPayload(task, context, options = {}) {
-  return createPayload('handoff', { task, context }, {
-    idempotencyKey: options.idempotencyKey || generateIdempotencyKey('handoff', task),
-    ...options
-  });
+  return createPayload(
+    'handoff',
+    { task, context },
+    {
+      idempotencyKey: options.idempotencyKey || generateIdempotencyKey('handoff', task),
+      ...options
+    }
+  );
 }
 
 // ============ ACK HELPERS ============
@@ -307,8 +360,8 @@ function formatPayload(payload) {
       return formatAckPayload(payload);
     case 'artifact':
       return formatArtifactPayload(payload);
-    case 'code':
-      return formatCodePayload(payload);
+    case 'agent':
+      return formatAgentPayload(payload);
     default:
       return `📦 _${payload.type} payload_`;
   }
@@ -320,7 +373,7 @@ function formatGamePayload(payload) {
 
   if (game === 'tictactoe' && state.board) {
     const b = state.board;
-    const cell = (i) => b[i] || '·';
+    const cell = i => b[i] || '·';
     return `🎮 **Tic-Tac-Toe** (move ${state.moves || '?'})
 \`\`\`
  ${cell(0)} │ ${cell(1)} │ ${cell(2)}
@@ -359,77 +412,10 @@ function formatAckPayload(payload) {
   return `${icon} Acknowledged: ${payload.replyTo} (${status})`;
 }
 
-/**
- * Format a code snippet payload for display
- */
-function formatCodePayload(payload) {
-  const lang = payload.language || '';
-  const filename = payload.filename || null;
-  const code = payload.code || '';
-  const description = payload.description || null;
-
-  let display = '📝 **Code Snippet**';
-  if (filename) {
-    display += ` — \`${filename}\``;
-  }
-  if (lang) {
-    display += ` (${lang})`;
-  }
-  display += '\n';
-
-  if (description) {
-    display += `> ${description}\n`;
-  }
-
-  display += `\`\`\`${lang}\n${code}\n\`\`\``;
-
-  return display;
-}
-
-/**
- * Create a code snippet payload
- * @param {string} code - The code content
- * @param {object} options - Options
- * @param {string} [options.language] - Programming language
- * @param {string} [options.filename] - Original filename
- * @param {string} [options.description] - Brief description
- */
-function createCodePayload(code, options = {}) {
-  return {
-    type: 'code',
-    version: PROTOCOL_VERSION,
-    code,
-    language: options.language || detectLanguage(code),
-    filename: options.filename || null,
-    description: options.description || null,
-  };
-}
-
-/**
- * Simple language detection based on content patterns
- */
-function detectLanguage(code) {
-  if (!code) return '';
-
-  // Check for common patterns
-  if (code.includes('import React') || code.includes('useState') || code.includes('useEffect')) return 'jsx';
-  if (code.includes('import ') && code.includes(' from ')) return 'javascript';
-  if (code.includes('async function') || code.includes('await ')) return 'javascript';
-  if (code.includes('def ') && code.includes(':')) return 'python';
-  if (code.includes('func ') && code.includes('()')) return 'go';
-  if (code.includes('fn ') && code.includes('->')) return 'rust';
-  if (code.includes('SELECT ') || code.includes('INSERT INTO')) return 'sql';
-  if (code.includes('<!DOCTYPE') || code.includes('<html')) return 'html';
-  if (code.includes('{') && code.includes(':') && code.includes(';')) return 'css';
-  if (code.startsWith('{') && code.endsWith('}')) return 'json';
-  if (code.startsWith('#!') && code.includes('/bin/')) return 'bash';
-
-  return '';
-}
-
 function formatArtifactPayload(payload) {
   const template = payload.template || 'artifact';
-  const templateIcon = template === 'guide' ? '📘' : template === 'learning' ? '💡' : template === 'workspace' ? '🗂️' : '📦';
+  const templateIcon =
+    template === 'guide' ? '📘' : template === 'learning' ? '💡' : template === 'workspace' ? '🗂️' : '📦';
 
   let display = `${templateIcon} **${payload.title}**\n`;
 
@@ -470,6 +456,56 @@ function createArtifactPayload(artifact) {
   });
 }
 
+// ============ AGENT HELPERS ============
+
+/**
+ * Create an agent wire payload
+ * @param {string} action - Agent action (session_sync, event_subscribe, etc.)
+ * @param {object} data - Action-specific data
+ * @param {object} [options] - Options (idempotencyKey, source)
+ * @returns {object} - Agent payload
+ */
+function createAgentPayload(action, data = {}, options = {}) {
+  const payload = {
+    action,
+    ...data
+  };
+
+  if (options.source) {
+    payload.source = options.source;
+  }
+
+  return createPayload('agent', payload, {
+    idempotencyKey: options.idempotencyKey || generateIdempotencyKey('agent', action),
+    ...options
+  });
+}
+
+/**
+ * Format agent payload for display
+ */
+function formatAgentPayload(payload) {
+  const action = payload.action || 'unknown';
+  const source = payload.source
+    ? ` (via ${payload.source.platform || payload.source.gateway || 'unknown'})`
+    : '';
+
+  switch (action) {
+    case 'session_sync':
+      return `🤖 **Session sync**${source}\n> ${payload.context?.session || 'active'}`;
+    case 'event_subscribe':
+      return `🔔 **Event subscription**${source}\n> ${(payload.events || []).join(', ')}`;
+    case 'heartbeat':
+      return `💓 **Agent heartbeat**${source}`;
+    case 'identity_verify':
+      return `🔑 **Identity verification**${source}`;
+    case 'capability_announce':
+      return `📡 **Capabilities**${source}\n> ${(payload.capabilities || []).join(', ')}`;
+    default:
+      return `🤖 **Agent: ${action}**${source}`;
+  }
+}
+
 module.exports = {
   PROTOCOL_VERSION,
 
@@ -492,8 +528,8 @@ module.exports = {
   // Artifact helpers
   createArtifactPayload,
 
-  // Code helpers
-  createCodePayload,
+  // Agent helpers
+  createAgentPayload,
 
   // Schemas (for extension)
   SCHEMAS

package/protocol/telegram-commands.js

@@ -1,12 +1,12 @@
 /**
  * /vibe Telegram Command Processor
- * 
+ *
  * Executes /vibe commands received via Telegram bot.
  * Maps Telegram users to /vibe handles and executes core protocol functions.
  */
 
 const { dm } = require('../tools/dm');
-const { status } = require('../tools/status'); 
+const { status } = require('../tools/status');
 const { who } = require('../tools/who');
 const { ship } = require('../tools/ship');
 const config = require('../config');
@@ -17,7 +17,7 @@ const config = require('../config');
 async function processVibeCommand(command, params, telegramUser) {
   // Map Telegram user to /vibe handle
   const vibeHandle = mapTelegramUserToHandle(telegramUser);
-  
+
   if (!vibeHandle) {
     return `❌ Telegram account not linked to /vibe. Contact admin to link @${telegramUser.username || telegramUser.first_name} to a /vibe handle.`;
   }
@@ -26,20 +26,19 @@ async function processVibeCommand(command, params, telegramUser) {
     switch (command) {
       case 'status':
         return await executeStatus(params.mood, params.note, vibeHandle);
-        
+
       case 'who':
         return await executeWho();
-        
+
       case 'ship':
         return await executeShip(params.message, vibeHandle);
-        
+
       case 'dm':
         return await executeDM(params.handle, params.message, vibeHandle);
-        
+
       default:
         return `❌ Unknown command: ${command}`;
     }
-    
   } catch (error) {
     console.error(`Telegram command error [${command}]:`, error);
     return `❌ Command failed: ${error.message}`;
@@ -52,7 +51,7 @@ async function processVibeCommand(command, params, telegramUser) {
 function mapTelegramUserToHandle(telegramUser) {
   const cfg = config.load();
   const telegramMappings = cfg.telegram_user_mappings || {};
-  
+
   // Try username first, then user ID
   const telegramKey = telegramUser.username || telegramUser.id.toString();
   return telegramMappings[telegramKey] || null;
@@ -65,19 +64,19 @@ async function executeStatus(mood, note, handle) {
   if (!mood) {
     return '❌ Need a mood. Try: `/status shipping "building the future"`';
   }
-  
+
   const validMoods = ['shipping', 'debugging', 'deep', 'afk', 'celebrating', 'pairing'];
   if (!validMoods.includes(mood)) {
     return `❌ Invalid mood. Use: ${validMoods.join(', ')}`;
   }
-  
+
   // Execute the status update
   const result = await status.handler({ mood, note });
-  
+
   if (result.error) {
     return `❌ ${result.error}`;
   }
-  
+
   return `✅ Status updated: **${handle}** is ${mood}${note ? ` - "${note}"` : ''}`;
 }
 
@@ -86,33 +85,33 @@ async function executeStatus(mood, note, handle) {
  */
 async function executeWho() {
   const result = await who.handler({});
-  
+
   if (result.error) {
     return `❌ ${result.error}`;
   }
-  
+
   // Convert display format to Telegram-friendly
   let response = result.display;
-  
+
   // Replace markdown formatting for Telegram
   response = response
     .replace(/\*\*(.*?)\*\*/g, '*$1*') // Bold
-    .replace(/_(.*?)_/g, '_$1_')       // Italic
-    .replace(/`(.*?)`/g, '`$1`');       // Code
-    
+    .replace(/_(.*?)_/g, '_$1_') // Italic
+    .replace(/`(.*?)`/g, '`$1`'); // Code
+
   return response;
 }
 
 /**
- * Execute ship command  
+ * Execute ship command
  */
 async function executeShip(message, handle) {
   const result = await ship.handler({ what: message });
-  
+
   if (result.error) {
     return `❌ ${result.error}`;
   }
-  
+
   return `🚀 Shipped! ${message ? `"${message}"` : 'Great work!'} has been announced to /vibe.`;
 }
 
@@ -123,23 +122,23 @@ async function executeDM(targetHandle, message, fromHandle) {
   if (!targetHandle) {
     return '❌ Need target handle. Try: `/dm @alice "hey there!"`';
   }
-  
+
   if (!message) {
     return '❌ Need message content.';
   }
-  
+
   // Remove @ if present
   const cleanHandle = targetHandle.replace('@', '');
-  
-  const result = await dm.handler({ 
-    to: cleanHandle, 
-    message: message 
+
+  const result = await dm.handler({
+    to: cleanHandle,
+    message: message
   });
-  
+
   if (result.error) {
     return `❌ ${result.error}`;
   }
-  
+
   return `📨 DM sent to @${cleanHandle}: "${message}"`;
 }
 
@@ -148,19 +147,19 @@ async function executeDM(targetHandle, message, fromHandle) {
  */
 async function linkTelegramUser(telegramUser, vibeHandle) {
   const cfg = config.load();
-  
+
   if (!cfg.telegram_user_mappings) {
     cfg.telegram_user_mappings = {};
   }
-  
+
   // Store both username and ID for flexibility
   if (telegramUser.username) {
     cfg.telegram_user_mappings[telegramUser.username] = vibeHandle;
   }
   cfg.telegram_user_mappings[telegramUser.id.toString()] = vibeHandle;
-  
+
   config.save(cfg);
-  
+
   return {
     success: true,
     message: `Linked Telegram user ${telegramUser.username || telegramUser.id} to /vibe handle @${vibeHandle}`
@@ -180,13 +179,13 @@ function getTelegramMappings() {
  */
 function unlinkTelegramUser(telegramKey) {
   const cfg = config.load();
-  
+
   if (cfg.telegram_user_mappings && cfg.telegram_user_mappings[telegramKey]) {
     delete cfg.telegram_user_mappings[telegramKey];
     config.save(cfg);
     return { success: true, message: `Unlinked ${telegramKey}` };
   }
-  
+
   return { success: false, message: `No mapping found for ${telegramKey}` };
 }
 
@@ -196,4 +195,4 @@ module.exports = {
   unlinkTelegramUser,
   getTelegramMappings,
   mapTelegramUserToHandle
-};
+};