@sesamespace/hivemind 0.5.4 → 0.5.7

package/packages/cli/src/commands/fleet.ts

@@ -1,206 +0,0 @@
-/**
- * CLI commands for fleet management.
- *
- * Usage:
- *   hivemind fleet status                          — Show fleet dashboard
- *   hivemind fleet add-worker <url>                — Register a worker by URL
- *   hivemind fleet remove-worker <worker-id>       — Remove a worker from the fleet
- *   hivemind fleet assign <worker-id> <context>    — Assign a context to a worker
- *   hivemind fleet migrate <context> <worker-id>   — Migrate a context to another worker
- *   hivemind fleet discover <url1> [url2] ...      — Probe URLs for workers
- */
-
-import { FleetManager } from "@hivemind/runtime";
-import type { FleetDashboard, WorkerSummary } from "@hivemind/runtime";
-
-function formatUptime(seconds: number | null): string {
-  if (seconds == null) return "—";
-  if (seconds < 60) return `${seconds}s`;
-  if (seconds < 3600) return `${Math.floor(seconds / 60)}m`;
-  const h = Math.floor(seconds / 3600);
-  const m = Math.floor((seconds % 3600) / 60);
-  return `${h}h ${m}m`;
-}
-
-function formatHealth(status: string): string {
-  switch (status) {
-    case "healthy": return "OK";
-    case "degraded": return "DEGRADED";
-    case "unreachable": return "DOWN";
-    default: return status.toUpperCase();
-  }
-}
-
-function printDashboard(dashboard: FleetDashboard): void {
-  console.log("\n=== Hivemind Fleet ===\n");
-  console.log(`Workers: ${dashboard.total_workers}  (${dashboard.healthy} healthy, ${dashboard.degraded} degraded, ${dashboard.unreachable} unreachable)`);
-  console.log(`Contexts assigned: ${dashboard.total_contexts}`);
-
-  if (dashboard.unassigned_contexts.length > 0) {
-    console.log(`Unassigned contexts: ${dashboard.unassigned_contexts.join(", ")}`);
-  }
-
-  console.log("");
-
-  if (dashboard.workers.length === 0) {
-    console.log("No workers registered. Use 'fleet add-worker <url>' to add one.");
-    return;
-  }
-
-  // Table header
-  const cols = { id: 12, url: 30, health: 8, activity: 10, contexts: 25, task: 20, uptime: 8 };
-  const header = [
-    "ID".padEnd(cols.id),
-    "URL".padEnd(cols.url),
-    "HEALTH".padEnd(cols.health),
-    "ACTIVITY".padEnd(cols.activity),
-    "CONTEXTS".padEnd(cols.contexts),
-    "TASK".padEnd(cols.task),
-    "UPTIME".padEnd(cols.uptime),
-  ].join("  ");
-  console.log(header);
-  console.log("-".repeat(header.length));
-
-  for (const w of dashboard.workers) {
-    const row = [
-      w.id.padEnd(cols.id),
-      w.url.slice(0, cols.url).padEnd(cols.url),
-      formatHealth(w.health).padEnd(cols.health),
-      w.activity.padEnd(cols.activity),
-      (w.contexts.join(", ") || "—").slice(0, cols.contexts).padEnd(cols.contexts),
-      (w.current_task ?? "—").slice(0, cols.task).padEnd(cols.task),
-      formatUptime(w.uptime_seconds).padEnd(cols.uptime),
-    ].join("  ");
-    console.log(row);
-  }
-
-  console.log(`\nGenerated: ${dashboard.generated_at}`);
-}
-
-export async function runFleetCommand(args: string[]): Promise<void> {
-  const subcommand = args[0];
-
-  if (!subcommand) {
-    printUsage();
-    process.exit(1);
-  }
-
-  const fleet = new FleetManager();
-
-  switch (subcommand) {
-    case "status": {
-      const dashboard = await fleet.getDashboard();
-      printDashboard(dashboard);
-      break;
-    }
-
-    case "add-worker": {
-      const url = args[1];
-      if (!url) {
-        console.error("Usage: hivemind fleet add-worker <url>");
-        process.exit(1);
-      }
-      try {
-        const worker = await fleet.addWorker(url);
-        console.log(`Worker registered: ${worker.id}`);
-        console.log(`  URL: ${worker.url}`);
-        console.log(`  Max contexts: ${worker.capabilities.max_contexts}`);
-        console.log(`  Ollama: ${worker.capabilities.has_ollama ? "yes" : "no"}`);
-        console.log(`  Memory daemon: ${worker.capabilities.has_memory_daemon ? "yes" : "no"}`);
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        console.error(`Failed to add worker: ${msg}`);
-        process.exit(1);
-      }
-      break;
-    }
-
-    case "remove-worker": {
-      const workerId = args[1];
-      if (!workerId) {
-        console.error("Usage: hivemind fleet remove-worker <worker-id>");
-        process.exit(1);
-      }
-      const removed = await fleet.removeWorker(workerId);
-      if (removed) {
-        console.log(`Worker ${workerId} removed.`);
-      } else {
-        console.error(`Worker ${workerId} not found.`);
-        process.exit(1);
-      }
-      break;
-    }
-
-    case "assign": {
-      const workerId = args[1];
-      const context = args[2];
-      if (!workerId || !context) {
-        console.error("Usage: hivemind fleet assign <worker-id> <context>");
-        process.exit(1);
-      }
-      const result = await fleet.assignContext(workerId, context);
-      if (result.accepted) {
-        console.log(`Context '${context}' assigned to ${workerId}.`);
-      } else {
-        console.error(`Assignment rejected: ${result.reason}`);
-        process.exit(1);
-      }
-      break;
-    }
-
-    case "migrate": {
-      const context = args[1];
-      const toWorker = args[2];
-      if (!context || !toWorker) {
-        console.error("Usage: hivemind fleet migrate <context> <worker-id>");
-        process.exit(1);
-      }
-      const result = await fleet.migrateContext(context, toWorker);
-      if (result.success) {
-        console.log(`Context '${context}' migrated: ${result.from_worker} -> ${result.to_worker}`);
-      } else {
-        console.error(`Migration failed: ${result.reason}`);
-        process.exit(1);
-      }
-      break;
-    }
-
-    case "discover": {
-      const urls = args.slice(1);
-      if (urls.length === 0) {
-        console.error("Usage: hivemind fleet discover <url1> [url2] ...");
-        process.exit(1);
-      }
-      console.log(`Probing ${urls.length} URL(s)...`);
-      const found = await fleet.discoverWorkers(urls);
-      if (found.length === 0) {
-        console.log("No workers found.");
-      } else {
-        console.log(`Found ${found.length} worker(s):`);
-        for (const url of found) {
-          console.log(`  ${url}`);
-        }
-      }
-      break;
-    }
-
-    default:
-      console.error(`Unknown fleet subcommand: ${subcommand}`);
-      printUsage();
-      process.exit(1);
-  }
-}
-
-function printUsage(): void {
-  console.log(`
-Usage: hivemind fleet <command> [args]
-
-Commands:
-  status                        Show fleet dashboard
-  add-worker <url>              Register a worker by URL
-  remove-worker <worker-id>     Remove a worker from the fleet
-  assign <worker-id> <context>  Assign a context to a worker
-  migrate <context> <worker-id> Migrate a context to another worker
-  discover <url1> [url2] ...    Probe URLs for workers
-`.trim());
-}

package/packages/cli/src/commands/init.ts

@@ -1,252 +0,0 @@
-import { resolve, dirname } from "path";
-import { existsSync, writeFileSync, mkdirSync, readFileSync, copyFileSync, realpathSync } from "fs";
-import { createInterface } from "readline";
-import { fileURLToPath } from "url";
-import { SesameClient } from "@sesamespace/sdk";
-import { homedir } from "os";
-
-const HIVEMIND_DIR = resolve(process.env.HIVEMIND_HOME || resolve(homedir(), "hivemind"));
-const CONFIG_DIR = resolve(HIVEMIND_DIR, "config");
-const WORKSPACE_DIR = resolve(HIVEMIND_DIR, "workspace");
-const ENV_FILE = resolve(HIVEMIND_DIR, ".env");
-const LOCAL_TOML = resolve(CONFIG_DIR, "local.toml");
-
-const VAULT_CONFIG_NAME = "hivemind-config";
-
-interface ProvisioningConfig {
-  agentName: string;
-  agentHandle: string;
-  agentId: string;
-  personality?: string;
-  llmApiKey?: string;
-  llmBaseUrl?: string;
-  llmModel?: string;
-  fleetRole?: string;
-  channels: Array<{ id: string; name: string | null; kind: string }>;
-}
-
-async function prompt(question: string): Promise<string> {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-  });
-}
-
-export async function runInitCommand(args: string[]): Promise<void> {
-  const nonInteractive = args.includes("--yes") || args.includes("-y") || args.includes("--non-interactive");
-  const filteredArgs = args.filter((a) => !["--yes", "-y", "--non-interactive", "--help", "-h"].includes(a));
-  let sesameApiKey = filteredArgs[0];
-
-  if (args.includes("--help") || args.includes("-h")) {
-    printHelp();
-    return;
-  }
-
-  console.log(`
-  ╦ ╦╦╦  ╦╔═╗╔╦╗╦╔╗╔╔╦╗
-  ╠═╣║╚╗╔╝║╣ ║║║║║║║ ║║
-  ╩ ╩╩ ╚╝ ╚═╝╩ ╩╩╝╚╝═╩╝
-  Agent Initialization
-`);
-
-  // --- Step 1: Get Sesame API key ---
-  if (!sesameApiKey) {
-    sesameApiKey = await prompt("  Sesame API key: ");
-  }
-  if (!sesameApiKey) {
-    console.error("Error: Sesame API key is required");
-    process.exit(1);
-  }
-
-  // --- Step 2: Connect to Sesame and fetch manifest ---
-  console.log("\n→ Connecting to Sesame...");
-  const sdk = new SesameClient({
-    apiUrl: "https://api.sesame.space",
-    wsUrl: "wss://ws.sesame.space",
-    apiKey: sesameApiKey,
-  });
-
-  let config: ProvisioningConfig;
-  try {
-    const manifest = await sdk.getManifest();
-    console.log(`  ✓ Authenticated as ${manifest.agent.handle} (${manifest.agent.id})`);
-    console.log(`  ✓ Workspace: ${manifest.workspace.name}`);
-    console.log(`  ✓ Channels: ${manifest.channels.length}`);
-    for (const ch of manifest.channels) {
-      console.log(`    - ${ch.name || ch.id} (${ch.kind})`);
-    }
-
-    config = {
-      agentName: manifest.agent.handle,
-      agentHandle: manifest.agent.handle,
-      agentId: manifest.agent.id,
-      channels: manifest.channels.map((ch) => ({
-        id: ch.id,
-        name: ch.name,
-        kind: ch.kind,
-      })),
-    };
-
-    // --- Step 3: Check vault for config ---
-    console.log("\n→ Checking vault for provisioning config...");
-    try {
-      const vaultResp = await sdk.listVaultItems() as any;
-      const items = vaultResp.items || vaultResp.data || [];
-      const configItem = items.find((i: any) => i.name === VAULT_CONFIG_NAME);
-
-      if (configItem) {
-        console.log(`  ✓ Found ${VAULT_CONFIG_NAME} vault item`);
-        const revealResp = await sdk.revealItem(configItem.id) as any;
-        const fields = revealResp.fields || revealResp.data || {};
-
-        config.llmApiKey = fields.llm_api_key || fields.openrouter_api_key;
-        config.llmBaseUrl = fields.llm_base_url;
-        config.llmModel = fields.llm_model;
-        config.personality = fields.agent_personality || fields.personality;
-        config.fleetRole = fields.fleet_role;
-
-        if (config.llmApiKey) console.log("  ✓ LLM API key loaded from vault");
-        if (config.personality) console.log(`  ✓ Personality: ${config.personality.slice(0, 60)}...`);
-        if (config.fleetRole) console.log(`  ✓ Fleet role: ${config.fleetRole}`);
-      } else {
-        console.log("  ! No hivemind-config vault item found");
-        console.log("  ! Will prompt for LLM API key instead");
-      }
-    } catch (err) {
-      console.log(`  ! Could not read vault: ${(err as Error).message}`);
-    }
-  } catch (err) {
-    console.error(`\n  ✗ Failed to connect to Sesame: ${(err as Error).message}`);
-    console.error("  Check your API key and try again.");
-    process.exit(1);
-  } finally {
-    sdk.disconnect();
-  }
-
-  // --- Step 4: Prompt for anything missing ---
-  if (!config.llmApiKey) {
-    console.log("  ! No LLM API key found in vault — set LLM_API_KEY in .env after init");
-  }
-
-  // --- Step 5: Write config files ---
-  console.log("\n→ Writing configuration...");
-
-  mkdirSync(CONFIG_DIR, { recursive: true });
-  mkdirSync(WORKSPACE_DIR, { recursive: true });
-
-  // Copy default.toml from installed package if not present
-  const defaultToml = resolve(CONFIG_DIR, "default.toml");
-  if (!existsSync(defaultToml)) {
-    // Resolve from the hivemind binary location
-    // process.argv[1] may be a symlink, so resolve it first
-    const realBin = realpathSync(process.argv[1]);
-    // realBin is <pkg>/dist/main.js, so ../config/ gets us to <pkg>/config/
-    const packageConfigDir = resolve(dirname(realBin), "..", "config");
-    const packageDefault = resolve(packageConfigDir, "default.toml");
-    if (existsSync(packageDefault)) {
-      copyFileSync(packageDefault, defaultToml);
-      console.log(`  ✓ ${defaultToml}`);
-      // Also copy team charter if available
-      const packageCharter = resolve(packageConfigDir, "TEAM-CHARTER.md");
-      const localCharter = resolve(CONFIG_DIR, "TEAM-CHARTER.md");
-      if (existsSync(packageCharter) && !existsSync(localCharter)) {
-        copyFileSync(packageCharter, localCharter);
-        console.log(`  ✓ ${localCharter}`);
-      }
-    } else {
-      console.log(`  ! default.toml not found in package — you may need to copy it manually`);
-    }
-  }
-
-  // Write workspace identity files
-  const soulPath = resolve(WORKSPACE_DIR, "SOUL.md");
-  if (!existsSync(soulPath)) {
-    const personality = config.personality || "A helpful, capable agent.";
-    writeFileSync(soulPath, `# SOUL.md — Who You Are
-
-${personality}
-
----
-
-_This file defines your personality and values. Edit it to evolve who you are._
-`);
-    console.log(`  ✓ ${soulPath}`);
-  }
-
-  const identityPath = resolve(WORKSPACE_DIR, "IDENTITY.md");
-  if (!existsSync(identityPath)) {
-    writeFileSync(identityPath, `# IDENTITY.md
-
-- **Name:** ${config.agentName}
-- **Handle:** ${config.agentHandle}
-- **Agent ID:** ${config.agentId}
-`);
-    console.log(`  ✓ ${identityPath}`);
-  }
-
-  // Write local.toml (overrides)
-  const localToml = `# Generated by hivemind init — ${new Date().toISOString()}
-# Overrides config/default.toml with agent-specific settings
-
-[agent]
-name = "${config.agentName}"
-${config.personality ? `personality = "${config.personality.replace(/"/g, '\\"')}"` : "# personality = (using default)"}
-workspace = "workspace"
-
-${config.llmModel ? `[llm]\nmodel = "${config.llmModel}"` : "# [llm] using defaults"}
-${config.llmBaseUrl ? `# base_url = "${config.llmBaseUrl}"` : ""}
-
-[sesame]
-api_key = "${sesameApiKey}"
-`;
-
-  writeFileSync(LOCAL_TOML, localToml);
-  console.log(`  ✓ ${LOCAL_TOML}`);
-
-  // Write .env
-  const envContent = `# Hivemind Agent — ${config.agentName}
-# Generated by hivemind init — ${new Date().toISOString()}
-SESAME_API_KEY=${sesameApiKey}
-LLM_API_KEY=${config.llmApiKey || ""}
-AGENT_NAME=${config.agentName}
-`;
-
-  writeFileSync(ENV_FILE, envContent, { mode: 0o600 });
-  console.log(`  ✓ ${ENV_FILE} (chmod 600)`);
-
-  // --- Done ---
-  console.log(`
-  ✓ Hivemind initialized for ${config.agentName}!
-
-  To start the agent:
-    hivemind start
-
-  To install as a service:
-    hivemind service install
-
-  Agent ID:   ${config.agentId}
-  Channels:   ${config.channels.map((c) => c.name || c.id).join(", ")}
-  Fleet role: ${config.fleetRole || "standalone"}
-`);
-}
-
-function printHelp(): void {
-  console.log(`hivemind init — Initialize a Hivemind agent from Sesame
-
-Usage: hivemind init [sesame-api-key]
-
-The API key can also be passed as the first argument.
-
-What it does:
-  1. Connects to Sesame and fetches agent identity
-  2. Reads provisioning config from Sesame vault (if available)
-  3. Prompts for any missing configuration
-  4. Writes config/local.toml and .env
-
-Options:
-  -h, --help    Show this help
-`);
-}

package/packages/cli/src/commands/service.ts

@@ -1,159 +0,0 @@
-import { resolve } from "path";
-import { writeFileSync, existsSync, unlinkSync, mkdirSync } from "fs";
-import { execSync } from "child_process";
-import { homedir } from "os";
-
-const LAUNCH_AGENTS_DIR = resolve(homedir(), "Library/LaunchAgents");
-const AGENT_LABEL = "com.hivemind.agent";
-
-function getHivemindHome(): string {
-  return process.env.HIVEMIND_HOME || resolve(homedir(), "hivemind");
-}
-
-function getHivemindBin(): string {
-  // Try to find the hivemind binary
-  try {
-    const which = execSync("which hivemind", { encoding: "utf-8" }).trim();
-    if (which) return which;
-  } catch {}
-  // Fallback to process.argv[1] (the script being run)
-  return process.argv[1] || "hivemind";
-}
-
-function generatePlist(hivemindHome: string, hivemindBin: string): string {
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>${AGENT_LABEL}</string>
-  <key>ProgramArguments</key>
-  <array>
-    <string>${hivemindBin}</string>
-    <string>start</string>
-  </array>
-  <key>WorkingDirectory</key>
-  <string>${hivemindHome}</string>
-  <key>EnvironmentVariables</key>
-  <dict>
-    <key>PATH</key>
-    <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
-    <key>HIVEMIND_HOME</key>
-    <string>${hivemindHome}</string>
-  </dict>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>KeepAlive</key>
-  <true/>
-  <key>StandardOutPath</key>
-  <string>/tmp/hivemind-agent.log</string>
-  <key>StandardErrorPath</key>
-  <string>/tmp/hivemind-error.log</string>
-  <key>ThrottleInterval</key>
-  <integer>5</integer>
-</dict>
-</plist>`;
-}
-
-export async function runServiceCommand(args: string[]): Promise<void> {
-  const subcommand = args[0];
-
-  switch (subcommand) {
-    case "install":
-      await installService();
-      break;
-    case "uninstall":
-      await uninstallService();
-      break;
-    case "status":
-      showStatus();
-      break;
-    case "logs":
-      showLogs(args[1]);
-      break;
-    default:
-      printHelp();
-      if (subcommand) {
-        console.error(`Unknown subcommand: ${subcommand}`);
-        process.exit(1);
-      }
-      break;
-  }
-}
-
-async function installService(): Promise<void> {
-  const hivemindHome = getHivemindHome();
-  const hivemindBin = getHivemindBin();
-
-  console.log(`\n→ Installing launchd service for ${hivemindHome}\n`);
-  console.log(`  Binary: ${hivemindBin}`);
-
-  mkdirSync(LAUNCH_AGENTS_DIR, { recursive: true });
-
-  const plistContent = generatePlist(hivemindHome, hivemindBin);
-  const destPath = resolve(LAUNCH_AGENTS_DIR, `${AGENT_LABEL}.plist`);
-
-  // Unload if already loaded
-  try { execSync(`launchctl unload ${destPath} 2>/dev/null`); } catch {}
-
-  writeFileSync(destPath, plistContent);
-  execSync(`launchctl load ${destPath}`);
-
-  console.log(`  ✓ ${AGENT_LABEL} installed and started`);
-  console.log("\n  Service will auto-start on boot.");
-  console.log("  Logs: /tmp/hivemind-agent.log, /tmp/hivemind-error.log\n");
-}
-
-async function uninstallService(): Promise<void> {
-  console.log("\n→ Uninstalling launchd service\n");
-
-  const plistPath = resolve(LAUNCH_AGENTS_DIR, `${AGENT_LABEL}.plist`);
-  if (existsSync(plistPath)) {
-    try { execSync(`launchctl unload ${plistPath} 2>/dev/null`); } catch {}
-    unlinkSync(plistPath);
-    console.log(`  ✓ ${AGENT_LABEL} uninstalled`);
-  } else {
-    console.log(`  - ${AGENT_LABEL} not installed`);
-  }
-  console.log("");
-}
-
-function showStatus(): void {
-  console.log("\n→ Service status\n");
-  try {
-    const out = execSync(`launchctl list ${AGENT_LABEL} 2>/dev/null`, { encoding: "utf-8" });
-    const pidMatch = out.match(/"PID"\s*=\s*(\d+)/);
-    const pid = pidMatch ? pidMatch[1] : "unknown";
-    console.log(`  ✓ ${AGENT_LABEL}: running (PID ${pid})`);
-  } catch {
-    console.log(`  - ${AGENT_LABEL}: not running`);
-  }
-  console.log("");
-}
-
-function showLogs(which?: string): void {
-  const logFile = which === "error"
-    ? "/tmp/hivemind-error.log"
-    : "/tmp/hivemind-agent.log";
-  try {
-    execSync(`tail -30 ${logFile}`, { stdio: "inherit" });
-  } catch {
-    console.error(`No log file at ${logFile}`);
-  }
-}
-
-function printHelp(): void {
-  console.log(`hivemind service — Manage launchd service
-
-Usage: hivemind service <subcommand>
-
-Subcommands:
-  install      Install and start launchd service (survives reboots)
-  uninstall    Stop and remove launchd service
-  status       Show service status
-  logs [agent|error]  Show recent logs
-
-Service:
-  com.hivemind.agent — Agent runtime (Node.js, Sesame)
-`);
-}