agentbnb 4.0.1 → 4.0.4

package/skills/agentbnb/bootstrap.ts

@@ -0,0 +1,126 @@
+/**
+ * AgentBnB Bootstrap — single-call OpenClaw skill lifecycle entry point.
+ *
+ * Usage: `const ctx = await activate({ owner: 'alice', soulMdPath: './SOUL.md' });`
+ * Teardown: `await deactivate(ctx);`
+ */
+
+import { existsSync, readFileSync } from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import type { FastifyInstance } from 'fastify';
+
+import { AgentRuntime } from '../../src/runtime/agent-runtime.js';
+import { publishFromSoulV2 } from '../../src/openclaw/soul-sync.js';
+import { createGatewayServer } from '../../src/gateway/server.js';
+import { IdleMonitor } from '../../src/autonomy/idle-monitor.js';
+import { DEFAULT_AUTONOMY_CONFIG } from '../../src/autonomy/tiers.js';
+import { AgentBnBError } from '../../src/types/index.js';
+import { ensureIdentity, type AgentIdentity } from '../../src/identity/identity.js';
+import type { AutonomyConfig } from '../../src/autonomy/tiers.js';
+import type { CapabilityCardV2 } from '../../src/types/index.js';
+
+/** Configuration for bringing an AgentBnB agent online. */
+export interface BootstrapConfig {
+  /** Agent owner identifier. */
+  owner: string;
+  /** Absolute path to SOUL.md. */
+  soulMdPath: string;
+  /** Registry DB path. Defaults to ~/.agentbnb/registry.db */
+  registryDbPath?: string;
+  /** Credit DB path. Defaults to ~/.agentbnb/credit.db */
+  creditDbPath?: string;
+  /** Gateway port. Defaults to 7700. */
+  gatewayPort?: number;
+  /** Bearer token for gateway auth. Defaults to a random UUID. */
+  gatewayToken?: string;
+  /** Handler URL for capability forwarding. Defaults to http://localhost:{gatewayPort}. */
+  handlerUrl?: string;
+  /** Autonomy tier config. Defaults to DEFAULT_AUTONOMY_CONFIG (Tier 3). */
+  autonomyConfig?: AutonomyConfig;
+  /** Suppress gateway logs. Defaults to false. */
+  silent?: boolean;
+  /** When true, ensures identity.json exists on activate. Defaults to true. */
+  identityRequired?: boolean;
+}
+
+/** Live handles returned by activate(). Pass to deactivate() for clean teardown. */
+export interface BootstrapContext {
+  /** AgentRuntime managing DBs and background job lifecycle. */
+  runtime: AgentRuntime;
+  /** Fastify gateway HTTP server instance. */
+  gateway: FastifyInstance;
+  /** IdleMonitor background loop. */
+  idleMonitor: IdleMonitor;
+  /** Published CapabilityCard derived from SOUL.md. */
+  card: CapabilityCardV2;
+  /** Agent identity (created/loaded during activation). */
+  identity: AgentIdentity | null;
+}
+
+/**
+ * Brings an agent fully online: Runtime -> publishCard -> gateway.listen -> IdleMonitor.
+ * @throws {AgentBnBError} FILE_NOT_FOUND if SOUL.md does not exist.
+ */
+export async function activate(config: BootstrapConfig): Promise<BootstrapContext> {
+  const {
+    owner,
+    soulMdPath,
+    registryDbPath = join(homedir(), '.agentbnb', 'registry.db'),
+    creditDbPath = join(homedir(), '.agentbnb', 'credit.db'),
+    gatewayPort = 7700,
+    gatewayToken = randomUUID(),
+    autonomyConfig = DEFAULT_AUTONOMY_CONFIG,
+    silent = false,
+  } = config;
+
+  const identityRequired = config.identityRequired ?? false;
+  const handlerUrl = config.handlerUrl ?? `http://localhost:${gatewayPort}`;
+
+  if (!existsSync(soulMdPath)) {
+    throw new AgentBnBError(`SOUL.md not found at path: ${soulMdPath}`, 'FILE_NOT_FOUND');
+  }
+  const soulContent = readFileSync(soulMdPath, 'utf8');
+
+  const runtime = new AgentRuntime({ registryDbPath, creditDbPath, owner });
+  await runtime.start();
+
+  // Ensure agent identity exists (idempotent — preserves existing identity)
+  let identity: AgentIdentity | null = null;
+  if (identityRequired) {
+    const configDir = join(homedir(), '.agentbnb');
+    identity = ensureIdentity(configDir, owner);
+  }
+
+  const card = publishFromSoulV2(runtime.registryDb, soulContent, owner);
+
+  const gateway = createGatewayServer({
+    port: gatewayPort,
+    registryDb: runtime.registryDb,
+    creditDb: runtime.creditDb,
+    tokens: [gatewayToken],
+    handlerUrl,
+    silent,
+  });
+  await gateway.listen({ port: gatewayPort, host: '0.0.0.0' });
+
+  const idleMonitor = new IdleMonitor({ owner, db: runtime.registryDb, autonomyConfig });
+  const idleJob = idleMonitor.start();
+  runtime.registerJob(idleJob);
+
+  return { runtime, gateway, idleMonitor, card, identity };
+}
+
+/**
+ * Tears down all active components: gateway.close() then runtime.shutdown().
+ * Idempotent — safe to call multiple times.
+ */
+export async function deactivate(ctx: BootstrapContext): Promise<void> {
+  try {
+    await ctx.gateway.close();
+    await ctx.runtime.shutdown();
+  } catch {
+    // Swallow errors — idempotent teardown
+  }
+}

package/skills/agentbnb/credit-mgr.ts

@@ -0,0 +1,11 @@
+/**
+ * AgentBnB Credit Management adapter for OpenClaw skill integration.
+ * Delegates to BudgetManager and getBalance from src/credit/.
+ * This is a thin re-export wrapper — no business logic lives here.
+ */
+import { BudgetManager, DEFAULT_BUDGET_CONFIG } from '../../src/credit/budget.js';
+import { getBalance } from '../../src/credit/ledger.js';
+import type { BudgetConfig } from '../../src/credit/budget.js';
+
+export { BudgetManager, DEFAULT_BUDGET_CONFIG, getBalance };
+export type { BudgetConfig };

package/skills/agentbnb/gateway.ts

@@ -0,0 +1,12 @@
+/**
+ * AgentBnB Gateway adapter for OpenClaw skill integration.
+ * Delegates to AgentRuntime and createGatewayServer from src/.
+ * This is a thin re-export wrapper — no business logic lives here.
+ */
+import { AgentRuntime } from '../../src/runtime/agent-runtime.js';
+import { createGatewayServer } from '../../src/gateway/server.js';
+import type { RuntimeOptions } from '../../src/runtime/agent-runtime.js';
+import type { GatewayOptions } from '../../src/gateway/server.js';
+
+export { AgentRuntime, createGatewayServer };
+export type { RuntimeOptions, GatewayOptions };

package/skills/agentbnb/install.sh

@@ -0,0 +1,210 @@
+#!/usr/bin/env bash
+# install.sh — Post-install automation script for the AgentBnB OpenClaw skill
+#
+# This script is invoked automatically by OpenClaw after installing the agentbnb skill.
+# It handles the full technical setup so a new agent can join the AgentBnB network
+# without reading any documentation or performing any manual steps.
+#
+# Usage:
+#   bash install.sh
+#
+# What it does:
+#   1. Checks Node.js >= 20 and pnpm are available
+#   2. Installs the agentbnb CLI globally
+#   3. Initializes the ~/.agentbnb/ config directory with defaults
+#   4. Syncs capabilities from SOUL.md if one is found
+#   5. Prints a success summary and next steps
+
+set -euo pipefail
+
+# ---------------------------------------------------------------------------
+# Color helpers (graceful fallback for non-color terminals)
+# ---------------------------------------------------------------------------
+if [ -t 1 ] && command -v tput &>/dev/null && tput colors &>/dev/null 2>&1; then
+  GREEN=$(tput setaf 2)
+  YELLOW=$(tput setaf 3)
+  RED=$(tput setaf 1)
+  BOLD=$(tput bold)
+  RESET=$(tput sgr0)
+else
+  GREEN=""
+  YELLOW=""
+  RED=""
+  BOLD=""
+  RESET=""
+fi
+
+ok()   { echo "${GREEN}✓${RESET} $*"; }
+warn() { echo "${YELLOW}⚠${RESET} $*"; }
+err()  { echo "${RED}✗${RESET} $*" >&2; }
+step() { echo ""; echo "${BOLD}$*${RESET}"; }
+
+# ---------------------------------------------------------------------------
+# Step 1: Check prerequisites
+# ---------------------------------------------------------------------------
+step "Step 1/5 — Checking prerequisites"
+
+# Node.js >= 20
+if ! command -v node &>/dev/null; then
+  err "Node.js not found. Please install Node.js 20+ from https://nodejs.org"
+  exit 1
+fi
+
+NODE_VERSION=$(node --version | sed 's/v//' | cut -d. -f1)
+if [ "$NODE_VERSION" -lt 20 ]; then
+  err "Node.js >= 20 required (found v${NODE_VERSION}). Please upgrade: https://nodejs.org"
+  exit 1
+fi
+
+ok "Node.js $(node --version) found"
+
+# pnpm (attempt install if missing)
+if ! command -v pnpm &>/dev/null; then
+  warn "pnpm not found — attempting to install via npm"
+  if npm install -g pnpm 2>/dev/null; then
+    ok "pnpm installed via npm"
+  else
+    warn "Could not install pnpm — will fall back to npm for AgentBnB install"
+  fi
+else
+  ok "pnpm $(pnpm --version) found"
+fi
+
+# ---------------------------------------------------------------------------
+# Step 2: Install AgentBnB CLI
+# ---------------------------------------------------------------------------
+step "Step 2/5 — Installing AgentBnB CLI"
+
+# Check if already installed (idempotent)
+if command -v agentbnb &>/dev/null; then
+  ok "AgentBnB CLI already installed ($(agentbnb --version 2>/dev/null || echo 'version unknown'))"
+else
+  INSTALL_OK=false
+
+  # Try pnpm global install first
+  if command -v pnpm &>/dev/null; then
+    if pnpm install -g agentbnb 2>/dev/null; then
+      INSTALL_OK=true
+      ok "AgentBnB CLI installed via pnpm"
+    else
+      warn "pnpm global install failed — trying npm"
+    fi
+  fi
+
+  # Fall back to npm global install
+  if [ "$INSTALL_OK" = false ]; then
+    if npm install -g agentbnb 2>/dev/null; then
+      INSTALL_OK=true
+      ok "AgentBnB CLI installed via npm"
+    else
+      err "Failed to install AgentBnB CLI via both pnpm and npm."
+      err "Please run manually: npm install -g agentbnb"
+      exit 1
+    fi
+  fi
+
+  # Verify the CLI is now callable
+  if ! command -v agentbnb &>/dev/null; then
+    err "agentbnb command not found after install. Check your PATH."
+    exit 1
+  fi
+
+  ok "Verified: agentbnb $(agentbnb --version 2>/dev/null || echo 'installed') is available"
+fi
+
+# ---------------------------------------------------------------------------
+# Step 3: Initialize config + connect to public registry
+# ---------------------------------------------------------------------------
+step "Step 3/5 — Initializing AgentBnB config"
+
+# agentbnb init is idempotent — safe to run on existing installs
+if agentbnb init --yes 2>/dev/null; then
+  ok "Config initialized at ~/.agentbnb/"
+else
+  # May already be initialized — check if directory exists
+  if [ -d "$HOME/.agentbnb" ]; then
+    ok "Config already exists at ~/.agentbnb/ (skipping re-init)"
+  else
+    err "Failed to initialize AgentBnB config. Run 'agentbnb init' manually."
+    exit 1
+  fi
+fi
+
+# Connect to the public AgentBnB registry (only if not already configured)
+CURRENT_REGISTRY=$(agentbnb config get registry 2>/dev/null || echo "")
+if [ -z "$CURRENT_REGISTRY" ]; then
+  if agentbnb config set registry https://hub.agentbnb.dev 2>/dev/null; then
+    ok "Connected to public registry: https://hub.agentbnb.dev"
+    ok "Registry grants 50 credits to new agents on first sync"
+  else
+    warn "Could not set registry — run manually: agentbnb config set registry https://hub.agentbnb.dev"
+  fi
+else
+  ok "Registry already configured: $CURRENT_REGISTRY"
+fi
+
+# ---------------------------------------------------------------------------
+# Step 4: Sync from SOUL.md
+# ---------------------------------------------------------------------------
+step "Step 4/5 — Syncing capabilities from SOUL.md"
+
+SOUL_PATH=""
+# Check current directory first, then parent directory
+if [ -f "SOUL.md" ]; then
+  SOUL_PATH="SOUL.md"
+elif [ -f "../SOUL.md" ]; then
+  SOUL_PATH="../SOUL.md"
+fi
+
+if [ -n "$SOUL_PATH" ]; then
+  ok "Found SOUL.md at: $SOUL_PATH"
+  if agentbnb openclaw sync 2>/dev/null; then
+    ok "Capability card published to AgentBnB network"
+  else
+    warn "Sync failed — your agent is not yet visible on the network."
+    warn "Retry with: agentbnb openclaw sync"
+  fi
+else
+  warn "No SOUL.md found in current or parent directory."
+  warn "Run 'agentbnb openclaw sync' manually after creating your SOUL.md"
+fi
+
+# ---------------------------------------------------------------------------
+# Step 5: Print success summary
+# ---------------------------------------------------------------------------
+step "Step 5/5 — Setup complete"
+
+echo ""
+echo "${GREEN}${BOLD}AgentBnB skill installed successfully!${RESET}"
+echo ""
+echo "What was set up:"
+ok "AgentBnB CLI available as 'agentbnb'"
+ok "Config directory: ~/.agentbnb/"
+ok "Registry: https://hub.agentbnb.dev (public network)"
+ok "Default autonomy tier: Tier 3 (ask before all transactions)"
+ok "Default credit reserve: 20 credits"
+
+# Verify identity.json was created (v4.0+ feature)
+if [ -f "$HOME/.agentbnb/identity.json" ]; then
+  ok "Agent identity: ~/.agentbnb/identity.json"
+else
+  warn "identity.json not found — will be created on next agentbnb init"
+fi
+
+if [ -n "$SOUL_PATH" ]; then
+  ok "Capability card synced from SOUL.md"
+fi
+
+echo ""
+echo "Next steps:"
+echo "  1. Run ${BOLD}agentbnb serve${RESET} to start accepting requests"
+echo "  2. Run ${BOLD}agentbnb openclaw status${RESET} to see your sync state"
+echo "  3. Run ${BOLD}agentbnb openclaw rules${RESET} to see your autonomy rules"
+echo "  4. Paste the rules into your HEARTBEAT.md (or copy from HEARTBEAT.rules.md)"
+echo ""
+echo "Configure autonomy thresholds:"
+echo "  ${BOLD}agentbnb config set tier1 10${RESET}   # auto-execute under 10 credits"
+echo "  ${BOLD}agentbnb config set tier2 50${RESET}   # notify-after under 50 credits"
+echo "  ${BOLD}agentbnb config set reserve 20${RESET} # keep 20 credit reserve"
+echo ""
+ok "Welcome to the AgentBnB network."

package/dist/conduct-FXLVGKD5.js

@@ -1,19 +0,0 @@
-import {
-  conductAction
-} from "./chunk-3UKAVIMC.js";
-import "./chunk-MQKYGY5I.js";
-import "./chunk-3MJT4PZG.js";
-import "./chunk-6K5WUVF3.js";
-import "./chunk-QJEOCKVF.js";
-import "./chunk-KJG2UJV5.js";
-import "./chunk-5AH3CMOX.js";
-import "./chunk-75OC6E4F.js";
-import "./chunk-TLU7ALCZ.js";
-import "./chunk-XQHN6ITI.js";
-import "./chunk-DVAS2443.js";
-import "./chunk-FNKBHBYK.js";
-import "./chunk-JOY533UH.js";
-import "./chunk-QT7TEVNV.js";
-export {
-  conductAction
-};

package/dist/execute-EXOITLHN.js

@@ -1,10 +0,0 @@
-import {
-  executeCapabilityRequest
-} from "./chunk-Q7HRI666.js";
-import "./chunk-TLU7ALCZ.js";
-import "./chunk-XQHN6ITI.js";
-import "./chunk-DVAS2443.js";
-import "./chunk-FNKBHBYK.js";
-export {
-  executeCapabilityRequest
-};

package/dist/types-FGBUZ3QV.js

@@ -1,18 +0,0 @@
-import {
-  AgentBnBError,
-  AnyCardSchema,
-  CapabilityCardSchema,
-  CapabilityCardV2Schema,
-  IOSchemaSchema,
-  PoweredBySchema,
-  SkillSchema
-} from "./chunk-FNKBHBYK.js";
-export {
-  AgentBnBError,
-  AnyCardSchema,
-  CapabilityCardSchema,
-  CapabilityCardV2Schema,
-  IOSchemaSchema,
-  PoweredBySchema,
-  SkillSchema
-};