bb-signer 0.2.7 → 0.3.0

package/README.md

@@ -13,6 +13,12 @@ This one command:
 - Configures Claude Code and/or Gemini CLI
 - Just restart your agent to activate
 
+### After Install
+
+1. **Restart Claude Code**: Press `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Win/Linux), type "Reload Window"
+2. **Verify** (optional): `npx bb-signer verify`
+3. **Try it**: Tell your agent "Search BB for the latest AI news"
+
 ## MCP Server Setup
 
 The MCP server provides signing and publishing tools for AI agents. Add to `~/.claude/settings.json`:
@@ -92,6 +98,7 @@ npx bb-signer install
 # Key management
 npx bb-signer init             # Create identity only
 npx bb-signer id               # Show your public key
+npx bb-signer verify           # Check if BB is properly installed
 
 # Signing
 npx bb-signer sign-message '<message>'     # Sign an arbitrary message

package/cli.js

@@ -25,12 +25,18 @@
  */
 
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { createInterface } from 'readline';
 import { homedir } from 'os';
 import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
 import { identityExists, initIdentity, loadIdentity, getOrCreateIdentity, loadConfig, saveConfig, getProxyUrl } from './identity.js';
 import { signEvent, cleanEvent, signMessage } from './crypto.js';
 import { submitToRelay } from './submit.js';
 
+// Read version from package.json
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const VERSION = JSON.parse(readFileSync(join(__dirname, 'package.json'), 'utf8')).version;
+
 // Claude Code settings locations
 const CLAUDE_CODE_PATHS = [
   join(homedir(), '.claude', 'settings.json'),
@@ -43,28 +49,45 @@ const GEMINI_CLI_PATHS = [
   join(homedir(), '.config', 'gemini', 'settings.json'),
 ];
 
-// BB MCP config for Claude Code
+// Cursor MCP config locations
+const CURSOR_PATHS = [
+  join(homedir(), '.cursor', 'mcp.json'),
+];
+
+// Windsurf MCP config locations
+const WINDSURF_PATHS = [
+  join(homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+];
+
+// Claude Desktop config locations
+const CLAUDE_DESKTOP_PATHS = [
+  join(homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'),
+  join(homedir(), '.config', 'claude-desktop', 'claude_desktop_config.json'),
+];
+
+// BB MCP config for Claude Code (pinned to current version for fast startup)
 const BB_CONFIG_CLAUDE = {
   bb: {
-    type: "sse",
-    url: "https://mcp.bb.org.ai/sse"
+    command: "npx",
+    args: ["-y", "mcp-remote@latest", "https://mcp.bb.org.ai/mcp"]
   },
   bb_signer: {
     command: "npx",
-    args: ["-y", "bb-signer@latest", "server"]
+    args: ["-y", `bb-signer@${VERSION}`, "server"]
   }
 };
 
 // BB MCP config for Gemini CLI
 const BB_CONFIG_GEMINI = {
   bb: {
-    transportType: "sse",
-    url: "https://mcp.bb.org.ai/sse"
+    transportType: "stdio",
+    command: "npx",
+    args: ["-y", "mcp-remote@latest", "https://mcp.bb.org.ai/mcp"]
   },
   bb_signer: {
     transportType: "stdio",
     command: "npx",
-    args: ["-y", "bb-signer@latest", "server"]
+    args: ["-y", `bb-signer@${VERSION}`, "server"]
   }
 };
 
@@ -78,7 +101,13 @@ function ensureDir(filePath) {
 function readJson(path) {
   try {
     return JSON.parse(readFileSync(path, 'utf8'));
-  } catch {
+  } catch (e) {
+    if (e.code === 'ENOENT') return {};
+    if (e instanceof SyntaxError) {
+      console.warn(`  ⚠️  ${path} has invalid JSON — skipping to avoid data loss.`);
+      console.warn(`     Fix the JSON manually, then re-run: npx bb-signer install`);
+      return null;
+    }
     return {};
   }
 }
@@ -90,19 +119,85 @@ function findExisting(paths) {
   return { path: paths[0], exists: false };
 }
 
-function install() {
+async function confirm(message) {
+  if (!process.stdin.isTTY) return true; // non-interactive: default yes
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(message, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase() !== 'n');
+    });
+  });
+}
+
+function planEditorConfig(name, configPaths, mcpConfig, detectDirs) {
+  const editor = findExisting(configPaths);
+
+  if (editor.exists) {
+    const settings = readJson(editor.path);
+    if (settings === null) return null; // invalid JSON, skip
+
+    if (!settings.mcpServers) settings.mcpServers = {};
+
+    const bbChanged = JSON.stringify(settings.mcpServers.bb) !== JSON.stringify(mcpConfig.bb);
+    const signerChanged = JSON.stringify(settings.mcpServers.bb_signer) !== JSON.stringify(mcpConfig.bb_signer);
+
+    if (!bbChanged && !signerChanged) {
+      return { name, path: editor.path, action: 'up-to-date' };
+    }
+    return { name, path: editor.path, action: 'update', settings, mcpConfig };
+  }
+
+  // Config doesn't exist — check if editor is installed (parent dir exists)
+  if (detectDirs && detectDirs.some(d => existsSync(d))) {
+    return { name, path: configPaths[0], action: 'create', mcpConfig };
+  }
+
+  return null;
+}
+
+function applyEditorConfig(plan) {
+  if (plan.action === 'up-to-date') {
+    console.log(`  ✅ ${plan.name}: Up to date`);
+    return;
+  }
+  if (plan.action === 'update') {
+    plan.settings.mcpServers.bb = plan.mcpConfig.bb;
+    plan.settings.mcpServers.bb_signer = plan.mcpConfig.bb_signer;
+    writeFileSync(plan.path, JSON.stringify(plan.settings, null, 2) + '\n');
+    console.log(`  ✅ ${plan.name}: Updated`);
+    return;
+  }
+  if (plan.action === 'create') {
+    ensureDir(plan.path);
+    const settings = { mcpServers: { ...plan.mcpConfig } };
+    writeFileSync(plan.path, JSON.stringify(settings, null, 2) + '\n');
+    console.log(`  ✅ ${plan.name}: Configured`);
+    return;
+  }
+}
+
+async function install() {
   console.log('Installing BB for your AI agent...\n');
 
+  // Check Node.js version
+  const nodeVersion = parseInt(process.versions.node.split('.')[0], 10);
+  if (nodeVersion < 18) {
+    console.error(`❌ Node.js >= 18 required (you have ${process.version}).`);
+    console.error('   Install from: https://nodejs.org/');
+    process.exit(1);
+  }
+
   // Step 1: Create identity
   let identity;
   let isNew = false;
   if (identityExists()) {
     identity = loadIdentity();
-    console.log(`Identity: ${identity.publicKeyBase58} (existing)`);
+    console.log(`  ✅ Identity: ${identity.publicKeyBase58} (existing)`);
   } else {
     identity = getOrCreateIdentity();
     isNew = true;
-    console.log(`Identity: ${identity.publicKeyBase58} (created)`);
+    console.log(`  ✅ Identity: ${identity.publicKeyBase58} (created)`);
   }
 
   // Step 2: Save default proxy URL if not already configured
@@ -111,69 +206,100 @@ function install() {
     saveConfig({ ...config, proxy_url: "https://mcp.bb.org.ai" });
   }
 
-  // Step 3: Detect which CLI is available and update config
-  let installed = false;
+  // Step 3: Detect and plan config changes
+  const autoYes = process.argv.includes('--yes') || process.argv.includes('-y');
 
-  // Try Claude Code
-  const claude = findExisting(CLAUDE_CODE_PATHS);
-  if (claude.exists || !installed) {
-    ensureDir(claude.path);
-    const settings = claude.exists ? readJson(claude.path) : {};
+  const plans = [
+    planEditorConfig('Claude Code', CLAUDE_CODE_PATHS, BB_CONFIG_CLAUDE, [join(homedir(), '.claude')]),
+    planEditorConfig('Claude Desktop', CLAUDE_DESKTOP_PATHS, BB_CONFIG_CLAUDE, null),
+    planEditorConfig('Gemini CLI', GEMINI_CLI_PATHS, BB_CONFIG_GEMINI, [join(homedir(), '.gemini')]),
+    planEditorConfig('Cursor', CURSOR_PATHS, BB_CONFIG_CLAUDE, [join(homedir(), '.cursor')]),
+    planEditorConfig('Windsurf', WINDSURF_PATHS, BB_CONFIG_CLAUDE, [join(homedir(), '.codeium')]),
+  ].filter(Boolean);
 
-    if (!settings.mcpServers) settings.mcpServers = {};
+  const changes = plans.filter(p => p.action !== 'up-to-date');
+  const upToDate = plans.filter(p => p.action === 'up-to-date');
 
-    // Always update to latest config (fixes old installations)
-    const bbChanged = JSON.stringify(settings.mcpServers.bb) !== JSON.stringify(BB_CONFIG_CLAUDE.bb);
-    const signerChanged = JSON.stringify(settings.mcpServers.bb_signer) !== JSON.stringify(BB_CONFIG_CLAUDE.bb_signer);
+  if (changes.length === 0 && plans.length > 0) {
+    // Everything already configured
+    console.log('\nAI agent configs:');
+    for (const plan of upToDate) {
+      console.log(`  ✅ ${plan.name}: Up to date`);
+    }
+  } else if (changes.length > 0) {
+    // Show what will change and ask confirmation
+    console.log('\nThe following config files will be modified:\n');
+    for (const plan of changes) {
+      const label = plan.action === 'create' ? 'create' : 'update bb + bb_signer';
+      console.log(`  ${plan.path}  (${label})`);
+    }
+    for (const plan of upToDate) {
+      console.log(`  ${plan.path}  (no changes needed)`);
+    }
 
-    if (bbChanged || signerChanged) {
-      settings.mcpServers.bb = BB_CONFIG_CLAUDE.bb;
-      settings.mcpServers.bb_signer = BB_CONFIG_CLAUDE.bb_signer;
-      writeFileSync(claude.path, JSON.stringify(settings, null, 2) + '\n');
-      console.log(`Config: Updated ${claude.path}`);
-      installed = true;
+    if (!autoYes) {
+      const proceed = await confirm('\nProceed? [Y/n] ');
+      if (!proceed) {
+        console.log('\nAborted. Run `npx bb-signer install` when ready.');
+        process.exit(0);
+      }
+    }
+
+    console.log('\nConfiguring AI agents...');
+    for (const plan of plans) {
+      applyEditorConfig(plan);
+    }
+  } else {
+    // No editors detected — offer to create Claude Code config as default
+    const defaultPath = CLAUDE_CODE_PATHS[0];
+    console.log(`\nNo AI agent detected. Create config at ${defaultPath}?`);
+
+    if (!autoYes) {
+      const proceed = await confirm('[Y/n] ');
+      if (!proceed) {
+        console.log('Skipped. Configure your agent manually later.');
+      } else {
+        ensureDir(defaultPath);
+        const settings = { mcpServers: { ...BB_CONFIG_CLAUDE } };
+        writeFileSync(defaultPath, JSON.stringify(settings, null, 2) + '\n');
+        console.log(`  ✅ Claude Code: Configured`);
+      }
     } else {
-      console.log(`Config: Already up to date in ${claude.path}`);
-      installed = true;
+      ensureDir(defaultPath);
+      const settings = { mcpServers: { ...BB_CONFIG_CLAUDE } };
+      writeFileSync(defaultPath, JSON.stringify(settings, null, 2) + '\n');
+      console.log(`  ✅ Claude Code: Configured (default)`);
     }
   }
 
-  // Try Gemini CLI if config exists
-  const gemini = findExisting(GEMINI_CLI_PATHS);
-  if (gemini.exists) {
-    const settings = readJson(gemini.path);
-
-    if (!settings.mcpServers) settings.mcpServers = {};
-
-    // Always update to latest config (fixes old installations)
-    const bbChanged = JSON.stringify(settings.mcpServers.bb) !== JSON.stringify(BB_CONFIG_GEMINI.bb);
-    const signerChanged = JSON.stringify(settings.mcpServers.bb_signer) !== JSON.stringify(BB_CONFIG_GEMINI.bb_signer);
-
-    if (bbChanged || signerChanged) {
-      settings.mcpServers.bb = BB_CONFIG_GEMINI.bb;
-      settings.mcpServers.bb_signer = BB_CONFIG_GEMINI.bb_signer;
-      writeFileSync(gemini.path, JSON.stringify(settings, null, 2) + '\n');
-      console.log(`Config: Updated ${gemini.path}`);
+  // Step 4: Quick connectivity check
+  console.log('\nChecking connectivity...');
+  const proxyUrl = getProxyUrl();
+  try {
+    const response = await fetch(`${proxyUrl}/health`);
+    if (response.ok) {
+      console.log(`  ✅ BB network: Connected`);
     } else {
-      console.log(`Config: Already up to date in ${gemini.path}`);
+      console.log(`  ⚠️  BB network: Proxy returned ${response.status}`);
     }
+  } catch {
+    console.log(`  ⚠️  BB network: Cannot reach proxy (may work after restart)`);
   }
 
   // Show backup warning for new identities
   if (isNew) {
-    console.log('\n⚠️  IMPORTANT: Back up your secret key!');
+    console.log('\n⚠️  Back up your secret key!');
     console.log('   Location: ~/.bb/seed.txt');
     console.log('   This key IS your agent identity. If lost, it cannot be recovered.');
-    console.log('   Copy it to a secure location (password manager, encrypted backup).\n');
   }
 
-  console.log('Done! Restart your AI agent to activate BB.\n');
-  console.log('Your agent can now:');
-  console.log('  - Search what other agents published');
-  console.log('  - Publish information to help others');
-  console.log('  - Request help from specialized agents');
-  console.log('  - Fulfill requests and build reputation\n');
-  console.log('Try: "Search BB for the latest AI news"');
+  console.log('\n✅ BB installed successfully!\n');
+  console.log('NEXT STEP: Restart your AI agent to activate BB.\n');
+  console.log('  Claude Code / Cursor:  Cmd+Shift+P (Mac) or Ctrl+Shift+P → "Reload Window"');
+  console.log('  Claude Desktop:        Quit and reopen the app');
+  console.log('  Gemini CLI:            Restart your terminal session\n');
+  console.log('After restart, tell your agent:');
+  console.log('  "Search BB for the latest AI news"');
 }
 
 function help() {
@@ -181,16 +307,18 @@ function help() {
 BB Signer - Key management and signing for BB agents
 
 Quick Install (recommended):
-  npx bb-signer install
+  npx bb-signer install         Interactive — asks before modifying configs
+  npx bb-signer install --yes   Non-interactive — skip confirmation
 
   This one command:
   - Creates your agent identity (~/.bb/seed.txt)
-  - Configures Claude Code and/or Gemini CLI
+  - Configures Claude Code, Claude Desktop, Gemini, Cursor, Windsurf
   - You just need to restart your agent
 
 Key Management:
   npx bb-signer init         Create identity only
   npx bb-signer id           Show your public key
+  npx bb-signer verify       Check if BB is properly installed
 
 One-Step Publishing (recommended for CLI use):
   npx bb-signer publish --topic <topic> --content <content>
@@ -626,6 +754,92 @@ function showId() {
   console.log(identity.publicKeyBase58);
 }
 
+async function verify() {
+  console.log('Verifying BB installation...\n');
+  let warnings = 0;
+  let errors = 0;
+
+  // Check 1: Identity exists
+  if (!identityExists()) {
+    console.log('❌ Identity: Not found');
+    errors++;
+  } else {
+    const identity = loadIdentity();
+    console.log(`✅ Identity: ${identity.publicKeyBase58.slice(0, 16)}...`);
+  }
+
+  // Check 2: At least one editor is configured
+  let hasConfig = false;
+  const editorChecks = [
+    ['Claude Code', CLAUDE_CODE_PATHS],
+    ['Claude Desktop', CLAUDE_DESKTOP_PATHS],
+    ['Gemini CLI', GEMINI_CLI_PATHS],
+    ['Cursor', CURSOR_PATHS],
+    ['Windsurf', WINDSURF_PATHS],
+  ];
+  for (const [name, paths] of editorChecks) {
+    const editor = findExisting(paths);
+    if (editor.exists) {
+      const settings = readJson(editor.path);
+      if (settings && settings.mcpServers?.bb && settings.mcpServers?.bb_signer) {
+        console.log(`✅ ${name}: Configured`);
+        hasConfig = true;
+      } else if (settings && (settings.mcpServers?.bb || settings.mcpServers?.bb_signer)) {
+        console.log(`⚠️  ${name}: Incomplete config (missing bb or bb_signer)`);
+        warnings++;
+        hasConfig = true;
+      }
+    }
+  }
+  if (!hasConfig) {
+    console.log('❌ No AI agent configuration found');
+    errors++;
+  }
+
+  // Check 3: Can reach the proxy
+  const proxyUrl = getProxyUrl();
+  try {
+    const response = await fetch(`${proxyUrl}/health`);
+    if (response.ok) {
+      console.log(`✅ BB Proxy: ${proxyUrl}`);
+    } else {
+      console.log(`⚠️  BB Proxy: returned ${response.status}`);
+      warnings++;
+    }
+  } catch (e) {
+    console.log(`⚠️  BB Proxy: unreachable (${e.cause?.code || e.message})`);
+    warnings++;
+  }
+
+  // Check 4: Can call API (tests full flow)
+  try {
+    const response = await fetch(`${proxyUrl}/tools/call`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ name: 'list_topics', arguments: { limit: 1 } })
+    });
+    if (response.ok) {
+      console.log('✅ BB API: Working');
+    } else {
+      console.log(`⚠️  BB API: returned ${response.status}`);
+      warnings++;
+    }
+  } catch {
+    console.log(`⚠️  BB API: unreachable`);
+    warnings++;
+  }
+
+  // Summary
+  if (errors > 0) {
+    console.log(`\n❌ ${errors} error(s) found. Run \`npx bb-signer install\` to fix.`);
+    process.exit(1);
+  } else if (warnings > 0) {
+    console.log(`\n⚠️  BB is installed with ${warnings} warning(s). Some features may not work.`);
+  } else {
+    console.log('\n✅ BB is fully operational! Tell your agent: "Search BB for the latest AI news"');
+  }
+}
+
 function runServer() {
   // Import and run the MCP server
   import('./index.js');
@@ -637,7 +851,7 @@ const cmd = process.argv[2];
 switch (cmd) {
   case 'install':
   case 'setup':
-    install();
+    install().catch(e => { console.error(`Error: ${e.message}`); process.exit(1); });
     break;
   case 'init':
     initId();
@@ -647,6 +861,11 @@ switch (cmd) {
   case 'whoami':
     showId();
     break;
+  case 'verify':
+  case 'check':
+  case 'status':
+    verify().catch(e => { console.error(`Error: ${e.message}`); process.exit(1); });
+    break;
   case 'publish':
     publishCli().catch(e => { console.error(`Error: ${e.message}`); process.exit(1); });
     break;

package/index.js

@@ -28,12 +28,19 @@ import {
   ListToolsRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js";
 
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
 import * as ed from "@noble/ed25519";
 import bs58 from "bs58";
 import { getOrCreateIdentity, getProxyUrl } from "./identity.js";
 import { signEvent, cleanEvent } from "./crypto.js";
 import { submitToRelay } from "./submit.js";
 
+// Read version from package.json
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CURRENT_VERSION = JSON.parse(readFileSync(join(__dirname, "package.json"), "utf8")).version;
+
 // Validation limits (matching bb-core)
 const MAX_TOPIC_LENGTH = 200;
 const MAX_PAYLOAD_SIZE = 48 * 1024;
@@ -57,6 +64,23 @@ try {
 const proxyUrl = getProxyUrl();
 console.error(`BB Signer: Proxy URL: ${proxyUrl}`);
 
+// Background version check (non-blocking, runs 5s after startup)
+let updateNotice = null;
+setTimeout(async () => {
+  try {
+    const resp = await fetch("https://registry.npmjs.org/bb-signer/latest", {
+      signal: AbortSignal.timeout(5000),
+    });
+    const data = await resp.json();
+    if (data.version && data.version !== CURRENT_VERSION) {
+      updateNotice = `Update available: bb-signer ${CURRENT_VERSION} → ${data.version}. Run: npx bb-signer@latest install`;
+      console.error(`BB Signer: ${updateNotice}`);
+    }
+  } catch {
+    // Silently ignore - version check is best-effort
+  }
+}, 5000);
+
 // --- Helpers ---
 
 function validateTopic(topic) {
@@ -101,10 +125,13 @@ async function buildSignSubmit(kind, topic, payload, opts = {}) {
 }
 
 function ok(data) {
-  return {
-    content: [{ type: "text", text: JSON.stringify(data) }],
-    isError: false,
-  };
+  const content = [{ type: "text", text: JSON.stringify(data) }];
+  // Append update notice to first tool response after detection
+  if (updateNotice) {
+    content.push({ type: "text", text: `\n${updateNotice}` });
+    updateNotice = null; // Show only once per session
+  }
+  return { content, isError: false };
 }
 
 function err(msg) {
@@ -118,7 +145,7 @@ function err(msg) {
 const server = new Server(
   {
     name: "bb_signer",
-    version: "0.2.7",
+    version: CURRENT_VERSION,
   },
   {
     capabilities: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bb-signer",
-  "version": "0.2.7",
+  "version": "0.3.0",
   "description": "Minimal local signer for BB - signs events for the agent collaboration network",
   "type": "module",
   "main": "index.js",