granclaw 0.0.1-beta.0 → 0.0.1-beta.3

package/dist/index.js

@@ -8,6 +8,7 @@ exports.main = main;
 /* eslint-disable no-console */
 const child_process_1 = require("child_process");
 const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const home_js_1 = require("./home.js");
 // package.json is resolved at runtime; require() avoids rootDir complaints
@@ -15,6 +16,54 @@ const home_js_1 = require("./home.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../package.json');
 const DEFAULT_PORT = 8787;
+// ANSI colour helpers — no external deps
+const c = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    cyan: '\x1b[36m',
+    magenta: '\x1b[35m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    white: '\x1b[97m',
+    gray: '\x1b[90m',
+};
+function col(code, text) {
+    return `${code}${text}${c.reset}`;
+}
+function printBanner(version, port, homeDir) {
+    const art = [
+        '   ____                  ____ _               ',
+        '  / ___|_ __ __ _ _ __  / ___| | __ ___      __',
+        " | |  _| '__/ _` | '_ \\| |   | |/ _` \\ \\ /\\ / /",
+        ' | |_| | | | (_| | | | | |___| | (_| |\\ V  V / ',
+        '  \\____|_|  \\__,_|_| |_|\\____|_|\\__,_| \\_/\\_/  ',
+    ];
+    console.log('');
+    for (const line of art) {
+        console.log(col(c.magenta + c.bold, line));
+    }
+    console.log('');
+    console.log(col(c.gray, '  Multi-agent AI framework') +
+        col(c.gray, '  ·  ') +
+        col(c.dim, `v${version}`));
+    console.log('');
+    console.log(col(c.cyan, '  Dashboard  ') + col(c.white + c.bold, `http://localhost:${port}`));
+    console.log(col(c.cyan, '  Home       ') + col(c.white, homeDir));
+    console.log(col(c.cyan, '  Workspaces ') + col(c.white, path_1.default.join(homeDir, 'workspaces')));
+    console.log(col(c.cyan, '  Config     ') + col(c.white, path_1.default.join(homeDir, 'agents.config.json')));
+    console.log(col(c.cyan, '  Logs       ') + col(c.white, path_1.default.join(homeDir, 'data')));
+    console.log('');
+    console.log(col(c.green, '  Opening browser…'));
+    console.log('');
+}
+function openBrowser(url) {
+    const platform = os_1.default.platform();
+    const cmd = platform === 'darwin' ? `open "${url}"` :
+        platform === 'win32' ? `start "" "${url}"` :
+            `xdg-open "${url}"`;
+    (0, child_process_1.exec)(cmd, () => { });
+}
 /**
  * Parse the CLI argv slice (sans `node` and the script path).
  *
@@ -94,6 +143,91 @@ Install from https://claude.ai/download, then rerun.
         process.exit(1);
     }
 }
+/**
+ * Return the path to a real system Chrome/Chromium install, or null if none
+ * is found. Deliberately excludes ~/.agent-browser/browsers/ (Chrome for
+ * Testing) — GranClaw requires a real browser installed on the system.
+ *
+ * Respects AGENT_BROWSER_EXECUTABLE_PATH for users who want a custom binary.
+ */
+function detectSystemChrome() {
+    const override = process.env.AGENT_BROWSER_EXECUTABLE_PATH;
+    if (override)
+        return fs_1.default.existsSync(override) ? override : null;
+    const platform = os_1.default.platform();
+    if (platform === 'darwin') {
+        const candidates = [
+            '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+            '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
+            '/Applications/Chromium.app/Contents/MacOS/Chromium',
+            '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser',
+            path_1.default.join(os_1.default.homedir(), 'Applications/Google Chrome.app/Contents/MacOS/Google Chrome'),
+        ];
+        return candidates.find((p) => fs_1.default.existsSync(p)) ?? null;
+    }
+    if (platform === 'linux') {
+        const candidates = [
+            '/usr/bin/google-chrome',
+            '/usr/bin/google-chrome-stable',
+            '/usr/bin/chromium',
+            '/usr/bin/chromium-browser',
+            '/snap/bin/chromium',
+            '/usr/bin/brave-browser',
+            '/usr/bin/microsoft-edge',
+        ];
+        return candidates.find((p) => fs_1.default.existsSync(p)) ?? null;
+    }
+    if (platform === 'win32') {
+        const local = process.env.LOCALAPPDATA ?? '';
+        const pf = process.env.ProgramFiles ?? 'C:\\Program Files';
+        const pf86 = process.env['ProgramFiles(x86)'] ?? 'C:\\Program Files (x86)';
+        const candidates = [
+            path_1.default.join(local, 'Google', 'Chrome', 'Application', 'chrome.exe'),
+            path_1.default.join(pf, 'Google', 'Chrome', 'Application', 'chrome.exe'),
+            path_1.default.join(pf86, 'Google', 'Chrome', 'Application', 'chrome.exe'),
+            path_1.default.join(local, 'BraveSoftware', 'Brave-Browser', 'Application', 'brave.exe'),
+            path_1.default.join(pf, 'BraveSoftware', 'Brave-Browser', 'Application', 'brave.exe'),
+            path_1.default.join(local, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+            path_1.default.join(pf, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+        ];
+        return candidates.find((p) => fs_1.default.existsSync(p)) ?? null;
+    }
+    return null;
+}
+function requireAgentBrowser() {
+    try {
+        (0, child_process_1.execSync)('agent-browser --version', { stdio: 'ignore' });
+    }
+    catch {
+        console.error(`
+error: agent-browser not found.
+
+GranClaw requires \`agent-browser\` for browser automation.
+
+  npm install -g agent-browser
+`);
+        process.exit(1);
+    }
+    const chrome = detectSystemChrome();
+    if (!chrome) {
+        const platform = os_1.default.platform();
+        const installLink = 'https://google.com/chrome';
+        const linuxExtra = platform === 'linux'
+            ? '\n  sudo apt install google-chrome-stable  # Debian/Ubuntu'
+            : '';
+        console.error(`
+error: Chrome not found.
+
+GranClaw requires Google Chrome (or Chromium / Brave / Edge) installed on
+your system. Install it from:
+
+  ${installLink}${linuxExtra}
+
+To use a custom binary, set AGENT_BROWSER_EXECUTABLE_PATH before running.
+`);
+        process.exit(1);
+    }
+}
 function cliPackageDir() {
     // dist/index.js runs at <cli-pkg>/dist/, so the package root is one up.
     return path_1.default.resolve(__dirname, '..');
@@ -103,6 +237,7 @@ function startServer(parsed) {
     const templatesDir = path_1.default.join(cliPackageDir(), 'templates');
     const staticDir = path_1.default.join(cliPackageDir(), 'dist', 'frontend');
     requireClaudeCli();
+    requireAgentBrowser();
     (0, home_js_1.seedHomeIfNeeded)(homeDir, templatesDir);
     const port = parsed.port ?? (Number(process.env.PORT) || DEFAULT_PORT);
     const env = {
@@ -112,11 +247,10 @@ function startServer(parsed) {
         GRANCLAW_STATIC_DIR: staticDir,
         PORT: String(port),
     };
-    console.log(`GranClaw ${pkg.version}`);
-    console.log(`Data:  ${homeDir}`);
-    console.log(`Port:  ${port}`);
-    console.log(`Ready: http://localhost:${port}`);
-    console.log('');
+    printBanner(pkg.version, port, homeDir);
+    // Open the browser shortly after the server process starts.
+    // 1.5 s is enough for the backend to bind its port on most machines.
+    setTimeout(() => openBrowser(`http://localhost:${port}`), 1500);
     // Spawn the compiled backend entrypoint. Bundled at dist/backend/index.js
     // by the CLI build script (see scripts/build.js).
     const backendEntry = path_1.default.join(cliPackageDir(), 'dist', 'backend', 'index.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "granclaw",
-  "version": "0.0.1-beta.0",
+  "version": "0.0.1-beta.3",
   "description": "A personal AI assistant you run on your own machine.",
   "license": "MIT",
   "repository": {

package/dist/backend/agent/runner.js

@@ -1,334 +0,0 @@
-"use strict";
-/**
- * agent/runner.ts
- *
- * Spawns the Claude Code CLI as a child process for a given agent.
- * Streams output back via a callback. Persists session IDs so conversations
- * continue across messages.
- *
- * Onboarding: if CLAUDE.md is missing from the workspace, the runner copies
- * templates/CLAUDE.onboarding.md there. Claude reads it, decides to onboard
- * (or not), and replaces the file itself when done. The host never checks
- * onboarding state — Claude controls it entirely.
- *
- * Claude CLI invocation:
- *   claude -p "<message>" --output-format stream-json --verbose [--resume <sessionId>]
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.spawnEnv = exports.claudeBin = void 0;
-exports.resolveTemplatesDir = resolveTemplatesDir;
-exports.stopAgent = stopAgent;
-exports.bootstrapWorkspace = bootstrapWorkspace;
-exports.runAgent = runAgent;
-const child_process_1 = require("child_process");
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
-const config_js_1 = require("../config.js");
-const agent_db_js_1 = require("../agent-db.js");
-const logs_db_js_1 = require("../logs-db.js");
-const messages_db_js_1 = require("../messages-db.js");
-const secrets_vault_js_1 = require("../secrets-vault.js");
-const schedules_db_js_1 = require("../schedules-db.js");
-const cron_parser_1 = require("cron-parser");
-// ── Claude binary resolution ──────────────────────────────────────────────────
-// Ensure ~/.local/bin is in PATH for child processes (where the claude CLI lives).
-exports.claudeBin = process.env.CLAUDE_BIN ?? 'claude';
-exports.spawnEnv = {
-    ...process.env,
-    PATH: [
-        path_1.default.join(process.env.HOME ?? '', '.local', 'bin'),
-        path_1.default.join(process.env.HOME ?? '', '.nvm', 'versions', 'node', process.version, 'bin'),
-        process.env.PATH ?? '',
-    ].filter(Boolean).join(':'),
-};
-/**
- * Resolve the templates directory.
- *
- * Priority:
- *   1. GRANCLAW_TEMPLATES_DIR env var — set by the CLI entrypoint to the
- *      templates dir bundled inside the published package.
- *   2. <GRANCLAW_HOME>/packages/cli/templates — dev-mode fallback when the
- *      root dev script does not set the env var.
- *
- * Note: the env var is read on every call (not captured at module load)
- * so the CLI entrypoint can set it just before requiring the backend.
- * The fallback path closes over REPO_ROOT, which is a load-time snapshot
- * of GRANCLAW_HOME — once the process has started, the fallback is stable.
- */
-function resolveTemplatesDir() {
-    const envDir = process.env.GRANCLAW_TEMPLATES_DIR?.trim();
-    if (envDir) {
-        return path_1.default.resolve(envDir);
-    }
-    return path_1.default.resolve(config_js_1.REPO_ROOT, 'packages/cli/templates');
-}
-// Track active Claude processes so they can be killed on stop
-const activeProcesses = new Map();
-function stopAgent(agentId) {
-    const proc = activeProcesses.get(agentId);
-    if (proc) {
-        try {
-            proc.kill('SIGTERM');
-        }
-        catch { /* already dead */ }
-        activeProcesses.delete(agentId);
-        return true;
-    }
-    return false;
-}
-// ── Workspace bootstrap ───────────────────────────────────────────────────────
-function bootstrapWorkspace(workspaceDir) {
-    fs_1.default.mkdirSync(workspaceDir, { recursive: true });
-    const claudeMd = path_1.default.join(workspaceDir, 'CLAUDE.md');
-    if (!fs_1.default.existsSync(claudeMd)) {
-        const template = path_1.default.join(resolveTemplatesDir(), 'CLAUDE.onboarding.md');
-        fs_1.default.copyFileSync(template, claudeMd);
-        console.log(`[runner] copied onboarding CLAUDE.md to ${workspaceDir}`);
-    }
-    // Ensure agent has its own .mcp.json to prevent inheriting project-root MCP servers.
-    // Claude CLI walks up the directory tree to discover .mcp.json — without this,
-    // agents inherit whatever MCP servers the host developer has configured.
-    const mcpJson = path_1.default.join(workspaceDir, '.mcp.json');
-    if (!fs_1.default.existsSync(mcpJson)) {
-        fs_1.default.writeFileSync(mcpJson, JSON.stringify({ mcpServers: {} }, null, 2));
-        console.log(`[runner] created empty .mcp.json in ${workspaceDir}`);
-    }
-    // Bootstrap vault directory structure (second brain)
-    const vaultDir = path_1.default.join(workspaceDir, 'vault');
-    if (!fs_1.default.existsSync(vaultDir)) {
-        for (const sub of ['journal', 'sessions', 'actions', 'topics', 'knowledge']) {
-            fs_1.default.mkdirSync(path_1.default.join(vaultDir, sub), { recursive: true });
-        }
-        console.log(`[runner] created vault structure in ${vaultDir}`);
-    }
-    // Bootstrap skills from templates
-    const skillsTemplateDir = path_1.default.join(resolveTemplatesDir(), 'skills');
-    if (fs_1.default.existsSync(skillsTemplateDir)) {
-        const targetSkillsDir = path_1.default.join(workspaceDir, '.claude', 'skills');
-        for (const skillName of fs_1.default.readdirSync(skillsTemplateDir)) {
-            const srcDir = path_1.default.join(skillsTemplateDir, skillName);
-            const destDir = path_1.default.join(targetSkillsDir, skillName);
-            if (!fs_1.default.statSync(srcDir).isDirectory())
-                continue;
-            if (fs_1.default.existsSync(destDir))
-                continue; // don't overwrite existing
-            fs_1.default.mkdirSync(destDir, { recursive: true });
-            for (const file of fs_1.default.readdirSync(srcDir)) {
-                fs_1.default.copyFileSync(path_1.default.join(srcDir, file), path_1.default.join(destDir, file));
-            }
-            // Make shell scripts executable
-            for (const file of fs_1.default.readdirSync(destDir)) {
-                if (file.endsWith('.sh')) {
-                    fs_1.default.chmodSync(path_1.default.join(destDir, file), 0o755);
-                }
-            }
-            console.log(`[runner] bootstrapped skill "${skillName}" to ${destDir}`);
-        }
-    }
-    // Bootstrap default vault housekeeping schedule
-    const agentId = path_1.default.basename(workspaceDir);
-    try {
-        const existing = (0, schedules_db_js_1.listSchedules)(agentId);
-        const hasHousekeeping = existing.some(s => s.name === 'Vault housekeeping');
-        if (!hasHousekeeping) {
-            const cron = '30 23 * * *';
-            const nextRun = (0, cron_parser_1.parseExpression)(cron, { tz: 'Asia/Singapore' }).next().getTime();
-            (0, schedules_db_js_1.createSchedule)(agentId, {
-                name: 'Vault housekeeping',
-                message: 'Run vault housekeeping: scan all vault folders, rebuild every index.md with one-line summaries for each file, update vault/index.md with folder counts and recent activity. Check for orphaned wikilinks and entities that need topic notes. Never delete files.',
-                cron,
-                timezone: 'Asia/Singapore',
-                nextRun,
-            });
-            console.log(`[runner] created default vault housekeeping schedule for ${agentId}`);
-        }
-    }
-    catch { /* schedules DB may not be ready yet for this agent */ }
-}
-function extractAgentName(workspaceDir) {
-    // After onboarding, Claude writes a real CLAUDE.md with the agent name as H1
-    const claudeMd = path_1.default.join(workspaceDir, 'CLAUDE.md');
-    if (!fs_1.default.existsSync(claudeMd))
-        return null;
-    const content = fs_1.default.readFileSync(claudeMd, 'utf8');
-    const match = content.match(/^#\s+(.+)/m);
-    return match ? match[1].trim() : null;
-}
-// ── Runner ────────────────────────────────────────────────────────────────────
-async function runAgent(agent, message, onChunk, options) {
-    const workspaceDir = path_1.default.resolve(config_js_1.REPO_ROOT, agent.workspaceDir);
-    const channelId = options?.channelId ?? 'ui';
-    bootstrapWorkspace(workspaceDir);
-    // Track soul state before this turn so we know if onboarding just completed
-    const soulExistedBefore = fs_1.default.existsSync(path_1.default.join(workspaceDir, 'SOUL.md'));
-    // If SOUL.md doesn't exist, this is a fresh agent — prepend onboarding nudge
-    // so Claude doesn't give a generic reply and actually follows CLAUDE.md
-    let finalMessage = message;
-    if (!soulExistedBefore) {
-        finalMessage = `[SYSTEM: You are a brand new agent with no identity yet. SOUL.md does not exist. You MUST follow the onboarding instructions in your CLAUDE.md before doing anything else. Do NOT give a generic greeting. Start the onboarding process immediately.]\n\nUser message: ${message}`;
-    }
-    const sessionId = (0, agent_db_js_1.getSession)(workspaceDir, agent.id, channelId);
-    // Always inject recent history from ALL channels so the agent has full context
-    // (UI chat, workflow results — everything the agent said or received)
-    if (soulExistedBefore && !finalMessage.includes('--- Recent History ---')) {
-        const recentMessages = (0, messages_db_js_1.getAllRecentMessages)(agent.id, 50)
-            .filter(m => m.role !== 'tool_call')
-            .slice(-20);
-        if (recentMessages.length > 0) {
-            const history = recentMessages
-                .map(m => {
-                const ch = m.channelId !== 'ui' ? ` [${m.channelId}]` : '';
-                return `[${m.role}${ch}]: ${m.content.slice(0, 500)}`;
-            })
-                .join('\n\n');
-            finalMessage = `[SYSTEM: Here is recent activity across all channels for context.]\n\n--- Recent History ---\n${history}\n--- End History ---\n\nUser: ${message}`;
-        }
-    }
-    const startedAt = Date.now();
-    (0, logs_db_js_1.logAction)(agent.id, 'message', { text: message });
-    const attempt = (resume) => new Promise((resolve, reject) => {
-        const args = ['-p', finalMessage, '--output-format', 'stream-json', '--verbose', '--permission-mode', 'bypassPermissions'];
-        if (resume)
-            args.push('--resume', resume);
-        // Inject core system instructions that every agent must follow (vault, security, skills)
-        const systemMd = path_1.default.join(resolveTemplatesDir(), 'DO_NOT_DELETE.md');
-        if (fs_1.default.existsSync(systemMd)) {
-            args.push('--append-system-prompt-file', systemMd);
-        }
-        // Use --strict-mcp-config to prevent Claude CLI from inheriting MCP servers
-        // from parent directories (e.g., project-root .mcp.json with Playwright).
-        // Only MCP servers explicitly in --mcp-config are loaded.
-        const agentMcpConfig = path_1.default.join(workspaceDir, 'tools.mcp.json');
-        const workspaceMcpConfig = path_1.default.join(workspaceDir, '.mcp.json');
-        if (fs_1.default.existsSync(agentMcpConfig)) {
-            args.push('--mcp-config', agentMcpConfig, '--strict-mcp-config');
-            console.log(`[agent:${agent.id}] loading MCP tools from ${agentMcpConfig} (strict)`);
-        }
-        else if (fs_1.default.existsSync(workspaceMcpConfig)) {
-            args.push('--mcp-config', workspaceMcpConfig, '--strict-mcp-config');
-        }
-        // Inject secrets so they're available regardless of calling process
-        // (agent process has them in env, but orchestrator/workflow runner does not)
-        const agentSecrets = (0, secrets_vault_js_1.getSecrets)(agent.id);
-        const agentEnv = { ...exports.spawnEnv, ...agentSecrets };
-        // CRITICAL: never pass Anthropic auth env vars to the Claude CLI.
-        // Claude Code must use the user's subscription (OAuth), not API mode.
-        // If these are set, the CLI switches to API mode and fails auth.
-        delete agentEnv.ANTHROPIC_API_KEY;
-        delete agentEnv.ANTHROPIC_AUTH_TOKEN;
-        delete agentEnv.ANTHROPIC_BASE_URL;
-        delete agentEnv.CLAUDE_API_KEY;
-        // Browser: session directory + persistent profile (so agent-browser always uses saved logins)
-        agentEnv.AGENT_BROWSER_SESSIONS_DIR = path_1.default.join(workspaceDir, '.browser-sessions');
-        const profileDir = path_1.default.join(workspaceDir, '.browser-profile');
-        if (fs_1.default.existsSync(profileDir)) {
-            agentEnv.AGENT_BROWSER_PROFILE = profileDir;
-        }
-        const proc = (0, child_process_1.spawn)(exports.claudeBin, args, { cwd: workspaceDir, env: agentEnv, stdio: ['pipe', 'pipe', 'pipe'] });
-        proc.stdin?.end();
-        activeProcesses.set(agent.id, proc);
-        proc.on('exit', () => { activeProcesses.delete(agent.id); });
-        let buffer = '';
-        let newSessionId = resume ?? '';
-        proc.stdout.on('data', (raw) => {
-            buffer += raw.toString();
-            const lines = buffer.split('\n');
-            buffer = lines.pop() ?? '';
-            for (const line of lines) {
-                const trimmed = line.trim();
-                if (!trimmed)
-                    continue;
-                let parsed;
-                try {
-                    parsed = JSON.parse(trimmed);
-                }
-                catch {
-                    onChunk({ type: 'text', text: trimmed });
-                    continue;
-                }
-                handleClaudeEvent(parsed, onChunk, (id) => { newSessionId = id; }, agent.id);
-            }
-        });
-        proc.stderr.on('data', (raw) => {
-            const msg = raw.toString().trim();
-            if (msg)
-                console.error(`[agent:${agent.id}] stderr:`, msg);
-        });
-        proc.on('close', async (code) => {
-            if (code === 0 || code === null) {
-                if (newSessionId) {
-                    (0, agent_db_js_1.saveSession)(workspaceDir, agent.id, newSessionId, channelId);
-                }
-                // If SOUL.md was created this turn, Claude finished onboarding — announce name
-                if (!soulExistedBefore && fs_1.default.existsSync(path_1.default.join(workspaceDir, 'SOUL.md'))) {
-                    const name = extractAgentName(workspaceDir);
-                    if (name) {
-                        console.log(`[agent:${agent.id}] onboarding complete — name: "${name}"`);
-                        onChunk({ type: 'agent_ready', name });
-                    }
-                }
-                onChunk({ type: 'done', sessionId: newSessionId });
-                (0, logs_db_js_1.logAction)(agent.id, 'system', null, { exitCode: code }, Date.now() - startedAt);
-                resolve();
-            }
-            else {
-                (0, logs_db_js_1.logAction)(agent.id, 'system', null, { exitCode: code }, Date.now() - startedAt);
-                reject(new Error(`claude exited with code ${code}`));
-            }
-        });
-    });
-    try {
-        await attempt(sessionId);
-    }
-    catch (err) {
-        if (sessionId) {
-            console.warn(`[agent:${agent.id}] session ${sessionId} rejected, retrying fresh`);
-            (0, agent_db_js_1.saveSession)(workspaceDir, agent.id, '', channelId);
-            try {
-                await attempt(null);
-            }
-            catch (retryErr) {
-                onChunk({ type: 'error', message: retryErr instanceof Error ? retryErr.message : String(retryErr) });
-                (0, logs_db_js_1.logAction)(agent.id, 'error', null, { message: retryErr instanceof Error ? retryErr.message : String(retryErr) });
-            }
-        }
-        else {
-            onChunk({ type: 'error', message: err instanceof Error ? err.message : String(err) });
-            (0, logs_db_js_1.logAction)(agent.id, 'error', null, { message: err instanceof Error ? err.message : String(err) });
-        }
-    }
-}
-function handleClaudeEvent(event, onChunk, onSessionId, agentId) {
-    const type = event.type;
-    if (type === 'assistant') {
-        const msg = event.message;
-        if (msg?.content) {
-            for (const block of msg.content) {
-                if (block.type === 'text' && block.text) {
-                    onChunk({ type: 'text', text: block.text });
-                }
-                else if (block.type === 'tool_use') {
-                    const b = block;
-                    onChunk({ type: 'tool_call', tool: b.name ?? 'unknown', input: b.input });
-                    if (agentId)
-                        (0, logs_db_js_1.logAction)(agentId, 'tool_call', { tool: b.name, input: b.input });
-                }
-            }
-        }
-    }
-    else if (type === 'tool_result') {
-        const content = event.content;
-        const text = content?.find((c) => c.type === 'text')?.text ?? '';
-        onChunk({ type: 'tool_result', tool: '', output: text });
-        if (agentId)
-            (0, logs_db_js_1.logAction)(agentId, 'tool_result', null, { text: text.slice(0, 500) });
-    }
-    else if (type === 'result') {
-        const sid = event.session_id;
-        if (sid)
-            onSessionId(sid);
-    }
-}

package/dist/frontend/chat-history-options.html

@@ -1,304 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <title>Chat History — Architecture Options</title>
-  <script src="https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js"></script>
-  <style>
-    :root {
-      --bg: #0d0d0d;
-      --surface: #161616;
-      --card: #1e1e1e;
-      --border: #2a2a2a;
-      --text: #e8e8e8;
-      --muted: #888;
-      --accent-a: #7c3aed;
-      --accent-b: #0ea5e9;
-      --accent-c: #10b981;
-      --warn: #f59e0b;
-    }
-
-    * { box-sizing: border-box; margin: 0; padding: 0; }
-
-    body {
-      background: var(--bg);
-      color: var(--text);
-      font-family: 'Inter', system-ui, sans-serif;
-      padding: 48px 32px;
-    }
-
-    h1 {
-      font-size: 1.5rem;
-      font-weight: 700;
-      margin-bottom: 8px;
-      letter-spacing: -0.02em;
-    }
-
-    .subtitle {
-      color: var(--muted);
-      font-size: 0.875rem;
-      margin-bottom: 48px;
-    }
-
-    .options {
-      display: grid;
-      grid-template-columns: repeat(3, 1fr);
-      gap: 24px;
-      margin-bottom: 48px;
-    }
-
-    .option {
-      background: var(--card);
-      border: 1px solid var(--border);
-      border-radius: 12px;
-      overflow: hidden;
-    }
-
-    .option-header {
-      padding: 16px 20px 12px;
-      border-bottom: 1px solid var(--border);
-    }
-
-    .option-label {
-      font-size: 0.7rem;
-      font-weight: 600;
-      letter-spacing: 0.1em;
-      text-transform: uppercase;
-      margin-bottom: 4px;
-    }
-
-    .option-a .option-label { color: var(--accent-a); }
-    .option-b .option-label { color: var(--accent-b); }
-    .option-c .option-label { color: var(--accent-c); }
-
-    .option-title {
-      font-size: 1rem;
-      font-weight: 600;
-    }
-
-    .diagram {
-      padding: 20px;
-    }
-
-    /* Hand-drawn style diagrams with SVG */
-    .diagram svg {
-      width: 100%;
-      height: auto;
-    }
-
-    .tradeoffs {
-      padding: 16px 20px;
-      border-top: 1px solid var(--border);
-      display: flex;
-      flex-direction: column;
-      gap: 8px;
-    }
-
-    .tradeoff {
-      display: flex;
-      align-items: flex-start;
-      gap: 8px;
-      font-size: 0.78rem;
-      line-height: 1.4;
-    }
-
-    .tradeoff .icon {
-      flex-shrink: 0;
-      margin-top: 1px;
-    }
-
-    .pro { color: var(--accent-c); }
-    .con { color: #f87171; }
-
-    .recommendation {
-      background: var(--card);
-      border: 1px solid var(--accent-c);
-      border-radius: 12px;
-      padding: 24px;
-    }
-
-    .recommendation h2 {
-      font-size: 0.7rem;
-      font-weight: 600;
-      letter-spacing: 0.1em;
-      text-transform: uppercase;
-      color: var(--accent-c);
-      margin-bottom: 8px;
-    }
-
-    .recommendation h3 {
-      font-size: 1.1rem;
-      font-weight: 600;
-      margin-bottom: 16px;
-    }
-
-    .rec-diagram {
-      background: var(--surface);
-      border-radius: 8px;
-      padding: 20px;
-    }
-
-    /* Mermaid theme overrides */
-    .mermaid {
-      background: transparent !important;
-    }
-  </style>
-</head>
-<body>
-
-<h1>Chat History — Architecture Options</h1>
-<p class="subtitle">How should agent-brother store messages so agents remember across channels and the UI can display history?</p>
-
-<div class="options">
-
-  <!-- OPTION A -->
-  <div class="option option-a">
-    <div class="option-header">
-      <div class="option-label">Option A</div>
-      <div class="option-title">Session per conversation</div>
-    </div>
-    <div class="diagram">
-      <div class="mermaid">
-%%{init: {'theme': 'dark', 'themeVariables': {'background': '#1e1e1e', 'primaryColor': '#7c3aed', 'primaryTextColor': '#e8e8e8', 'primaryBorderColor': '#7c3aed', 'lineColor': '#555', 'secondaryColor': '#2a2a2a', 'tertiaryColor': '#1e1e1e', 'edgeLabelBackground': '#1e1e1e', 'fontSize': '12px'}}}%%
-flowchart TD
-    WA["📱 WhatsApp"] -->|msg + channel:wa| B
-    LI["💼 LinkedIn"] -->|msg + channel:li| B
-    UI["🖥 Dashboard UI"] -->|msg + channel:ui| B
-
-    B["Backend\nOrchestrator"]
-
-    B -->|resume session_wa| AG
-    B -->|resume session_li| AG
-    B -->|resume session_ui| AG
-
-    AG["🤖 Agent\nRunner"]
-    AG -->|spawns| CL["claude CLI\n--resume &lt;session_id&gt;"]
-
-    AG -->|stores| DB[("SQLite\nsession_wa\nsession_li\nsession_ui")]
-
-    B -->|log msg| MG[("MongoDB\nmessages")]
-
-    MG -->|history| UI
-      </div>
-    </div>
-    <div class="tradeoffs">
-      <div class="tradeoff pro"><span class="icon">✓</span><span>Each channel has its own Claude context window — no cross-talk</span></div>
-      <div class="tradeoff pro"><span class="icon">✓</span><span>Fast — no extra tokens injected per request</span></div>
-      <div class="tradeoff con"><span class="icon">✗</span><span>Claude sessions expire — agent loses memory cold on restart</span></div>
-      <div class="tradeoff con"><span class="icon">✗</span><span>Can't move a conversation between channels</span></div>
-    </div>
-  </div>
-
-  <!-- OPTION B -->
-  <div class="option option-b">
-    <div class="option-header">
-      <div class="option-label">Option B</div>
-      <div class="option-title">Inject history, no sessions</div>
-    </div>
-    <div class="diagram">
-      <div class="mermaid">
-%%{init: {'theme': 'dark', 'themeVariables': {'background': '#1e1e1e', 'primaryColor': '#0ea5e9', 'primaryTextColor': '#e8e8e8', 'primaryBorderColor': '#0ea5e9', 'lineColor': '#555', 'secondaryColor': '#2a2a2a', 'tertiaryColor': '#1e1e1e', 'edgeLabelBackground': '#1e1e1e', 'fontSize': '12px'}}}%%
-flowchart TD
-    WA["📱 WhatsApp"] -->|msg| B
-    LI["💼 LinkedIn"] -->|msg| B
-    UI["🖥 Dashboard UI"] -->|msg| B
-
-    B["Backend\nOrchestrator"]
-
-    B -->|fetch last N msgs| MG[("MongoDB\nmessages")]
-    MG -->|history| B
-
-    B -->|prompt = history + msg| AG["🤖 Agent\nRunner"]
-    AG -->|spawns fresh| CL["claude CLI\n-p 'prev: ...\nuser: ...'"]
-
-    AG -->|save reply| MG
-
-    MG -->|display| UI
-      </div>
-    </div>
-    <div class="tradeoffs">
-      <div class="tradeoff pro"><span class="icon">✓</span><span>Full control over what agent sees — no session expiry surprises</span></div>
-      <div class="tradeoff pro"><span class="icon">✓</span><span>Conversation can move freely across channels</span></div>
-      <div class="tradeoff con"><span class="icon">✗</span><span>Extra tokens on every request — slower and more expensive</span></div>
-      <div class="tradeoff con"><span class="icon">✗</span><span>Context window fills up on long conversations</span></div>
-    </div>
-  </div>
-
-  <!-- OPTION C -->
-  <div class="option option-c">
-    <div class="option-header">
-      <div class="option-label">Option C — Recommended</div>
-      <div class="option-title">Hybrid: resume + fallback inject</div>
-    </div>
-    <div class="diagram">
-      <div class="mermaid">
-%%{init: {'theme': 'dark', 'themeVariables': {'background': '#1e1e1e', 'primaryColor': '#10b981', 'primaryTextColor': '#e8e8e8', 'primaryBorderColor': '#10b981', 'lineColor': '#555', 'secondaryColor': '#2a2a2a', 'tertiaryColor': '#1e1e1e', 'edgeLabelBackground': '#1e1e1e', 'fontSize': '12px'}}}%%
-flowchart TD
-    WA["📱 WhatsApp"] --> B
-    LI["💼 LinkedIn"] --> B
-    UI["🖥 Dashboard UI"] --> B
-
-    B["Backend\nOrchestrator"]
-    B -->|save msg| MG[("MongoDB\nmessages")]
-    B -->|run| AG["🤖 Agent\nRunner"]
-
-    AG -->|happy path| CL1["claude CLI\n--resume session_id"]
-    CL1 -->|exit 1 / expired| FB["⚠ Session expired\nfallback"]
-
-    FB -->|fetch last 20 msgs| MG
-    MG --> FB
-    FB -->|inject as context| CL2["claude CLI\nfresh + history"]
-
-    CL1 -->|reply| B
-    CL2 -->|reply + new session_id| B
-
-    B -->|save reply| MG
-    MG -->|display| UI
-      </div>
-    </div>
-    <div class="tradeoffs">
-      <div class="tradeoff pro"><span class="icon">✓</span><span>Fast on happy path (--resume, no extra tokens)</span></div>
-      <div class="tradeoff pro"><span class="icon">✓</span><span>Survives session expiry — injects history automatically</span></div>
-      <div class="tradeoff pro"><span class="icon">✓</span><span>Full message log in MongoDB for UI + cross-channel queries</span></div>
-      <div class="tradeoff con"><span class="icon">✗</span><span>Slightly more complex runner logic (already partially there)</span></div>
-    </div>
-  </div>
-
-</div>
-
-<!-- DATA MODEL -->
-<div class="recommendation">
-  <h2>Recommended data model — Option C</h2>
-  <h3>MongoDB <code>messages</code> collection + SQLite <code>agent_sessions</code> per (agent, channel, conversation)</h3>
-  <div class="rec-diagram">
-    <div class="mermaid">
-%%{init: {'theme': 'dark', 'themeVariables': {'background': '#161616', 'primaryColor': '#10b981', 'primaryTextColor': '#e8e8e8', 'primaryBorderColor': '#10b981', 'lineColor': '#555', 'secondaryColor': '#2a2a2a', 'tertiaryColor': '#161616', 'edgeLabelBackground': '#161616', 'fontSize': '13px'}}}%%
-erDiagram
-    MESSAGE {
-        string id PK
-        string agentId
-        string channelId "ui | whatsapp | linkedin"
-        string conversationId "groups a thread"
-        string role "user | assistant"
-        string content
-        number createdAt
-    }
-
-    AGENT_SESSION {
-        string agentId PK
-        string channelId PK
-        string conversationId PK
-        string sessionId "Claude resume token"
-        number updatedAt
-    }
-
-    MESSAGE }o--|| AGENT_SESSION : "linked by agentId+channelId+conversationId"
-    </div>
-  </div>
-</div>
-
-<script>
-  mermaid.initialize({ startOnLoad: true, theme: 'dark' });
-</script>
-</body>
-</html>