fixo-cli 1.0.2 → 1.0.4

package/dist/runtime/session-snapshots.js

@@ -51,7 +51,7 @@ export function snapshotPath(cwd, id) {
     return path.join(dirForCwd(cwd), `${id}.json`);
 }
 export function saveSnapshot(input, now = new Date()) {
-    const id = makeSnapshotId(now);
+    const id = input.id ?? makeSnapshotId(now);
     const file = snapshotPath(input.cwd, id);
     const dir = path.dirname(file);
     try {
@@ -73,6 +73,7 @@ export function saveSnapshot(input, now = new Date()) {
         mode: input.mode,
         selectedFiles: input.selectedFiles,
         summary: input.summary,
+        label: input.label,
         fixedInstructions: input.fixedInstructions,
         todo,
     };
@@ -154,6 +155,7 @@ export function listSnapshots(cwd) {
                 tokens: typeof obj.tokens === 'number' ? obj.tokens : 0,
                 items,
                 summary: typeof obj.summary === 'string' ? obj.summary : undefined,
+                label: typeof obj.label === 'string' ? obj.label : undefined,
             });
         }
         catch {
@@ -163,4 +165,77 @@ export function listSnapshots(cwd) {
     out.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
     return out;
 }
+/* ──────────────────────── rename ──────────────────────── */
+/**
+ * Maximum label length. Long enough for "clinic-website-accessibility-audit"
+ * but short enough to fit in a session header pill on a 100-col terminal.
+ */
+export const MAX_LABEL_LENGTH = 64;
+/**
+ * Returns true if the label is safe to store, render, and search.
+ *
+ * Rules:
+ *   - 1..MAX_LABEL_LENGTH characters
+ *   - letters, digits, dash, underscore, dot, and spaces only
+ *   - no path separators (`/`, `\`) so a label can never affect
+ *     where the snapshot file lives on disk
+ *   - no shell metacharacters (backtick, `$`, `;`, `|`, `&`, `<`, `>`)
+ *     so a future render path that interpolates the label cannot be
+ *     hijacked
+ *
+ * The validator is conservative on purpose — labels are user-facing,
+ * not creative writing. The file id stays as the durable identifier.
+ */
+export function isValidSessionLabel(label) {
+    if (typeof label !== 'string')
+        return false;
+    const trimmed = label.trim();
+    if (trimmed.length === 0 || trimmed.length > MAX_LABEL_LENGTH)
+        return false;
+    // Allow Unicode letters/digits + space + dash + underscore + dot.
+    return /^[\p{L}\p{N}._\- ]+$/u.test(trimmed);
+}
+/**
+ * Atomically rewrite the `label` field of an existing snapshot.
+ * The on-disk file basename (the snapshot id) is **never** renamed —
+ * existing `/resume <id>` invocations keep working after a relabel.
+ *
+ * Pass `label: undefined` to clear an existing label.
+ */
+export function renameSnapshot(cwd, id, label) {
+    if (label !== undefined && !isValidSessionLabel(label)) {
+        return {
+            ok: false,
+            id,
+            error: `invalid label: must be 1..${MAX_LABEL_LENGTH} chars, letters/digits/space/dash/underscore/dot only`,
+        };
+    }
+    const loaded = loadSnapshot(cwd, id);
+    if (!loaded.ok || !loaded.snapshot) {
+        return { ok: false, id, error: loaded.error ?? 'snapshot not found' };
+    }
+    const updated = {
+        ...loaded.snapshot,
+        label: label?.trim() || undefined,
+    };
+    const file = snapshotPath(cwd, id);
+    const tmp = `${file}.tmp`;
+    try {
+        fs.writeFileSync(tmp, JSON.stringify(updated, null, 2), {
+            encoding: 'utf-8',
+            mode: 0o600,
+        });
+        fs.renameSync(tmp, file);
+    }
+    catch (err) {
+        try {
+            fs.unlinkSync(tmp);
+        }
+        catch {
+            /* ignore tmp cleanup failure */
+        }
+        return { ok: false, id, error: err.message };
+    }
+    return { ok: true, id, label: updated.label };
+}
 //# sourceMappingURL=session-snapshots.js.map

package/dist/runtime/session-snapshots.js.map

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

package/dist/setup-wizard.d.ts

@@ -3,6 +3,7 @@ import type { FreeLLMConfig } from './config.js';
  * Runs the interactive first-run setup wizard for FixO CLI.
  * Links the CLI terminal to the FreeLLMAPI SaaS cloud by prompting
  * for the master API key, destination URL, and saving it to the configuration.
+ * Also offers to configure individual provider API keys for direct access.
  */
 export declare function runSetupWizard(): Promise<FreeLLMConfig>;
 //# sourceMappingURL=setup-wizard.d.ts.map

package/dist/setup-wizard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup-wizard.d.ts","sourceRoot":"","sources":["../src/setup-wizard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,CA0E7D"}
+{"version":3,"file":"setup-wizard.d.ts","sourceRoot":"","sources":["../src/setup-wizard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,CAuH7D"}

package/dist/setup-wizard.js

@@ -4,6 +4,7 @@ import { getDefaultConfig, saveConfig, DEFAULT_API_URL } from './config.js';
  * Runs the interactive first-run setup wizard for FixO CLI.
  * Links the CLI terminal to the FreeLLMAPI SaaS cloud by prompting
  * for the master API key, destination URL, and saving it to the configuration.
+ * Also offers to configure individual provider API keys for direct access.
  */
 export async function runSetupWizard() {
     p.intro('🚀 Welcome to FixO CLI Setup');
@@ -67,7 +68,47 @@ export async function runSetupWizard() {
     config.apiUrl = apiUrl;
     config._firstRunComplete = true;
     saveConfig(config);
-    p.outro('✓ Configuration saved to ~/.fixocli/config.json');
+    p.outro('✓ FreeLLMAPI configuration saved to ~/.fixocli/config.json');
+    // ──── Optional: Configure individual provider API keys ────
+    const configureProviders = await p.confirm({
+        message: 'Would you like to add API keys for individual AI providers? (You can also do this later via /providers add)',
+        initialValue: false,
+    });
+    if (configureProviders) {
+        // Dynamic import to avoid any module-load-time side effects
+        const { ProvidersManager, PROVIDER_REGISTRY } = await import('./agent/providers-manager.js');
+        const selectedProviders = await p.multiselect({
+            message: 'Select providers to configure (you can add more later via /providers add):',
+            options: PROVIDER_REGISTRY.map(def => ({
+                value: def.name,
+                label: def.displayName,
+                hint: def.docsUrl,
+            })),
+            required: false,
+        });
+        if (!p.isCancel(selectedProviders) && selectedProviders.length > 0) {
+            let configuredCount = 0;
+            for (const name of selectedProviders) {
+                const def = PROVIDER_REGISTRY.find(d => d.name === name);
+                const apiKey = await p.password({
+                    message: `Enter API key for ${def.displayName}:`,
+                    validate: (val) => {
+                        if (!val.trim())
+                            return 'API key is required';
+                        return;
+                    },
+                });
+                if (!p.isCancel(apiKey) && apiKey) {
+                    ProvidersManager.add(name, apiKey);
+                    configuredCount++;
+                    console.log(`  ✓ ${def.displayName} key saved`);
+                }
+            }
+            if (configuredCount > 0) {
+                p.outro(`✓ ${configuredCount} provider key(s) saved to ~/.fixocli/providers.json`);
+            }
+        }
+    }
     return config;
 }
 //# sourceMappingURL=setup-wizard.js.map

package/dist/setup-wizard.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup-wizard.js","sourceRoot":"","sources":["../src/setup-wizard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE5E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC;;;;;;;;qEAQuD,CAAC,CAAC;IAErE,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;QAClC,OAAO,EAAE,yCAAyC;QAClD,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,6BAA6B,EAAE;YAChE,EAAE,KAAK,EAAE,0BAA0B,EAAE,KAAK,EAAE,qDAAqD,EAAE;YACnG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,qBAAqB,EAAE;SAClD;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,GAAG,YAAsB,CAAC;IACpC,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;YAC7B,OAAO,EAAE,4CAA4C;YACrD,WAAW,EAAE,kCAAkC;YAC/C,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;gBAChB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;oBAAE,OAAO,iBAAiB,CAAC;gBAC1C,OAAO;YACT,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;QAC/B,OAAO,EAAE,gCAAgC;QACzC,WAAW,EAAE,wBAAwB;QACrC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;YAChB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBAChB,OAAO,qBAAqB,CAAC;YAC/B,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC1C,OAAO,uCAAuC,CAAC;YACjD,CAAC;YACD,OAAO;QACT,CAAC;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,CAAC,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,CAAC,kBAAkB,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAC/C,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAEhC,UAAU,CAAC,MAAM,CAAC,CAAC;IAEnB,CAAC,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAE3D,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"setup-wizard.js","sourceRoot":"","sources":["../src/setup-wizard.ts"],"names":[],"mappings":"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"}

package/dist/ui/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/ui/prompt.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,aAAa,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA2DlD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA4+DrE"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/ui/prompt.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,aAAa,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA2DlD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAkrErE"}

package/dist/ui/prompt.js

@@ -45,6 +45,7 @@ export async function startREPL(options) {
     await mcpBridgeManager.initialize(cwd);
     const { randomUUID } = await import('node:crypto');
     let currentSessionId = randomUUID();
+    let currentSessionLabel;
     let sessionModifiedFiles = [];
     let currentMode = 'BUILD';
     let currentModel = projectConfig?.model ?? config.defaultModel ?? 'auto';
@@ -76,6 +77,8 @@ export async function startREPL(options) {
             conversation.setContextLimit(currentModel);
             currentMode = snap.mode;
             selectedFiles = [...snap.selectedFiles];
+            currentSessionId = snap.id;
+            currentSessionLabel = snap.label;
             console.log(`\n${c.green}✓ Resumed session${c.reset} ${c.dim}${snap.id}${c.reset}`);
             console.log(`  ${c.dim}messages=${snap.conversation.length} tokens=${snap.tokens} model=${snap.model} mode=${snap.mode}${c.reset}`);
             if (snap.summary) {
@@ -88,6 +91,8 @@ export async function startREPL(options) {
         }
     }
     let isPrompting = false;
+    let isTaskRunning = false;
+    let currentRunningAgent = null;
     let activeSuggestionsCount = 0;
     let currentMatches = [];
     let highlightedIndex = 0;
@@ -181,7 +186,10 @@ export async function startREPL(options) {
             mode: modeForState,
             routing: 'auto',
             model: currentModel,
-            branch: currentBranch || 'detached',
+            // Show '(detached HEAD)' instead of bare 'detached' so the
+            // status bar is unambiguous — the previous label read as "the
+            // CLI is detached from the API server" to several users.
+            branch: currentBranch || '(detached HEAD)',
             contextPercent,
             providersCount,
             transport: 'freellmapi',
@@ -273,12 +281,48 @@ export async function startREPL(options) {
         }
     };
     process.on('exit', exitCleanup);
-    // ──── Graceful exit handlers ────
+    // ──── Double-Ctrl+C (and task-abort) handler ────
+    const SIGINT_RESET_MS = 2000;
+    let sigintCount = 0;
+    let lastSigintTime = 0;
+    let sigintResetTimer = null;
     const sigintHandler = () => {
+        if (isTaskRunning && currentRunningAgent) {
+            // A task is running — cancel it instead of exiting
+            currentRunningAgent.abort();
+            return;
+        }
+        const now = Date.now();
+        if (now - lastSigintTime > SIGINT_RESET_MS) {
+            // First press (or after reset window)
+            sigintCount = 1;
+            lastSigintTime = now;
+            // Write hint and redraw the prompt
+            const promptStr = `${C.LAVA}›${C.RESET} `;
+            process.stdout.write(`\n${c.yellow}⚠ Press Ctrl+C again to exit${c.reset}\n`);
+            drawLavaStatusBar();
+            process.stdout.write(promptStr);
+            // Auto-reset after the window expires
+            if (sigintResetTimer)
+                clearTimeout(sigintResetTimer);
+            sigintResetTimer = setTimeout(() => {
+                sigintCount = 0;
+                sigintResetTimer = null;
+            }, SIGINT_RESET_MS);
+            return;
+        }
+        // Second press within the window — exit
+        if (sigintResetTimer)
+            clearTimeout(sigintResetTimer);
+        sigintResetTimer = null;
+        sigintCount = 0;
         exitCleanup();
         console.log('\n\n👋 FixO CLI session ended safely. Core engine offline.');
         process.exit(0);
     };
+    // Listen on both the readline interface (catches Ctrl+C during rl.question())
+    // and the process (fallback for non-readline scenarios).
+    rl.on('SIGINT', sigintHandler);
     process.on('SIGINT', sigintHandler);
     const sigtermHandler = () => {
         exitCleanup();
@@ -458,7 +502,15 @@ export async function startREPL(options) {
     const keypressHandler = (_char, key) => {
         if (!isPrompting)
             return;
-        if (key && (key.name === 'up' || key.name === 'down' || key.name === 'escape' || key.name === 'tab' || key.name === 'enter' || key.name === 'return')) {
+        // Intercept Escape to cancel a running task even when readline is in a question state
+        if (key && key.name === 'escape') {
+            if (isTaskRunning && currentRunningAgent) {
+                currentRunningAgent.abort();
+                return;
+            }
+            return;
+        }
+        if (key && (key.name === 'up' || key.name === 'down' || key.name === 'tab' || key.name === 'enter' || key.name === 'return')) {
             return;
         }
         process.nextTick(() => {
@@ -582,6 +634,15 @@ export async function startREPL(options) {
         }
         if (event === 'keypress') {
             const [char, key] = args;
+            // Intercept Escape or Ctrl+C to cancel a running task (when not prompting)
+            if (key && key.name === 'escape' && isTaskRunning && currentRunningAgent) {
+                currentRunningAgent.abort();
+                return true;
+            }
+            if (key && key.name === 'c' && key.ctrl && isTaskRunning && currentRunningAgent) {
+                currentRunningAgent.abort();
+                return true;
+            }
             // Tab on empty line → cycle mode (BEFORE suggestion handling, so it always works)
             if (isPrompting && key && key.name === 'tab' && rl.line.trim() === '') {
                 const modes = ['BUILD', 'EXPLORE', 'SCOUT', 'PLAN'];
@@ -671,13 +732,20 @@ export async function startREPL(options) {
                 case '/model': {
                     if (args[0] === 'list') {
                         // Print full model table grouped by provider
+                        // Uses live-fetched cached models when available, otherwise falls
+                        // back to the static registry list (tagged [unverified]).
                         console.log(`\n${c.bold}${c.cyan}Available Models by Provider${c.reset}`);
                         console.log(`${c.dim}${'─'.repeat(60)}${c.reset}`);
                         for (const def of PROVIDER_REGISTRY) {
                             const hasKey = ProvidersManager.has(def.name);
                             const keyStatus = hasKey ? `${c.green}[key ✓]${c.reset}` : `${c.dim}[no key]${c.reset}`;
-                            console.log(`\n  ${c.snow}${c.bold}${def.displayName}${c.reset} ${keyStatus}`);
-                            for (const model of def.models) {
+                            const cached = ProvidersManager.getCachedModels(def.name);
+                            const modelList = cached?.models?.length ? cached.models : def.models;
+                            const sourceTag = cached?.source === 'live'
+                                ? ''
+                                : ` ${c.dim}[unverified]${c.reset}`;
+                            console.log(`\n  ${c.snow}${c.bold}${def.displayName}${c.reset} ${keyStatus}${sourceTag}`);
+                            for (const model of modelList) {
                                 console.log(`    ${c.cyan}•${c.reset} ${model}`);
                             }
                         }
@@ -742,6 +810,11 @@ export async function startREPL(options) {
                                 return;
                             }
                             currentModel = picked;
+                            // Store hint — find which provider this model belongs to
+                            const owningDef = PROVIDER_REGISTRY.find(d => d.models.includes(currentModel)
+                                || ProvidersManager.getCachedModels(d.name)?.models?.includes(currentModel));
+                            if (owningDef)
+                                ProvidersManager.setModelProviderHint(currentModel, owningDef.name);
                             conversation.setContextLimit(currentModel);
                             console.log(`\n${c.green}✓ Model set to: ${c.bold}${currentModel}${c.reset}`);
                             return;
@@ -777,6 +850,11 @@ export async function startREPL(options) {
                             return;
                         }
                         currentModel = picked;
+                        // Store explicit model-provider association so
+                        // resolveDirectConfig can route this model directly
+                        // to this provider (critical for live-fetched models
+                        // that don't appear in the static registry).
+                        ProvidersManager.setModelProviderHint(currentModel, def.name);
                         conversation.setContextLimit(currentModel);
                         console.log(`\n${c.green}✓ Model set to: ${c.bold}${currentModel}${c.reset}`);
                         return;
@@ -1192,6 +1270,8 @@ export async function startREPL(options) {
                             yes: true,
                         };
                         try {
+                            isTaskRunning = true;
+                            currentRunningAgent = agent;
                             const result = await agent.runStreaming(context, conversation, rl);
                             for (const file of result.modifiedFiles) {
                                 if (!modifiedFiles.includes(file)) {
@@ -1202,6 +1282,11 @@ export async function startREPL(options) {
                         catch (err) {
                             console.log(`\n${c.red}✗ Repair agent failed on attempt ${attempt}: ${err.message || err}${c.reset}`);
                         }
+                        finally {
+                            isTaskRunning = false;
+                            currentRunningAgent = null;
+                            agent.reset();
+                        }
                         testResult = runProjectTests(cwd);
                         if (testResult.includes('Status: 0')) {
                             console.log(`\n${c.green}✓ All tests passed after repair attempt ${attempt}!${c.reset}`);
@@ -1307,9 +1392,59 @@ export async function startREPL(options) {
                     }
                     return;
                 }
+                case '/rename': {
+                    // Renames the *active* session. Accepts the rest of the
+                    // input as a free-form label (so spaces don't need quoting).
+                    const rawLabel = args.join(' ').trim();
+                    const { isValidSessionLabel, MAX_LABEL_LENGTH } = await import('../runtime/session-snapshots.js');
+                    const { SessionManager } = await import('../agent/conversation.js');
+                    if (!rawLabel) {
+                        console.log(`\n${c.yellow}Usage: /rename <label>${c.reset}\n` +
+                            `${c.dim}  Labels are 1..${MAX_LABEL_LENGTH} chars: letters, digits, space, dash, underscore, dot.${c.reset}`);
+                        return;
+                    }
+                    if (!isValidSessionLabel(rawLabel)) {
+                        console.log(`\n${c.red}✗ Invalid label.${c.reset} ${c.dim}Allowed: letters, digits, space, dash, underscore, dot — max ${MAX_LABEL_LENGTH} chars.${c.reset}`);
+                        return;
+                    }
+                    // Persist if the session has already been saved at least
+                    // once; otherwise just remember the label in memory until
+                    // the next save fires.
+                    try {
+                        SessionManager.renameSession(currentSessionId, rawLabel);
+                    }
+                    catch {
+                        /* tolerate first-rename-before-save */
+                    }
+                    currentSessionLabel = rawLabel;
+                    console.log(`\n${c.green}✓ Session renamed:${c.reset} ${c.cyan}${rawLabel}${c.reset} ${c.dim}(id: ${currentSessionId})${c.reset}`);
+                    return;
+                }
                 case '/session': {
                     const sub = args[0];
                     const { SessionManager } = await import('../agent/conversation.js');
+                    if (sub === 'rename') {
+                        const id = args[1];
+                        const rawLabel = args.slice(2).join(' ').trim();
+                        const { isValidSessionLabel, MAX_LABEL_LENGTH } = await import('../runtime/session-snapshots.js');
+                        if (!id || !rawLabel) {
+                            console.log(`\n${c.yellow}Usage: /session rename <id> <label>${c.reset}`);
+                            return;
+                        }
+                        if (!isValidSessionLabel(rawLabel)) {
+                            console.log(`\n${c.red}✗ Invalid label.${c.reset} ${c.dim}Max ${MAX_LABEL_LENGTH} chars; letters, digits, space, dash, underscore, dot only.${c.reset}`);
+                            return;
+                        }
+                        const ok = SessionManager.renameSession(id, rawLabel);
+                        if (!ok) {
+                            console.log(`\n${c.red}✗ Session not found: ${id}${c.reset}`);
+                            return;
+                        }
+                        if (id === currentSessionId)
+                            currentSessionLabel = rawLabel;
+                        console.log(`\n${c.green}✓ Renamed${c.reset} ${c.dim}${id}${c.reset} → ${c.cyan}${rawLabel}${c.reset}`);
+                        return;
+                    }
                     if (sub === 'list') {
                         const list = SessionManager.listSessions();
                         if (list.length === 0) {
@@ -1319,7 +1454,10 @@ export async function startREPL(options) {
                             console.log(`\n${c.cyan}${c.bold}Saved Sessions:${c.reset}`);
                             for (const s of list) {
                                 const date = new Date(s.timestamp).toLocaleString();
-                                console.log(`  ${c.cyan}${s.sessionId}${c.reset} - ${c.bold}${s.model}${c.reset} (${s.messageCount} msgs)`);
+                                const labelDisplay = s.label
+                                    ? `${c.cyan}${s.label}${c.reset} ${c.dim}(${s.sessionId.slice(0, 8)})${c.reset}`
+                                    : `${c.cyan}${s.sessionId}${c.reset}`;
+                                console.log(`  ${labelDisplay} - ${c.bold}${s.model}${c.reset} (${s.messageCount} msgs)`);
                                 console.log(`    ${c.dim}Created: ${date} | Tokens: ${s.totalTokens.toLocaleString()}${c.reset}`);
                                 if (s.summary) {
                                     console.log(`    ${c.dim}Summary: ${s.summary.slice(0, 80)}...${c.reset}`);
@@ -1342,6 +1480,7 @@ export async function startREPL(options) {
                             conversation.setContextLimit(currentModel);
                             sessionModifiedFiles = data.modifiedFiles || [];
                             currentSessionId = data.sessionId;
+                            currentSessionLabel = data.label;
                             stats.totalPromptTokens = data.tokenUsage?.prompt_tokens || 0;
                             stats.totalCompletionTokens = data.tokenUsage?.completion_tokens || 0;
                             console.log(`\n${c.green}✓ Session restored successfully: ${c.bold}${uuid}${c.reset}`);
@@ -1361,15 +1500,34 @@ export async function startREPL(options) {
                         stats.totalDurationMs = 0;
                         const { randomUUID } = await import('node:crypto');
                         currentSessionId = randomUUID();
+                        currentSessionLabel = undefined;
                         SessionManager.saveSession(conversation, currentModel, sessionModifiedFiles, {
                             prompt_tokens: stats.totalPromptTokens,
                             completion_tokens: stats.totalCompletionTokens,
                             total_tokens: stats.totalPromptTokens + stats.totalCompletionTokens,
-                        }, currentSessionId);
+                        }, currentSessionId, currentSessionLabel);
+                        try {
+                            const { saveSnapshot } = await import('../runtime/session-snapshots.js');
+                            saveSnapshot({
+                                cwd,
+                                conversation: [],
+                                tokens: 0,
+                                model: currentModel,
+                                mode: currentMode,
+                                selectedFiles: [],
+                                summary: '',
+                                label: undefined,
+                                id: currentSessionId,
+                                fixedInstructions: projectConfig?.systemPrompt,
+                            });
+                        }
+                        catch {
+                            // Ignore snapshot save errors on new session
+                        }
                         console.log(`\n${c.green}✓ Active conversation memory purged. New session initialized: ${c.bold}${currentSessionId}${c.reset}`);
                     }
                     else {
-                        console.log(`\n${c.yellow}Usage: /session [list | load <uuid> | new]${c.reset}`);
+                        console.log(`\n${c.yellow}Usage: /session [list | load <uuid> | new | rename <id> <label>]${c.reset}`);
                     }
                     return;
                 }
@@ -1825,7 +1983,16 @@ export async function startREPL(options) {
         }
         else {
             console.log(`\n${c.cyan}[Routing Engine] Simple task detected (${classification.reason}). Routing to SingleAgent...${c.reset}`);
-            result = await agent.runStreaming(context, conversation, rl);
+            isTaskRunning = true;
+            currentRunningAgent = agent;
+            try {
+                result = await agent.runStreaming(context, conversation, rl);
+            }
+            finally {
+                isTaskRunning = false;
+                currentRunningAgent = null;
+                agent.reset();
+            }
         }
         // Print result summary
         console.log('');
@@ -1897,7 +2064,25 @@ export async function startREPL(options) {
                 prompt_tokens: stats.totalPromptTokens,
                 completion_tokens: stats.totalCompletionTokens,
                 total_tokens: stats.totalPromptTokens + stats.totalCompletionTokens,
-            }, currentSessionId);
+            }, currentSessionId, currentSessionLabel);
+            const { saveSnapshot } = await import('../runtime/session-snapshots.js');
+            saveSnapshot({
+                cwd,
+                conversation: conversation.exportHistory().map((m, idx) => ({
+                    role: m.role,
+                    content: m.content || '',
+                    name: m.name,
+                    index: idx,
+                })),
+                tokens: stats.totalPromptTokens + stats.totalCompletionTokens,
+                model: currentModel,
+                mode: currentMode,
+                selectedFiles: [...selectedFiles],
+                summary: conversation.getSummary(),
+                label: currentSessionLabel,
+                id: currentSessionId,
+                fixedInstructions: projectConfig?.systemPrompt,
+            });
         }
         catch (err) {
             // Ignore session save errors