compact-agent 1.31.2 → 1.32.1

package/dist/command-palette.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Command palette catalog — the slash commands exposed via the
+ * Space-at-empty quick picker. Hand-curated rather than auto-
+ * extracted from handleSlashCommand's switch, because:
+ *
+ *   1. The switch contains alias arms (/branch → /fork, /quit → /exit,
+ *      etc.) that would clutter a UI listing.
+ *   2. Some commands are internal sentinels (__DICTATE__, __SWARM__)
+ *      that should never appear to users.
+ *   3. Curating gives us a tight description column for each entry —
+ *      the picker shows label + hint + description, and a hand-
+ *      written one-liner is more scannable than a parsed comment.
+ *
+ * Categories mirror /help's grouping so muscle memory transfers.
+ */
+export interface CommandEntry {
+    command: string;
+    description: string;
+    category: string;
+}
+export declare const COMMAND_CATALOG: CommandEntry[];

package/dist/command-palette.js

@@ -0,0 +1,106 @@
+/**
+ * Command palette catalog — the slash commands exposed via the
+ * Space-at-empty quick picker. Hand-curated rather than auto-
+ * extracted from handleSlashCommand's switch, because:
+ *
+ *   1. The switch contains alias arms (/branch → /fork, /quit → /exit,
+ *      etc.) that would clutter a UI listing.
+ *   2. Some commands are internal sentinels (__DICTATE__, __SWARM__)
+ *      that should never appear to users.
+ *   3. Curating gives us a tight description column for each entry —
+ *      the picker shows label + hint + description, and a hand-
+ *      written one-liner is more scannable than a parsed comment.
+ *
+ * Categories mirror /help's grouping so muscle memory transfers.
+ */
+export const COMMAND_CATALOG = [
+    // ── General ──
+    { command: '/help', description: 'Show the full command reference', category: 'General' },
+    { command: '/clear', description: 'Reset the conversation (also resets side-channel state)', category: 'General' },
+    { command: '/back', description: 'Rewind to before the nth most-recent user turn', category: 'General' },
+    { command: '/fork', description: 'Branch the current conversation; previous still resumable', category: 'General' },
+    { command: '/btw', description: 'Side question that doesn\'t pollute the main thread', category: 'General' },
+    { command: '/editor', description: 'Open $EDITOR for a multi-line prompt', category: 'General' },
+    { command: '/history', description: 'Message count + token estimate', category: 'General' },
+    { command: '/export', description: 'Export conversation (md/json/txt)', category: 'General' },
+    { command: '/walkthrough', description: 'Agent-led tour of compact-agent', category: 'General' },
+    { command: '/config', description: 'Reconfigure provider / model / key (re-runs the setup wizard)', category: 'General' },
+    { command: '/theme', description: 'Change display mode (full/compact/minimal)', category: 'General' },
+    { command: '/palette', description: 'Switch color palette (run /palettes to list)', category: 'General' },
+    // ── Model & Provider ──
+    { command: '/model', description: 'Switch model (no arg → interactive picker on OpenRouter)', category: 'Model' },
+    { command: '/models', description: 'List available models for the current provider', category: 'Model' },
+    { command: '/fallback', description: 'Set/show the model auto-retried on cryptic errors', category: 'Model' },
+    { command: '/provider', description: 'Show provider info (URL, masked key)', category: 'Model' },
+    { command: '/keys', description: 'Multi-key rotation pool (/keys add, status, remove)', category: 'Model' },
+    { command: '/route', description: 'Auto-route to a model based on the next message', category: 'Model' },
+    // ── Modes ──
+    { command: '/mode', description: 'Switch mode (dev/review/tdd/research/plan/debug/architect/hermes/design)', category: 'Modes' },
+    { command: '/modes', description: 'List all available modes', category: 'Modes' },
+    { command: '/hermes', description: 'Switch to Hermes mode (self-improving learning loop)', category: 'Modes' },
+    { command: '/design', description: 'Switch to design mode (Stitch-powered UI work)', category: 'Modes' },
+    // ── Session ──
+    { command: '/sessions', description: 'List saved sessions', category: 'Session' },
+    { command: '/save', description: 'Save current session', category: 'Session' },
+    { command: '/resume', description: 'Resume a saved session (accepts id, prefix, or "last")', category: 'Session' },
+    { command: '/delete', description: 'Delete a session', category: 'Session' },
+    // ── Git ──
+    { command: '/commit', description: 'AI-generated commit message', category: 'Git' },
+    { command: '/pr', description: 'AI-generated pull request', category: 'Git' },
+    { command: '/diff', description: 'Show git diff', category: 'Git' },
+    { command: '/log', description: 'Show git log', category: 'Git' },
+    // ── Code Quality ──
+    { command: '/review', description: 'AI code review (severity-rated findings)', category: 'Code Quality' },
+    { command: '/auto-review', description: 'Code review with auto-detected language lens', category: 'Code Quality' },
+    { command: '/tdd', description: 'Test-driven workflow (RED → GREEN → REFACTOR)', category: 'Code Quality' },
+    { command: '/security-review', description: 'Security-focused audit', category: 'Code Quality' },
+    { command: '/audit', description: 'Local-only project health check', category: 'Code Quality' },
+    { command: '/verify', description: 'Run tests, fix failures, repeat until green', category: 'Code Quality' },
+    { command: '/build-fix', description: 'Auto-detect language + fix build errors', category: 'Code Quality' },
+    { command: '/test-coverage', description: 'Analyze coverage, suggest missing tests', category: 'Code Quality' },
+    { command: '/refactor', description: 'Dead code detection + cleanup', category: 'Code Quality' },
+    { command: '/hunt-silent', description: 'Silent-failure-hunter agent (empty catches, log-and-forget)', category: 'Code Quality' },
+    { command: '/explore', description: 'Code-explorer agent (codebase reconnaissance pass)', category: 'Code Quality' },
+    { command: '/types', description: 'Type-design-analyzer agent (type system critique)', category: 'Code Quality' },
+    { command: '/architect', description: 'Code-architect agent (structural critique)', category: 'Code Quality' },
+    { command: '/simplify', description: 'Code-simplifier agent (find + collapse incidental complexity)', category: 'Code Quality' },
+    { command: '/e2e', description: 'Generate E2E tests', category: 'Code Quality' },
+    // ── Tools & Config ──
+    { command: '/tools', description: 'List currently-available tools', category: 'Config' },
+    { command: '/perm', description: 'Permission mode (ask/auto/yolo)', category: 'Config' },
+    { command: '/sandbox', description: 'OS-native bash sandbox (off/standard/strict)', category: 'Config' },
+    { command: '/dry-run', description: 'Toggle dry-run mode (preview tool calls)', category: 'Config' },
+    { command: '/thinking', description: 'Toggle thinking/reasoning display', category: 'Config' },
+    { command: '/cd', description: 'Change working directory', category: 'Config' },
+    { command: '/hooks', description: 'List configured hooks', category: 'Config' },
+    // ── Planning ──
+    { command: '/plan', description: 'Structured implementation planning', category: 'Planning' },
+    { command: '/checkpoint', description: 'Save git-state checkpoint inside this session', category: 'Planning' },
+    { command: '/search-first', description: 'Research before coding', category: 'Planning' },
+    { command: '/update-docs', description: 'Sync documentation with code', category: 'Planning' },
+    // ── Orchestration ──
+    { command: '/orchestrate', description: 'Decompose into parallel sub-agents', category: 'Orchestration' },
+    { command: '/swarm', description: 'Parallel fan-out: N agents on the same task', category: 'Orchestration' },
+    { command: '/multi-plan', description: 'Multi-agent planning', category: 'Orchestration' },
+    // ── Skills & Memory ──
+    { command: '/skills', description: 'List learned + bundled ECC skills', category: 'Skills' },
+    { command: '/skill-show', description: 'Print the full prompt of a specific skill', category: 'Skills' },
+    { command: '/ecc-guide', description: 'Browse the bundled ECC corpus', category: 'Skills' },
+    { command: '/memory', description: 'MemPalace: status, search, recall, list', category: 'Skills' },
+    { command: '/learn', description: 'Extract patterns from this session into instincts', category: 'Skills' },
+    // ── Cost & Usage ──
+    { command: '/usage', description: 'Token + cost summary', category: 'Cost' },
+    { command: '/budget', description: 'Set daily/monthly USD budget', category: 'Cost' },
+    // ── Debug ──
+    { command: '/debug', description: 'Toggle debug instrumentation + tail event log', category: 'Debug' },
+    // ── Voice / Accessibility ──
+    { command: '/voice', description: 'Voice config + master switch', category: 'Voice' },
+    { command: '/accessibility', description: 'Screen-reader mode, audio cues, destructive-confirm', category: 'Voice' },
+    { command: '/dictate', description: 'One-shot record + transcribe', category: 'Voice' },
+    // ── Stitch ──
+    { command: '/stitch', description: 'Show Stitch config status', category: 'Stitch' },
+    { command: '/stitch-config', description: 'Save your Stitch API key', category: 'Stitch' },
+    // ── Exit ──
+    { command: '/exit', description: 'Quit the REPL', category: 'General' },
+];
+//# sourceMappingURL=command-palette.js.map

package/dist/command-palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-palette.js","sourceRoot":"","sources":["../src/command-palette.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -351,7 +351,21 @@ async function askWithDecoratedPrompt(rl, sessionTag, modeTag, promptGlyph) {
     return rl.question(theme.prompt(promptGlyph));
 }
 /**
- * Parse slash command respecting quoted strings
+ * Parse a slash command into (cmd, args).
+ *
+ * Args normalization: leading + trailing angle brackets are stripped
+ * automatically. The /help text uses `<arg>` as placeholder syntax
+ * (e.g. `/resume <session-id>`, `/model <name>`), and users routinely
+ * paste the placeholder literally — `/resume <abc123>` instead of
+ * `/resume abc123`. Stripping at the parser level means every
+ * command gets the same forgiving treatment without each handler
+ * having to defensively unwrap.
+ *
+ * Quotes / brackets other than `<>` are intentionally NOT stripped
+ * here. Some commands legitimately take quoted strings (e.g.
+ * `/article "How to be a vibe coder"`) — those commands should
+ * handle their own quote semantics. Only the `<>` placeholder
+ * pattern is normalized universally.
  */
 function parseSlashCommand(input) {
     const trimmed = input.trim();
@@ -360,8 +374,14 @@ function parseSlashCommand(input) {
         return { cmd: trimmed.toLowerCase(), args: '' };
     }
     const cmd = trimmed.slice(0, spaceIdx).toLowerCase();
-    const argsRaw = trimmed.slice(spaceIdx + 1);
-    // Keep quoted strings intact
+    let argsRaw = trimmed.slice(spaceIdx + 1).trim();
+    // Strip leading + trailing `<>` if they wrap the entire arg
+    // string. Keeps `<>` inside the arg untouched (e.g. paths with
+    // angle brackets in regex-style queries) — only the outermost
+    // wrap is removed.
+    if (argsRaw.startsWith('<') && argsRaw.endsWith('>') && argsRaw.length > 2) {
+        argsRaw = argsRaw.slice(1, -1).trim();
+    }
     return { cmd, args: argsRaw };
 }
 // ── Slash Commands ────────────────────────────────────────
@@ -810,10 +830,20 @@ export function handleSlashCommand(input, config, messages, session, mode) {
                     resetClient();
                     console.log(chalk.green(`  Model: ${config.model} (custom)`));
                 }
+                return { handled: true };
             }
-            else {
-                console.log(chalk.dim(`  Current: ${config.model}`));
+            // No args. On OpenRouter, the user wants the interactive
+            // picker (catalog + pricing). On other providers we don't
+            // have an equivalent catalog endpoint, so keep the legacy
+            // "show current" behavior.
+            if (/openrouter/i.test(config.provider)) {
+                // The picker is async; handleSlashCommand is sync. Use the
+                // sentinel-injectPrompt pattern that /dictate + /swarm
+                // already use to defer async work to the main REPL loop.
+                return { handled: true, injectPrompt: '__PICK_MODEL__' };
             }
+            console.log(chalk.dim(`  Current: ${config.model}`));
+            console.log(chalk.dim('  (interactive picker is OpenRouter-only — pass a model name explicitly with /model <id>)'));
             return { handled: true };
         case '/models':
             printModelOptions(config);
@@ -2538,7 +2568,34 @@ export function handleSlashCommand(input, config, messages, session, mode) {
 }
 // ── Main ──────────────────────────────────────────────────
 async function main() {
-    const rl = readline.createInterface({ input: stdin, output: stdout });
+    // Slash-command completer: bash-style Tab completion. Triggered
+    // only when the typed line starts with '/' so it doesn't interfere
+    // with regular prose. When the user has typed a unique prefix, Tab
+    // completes to the full command. When multiple commands share the
+    // prefix, readline's default behavior is to print the list of
+    // candidates on the next Tab press — same UX as bash/zsh.
+    //
+    // This is COMPLEMENTARY to the '/' keypress trigger that opens the
+    // alt-screen picker: that's the "I want to browse" path; this is
+    // the "I know what I'm typing, just save me keystrokes" path. The
+    // two coexist because pressing '/' fires the picker only at an
+    // empty buffer — once the user has typed beyond '/', Tab takes
+    // over via this completer.
+    const { COMMAND_CATALOG } = await import('./command-palette.js');
+    const slashCommandNames = COMMAND_CATALOG.map((c) => c.command);
+    const rl = readline.createInterface({
+        input: stdin,
+        output: stdout,
+        completer: (line) => {
+            if (!line.startsWith('/'))
+                return [[], line];
+            const matches = slashCommandNames.filter((c) => c.startsWith(line));
+            // readline contract: return [matches, lineWeMatchedAgainst].
+            // If matches is empty, readline beeps; otherwise it completes
+            // to common prefix or lists candidates.
+            return [matches.length > 0 ? matches : slashCommandNames, line];
+        },
+    });
     // Initialize subsystems
     initHooksDir();
     // First-run ECC install — silent if already installed, silent if resources missing.
@@ -2715,10 +2772,18 @@ async function main() {
             'tab', // Shift+Tab cycles perm modes
             'escape', // Esc-Esc rewind at empty prompt
             ',', '.', // Alt+, / Alt+. reasoning effort
+            'space', // Space at empty prompt → command palette
+            '/', // / at empty prompt → palette filtered to '/'
             // Shifted F-keys carry the Tier-2 and Tier-3 a11y functions. Each
             // is checked alongside key.shift below, so a bare F1 still routes
             // to "status" while Shift+F1 routes to "queued input."
         ]);
+        // Re-entry guard for the picker. The keypress listener can fire
+        // again while the picker is still in alt-screen mode (the user
+        // pressed something the picker handled but we still saw the
+        // 'keypress' event), so we need to make sure we don't open a
+        // second picker on top of the first.
+        let pickerActive = false;
         // Define the hotkey listener as a NAMED, TAGGED function so
         // suppressInputDuringStream() in query.ts can isolate it among stdin's
         // 'keypress' listeners. During streaming we detach readline's own
@@ -2749,6 +2814,17 @@ async function main() {
                 return;
             if (name === 'escape' && (shift || ctrl || meta))
                 return;
+            // Space is ours ONLY when the input buffer is empty and we're
+            // at a prompt (not mid-streaming). The check happens in the
+            // dedicated branch below; here we just defer if there's any
+            // modifier (Shift+Space, Ctrl+Space, etc. aren't us).
+            if (name === 'space' && (shift || ctrl || meta))
+                return;
+            // Slash autocomplete: '/' at empty prompt opens the picker
+            // pre-filtered to '/'. Modified variants (Ctrl+/, etc.) are
+            // not ours.
+            if (name === '/' && (shift || ctrl || meta))
+                return;
             const a = getAccessibilityConfig(config);
             const tts = getTtsConfig(config);
             // Helper: print to stdout (always — picked up by the OS screen reader)
@@ -2921,6 +2997,103 @@ async function main() {
                 // Any other shifted F-key: no-op (don't fall through to bare).
                 return;
             }
+            // ── Space (bare): command palette at empty prompt ──
+            // Pressing Space when the input buffer is empty opens the
+            // command palette — an alt-screen picker showing every slash
+            // command, arrow-key navigable, type-to-filter, Enter to run.
+            // When the buffer has content (the user is typing a real
+            // message that begins with a space-separated word) the keypress
+            // listener stays out of the way and lets readline handle the
+            // space normally.
+            if (name === 'space' || name === '/') {
+                if (pickerActive)
+                    return;
+                const buf = rl.line ?? '';
+                // Space is only triggered at an empty buffer (mid-typing
+                // space should insert normally). '/' has a more permissive
+                // trigger: it fires at empty buffer OR at exactly "/"
+                // (which is the state right after the user pressed '/'
+                // and the byte landed in the buffer). Either way, only
+                // empty + single-/ states open the picker; longer buffers
+                // pass through.
+                if (name === 'space' && buf.length > 0)
+                    return;
+                if (name === '/' && buf !== '' && buf !== '/')
+                    return;
+                // Mid-stream is suppressed by the input guard already;
+                // this listener still fires but we shouldn't open a picker
+                // on top of a streaming turn.
+                const turnCtl = globalThis.__turnAbortCtl;
+                if (turnCtl && !turnCtl.signal.aborted)
+                    return;
+                const triggerChar = name === '/' ? '/' : ' ';
+                // Open the palette. The picker is async and takes stdin into
+                // raw mode for its lifetime — we fire-and-forget here.
+                pickerActive = true;
+                // The trigger character is already in readline's buffer at
+                // this point (the keypress listener is an observer, not a
+                // gate). Clear it so the prompt is clean once the picker
+                // exits.
+                try {
+                    const rlAny = rl;
+                    rlAny.line = '';
+                    rlAny._refreshLine?.();
+                }
+                catch { /* noop */ }
+                void (async () => {
+                    try {
+                        const { pick } = await import('./picker.js');
+                        const { COMMAND_CATALOG } = await import('./command-palette.js');
+                        const items = COMMAND_CATALOG.map((c) => ({
+                            label: c.command,
+                            hint: c.category,
+                            description: c.description,
+                            value: c.command,
+                        }));
+                        const selected = await pick(items, {
+                            title: 'compact-agent · command palette',
+                            footer: 'type to filter · ↑↓ to navigate · Enter to run · Esc to cancel',
+                            // '/' trigger: pre-fill filter so the user's mental
+                            // model ("I typed / and now I see slash commands") is
+                            // preserved. Space trigger: blank filter, browse all.
+                            initialFilter: name === '/' ? '/' : undefined,
+                        });
+                        if (selected) {
+                            globalThis.__crowcoderQueuedInput = selected + '\n';
+                            try {
+                                rl.emit('line', '');
+                            }
+                            catch { /* noop */ }
+                        }
+                        else if (triggerChar === '/') {
+                            // Cancel from '/'-triggered picker: restore the '/'
+                            // to the buffer so the user can keep typing the
+                            // command manually (e.g. they wanted /model claude-
+                            // sonnet-4 directly, not the picker). Don't resolve
+                            // rl.question — leave readline waiting for input.
+                            try {
+                                const rlAny = rl;
+                                rlAny.line = '/';
+                                rlAny._refreshLine?.();
+                            }
+                            catch { /* noop */ }
+                        }
+                        else {
+                            // Cancel from space-triggered picker: prompt is clean,
+                            // resolve readline with empty so the loop iterates
+                            // back to a fresh prompt.
+                            try {
+                                rl.emit('line', '');
+                            }
+                            catch { /* noop */ }
+                        }
+                    }
+                    finally {
+                        pickerActive = false;
+                    }
+                })();
+                return;
+            }
             // ── Esc (bare): rewind chord at empty prompt ───────
             // Two bare Esc presses within 500ms at an empty input buffer
             // triggers /back (rewind one user turn). Matches the muscle
@@ -3349,6 +3522,42 @@ async function main() {
                     console.log(theme.dim('  [dictate] ') + chalk.white(transcript));
                     messages.push({ role: 'user', content: transcript });
                 }
+                else if (result.injectPrompt === '__PICK_MODEL__') {
+                    // OpenRouter model picker — same sentinel-into-the-REPL
+                    // pattern as /dictate + /swarm because handleSlashCommand
+                    // is sync but fetching the catalog + showing the picker
+                    // is async. Selection sets config.model + saves; no
+                    // injectPrompt cascades into runQuery.
+                    const { pick } = await import('./picker.js');
+                    const { fetchOpenRouterModels, formatPricing } = await import('./openrouter-models.js');
+                    console.log(chalk.dim('  Fetching OpenRouter catalog…'));
+                    const models = await fetchOpenRouterModels();
+                    if (models.length === 0) {
+                        console.log(chalk.yellow('  Could not fetch model catalog (network error or rate limit).'));
+                        console.log(chalk.dim('  Use /model <id> with a known model name, or check your connection.'));
+                        continue;
+                    }
+                    const items = models.map((m) => ({
+                        label: m.id,
+                        hint: formatPricing(m),
+                        description: m.name !== m.id ? m.name : undefined,
+                        value: m.id,
+                    }));
+                    const selected = await pick(items, {
+                        title: `compact-agent · OpenRouter models  (current: ${config.model})`,
+                        footer: 'type to filter · ↑↓ to navigate · Enter to pick · Esc to cancel · free models float to the top',
+                    });
+                    if (selected) {
+                        config.model = selected;
+                        saveConfig(config);
+                        resetClient();
+                        console.log(chalk.green(`  Model: ${config.model}`));
+                    }
+                    else {
+                        console.log(chalk.dim('  Cancelled — model unchanged.'));
+                    }
+                    continue;
+                }
                 else if (result.injectPrompt.startsWith('__SWARM__')) {
                     // Swarm dispatch: __SWARM__<agentsCsv>|||<task>. Same sentinel
                     // trick as /dictate so the slash handler stays sync; the async