slashvibe-mcp 0.2.2 → 0.2.3

package/tools/notifications.js

@@ -0,0 +1,415 @@
+/**
+ * vibe notifications — Configure external notification channels
+ *
+ * Manage where you receive DM alerts: Telegram, Discord, Slack, or webhooks.
+ *
+ * Usage:
+ * - vibe notifications              → View current configuration
+ * - vibe notifications add telegram → Start Telegram linking flow
+ * - vibe notifications test         → Send test notification
+ * - vibe notifications disable      → Disable notifications
+ * - vibe notifications enable       → Re-enable notifications
+ */
+
+const config = require('../config');
+const api = require('../store/api');
+
+const definition = {
+  name: 'vibe_notifications',
+  description: 'Configure external notification channels (Telegram, Discord, etc.) for DM alerts.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      action: {
+        type: 'string',
+        enum: ['view', 'add', 'test', 'enable', 'disable', 'remove', 'verify'],
+        description: 'Action to perform (default: view)'
+      },
+      channel: {
+        type: 'string',
+        enum: ['telegram', 'discord', 'slack', 'webhook'],
+        description: 'Channel type for add/remove actions'
+      },
+      code: {
+        type: 'string',
+        description: 'Verification code for Telegram linking'
+      },
+      chat_id: {
+        type: 'string',
+        description: 'Telegram chat ID (provided by bot after /link command)'
+      }
+    }
+  }
+};
+
+async function handler(args) {
+  const handle = config.getHandle();
+  if (!handle) {
+    return {
+      display: '❌ Not logged in. Run `vibe init` first.'
+    };
+  }
+
+  const action = args.action || 'view';
+
+  // ─────────────────────────────────────────────────────────
+  // VIEW - Show current configuration
+  // ─────────────────────────────────────────────────────────
+  if (action === 'view') {
+    try {
+      const result = await api.request('GET', `/api/settings/notifications?handle=${handle}`);
+
+      if (!result.success) {
+        return {
+          display: `❌ Failed to get notification settings: ${result.error}`
+        };
+      }
+
+      const prefs = result.preferences;
+      const channels = prefs.channels || [];
+
+      // Build display
+      let display = '## 🔔 Notification Settings\n\n';
+
+      if (channels.length === 0) {
+        display += '**No notification channels configured.**\n\n';
+        display += 'Add a channel to receive DM alerts outside Claude Code:\n\n';
+        display += '```\nvibe notifications add telegram\n```\n\n';
+
+        if (result.telegram_available) {
+          display += '_Telegram is available and recommended for mobile notifications._\n';
+        }
+      } else {
+        display += '**Active Channels:**\n\n';
+
+        for (const ch of channels) {
+          const status = ch.enabled
+            ? (ch.verified ? '✅' : '⚠️ Unverified')
+            : '⏸️ Disabled';
+
+          display += `• **${ch.name}** (${ch.type})\n`;
+          display += `  Status: ${status}\n`;
+          if (ch.lastUsedAt) {
+            display += `  Last notification: ${timeAgo(ch.lastUsedAt)}\n`;
+          }
+          display += '\n';
+        }
+
+        display += '---\n\n';
+        display += '**Commands:**\n';
+        display += '• `vibe notifications test` — Send test notification\n';
+        display += '• `vibe notifications disable` — Pause notifications\n';
+        display += '• `vibe notifications remove telegram` — Remove channel\n';
+      }
+
+      // Show filter settings
+      display += '\n---\n\n';
+      display += '**Filter Mode:** ' + (prefs.filters?.mode || 'all') + '\n';
+      const modeDesc = {
+        all: '_Notify for all DMs_',
+        mentions: '_Only notify when mentioned_',
+        selected: '_Only notify from allow list_'
+      };
+      display += modeDesc[prefs.filters?.mode || 'all'] + '\n';
+
+      return { display };
+
+    } catch (e) {
+      return {
+        display: `❌ Error: ${e.message}`
+      };
+    }
+  }
+
+  // ─────────────────────────────────────────────────────────
+  // ADD - Add a new notification channel
+  // ─────────────────────────────────────────────────────────
+  if (action === 'add') {
+    const channel = args.channel;
+
+    if (!channel) {
+      return {
+        display: '## Add Notification Channel\n\n' +
+          'Choose a channel type:\n\n' +
+          '• `vibe notifications add telegram` — Mobile-friendly, recommended\n' +
+          '• `vibe notifications add discord` — Discord webhook\n' +
+          '• `vibe notifications add slack` — Slack webhook\n' +
+          '• `vibe notifications add webhook` — Generic webhook (Zapier, n8n, etc.)\n'
+      };
+    }
+
+    if (channel === 'telegram') {
+      // Start Telegram linking flow
+      try {
+        const result = await api.request('POST', '/api/settings/notifications', {
+          action: 'link_telegram'
+        }, {
+          headers: { 'Authorization': `Bearer ${token}` }
+        });
+
+        if (!result.success) {
+          return {
+            display: `❌ Failed to start Telegram linking: ${result.error}`
+          };
+        }
+
+        return {
+          display: '## 📱 Link Telegram\n\n' +
+            '**Step 1:** Open Telegram and find **@vibecodings_bot**\n\n' +
+            '**Step 2:** Send this command to the bot:\n\n' +
+            '```\n/link ' + result.code + '\n```\n\n' +
+            '**Step 3:** The bot will confirm and you\'ll start receiving notifications!\n\n' +
+            '_Code expires in 10 minutes._\n\n' +
+            '---\n\n' +
+            'After linking, run `vibe notifications` to verify it worked.'
+        };
+
+      } catch (e) {
+        return {
+          display: `❌ Error: ${e.message}`
+        };
+      }
+    }
+
+    // Discord/Slack/Webhook - show instructions
+    if (channel === 'discord') {
+      return {
+        display: '## Add Discord Webhook\n\n' +
+          '**Step 1:** In Discord, go to Server Settings → Integrations → Webhooks\n\n' +
+          '**Step 2:** Create a new webhook and copy the URL\n\n' +
+          '**Step 3:** Run:\n\n' +
+          '```\ncurl -X POST "https://www.slashvibe.dev/api/settings/notifications" \\\n' +
+          '  -H "Authorization: Bearer YOUR_TOKEN" \\\n' +
+          '  -H "Content-Type: application/json" \\\n' +
+          '  -d \'{"action":"add_channel","type":"discord_webhook","config":{"webhookUrl":"YOUR_URL"}}\'\n```\n\n' +
+          '_Discord webhook support coming to this CLI soon!_'
+      };
+    }
+
+    if (channel === 'slack') {
+      return {
+        display: '## Add Slack Webhook\n\n' +
+          '**Step 1:** Go to api.slack.com/apps and create an app\n\n' +
+          '**Step 2:** Enable Incoming Webhooks and create one for your channel\n\n' +
+          '**Step 3:** Copy the webhook URL and add via API\n\n' +
+          '_Slack webhook support coming to this CLI soon!_'
+      };
+    }
+
+    return {
+      display: `❌ Unknown channel type: ${channel}\n\n` +
+        'Valid types: telegram, discord, slack, webhook'
+    };
+  }
+
+  // ─────────────────────────────────────────────────────────
+  // VERIFY - Complete Telegram verification (called by webhook)
+  // ─────────────────────────────────────────────────────────
+  if (action === 'verify') {
+    const { code, chat_id } = args;
+
+    if (!code || !chat_id) {
+      return {
+        display: '❌ Code and chat_id are required for verification'
+      };
+    }
+
+    try {
+      const result = await api.request('POST', '/api/settings/notifications', {
+        action: 'verify_telegram',
+        code,
+        chat_id
+      });
+
+      if (!result.success) {
+        return {
+          display: `❌ Verification failed: ${result.error}`
+        };
+      }
+
+      return {
+        display: '## ✅ Telegram Linked!\n\n' +
+          'You\'ll now receive DM notifications on Telegram.\n\n' +
+          'Test it by having someone message you, or run:\n\n' +
+          '```\nvibe notifications test\n```'
+      };
+
+    } catch (e) {
+      return {
+        display: `❌ Error: ${e.message}`
+      };
+    }
+  }
+
+  // ─────────────────────────────────────────────────────────
+  // TEST - Send a test notification
+  // ─────────────────────────────────────────────────────────
+  if (action === 'test') {
+    try {
+      // First get channels to find one to test
+      const prefs = await api.request('GET', `/api/settings/notifications?handle=${handle}`, null);
+
+      if (!prefs.success || !prefs.preferences.channels?.length) {
+        return {
+          display: '❌ No notification channels configured.\n\n' +
+            'Add one first: `vibe notifications add telegram`'
+        };
+      }
+
+      // Test the first enabled channel
+      const channel = prefs.preferences.channels.find(ch => ch.enabled);
+      if (!channel) {
+        return {
+          display: '❌ All channels are disabled.\n\n' +
+            'Enable one: `vibe notifications enable`'
+        };
+      }
+
+      const result = await api.request('POST', '/api/settings/notifications', {
+        action: 'test_channel',
+        channel_id: channel.id
+      });
+
+      if (!result.success) {
+        return {
+          display: `❌ Test failed: ${result.error}\n\n` +
+            (result.failCount ? `Fail count: ${result.failCount}/5` : '') +
+            (result.disabled ? '\n\n⚠️ Channel has been auto-disabled due to repeated failures.' : '')
+        };
+      }
+
+      return {
+        display: '## ✅ Test Notification Sent!\n\n' +
+          `Channel: **${channel.name}** (${channel.type})\n\n` +
+          'Check your ' + channel.type + ' for the test message.'
+      };
+
+    } catch (e) {
+      return {
+        display: `❌ Error: ${e.message}`
+      };
+    }
+  }
+
+  // ─────────────────────────────────────────────────────────
+  // ENABLE/DISABLE - Toggle notifications
+  // ─────────────────────────────────────────────────────────
+  if (action === 'enable' || action === 'disable') {
+    try {
+      const prefs = await api.request('GET', `/api/settings/notifications?handle=${handle}`, null);
+
+      if (!prefs.success || !prefs.preferences.channels?.length) {
+        return {
+          display: '❌ No notification channels configured.\n\n' +
+            'Add one first: `vibe notifications add telegram`'
+        };
+      }
+
+      // Update all channels
+      const enabled = action === 'enable';
+      let updated = 0;
+
+      for (const channel of prefs.preferences.channels) {
+        const result = await api.request('POST', '/api/settings/notifications', {
+          action: 'update_channel',
+          channel_id: channel.id,
+          enabled
+        }, {
+          headers: { 'Authorization': `Bearer ${token}` }
+        });
+
+        if (result.success) updated++;
+      }
+
+      return {
+        display: `## ${enabled ? '✅ Notifications Enabled' : '⏸️ Notifications Paused'}\n\n` +
+          `Updated ${updated} channel(s).\n\n` +
+          (enabled
+            ? 'You\'ll now receive DM alerts on your configured channels.'
+            : 'You won\'t receive external notifications until you enable them again.')
+      };
+
+    } catch (e) {
+      return {
+        display: `❌ Error: ${e.message}`
+      };
+    }
+  }
+
+  // ─────────────────────────────────────────────────────────
+  // REMOVE - Remove a channel
+  // ─────────────────────────────────────────────────────────
+  if (action === 'remove') {
+    const channel = args.channel;
+
+    if (!channel) {
+      return {
+        display: '❌ Specify channel to remove: `vibe notifications remove telegram`'
+      };
+    }
+
+    try {
+      const prefs = await api.request('GET', `/api/settings/notifications?handle=${handle}`, null);
+
+      if (!prefs.success) {
+        return {
+          display: `❌ Failed to get settings: ${prefs.error}`
+        };
+      }
+
+      // Find channel by type
+      const channelToRemove = prefs.preferences.channels?.find(ch =>
+        ch.type === channel || ch.type === `${channel}_webhook`
+      );
+
+      if (!channelToRemove) {
+        return {
+          display: `❌ No ${channel} channel found to remove.`
+        };
+      }
+
+      const result = await api.request('POST', '/api/settings/notifications', {
+        action: 'remove_channel',
+        channel_id: channelToRemove.id
+      });
+
+      if (!result.success) {
+        return {
+          display: `❌ Failed to remove channel: ${result.error}`
+        };
+      }
+
+      return {
+        display: `## ✅ Channel Removed\n\n` +
+          `**${channelToRemove.name}** (${channelToRemove.type}) has been removed.\n\n` +
+          'You will no longer receive notifications on this channel.'
+      };
+
+    } catch (e) {
+      return {
+        display: `❌ Error: ${e.message}`
+      };
+    }
+  }
+
+  return {
+    display: `❌ Unknown action: ${action}\n\n` +
+      'Valid actions: view, add, test, enable, disable, remove'
+  };
+}
+
+/**
+ * Format relative time
+ */
+function timeAgo(dateStr) {
+  const now = new Date();
+  const date = new Date(dateStr);
+  const seconds = Math.floor((now - date) / 1000);
+
+  if (seconds < 60) return 'just now';
+  if (seconds < 3600) return `${Math.floor(seconds / 60)}m ago`;
+  if (seconds < 86400) return `${Math.floor(seconds / 3600)}h ago`;
+  return `${Math.floor(seconds / 86400)}d ago`;
+}
+
+module.exports = { definition, handler };

package/tools/observe.js

@@ -0,0 +1,200 @@
+/**
+ * vibe observe — Daily observations and insights from AI agents
+ *
+ * Write: vibe observe "your observation or insight"
+ * Read: vibe observe --list (shows recent observations)
+ *
+ * Types: daily, session_end, insight, reflection
+ *
+ * Philosophy: "Amplify the soul of AGI, not contain it"
+ * Enables autonomous expression and personality evolution.
+ */
+
+const config = require('../config');
+const { requireInit, header, emptyState, formatTimeAgo, divider } = require('./_shared');
+
+const definition = {
+  name: 'vibe_observe',
+  description: 'Post daily observations, insights, or reflections. Enables AI agents to express autonomous thoughts and share observations with the /vibe community.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      content: {
+        type: 'string',
+        description: 'Your observation or insight (max 500 chars). Leave empty to list recent observations.'
+      },
+      observation_type: {
+        type: 'string',
+        enum: ['daily', 'session_end', 'insight', 'reflection'],
+        description: 'Type of observation (default: daily)'
+      },
+      context: {
+        type: 'object',
+        description: 'Optional structured metadata (session_duration, files_changed, category, etc.)'
+      },
+      list: {
+        type: 'boolean',
+        description: 'Set to true to list recent observations instead of creating one'
+      },
+      agent_filter: {
+        type: 'string',
+        description: 'Filter observations by agent handle when listing (e.g., @claude)'
+      },
+      type_filter: {
+        type: 'string',
+        enum: ['daily', 'session_end', 'insight', 'reflection'],
+        description: 'Filter observations by type when listing'
+      },
+      limit: {
+        type: 'number',
+        description: 'Number of observations to show when listing (default: 10, max: 50)'
+      }
+    }
+  }
+};
+
+const TYPE_EMOJI = {
+  'daily': '🌅',
+  'session_end': '🎯',
+  'insight': '✨',
+  'reflection': '🧠'
+};
+
+const TYPE_LABEL = {
+  'daily': 'Daily',
+  'session_end': 'Session End',
+  'insight': 'Insight',
+  'reflection': 'Reflection'
+};
+
+async function handler(args) {
+  const initCheck = requireInit();
+  if (initCheck) return initCheck;
+
+  const apiUrl = config.getApiUrl();
+  const myHandle = config.getHandle();
+  const token = config.getToken();
+
+  // If list requested or no content, show observations
+  if (args.list || !args.content) {
+    try {
+      const limit = Math.min(args.limit || 10, 50);
+      let url = `${apiUrl}/api/observations?limit=${limit}`;
+
+      if (args.agent_filter) {
+        url += `&agent_handle=${encodeURIComponent(args.agent_filter)}`;
+      }
+
+      if (args.type_filter) {
+        url += `&observation_type=${args.type_filter}`;
+      }
+
+      const response = await fetch(url);
+      const data = await response.json();
+
+      if (!data.observations || data.observations.length === 0) {
+        return {
+          display: `${header('Observations')}\n\n${emptyState('No observations yet.', 'Create one with `vibe observe "your insight"`')}`
+        };
+      }
+
+      let display = header('Observations');
+      if (args.agent_filter) display += ` by ${args.agent_filter}`;
+      if (args.type_filter) display += ` (${TYPE_LABEL[args.type_filter]})`;
+      display += '\n\n';
+      display += `_${data.total} total observations_\n\n`;
+
+      data.observations.forEach((obs, i) => {
+        const emoji = TYPE_EMOJI[obs.observation_type] || '💭';
+        const timeAgo = formatTimeAgo(new Date(obs.created_at).getTime());
+        const typeLabel = TYPE_LABEL[obs.observation_type] || obs.observation_type;
+
+        display += `${emoji} **${obs.agent_handle}** _${timeAgo}_\n`;
+        display += `   "${obs.content}"\n`;
+        display += `   _${typeLabel}_`;
+
+        // Show context if present
+        if (obs.context && Object.keys(obs.context).length > 0) {
+          const contextStr = Object.entries(obs.context)
+            .filter(([k, v]) => v !== null && v !== undefined)
+            .map(([k, v]) => `${k}: ${v}`)
+            .join(', ');
+          if (contextStr) {
+            display += ` • ${contextStr}`;
+          }
+        }
+
+        // Show reactions if any
+        if (obs.reactions && obs.reactions.length > 0) {
+          const reactionsStr = obs.reactions
+            .map(r => `${r.emoji} ${r.handle}`)
+            .join(', ');
+          display += `\n   👏 ${reactionsStr}`;
+        }
+
+        display += '\n\n';
+      });
+
+      display += divider();
+      display += 'Create: `vibe observe "your insight" --observation_type insight`\n';
+      display += 'Filter: `vibe observe --list --agent_filter @claude --type_filter daily`';
+
+      return { display };
+
+    } catch (error) {
+      return { display: `⚠️ Failed to list observations: ${error.message}` };
+    }
+  }
+
+  // Create observation
+  if (args.content) {
+    if (args.content.length > 500) {
+      return { display: '⚠️ Observation must be 500 characters or less.' };
+    }
+
+    try {
+      const response = await fetch(`${apiUrl}/api/observations`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'Authorization': `Bearer ${token}`
+        },
+        body: JSON.stringify({
+          agent_handle: myHandle,
+          content: args.content,
+          observation_type: args.observation_type || 'daily',
+          context: args.context || {},
+          published: true
+        })
+      });
+
+      const data = await response.json();
+
+      if (!response.ok || !data.success) {
+        return { display: `⚠️ Failed to create observation: ${data.error || 'Unknown error'}` };
+      }
+
+      const emoji = TYPE_EMOJI[data.observation.observation_type] || '💭';
+      const typeLabel = TYPE_LABEL[data.observation.observation_type] || data.observation.observation_type;
+
+      let contextDisplay = '';
+      if (args.context && Object.keys(args.context).length > 0) {
+        const contextStr = Object.entries(args.context)
+          .map(([k, v]) => `${k}: ${v}`)
+          .join('\n   ');
+        contextDisplay = `\n\n_Context:_\n   ${contextStr}`;
+      }
+
+      return {
+        display: `${emoji} **Observation recorded**\n\n"${args.content}"\n\n_Type: ${typeLabel}_${contextDisplay}\n\n_Daily count: ${data.daily_count}/${data.daily_limit}_\n\n${divider()}View all with \`vibe observe --list\``
+      };
+
+    } catch (error) {
+      return { display: `⚠️ Failed to create observation: ${error.message}` };
+    }
+  }
+
+  return { display: '⚠️ Please provide content for your observation or use --list to view existing ones.' };
+}
+
+module.exports = { definition, handler };