@robbiesrobotics/alice-agents 1.0.0

package/lib/prompter.mjs

@@ -0,0 +1,102 @@
+import { createInterface } from 'node:readline';
+
+// Simple readline-based prompts. Zero deps.
+
+let rl;
+
+function getRL() {
+  if (!rl) {
+    rl = createInterface({ input: process.stdin, output: process.stdout });
+  }
+  return rl;
+}
+
+export function closePrompt() {
+  if (rl) {
+    rl.close();
+    rl = null;
+  }
+}
+
+function ask(question) {
+  return new Promise((resolve) => {
+    getRL().question(question, (answer) => resolve(answer.trim()));
+  });
+}
+
+export async function confirm(message, defaultYes = true) {
+  const hint = defaultYes ? '[Y/n]' : '[y/N]';
+  const answer = await ask(`${message} ${hint} `);
+  if (!answer) return defaultYes;
+  return answer.toLowerCase().startsWith('y');
+}
+
+export async function choose(message, options) {
+  console.log(`\n${message}\n`);
+  for (let i = 0; i < options.length; i++) {
+    console.log(`  ${i + 1}. ${options[i].label}`);
+  }
+  console.log();
+  const answer = await ask(`Choice [1-${options.length}]: `);
+  const idx = parseInt(answer, 10) - 1;
+  if (idx >= 0 && idx < options.length) return options[idx].value;
+  // Default to first
+  return options[0].value;
+}
+
+export async function input(message, defaultValue = '') {
+  const hint = defaultValue ? ` [${defaultValue}]` : '';
+  const answer = await ask(`${message}${hint}: `);
+  return answer || defaultValue;
+}
+
+export function detectTimezone() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone;
+  } catch {
+    return 'UTC';
+  }
+}
+
+export function detectUserName() {
+  const { env } = process;
+  return env.USER || env.USERNAME || env.LOGNAME || 'User';
+}
+
+export async function promptInstallMode() {
+  return choose('Install mode:', [
+    { label: 'Fresh install — replace agents section (recommended for first install)', value: 'fresh' },
+    { label: 'Merge — add A.L.I.C.E. agents alongside existing ones', value: 'merge' },
+    { label: 'Upgrade — update product files only (preserves user customizations)', value: 'upgrade' },
+  ]);
+}
+
+export async function promptUserInfo() {
+  const name = await input('Your name', detectUserName());
+  const tz = await input('Timezone', detectTimezone());
+  const notes = await input('Any notes about yourself (optional)', '');
+  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' },
+    { label: 'Opus + Sonnet — Opus for orchestrator, Sonnet for specialists', value: 'opus-sonnet' },
+    { label: 'OpenAI — GPT-4.1 / GPT-4.1-mini', value: 'openai' },
+    { label: 'Local (Ollama) — requires local models', value: 'local' },
+    { label: 'Custom — specify your own model strings', value: 'custom' },
+  ]);
+}
+
+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);
+  return { primary, orchestrator };
+}
+
+export async function promptTier() {
+  return choose('Agent tier:', [
+    { label: 'Starter (10 agents) — core team for most workflows', value: 'starter' },
+    { label: 'Pro (all 28 agents) — full specialist roster', value: 'pro' },
+  ]);
+}

package/lib/workspace-scaffolder.mjs

@@ -0,0 +1,112 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = join(__dirname, '..', 'templates', 'workspaces');
+const OPENCLAW_DIR = join(homedir(), '.openclaw');
+
+// Product files — always overwritten on install/upgrade
+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'];
+
+function renderTemplate(template, vars) {
+  let result = template;
+  for (const [key, value] of Object.entries(vars)) {
+    result = result.replaceAll(`{{${key}}}`, value);
+  }
+  return result;
+}
+
+function loadTemplate(filename) {
+  const sharedPath = join(TEMPLATES_DIR, '_shared', filename);
+  if (existsSync(sharedPath)) {
+    return readFileSync(sharedPath, 'utf8');
+  }
+  return null;
+}
+
+function getTemplateVariant(baseName, agent) {
+  // Check for agent-specific override first
+  const agentOverridePath = join(TEMPLATES_DIR, agent.id, baseName);
+  if (existsSync(agentOverridePath)) {
+    return readFileSync(agentOverridePath, 'utf8');
+  }
+
+  // Use variant-based naming
+  if (agent.isOrchestrator) {
+    const orchestratorTemplate = loadTemplate(`${baseName.replace('.md', '')}-orchestrator.md`);
+    if (orchestratorTemplate) return orchestratorTemplate;
+  }
+
+  if (agent.coding) {
+    const codingTemplate = loadTemplate(`${baseName.replace('.md', '')}-coding.md`);
+    if (codingTemplate) return codingTemplate;
+  }
+
+  // Fallback to default
+  return loadTemplate(baseName);
+}
+
+export function scaffoldWorkspace(agent, userInfo, agentCount) {
+  const workspaceDir = join(OPENCLAW_DIR, `workspace-${agent.id}`);
+
+  // Create workspace + memory dirs
+  mkdirSync(join(workspaceDir, 'memory'), { recursive: true });
+
+  const vars = {
+    userName: userInfo.name,
+    userTimezone: userInfo.timezone,
+    userNotes: userInfo.notes ? `- **Notes:** ${userInfo.notes}` : '',
+    agentName: agent.name,
+    agentDomain: agent.domain,
+    agentEmoji: agent.emoji,
+    agentDescription: agent.description,
+    agentCount: String(agentCount),
+  };
+
+  const written = [];
+  const skipped = [];
+
+  // Product files — always overwrite
+  for (const filename of PRODUCT_FILES) {
+    const template = getTemplateVariant(filename, agent);
+    if (template) {
+      const content = renderTemplate(template, vars);
+      writeFileSync(join(workspaceDir, filename), content, 'utf8');
+      written.push(filename);
+    }
+  }
+
+  // User files — only create if missing
+  for (const filename of USER_FILES) {
+    const filePath = join(workspaceDir, filename);
+    if (!existsSync(filePath)) {
+      const template = loadTemplate(filename);
+      if (template) {
+        const content = renderTemplate(template, vars);
+        writeFileSync(filePath, content, 'utf8');
+        written.push(filename);
+      }
+    } else {
+      skipped.push(filename);
+    }
+  }
+
+  return { workspaceDir, written, skipped };
+}
+
+export function scaffoldAll(agents, userInfo) {
+  const agentCount = agents.length;
+  const results = [];
+
+  for (const agent of agents) {
+    const result = scaffoldWorkspace(agent, userInfo, agentCount);
+    results.push({ agent: agent.id, ...result });
+  }
+
+  return results;
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@robbiesrobotics/alice-agents",
+  "version": "1.0.0",
+  "description": "A.L.I.C.E. — 28 AI agents for OpenClaw. One conversation, one team.",
+  "bin": {
+    "alice-agents": "bin/alice-install.mjs"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "openclaw",
+    "ai-agents",
+    "multi-agent",
+    "orchestration",
+    "alice"
+  ],
+  "license": "MIT",
+  "files": [
+    "bin/",
+    "lib/",
+    "templates/",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}