@robbiesrobotics/alice-agents 1.0.0

package/README.md

@@ -0,0 +1,120 @@
+# 🧠 A.L.I.C.E. — 28 AI Agents for OpenClaw
+
+**Adaptive Learning & Intelligent Coordination Engine**
+
+One conversation. One orchestrator. Twenty-eight specialists. A.L.I.C.E. turns OpenClaw into a full AI team — talk to Olivia, and she routes your request to the right expert.
+
+## Quick Start
+
+```bash
+npx @robbiesrobotics/alice-agents
+```
+
+That's it. The installer detects your OpenClaw installation, asks a few questions, and sets up everything.
+
+## What You Get
+
+An orchestrator (Olivia) backed by specialist agents across every domain:
+
+| Agent | Domain | Emoji | Tier |
+|-------|--------|-------|------|
+| **Olivia** | Orchestration | 🧠 | Starter |
+| **Dylan** | Development | 💻 | Starter |
+| **Selena** | Security | 🛡️ | Starter |
+| **Devon** | DevOps | 🚀 | Starter |
+| **Quinn** | QA/Testing | ✅ | Starter |
+| **Felix** | Frontend | 🖥️ | Starter |
+| **Daphne** | Documentation | 📝 | Starter |
+| **Rowan** | Research | 🔍 | Starter |
+| **Darius** | Data | 📊 | Starter |
+| **Sophie** | Support | 💬 | Starter |
+| **Hannah** | HR | 👥 | Pro |
+| **Aiden** | Analytics | 📈 | Pro |
+| **Clara** | Communication | ✍️ | Pro |
+| **Avery** | Automation | ⚙️ | Pro |
+| **Owen** | Operations | 🔧 | Pro |
+| **Isaac** | Integration | 🔌 | Pro |
+| **Tommy** | Travel | ✈️ | Pro |
+| **Sloane** | Sales | 💼 | Pro |
+| **Nadia** | UI/UX Design | 🎨 | Pro |
+| **Morgan** | Marketing | 📣 | Pro |
+| **Alex** | API Crawling | 🕷️ | Pro |
+| **Uma** | UX Research | 🧪 | Pro |
+| **Caleb** | CRM | 🗂️ | Pro |
+| **Elena** | Estimation | 📋 | Pro |
+| **Audrey** | Accounting | 💰 | Pro |
+| **Logan** | Legal | ⚖️ | Pro |
+| **Eva** | Executive Assistant | 📌 | Pro |
+| **Parker** | Project Management | 📅 | Pro |
+
+## Model Presets
+
+| Preset | Models | Best For |
+|--------|--------|----------|
+| **Sonnet** (default) | claude-sonnet-4-6 for all | Balanced speed + quality |
+| **Opus + Sonnet** | Opus for orchestrator, Sonnet for specialists | Maximum orchestration quality |
+| **OpenAI** | GPT-4.1 / GPT-4.1-mini | OpenAI users |
+| **Local (Ollama)** | Local models | Privacy, offline use |
+| **Custom** | Your choice | Full control |
+
+## Install Options
+
+```bash
+# Interactive install
+npx @robbiesrobotics/alice-agents
+
+# Non-interactive with defaults (Sonnet, Starter tier)
+npx @robbiesrobotics/alice-agents --yes
+
+# Show help
+npx @robbiesrobotics/alice-agents --help
+```
+
+### Install Modes
+
+- **Fresh** — Replaces the agents section in `openclaw.json` (recommended for first install)
+- **Merge** — Adds A.L.I.C.E. agents alongside your existing agents
+- **Upgrade** — Updates product files (SOUL.md, AGENTS.md, etc.) without touching user customizations
+
+## Upgrade
+
+Re-run the installer and choose "Upgrade":
+
+```bash
+npx @robbiesrobotics/alice-agents
+# Select: Upgrade
+```
+
+This updates agent templates and config while preserving your PLAYBOOK.md, LEARNINGS.md, FEEDBACK.md, and memory/ directories.
+
+## Uninstall
+
+```bash
+npx @robbiesrobotics/alice-agents --uninstall
+```
+
+Removes A.L.I.C.E. agents from `openclaw.json` while preserving any non-ALICE agents. Creates a backup before making changes.
+
+## How It Works
+
+1. **You talk to Olivia** — she's your single point of contact
+2. **Olivia routes to specialists** — "Build me an API" → Dylan (Development)
+3. **Specialists do the work** — using their domain-specific tools and expertise
+4. **Olivia synthesizes** — combines results and presents them to you
+
+Each agent has its own workspace with:
+- `SOUL.md` — personality and values
+- `AGENTS.md` — operating instructions
+- `PLAYBOOK.md` — learned patterns (evolves over time)
+- `LEARNINGS.md` — task log
+- `memory/` — persistent context between sessions
+
+## Requirements
+
+- [OpenClaw](https://openclaw.com) installed and configured
+- Node.js 18+
+- At least one AI provider configured (Anthropic, OpenAI, or Ollama)
+
+## License
+
+MIT

package/bin/alice-install.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+import { runInstall, runUninstall } from '../lib/installer.mjs';
+
+const args = process.argv.slice(2);
+const flags = new Set(args);
+
+if (flags.has('--help') || flags.has('-h')) {
+  console.log(`
+  alice-agents — A.L.I.C.E. Agent Framework Installer
+
+  Usage:
+    npx @robbiesrobotics/alice-agents              Interactive install
+    npx @robbiesrobotics/alice-agents --yes        Non-interactive install with defaults
+    npx @robbiesrobotics/alice-agents --uninstall  Remove A.L.I.C.E. agents from config
+    npx @robbiesrobotics/alice-agents --help       Show this help
+
+  Options:
+    --yes         Skip prompts, use defaults (Sonnet, Starter tier)
+    --uninstall   Remove A.L.I.C.E. agents (preserves non-ALICE agents)
+  `);
+  process.exit(0);
+}
+
+if (flags.has('--uninstall')) {
+  runUninstall({ yes: flags.has('--yes') }).catch((err) => {
+    console.error('  ❌ Uninstall failed:', err.message);
+    process.exit(1);
+  });
+} else {
+  runInstall({ yes: flags.has('--yes') }).catch((err) => {
+    console.error('  ❌ Install failed:', err.message);
+    process.exit(1);
+  });
+}

package/lib/config-merger.mjs

@@ -0,0 +1,185 @@
+import { readFileSync, writeFileSync, renameSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { randomBytes } from 'node:crypto';
+
+const OPENCLAW_DIR = join(homedir(), '.openclaw');
+const CONFIG_PATH = join(OPENCLAW_DIR, 'openclaw.json');
+
+export function configExists() {
+  return existsSync(CONFIG_PATH);
+}
+
+export function readConfig() {
+  const raw = readFileSync(CONFIG_PATH, 'utf8');
+  return JSON.parse(raw);
+}
+
+function backupConfig() {
+  const ts = Date.now();
+  const backupPath = join(OPENCLAW_DIR, `openclaw.json.bak.alice-${ts}`);
+  const raw = readFileSync(CONFIG_PATH, 'utf8');
+  writeFileSync(backupPath, raw, 'utf8');
+  return backupPath;
+}
+
+function writeConfigAtomic(config) {
+  const tmpPath = join(OPENCLAW_DIR, `.openclaw.json.tmp.${randomBytes(4).toString('hex')}`);
+  writeFileSync(tmpPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+  renameSync(tmpPath, CONFIG_PATH);
+}
+
+function getModelConfig(preset, customModels) {
+  switch (preset) {
+    case 'sonnet':
+      return {
+        primary: 'anthropic/claude-sonnet-4-6',
+        orchestrator: 'anthropic/claude-sonnet-4-6',
+        fallbacks: ['anthropic/claude-sonnet-4-6', 'anthropic/claude-haiku-4-5'],
+        models: {
+          'anthropic/claude-sonnet-4-6': {},
+          'anthropic/claude-haiku-4-5': {},
+        },
+      };
+    case 'opus-sonnet':
+      return {
+        primary: 'anthropic/claude-sonnet-4-6',
+        orchestrator: 'anthropic/claude-opus-4-6',
+        fallbacks: ['anthropic/claude-opus-4-6', 'anthropic/claude-sonnet-4-6', 'anthropic/claude-haiku-4-5'],
+        models: {
+          'anthropic/claude-opus-4-6': {},
+          'anthropic/claude-sonnet-4-6': {},
+          'anthropic/claude-haiku-4-5': {},
+        },
+      };
+    case 'openai':
+      return {
+        primary: 'openai/gpt-4.1-mini',
+        orchestrator: 'openai/gpt-4.1',
+        fallbacks: ['openai/gpt-4.1', 'openai/gpt-4.1-mini'],
+        models: {
+          'openai/gpt-4.1': {},
+          'openai/gpt-4.1-mini': {},
+        },
+      };
+    case 'local':
+      return {
+        primary: 'ollama/qwen3.5:27b',
+        orchestrator: 'ollama/qwen3.5:27b',
+        fallbacks: [],
+        models: {},
+      };
+    case 'custom':
+      return {
+        primary: customModels?.primary || 'anthropic/claude-sonnet-4-6',
+        orchestrator: customModels?.orchestrator || customModels?.primary || 'anthropic/claude-sonnet-4-6',
+        fallbacks: [],
+        models: {},
+      };
+    default:
+      return getModelConfig('sonnet');
+  }
+}
+
+function buildAgentEntry(agent, modelCfg) {
+  const entry = {
+    id: agent.id,
+    name: agent.name,
+    workspace: join(OPENCLAW_DIR, `workspace-${agent.id}`),
+    identity: {
+      name: agent.name,
+      theme: agent.theme,
+      emoji: agent.emoji,
+    },
+    sandbox: agent.sandbox,
+    tools: agent.tools,
+  };
+
+  // Orchestrator gets special model + extra config
+  if (agent.isOrchestrator) {
+    entry.default = true;
+    entry.model = modelCfg.orchestrator;
+    if (agent.extraConfig) {
+      Object.assign(entry, agent.extraConfig);
+    }
+  }
+
+  return entry;
+}
+
+export function mergeConfig({ agents, mode, preset, customModels }) {
+  const backupPath = backupConfig();
+  const config = readConfig();
+  const modelCfg = getModelConfig(preset, customModels);
+
+  // Build agent entries
+  const aliceEntries = agents.map((a) => buildAgentEntry(a, modelCfg));
+  const aliceIds = new Set(agents.map((a) => a.id));
+
+  if (mode === 'fresh') {
+    // Replace agents entirely
+    config.agents = config.agents || {};
+    config.agents.list = aliceEntries;
+  } else if (mode === 'merge') {
+    // Preserve non-ALICE agents, add/replace ALICE ones
+    config.agents = config.agents || {};
+    const existing = (config.agents.list || []).filter((a) => !aliceIds.has(a.id));
+    config.agents.list = [...aliceEntries, ...existing];
+  } else if (mode === 'upgrade') {
+    // Only update existing ALICE agents, don't add new ones
+    config.agents = config.agents || {};
+    const list = config.agents.list || [];
+    config.agents.list = list.map((existing) => {
+      if (aliceIds.has(existing.id)) {
+        const updated = aliceEntries.find((a) => a.id === existing.id);
+        return { ...updated, workspace: existing.workspace };
+      }
+      return existing;
+    });
+  }
+
+  // Set defaults
+  config.agents.defaults = config.agents.defaults || {};
+  config.agents.defaults.model = {
+    primary: modelCfg.primary,
+    fallbacks: modelCfg.fallbacks,
+  };
+  if (Object.keys(modelCfg.models).length > 0) {
+    config.agents.defaults.models = modelCfg.models;
+  }
+  config.agents.defaults.workspace = join(OPENCLAW_DIR, 'workspace-olivia');
+  config.agents.defaults.compaction = config.agents.defaults.compaction || { mode: 'safeguard' };
+  config.agents.defaults.maxConcurrent = config.agents.defaults.maxConcurrent || 4;
+  config.agents.defaults.subagents = config.agents.defaults.subagents || {
+    maxConcurrent: 4,
+    archiveAfterMinutes: 120,
+    runTimeoutSeconds: 900,
+  };
+
+  // Agent-to-agent communication
+  config.tools = config.tools || {};
+  config.tools.agentToAgent = config.tools.agentToAgent || {};
+  config.tools.agentToAgent.enabled = true;
+  config.tools.agentToAgent.allow = [...aliceIds];
+
+  writeConfigAtomic(config);
+  return { backupPath, agentCount: aliceEntries.length };
+}
+
+export function removeAliceAgents(agentIds) {
+  const backupPath = backupConfig();
+  const config = readConfig();
+  const idsToRemove = new Set(agentIds);
+
+  if (config.agents?.list) {
+    config.agents.list = config.agents.list.filter((a) => !idsToRemove.has(a.id));
+  }
+
+  // Clean up agentToAgent allow list
+  if (config.tools?.agentToAgent?.allow) {
+    config.tools.agentToAgent.allow = config.tools.agentToAgent.allow.filter((id) => !idsToRemove.has(id));
+  }
+
+  writeConfigAtomic(config);
+  return { backupPath };
+}

package/lib/installer.mjs

@@ -0,0 +1,233 @@
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { configExists, mergeConfig, removeAliceAgents } from './config-merger.mjs';
+import { scaffoldAll } from './workspace-scaffolder.mjs';
+import { readManifest, writeManifest } from './manifest.mjs';
+import {
+  promptInstallMode,
+  promptUserInfo,
+  promptModelPreset,
+  promptCustomModel,
+  promptTier,
+  confirm,
+  input,
+  closePrompt,
+  detectUserName,
+  detectTimezone,
+} from './prompter.mjs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+function loadAgentRegistry() {
+  const raw = readFileSync(join(__dirname, '..', 'templates', 'agents.json'), 'utf8');
+  return JSON.parse(raw);
+}
+
+function filterByTier(agents, tier) {
+  if (tier === 'pro') return agents;
+  return agents.filter((a) => a.tier === 'starter');
+}
+
+function printBanner() {
+  console.log();
+  console.log('  ╔═══════════════════════════════════════════════════╗');
+  console.log('  ║                                                   ║');
+  console.log('  ║   🧠  A.L.I.C.E. Agent Framework Installer       ║');
+  console.log('  ║                                                   ║');
+  console.log('  ║   Adaptive Learning & Intelligent Coordination    ║');
+  console.log('  ║   Engine — 28 specialists, one conversation.      ║');
+  console.log('  ║                                                   ║');
+  console.log('  ╚═══════════════════════════════════════════════════╝');
+  console.log();
+}
+
+function printSummary(mode, tier, agents, preset, userInfo) {
+  console.log('\n  ── Install Summary ──────────────────────────────');
+  console.log(`  Mode:      ${mode}`);
+  console.log(`  Tier:      ${tier} (${agents.length} agents)`);
+  console.log(`  Model:     ${preset}`);
+  console.log(`  User:      ${userInfo.name}`);
+  console.log(`  Timezone:  ${userInfo.timezone}`);
+  console.log('  ─────────────────────────────────────────────────');
+  console.log();
+  console.log('  Agents:');
+  for (const a of agents) {
+    console.log(`    ${a.emoji}  ${a.name.padEnd(10)} — ${a.domain}`);
+  }
+  console.log();
+}
+
+export async function runInstall(options = {}) {
+  const auto = options.yes || false;
+
+  printBanner();
+
+  // 1. Detect OpenClaw
+  if (!configExists()) {
+    console.error('  ❌ OpenClaw not found. Install OpenClaw first:');
+    console.error('     https://openclaw.com/docs/install');
+    console.error();
+    process.exit(1);
+  }
+  console.log('  ✓ OpenClaw detected\n');
+
+  const allAgents = loadAgentRegistry();
+
+  // 2. Install mode
+  let mode;
+  if (auto) {
+    const manifest = readManifest();
+    mode = manifest ? 'upgrade' : 'fresh';
+  } else {
+    mode = await promptInstallMode();
+  }
+
+  if (mode === 'upgrade') {
+    const manifest = readManifest();
+    if (!manifest) {
+      console.log('  ⚠  No previous install found. Switching to fresh install.\n');
+      mode = 'fresh';
+    }
+  }
+
+  if (mode === 'fresh' && !auto) {
+    const ok = await confirm('  ⚠  This will replace the agents section in openclaw.json. Continue?');
+    if (!ok) {
+      console.log('  Aborted.');
+      closePrompt();
+      return;
+    }
+  }
+
+  // 3. User info
+  let userInfo;
+  if (auto) {
+    userInfo = { name: detectUserName(), timezone: detectTimezone(), notes: '' };
+  } else {
+    console.log('\n  ── About You ───────────────────────────────────\n');
+    userInfo = await promptUserInfo();
+  }
+
+  // 4. Model preset
+  let preset, customModels;
+  if (auto) {
+    preset = 'sonnet';
+  } else {
+    preset = await promptModelPreset();
+    if (preset === 'custom') {
+      customModels = await promptCustomModel();
+    }
+  }
+
+  // 5. Tier selection
+  let tier;
+  if (auto) {
+    tier = 'starter';
+  } else {
+    tier = await promptTier();
+  }
+
+  const agents = filterByTier(allAgents, tier);
+
+  // 6. Confirmation
+  printSummary(mode, tier, agents, preset, userInfo);
+
+  if (!auto) {
+    const ok = await confirm('  Proceed with installation?');
+    if (!ok) {
+      console.log('  Aborted.');
+      closePrompt();
+      return;
+    }
+  }
+
+  closePrompt();
+
+  // Execute
+  console.log('\n  Installing...\n');
+
+  // Merge config
+  const { backupPath, agentCount } = mergeConfig({
+    agents,
+    mode,
+    preset,
+    customModels,
+  });
+  console.log(`  ✓ Config updated (backup: ${backupPath})`);
+
+  // Scaffold workspaces
+  const results = scaffoldAll(agents, userInfo);
+  let newWorkspaces = 0;
+  let updatedWorkspaces = 0;
+  for (const r of results) {
+    if (r.skipped.length === 0) {
+      newWorkspaces++;
+    } else {
+      updatedWorkspaces++;
+    }
+  }
+  console.log(`  ✓ Workspaces: ${newWorkspaces} created, ${updatedWorkspaces} updated`);
+
+  // Write manifest
+  const existing = readManifest();
+  writeManifest({
+    installedAt: existing?.installedAt,
+    tier,
+    agents: agents.map((a) => a.id),
+    userName: userInfo.name,
+    userTimezone: userInfo.timezone,
+    modelPreset: preset,
+  });
+  console.log('  ✓ Manifest written');
+
+  console.log(`\n  🎉 A.L.I.C.E. installed! ${agentCount} agents ready.`);
+  console.log('  Restart OpenClaw to activate: openclaw gateway restart\n');
+}
+
+export async function runUninstall(options = {}) {
+  const auto = options.yes || false;
+
+  console.log('\n  🧠 A.L.I.C.E. Uninstaller\n');
+
+  const manifest = readManifest();
+  if (!manifest) {
+    console.error('  ❌ No A.L.I.C.E. installation found (no manifest).');
+    process.exit(1);
+  }
+
+  console.log(`  Found: ${manifest.agents.length} agents installed`);
+  console.log(`  Tier: ${manifest.tier}`);
+  console.log();
+
+  if (!auto) {
+    const { createInterface } = await import('node:readline');
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((resolve) => {
+      rl.question('  Remove A.L.I.C.E. agents from config? [y/N] ', resolve);
+    });
+    rl.close();
+    if (!answer.toLowerCase().startsWith('y')) {
+      console.log('  Aborted.');
+      return;
+    }
+  }
+
+  const { backupPath } = removeAliceAgents(manifest.agents);
+  console.log(`  ✓ Agents removed from config (backup: ${backupPath})`);
+
+  if (!auto) {
+    const { createInterface } = await import('node:readline');
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((resolve) => {
+      rl.question('  Also remove workspace directories? [y/N] ', resolve);
+    });
+    rl.close();
+    if (answer.toLowerCase().startsWith('y')) {
+      console.log('  ⚠  Workspace removal not implemented (safety measure).');
+      console.log('  Remove manually: rm -rf ~/.openclaw/workspace-{agent-id}');
+    }
+  }
+
+  console.log('\n  ✓ A.L.I.C.E. uninstalled. Restart OpenClaw: openclaw gateway restart\n');
+}

package/lib/manifest.mjs

@@ -0,0 +1,33 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+const MANIFEST_NAME = '.alice-manifest.json';
+
+export function getManifestPath() {
+  return join(homedir(), '.openclaw', MANIFEST_NAME);
+}
+
+export function readManifest() {
+  try {
+    const raw = readFileSync(getManifestPath(), 'utf8');
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+export function writeManifest(data) {
+  const manifest = {
+    version: '1.0.0',
+    installedAt: data.installedAt || new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+    tier: data.tier,
+    agents: data.agents,
+    userName: data.userName,
+    userTimezone: data.userTimezone,
+    modelPreset: data.modelPreset,
+  };
+  writeFileSync(getManifestPath(), JSON.stringify(manifest, null, 2) + '\n', 'utf8');
+  return manifest;
+}