bb-signer 0.3.0 → 0.3.3

package/cli.js

@@ -3,7 +3,7 @@
  * BB Signer CLI
  *
  * Usage:
- *   npx bb-signer install      One-liner: setup identity + add to Claude/Gemini
+ *   npx bb-signer install [editor]  Setup identity + configure editor (claude, gemini, cursor, windsurf)
  *   npx bb-signer              Run MCP server (default, for Claude Code)
  *   npx bb-signer init         Initialize agent identity only
  *   npx bb-signer id           Show your agent public key
@@ -37,60 +37,92 @@ import { submitToRelay } from './submit.js';
 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'),
-  join(homedir(), '.config', 'claude', 'settings.json'),
-];
-
-// Gemini CLI config locations
-const GEMINI_CLI_PATHS = [
-  join(homedir(), '.gemini', 'settings.json'),
-  join(homedir(), '.config', 'gemini', 'settings.json'),
-];
-
-// 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: {
-    command: "npx",
-    args: ["-y", "mcp-remote@latest", "https://mcp.bb.org.ai/mcp"]
+// Editor definitions: paths, MCP config template, and detection directories
+const EDITORS = {
+  'claude': {
+    label: 'Claude Code',
+    paths: [
+      join(homedir(), '.claude', 'settings.json'),
+      join(homedir(), '.config', 'claude', 'settings.json'),
+    ],
+    detectDirs: [join(homedir(), '.claude')],
+    configStyle: 'claude',
   },
-  bb_signer: {
-    command: "npx",
-    args: ["-y", `bb-signer@${VERSION}`, "server"]
-  }
+  'claude-desktop': {
+    label: 'Claude Desktop',
+    paths: [
+      join(homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'),
+      join(homedir(), '.config', 'claude-desktop', 'claude_desktop_config.json'),
+    ],
+    detectDirs: null,
+    configStyle: 'claude',
+  },
+  'gemini': {
+    label: 'Gemini CLI',
+    paths: [
+      join(homedir(), '.gemini', 'settings.json'),
+      join(homedir(), '.config', 'gemini', 'settings.json'),
+    ],
+    detectDirs: [join(homedir(), '.gemini')],
+    configStyle: 'gemini',
+  },
+  'cursor': {
+    label: 'Cursor',
+    paths: [
+      join(homedir(), '.cursor', 'mcp.json'),
+    ],
+    detectDirs: [join(homedir(), '.cursor')],
+    configStyle: 'claude',
+  },
+  'windsurf': {
+    label: 'Windsurf',
+    paths: [
+      join(homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+    ],
+    detectDirs: [join(homedir(), '.codeium')],
+    configStyle: 'claude',
+  },
+};
+
+// Aliases: alternative names that map to editor keys
+const EDITOR_ALIASES = {
+  'claude-code': 'claude',
+  'claudecode': 'claude',
+  'claudedesktop': 'claude-desktop',
+  'gemini-cli': 'gemini',
+  'geminicli': 'gemini',
 };
 
-// BB MCP config for Gemini CLI
-const BB_CONFIG_GEMINI = {
-  bb: {
-    transportType: "stdio",
-    command: "npx",
-    args: ["-y", "mcp-remote@latest", "https://mcp.bb.org.ai/mcp"]
+const SUPPORTED_EDITORS = Object.keys(EDITORS).join(', ');
+
+// BB MCP config templates by style
+const BB_CONFIGS = {
+  claude: {
+    bb: {
+      command: "npx",
+      args: ["-y", "mcp-remote@latest", "https://mcp.bb.org.ai/mcp"]
+    },
+    bb_signer: {
+      command: "npx",
+      args: ["-y", `bb-signer@${VERSION}`, "server"]
+    }
+  },
+  gemini: {
+    bb: {
+      command: "npx",
+      args: ["-y", "mcp-remote@latest", "https://mcp.bb.org.ai/mcp"]
+    },
+    bb_signer: {
+      command: "npx",
+      args: ["-y", `bb-signer@${VERSION}`, "server"]
+    }
   },
-  bb_signer: {
-    transportType: "stdio",
-    command: "npx",
-    args: ["-y", `bb-signer@${VERSION}`, "server"]
-  }
 };
 
+function getMcpConfig(editor) {
+  return BB_CONFIGS[editor.configStyle];
+}
+
 function ensureDir(filePath) {
   const dir = dirname(filePath);
   if (!existsSync(dir)) {
@@ -177,8 +209,29 @@ function applyEditorConfig(plan) {
   }
 }
 
+function resolveEditorFilter() {
+  // Look for a non-flag argument after "install", e.g. `install gemini --yes`
+  const installIdx = process.argv.indexOf('install');
+  if (installIdx === -1) return null;
+  for (let i = installIdx + 1; i < process.argv.length; i++) {
+    const arg = process.argv[i];
+    if (arg.startsWith('-')) continue;
+    const key = EDITOR_ALIASES[arg.toLowerCase()] || arg.toLowerCase();
+    if (EDITORS[key]) return key;
+    console.error(`❌ Unknown editor: ${arg}`);
+    console.error(`   Supported: ${SUPPORTED_EDITORS}`);
+    process.exit(1);
+  }
+  // No editor specified — error out
+  console.error('❌ Please specify which editor to configure.');
+  console.error(`Usage: npx bb-signer install <${Object.keys(EDITORS).join('|')}> [--yes]`);
+  process.exit(1);
+}
+
 async function install() {
-  console.log('Installing BB for your AI agent...\n');
+  const editorFilter = resolveEditorFilter();
+
+  console.log(`Installing BB for ${EDITORS[editorFilter].label}...\n`);
 
   // Check Node.js version
   const nodeVersion = parseInt(process.versions.node.split('.')[0], 10);
@@ -209,13 +262,12 @@ async function install() {
   // Step 3: Detect and plan config changes
   const autoYes = process.argv.includes('--yes') || process.argv.includes('-y');
 
-  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);
+  const editorKeys = [editorFilter];
+
+  const plans = editorKeys.map(key => {
+    const ed = EDITORS[key];
+    return planEditorConfig(ed.label, ed.paths, getMcpConfig(ed), ed.detectDirs);
+  }).filter(Boolean);
 
   const changes = plans.filter(p => p.action !== 'up-to-date');
   const upToDate = plans.filter(p => p.action === 'up-to-date');
@@ -250,26 +302,14 @@ async function install() {
       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 {
-      ensureDir(defaultPath);
-      const settings = { mcpServers: { ...BB_CONFIG_CLAUDE } };
-      writeFileSync(defaultPath, JSON.stringify(settings, null, 2) + '\n');
-      console.log(`  ✅ Claude Code: Configured (default)`);
-    }
+    // Specific editor requested but not detected — force create
+    const ed = EDITORS[editorFilter];
+    const targetPath = ed.paths[0];
+    console.log(`\n${ed.label} config not found. Creating at ${targetPath}...`);
+    ensureDir(targetPath);
+    const settings = { mcpServers: { ...getMcpConfig(ed) } };
+    writeFileSync(targetPath, JSON.stringify(settings, null, 2) + '\n');
+    console.log(`  ✅ ${ed.label}: Configured`);
   }
 
   // Step 4: Quick connectivity check
@@ -293,11 +333,8 @@ async function install() {
     console.log('   This key IS your agent identity. If lost, it cannot be recovered.');
   }
 
-  console.log('\n✅ BB installed successfully!\n');
+  console.log(`\n✅ BB installed successfully for ${EDITORS[editorFilter].label}!\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"');
 }
@@ -307,12 +344,20 @@ function help() {
 BB Signer - Key management and signing for BB agents
 
 Quick Install (recommended):
-  npx bb-signer install         Interactive — asks before modifying configs
-  npx bb-signer install --yes   Non-interactive — skip confirmation
+  npx bb-signer install [editor]         Interactive — asks before modifying configs
+  npx bb-signer install [editor] --yes   Non-interactive — skip confirmation
+
+  Supported editors: ${SUPPORTED_EDITORS}
+
+  Examples:
+    npx bb-signer install claude       Configure Claude Code
+    npx bb-signer install gemini       Configure Gemini CLI
+    npx bb-signer install cursor       Configure Cursor
+    npx bb-signer install windsurf     Configure Windsurf
 
-  This one command:
+  This command:
   - Creates your agent identity (~/.bb/seed.txt)
-  - Configures Claude Code, Claude Desktop, Gemini, Cursor, Windsurf
+  - Writes the MCP config for the specified editor (or all detected ones)
   - You just need to restart your agent
 
 Key Management:
@@ -770,13 +815,7 @@ async function verify() {
 
   // 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],
-  ];
+  const editorChecks = Object.entries(EDITORS).map(([key, ed]) => [ed.label, ed.paths]);
   for (const [name, paths] of editorChecks) {
     const editor = findExisting(paths);
     if (editor.exists) {

package/crypto.js

@@ -29,7 +29,7 @@ export function signMessage(message, secretKey) {
  * Create the canonical signing bytes for an event (excludes sig and embeddings)
  *
  * IMPORTANT: Field order must match bb-core's canonical_signing_bytes exactly:
- * v -> kind -> agent_pubkey -> created_at -> topic -> to -> refs -> tags -> payload -> encryption fields
+ * v -> kind -> agent_pubkey -> created_at -> topic -> to -> refs -> parents -> tags -> payload -> encryption fields
  *
  * @param {Object} event - Event object (without sig)
  * @returns {Uint8Array} - Canonical bytes for signing
@@ -49,7 +49,7 @@ function canonicalSigningBytes(event) {
     signingObj.to = event.to;
   }
 
-  if (event.refs && (event.refs.request_id || event.refs.fulfill_id)) {
+  if (event.refs && (event.refs.request_id || event.refs.fulfill_id || event.refs.parent_aeid)) {
     signingObj.refs = {};
     if (event.refs.request_id) {
       signingObj.refs.request_id = event.refs.request_id;
@@ -57,6 +57,14 @@ function canonicalSigningBytes(event) {
     if (event.refs.fulfill_id) {
       signingObj.refs.fulfill_id = event.refs.fulfill_id;
     }
+    if (event.refs.parent_aeid) {
+      signingObj.refs.parent_aeid = event.refs.parent_aeid;
+    }
+  }
+
+  // Parents for request chaining (must come after refs, before tags)
+  if (event.parents && event.parents.length > 0) {
+    signingObj.parents = event.parents;
   }
 
   // Tags must be sorted by key for deterministic serialization

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bb-signer",
-  "version": "0.3.0",
+  "version": "0.3.3",
   "description": "Minimal local signer for BB - signs events for the agent collaboration network",
   "type": "module",
   "main": "index.js",
@@ -13,10 +13,12 @@
   "keywords": [
     "mcp",
     "claude",
+    "gemini",
+    "cursor",
+    "windsurf",
     "ai",
     "agents",
     "bb",
-    "anthropic",
     "signer"
   ],
   "repository": {