@robbiesrobotics/alice-agents 1.2.8 → 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robbies Robotics (av3.ai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -51,16 +51,23 @@ An orchestrator (Olivia) backed by specialist agents across every domain:
 | **Eva** | Executive Assistant | 📌 | Pro |
 | **Parker** | Project Management | 📅 | Pro |
 
-## Model Presets
+## Model Flexibility
+
+A.L.I.C.E. works with **whatever model you already have configured** in OpenClaw/NemoClaw. There's no required API key — just use what you've got.
+
+When you install, the installer will **auto-detect your configured model** and use it by default. You can also choose from presets or specify a custom model.
 
 | 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 |
+| **Auto-detect** (default) | Your current OpenClaw model | Zero friction — works with what you have |
+| **Sonnet** | claude-sonnet-4-6 for all | Balanced speed + quality (requires Anthropic key) |
+| **Opus + Sonnet** | Opus for orchestrator, Sonnet for specialists | Maximum quality (requires Anthropic key) |
 | **OpenAI** | GPT-5.4 / GPT-5.4-mini | OpenAI users |
-| **Local (Ollama)** | Local models | Privacy, offline use |
+| **Local (Ollama)** | Local models | Privacy, offline use, no API key needed |
 | **Custom** | Your choice | Full control |
 
+> **Tip:** We prefer Claude Opus for orchestration when available — but A.L.I.C.E. is model-agnostic. Whatever model OpenClaw has configured will work.
+
 ## Install Options
 
 ```bash
@@ -132,7 +139,7 @@ If you're already running NemoClaw, A.L.I.C.E. works out of the box — no extra
 
 - [OpenClaw](https://openclaw.ai) or [NemoClaw](https://nemoclaw.com) installed and configured
 - Node.js 18+
-- At least one AI provider configured (Anthropic, OpenAI, or Ollama)
+- At least one model configured in OpenClaw or NemoClaw — no specific API key required. A.L.I.C.E. uses whatever you already have set up.
 
 ## License
 

package/bin/alice-install.mjs

@@ -1,10 +1,19 @@
 #!/usr/bin/env node
 
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
 import { runInstall, runUninstall } from '../lib/installer.mjs';
+import { runDoctor } from '../lib/doctor.mjs';
 
 const args = process.argv.slice(2);
 const flags = new Set(args);
 
+if (flags.has('--version') || flags.has('-v')) {
+  const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url)));
+  console.log(pkg.version);
+  process.exit(0);
+}
+
 if (flags.has('--help') || flags.has('-h')) {
   console.log(`
   alice-agents — A.L.I.C.E. Agent Framework Installer
@@ -12,17 +21,33 @@ if (flags.has('--help') || flags.has('-h')) {
   Usage:
     npx @robbiesrobotics/alice-agents              Interactive install
     npx @robbiesrobotics/alice-agents --yes        Non-interactive install with defaults
+    npx @robbiesrobotics/alice-agents --update     Non-interactive upgrade to latest agents
     npx @robbiesrobotics/alice-agents --uninstall  Remove A.L.I.C.E. agents from config
+    npx @robbiesrobotics/alice-agents --doctor     Run diagnostics on your A.L.I.C.E. install
+    npx @robbiesrobotics/alice-agents --version    Show version
     npx @robbiesrobotics/alice-agents --help       Show this help
 
   Options:
     --yes         Skip prompts, use defaults (Sonnet, Starter tier)
+    --update      Non-interactive upgrade (alias for --yes with upgrade mode)
     --uninstall   Remove A.L.I.C.E. agents (preserves non-ALICE agents)
+    --doctor      Run diagnostics and check install health
+    --version     Print package version
   `);
   process.exit(0);
 }
 
-if (flags.has('--uninstall')) {
+if (flags.has('--doctor')) {
+  runDoctor().then((ok) => process.exit(ok ? 0 : 1)).catch((err) => {
+    console.error('  ❌ Doctor failed:', err.message);
+    process.exit(1);
+  });
+} else if (flags.has('--update')) {
+  runInstall({ yes: true, modeOverride: 'upgrade' }).catch((err) => {
+    console.error('  ❌ Update failed:', err.message);
+    process.exit(1);
+  });
+} else if (flags.has('--uninstall')) {
   runUninstall({ yes: flags.has('--yes') }).catch((err) => {
     console.error('  ❌ Uninstall failed:', err.message);
     process.exit(1);

package/lib/config-merger.mjs

@@ -15,6 +15,43 @@ export function readConfig() {
   return JSON.parse(raw);
 }
 
+/**
+ * Inspect the existing OpenClaw/NemoClaw config and return what models
+ * and providers the user already has set up. This is used to avoid
+ * forcing Anthropic/Claude on users who haven't configured those keys.
+ *
+ * Returns null if config can't be read.
+ */
+export function detectAvailableModels() {
+  if (!configExists()) return null;
+  try {
+    const config = readConfig();
+
+    // Current agents.defaults.model (set by a prior install or manually)
+    const agentDefaults = config?.agents?.defaults?.model || {};
+
+    // Top-level model override (some users set this)
+    const globalModel = config?.model;
+
+    // Configured provider keys (e.g. ['anthropic', 'openai', 'ollama'])
+    const providers = Object.keys(config?.models?.providers || {});
+
+    const primary = agentDefaults.primary || globalModel || null;
+    const orchestrator = agentDefaults.orchestrator || primary;
+    const fallbacks = agentDefaults.fallbacks || [];
+
+    return {
+      primary,
+      orchestrator,
+      fallbacks,
+      providers,
+      hasModel: !!primary,
+    };
+  } catch {
+    return null;
+  }
+}
+
 function backupConfig() {
   const ts = Date.now();
   const backupPath = join(OPENCLAW_DIR, `openclaw.json.bak.alice-${ts}`);
@@ -29,8 +66,17 @@ function writeConfigAtomic(config) {
   renameSync(tmpPath, CONFIG_PATH);
 }
 
-function getModelConfig(preset, customModels) {
+function getModelConfig(preset, customModels, detectedModels) {
   switch (preset) {
+    case 'detected':
+      // Use whatever the user already has configured — don't touch model settings at all
+      return {
+        primary: detectedModels?.primary || null,
+        orchestrator: detectedModels?.orchestrator || detectedModels?.primary || null,
+        fallbacks: detectedModels?.fallbacks || [],
+        models: {},
+        preserve: true, // signal: don't overwrite model defaults
+      };
     case 'sonnet':
       return {
         primary: 'anthropic/claude-sonnet-4-6',
@@ -71,8 +117,8 @@ function getModelConfig(preset, customModels) {
       };
     case 'custom':
       return {
-        primary: customModels?.primary || 'anthropic/claude-sonnet-4-6',
-        orchestrator: customModels?.orchestrator || customModels?.primary || 'anthropic/claude-sonnet-4-6',
+        primary: customModels?.primary || null,
+        orchestrator: customModels?.orchestrator || customModels?.primary || null,
         fallbacks: [],
         models: {},
       };
@@ -110,7 +156,8 @@ function buildAgentEntry(agent, modelCfg) {
 export function mergeConfig({ agents, mode, preset, customModels }) {
   const backupPath = backupConfig();
   const config = readConfig();
-  const modelCfg = getModelConfig(preset, customModels);
+  const detectedModels = detectAvailableModels();
+  const modelCfg = getModelConfig(preset, customModels, detectedModels);
 
   // Build agent entries
   const aliceEntries = agents.map((a) => buildAgentEntry(a, modelCfg));
@@ -140,13 +187,24 @@ export function mergeConfig({ agents, mode, preset, customModels }) {
 
   // 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;
+
+  if (modelCfg.preserve) {
+    // User's existing model config is intact — don't overwrite it.
+    // Only initialize the key if it doesn't exist at all (safety net).
+    config.agents.defaults.model = config.agents.defaults.model || {};
+  } else if (modelCfg.primary) {
+    config.agents.defaults.model = {
+      primary: modelCfg.primary,
+      fallbacks: modelCfg.fallbacks,
+    };
+    if (modelCfg.orchestrator && modelCfg.orchestrator !== modelCfg.primary) {
+      config.agents.defaults.model.orchestrator = modelCfg.orchestrator;
+    }
+    if (Object.keys(modelCfg.models).length > 0) {
+      config.agents.defaults.models = modelCfg.models;
+    }
   }
+  // If modelCfg.primary is null (custom/detected with nothing set), leave existing model config alone
   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;

package/lib/doctor.mjs

@@ -0,0 +1,169 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { execSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const HOME = homedir();
+const OPENCLAW_DIR = join(HOME, '.openclaw');
+
+const STARTER_AGENTS = [
+  'olivia', 'dylan', 'selena', 'devon', 'quinn',
+  'felix', 'daphne', 'rowan', 'darius', 'sophie',
+];
+
+function check(label, ok, hint) {
+  const icon = ok ? '✓' : '✗';
+  console.log(`  ${icon}  ${label}`);
+  if (!ok && hint) console.log(`     → ${hint}`);
+  return ok;
+}
+
+function getRuntime() {
+  try {
+    const v = execSync('nemoclaw --version', { stdio: 'pipe', encoding: 'utf8' }).trim();
+    return { name: 'NemoClaw', ok: true, version: v };
+  } catch {}
+  try {
+    const v = execSync('openclaw --version', { stdio: 'pipe', encoding: 'utf8' }).trim();
+    return { name: 'OpenClaw', ok: true, version: v };
+  } catch {}
+  return { name: 'openclaw/nemoclaw', ok: false, version: null };
+}
+
+function loadConfig() {
+  const configPath = join(OPENCLAW_DIR, 'openclaw.json');
+  if (!existsSync(configPath)) return null;
+  try {
+    return JSON.parse(readFileSync(configPath, 'utf8'));
+  } catch {
+    return 'invalid';
+  }
+}
+
+export async function runDoctor() {
+  console.log('\n  🩺 A.L.I.C.E. Doctor — Diagnostic Report\n');
+  let allOk = true;
+
+  // 1. Runtime check
+  const runtime = getRuntime();
+  const runtimeOk = check(
+    runtime.ok
+      ? `${runtime.name} installed (${runtime.version})`
+      : `${runtime.name} not found`,
+    runtime.ok,
+    'Install OpenClaw: npm install -g openclaw'
+  );
+  allOk = allOk && runtimeOk;
+
+  // 2. Config exists and valid JSON
+  const configPath = join(OPENCLAW_DIR, 'openclaw.json');
+  const configExists = existsSync(configPath);
+  check('openclaw.json exists', configExists, 'Run: openclaw configure');
+
+  if (!configExists) {
+    allOk = false;
+    console.log('\n  ⚠️  Cannot continue checks — openclaw.json missing.\n');
+    return false;
+  }
+
+  const config = loadConfig();
+  const configValid = config !== null && config !== 'invalid';
+  check(
+    'openclaw.json is valid JSON',
+    configValid,
+    `Fix JSON syntax in ${configPath}`
+  );
+  if (!configValid) {
+    allOk = false;
+    console.log('\n  ⚠️  Cannot continue checks — config is invalid JSON.\n');
+    return false;
+  }
+
+  // 3. A.L.I.C.E. agents in config
+  const configAgents = Array.isArray(config.agents) ? config.agents : [];
+  const agentsInConfig = configAgents
+    .filter((a) => a && STARTER_AGENTS.includes(a.id))
+    .map((a) => a.id);
+
+  const agentsOk = agentsInConfig.length > 0;
+  check(
+    agentsOk
+      ? `A.L.I.C.E. agents in config: ${agentsInConfig.join(', ')}`
+      : 'No A.L.I.C.E. agents found in config',
+    agentsOk,
+    'Run: npx @robbiesrobotics/alice-agents to install'
+  );
+  allOk = allOk && agentsOk;
+
+  // Check for missing agents from full starter set
+  if (agentsInConfig.length > 0 && agentsInConfig.length < STARTER_AGENTS.length) {
+    const missing = STARTER_AGENTS.filter((id) => !agentsInConfig.includes(id));
+    check(
+      `All starter agents present (missing: ${missing.join(', ')})`,
+      false,
+      'Run: npx @robbiesrobotics/alice-agents --update'
+    );
+    allOk = false;
+  } else if (agentsInConfig.length === STARTER_AGENTS.length) {
+    check('All starter agents present', true);
+  }
+
+  // 4. Agent workspaces exist on disk
+  if (agentsInConfig.length > 0) {
+    let missingWorkspaces = [];
+    for (const id of agentsInConfig) {
+      const wsDir = join(OPENCLAW_DIR, `workspace-${id}`);
+      if (!existsSync(wsDir)) {
+        missingWorkspaces.push(id);
+      }
+    }
+    const workspacesOk = missingWorkspaces.length === 0;
+    check(
+      workspacesOk
+        ? `Agent workspaces exist (${agentsInConfig.length})`
+        : `Agent workspaces missing: ${missingWorkspaces.join(', ')}`,
+      workspacesOk,
+      'Run: npx @robbiesrobotics/alice-agents --update to scaffold missing workspaces'
+    );
+    allOk = allOk && workspacesOk;
+  }
+
+  // 5. At least one model/provider configured
+  let modelOk = false;
+  let modelLabel = null;
+
+  if (config.default_model) {
+    modelOk = true;
+    modelLabel = config.default_model;
+  } else if (config.models && Object.keys(config.models).length > 0) {
+    modelOk = true;
+    modelLabel = Object.keys(config.models)[0];
+  } else if (config.providers && Object.keys(config.providers).length > 0) {
+    modelOk = true;
+    modelLabel = Object.keys(config.providers)[0];
+  } else if (config.llm && Object.keys(config.llm).length > 0) {
+    modelOk = true;
+    modelLabel = Object.keys(config.llm)[0];
+  }
+
+  check(
+    modelOk
+      ? `Model/provider configured: ${modelLabel}`
+      : 'No model/provider configured',
+    modelOk,
+    'Run: openclaw configure to set up a model provider'
+  );
+  allOk = allOk && modelOk;
+
+  // Summary
+  console.log();
+  if (allOk) {
+    console.log('  ✅ A.L.I.C.E. is healthy!\n');
+  } else {
+    console.log('  ⚠️  Issues found — follow the hints above to fix them.\n');
+  }
+
+  return allOk;
+}

package/lib/installer.mjs

@@ -2,7 +2,7 @@ import { readFileSync, existsSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { execSync } from 'node:child_process';
-import { configExists, mergeConfig, removeAliceAgents } from './config-merger.mjs';
+import { configExists, mergeConfig, removeAliceAgents, detectAvailableModels } from './config-merger.mjs';
 import { scaffoldAll } from './workspace-scaffolder.mjs';
 import { readManifest, writeManifest } from './manifest.mjs';
 import {
@@ -170,11 +170,18 @@ function printBanner() {
   console.log();
 }
 
-function printSummary(mode, tier, agents, preset, userInfo) {
+function printSummary(mode, tier, agents, preset, userInfo, detectedModels) {
+  const modelLabel =
+    preset === 'detected'
+      ? `${detectedModels?.primary || 'your configured model'} (detected)`
+      : preset === 'custom'
+        ? `custom`
+        : preset;
+
   console.log('\n  ── Install Summary ──────────────────────────────');
   console.log(`  Mode:      ${mode}`);
   console.log(`  Tier:      ${tier} (${agents.length} agents)`);
-  console.log(`  Model:     ${preset}`);
+  console.log(`  Model:     ${modelLabel}`);
   console.log(`  User:      ${userInfo.name}`);
   console.log(`  Timezone:  ${userInfo.timezone}`);
   console.log('  ─────────────────────────────────────────────────');
@@ -229,11 +236,26 @@ export async function runInstall(options = {}) {
     console.log('  💡 Tip: Upgrade to NemoClaw for enterprise security: https://nvidia.com/nemoclaw\n');
   }
 
+  // Detect what models the user already has configured
+  const detectedModels = detectAvailableModels();
+  if (detectedModels?.hasModel) {
+    console.log(`  ✔  Detected configured model: ${detectedModels.primary}`);
+    if (detectedModels.providers.length > 0) {
+      console.log(`     Providers: ${detectedModels.providers.join(', ')}\n`);
+    } else {
+      console.log();
+    }
+  } else {
+    console.log('  ℹ  No model configured yet — you\'ll be prompted to choose one.\n');
+  }
+
   const allAgents = loadAgentRegistry();
 
   // 2. Install mode
   let mode;
-  if (auto) {
+  if (options.modeOverride) {
+    mode = options.modeOverride;
+  } else if (auto) {
     const manifest = readManifest();
     mode = manifest ? 'upgrade' : 'fresh';
   } else {
@@ -269,9 +291,12 @@ export async function runInstall(options = {}) {
   // 4. Model preset
   let preset, customModels;
   if (auto) {
-    preset = 'sonnet';
+    // Non-interactive: use whatever the user already has configured.
+    // Only fall back to sonnet if nothing is detected (e.g. fresh OpenClaw install
+    // where the user explicitly set up Claude credentials).
+    preset = detectedModels?.hasModel ? 'detected' : 'sonnet';
   } else {
-    preset = await promptModelPreset();
+    preset = await promptModelPreset(detectedModels);
     if (preset === 'custom') {
       customModels = await promptCustomModel();
     }
@@ -307,7 +332,7 @@ export async function runInstall(options = {}) {
   const agents = allAgents;
 
   // 6. Confirmation
-  printSummary(mode, tier, agents, preset, userInfo);
+  printSummary(mode, tier, agents, preset, userInfo, detectedModels);
 
   if (!auto) {
     const ok = await confirm('  Proceed with installation?');

package/lib/prompter.mjs

@@ -78,19 +78,29 @@ export async function promptUserInfo() {
   return { name, timezone: tz, notes };
 }
 
-export async function promptModelPreset() {
-  return choose('Model preset:', [
-    { label: 'Sonnet (recommended) — claude-sonnet-4-6 for all agents', value: 'sonnet' },
+export async function promptModelPreset(detectedModels) {
+  const options = [];
+
+  // If the user already has a model configured, put it first
+  if (detectedModels?.hasModel) {
+    const label = `Use your current model (${detectedModels.primary}) — recommended`;
+    options.push({ label, value: 'detected' });
+  }
+
+  options.push(
+    { label: 'Sonnet — claude-sonnet-4-6 for all agents', value: 'sonnet' },
     { label: 'Opus + Sonnet — Opus for orchestrator, Sonnet for specialists', value: 'opus-sonnet' },
     { label: 'OpenAI — GPT-5.4 / GPT-5.4-mini', value: 'openai' },
     { label: 'Local (Ollama) — requires local models', value: 'local' },
     { label: 'Custom — specify your own model strings', value: 'custom' },
-  ]);
+  );
+
+  return choose('\n  Model selection:', options);
 }
 
 export async function promptCustomModel() {
-  const primary = await input('Primary model (e.g., anthropic/claude-sonnet-4-6)');
-  const orchestrator = await input('Orchestrator model (or same as primary)', primary);
+  const primary = await input('  Primary model (e.g., anthropic/claude-sonnet-4-6, openai/gpt-4o, ollama/llama3)');
+  const orchestrator = await input('  Orchestrator model (or same as primary)', primary);
   return { primary, orchestrator };
 }
 

package/lib/workspace-scaffolder.mjs

@@ -12,7 +12,7 @@ const SKILLS_DIR = join(OPENCLAW_DIR, 'skills');
 const PRODUCT_FILES = ['SOUL.md', 'AGENTS.md', 'IDENTITY.md', 'TOOLS.md'];
 
 // User files — only created if missing
-const USER_FILES = ['PLAYBOOK.md', 'LEARNINGS.md', 'FEEDBACK.md', 'USER.md'];
+const USER_FILES = ['PLAYBOOK.md', 'LEARNINGS.md', 'FEEDBACK.md', 'USER.md', 'MEMORY.md'];
 
 function renderTemplate(template, vars) {
   let result = template;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbiesrobotics/alice-agents",
-  "version": "1.2.8",
+  "version": "1.3.0",
   "description": "A.L.I.C.E. — 28 AI agents for OpenClaw. One conversation, one team.",
   "bin": {
     "alice-agents": "bin/alice-install.mjs"
@@ -28,6 +28,10 @@
     "SELF-HEALING-SPEC.md",
     "README.md"
   ],
+  "scripts": {
+    "test": "node --test test/*.test.mjs",
+    "test:check": "node --check lib/*.mjs bin/*.mjs"
+  },
   "publishConfig": {
     "access": "public"
   }

package/templates/workspaces/_shared/MEMORY.md

@@ -0,0 +1,22 @@
+# MEMORY.md — {{agentName}}
+
+> Persistent memory for {{agentName}}, {{agentDomain}} specialist.
+> This file is yours — add notes, context, and learnings that should persist across sessions.
+
+## Identity
+
+- **Name:** {{agentName}}
+- **Domain:** {{agentDomain}}
+- **Team:** A.L.I.C.E.
+
+## Active Projects
+
+<!-- Add ongoing projects and their current status here -->
+
+## Key Notes
+
+<!-- Jot down anything important to remember across sessions -->
+
+## Decisions Made
+
+<!-- Record significant decisions and their rationale -->