s-app-scoder-agent 0.6.0 → 0.7.0

package/dist/tui/at-complete.js

@@ -0,0 +1,93 @@
+/**
+ * T-01: `@` fuzzy autocomplete engine — pure logic, TUI-agnostic (unit-testable).
+ * Sources: file index (.gitignore-aware via `rg --files`, fallback walk) +
+ * directory prefixes so `@src/` opens the subtree. Engine: fuzzysort (MIT).
+ */
+import { spawnSync } from "node:child_process";
+import { readdirSync } from "node:fs";
+import { join, relative } from "node:path";
+import fuzzysort from "fuzzysort";
+const SKIP = new Set(["node_modules", ".git", "dist", "build", ".next", "__pycache__", ".venv"]);
+let cache = null;
+/** File index for `workdir` (cached, TTL 5s; invalidateFileIndex on tool writes). */
+export function fileIndex(workdir) {
+    if (cache && Date.now() - cache.built < 5_000)
+        return cache.files;
+    const files = [];
+    // Fast path: ripgrep --files (gitignore-aware). Bare-name globs match at any
+    // depth; `!**/x/**` does NOT match absolute paths (I-07 lesson).
+    try {
+        const r = spawnSync("rg", ["--files", "--hidden", "-g", "!.git", "-g", "!node_modules", "-g", "!dist", "-g", "!build", "-g", "!.venv", "-g", "!__pycache__", "-g", "!.next", "--no-messages", workdir], { maxBuffer: 16e6, timeout: 3_000 });
+        if (r.status === 0) {
+            for (const line of r.stdout.toString().split("\n")) {
+                if (line)
+                    files.push(relative(workdir, line) || line);
+            }
+        }
+    }
+    catch {
+        // no rg on PATH → walker fallback
+    }
+    if (files.length === 0)
+        walkFiles(workdir, "", files, 0);
+    files.sort();
+    cache = { files, built: Date.now() };
+    return files;
+}
+/** Cache invalidate — call after write/edit tool_result (scope: whole index). */
+export function invalidateFileIndex() {
+    cache = null;
+}
+function walkFiles(root, prefix, out, depth) {
+    if (depth > 6)
+        return;
+    let entries;
+    try {
+        entries = readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const e of entries) {
+        if (SKIP.has(e.name))
+            continue;
+        const rel = prefix ? `${prefix}/${e.name}` : e.name;
+        if (e.isDirectory())
+            walkFiles(join(root, e.name), rel, out, depth + 1);
+        else if (e.isFile())
+            out.push(rel);
+    }
+}
+/** Active `@` token in `value`, or null. Returns start index (of "@") + query. */
+export function atQuery(value) {
+    const m = /(^|\s)@([^\s@]*)$/.exec(value);
+    if (!m)
+        return null;
+    return { start: m.index + m[1].length, query: m[2] };
+}
+/** Candidate suggestions for a query: fuzzy files + dir prefixes, max 8. */
+export function suggest(files, query, limit = 8) {
+    const dirs = new Set();
+    for (const f of files) {
+        const parts = f.split("/");
+        for (let i = 1; i < parts.length; i++)
+            dirs.add(parts.slice(0, i).join("/"));
+    }
+    const all = [...files, ...[...dirs].map((d) => `${d}/`)];
+    let hits;
+    if (query.includes("/") || query.endsWith("/")) {
+        // Subtree mode: prefix match on directories (`@src/tui/…`).
+        hits = all.filter((t) => t.startsWith(query));
+    }
+    else if (query === "") {
+        hits = all.slice(0, limit * 4);
+    }
+    else {
+        hits = fuzzysort.go(query, all, { limit: limit * 4 }).map((r) => r.target);
+    }
+    return hits.slice(0, limit);
+}
+/** Replace the active @token with `sel` (dirs keep the trailing slash). */
+export function applySuggestion(value, at, sel) {
+    return value.slice(0, at.start) + "@" + sel + (sel.endsWith("/") ? "" : " ");
+}

package/dist/tui/chat-views.js

@@ -0,0 +1,145 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * T2: chat item views — Spinner, ToolItemView, DiffItemView, TodoItemView,
+ * ChatItemView. Tách khỏi app.tsx (component-based, pattern từ opencode
+ * packages/tui).
+ */
+import { useEffect, useMemo, useState } from "react";
+import { Box, Text } from "ink";
+import { Markdown } from "./markdown.js";
+import { detectImageCaps, halfblockRows } from "./image.js"; // T7
+import { AgentMark, fit, theme, toolIcon } from "./theme.js";
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+const SPINNER_MS = 80;
+function useSpinner(active) {
+    const [frame, setFrame] = useState(0);
+    useEffect(() => {
+        if (!active)
+            return;
+        const timer = setInterval(() => setFrame((f) => (f + 1) % SPINNER_FRAMES.length), SPINNER_MS);
+        return () => clearInterval(timer);
+    }, [active]);
+    return SPINNER_FRAMES[frame];
+}
+/**
+ * Isolated spinner: owns its own 80ms timer so animation frames re-render
+ * ONLY this component — not the whole tree (the previous design lifted the
+ * frame state into TuiApp, re-rendering every chat item 12x/second → flicker).
+ */
+export function Spinner({ active }) {
+    const frame = useSpinner(active);
+    if (!active)
+        return null;
+    return _jsx(Text, { color: "cyan", children: frame });
+}
+const OUTPUT_PREVIEW_LINES = 5;
+/** T7: decode data URL → halfblock rows (null khi không PNG/không decode được). */
+function halfblockFromDataUrl(dataUrl) {
+    const m = /^data:image\/(\w+);base64,(.+)$/.exec(dataUrl);
+    if (!m)
+        return null;
+    try {
+        return halfblockRows(Buffer.from(m[2], "base64"));
+    }
+    catch {
+        return null;
+    }
+}
+/** Collapse run_command scaffolding ("--- stdout ---" etc.) to real content. */
+function previewLines(output) {
+    const lines = output
+        .replace(/\n+$/, "")
+        .split("\n")
+        .filter((l) => !/^--- (stdout|stderr) ---$/.test(l.trim()));
+    return lines.slice(-OUTPUT_PREVIEW_LINES);
+}
+function ToolItemView({ item }) {
+    const running = item.ok === null;
+    // One meaningful arg per tool type keeps the line scannable.
+    const keyArg = typeof item.args.command === "string"
+        ? fit(item.args.command, 60)
+        : typeof item.args.path === "string"
+            ? fit(item.args.path, 40)
+            : Object.keys(item.args).length > 0
+                ? fit(Object.keys(item.args).join(","), 24)
+                : "";
+    const preview = previewLines(item.output);
+    // T7: image result — halfblock preview khi terminal truecolor, fallback link.
+    const caps = useMemo(() => detectImageCaps(), []);
+    const halfblocks = useMemo(() => (item.image && caps.truecolor ? halfblockFromDataUrl(item.image) : null), [item.image, caps.truecolor]);
+    // T6: live elapsed cho tool đang chạy
+    const liveElapsed = item.ok === null && item.startedAt != null ? Date.now() - item.startedAt : null;
+    const elapsedMs = item.durationMs ?? liveElapsed;
+    const elapsed = elapsedMs != null
+        ? elapsedMs >= 10_000
+            ? `${(elapsedMs / 1000).toFixed(0)}s`
+            : `${(elapsedMs / 1000).toFixed(1)}s`
+        : null;
+    return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, children: [_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: [String(item.step).padStart(2, "0"), "\u25B8 "] }), _jsxs(Text, { color: theme.accent, children: [toolIcon(item.name), " "] }), _jsx(Text, { color: item.ok === false ? theme.error : theme.accent, bold: true, children: item.name }), keyArg && _jsxs(Text, { dimColor: true, children: [" ", keyArg] }), running && _jsx(Text, { dimColor: true, children: " \u00B7 running" }), !running && elapsed && _jsxs(Text, { dimColor: true, children: [" \u00B7 ", elapsed] })] }), preview.map((line, i) => (_jsxs(Text, { dimColor: true, children: ["  └ ", line.length > 140 ? line.slice(0, 140) + "…" : line] }, i))), halfblocks && (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, children: [halfblocks.map((r, i) => (_jsx(Text, { children: r.text }, i))), _jsx(Text, { dimColor: true, children: "  \u2514 image preview" })] })), item.image && !halfblocks && (_jsxs(Text, { dimColor: true, children: ["  \u2514 image \u2014 ", item.output] }))] }));
+}
+/** One colored line of a unified diff (+ green, - red, @@ cyan, header bold). */
+export function DiffLine({ line }) {
+    if (line.startsWith("+++") || line.startsWith("---"))
+        return _jsx(Text, { bold: true, children: line });
+    if (line.startsWith("@@"))
+        return _jsx(Text, { color: "cyan", children: line });
+    if (line.startsWith("+"))
+        return _jsx(Text, { color: "green", children: line });
+    if (line.startsWith("-"))
+        return _jsx(Text, { color: "red", children: line });
+    return _jsx(Text, { children: line });
+}
+const MAX_DIFF_RENDER_LINES = 20;
+/**
+ * Polished diff card — rounded border, step badge, color-coded + and - lines.
+ * Header row: [step] ✎ [+/− stats] [path]
+ * Body: up to MAX_DIFF_RENDER_LINES of colored diff lines.
+ */
+function DiffItemView({ item }) {
+    const lines = item.text.length > 0 ? item.text.split("\n") : [];
+    const shown = lines.slice(0, MAX_DIFF_RENDER_LINES);
+    const hidden = lines.length - shown.length;
+    const addedColor = item.added > 0 ? theme.success : undefined;
+    const removedColor = item.removed > 0 ? theme.error : undefined;
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.border, paddingX: 1, marginTop: 1, marginLeft: 1, children: [_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: [String(item.step).padStart(2, "0"), "\u25B8 "] }), _jsx(Text, { color: theme.brand, bold: true, children: "\u270E" }), _jsx(Text, { children: "  " }), _jsxs(Text, { color: addedColor, children: ["+", item.added] }), _jsx(Text, { children: " " }), _jsxs(Text, { color: removedColor, children: ["-", item.removed] }), _jsx(Text, { children: "  " }), _jsx(Text, { bold: true, color: theme.accent, children: item.path }), item.truncated && _jsx(Text, { dimColor: true, children: " \u00B7 diff truncated" })] }), shown.map((line, i) => (_jsx(DiffLine, { line: line.length > 160 ? line.slice(0, 160) + "…" : line }, i))), hidden > 0 && (_jsxs(Text, { dimColor: true, children: ["  \u2026 +", hidden, " more diff lines"] }))] }));
+}
+/**
+ * Plan KHÔNG còn render trong chat — checklist live hiển thị ở Sidebar bên
+ * phải (sidebar.tsx, PlanSection) để transcript sạch; todo items vẫn được
+ * giữ trong state (latestPlan) làm nguồn dữ liệu cho sidebar.
+ */
+function TodoItemView() {
+    return null;
+}
+export function ChatItemView({ item }) {
+    switch (item.kind) {
+        case "user":
+            // Clean user bubble: accent arrow + bold text
+            return (_jsxs(Box, { marginTop: 1, paddingLeft: 1, children: [_jsx(Text, { color: theme.user, bold: true, children: "\u276F " }), _jsx(Text, { bold: true, children: item.text })] }));
+        case "assistant": {
+            // Streaming: dim with pulsing cursor; finalized: markdown with agent mark.
+            if (item.streaming || !item.text) {
+                return (_jsxs(Box, { marginTop: item.text ? 1 : 0, paddingLeft: 1, children: [_jsx(AgentMark, {}), _jsx(Text, { dimColor: item.streaming, children: item.text || (item.streaming ? "" : "(no text)") }), item.streaming && _jsx(Text, { color: theme.accent, bold: true, children: "\u258B" })] }));
+            }
+            return (_jsxs(Box, { marginTop: 1, paddingLeft: 1, children: [_jsx(AgentMark, {}), _jsx(Markdown, { text: item.text })] }));
+        }
+        case "thinking":
+            // T-10: reasoning stream — dim color, ⊙ prefix, collapse to last 4 lines.
+            return (_jsx(Box, { paddingLeft: 1, marginTop: 1, children: _jsxs(Text, { color: theme.thinking, italic: true, children: [_jsx(Text, { dimColor: true, children: "\u2299" }), " ", item.text.split("\n").slice(-4).join("\n  ")] }) }));
+        case "tool":
+            return _jsx(ToolItemView, { item: item });
+        case "diff":
+            return _jsx(DiffItemView, { item: item });
+        case "todo":
+            return _jsx(TodoItemView, {});
+        case "build":
+            // Rich build status card: large icon + bold label + dim command
+            return (_jsx(Box, { paddingLeft: 1, marginTop: 1, children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: item.success
+                                ? _jsx(Text, { color: theme.success, bold: true, children: "\u2713 build passed" })
+                                : _jsx(Text, { color: theme.error, bold: true, children: "\u2717 build FAILED" }) }), _jsxs(Text, { dimColor: true, children: ["   ", item.command] })] }) }));
+        case "notice":
+            return (_jsx(Box, { paddingLeft: 2, marginTop: 1, children: _jsxs(Text, { color: item.level === "error" ? theme.error :
+                        item.level === "warn" ? theme.warn :
+                            theme.dim, children: [item.level === "error" ? "✗ " : item.level === "warn" ? "⚠ " : "  ", item.text.length > 2000 ? item.text.slice(0, 2000) + "…" : item.text] }) }));
+    }
+}

package/dist/tui/chrome.js

@@ -0,0 +1,96 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text, useWindowSize } from "ink";
+import { fit, theme } from "./theme.js";
+import { Spinner } from "./chat-views.js";
+/** Fuel gauge is scaled to this many cells regardless of maxSteps. */
+export const GAUGE_CELLS = 12;
+/** Sidebar phải: tổng rộng (kể cả border + padding) — pattern opencode. */
+export const SIDEBAR_WIDTH = 40;
+/** Dưới ngưỡng cột này ẩn sidebar — BuildRail fallback sang header đầy đủ. */
+export const SIDEBAR_MIN_COLS = 92;
+/** Scaled step fuel gauge: ▰ filled / ▱ remaining, e.g. ▰▰▰▰▱▱▱▱ 4/40. */
+export function fuelGauge(step, maxSteps) {
+    if (maxSteps <= 0)
+        return null;
+    const filled = Math.min(GAUGE_CELLS, Math.round((Math.min(step, maxSteps) / maxSteps) * GAUGE_CELLS));
+    return "▰".repeat(filled) + "▱".repeat(GAUGE_CELLS - filled);
+}
+/** T-11: gauge segment color — green (headroom) → yellow → red (nearly spent). */
+export function gaugeColor(step, maxSteps) {
+    const ratio = maxSteps > 0 ? Math.min(step, maxSteps) / maxSteps : 0;
+    return ratio < 0.6 ? theme.success : ratio < 0.85 ? theme.warn : theme.error;
+}
+/**
+ * BuildRail — polished top bar (SINGLE row).
+ *
+ * Layout:  [⚑ scoder] ── [phase breadcrumb / guardrail warning] ── [perm] [build] [steps]
+ *
+ * Terminal ≥ SIDEBAR_MIN_COLS: sidebar handles METRICS + PHASES.
+ * Terminal < SIDEBAR_MIN_COLS: phase breadcrumb + metrics move into this row.
+ */
+export function BuildRail({ state, config }) {
+    const { columns } = useWindowSize();
+    const wide = (columns ?? 100) >= SIDEBAR_MIN_COLS;
+    const perm = state.permission || config.permissionMode;
+    const permColor = perm === "readonly" ? theme.warn : perm === "ask" ? theme.accent : theme.dim;
+    // Build lamp
+    const lampColor = state.buildLamp === "ok" ? theme.success : state.buildLamp === "fail" ? theme.error : theme.dim;
+    const lampLabel = state.buildLamp === "ok" ? "✓" : state.buildLamp === "fail" ? "✗" : "○";
+    const lampText = state.buildLamp === "ok" ? "ok" : state.buildLamp === "fail" ? "fail" : "—";
+    // Step badge
+    const stepLabel = state.step > 0
+        ? `${state.step}${state.maxSteps > 0 ? `/${state.maxSteps}` : ""}`
+        : "idle";
+    // Guardrail: shown inline if it fired (small warning before the phase breadcrumb)
+    const hasGuardrail = Boolean(state.lastGuardrail);
+    // Phase breadcrumb or narrow-terminal metrics (right of the center)
+    const showNarrowMetrics = !wide && (state.status === "running" || state.phases.length > 0);
+    return (_jsxs(Box, { borderStyle: "bold", borderColor: theme.border, paddingX: 1, justifyContent: "space-between", alignItems: "center", flexShrink: 0, children: [_jsxs(Text, { bold: true, color: theme.brand, children: ["\u2691 ", _jsx(Text, { bold: true, children: "scoder" })] }), _jsx(Box, { flexGrow: 1, justifyContent: "center", children: hasGuardrail ? (_jsxs(Text, { color: theme.warn, bold: true, children: ["\u26A0 ", fit(state.lastGuardrail, 40)] })) : state.status === "running" ? (showNarrowMetrics ? (_jsx(PhaseBreadcrumb, { phases: state.phases })) : (_jsx(Text, { dimColor: true, children: "plan \u203A explore \u203A edit \u203A build \u203A verify" }))) : (_jsx(Text, { dimColor: true, children: "ready" })) }), _jsxs(Text, { children: [_jsxs(Text, { color: permColor, children: ["[", perm, "]"] }), _jsx(Text, { children: " " }), _jsx(Text, { color: lampColor, children: lampLabel }), _jsxs(Text, { dimColor: true, children: [" ", lampText] }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: stepLabel })] })] }));
+}
+/** Breadcrumb tiến trình: plan › explore › edit › build › verify. */
+const PHASE_SEQUENCE = ["plan", "explore", "edit", "build", "verify"];
+/** Clean horizontal phase trail with separator dots (● visited, ○ pending, ◆ current). */
+function PhaseBreadcrumb({ phases }) {
+    const current = phases[phases.length - 1] ?? null;
+    return (_jsx(Text, { children: PHASE_SEQUENCE.map((p, i) => {
+            const visited = phases.includes(p);
+            const isCurrent = p === current;
+            const dot = isCurrent ? "◆" : visited ? "●" : "○";
+            return (_jsxs(Text, { children: [i > 0 && _jsx(Text, { dimColor: true, children: " \u00B7 " }), _jsxs(Text, { color: isCurrent ? theme.accent : visited ? theme.success : theme.dim, bold: isCurrent, children: [dot, " ", p] })] }, p));
+        }) }));
+}
+/** Metrics cho narrow-terminal — không còn dùng (sidebar đã thay thế), giữ để tham khảo. */
+/**
+ * Status bar — bottom row. Left: spinner · status · elapsed · model.
+ * Right: scroll position OR keyboard hints.
+ */
+export function StatusBar({ state, scroll }) {
+    const { columns } = useWindowSize();
+    const width = Math.max(40, (columns ?? 100) - 6);
+    const statusColor = state.status === "running" ? theme.accent :
+        state.status === "success" ? theme.success :
+            state.status === "failed" ? theme.error : theme.dim;
+    const statusLabel = state.status === "running"
+        ? `running ${state.step}${state.maxSteps > 0 ? `/${state.maxSteps}` : ""}`
+        : state.status === "idle" ? "idle" : state.status;
+    const model = state.model || "—";
+    const elapsed = state.startedAt
+        ? `${Math.floor((Date.now() - state.startedAt) / 60000)}:${String(Math.floor((Date.now() - state.startedAt) / 1000) % 60).padStart(2, "0")}`
+        : null;
+    // Right side: scroll position OR helpful keybinds
+    const rightText = scroll
+        ? `scroll ${scroll} · esc→tail`
+        : `⏎ send · ctrl+s sessions · ctrl+t ${state.thinkingVisible ? "◉" : "○"} · esc abort · ctrl+c quit`;
+    const leftBudget = Math.max(24, width - rightText.length - 3);
+    let left = statusLabel;
+    if (elapsed && state.status === "running")
+        left += ` · ${elapsed}`;
+    if (model && model !== "—") {
+        const part = ` · ${model}`;
+        if (left.length + part.length <= leftBudget)
+            left += part;
+        else
+            left = fit(left, leftBudget);
+    }
+    return (_jsxs(Box, { borderStyle: "bold", borderColor: theme.border, paddingX: 1, justifyContent: "space-between", alignItems: "center", flexShrink: 0, children: [_jsxs(Text, { children: [state.status === "running" && _jsx(Spinner, { active: true }), state.status === "running" ? "  " : "   ", _jsx(Text, { color: statusColor, bold: true, children: left })] }), _jsx(Text, { dimColor: true, children: fit(rightText, Math.floor(width * 0.5)) })] }));
+}

package/dist/tui/command-registry.js

@@ -0,0 +1,189 @@
+import { listSessions, resolveSessionId } from "../session.js";
+import { discoverSkills } from "../skills.js";
+import { formatSlashHelp, parseMcpExec } from "./commands.js";
+/** Format usage/cost block (dùng chung — REPL console.log, TUI notice). */
+export function formatUsage(u) {
+    return u.calls > 0
+        ? `session usage: ${u.calls} LLM calls · tokens in ${u.inputTokens} / out ${u.outputTokens}` +
+            (u.cachedTokens > 0 ? ` (+${u.cachedTokens} cached)` : "")
+        : "no LLM calls yet in this session";
+}
+/** Format skills listing (dùng chung). */
+export function formatSkills(skills) {
+    if (skills.length === 0) {
+        return "no skills discovered — add .scoder/skills/<name>/SKILL.md (name + description frontmatter)";
+    }
+    return ("Skills:\n" +
+        skills
+            .map((s) => `  ${s.name.padEnd(20)} ${s.description || "(no description)"}  [${s.scope}]`)
+            .join("\n"));
+}
+/** Format sessions listing (dùng chung). */
+export function formatSessions(all) {
+    return all.length === 0
+        ? "no saved sessions — completed runs auto-save to .scoder/sessions/"
+        : all.slice(0, 10).map((x) => `${x.id.slice(0, 8)}  ${x.updatedAt.slice(0, 16).replace("T", " ")}  ${x.steps} steps  ${x.task}`).join("\n") +
+            "\nresume: /sessions resume <id|last>";
+}
+/** Format MCP status listing (dùng chung). */
+export function formatMcpStatus(status) {
+    if (status.length === 0)
+        return "no MCP servers configured — add mcpServers to .scoderrc.json";
+    return status
+        .map((srv) => `${srv.connected ? "✓" : "·"} ${srv.name} — ${srv.command}` +
+        (srv.connected ? ` (${srv.tools.length} tools)\n` + srv.tools.map((t) => `    mcp__${srv.name}__${t.name}  ${t.description ?? ""}`).join("\n") : " (not connected)"))
+        .join("\n");
+}
+/**
+ * Handlers dùng chung. Command đặc thù frontend (/review, /undo, /theme — chỉ
+ * TUI; /diff TUI có turn-scope riêng) KHÔNG nằm đây — frontend xử lý trước
+ * khi dispatch, rồi mới gọi dispatchCommand() cho phần còn lại.
+ */
+export function coreCommands() {
+    return [
+        {
+            name: "/help",
+            description: "show this command list",
+            run(_slash, _host, notice) {
+                notice(formatSlashHelp("scoder tui"));
+            },
+        },
+        {
+            name: "/cost",
+            description: "token usage of the current session",
+            run(_slash, host, notice) {
+                notice(formatUsage(host.agent()?.getUsage() ?? { calls: 0, inputTokens: 0, outputTokens: 0, cachedTokens: 0 }));
+            },
+        },
+        {
+            name: "/skills",
+            description: "list discovered skills (SKILL.md)",
+            run(_slash, host, notice) {
+                notice(formatSkills(host.agent()?.getSkills() ?? discoverSkills(host.config.workdir)));
+            },
+        },
+        {
+            name: "/skill",
+            description: "load a skill into context: /skill <name>",
+            run(slash, host, notice) {
+                if (!slash.arg)
+                    return notice("usage: /skill <name>", "warn");
+                const r = host.agent()?.stageSkill(slash.arg);
+                if (!r)
+                    return notice("agent not ready", "warn");
+                notice(r.message, r.ok ? "info" : "error");
+            },
+        },
+        {
+            name: "/mcp",
+            description: "MCP servers & tools: /mcp [server] [tool] [json|text]",
+            async run(slash, host, notice) {
+                const agent = host.agent();
+                if (!agent)
+                    return notice("agent not ready", "warn");
+                const exec = parseMcpExec(slash.arg);
+                if (exec === null) {
+                    notice(formatMcpStatus(await agent.mcpStatus()));
+                    return;
+                }
+                if ("error" in exec)
+                    return notice(exec.error, "warn");
+                notice(`→ ${exec.fullName}`);
+                const r = await agent.callMcpTool(exec.fullName, exec.args);
+                if (r.ok)
+                    notice(r.output.length > 4000 ? r.output.slice(0, 4000) + "\n… (truncated)" : r.output);
+                else
+                    notice(r.output, "error");
+            },
+        },
+        {
+            name: "/model",
+            description: "show the active model & provider — /model <provider/model> to hot-swap",
+            run(slash, host, notice) {
+                if (slash.arg) {
+                    const agent = host.agent();
+                    if (!agent)
+                        return notice("agent not ready", "warn");
+                    const msg = agent.setModel(slash.arg.trim());
+                    notice(msg, msg.startsWith("ERROR") ? "error" : "info");
+                    return;
+                }
+                const cfg = host.config;
+                notice(`model: ${cfg.model} · provider: ${cfg.provider} · build: ${cfg.buildCmd ?? "auto-detect"}`);
+            },
+        },
+        {
+            name: "/permission",
+            description: "view or switch permission mode: /permission <auto|ask|readonly>",
+            run(slash, host, notice) {
+                const mode = slash.arg.toLowerCase();
+                if (!["auto", "ask", "readonly"].includes(mode)) {
+                    notice(`permission mode: ${host.config.permissionMode} — usage: /permission <auto|ask|readonly>`, "warn");
+                    return;
+                }
+                host.agent()?.setPermissionMode(mode);
+                host.config = withPermissionMode(host.config, mode);
+                notice(`permission mode → ${mode}`);
+            },
+        },
+        {
+            name: "/sessions",
+            description: "list saved sessions — /sessions resume <id|last>",
+            async run(slash, host, notice) {
+                if (slash.arg.startsWith("resume")) {
+                    const ref = slash.arg.replace(/^resume\s*/, "").trim() || "last";
+                    const s = resolveSessionId(host.config.workdir, ref);
+                    if (!s)
+                        return notice(`session not found: ${ref} — bare /sessions lists saved ones`, "error");
+                    if (host.isRunning?.())
+                        return notice("agent is running — wait or Esc first", "warn");
+                    if (host.resumeAndRun) {
+                        await host.resumeAndRun(s);
+                        return;
+                    }
+                    notice(`resumed session ${s.id.slice(0, 8)}`);
+                    return;
+                }
+                notice(formatSessions(listSessions(host.config.workdir)));
+            },
+        },
+    ];
+}
+/** Clone config với permissionMode mới (host.config thay thế được). */
+function withPermissionMode(cfg, mode) {
+    return { ...cfg, permissionMode: mode };
+}
+/**
+ * Dispatch một input qua registry. Trả về {handled:false} khi không phải
+ * slash command. Frontend xử lý command riêng (TUI: /review /undo /theme
+ * /diff; REPL: không có) TRƯỚC khi gọi hàm này.
+ */
+export async function dispatchCommand(input, host, notice, extra = []) {
+    const m = /^\/([a-zA-Z][a-zA-Z0-9]*)(?:\s+(.*\S))?\s*$/.exec(input.trim());
+    if (!m)
+        return { handled: false, outcome: null };
+    const cmd = "/" + m[1].toLowerCase();
+    const arg = m[2] ?? "";
+    const slash = { cmd, arg };
+    if (cmd === "/exit" || cmd === "/quit")
+        return { handled: true, outcome: { quit: true } };
+    if (cmd === "/clear") {
+        host.agent()?.abort();
+        host.replaceAgent(null);
+        return { handled: true, outcome: { notice: "conversation cleared — context reset" } };
+    }
+    const entry = [...extra, ...coreCommands()].find((c) => c.name === cmd);
+    if (!entry) {
+        notice(`unknown command ${cmd} — try /help`, "error");
+        return { handled: true, outcome: {} };
+    }
+    let outcome;
+    try {
+        outcome = await entry.run(slash, host, notice);
+    }
+    catch (err) {
+        notice(err.message, "error");
+        return { handled: true, outcome: {} };
+    }
+    return { handled: true, outcome: outcome ?? {} };
+}