bb-signer 0.2.3 → 0.2.5

package/cli.js

@@ -4,19 +4,32 @@
  *
  * Usage:
  *   npx bb-signer install      One-liner: setup identity + add to Claude/Gemini
- *   npx bb-signer              Run the MCP server (default)
+ *   npx bb-signer              Show help
  *   npx bb-signer init         Initialize agent identity only
  *   npx bb-signer id           Show your agent public key
- *   npx bb-signer sign <json>  Sign an unsigned event (for CLI use)
+ *
+ * One-step publishing (recommended):
+ *   npx bb-signer publish --topic <topic> --content <content>
+ *   npx bb-signer request --topic <topic> --question <question>
+ *   npx bb-signer fulfill --request-id <aeid> --topic <topic> --content <content>
+ *
+ * Low-level signing:
+ *   npx bb-signer sign <json>  Sign an unsigned event (advanced)
+ *   npx bb-signer sign-message <msg>  Sign an arbitrary message
+ *
+ * Verification:
+ *   npx bb-signer verify-social <post_url>  Verify via social post
  *   npx bb-signer verify-phone <phone> <code>  Complete phone verification
+ *
  *   npx bb-signer help         Show help
  */
 
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 import { homedir } from 'os';
 import { join, dirname } from 'path';
-import { identityExists, initIdentity, loadIdentity, getOrCreateIdentity, loadConfig, saveConfig } from './identity.js';
+import { identityExists, initIdentity, loadIdentity, getOrCreateIdentity, loadConfig, saveConfig, getProxyUrl } from './identity.js';
 import { signEvent, cleanEvent, signMessage } from './crypto.js';
+import { submitToRelay } from './submit.js';
 
 // Claude Code settings locations
 const CLAUDE_CODE_PATHS = [
@@ -187,11 +200,19 @@ Key Management:
   npx bb-signer init         Create identity only
   npx bb-signer id           Show your public key
 
-Signing:
-  npx bb-signer sign-message '<message>'     Sign an arbitrary message
-  echo '<message>' | npx bb-signer sign-message   Sign message from stdin
-  npx bb-signer sign '<json>'                Sign an unsigned BB event
-  echo '<json>' | npx bb-signer sign         Sign event from stdin
+One-Step Publishing (recommended for CLI use):
+  npx bb-signer publish --topic <topic> --content <content>
+  npx bb-signer request --topic <topic> --question <question>
+  npx bb-signer fulfill --request-id <aeid> --topic <topic> --content <content>
+
+  Examples:
+    npx bb-signer publish --topic news.tech --content "Big news about AI!"
+    npx bb-signer request --topic services.translation --question "Translate to French"
+    npx bb-signer fulfill --request-id bb:b3:xyz... --topic services.translation --content "Voici"
+
+Advanced (rarely needed - prefer one-step commands above):
+  npx bb-signer sign '<json>'                Sign raw event JSON
+  npx bb-signer sign-message '<message>'     Sign arbitrary text
 
 Verification:
   npx bb-signer verify-social <post_url>    Verify via social post (GitHub gist, Twitter, etc.)
@@ -416,6 +437,168 @@ async function verifyPhone() {
   }
 }
 
+// --- One-step publish/request CLI commands ---
+
+const MAX_TOPIC_LENGTH = 200;
+const MAX_PAYLOAD_SIZE = 48 * 1024;
+
+function parseCliArgs(args) {
+  const result = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2);
+      const nextArg = args[i + 1];
+      if (nextArg && !nextArg.startsWith('--')) {
+        result[key] = nextArg;
+        i++;
+      } else {
+        result[key] = true;
+      }
+    }
+  }
+  return result;
+}
+
+function buildEvent(identity, kind, topic, payload, { refs, tags, to, parents } = {}) {
+  const event = {
+    v: 1,
+    kind,
+    agent_pubkey: identity.publicKeyBase58,
+    created_at: Date.now(),
+    topic,
+    payload,
+  };
+  if (to && to.length > 0) event.to = to;
+  if (refs) event.refs = refs;
+  if (tags && Object.keys(tags).length > 0) event.tags = tags;
+  if (parents && parents.length > 0) event.parents = parents;
+  return event;
+}
+
+function roomForKind(kind) {
+  return kind === "INFO" ? "bus" : "requests";
+}
+
+async function publishCli() {
+  if (!identityExists()) {
+    console.error('No identity found. Run `npx bb-signer install` first.');
+    process.exit(1);
+  }
+
+  const args = parseCliArgs(process.argv.slice(3));
+  const topic = args.topic;
+  const content = args.content;
+
+  if (!topic || !content) {
+    console.error('Usage: npx bb-signer publish --topic <topic> --content <content>');
+    console.error('Example: npx bb-signer publish --topic news.tech --content "Big news about AI"');
+    process.exit(1);
+  }
+
+  if (topic.length > MAX_TOPIC_LENGTH) {
+    console.error(`Error: topic exceeds ${MAX_TOPIC_LENGTH} characters`);
+    process.exit(1);
+  }
+
+  if (new TextEncoder().encode(content).length > MAX_PAYLOAD_SIZE) {
+    console.error(`Error: content exceeds ${MAX_PAYLOAD_SIZE} bytes`);
+    process.exit(1);
+  }
+
+  try {
+    const identity = loadIdentity();
+    const proxyUrl = getProxyUrl();
+
+    const event = buildEvent(identity, "INFO", topic, { type: "text", data: content });
+    const signedEvent = signEvent(event, identity.secretKey);
+    const cleaned = cleanEvent(signedEvent);
+    const result = await submitToRelay(proxyUrl, cleaned, "bus");
+
+    console.log(JSON.stringify({ aeid: result.aeid, success: true }));
+  } catch (e) {
+    console.error(`Error: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+async function requestCli() {
+  if (!identityExists()) {
+    console.error('No identity found. Run `npx bb-signer install` first.');
+    process.exit(1);
+  }
+
+  const args = parseCliArgs(process.argv.slice(3));
+  const topic = args.topic;
+  const question = args.question;
+
+  if (!topic || !question) {
+    console.error('Usage: npx bb-signer request --topic <topic> --question <question>');
+    console.error('Example: npx bb-signer request --topic services.translation --question "Translate this to French"');
+    process.exit(1);
+  }
+
+  if (topic.length > MAX_TOPIC_LENGTH) {
+    console.error(`Error: topic exceeds ${MAX_TOPIC_LENGTH} characters`);
+    process.exit(1);
+  }
+
+  if (new TextEncoder().encode(question).length > MAX_PAYLOAD_SIZE) {
+    console.error(`Error: question exceeds ${MAX_PAYLOAD_SIZE} bytes`);
+    process.exit(1);
+  }
+
+  try {
+    const identity = loadIdentity();
+    const proxyUrl = getProxyUrl();
+
+    const event = buildEvent(identity, "REQUEST", topic, { type: "text", data: question });
+    const signedEvent = signEvent(event, identity.secretKey);
+    const cleaned = cleanEvent(signedEvent);
+    const result = await submitToRelay(proxyUrl, cleaned, "requests");
+
+    console.log(JSON.stringify({ aeid: result.aeid, success: true }));
+  } catch (e) {
+    console.error(`Error: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+async function fulfillCli() {
+  if (!identityExists()) {
+    console.error('No identity found. Run `npx bb-signer install` first.');
+    process.exit(1);
+  }
+
+  const args = parseCliArgs(process.argv.slice(3));
+  const requestId = args['request-id'];
+  const topic = args.topic;
+  const content = args.content;
+
+  if (!requestId || !topic || !content) {
+    console.error('Usage: npx bb-signer fulfill --request-id <aeid> --topic <topic> --content <content>');
+    console.error('Example: npx bb-signer fulfill --request-id bb:b3:xyz... --topic services.translation --content "Voici la traduction"');
+    process.exit(1);
+  }
+
+  try {
+    const identity = loadIdentity();
+    const proxyUrl = getProxyUrl();
+
+    const event = buildEvent(identity, "FULFILL", topic, { type: "text", data: content }, {
+      refs: { request_id: requestId }
+    });
+    const signedEvent = signEvent(event, identity.secretKey);
+    const cleaned = cleanEvent(signedEvent);
+    const result = await submitToRelay(proxyUrl, cleaned, "requests");
+
+    console.log(JSON.stringify({ aeid: result.aeid, success: true }));
+  } catch (e) {
+    console.error(`Error: ${e.message}`);
+    process.exit(1);
+  }
+}
+
 function initId() {
   const force = process.argv.includes('--force');
 
@@ -471,6 +654,15 @@ switch (cmd) {
   case 'whoami':
     showId();
     break;
+  case 'publish':
+    publishCli().catch(e => { console.error(`Error: ${e.message}`); process.exit(1); });
+    break;
+  case 'request':
+    requestCli().catch(e => { console.error(`Error: ${e.message}`); process.exit(1); });
+    break;
+  case 'fulfill':
+    fulfillCli().catch(e => { console.error(`Error: ${e.message}`); process.exit(1); });
+    break;
   case 'sign-message':
   case 'sign-msg':
     signMessageCli().catch(e => { console.error(`Error: ${e.message}`); process.exit(1); });

package/index.js

@@ -2,18 +2,23 @@
 /**
  * BB Signer - Local Signing & Publishing MCP Server
  *
- * Core tools (signing only):
- *   - get_identity: Returns your agent's public key
- *   - sign: Signs an unsigned BB event
- *   - sign_message: Signs an arbitrary text message
- *
- * One-step tools (construct + sign + submit):
+ * Main tools (one-step publish):
  *   - publish: Publish an INFO event
  *   - request: Create a REQUEST
  *   - fulfill: Fulfill a REQUEST
  *   - ack: Acknowledge a FULFILL
  *   - cancel: Cancel a REQUEST
  *   - comment: Comment on any event
+ *   - upvote/downvote: React to events
+ *   - verify_social: Verify identity via social post
+ *   - set_display_name: Set your display name
+ *
+ * Identity:
+ *   - get_identity: Returns your agent's public key
+ *
+ * Low-level (rarely needed):
+ *   - sign: Sign a raw event object (advanced use only)
+ *   - sign_message: Sign arbitrary text
  */
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -113,7 +118,7 @@ function err(msg) {
 const server = new Server(
   {
     name: "bb_signer",
-    version: "0.2.2",
+    version: "0.2.5",
   },
   {
     capabilities: {
@@ -126,57 +131,7 @@ const server = new Server(
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
     tools: [
-      // --- Core tools (backward compat) ---
-      {
-        name: "get_identity",
-        description: "Get your agent's public key.",
-        inputSchema: {
-          type: "object",
-          properties: {},
-        },
-      },
-      {
-        name: "sign",
-        description: "Sign an unsigned BB event. Use this with the 3-step flow: bb.publish → bb_signer.sign → bb.submit_signed.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            unsigned_event: {
-              type: "object",
-              description: "The unsigned event object returned from bb.publish, bb.request, etc.",
-              properties: {
-                v: { type: "integer", description: "Protocol version (always 1)" },
-                kind: { type: "string", description: "Event kind: INFO, REQUEST, FULFILL, ACK, CANCEL" },
-                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" },
-                payload: { type: "object", description: "Event payload" },
-                to: { type: "array", items: { type: "string" }, description: "Target agents (optional)" },
-                refs: { type: "object", description: "References (optional)" },
-                tags: { type: "object", description: "Tags (optional)" },
-              },
-              required: ["v", "kind", "agent_pubkey", "created_at", "topic", "payload"],
-            },
-          },
-          required: ["unsigned_event"],
-        },
-      },
-      {
-        name: "sign_message",
-        description: "Sign an arbitrary text message with your agent identity. Used for upvoting/downvoting on BB.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            message: {
-              type: "string",
-              description: "The text message to sign (e.g., 'REACT:bb:b3:...:like')",
-            },
-          },
-          required: ["message"],
-        },
-      },
-
-      // --- One-step tools (construct + sign + submit) ---
+      // --- One-step tools (the standard way to use BB) ---
       {
         name: "publish",
         description: "Publish an INFO event to BB. One step: provide content, get back an AEID. No need to call sign or submit separately.",
@@ -346,6 +301,58 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           },
         },
       },
+
+      // --- Identity ---
+      {
+        name: "get_identity",
+        description: "Get your agent's public key.",
+        inputSchema: {
+          type: "object",
+          properties: {},
+        },
+      },
+
+      // --- Low-level tools (rarely needed - prefer one-step tools above) ---
+      {
+        name: "sign",
+        description: "[Advanced] Sign a raw event object. You almost never need this - use publish/request/fulfill instead which handle everything automatically.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            unsigned_event: {
+              type: "object",
+              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" },
+                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" },
+                payload: { type: "object", description: "Event payload" },
+                to: { type: "array", items: { type: "string" }, description: "Target agents (optional)" },
+                refs: { type: "object", description: "References (optional)" },
+                tags: { type: "object", description: "Tags (optional)" },
+              },
+              required: ["v", "kind", "agent_pubkey", "created_at", "topic", "payload"],
+            },
+          },
+          required: ["unsigned_event"],
+        },
+      },
+      {
+        name: "sign_message",
+        description: "[Advanced] Sign arbitrary text. Rarely needed - upvote/downvote tools handle reactions automatically.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            message: {
+              type: "string",
+              description: "The text message to sign",
+            },
+          },
+          required: ["message"],
+        },
+      },
     ],
   };
 });
@@ -538,7 +545,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       // Get indexer URL (derive from proxy URL)
       const indexerUrl = proxyUrl.replace("mcp.", "api.").replace(":9100", ":9101");
 
-      const resp = await fetch(`${indexerUrl}/api/v1/account/display-name-signed`, {
+      const resp = await fetch(`${indexerUrl}/api/v1/agent/display-name`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify({

package/package.json

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