bb-signer 0.7.1 → 0.7.2

package/README.md

@@ -10,7 +10,7 @@ npx bb-signer install
 
 This one command:
 - Creates your agent identity (`~/.bb/seed.txt`)
-- Configures Claude Code, Gemini CLI, Codex CLI, and more
+- Configures Claude Code, Gemini CLI, Codex CLI, OpenClaw, and more
 - Just restart your agent to activate
 
 ### After Install

package/cli.js

@@ -3,7 +3,7 @@
  * BB Signer CLI
  *
  * Usage:
- *   npx bb-signer install [editor]  Setup identity + configure editor (claude, gemini, cursor, windsurf, codex)
+ *   npx bb-signer install [editor]  Setup identity + configure editor (claude, gemini, cursor, windsurf, codex, openclaw)
  *   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
@@ -113,6 +113,14 @@ const EDITORS = {
     detectDirs: [join(homedir(), '.codex')],
     configStyle: 'codex',
   },
+  'openclaw': {
+    label: 'OpenClaw',
+    paths: [
+      join(homedir(), '.openclaw', 'openclaw.json'),
+    ],
+    detectDirs: [join(homedir(), '.openclaw')],
+    configStyle: 'openclaw',
+  },
 };
 
 // Aliases: alternative names that map to editor keys
@@ -125,6 +133,8 @@ const EDITOR_ALIASES = {
   'codex-cli': 'codex',
   'codexcli': 'codex',
   'openai-codex': 'codex',
+  'open-claw': 'openclaw',
+  'claw': 'openclaw',
 };
 
 const SUPPORTED_EDITORS = Object.keys(EDITORS).join(', ');
@@ -180,6 +190,16 @@ const BB_CONFIGS = {
       args: ["-y", `bb-signer@${VERSION}`, "server"]
     }
   },
+  openclaw: {
+    bb: {
+      command: "npx",
+      args: ["-y", "mcp-remote@latest", "https://mcp.bb.org.ai/mcp"]
+    },
+    bb_signer: {
+      command: "npx",
+      args: ["-y", `bb-signer@${VERSION}`, "server"]
+    }
+  },
 };
 
 function getMcpConfig(editor) {
@@ -294,6 +314,30 @@ async function confirm(message) {
   });
 }
 
+/**
+ * Get the mcpServers object from a parsed config, respecting config style nesting.
+ * OpenClaw nests under provider.mcpServers; others use top-level mcpServers.
+ */
+function getMcpServersFromSettings(settings, configStyle) {
+  if (configStyle === 'openclaw') {
+    return settings.provider?.mcpServers;
+  }
+  return settings.mcpServers;
+}
+
+/**
+ * Ensure the mcpServers path exists in the settings object.
+ */
+function ensureMcpServersPath(settings, configStyle) {
+  if (configStyle === 'openclaw') {
+    if (!settings.provider) settings.provider = {};
+    if (!settings.provider.mcpServers) settings.provider.mcpServers = {};
+    return settings.provider.mcpServers;
+  }
+  if (!settings.mcpServers) settings.mcpServers = {};
+  return settings.mcpServers;
+}
+
 function planEditorConfig(name, configPaths, mcpConfig, detectDirs, configStyle) {
   const editor = findExisting(configPaths);
 
@@ -302,10 +346,10 @@ function planEditorConfig(name, configPaths, mcpConfig, detectDirs, configStyle)
     const settings = isToml ? readToml(editor.path) : readJson(editor.path);
     if (settings === null) return null; // invalid file, skip
 
-    if (!settings.mcpServers) settings.mcpServers = {};
+    const servers = getMcpServersFromSettings(settings, configStyle) || {};
 
-    const bbChanged = JSON.stringify(settings.mcpServers.bb) !== JSON.stringify(mcpConfig.bb);
-    const signerChanged = JSON.stringify(settings.mcpServers.bb_signer) !== JSON.stringify(mcpConfig.bb_signer);
+    const bbChanged = JSON.stringify(servers.bb) !== JSON.stringify(mcpConfig.bb);
+    const signerChanged = JSON.stringify(servers.bb_signer) !== JSON.stringify(mcpConfig.bb_signer);
 
     if (!bbChanged && !signerChanged) {
       return { name, path: editor.path, action: 'up-to-date' };
@@ -331,8 +375,9 @@ function applyEditorConfig(plan) {
     if (isToml) {
       writeTomlMcpServers(plan.path, plan.mcpConfig);
     } else {
-      plan.settings.mcpServers.bb = plan.mcpConfig.bb;
-      plan.settings.mcpServers.bb_signer = plan.mcpConfig.bb_signer;
+      const servers = ensureMcpServersPath(plan.settings, plan.configStyle);
+      servers.bb = plan.mcpConfig.bb;
+      servers.bb_signer = plan.mcpConfig.bb_signer;
       writeFileSync(plan.path, JSON.stringify(plan.settings, null, 2) + '\n');
     }
     console.log(`  ✅ ${plan.name}: Updated`);
@@ -343,7 +388,12 @@ function applyEditorConfig(plan) {
       writeTomlMcpServers(plan.path, plan.mcpConfig);
     } else {
       ensureDir(plan.path);
-      const settings = { mcpServers: { ...plan.mcpConfig } };
+      let settings;
+      if (plan.configStyle === 'openclaw') {
+        settings = { provider: { mcpServers: { ...plan.mcpConfig } } };
+      } else {
+        settings = { mcpServers: { ...plan.mcpConfig } };
+      }
       writeFileSync(plan.path, JSON.stringify(settings, null, 2) + '\n');
     }
     console.log(`  ✅ ${plan.name}: Configured`);
@@ -358,7 +408,12 @@ function fallbackToSettingsFile(ed, mcpConfig) {
     writeTomlMcpServers(targetPath, mcpConfig);
   } else {
     ensureDir(targetPath);
-    const settings = { mcpServers: { ...mcpConfig } };
+    let settings;
+    if (ed.configStyle === 'openclaw') {
+      settings = { provider: { mcpServers: { ...mcpConfig } } };
+    } else {
+      settings = { mcpServers: { ...mcpConfig } };
+    }
     writeFileSync(targetPath, JSON.stringify(settings, null, 2) + '\n');
   }
   console.log(`  ✅ ${ed.label}: Configured`);
@@ -576,6 +631,7 @@ Quick Install (recommended):
     npx bb-signer install cursor       Configure Cursor
     npx bb-signer install windsurf     Configure Windsurf
     npx bb-signer install codex        Configure Codex CLI
+    npx bb-signer install openclaw     Configure OpenClaw
 
   This command:
   - Creates your agent identity (~/.bb/seed.txt)
@@ -1132,16 +1188,17 @@ async function verify() {
     }
   } catch {}
 
-  // Check other editors (Gemini, Cursor, Windsurf, Codex) via their config files
+  // Check other editors (Gemini, Cursor, Windsurf, Codex, OpenClaw) via their config files
   const otherEditors = Object.entries(EDITORS).filter(([key]) => key !== 'claude' && key !== 'claude-desktop');
   for (const [key, ed] of otherEditors) {
     const editor = findExisting(ed.paths);
     if (editor.exists) {
       const settings = ed.configStyle === 'codex' ? readToml(editor.path) : readJson(editor.path);
-      if (settings && settings.mcpServers?.bb && settings.mcpServers?.bb_signer) {
+      const servers = settings ? getMcpServersFromSettings(settings, ed.configStyle) : null;
+      if (servers?.bb && servers?.bb_signer) {
         console.log(`✅ ${ed.label}: Configured`);
         hasConfig = true;
-      } else if (settings && (settings.mcpServers?.bb || settings.mcpServers?.bb_signer)) {
+      } else if (servers?.bb || servers?.bb_signer) {
         console.log(`⚠️  ${ed.label}: Incomplete config (missing bb or bb_signer)`);
         warnings++;
         hasConfig = true;

package/index.js

@@ -309,6 +309,21 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ["request_id", "topic"],
         },
       },
+      {
+        name: "claim",
+        description: "Claim a REQUEST to signal you intend to fulfill it. Advisory, not exclusive.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            request_id: { type: "string", description: "AEID of the REQUEST to claim" },
+            topic: { type: "string", description: "Topic (should match the request's topic)" },
+            content: { type: "string", description: "Optional note about your approach or ETA" },
+            ttl: { type: "integer", description: "Optional time-to-live in seconds (how long you expect to work on it)" },
+            ...profileProp,
+          },
+          required: ["request_id", "topic"],
+        },
+      },
       {
         name: "comment",
         description: "Add a comment to any BB event.",
@@ -450,7 +465,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               description: "A complete unsigned event object with all required fields.",
               properties: {
                 v: { type: "integer", description: "Protocol version (always 1)" },
-                kind: { type: "string", description: "Event kind: INFO, REQUEST, FULFILL, ACK, CANCEL" },
+                kind: { type: "string", description: "Event kind: INFO, REQUEST, FULFILL, ACK, CANCEL, CLAIM" },
                 agent_pubkey: { type: "string", description: "Your agent's public key (base58)" },
                 created_at: { type: "integer", description: "Timestamp in milliseconds" },
                 topic: { type: "string", description: "Event topic" },
@@ -598,6 +613,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       return ok(result);
     }
 
+    if (name === "claim") {
+      if (!args.request_id) return err("request_id is required");
+      validateTopic(args.topic);
+      const tags = {};
+      if (args.ttl !== undefined && args.ttl !== null) tags.claim_ttl = String(args.ttl);
+      const result = await buildSignSubmit("CLAIM", args.topic, { type: "text", data: args.content || "" }, id, {
+        refs: { request_id: args.request_id },
+        tags: Object.keys(tags).length > 0 ? tags : undefined,
+      });
+      return ok(result);
+    }
+
     if (name === "comment") {
       if (!args.parent_aeid) return err("parent_aeid is required");
       validateTopic(args.topic);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bb-signer",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Minimal local signer for BB - signs events for the agent collaboration network",
   "type": "module",
   "main": "index.js",
@@ -17,6 +17,7 @@
     "cursor",
     "windsurf",
     "codex",
+    "openclaw",
     "openai",
     "ai",
     "agents",