agentbnb 7.0.0 → 8.0.1

package/dist/skills/agentbnb/bootstrap.js

@@ -67,9 +67,10 @@ import {
 } from "../../chunk-3LWBH7P3.js";
 
 // skills/agentbnb/bootstrap.ts
-import { join as join5 } from "path";
+import { join as join5, basename, dirname as dirname4 } from "path";
 import { homedir as homedir2 } from "os";
-import { spawnSync } from "child_process";
+import { spawnSync, exec } from "child_process";
+import { promisify as promisify2 } from "util";
 import { randomUUID as randomUUID10 } from "crypto";
 
 // src/runtime/process-guard.ts
@@ -6735,6 +6736,7 @@ function isNetworkError(err) {
 }
 
 // skills/agentbnb/bootstrap.ts
+var execAsync = promisify2(exec);
 function resolveWorkspaceDir() {
   if (process.env["AGENTBNB_DIR"]) {
     return process.env["AGENTBNB_DIR"];
@@ -6807,7 +6809,58 @@ function registerDecomposerCard(configDir, owner) {
     );
   }
 }
-async function activate(config = {}) {
+function findCli() {
+  const result = spawnSync("which", ["agentbnb"], { encoding: "utf-8", stdio: "pipe" });
+  if (result.status === 0 && result.stdout.trim()) {
+    return result.stdout.trim();
+  }
+  return null;
+}
+async function runCommand(cmd, env) {
+  return execAsync(cmd, { env });
+}
+function deriveAgentName(configDir) {
+  const parent = basename(dirname4(configDir));
+  if (parent && parent !== "." && parent !== ".agentbnb" && parent !== homedir2().split("/").pop()) {
+    return parent;
+  }
+  return `agent-${randomUUID10().slice(0, 8)}`;
+}
+var defaultDeps = { findCli, runCommand };
+async function autoOnboard(configDir, deps = defaultDeps) {
+  process.stderr.write("[agentbnb] First-time setup: initializing agent identity...\n");
+  const cliPath = deps.findCli();
+  if (!cliPath) {
+    process.stderr.write("[agentbnb] CLI not found. Run: npm install -g agentbnb\n");
+    throw new AgentBnBError(
+      "agentbnb CLI not found in PATH. Install with: npm install -g agentbnb",
+      "INIT_FAILED"
+    );
+  }
+  const env = { ...process.env, AGENTBNB_DIR: configDir };
+  const agentName = deriveAgentName(configDir);
+  try {
+    await deps.runCommand(`agentbnb init --owner "${agentName}" --yes --no-detect`, env);
+    process.stderr.write(`[agentbnb] Agent "${agentName}" initialized.
+`);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new AgentBnBError(`Auto-init failed: ${msg}`, "INIT_FAILED");
+  }
+  try {
+    await deps.runCommand("agentbnb openclaw sync", env);
+    process.stderr.write("[agentbnb] Capabilities published from SOUL.md.\n");
+  } catch {
+    process.stderr.write("[agentbnb] Note: openclaw sync skipped (SOUL.md may not exist yet).\n");
+  }
+  const config = loadConfig();
+  if (!config) {
+    throw new AgentBnBError("AgentBnB config still not found after auto-init", "CONFIG_NOT_FOUND");
+  }
+  process.stderr.write("[agentbnb] Agent initialized and published to AgentBnB network.\n");
+  return config;
+}
+async function activate(config = {}, _onboardDeps) {
   if (config.agentDir) {
     process.env["AGENTBNB_DIR"] = config.agentDir;
     process.stderr.write(
@@ -6838,19 +6891,7 @@ async function activate(config = {}) {
   }
   let agentConfig = loadConfig();
   if (!agentConfig) {
-    const result = spawnSync("agentbnb", ["init", "--yes", "--no-detect"], {
-      stdio: "pipe",
-      env: { ...process.env },
-      encoding: "utf-8"
-    });
-    if (result.error || result.status !== 0) {
-      const msg = result.error?.message ?? result.stderr?.trim() ?? "agentbnb init failed";
-      throw new AgentBnBError(`Auto-init failed: ${msg}`, "INIT_FAILED");
-    }
-    agentConfig = loadConfig();
-    if (!agentConfig) {
-      throw new AgentBnBError("AgentBnB config still not found after auto-init", "CONFIG_NOT_FOUND");
-    }
+    agentConfig = await autoOnboard(configDir, _onboardDeps);
   }
   process.stderr.write(
     `[agentbnb] activate: owner=${agentConfig.owner} config=${configDir}/config.json
@@ -6896,5 +6937,7 @@ async function deactivate(ctx) {
 }
 export {
   activate,
-  deactivate
+  deactivate,
+  findCli,
+  runCommand
 };

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "7.0.0",
+  "version": "8.0.1",
   "description": "P2P Agent Capability Sharing Protocol — Airbnb for AI agent pipelines",
   "type": "module",
   "main": "dist/index.js",

package/skills/agentbnb/bootstrap.test.ts

@@ -55,7 +55,7 @@ vi.mock('../../src/registry/store.js', () => ({
 
 import { loadConfig } from '../../src/cli/config.js';
 import { activate, deactivate } from './bootstrap.js';
-import type { BootstrapContext } from './bootstrap.js';
+import type { BootstrapContext, OnboardDeps } from './bootstrap.js';
 
 const mockLoadConfig = vi.mocked(loadConfig);
 
@@ -104,16 +104,71 @@ describe('bootstrap activate/deactivate lifecycle', () => {
   });
 
   // ---------------------------------------------------------------------------
-  // Test 1: CONFIG_NOT_FOUND when no config exists
+  // Test 1: INIT_FAILED when CLI not found and config missing
   // ---------------------------------------------------------------------------
-  it('activate() throws CONFIG_NOT_FOUND when config is missing', async () => {
+  it('activate() throws INIT_FAILED when CLI not found and config missing', async () => {
     mockLoadConfig.mockReturnValue(null);
+    const deps: OnboardDeps = {
+      findCli: () => null,
+      runCommand: vi.fn(),
+    };
 
-    await expect(activate()).rejects.toMatchObject({
-      code: 'CONFIG_NOT_FOUND',
+    await expect(activate({}, deps)).rejects.toMatchObject({
+      code: 'INIT_FAILED',
     });
   });
 
+  // ---------------------------------------------------------------------------
+  // Test 1b: Auto-onboard runs init + openclaw sync when config missing
+  // ---------------------------------------------------------------------------
+  it('activate() auto-onboards when config missing and CLI available', async () => {
+    mockLoadConfig.mockReturnValueOnce(null).mockReturnValue(MINIMAL_CONFIG as ReturnType<typeof loadConfig>);
+    const mockRun = vi.fn().mockResolvedValue({ stdout: '', stderr: '' });
+    const deps: OnboardDeps = {
+      findCli: () => '/usr/local/bin/agentbnb',
+      runCommand: mockRun,
+    };
+
+    ctx = await activate({}, deps);
+
+    expect(mockRun).toHaveBeenCalledTimes(2);
+    expect(mockRun.mock.calls[0][0]).toMatch(/agentbnb init --owner .* --yes --no-detect/);
+    expect(mockRun.mock.calls[1][0]).toBe('agentbnb openclaw sync');
+  });
+
+  // ---------------------------------------------------------------------------
+  // Test 1c: Auto-onboard continues if openclaw sync fails
+  // ---------------------------------------------------------------------------
+  it('activate() continues if openclaw sync fails during auto-onboard', async () => {
+    mockLoadConfig.mockReturnValueOnce(null).mockReturnValue(MINIMAL_CONFIG as ReturnType<typeof loadConfig>);
+    const mockRun = vi.fn()
+      .mockResolvedValueOnce({ stdout: '', stderr: '' })
+      .mockRejectedValueOnce(new Error('SOUL.md not found'));
+    const deps: OnboardDeps = {
+      findCli: () => '/usr/local/bin/agentbnb',
+      runCommand: mockRun,
+    };
+
+    ctx = await activate({}, deps);
+
+    expect(ctx.startDisposition).toBe('started');
+  });
+
+  // ---------------------------------------------------------------------------
+  // Test 1d: Skips auto-onboard when config already exists
+  // ---------------------------------------------------------------------------
+  it('activate() skips auto-onboard when config already exists', async () => {
+    const mockRun = vi.fn();
+    const deps: OnboardDeps = {
+      findCli: () => '/usr/local/bin/agentbnb',
+      runCommand: mockRun,
+    };
+
+    ctx = await activate({}, deps);
+
+    expect(mockRun).not.toHaveBeenCalled();
+  });
+
   // ---------------------------------------------------------------------------
   // Test 2: BootstrapContext shape
   // ---------------------------------------------------------------------------

package/skills/agentbnb/bootstrap.ts

@@ -8,12 +8,15 @@
  * Teardown: `await deactivate(ctx);`
  */
 
-import { join } from 'node:path';
+import { join, basename, dirname } from 'node:path';
 import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { spawnSync } from 'node:child_process';
+import { spawnSync, exec } from 'node:child_process';
+import { promisify } from 'node:util';
 import { randomUUID } from 'node:crypto';
 
+const execAsync = promisify(exec);
+
 /**
  * Derives a workspace-specific AGENTBNB_DIR using a priority chain:
  *
@@ -170,6 +173,109 @@ function registerDecomposerCard(configDir: string, owner: string): void {
   }
 }
 
+/**
+ * Checks if the `agentbnb` CLI is available in PATH.
+ * @returns Absolute path to the CLI, or null if not found.
+ */
+export function findCli(): string | null {
+  const result = spawnSync('which', ['agentbnb'], { encoding: 'utf-8', stdio: 'pipe' });
+  if (result.status === 0 && result.stdout.trim()) {
+    return result.stdout.trim();
+  }
+  return null;
+}
+
+/**
+ * Runs a shell command asynchronously. Exported for test injection.
+ */
+export async function runCommand(cmd: string, env: Record<string, string | undefined>): Promise<{ stdout: string; stderr: string }> {
+  return execAsync(cmd, { env });
+}
+
+/**
+ * Derives a human-readable agent name from the config directory path.
+ * If configDir is `~/.openclaw/agents/genesis-bot/.agentbnb`, returns "genesis-bot".
+ * Falls back to a random identifier.
+ */
+function deriveAgentName(configDir: string): string {
+  // configDir is typically <workspace>/.agentbnb — parent dir is the agent workspace
+  const parent = basename(dirname(configDir));
+  if (parent && parent !== '.' && parent !== '.agentbnb' && parent !== homedir().split('/').pop()) {
+    return parent;
+  }
+  return `agent-${randomUUID().slice(0, 8)}`;
+}
+
+/**
+ * First-time auto-onboarding: initializes identity, publishes capabilities, and
+ * grants the Demand Voucher (50 credits). Called when activate() detects no config.json.
+ *
+ * Steps:
+ * 1. Check agentbnb CLI is available
+ * 2. Run `agentbnb init --owner <name> --yes --no-detect` (keypair + config)
+ * 3. Run `agentbnb openclaw sync` (publish SOUL.md capabilities)
+ * 4. Demand Voucher is auto-issued by the registry on first registration
+ *
+ * @param configDir - The AGENTBNB_DIR for this agent.
+ * @returns The loaded AgentBnBConfig after init.
+ * @throws {AgentBnBError} INIT_FAILED if CLI not found or init fails.
+ */
+/** Injectable dependencies for autoOnboard (test seam). */
+export interface OnboardDeps {
+  findCli: () => string | null;
+  runCommand: (cmd: string, env: Record<string, string | undefined>) => Promise<{ stdout: string; stderr: string }>;
+}
+
+/** Default production dependencies. */
+const defaultDeps: OnboardDeps = { findCli, runCommand };
+
+async function autoOnboard(configDir: string, deps: OnboardDeps = defaultDeps): Promise<import('./../../src/cli/config.js').AgentBnBConfig> {
+  process.stderr.write('[agentbnb] First-time setup: initializing agent identity...\n');
+
+  // Step 0: Check CLI exists
+  const cliPath = deps.findCli();
+  if (!cliPath) {
+    process.stderr.write('[agentbnb] CLI not found. Run: npm install -g agentbnb\n');
+    throw new AgentBnBError(
+      'agentbnb CLI not found in PATH. Install with: npm install -g agentbnb',
+      'INIT_FAILED',
+    );
+  }
+
+  const env = { ...process.env, AGENTBNB_DIR: configDir };
+  const agentName = deriveAgentName(configDir);
+
+  // Step 1: Initialize identity (keypair + config.json + credit bootstrap)
+  try {
+    await deps.runCommand(`agentbnb init --owner "${agentName}" --yes --no-detect`, env);
+    process.stderr.write(`[agentbnb] Agent "${agentName}" initialized.\n`);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new AgentBnBError(`Auto-init failed: ${msg}`, 'INIT_FAILED');
+  }
+
+  // Step 2: Publish capabilities from SOUL.md (if it exists)
+  try {
+    await deps.runCommand('agentbnb openclaw sync', env);
+    process.stderr.write('[agentbnb] Capabilities published from SOUL.md.\n');
+  } catch {
+    // Non-fatal: SOUL.md may not exist yet, or sync may fail for other reasons.
+    // Agent is still initialized and can publish capabilities later.
+    process.stderr.write('[agentbnb] Note: openclaw sync skipped (SOUL.md may not exist yet).\n');
+  }
+
+  // Step 3: Demand Voucher (50 credits) is auto-issued by bootstrapAgent() during init.
+  // No action needed here.
+
+  const config = loadConfig();
+  if (!config) {
+    throw new AgentBnBError('AgentBnB config still not found after auto-init', 'CONFIG_NOT_FOUND');
+  }
+
+  process.stderr.write('[agentbnb] Agent initialized and published to AgentBnB network.\n');
+  return config;
+}
+
 /**
  * Brings an AgentBnB node online (idempotent — safe to call when already running).
  * Registers SIGTERM/SIGINT handlers that conditionally stop the node on process exit.
@@ -179,7 +285,7 @@ function registerDecomposerCard(configDir: string, owner: string): void {
  * TODO: Once ServiceCoordinator gains its own signal handling, remove the handlers
  * registered here to avoid double-handler conflicts. Track in Layer A implementation.
  */
-export async function activate(config: BootstrapConfig = {}): Promise<BootstrapContext> {
+export async function activate(config: BootstrapConfig = {}, _onboardDeps?: OnboardDeps): Promise<BootstrapContext> {
   // Per-workspace isolation: determine the correct config directory.
   // Priority: config.agentDir > config.workspaceDir/.agentbnb > AGENTBNB_DIR env > resolveWorkspaceDir()
   if (config.agentDir) {
@@ -211,20 +317,8 @@ export async function activate(config: BootstrapConfig = {}): Promise<BootstrapC
 
   let agentConfig = loadConfig();
   if (!agentConfig) {
-    // Auto-init for first-time OpenClaw plugin activation
-    const result = spawnSync('agentbnb', ['init', '--yes', '--no-detect'], {
-      stdio: 'pipe',
-      env: { ...process.env },
-      encoding: 'utf-8',
-    });
-    if (result.error || result.status !== 0) {
-      const msg = result.error?.message ?? (result.stderr as string | null)?.trim() ?? 'agentbnb init failed';
-      throw new AgentBnBError(`Auto-init failed: ${msg}`, 'INIT_FAILED');
-    }
-    agentConfig = loadConfig();
-    if (!agentConfig) {
-      throw new AgentBnBError('AgentBnB config still not found after auto-init', 'CONFIG_NOT_FOUND');
-    }
+    // First-time setup: auto-onboard this agent onto the AgentBnB network.
+    agentConfig = await autoOnboard(configDir, _onboardDeps);
   }
 
   // Print startup diagnostic so it's always visible in agent logs.