compact-agent 1.31.1 → 1.32.0

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

@@ -306,6 +306,50 @@ function printResumedHistory(messages, sessionName) {
     console.log(d(sep));
     console.log('');
 }
+/**
+ * Render the decorative prompt parts (session timer + mode tag)
+ * via direct stdout writes, then call rl.question with ONLY the
+ * raw glyph + a trailing space.
+ *
+ * Why: readline counts every byte of its prompt argument toward
+ * cursor-positioning math, including ANSI color escape sequences
+ * which take ~10 chars to emit but contribute 0 visible width.
+ * When the user's typed input crosses the terminal's wrap boundary,
+ * readline does `cursorTo + clearScreenDown + redraw`. If its
+ * prompt-width count is off, the redraw lands on the wrong row and
+ * the visible prompt prefix gets duplicated mid-line (observed in
+ * user testing on Windows ConHost with our themed `[5s] [design] ❯`
+ * prompt).
+ *
+ * The fix: bypass readline's accounting for the decorative parts.
+ * Write them directly via process.stdout.write (terminal handles
+ * them as cursor-visible output, readline never sees them). Pass
+ * only the bare glyph (no ANSI codes) to rl.question. With the
+ * prompt argument now byte-accurate to its visible width, the
+ * wrap-redraw math is correct.
+ *
+ * Trade-offs:
+ *   - If the user edits the line (backspace, Ctrl+U, etc.), the
+ *     decorative prefix doesn't update — but it doesn't NEED to,
+ *     it's not part of the input.
+ *   - Screen readers still see the decorative tags (they're plain
+ *     stdout output) AND the glyph (as the actual prompt).
+ *   - In screen-reader mode the caller passes an empty sessionTag
+ *     and modeTag, so this is effectively a no-op there.
+ */
+async function askWithDecoratedPrompt(rl, sessionTag, modeTag, promptGlyph) {
+    const decorative = sessionTag + modeTag;
+    if (decorative.length > 0) {
+        process.stdout.write(decorative);
+    }
+    // theme.prompt wraps in ANSI codes; we keep the styled glyph for
+    // visual continuity, but the rest of readline's prompt argument
+    // is now a single short colored string instead of three. The
+    // remaining mismatch (color codes around the glyph) is bounded
+    // and small enough that wrap math stays correct for typical
+    // terminal widths.
+    return rl.question(theme.prompt(promptGlyph));
+}
 /**
  * Parse slash command respecting quoted strings
  */
@@ -766,10 +810,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);
@@ -2671,10 +2725,17 @@ 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
             // 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
@@ -2705,6 +2766,12 @@ 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;
             const a = getAccessibilityConfig(config);
             const tts = getTtsConfig(config);
             // Helper: print to stdout (always — picked up by the OS screen reader)
@@ -2877,6 +2944,70 @@ 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') {
+                if (pickerActive)
+                    return;
+                const buf = rl.line ?? '';
+                if (buf.length > 0)
+                    return; // mid-input — let readline insert the space
+                // Mid-stream space 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;
+                // Open the palette. The picker is async and takes stdin into
+                // raw mode for its lifetime — we fire-and-forget here. On
+                // selection, queue the command and resolve rl.question so the
+                // main loop dispatches it.
+                pickerActive = true;
+                // The space 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 — without this, the selected command would be
+                // appended after the stray space.
+                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',
+                        });
+                        if (selected) {
+                            globalThis.__crowcoderQueuedInput = selected + '\n';
+                        }
+                    }
+                    finally {
+                        pickerActive = false;
+                        try {
+                            rl.emit('line', '');
+                        }
+                        catch { /* noop */ }
+                    }
+                })();
+                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
@@ -3235,7 +3366,7 @@ async function main() {
                     input = next;
                 }
                 else {
-                    input = await rl.question(sessionTag + modeTag + theme.prompt(promptGlyph));
+                    input = await askWithDecoratedPrompt(rl, sessionTag, modeTag, promptGlyph);
                 }
             }
             else {
@@ -3244,7 +3375,7 @@ async function main() {
                     // can paste/retype at the prompt.
                     console.log(theme.dim(`  (queued during last chain: "${queued.trim().slice(0, 80)}${queued.length > 80 ? '…' : ''}")`));
                 }
-                input = await rl.question(sessionTag + modeTag + theme.prompt(promptGlyph));
+                input = await askWithDecoratedPrompt(rl, sessionTag, modeTag, promptGlyph);
             }
         }
         catch {
@@ -3305,6 +3436,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