klyro 0.1.42 → 0.1.44

package/dist/cli/repl.js

@@ -50,9 +50,15 @@ export async function startRepl(opts = {}) {
     if (providerKind === 'anthropic' && !apiKey) {
         process.stderr.write('klyro: anthropic provider detected but KLYRO_API_KEY is empty — falling back to OpenAI-compatible adapter\n');
     }
-    const adapter = effectiveProvider === 'anthropic'
-        ? anthropicAdapter({ baseURL: baseUrl, apiKey, timeoutMs: 60_000 })
-        : httpChatAdapter({ baseURL: baseUrl, apiKey, timeoutMs: 60_000 });
+    let currentProvider = effectiveProvider;
+    let currentBaseUrl = baseUrl;
+    let currentApiKey = apiKey;
+    let currentMaxSteps = opts.maxSteps ?? 30;
+    let effortLevel = 'medium';
+    const buildAdapter = (prov, url, key) => prov === 'anthropic'
+        ? anthropicAdapter({ baseURL: url, apiKey: key, timeoutMs: 60_000 })
+        : httpChatAdapter({ baseURL: url, apiKey: key, timeoutMs: 60_000 });
+    let adapter = buildAdapter(currentProvider, currentBaseUrl, currentApiKey);
     const ctxBlock = await buildLevel6Context({ cwd });
     const ctxPrefix = ctxBlock.formatted ? `\n\n<context>\n${ctxBlock.formatted}\n</context>` : '';
     // 4.4 KLYRO.md hierarchy
@@ -64,7 +70,7 @@ export async function startRepl(opts = {}) {
         const t = _ctx.telemetry ? '\n\n' + _ctx.telemetry : '';
         return base + t;
     };
-    const ac = new AbortController();
+    let ac = new AbortController();
     // When the TUI is mounted, use the inline Ink prompt. Otherwise
     // fall back to stdin readline. The bridge is shared between the
     // App and the runtime so the modal can resolve the runtime's ask().
@@ -133,9 +139,24 @@ export async function startRepl(opts = {}) {
     let tuiSessionId;
     if (isAltScreen)
         enterAlt();
+    const EFFORT_STEPS = { low: 10, medium: 30, high: 50, max: 100 };
+    // P1 session/permission state (commands.md Priority 1)
+    let sessionLabel = '';
+    let currentBranch = '';
+    let fastMode = false;
+    let displayMode = 'default';
+    let lastAssistantText = '';
+    function queuedClear() {
+        if (isMounted && directHooks)
+            directHooks.clearTranscript();
+        else
+            pendingQueue.length = 0;
+        if (isMounted && directHooks)
+            directHooks.clearTranscript();
+    }
     app = render(React.createElement(App, {
         initialModel: model,
-        maxSteps: opts.maxSteps ?? 30,
+        maxSteps: currentMaxSteps,
         cwd,
         initialStatus: { status: 'idle' },
         approvalBridge: tuiBridge,
@@ -190,7 +211,7 @@ export async function startRepl(opts = {}) {
         let sessionId;
         if (!isSimpleChat) {
             try {
-                const rec = await tuiStore.create({ cwd, task: taskText, config: { model, maxSteps: opts.maxSteps ?? 30 } });
+                const rec = await tuiStore.create({ cwd, task: taskText, config: { model, maxSteps: currentMaxSteps } });
                 sessionId = rec.id;
                 tuiSessionId = rec.id;
                 // Session info goes to status bar, not transcript (clean like Claude Code)
@@ -220,6 +241,7 @@ export async function startRepl(opts = {}) {
                     else if (ev.kind === 'error')
                         throw new Error(ev.message);
                 }
+                lastAssistantText = simpleText;
                 queuedStatus({ status: 'done' });
                 return;
             }
@@ -238,7 +260,7 @@ export async function startRepl(opts = {}) {
                 task: taskText,
                 cwd,
                 model,
-                maxSteps: opts.maxSteps ?? 30,
+                maxSteps: currentMaxSteps,
                 signal: ac.signal,
                 nonInteractive: opts.nonInteractive ?? false,
                 verify: { enabled: true, maxRepairAttempts: 3 },
@@ -337,6 +359,8 @@ export async function startRepl(opts = {}) {
                     }
                 },
             }, { adapter, registry, policy, approval, systemPrompt: systemPromptFn });
+            if (result.finalText)
+                lastAssistantText = result.finalText;
             if (result.verification) {
                 const v = result.verification;
                 queuedAppend({
@@ -387,21 +411,19 @@ export async function startRepl(opts = {}) {
                 // Listener cleanup is handled by the waitUntilExit resolver below
                 return;
             case 'clear':
+                queuedClear();
                 queuedAppend({ id: `sep-${Date.now()}`, kind: 'text', text: '--- cleared ---', role: 'assistant' });
                 return;
             case 'help': {
                 const helpText = [
-                    'commands:',
-                    '  /clear          — clear transcript marker',
-                    '  /diff           — show git diff',
-                    '  /status         — show session status',
-                    '  /compact        — (stub) context compaction',
-                    '  /model <id>     — switch model mid-session',
-                    '  /config         — show config path',
-                    '  /doctor         — run diagnostics',
-                    '  /version        — show version',
-                    '  /quit (/exit)   — exit',
-                    `provider: ${effectiveProvider}  model: ${model}  cwd: ${cwd}`,
+                    'commands (Priority 1):',
+                    '  session: /new /clear /compact [focus] /resume [id] /sessions /rename [n] /fork [p] /branch [n] /export [f] /copy [n] /quit',
+                    '  model:   /model [id] /models /provider [name] /effort [low|medium|high|max] /fast [on|off]',
+                    '  project: /init /status /context /diff /plan [task] /todos /memory',
+                    '  perms:   /permissions /mode [m] /sandbox [dir] /approve /deny',
+                    '  app:     /login /logout /auth /version /update /cancel /shell (!cmd) /mention (@path) /tools /config /doctor',
+                    '  (!cmd runs shell, @path attaches a file)',
+                    `provider: ${currentProvider}  model: ${model}  effort: ${effortLevel}${fastMode ? ' fast' : ''} (${currentMaxSteps} steps)  mode: ${displayMode}  cwd: ${cwd}${sessionLabel ? `  session: ${sessionLabel}` : ''}${currentBranch ? `  branch: ${currentBranch}` : ''}`,
                 ].join('\n');
                 queuedAppend({ id: `help-${Date.now()}`, kind: 'text', text: helpText, role: 'assistant' });
                 return;
@@ -476,7 +498,7 @@ export async function startRepl(opts = {}) {
                     });
                 }
                 else {
-                    queuedAppend({ id: `stat2-${Date.now()}`, kind: 'text', text: `model: ${model}  provider: ${effectiveProvider}  cwd: ${cwd}`, role: 'assistant' });
+                    queuedAppend({ id: `stat2-${Date.now()}`, kind: 'text', text: `model: ${model}  provider: ${currentProvider}  effort: ${effortLevel} (${currentMaxSteps} steps)  cwd: ${cwd}`, role: 'assistant' });
                 }
                 return;
             }
@@ -577,14 +599,23 @@ export async function startRepl(opts = {}) {
                 return;
             }
             case 'compact': {
-                queuedAppend({ id: `compact-${Date.now()}`, kind: 'text', text: 'Compacting context…', role: 'assistant' });
-                queuedStatus({ status: 'running' });
+                const focus = cmd.focus?.trim();
+                queuedClear();
+                queuedAppend({
+                    id: `compact-${Date.now()}`,
+                    kind: 'text',
+                    text: focus ? `Context compacted — transcript cleared (focus: ${focus}). Continuing fresh.` : 'Context compacted — transcript cleared. Continuing fresh.',
+                    role: 'assistant',
+                });
+                queuedStatus({ status: 'done' });
                 return;
             }
             case 'model': {
                 const next = cmd.model?.trim();
                 if (!next) {
-                    queuedAppend({ id: `mdl-${Date.now()}`, kind: 'text', text: `current model: ${model}`, role: 'assistant' });
+                    const { MODEL_REGISTRY } = await import('../providers/model-info.js');
+                    const known = Object.keys(MODEL_REGISTRY).join(', ');
+                    queuedAppend({ id: `mdl-${Date.now()}`, kind: 'text', text: `current model: ${model}\nknown: ${known}\nusage: /model <id>`, role: 'assistant' });
                 }
                 else {
                     queuedStatus({ model: next });
@@ -593,6 +624,404 @@ export async function startRepl(opts = {}) {
                 }
                 return;
             }
+            case 'provider': {
+                const next = cmd.provider?.trim().toLowerCase();
+                if (!next) {
+                    queuedAppend({ id: `prov-${Date.now()}`, kind: 'text', text: `current provider: ${currentProvider}\nbaseURL: ${currentBaseUrl}\nusage: /provider <openai|anthropic>`, role: 'assistant' });
+                }
+                else if (next !== 'openai' && next !== 'anthropic') {
+                    queuedAppend({ id: `prov-err-${Date.now()}`, kind: 'error', message: `unknown provider: ${next} (expected openai|anthropic)` });
+                }
+                else {
+                    if (next === 'anthropic' && !currentApiKey) {
+                        queuedAppend({ id: `prov-warn-${Date.now()}`, kind: 'text', text: 'warning: no API key set — anthropic adapter may 401. Set KLYRO_API_KEY or use /login.', role: 'assistant' });
+                    }
+                    currentProvider = next;
+                    adapter = buildAdapter(currentProvider, currentBaseUrl, currentApiKey);
+                    queuedAppend({ id: `prov2-${Date.now()}`, kind: 'text', text: `provider switched to ${next} (takes effect on next prompt)`, role: 'assistant' });
+                }
+                return;
+            }
+            case 'effort': {
+                const level = cmd.level?.trim().toLowerCase();
+                if (!level) {
+                    queuedAppend({ id: `eff-${Date.now()}`, kind: 'text', text: `current effort: ${effortLevel} (${currentMaxSteps} steps)\nlevels: low (10) | medium (30) | high (50) | max (100)\nusage: /effort <level>`, role: 'assistant' });
+                }
+                else if (!EFFORT_STEPS[level]) {
+                    queuedAppend({ id: `eff-err-${Date.now()}`, kind: 'error', message: `unknown effort: ${level} (expected low|medium|high|max)` });
+                }
+                else {
+                    effortLevel = level;
+                    currentMaxSteps = EFFORT_STEPS[level];
+                    queuedStatus({ maxSteps: currentMaxSteps });
+                    queuedAppend({ id: `eff2-${Date.now()}`, kind: 'text', text: `effort set to ${level} (${currentMaxSteps} max steps)`, role: 'assistant' });
+                }
+                return;
+            }
+            case 'login': {
+                const { runLogin } = await import('./auth.js');
+                const code = await runLogin();
+                queuedAppend({ id: `login-${Date.now()}`, kind: 'text', text: code === 0 ? 'login saved (0600)' : 'login failed', role: 'assistant' });
+                return;
+            }
+            case 'logout': {
+                const { runLogout } = await import('./auth.js');
+                const code = await runLogout();
+                queuedAppend({ id: `logout-${Date.now()}`, kind: 'text', text: code === 0 ? 'logged out' : 'logout failed', role: 'assistant' });
+                return;
+            }
+            case 'init': {
+                const { writeFileSync, existsSync } = await import('node:fs');
+                const { join } = await import('node:path');
+                const target = join(cwd, 'KLYRO.md');
+                if (existsSync(target)) {
+                    queuedAppend({ id: `init-${Date.now()}`, kind: 'text', text: `KLYRO.md already exists at ${target}`, role: 'assistant' });
+                }
+                else {
+                    try {
+                        const { runScan } = await import('./scan.js');
+                        let out = '';
+                        const orig = process.stdout.write.bind(process.stdout);
+                        process.stdout.write = ((c) => { out += String(c); return true; });
+                        await runScan({ cwd, json: false });
+                        process.stdout.write = orig;
+                        writeFileSync(target, `# KLYRO.md\n\nProject: ${cwd}\n\n## Stack\n\n${out.slice(0, 2000)}\n\n## Conventions\n\n- Prefer smallest change that solves the task.\n- Run verification after edits.\n`);
+                        queuedAppend({ id: `init2-${Date.now()}`, kind: 'text', text: `created ${target}`, role: 'assistant' });
+                    }
+                    catch (err) {
+                        queuedAppend({ id: `init-err-${Date.now()}`, kind: 'error', message: `init failed: ${err instanceof Error ? err.message : String(err)}` });
+                    }
+                }
+                return;
+            }
+            case 'plan': {
+                if (cmd.task) {
+                    queuedAppend({ id: `plan-mode-${Date.now()}`, kind: 'text', text: `Plan mode: "${cmd.task}" — the agent will plan first (todo_write) before editing. Current plan below:`, role: 'assistant' });
+                }
+                try {
+                    const { readFileSync, existsSync } = await import('node:fs');
+                    const { join } = await import('node:path');
+                    const todosPath = join(cwd, '.klyro', 'plans', 'todos.json');
+                    if (!existsSync(todosPath)) {
+                        queuedAppend({ id: `plan-${Date.now()}`, kind: 'text', text: 'No active plan (no .klyro/plans/todos.json). The agent creates one via todo_write when planning.', role: 'assistant' });
+                    }
+                    else {
+                        const raw = readFileSync(todosPath, 'utf-8').slice(0, 2000);
+                        queuedAppend({ id: `plan2-${Date.now()}`, kind: 'text', text: `Plan (todos.json):\n${raw}`, role: 'assistant' });
+                    }
+                }
+                catch (err) {
+                    queuedAppend({ id: `plan-err-${Date.now()}`, kind: 'error', message: `plan failed: ${err instanceof Error ? err.message : String(err)}` });
+                }
+                return;
+            }
+            case 'todos': {
+                try {
+                    const { readFileSync, existsSync } = await import('node:fs');
+                    const { join } = await import('node:path');
+                    const todosPath = join(cwd, '.klyro', 'plans', 'todos.json');
+                    if (!existsSync(todosPath)) {
+                        queuedAppend({ id: `todos-${Date.now()}`, kind: 'text', text: 'No todos (no .klyro/plans/todos.json yet).', role: 'assistant' });
+                    }
+                    else {
+                        const arr = JSON.parse(readFileSync(todosPath, 'utf-8'));
+                        const lines = arr.map((t) => `${t.status === 'done' ? '[x]' : t.status === 'in_progress' ? '[>]' : '[ ]'} ${t.title} (${t.id})`);
+                        queuedAppend({ id: `todos2-${Date.now()}`, kind: 'text', text: `Todos (${arr.length}):\n${lines.join('\n').slice(0, 3000)}`, role: 'assistant' });
+                    }
+                }
+                catch (err) {
+                    queuedAppend({ id: `todos-err-${Date.now()}`, kind: 'error', message: `todos failed: ${err instanceof Error ? err.message : String(err)}` });
+                }
+                return;
+            }
+            case 'new': {
+                queuedClear();
+                sessionLabel = '';
+                currentBranch = '';
+                try {
+                    const rec = await tuiStore.create({ cwd, task: 'new session', config: { model, maxSteps: currentMaxSteps } });
+                    tuiSessionId = rec.id;
+                    queuedAppend({ id: `new-${Date.now()}`, kind: 'text', text: `new session ${rec.id.slice(0, 8)} started`, role: 'assistant' });
+                }
+                catch {
+                    queuedAppend({ id: `new2-${Date.now()}`, kind: 'text', text: 'new session started', role: 'assistant' });
+                }
+                queuedStatus({ status: 'idle', step: 0 });
+                return;
+            }
+            case 'models': {
+                const { MODEL_REGISTRY } = await import('../providers/model-info.js');
+                const lines = Object.values(MODEL_REGISTRY).map((m) => `  ${m.id}  ctx ${(m.contextWindow / 1000).toFixed(0)}k  $${m.inputPricePer1k}/$${m.outputPricePer1k} per 1k`);
+                queuedAppend({ id: `models-${Date.now()}`, kind: 'text', text: `Available models (current: ${model}):\n${lines.join('\n')}\nusage: /model <id>`, role: 'assistant' });
+                return;
+            }
+            case 'fast': {
+                const s = cmd.state?.trim().toLowerCase();
+                if (!s) {
+                    queuedAppend({ id: `fast-${Date.now()}`, kind: 'text', text: `fast mode: ${fastMode ? 'on' : 'off'} (${currentMaxSteps} steps)\nusage: /fast on|off`, role: 'assistant' });
+                }
+                else if (s === 'on') {
+                    fastMode = true;
+                    currentMaxSteps = 10;
+                    queuedStatus({ maxSteps: currentMaxSteps });
+                    queuedAppend({ id: `fast2-${Date.now()}`, kind: 'text', text: 'fast mode on (10 max steps)', role: 'assistant' });
+                }
+                else if (s === 'off') {
+                    fastMode = false;
+                    currentMaxSteps = EFFORT_STEPS[effortLevel];
+                    queuedStatus({ maxSteps: currentMaxSteps });
+                    queuedAppend({ id: `fast3-${Date.now()}`, kind: 'text', text: `fast mode off (restored ${effortLevel}: ${currentMaxSteps} steps)`, role: 'assistant' });
+                }
+                else {
+                    queuedAppend({ id: `fast-err-${Date.now()}`, kind: 'error', message: `unknown /fast value: ${s} (expected on|off)` });
+                }
+                return;
+            }
+            case 'permissions': {
+                const cfg = policy.config;
+                const lines = [
+                    `mode: ${displayMode} (engine: ${String(cfg.mode ?? 'default')})`,
+                    `shellAllow: ${(cfg.shellAllow ?? []).length} prefixes`,
+                    `shellDeny: ${(cfg.shellDeny ?? []).length} patterns`,
+                    `allow: ${JSON.stringify(cfg.allow ?? [])}`,
+                    `deny: ${JSON.stringify(cfg.deny ?? [])}`,
+                    `ask: ${JSON.stringify(cfg.ask ?? [])}`,
+                    `sandbox dirs: ${JSON.stringify(cfg.additionalDirs ?? [])}`,
+                ];
+                queuedAppend({ id: `perm-${Date.now()}`, kind: 'text', text: `Permissions:\n${lines.join('\n')}\nchange via /mode <manual|accept-edits|plan|auto|yolo>`, role: 'assistant' });
+                return;
+            }
+            case 'mode': {
+                const m = cmd.mode?.trim().toLowerCase();
+                if (!m) {
+                    queuedAppend({ id: `mode-${Date.now()}`, kind: 'text', text: `current mode: ${displayMode}\nmodes: manual | accept-edits | plan | auto | yolo\nusage: /mode <mode>`, role: 'assistant' });
+                }
+                else {
+                    const map = { manual: 'default', 'accept-edits': 'accept-edits', plan: 'plan', auto: 'auto', yolo: 'auto' };
+                    const engineMode = map[m];
+                    if (!engineMode) {
+                        queuedAppend({ id: `mode-err-${Date.now()}`, kind: 'error', message: `unknown mode: ${m} (expected manual|accept-edits|plan|auto|yolo)` });
+                    }
+                    else {
+                        policy.config.mode = engineMode;
+                        displayMode = m;
+                        queuedAppend({ id: `mode2-${Date.now()}`, kind: 'text', text: `mode set to ${m}${m === 'yolo' ? ' (auto-approve everything — careful)' : ''}${m === 'plan' ? ' (writes blocked)' : ''}`, role: 'assistant' });
+                    }
+                }
+                return;
+            }
+            case 'sandbox': {
+                const cfg = policy.config;
+                const p = cmd.policy?.trim();
+                if (!p) {
+                    queuedAppend({ id: `sb-${Date.now()}`, kind: 'text', text: `sandbox dirs: ${JSON.stringify(cfg.additionalDirs ?? [])}\nusage: /sandbox <dir> (adds an allowed directory)`, role: 'assistant' });
+                }
+                else {
+                    cfg.additionalDirs = [...(cfg.additionalDirs ?? []), p];
+                    queuedAppend({ id: `sb2-${Date.now()}`, kind: 'text', text: `sandbox: added allowed dir ${p}`, role: 'assistant' });
+                }
+                return;
+            }
+            case 'approve': {
+                const ok = tuiBridge.resolve('allow');
+                queuedAppend({ id: `appr-${Date.now()}`, kind: 'text', text: ok ? 'approved pending action' : 'no pending approval', role: 'assistant' });
+                return;
+            }
+            case 'deny': {
+                const ok = tuiBridge.resolve('deny');
+                queuedAppend({ id: `deny-${Date.now()}`, kind: 'text', text: ok ? 'denied pending action' : 'no pending approval', role: 'assistant' });
+                return;
+            }
+            case 'resume': {
+                try {
+                    const { resolveSessionId } = await import('../persistence/session.js');
+                    const all = (await tuiStore.list()).filter((r) => r.cwd === cwd).sort((a, b) => b.updatedAt - a.updatedAt);
+                    const full = cmd.id ? await resolveSessionId(tuiStore, cmd.id) : all[0]?.id;
+                    if (!full) {
+                        queuedAppend({ id: `resume-err-${Date.now()}`, kind: 'error', message: cmd.id ? `session not found: ${cmd.id}` : 'no previous session in this cwd' });
+                        return;
+                    }
+                    const rec = await tuiStore.get(full);
+                    const msgs = await tuiStore.loadMessages(full);
+                    tuiSessionId = full;
+                    sessionLabel = rec?.task.slice(0, 40) ?? '';
+                    queuedAppend({ id: `resume-${Date.now()}`, kind: 'text', text: `resumed session ${full.slice(0, 8)} — "${rec?.task}" (${msgs.length} messages, status ${rec?.status})`, role: 'assistant' });
+                    queuedStatus({ status: 'idle' });
+                }
+                catch (err) {
+                    queuedAppend({ id: `resume-err2-${Date.now()}`, kind: 'error', message: `resume failed: ${err instanceof Error ? err.message : String(err)}` });
+                }
+                return;
+            }
+            case 'sessions': {
+                try {
+                    const { formatSession } = await import('../persistence/session.js');
+                    const all = (await tuiStore.list()).sort((a, b) => b.updatedAt - a.updatedAt).slice(0, 20);
+                    if (all.length === 0) {
+                        queuedAppend({ id: `sess-${Date.now()}`, kind: 'text', text: 'No sessions yet.', role: 'assistant' });
+                    }
+                    else {
+                        const lines = all.map((r) => `${r.id.slice(0, 8) === tuiSessionId?.slice(0, 8) ? '*' : ' '} ${formatSession(r)}`);
+                        queuedAppend({ id: `sess2-${Date.now()}`, kind: 'text', text: `Sessions (* = current):\n${lines.join('\n')}\nusage: /resume <id>`, role: 'assistant' });
+                    }
+                }
+                catch (err) {
+                    queuedAppend({ id: `sess-err-${Date.now()}`, kind: 'error', message: `sessions failed: ${err instanceof Error ? err.message : String(err)}` });
+                }
+                return;
+            }
+            case 'rename': {
+                if (!cmd.name) {
+                    queuedAppend({ id: `ren-${Date.now()}`, kind: 'text', text: `current session label: ${sessionLabel || '(none)'}\nusage: /rename <name>`, role: 'assistant' });
+                }
+                else {
+                    sessionLabel = cmd.name;
+                    queuedAppend({ id: `ren2-${Date.now()}`, kind: 'text', text: `session renamed to "${cmd.name}"`, role: 'assistant' });
+                }
+                return;
+            }
+            case 'fork': {
+                try {
+                    const base = sessionLabel || 'session';
+                    const rec = await tuiStore.create({ cwd, task: `${base} (fork)${cmd.prompt ? `: ${cmd.prompt}` : ''}`, config: { model, maxSteps: currentMaxSteps } });
+                    tuiSessionId = rec.id;
+                    queuedAppend({ id: `fork-${Date.now()}`, kind: 'text', text: `forked → session ${rec.id.slice(0, 8)}`, role: 'assistant' });
+                }
+                catch (err) {
+                    queuedAppend({ id: `fork-err-${Date.now()}`, kind: 'error', message: `fork failed: ${err instanceof Error ? err.message : String(err)}` });
+                }
+                return;
+            }
+            case 'branch': {
+                if (!cmd.name) {
+                    queuedAppend({ id: `br-${Date.now()}`, kind: 'text', text: `current branch: ${currentBranch || '(none)'}\nusage: /branch <name>`, role: 'assistant' });
+                }
+                else {
+                    currentBranch = cmd.name;
+                    queuedAppend({ id: `br2-${Date.now()}`, kind: 'text', text: `branch "${cmd.name}" created — conversation continues here`, role: 'assistant' });
+                }
+                return;
+            }
+            case 'export': {
+                try {
+                    const all = (await tuiStore.list()).filter((r) => r.cwd === cwd).sort((a, b) => b.updatedAt - a.updatedAt);
+                    const target = tuiSessionId ?? all[0]?.id;
+                    if (!target) {
+                        queuedAppend({ id: `exp-err-${Date.now()}`, kind: 'error', message: 'nothing to export (no session)' });
+                        return;
+                    }
+                    const rec = await tuiStore.get(target);
+                    const msgs = await tuiStore.loadMessages(target);
+                    const out = cmd.file ?? `${target.slice(0, 8)}.export.json`;
+                    await (await import('node:fs/promises')).writeFile(out, JSON.stringify({ record: rec, messages: msgs }, null, 2), 'utf-8');
+                    queuedAppend({ id: `exp-${Date.now()}`, kind: 'text', text: `exported ${target.slice(0, 8)} → ${out} (${msgs.length} messages)`, role: 'assistant' });
+                }
+                catch (err) {
+                    queuedAppend({ id: `exp-err2-${Date.now()}`, kind: 'error', message: `export failed: ${err instanceof Error ? err.message : String(err)}` });
+                }
+                return;
+            }
+            case 'copy': {
+                if (!lastAssistantText) {
+                    queuedAppend({ id: `copy-err-${Date.now()}`, kind: 'error', message: 'nothing to copy yet (no assistant response this session)' });
+                    return;
+                }
+                const n = cmd.n ? parseInt(cmd.n, 10) : NaN;
+                const text = Number.isFinite(n) && n > 0 ? lastAssistantText.slice(0, n) : lastAssistantText;
+                try {
+                    const { execSync } = await import('node:child_process');
+                    const clip = process.platform === 'win32' ? 'clip' : process.platform === 'darwin' ? 'pbcopy' : 'xclip -selection clipboard';
+                    execSync(clip, { input: text });
+                    queuedAppend({ id: `copy-${Date.now()}`, kind: 'text', text: `copied ${text.length} chars to clipboard`, role: 'assistant' });
+                }
+                catch {
+                    queuedAppend({ id: `copy2-${Date.now()}`, kind: 'text', text: `clipboard unavailable — response preview (${text.length} chars):\n${text.slice(0, 500)}`, role: 'assistant' });
+                }
+                return;
+            }
+            case 'auth': {
+                const { getStoredKey } = await import('./auth.js');
+                const rows = ['openai', 'anthropic'].map((p) => {
+                    const hasFile = !!getStoredKey(p);
+                    const hasEnv = !!(p === 'openai' ? process.env.OPENAI_API_KEY : process.env.ANTHROPIC_API_KEY) || !!process.env.KLYRO_API_KEY;
+                    return `  ${p}: ${hasFile ? 'stored key (0600)' : hasEnv ? 'env key' : '—'}`;
+                });
+                queuedAppend({ id: `auth-${Date.now()}`, kind: 'text', text: `Auth:\n${rows.join('\n')}\ncurrent provider: ${currentProvider}\nmanage via /login /logout`, role: 'assistant' });
+                return;
+            }
+            case 'update': {
+                const { runUpdate } = await import('./update.js');
+                const origWrite = process.stdout.write.bind(process.stdout);
+                let out = '';
+                process.stdout.write = ((chunk) => { out += String(chunk); return true; });
+                await runUpdate();
+                process.stdout.write = origWrite;
+                queuedAppend({ id: `upd-${Date.now()}`, kind: 'text', text: out || 'update check done', role: 'assistant' });
+                return;
+            }
+            case 'cancel': {
+                ac.abort();
+                ac = new AbortController();
+                queuedStatus({ status: 'aborted' });
+                queuedAppend({ id: `cancel-${Date.now()}`, kind: 'text', text: 'cancelled current operation', role: 'assistant' });
+                return;
+            }
+            case 'shell': {
+                if (!cmd.command) {
+                    queuedAppend({ id: `sh-${Date.now()}`, kind: 'text', text: 'usage: /shell <command>  (or !<command>)', role: 'assistant' });
+                    return;
+                }
+                try {
+                    const r = await registry.execute('shell_exec', { command: cmd.command }, { cwd, env: process.env, nonInteractive: true });
+                    if (!r.ok) {
+                        queuedAppend({ id: `sh-err-${Date.now()}`, kind: 'error', message: `shell failed: ${r.error.message ?? r.error.code}` });
+                    }
+                    else {
+                        const v = r.value;
+                        const body = (v.stdout + (v.stderr ? `\n[stderr]\n${v.stderr}` : '')).slice(0, 4000) || '(no output)';
+                        queuedAppend({ id: `sh2-${Date.now()}`, kind: 'text', text: `$ ${cmd.command}\nexit ${v.exitCode}\n${body}`, role: 'assistant' });
+                    }
+                }
+                catch (err) {
+                    queuedAppend({ id: `sh-err2-${Date.now()}`, kind: 'error', message: `shell failed: ${err instanceof Error ? err.message : String(err)}` });
+                }
+                return;
+            }
+            case 'mention': {
+                if (!cmd.path) {
+                    queuedAppend({ id: `men-${Date.now()}`, kind: 'text', text: 'usage: /mention <path>  (or @<path>)', role: 'assistant' });
+                    return;
+                }
+                try {
+                    const r = await registry.execute('read_file', { path: cmd.path }, { cwd, env: process.env, nonInteractive: true });
+                    if (!r.ok) {
+                        queuedAppend({ id: `men-err-${Date.now()}`, kind: 'error', message: `mention failed: ${r.error.message ?? r.error.code}` });
+                    }
+                    else {
+                        const v = r.value;
+                        const body = String(v.content ?? v.text ?? JSON.stringify(v)).slice(0, 6000);
+                        queuedAppend({ id: `men2-${Date.now()}`, kind: 'text', text: `attached ${cmd.path} (${body.length} chars):\n${body}`, role: 'assistant' });
+                    }
+                }
+                catch (err) {
+                    queuedAppend({ id: `men-err2-${Date.now()}`, kind: 'error', message: `mention failed: ${err instanceof Error ? err.message : String(err)}` });
+                }
+                return;
+            }
+            case 'tools': {
+                const lines = registry.list().map((t) => `  ${t.name} — ${t.description.slice(0, 80)}`);
+                queuedAppend({ id: `tools-${Date.now()}`, kind: 'text', text: `Tools (${lines.length}):\n${lines.join('\n')}`, role: 'assistant' });
+                return;
+            }
+            case 'settings': {
+                const { getConfigPath } = await import('./config.js');
+                queuedAppend({ id: `set-${Date.now()}`, kind: 'text', text: `config: ${getConfigPath()} (alias of /config)`, role: 'assistant' });
+                return;
+            }
+            case 'prompt': {
+                // Regular prompts never reach onSlash — no-op for exhaustiveness.
+                return;
+            }
             case 'unknown':
                 queuedAppend({
                     id: `unk-${Date.now()}`,

package/dist/cli/slash/parser.d.ts

@@ -16,11 +16,25 @@
  */
 export type SlashCommand = {
     kind: 'clear';
+} | {
+    kind: 'new';
 } | {
     kind: 'compact';
+    focus?: string;
 } | {
     kind: 'model';
     model: string;
+} | {
+    kind: 'models';
+} | {
+    kind: 'provider';
+    provider: string;
+} | {
+    kind: 'effort';
+    level: string;
+} | {
+    kind: 'fast';
+    state: string;
 } | {
     kind: 'diff';
 } | {
@@ -29,6 +43,9 @@ export type SlashCommand = {
     kind: 'rewind';
 } | {
     kind: 'plan';
+    task?: string;
+} | {
+    kind: 'todos';
 } | {
     kind: 'status';
 } | {
@@ -37,10 +54,14 @@ export type SlashCommand = {
     kind: 'help';
 } | {
     kind: 'config';
+} | {
+    kind: 'settings';
 } | {
     kind: 'doctor';
 } | {
     kind: 'version';
+} | {
+    kind: 'update';
 } | {
     kind: 'cost';
 } | {
@@ -56,8 +77,56 @@ export type SlashCommand = {
 } | {
     kind: 'context';
 } | {
-    kind: 'compact';
-    focus?: string;
+    kind: 'login';
+} | {
+    kind: 'logout';
+} | {
+    kind: 'auth';
+} | {
+    kind: 'init';
+} | {
+    kind: 'cancel';
+} | {
+    kind: 'shell';
+    command: string;
+} | {
+    kind: 'mention';
+    path: string;
+} | {
+    kind: 'tools';
+} | {
+    kind: 'permissions';
+} | {
+    kind: 'mode';
+    mode: string;
+} | {
+    kind: 'sandbox';
+    policy: string;
+} | {
+    kind: 'approve';
+} | {
+    kind: 'deny';
+} | {
+    kind: 'resume';
+    id?: string;
+} | {
+    kind: 'sessions';
+    sub?: string;
+} | {
+    kind: 'rename';
+    name: string;
+} | {
+    kind: 'fork';
+    prompt?: string;
+} | {
+    kind: 'branch';
+    name: string;
+} | {
+    kind: 'export';
+    file?: string;
+} | {
+    kind: 'copy';
+    n?: string;
 } | {
     kind: 'prompt';
     text: string;

package/dist/cli/slash/parser.js

@@ -14,9 +14,16 @@
  * Anything not starting with "/" is a regular prompt and yields
  * { kind: 'prompt', text }.
  */
-const KNOWN = ['clear', 'compact', 'model', 'diff', 'undo', 'rewind', 'plan', 'status', 'quit', 'help', 'config', 'doctor', 'version', 'cost', 'thinking', 'memory', 'jobs', 'verify', 'project', 'context', 'compact', 'exit', 'clear'];
+const KNOWN = ['help', 'clear', 'new', 'exit', 'quit', 'q', 'compact', 'resume', 'sessions', 'rename', 'fork', 'branch', 'export', 'copy', 'model', 'm', 'models', 'provider', 'p', 'effort', 'e', 'fast', 'init', 'status', 'context', 'diff', 'plan', 'todos', 'memory', 'permissions', 'mode', 'sandbox', 'approve', 'deny', 'login', 'logout', 'auth', 'version', 'update', 'cancel', 'shell', 'mention', 'tools', 'config', 'settings', 'doctor', 'version', 'cost', 'thinking', 'jobs', 'verify', 'project', 'undo', 'rewind'];
 export function parse(input) {
     const trimmed = input.trim();
+    // `!cmd` alias for /shell, `@path` alias for /mention (commands.md P1)
+    if (trimmed.startsWith('!')) {
+        return { kind: 'shell', command: trimmed.slice(1).trim() };
+    }
+    if (trimmed.startsWith('@')) {
+        return { kind: 'mention', path: trimmed.slice(1).trim() };
+    }
     if (!trimmed.startsWith('/')) {
         return { kind: 'prompt', text: trimmed };
     }
@@ -25,11 +32,13 @@ export function parse(input) {
     const rest = space === -1 ? '' : trimmed.slice(space + 1).trim();
     switch (name) {
         case 'clear': return { kind: 'clear' };
-        case 'compact': return { kind: 'compact' };
+        case 'new': return { kind: 'new' };
+        case 'compact': return { kind: 'compact', focus: rest || undefined };
         case 'diff': return { kind: 'diff' };
         case 'undo': return { kind: 'undo' };
         case 'rewind': return { kind: 'rewind' };
-        case 'plan': return { kind: 'plan' };
+        case 'plan': return { kind: 'plan', task: rest || undefined };
+        case 'todos': return { kind: 'todos' };
         case 'status': return { kind: 'status' };
         case 'cost': return { kind: 'cost' };
         case 'thinking': return { kind: 'thinking' };
@@ -38,7 +47,33 @@ export function parse(input) {
         case 'verify': return { kind: 'verify' };
         case 'project': return { kind: 'project' };
         case 'context': return { kind: 'context' };
-        case 'compact': return { kind: 'compact', focus: rest || undefined };
+        case 'login': return { kind: 'login' };
+        case 'logout': return { kind: 'logout' };
+        case 'auth': return { kind: 'auth' };
+        case 'init': return { kind: 'init' };
+        case 'cancel':
+        case 'interrupt': return { kind: 'cancel' };
+        case 'shell': return { kind: 'shell', command: rest };
+        case 'mention': return { kind: 'mention', path: rest };
+        case 'tools': return { kind: 'tools' };
+        case 'permissions': return { kind: 'permissions' };
+        case 'mode': return { kind: 'mode', mode: rest };
+        case 'sandbox': return { kind: 'sandbox', policy: rest };
+        case 'approve': return { kind: 'approve' };
+        case 'deny': return { kind: 'deny' };
+        case 'resume': return { kind: 'resume', id: rest || undefined };
+        case 'sessions': return { kind: 'sessions', sub: rest || undefined };
+        case 'rename':
+        case 'title': return { kind: 'rename', name: rest };
+        case 'fork': return { kind: 'fork', prompt: rest || undefined };
+        case 'branch': return { kind: 'branch', name: rest };
+        case 'export': return { kind: 'export', file: rest || undefined };
+        case 'copy': return { kind: 'copy', n: rest || undefined };
+        case 'update':
+        case 'upgrade': return { kind: 'update' };
+        case 'models': return { kind: 'models' };
+        case 'fast': return { kind: 'fast', state: rest };
+        case 'settings': return { kind: 'settings' };
         case 'quit':
         case 'exit':
         case 'q': return { kind: 'quit' };
@@ -47,10 +82,16 @@ export function parse(input) {
         case 'config': return { kind: 'config' };
         case 'doctor': return { kind: 'doctor' };
         case 'version': return { kind: 'version' };
+        case 'provider':
+        case 'p': {
+            return { kind: 'provider', provider: rest };
+        }
+        case 'effort':
+        case 'e': {
+            return { kind: 'effort', level: rest };
+        }
         case 'model':
         case 'm': {
-            if (!rest)
-                return { kind: 'unknown', raw: trimmed };
             return { kind: 'model', model: rest };
         }
         default: return { kind: 'unknown', raw: trimmed };

package/dist/tui/app.d.ts

@@ -21,6 +21,7 @@ export interface AppProps {
         appendDelta: (text: string) => void;
         updateStatus: (s: Partial<StatusSnapshot>) => void;
         updatePlan: (p: PlanStep[]) => void;
+        clearTranscript: () => void;
     }) => void;
     version?: string;
     isFullscreen?: boolean;

package/dist/tui/app.js

@@ -233,9 +233,10 @@ export function App(props) {
         streamingIdRef.current = null; }, [status.status]);
     const updateStatus = useCallback((s) => setStatus((p) => ({ ...p, ...s })), []);
     const updatePlan = useCallback((p) => setPlan(p), []);
+    const clearTranscript = useCallback(() => { streamingIdRef.current = null; setTranscript([]); setPlan([]); }, []);
     const onMountedRef = useRef(props.onMounted);
     useEffect(() => { onMountedRef.current = props.onMounted; }, [props.onMounted]);
-    useEffect(() => { onMountedRef.current?.({ append, appendDelta, updateStatus, updatePlan }); globalThis.__klyroAppAppend = append; globalThis.__klyroAppendDelta = appendDelta; globalThis.__klyroAppStatus = updateStatus; globalThis.__klyroAppPlan = updatePlan; return () => { delete globalThis.__klyroAppAppend; delete globalThis.__klyroAppendDelta; delete globalThis.__klyroAppStatus; delete globalThis.__klyroAppPlan; }; }, [append, appendDelta, updateStatus, updatePlan]);
+    useEffect(() => { onMountedRef.current?.({ append, appendDelta, updateStatus, updatePlan, clearTranscript }); globalThis.__klyroAppAppend = append; globalThis.__klyroAppendDelta = appendDelta; globalThis.__klyroAppStatus = updateStatus; globalThis.__klyroAppPlan = updatePlan; return () => { delete globalThis.__klyroAppAppend; delete globalThis.__klyroAppendDelta; delete globalThis.__klyroAppStatus; delete globalThis.__klyroAppPlan; }; }, [append, appendDelta, updateStatus, updatePlan, clearTranscript]);
     const toggleGroup = (id) => setExpandedGroups((prev) => { const n = new Set(prev); if (n.has(id))
         n.delete(id);
     else

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "klyro",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "description": "Klyro \u2014 autonomous coding harness CLI that streams from any OpenAI-compatible or Anthropic LLM endpoint.",
   "type": "module",
   "main": "dist/index.js",