s-app-scoder-agent 0.9.9 → 0.9.14

package/.scoderrc.example.json

@@ -38,6 +38,8 @@
   "verifyCache": true,
   "localProfile": true,
 
+  "warmup": true,
+
   "mcpTools": {
     "include": [],
     "exclude": ["mcp__github-mcp__*notifications*", "mcp__github-mcp__*codespaces*"]

package/README.md

@@ -395,7 +395,7 @@ Features:
 - **Slash commands** — `/help`, `/clear`, `/compact`, `/cost`, `/model`, `/skill`, `/mcp`, `/permission` (identical to the REPL; `/theme` is TUI-only)
 - **Multi-turn** — keep typing follow-ups after a task finishes; the conversation context carries over (same as the REPL)
 - **Scrollback** — `PgUp`/`PgDn` page in 0.8-viewport steps, `Home`/`End` jump to top/bottom, `Esc` returns to the live tail (press again to abort); rendering is capped at the last 200 items for smooth scrolling on long runs
-- **Keybinds** — `Enter` send · `PgUp`/`PgDn` scroll · `Esc` reset scroll / abort · `Ctrl+C` quit
+- **Keybinds** — `Enter` send · `PgUp`/`PgDn` scroll · `Esc` reset scroll / abort · `Ctrl+O` toggle select mode (releases mouse tracking so you can drag-highlight chat text and copy it with `⌘C`/`Ctrl+C`) · `Ctrl+C` quit
 - Non-TTY environments (CI, pipes) automatically fall back to the classic REPL
 - `permission: "ask"` is not supported in the TUI (no readline prompts on the alt screen) — it falls back to `auto`
 

package/dist/agent/guardrails.js

@@ -167,6 +167,23 @@ const continueNudgeRule = { name: "continue-nudge",
             return null;
         if (claimsCompletion(ctx.text))
             return null; // completion-claim rule phụ trách
+        // P0-8: text-only + không sửa file + không có plan mở ⇒ đây là LƯỢT CHAT.
+        // Finish ngay với chính text làm summary — trước đây rule này inject nudge
+        // ⇒ thêm 1 LLM call ~14,5k token mỗi câu chào (đo: call 2 in=14.569, chỉ
+        // thêm đúng dòng nudge 81 token). Bài học aec95ef giữ nguyên: nhánh CÓ
+        // sửa file vẫn nudge/ép build bên dưới; plan còn mở (model nghỉ giữa
+        // task, quên gọi tool) cũng vẫn nudge.
+        if (!ctx.filesModified && ctx.planOpen !== true) {
+            return {
+                action: {
+                    kind: "finish",
+                    success: true,
+                    summary: ctx.text || "(agent replied without acting)",
+                    chatOnly: true,
+                },
+                reason: "chat turn: tool-less step, no files modified, no open plan — one LLM call per message",
+            };
+        }
         // No file changed yet → never demand a build for what may be a pure Q&A or
         // an explanation-only answer. Give the model the explicit conversational
         // exit instead; text-only-streak still ends the run if it keeps stalling.

package/dist/agent/interaction.js

@@ -21,15 +21,22 @@ export class InteractionBroker {
     async awaitQuestion(runtime, request, id, handler) {
         try {
             const timeoutMs = (request.timeoutSecs ?? 120) * 1000;
-            const answer = await Promise.race([
-                handler({ ...request, id }),
-                new Promise((resolve) => setTimeout(() => resolve(null), timeoutMs)),
-            ]);
-            if (answer == null || (typeof answer === "string" && !answer.trim())) {
-                return { ok: false, output: "ERROR: ask_user timed out or was cancelled." };
+            let timer;
+            const timeoutPromise = new Promise((resolve) => {
+                timer = setTimeout(() => resolve(null), timeoutMs);
+            });
+            try {
+                const answer = await Promise.race([handler({ ...request, id }), timeoutPromise]);
+                if (answer == null || (typeof answer === "string" && !answer.trim())) {
+                    return { ok: false, output: "ERROR: ask_user timed out or was cancelled." };
+                }
+                runtime.logger.log({ type: "ask_user", question: request.question, answer: String(answer).slice(0, 500) });
+                return { ok: true, output: `User answered: ${answer}` };
+            }
+            finally {
+                if (timer)
+                    clearTimeout(timer);
             }
-            runtime.logger.log({ type: "ask_user", question: request.question, answer: String(answer).slice(0, 500) });
-            return { ok: true, output: `User answered: ${answer}` };
         }
         catch (err) {
             return { ok: false, output: `ERROR: ask_user failed: ${err.message.slice(0, 200)}` };

package/dist/agent/prompt-context.js

@@ -19,7 +19,12 @@ export function buildRunMessages(input) {
     const { config, primaryDef, skills, buildCmd, task, pendingContext } = input;
     const skillsBlock = buildSkillsBlock(skills);
     const agentsGuideBlock = buildAgentGuideBlock(config.workdir, task);
-    const repoMapBlock = config.repoMap === false ? "" : `\n\n${buildRepoMap(config.workdir)}`;
+    // P0-10: REPO MAP rời khỏi system prompt. Map mô tả TRẠNG THÁI repo — mỗi
+    // byte đổi (file mới, tên symbol đổi) làm lệch prefix system+tools ở token
+    // ~954 ⇒ mọi cửa sổ mới mất 96% KV-cache (đo: cached 14.484 → 0, TTFT
+    // 0,2 s → 30–47 s). Đặt làm message sát task: prefix system+tools+junk byte
+    // stable giữa các cửa sổ, map (cold) chỉ còn là đuôi ~2k token.
+    const repoMapBlock = config.repoMap === false ? "" : buildRepoMap(config.workdir);
     const baseOverride = primaryDef?.prompt?.trim() ? primaryDef.prompt : undefined;
     return [
         {
@@ -31,12 +36,20 @@ export function buildRunMessages(input) {
                 skillsBlock,
                 mcpBlock: buildMcpBlock(config),
                 agentsGuideBlock,
-                repoMapBlock,
+                repoMapBlock: "",
                 base: baseOverride,
                 promptVersion: config.promptVersion,
             }) + buildAgentsBlock(discoverAgents(config.workdir), config.allowSubagents !== false),
         },
         ...pendingContext.map((content) => ({ role: "user", content })),
+        ...(repoMapBlock
+            ? [{
+                    role: "user",
+                    content: "[Context — repository map as of session start; paths + exported symbols only. " +
+                        "If a file looks missing or stale, confirm with list_files/glob/repo_map rather than assume.]\n\n" +
+                        repoMapBlock,
+                }]
+            : []),
         { role: "user", content: task },
     ];
 }
@@ -75,6 +88,11 @@ export class PromptContext {
     clearPendingTools() {
         this.pendingAllowedTools = null;
     }
+    /** Non-destructive read — warm-up dựng đúng messages như run() nhưng KHÔNG
+     *  tiêu thụ pending context (nó thuộc về run thật, take là mất). */
+    peekPendingContext() {
+        return [...this.pendingContext];
+    }
     takePendingContext() {
         const pending = this.pendingContext;
         this.pendingContext = [];

package/dist/agent/run-loop.js

@@ -246,6 +246,9 @@ export async function runAgentLoop(runtime, startSteps, buildCmd, initialBuild =
             buildCallPresent: !!buildCall,
             filesModified: runtime.filesModified,
             chatDone,
+            // P0-8: plan chưa xong ⇒ bước text-only chỉ là nghỉ giữa task (nudge);
+            // plan trống/đủ ⇒ rule coi đó là lượt chat và finish (1 call).
+            planOpen: runtime.plan.some((t) => t.status !== "completed"),
             outputTokensThisStep: usage?.completion_tokens,
             totalTokensIn: runtime.usageTotals.inputTokens, // G6 budget rule
             totalTokensOut: runtime.usageTotals.outputTokens,

package/dist/agent.js

@@ -1,4 +1,4 @@
-import { loadPermissionLists, loadPolicyRules, loadSavedApprovals } from "./config/config.js";
+import { loadPermissionLists, loadPolicyRules, loadSavedApprovals, adaptiveToolOutputChars } from "./config/config.js";
 import { LlmClient, LlmError, redactSecrets } from "./llm/llm.js";
 import { AnthropicClient } from "./llm/provider-anthropic.js";
 import { allToolSpecs } from "./tools/registry.js";
@@ -33,6 +33,12 @@ import { runAgentLoop } from "./agent/run-loop.js";
 // CHAT_DONE_MARKER import từ guardrails.js (marker chat thuần, rule 9).
 import { EVENT_SCHEMA_VERSION, applyToolFilter, resolvePrimaryConfig, } from "./agent/types.js";
 export { EVENT_SCHEMA_VERSION, resolvePrimaryConfig } from "./agent/types.js";
+/**
+ * FILE-READ-PERF P3: nhịp heartbeat re-warm khi idle — 4' < TTL cache ~5'
+ * (Anthropic ephemeral / Ollama keep_alive mặc định), để prefix không bao giờ
+ * nguội trong lúc session còn mở.
+ */
+export const WARMUP_IDLE_REFRESH_MS = 240_000;
 export class Agent {
     /** v2 event schema: stable id for the run — links agent_start/agent_end. */
     id = randomUUID();
@@ -89,6 +95,25 @@ export class Agent {
     /** v2: build no-progress tracking — same failure signature twice → escalate. */
     lastVerifySignature = "";
     verifyStrikes = 0;
+    /**
+     * WARMUP (plan/WARMUP-PLAN.md): request prefill nền — dựng đúng prefix
+     * system+tools mà lượt thật sẽ gửi, max_tokens=1, vứt response. Null khi
+     * chưa trigger; `settled` sau khi LLM request kết thúc (thành công/abort/lỗi).
+     */
+    warmupRun = null;
+    /** True after dispose() — warm-up không được để MCP server con mọc lại. */
+    disposed = false;
+    /**
+     * FILE-READ-PERF P3 (plan/FILE-READ-PERF-PLAN.md): heartbeat re-warm khi idle —
+     * engine local có keep_alive ~5', model unload thì lượt kế trả 35–56s cold
+     * prefill (đo thật). Timer chạy CHỈ lúc nhàn rỗi (settleWarmup tắt, finish()
+     * bật lại), unref để không giữ process. CHỈ cho baseUrl loopback.
+     */
+    warmupIdleTimer = null;
+    /** True nếu frontend này THỰC sự dùng warm-up (REPL/TUI) — serve/run-once không heartbeat. */
+    warmupUsed = false;
+    /** Test knob: thu ngắn nhịp heartbeat (default WARMUP_IDLE_REFRESH_MS). */
+    warmupIdleRefreshMs = WARMUP_IDLE_REFRESH_MS;
     /** v2: ask_user plumbing (frontends register handlers; serve → not-interactive). */
     /** Guardrail Engine — khởi tạo trong constructor (cần this.config). */
     guardrails;
@@ -411,7 +436,7 @@ export class Agent {
                     const servers = rc.mcpServers ?? {};
                     this.config.mcpServers = servers;
                     if (this.mcp) {
-                        void this.mcp.applyConfig(servers);
+                        void this.mcp.applyConfig(servers).catch(() => { });
                     }
                 }
             });
@@ -424,6 +449,8 @@ export class Agent {
     abort() {
         this.aborted = true;
         this.runSignal.abort(new DOMException("interrupted by user", "AbortError"));
+        // WARMUP: SIGINT giết luôn request prefill nếu còn chạy nền.
+        this.warmupRun?.abort.abort(new DOMException("interrupted by user", "AbortError"));
     }
     /**
      * Steer: user input delivered at the NEXT safe step boundary (pattern from
@@ -848,8 +875,10 @@ export class Agent {
      * server tự cắt history, và mỗi lần nó cắt là một lần mất KV-cache.
      */
     async applyContextProbe() {
-        if (this.config.contextWindow)
+        if (this.config.contextWindow) {
+            this.applyAdaptiveReadBudget();
             return;
+        }
         let probe = null;
         try {
             // Server local vẫn có thể bật --api-key: /props trả 401 nếu không gửi
@@ -875,11 +904,184 @@ export class Agent {
         if (probe.tokens !== catalog) {
             this.reporter.info(`context window: ${probe.tokens} token (${probe.detail}) — thay fallback ${catalog} token, compaction/trim tính theo số này`);
         }
+        this.applyAdaptiveReadBudget();
+    }
+    /**
+     * FILE-READ-PERF (plan/FILE-READ-PERF-PLAN.md) P1: nới ngân sách một lần đọc
+     * theo window THẬT khi local + user không đặt tường minh. Chạy một lần; giá
+     * trị ghi cả vào config.limits (safety-net ở tool-executor) lẫn module budget
+     * mà read-file.ts cắt theo. Probe thất bại (không có window) → giữ floor cũ.
+     */
+    readBudgetAdapted = false;
+    applyAdaptiveReadBudget() {
+        if (this.readBudgetAdapted)
+            return;
+        const window = this.config.contextWindow;
+        if (!window || !isLocalBaseUrl(this.config.baseUrl) || this.config.localProfile === false)
+            return;
+        if (this.config.limits?.toolOutputChars !== undefined)
+            return; // user thắng, không đụng
+        const budget = adaptiveToolOutputChars(window);
+        this.config.limits = { ...this.config.limits, toolOutputChars: budget };
+        setMaxToolOutputChars(budget);
+        this.readBudgetAdapted = true;
+        this.logger.log({ type: "read_budget", chars: budget, window });
     }
     /** Rebuild built-in and connected MCP tool specs for the current skill scope. */
     rebuildToolList() {
         rebuildMcpToolList(this.mcpBridgeRuntime());
     }
+    /**
+     * WARMUP (plan/WARMUP-PLAN.md): prefill prefix system+tools NỀN ngay khi mở
+     * session, để lượt chat đầu không phải trả cold-load + 20–60k token prefill
+     * trên đường tới token đầu (đo: 30–120s trên máy cá nhân, xem P2-3). One-shot,
+     * idempotent, fire-and-forget — lỗi im lặng (best-effort).
+     * `rewarm` (FILE-READ-PERF P3): bản heartbeat — bỏ guard "chưa có messages",
+     * tiền đề là entry trước đã settle.
+     */
+    warmup(opts = {}) {
+        const w = this.warmupRun;
+        if (w && (!w.settled || !opts.rewarm))
+            return w.promise;
+        if (this.config.warmup === false)
+            return Promise.resolve();
+        // aborted chỉ chặn warm KHỞI ĐẦU; heartbeat sống lại sau lượt kế (resetRunSignal).
+        if (this.disposed || (this.aborted && !opts.rewarm))
+            return Promise.resolve();
+        if (!opts.rewarm && this.messages.length > 0)
+            return Promise.resolve();
+        if (!this.config.apiKey)
+            return Promise.resolve();
+        // I-12: harness eval thay client bằng scripted transcript — warm-up sẽ ăn
+        // mất một lượt kịch bản, làm hỏng mọi assertion đếm request.
+        if (this.config.clientFactory)
+            return Promise.resolve();
+        const abort = new AbortController();
+        const entry = { abort, settled: false, promise: Promise.resolve() };
+        this.warmupUsed = true;
+        entry.promise = this.runWarmup(abort.signal, () => {
+            entry.settled = true;
+        }, opts.rewarm === true);
+        this.warmupRun = entry;
+        return entry.promise;
+    }
+    async runWarmup(signal, settle, rewarm = false) {
+        const t0 = Date.now();
+        try {
+            // Dời hai việc network ra khỏi đường tới token đầu. run() vẫn gọi lại
+            // nguyên như cũ — cả hai đều return sớm khi đã hoàn tất ở đây.
+            await Promise.allSettled([this.applyContextProbe(), this.connectMcp()]);
+            if (signal.aborted || this.disposed)
+                return;
+            // FILE-READ-PERF P3: heartbeat sau khi đã chạy ≥1 lượt thật gửi lại
+            // HISTORY THẬT — đó mới là prefix của lượt kế tiếp (placeholder sẽ phân
+            // nhánh ngay sau system). Trước lượt đầu: dựng đúng messages như run().
+            const hasHistory = this.messages.length > 0;
+            // Tool list + messages dựng ĐÚNG như run() — cache-key (Anthropic
+            // breakpoint, prefix KV của llama.cpp) là từng byte JSON của schema.
+            const pendingAllowedTools = this.promptContext.pendingTools();
+            const allow = pendingAllowedTools?.length
+                ? new Set(pendingAllowedTools.map((t) => t.toLowerCase()))
+                : null;
+            let baseTools = applyToolFilter(allToolSpecs(), this.primaryDef, this.reporter);
+            if (allow)
+                baseTools = baseTools.filter((s) => allow.has(s.function.name.toLowerCase()));
+            const mcpSpecs = governedMcpSpecs(this.mcpBridgeRuntime());
+            const tools = allow
+                ? [...baseTools, ...mcpSpecs.filter((s) => allow.has(s.function.name.toLowerCase()))]
+                : [...baseTools, ...mcpSpecs];
+            const messages = hasHistory
+                ? this.messages
+                : buildRunMessages({
+                    config: this.config,
+                    primaryDef: this.primaryDef,
+                    skills: this.promptContext.getSkills(),
+                    buildCmd: this.buildCmd,
+                    // Placeholder KHÔNG mention file nào: system prompt trùng byte với
+                    // request thật ở mọi task không có focus-file guide (xem plan §7).
+                    task: "[warmup]",
+                    pendingContext: this.promptContext.peekPendingContext(),
+                });
+            const res = await this.client.chat(messages, tools, { signal, maxTokens: 1 });
+            this.logger.log({
+                type: "warmup",
+                ok: true,
+                rewarm,
+                ms: Date.now() - t0,
+                model: this.client.model,
+                promptTokens: res.usage?.prompt_tokens,
+                cachedTokens: res.usage?.cached_tokens,
+            });
+        }
+        catch (err) {
+            // Warm-up không bao giờ được làm hỏng run thật — kể cả SIGINT abort.
+            this.logger.log({
+                type: "warmup",
+                ok: false,
+                ms: Date.now() - t0,
+                error: (err?.message ?? String(err)).slice(0, 200),
+            });
+        }
+        finally {
+            settle();
+            // dispose() chạy giữa chừng: kill lại MCP servers mà connectMcp của
+            // warm-up vừa spawn (killAll của dispose đã chạy TRƯỚC khi chúng mọc).
+            if (this.disposed)
+                this.shutdownMcp();
+            // FILE-READ-PERF P3: cycle warm kết thúc TỰ NHIÊN (không bị supersede/
+            // abort) → arm nhịp heartbeat tiếp theo. Bị abort nghĩa là run thật đang
+            // chạy — finish() sẽ arm lại khi xong.
+            else if (!signal.aborted)
+                this.scheduleWarmupRefresh();
+        }
+    }
+    /**
+     * Đầu mọi run thật (run/runTurn/resume): lượt thật thắng warm-up — abort
+     * request prefill nếu còn treo, rồi await cho settle để connectMcp/probe
+     * không double-spawn server con song song với chính nó.
+     */
+    async settleWarmup() {
+        // Run thật bắt đầu → heartbeat phải im lặng (timer re-arm ở finish()).
+        this.clearWarmupTimer();
+        const w = this.warmupRun;
+        if (!w)
+            return;
+        if (!w.settled)
+            w.abort.abort(new DOMException("real run supersedes warmup", "AbortError"));
+        await w.promise.catch(() => { });
+    }
+    /** Tắt heartbeat idle (run thật vào / dispose). */
+    clearWarmupTimer() {
+        if (this.warmupIdleTimer) {
+            clearTimeout(this.warmupIdleTimer);
+            this.warmupIdleTimer = null;
+        }
+    }
+    /**
+     * FILE-READ-PERF P3: arm lại nhịp re-warm — chỉ khi engine local và bộ máy
+     * warmup còn bật (đúng các guard của warmup()). unref(): timer không được
+     * giữ process sống (run-once/test thoát sạch).
+     */
+    scheduleWarmupRefresh() {
+        if (this.disposed || !this.warmupUsed)
+            return;
+        if (this.config.warmup === false || !this.config.apiKey || this.config.clientFactory) {
+            this.clearWarmupTimer();
+            return;
+        }
+        // KHÔNG phải local (kể cả /model đổi từ local → cloud giữa session): tắt
+        // heartbeat đang arm — không đốt tiền API để giữ cache.
+        if (!isLocalBaseUrl(this.config.baseUrl)) {
+            this.clearWarmupTimer();
+            return;
+        }
+        this.clearWarmupTimer();
+        this.warmupIdleTimer = setTimeout(() => {
+            this.warmupIdleTimer = null;
+            void this.warmup({ rewarm: true }).catch(() => { });
+        }, this.warmupIdleRefreshMs);
+        this.warmupIdleTimer.unref();
+    }
     /**
      * Disconnect MCP servers when the agent is disposed — connections are kept
      * alive for the whole agent/session lifetime (one "connected" line, no
@@ -891,8 +1093,13 @@ export class Agent {
     }
     /** M4: đóng hot-reload watcher (khi agent bị hủy vĩnh viễn). */
     dispose() {
+        this.disposed = true;
+        this.clearWarmupTimer();
         this.watcher?.close();
         this.watcher = null;
+        // WARMUP: hủy request prefill đang chạy (chặn MCP servers connect thêm
+        // sau khi kill — runWarmup tự shutdownMcp lần cuối trong finally).
+        this.warmupRun?.abort.abort(new DOMException("agent disposed", "AbortError"));
         this.shutdownMcp();
     }
     /**
@@ -934,6 +1141,8 @@ export class Agent {
         if (!this.config.apiKey) {
             throw new Error("No API key configured. Set SCODER_API_KEY or OPENAI_API_KEY (or put apiKey in .scoderrc.json).");
         }
+        // WARMUP: lượt thật thắng request prefill đang chạy nền (xem warmup()).
+        await this.settleWarmup();
         const buildCmd = this.buildCmd;
         const rawTask = task;
         // @file mention expansion — task trước khi build messages.
@@ -974,6 +1183,8 @@ export class Agent {
         else {
             this.tools = [...baseTools, ...mcpSpecs];
         }
+        // Tool list (re)built for this run — previous calibration no longer valid.
+        this.measuredFixedTokens = null;
         this.messages = buildRunMessages({
             config: this.config,
             primaryDef: this.primaryDef,
@@ -1025,6 +1236,9 @@ export class Agent {
         if (this.messages.length === 0) {
             return this.run(task);
         }
+        // WARMUP: thường đã settle ở run() đầu; await lại cho chắc (race /clear+
+        // warm-up + runTurn ngay lập tức).
+        await this.settleWarmup();
         const buildCmd = this.buildCmd;
         const rawTask = task;
         task = expandMentions(task, this.config.workdir);
@@ -1033,6 +1247,10 @@ export class Agent {
         this.resetUsageTotals();
         this.filesModified = false;
         this.plan = [];
+        this.runDiffs = [];
+        this.selfReviewDone = false;
+        this.verifyStrikes = 0;
+        this.lastVerifySignature = "";
         for (const content of this.promptContext.takePendingContext())
             this.messages.push({ role: "user", content });
         this.messages.push({ role: "user", content: task });
@@ -1049,6 +1267,9 @@ export class Agent {
      * An optional follow-up task is appended as a new user message.
      */
     async resume(session, followUp) {
+        // WARMUP: session restore mang system prompt RIÊNG (từ session cũ) — hủy
+        // request prefill của prompt mới để không nhân đôi prefill nền.
+        await this.settleWarmup();
         const buildCmd = this.buildCmd;
         this.sessionCreatedAt = session.createdAt;
         this.currentTask = session.task;
@@ -1325,6 +1546,8 @@ export class Agent {
                 : { ok: null, detail: "no verification command ran" };
         this.emit({ type: "finish", success, steps, summary: summary.slice(0, 2000), usage: this.getUsage(), verification });
         this.logger.log({ type: "finish", success, steps });
+        // FILE-READ-PERF P3: run kết thúc → session quay về nhàn rỗi, arm heartbeat.
+        this.scheduleWarmupRefresh();
         return { success, steps, buildCmd, summary: summary.slice(0, 2000) };
     }
 }

package/dist/cli/repl.js

@@ -12,6 +12,9 @@ export async function repl(cfg) {
     // every input is a follow-up turn, context carries over, saved continuously.
     // /clear swaps in a fresh Agent (the /clear branch reassigns this).
     let agent = new Agent(cfg);
+    // WARMUP (plan/WARMUP-PLAN.md): dựng MCP+probe+prefill system+tools nền
+    // trong lúc user còn đọc prompt — lệnh đầu không trả 30–120s cold prefill.
+    void agent.warmup();
     process.on("SIGINT", () => {
         ui.warn("\nSIGINT — aborting current task...");
         agent.abort();
@@ -37,6 +40,9 @@ export async function repl(cfg) {
                 agent.dispose();
                 agent = next ?? new Agent(cfg);
                 first = true;
+                // Agent mới = prefix mới (session id, repo state) — warm-up lại từ đầu.
+                // Với `next` đã có messages (resume) warmup() tự no-op.
+                void agent.warmup();
             },
         };
         const { handled, outcome } = await dispatchCommand(input, host, (text, level) => {

package/dist/config/config.js

@@ -68,11 +68,29 @@ export const LOCAL_PROFILE_DEFAULTS = {
     maxSteps: 24,
     /** P2-3: prefill 20–60k token trên máy cá nhân có thể vượt 120s → timeout + retry. */
     requestTimeoutMs: 600_000,
-    /** P0-2: history của MỘT tool result nhỏ hơn mặc định cloud (8k). */
-    toolOutputChars: 6_000,
+    /**
+     * FILE-READ-PERF P1: profile KHÔNG pin toolOutputChars nữa (trước là 6000) —
+     * ngân sách đọc giờ suy từ context window THẬT qua adaptiveToolOutputChars,
+     * apply ở cuối applyContextProbe (agent.ts). Window nhỏ vẫn ra 6000 như cũ.
+     */
     /** P0-3: trần token cho MCP schema; 46 tool GitHub MCP ≈ 12k token mỗi lượt. */
     mcpSchemaTokens: 6_000,
 };
+/**
+ * FILE-READ-PERF (plan/FILE-READ-PERF-PLAN.md) N1: một lần đọc file bị cắt
+ * thành 5–6 MẢNH vì budget 6000 ký tự, mà mỗi mảnh = một lượt LLM tròn
+ * (đo: 8–11s/mảnh với README 28KB). Nới budget theo window đã probe:
+ * 0.17 ký tự mỗi token window ≈ 4% history cho một tool result
+ * (4 chars ≈ 1 token) — window 16k giữ nguyên 6000, 96k lên trần 16000.
+ */
+export const TOOL_OUTPUT_WINDOW_SHARE = 0.17;
+export const TOOL_OUTPUT_CHARS_FLOOR = 6_000;
+export const TOOL_OUTPUT_CHARS_CEIL = 16_000;
+export function adaptiveToolOutputChars(windowTokens) {
+    if (!Number.isFinite(windowTokens) || windowTokens <= 0)
+        return TOOL_OUTPUT_CHARS_FLOOR;
+    return Math.min(TOOL_OUTPUT_CHARS_CEIL, Math.max(TOOL_OUTPUT_CHARS_FLOOR, Math.round(windowTokens * TOOL_OUTPUT_WINDOW_SHARE)));
+}
 /**
  * Áp mặc định phù hợp cho local engine. Trả về danh sách thay đổi đã áp (để
  * log/kiểm thử); rỗng khi không áp dụng (cloud, hoặc localProfile:false).
@@ -98,10 +116,8 @@ export function applyLocalProfile(cfg, explicit = {}) {
         limits.requestTimeoutMs = LOCAL_PROFILE_DEFAULTS.requestTimeoutMs;
         applied.push(`requestTimeoutMs=${LOCAL_PROFILE_DEFAULTS.requestTimeoutMs}`);
     }
-    if (limits.toolOutputChars === undefined) {
-        limits.toolOutputChars = LOCAL_PROFILE_DEFAULTS.toolOutputChars;
-        applied.push(`toolOutputChars=${LOCAL_PROFILE_DEFAULTS.toolOutputChars}`);
-    }
+    // FILE-READ-PERF P1: toolOutputChars KHÔNG pin ở đây nữa — để undefined để
+    // applyAdaptiveReadBudget nhận diện "user không đặt" và suy từ window.
     if (limits.mcpSchemaTokens === undefined) {
         limits.mcpSchemaTokens = LOCAL_PROFILE_DEFAULTS.mcpSchemaTokens;
         applied.push(`mcpSchemaTokens=${LOCAL_PROFILE_DEFAULTS.mcpSchemaTokens}`);
@@ -304,6 +320,7 @@ export function loadConfig(overrides = {}) {
         agent: overrides.agent ?? process.env.SCODER_AGENT ?? rc.agent,
         routing: rc.routing,
         repoMap: rc.repoMap,
+        warmup: rc.warmup,
         promptVersion: rc.promptVersion,
         verifyCmds: rc.verifyCmds,
         selfReview: rc.selfReview,

package/dist/context/prompt.js

@@ -259,6 +259,10 @@ export const PROMPT_SECTIONS = {
     tools: `## Tool policy
 - Orient with list_files / grep / glob / repo_map — prefer them over shell
   greps. read_file before every edit_file.
+- read_file: when a result ends with "N more line(s)", read the REST in ONE
+  step — issue several read_file calls with successive offset/limit covering
+  every remaining chunk at once (they run in parallel). Never re-read lines
+  you already have.
 - edit_file: old_string MUST appear exactly once — otherwise re-read the file
   and add more context.
 - run_command IS the build command: run it only when you changed files; a

package/dist/context/repo-map.js

@@ -104,19 +104,21 @@ export function extractSymbols(path, content) {
     return [...out].slice(0, MAX_SYMBOLS_PER_FILE);
 }
 // ── Rendering ────────────────────────────────────────────────────────────────
-function kb(size) {
-    return size >= 1024 * 1024 ? `${(size / 1024 / 1024).toFixed(1)}MB` : `${Math.max(1, Math.round(size / 1024))}KB`;
-}
-/** Render the map without touching the cache (used for sub-tree maps). */
+/** Render the map without touching the cache (used for sub-tree maps).
+ * P0-10: deliberately NO per-file sizes and NO file-count header — those bytes
+ * change on every edit/add and used to invalidate the KV-cache prefix of every
+ * fresh window (measured: 1 char in REPO MAP ⇒ cached=0, TTFT 30–47 s). Symbol
+ * names still change only when a file's exported API changes, so the map is
+ * byte-stable across normal coding. */
 export function renderRepoMap(workdir, budgetChars = DEFAULT_BUDGET_CHARS, sub = ".") {
     const files = walkRepo(workdir, sub);
     const lines = [
-        `REPO MAP — ${files.length} files (auto-generated; orient from this, don't read everything)`,
+        "REPO MAP — auto-generated; orient from this, don't read everything",
     ];
     let budget = budgetChars;
     let truncated = 0;
     for (const f of files) {
-        let line = `  ${f.rel} (${kb(f.size)})`;
+        let line = `  ${f.rel}`;
         if (SYMBOL_FILE.test(f.rel) && f.size <= MAX_FILE_BYTES) {
             try {
                 const syms = extractSymbols(f.rel, readFileSync(f.abs, "utf8"));

package/dist/llm/llm.js

@@ -169,7 +169,9 @@ export class LlmClient {
             messages: toWireMessages(messages),
             tools: tools.length > 0 ? tools : undefined,
             temperature: this.opts.temperature,
-            max_tokens: this.opts.maxTokens,
+            // WARMUP: override max_tokens cho request prefill (1 token là đủ để
+            // engine tính xong KV-cache của prefix) — lượt thật không truyền key này.
+            max_tokens: opts.maxTokens ?? this.opts.maxTokens,
             stream: false,
         });
         let res;

package/dist/llm/provider-anthropic.js

@@ -153,12 +153,12 @@ export class AnthropicClient {
         this.opts = { ...this.opts, model };
     }
     /** I-05: request body builder — shared by chat/streamChat. */
-    buildBody(system, messages, tools, stream) {
+    buildBody(system, messages, tools, stream, maxTokensOverride) {
         // Extended thinking: temperature must be 1 và thinking block format.
         const thinkingOn = (this.opts.thinkingBudgetTokens ?? 0) > 0;
         return JSON.stringify({
             model: this.opts.model,
-            max_tokens: this.opts.maxTokens,
+            max_tokens: maxTokensOverride ?? this.opts.maxTokens,
             temperature: thinkingOn ? 1 : this.opts.temperature,
             ...(thinkingOn ? { thinking: { type: "enabled", budget_tokens: this.opts.thinkingBudgetTokens } } : {}),
             system,
@@ -172,7 +172,9 @@ export class AnthropicClient {
         const { system, messages: translated } = toAnthropicMessages(messages);
         const { signal, cleanup } = combinedSignal(opts.signal, this.timeoutMs);
         const cached = this.applyCacheControl(system, translated, tools);
-        const body = this.buildBody(cached.system, cached.messages, cached.tools, false);
+        // WARMUP: override max_tokens cho request prefill — các breakpoint
+        // cache_control (tools + system) đã áp dụng y hệt lượt thật.
+        const body = this.buildBody(cached.system, cached.messages, cached.tools, false, opts.maxTokens);
         let res;
         try {
             res = await withRetry(async () => {

package/dist/llm/retry.js

@@ -32,6 +32,10 @@ export async function withRetry(fn, opts = {}, onRetry) {
         catch (err) {
             lastErr = err;
             const status = err.status;
+            // WARMUP: abort của CHÍNH caller (warm-up bị lượt thật supersede, SIGINT)
+            // không bao giờ được retry — message có thể là bất kỳ chuỗi nào.
+            if (err?.name === "AbortError")
+                throw err;
             const retryable = (typeof status === "number" && isRetryableStatus(status)) ||
                 (!(err instanceof NonRetryableError) && isRetryableNetworkError(err));
             // Client errors (except 429) — fail immediately

package/dist/mcp/manager.js

@@ -89,8 +89,8 @@ export class McpManager {
                     .listTools()
                     .then((defs) => this.reregisterTools(name, conn, defs))
                     .catch(() => { });
-                void this.refreshResources(name, conn);
-                void this.refreshPrompts(name, conn);
+                void this.refreshResources(name, conn).catch(() => { });
+                void this.refreshPrompts(name, conn).catch(() => { });
                 for (const uri of this.subscriptions.get(name) ?? []) {
                     void conn.subscribeResource(uri).catch(() => { });
                 }

package/dist/security/permissions.js

@@ -272,22 +272,29 @@ export class PermissionChecker {
             // T3: timeout enforced HERE (checker-level) — a hung frontend handler
             // (TUI modal never answered, server client disconnected) must not leak
             // the pending permission promise forever.
-            const answer = await Promise.race([
-                this.promptHandler(req),
-                new Promise((_, rej) => setTimeout(() => {
+            let timer;
+            const timeoutPromise = new Promise((_, rej) => {
+                timer = setTimeout(() => {
                     const e = new Error("permission handler timed out");
                     e.name = "AbortError";
                     rej(e);
-                }, req.timeoutSecs * 1000)),
-            ]);
-            if (answer === "quit")
-                this.abortRequested = true;
-            if (answer === "always" && req.kind === "edit")
-                this.allowAllEdits = true;
-            if (answer === "always" && req.kind === "shell" && req.alwaysAllowPrefix) {
-                this.sessionAllow.addPrefix(req.alwaysAllowPrefix);
+                }, req.timeoutSecs * 1000);
+            });
+            try {
+                const answer = await Promise.race([this.promptHandler(req), timeoutPromise]);
+                if (answer === "quit")
+                    this.abortRequested = true;
+                if (answer === "always" && req.kind === "edit")
+                    this.allowAllEdits = true;
+                if (answer === "always" && req.kind === "shell" && req.alwaysAllowPrefix) {
+                    this.sessionAllow.addPrefix(req.alwaysAllowPrefix);
+                }
+                return answer === "yes" || answer === "always";
+            }
+            finally {
+                if (timer)
+                    clearTimeout(timer);
             }
-            return answer === "yes" || answer === "always";
         }
         catch {
             return false; // handler error/timeout — deny
@@ -461,6 +468,19 @@ export class PermissionChecker {
                 };
             }
         }
+        // Command substitution $(...) / backticks can hide arbitrary commands inside
+        // an otherwise-allowed prefix (e.g. `echo $(rm -rf /)`). Treat as ask
+        // unless an explicit rule allows the whole command line.
+        if (scan?.ok && scan.hasCommandSubstitution) {
+            const e = matchRule(this.activeRules(), "shell", command);
+            if (e !== "allow") {
+                return {
+                    decision: "ask",
+                    reason: "command substitution ($() / backticks) — approval required",
+                    alwaysAllowPrefix: extractFirstWord(command) + " ",
+                };
+            }
+        }
         return this.classify(command);
     }
     /**

package/dist/tools/read-file.js

@@ -74,8 +74,10 @@ export function toolReadFile(workdir, args) {
         const header = offset > 1 || end < total ? `[lines ${offset}-${end} of ${total} — ${args.path}]\n` : "";
         const footer = dropped > 0
             ? `\n... [${dropped} more line(s): ${end + 1}-${offset + slice.length - 1} of ${total}. ` +
-                `Read the next chunk with read_file({"path":"${args.path}","offset":${end + 1}}) — ` +
-                `do NOT re-read from the start.]`
+                `Read the REST in ONE step — parallel read_file calls at ` +
+                `{"path":"${args.path}","offset":${end + 1}}, ` +
+                `{"path":"${args.path}","offset":${end + 1 + kept.length}}, ... ` +
+                `until the file is done; do NOT re-read from the start.]`
             : "";
         // clamp cho dòng kếch xù (một dòng 40k ký tự vẫn phải nằm trong ngân sách).
         const numbered = clamp(kept.join("\n"), budget);

package/dist/tools/run-command.js

@@ -116,23 +116,34 @@ export async function toolRunCommand(workdir, args, signal, onOutput, sandbox, r
             cwd: workdir,
             stdio: ["ignore", "pipe", "pipe"],
             env: buildChildEnv(workdir), // G3: allowlist — không kế thừa full process.env
+            // Own process group so killTree(-pid) can reap grandchildren (see killTree).
+            detached: process.platform !== "win32",
         });
+        let exited = false;
         let stdout = "";
         let stderr = "";
         let killedReason = null;
-        const killChild = (reason) => {
-            killedReason = reason;
+        // Linux/macOS: sh fork command con (sleep, make, npm…) rồi chết trước —
+        // kill mỗi `child` để chúng mồ côi, còn giữ PIPE => 'close' không bao giờ
+        // tới, tool treo, run không finish (fail CI serve-abort reproducibly).
+        // detached:true cho child một process group riêng -> kill cả nhóm qua -pid.
+        const killTree = (sig) => {
             try {
-                child.kill("SIGTERM");
+                if (process.platform !== "win32" && child.pid)
+                    process.kill(-child.pid, sig);
+                else
+                    child.kill(sig);
             }
-            catch { /* already dead */ }
-            // SIGKILL fallback if the process ignores SIGTERM
+            catch { /* already dead / group gone */ }
+        };
+        const killChild = (reason) => {
+            killedReason = reason;
+            killTree("SIGTERM");
+            // SIGKILL escalation — sh chết nhưng GRANDCHILD ignore TERM thì group
+            // vẫn sống; exitCode của bản thân sh không phản ánh điều đó, dùng `exited`.
             setTimeout(() => {
-                try {
-                    if (child.exitCode === null)
-                        child.kill("SIGKILL");
-                }
-                catch { /* already dead */ }
+                if (!exited)
+                    killTree("SIGKILL");
             }, 5_000).unref();
         };
         const timer = setTimeout(() => killChild("timeout"), timeoutMs);
@@ -156,34 +167,41 @@ export async function toolRunCommand(workdir, args, signal, onOutput, sandbox, r
         child.on("error", (err) => {
             finish({ ok: false, output: clamp(`${echoLine}\n(spawn error) ${err.message}`) });
         });
-        child.on("close", (code) => {
+        const buildResult = (code) => {
             if (killedReason === "timeout") {
-                finish({
+                return {
                     ok: false,
                     output: clamp(`${echoLine}\n(command timed out after ${Math.round(timeoutMs / 1000)}s and was killed)\n--- stdout ---\n${redactSecrets(stdout)}\n--- stderr ---\n${redactSecrets(stderr)}`),
-                });
-                return;
+                };
             }
             if (killedReason === "aborted") {
-                finish({
+                return {
                     ok: false,
                     output: clamp(`${echoLine}\n(interrupted by user)\n--- stdout ---\n${redactSecrets(stdout)}\n--- stderr ---\n${redactSecrets(stderr)}`),
-                });
-                return;
+                };
             }
             const status = code ?? -1;
             // G3: redact trước khi output vào conversation/log/TUI.
             const redacted = redactSecrets(stdout);
             const redactedErr = redactSecrets(stderr);
             if (status === 0) {
-                finish({ ok: true, output: clamp(`${echoLine}\n(exit 0)\n${redacted}`) });
-            }
-            else {
-                finish({
-                    ok: false,
-                    output: clamp(`${echoLine}\n(exit ${status})\n--- stdout ---\n${redacted}\n--- stderr ---\n${redactedErr}`),
-                });
+                return { ok: true, output: clamp(`${echoLine}\n(exit 0)\n${redacted}`) };
             }
+            return {
+                ok: false,
+                output: clamp(`${echoLine}\n(exit ${status})\n--- stdout ---\n${redacted}\n--- stderr ---\n${redactedErr}`),
+            };
+        };
+        // 'close' chờ EOF của pipe; grandchild lì (khác process group — hiếm, hoặc
+        // spawn của chính command) có thể giữ nó mở vĩnh viễn. Đã kill mà child
+        // exit rồi thì resolve ngay trên 'exit', đừng đợi close.
+        child.on("exit", (code) => {
+            exited = true;
+            if (killedReason)
+                finish(buildResult(code));
+        });
+        child.on("close", (code) => {
+            finish(buildResult(code));
         });
     });
 }

package/dist/tools/search.js

@@ -91,7 +91,14 @@ export function toolGrep(workdir, args) {
             // status >= 2 → rg error; fall through to grep fallback.
         }
         // Fallback: grep -rn (portable) — output already path:line:text.
+        // CI runners (ubuntu-latest) không có rg → đường này là mainstream, phải
+        // hỗ trợ include + skip noise dirs như rg; grep BSD không hiểu các cờ này
+        // sẽ exit ≥2 → rơi tiếp xuống jsGrepFallback (xử lý đúng, không mất sạch).
         const gArgs = ["-rn", "--binary-files=without-match", "-I", "-m", "5", "-e", pattern];
+        for (const d of SEARCH_SKIP)
+            gArgs.push(`--exclude-dir=${d}`);
+        if (args.include)
+            gArgs.push("--include", args.include);
         if (ctxBefore > 0)
             gArgs.push("-B", String(ctxBefore));
         if (ctxAfter > 0)

package/dist/tui/app.js

@@ -19,6 +19,7 @@ import { setQuiet } from "../io/terminal.js";
 import { discoverSkills } from "../context/skills.js";
 import { discoverAgents } from "../context/agents.js";
 import { initialState } from "./state.js";
+import { transcriptWindow, estimateTotalRows } from "./selectors.js";
 import { SLASH_COMMANDS, formatSlashHelp } from "../commands/definitions.js";
 import { ChatItemView } from "./chat-views.js"; // T2
 import { BuildRail, StatusBar, SIDEBAR_MIN_COLS, SIDEBAR_WIDTH } from "./chrome.js"; // T2
@@ -72,6 +73,8 @@ export function TuiApp({ config, initialTask }) {
     const [input, setInput] = useState(initialTask ?? "");
     /** Rows scrolled up from the bottom; 0 = follow the newest content. */
     const [scrollOffset, setScrollOffset] = useState(0);
+    /** Ctrl+O: native terminal text selection (mouse tracking released). */
+    const [selectMode, setSelectMode] = useState(false);
     const [permMode, setPermMode] = useState(cfg.permissionMode);
     // T-03: active permission prompt (modal) — the run blocks until answered.
     const [permPrompt, setPermPrompt] = useState(null);
@@ -95,13 +98,25 @@ export function TuiApp({ config, initialTask }) {
         agentRef.current?.dispose();
         agentRef.current = null;
     }, []);
-    // ── Scrollable chat viewport (Ink 8 alt-screen) ──
-    // The viewport clips overflow; the inner content wrapper keeps its natural
-    // height so it can be measured and offset upward for scrolling.
-    const { viewportRef, contentRef, viewport, content, viewportRowsRef } = useScrollMetrics(setScrollOffset);
-    const maxScroll = Math.max(0, content.height - viewport.clientHeight);
-    // scrollOffset counts rows UP from the bottom; 0 = follow the newest item.
-    const scrollTop = Math.max(0, maxScroll - scrollOffset);
+    // ── Scrollable chat viewport (Ink 8 alt-screen) — P1-8 virtualized ──
+    // Chi phí layout/wrap mỗi frame tỷ lệ với số item MOUNT, không phải số
+    // item transcript ⇒ chỉ mount cửa sổ quanh viewport (transcriptWindow).
+    // Scroll offset khi đọc lại dùng rows ước lượng; khi BÁM ĐÁY dùng chiều
+    // cao THẬT của cửa sổ đã mount (đo rẻ vì cửa sổ ~viewport+overscan) —
+    // estimate sai lệch bao nhiêu thì dòng cuối vẫn luôn thấy.
+    const { viewportRef, viewport, contentRef, content, viewportRowsRef } = useScrollMetrics(setScrollOffset, !selectMode);
+    const viewportRows = viewport.clientHeight || 24;
+    const win = useMemo(() => {
+        const total = estimateTotalRows(state.items);
+        const max = Math.max(0, total - viewportRows);
+        const top = Math.max(0, max - scrollOffset);
+        return { ...transcriptWindow(state.items, top, viewportRows), maxScroll: max };
+    }, [state.items, scrollOffset, viewportRows]);
+    const maxScroll = win.maxScroll;
+    // Follow-bottom (scrollOffset = 0): offset chính xác theo số đo thật.
+    const contentOffset = scrollOffset === 0 && content.hasMeasured
+        ? Math.max(0, content.height - viewport.clientHeight)
+        : win.offset;
     const skills = useMemo(() => discoverSkills(cfg.workdir), [cfg.workdir]);
     const skillNames = useMemo(() => skills.map((s) => s.name), [skills]);
     // T-02: completion sources (agents + files) computed once per mount.
@@ -141,8 +156,19 @@ export function TuiApp({ config, initialTask }) {
     useTuiKeybinds({
         scrollOffset, permPromptRef, setPermPrompt, agentRef, runningRef, sessionPickerOpen,
         setSessionPickerOpen, setPaletteOpen, inputRef, setHelpOpen, update, viewportRowsRef,
-        setScrollOffset, exit,
+        setScrollOffset, selectMode, setSelectMode, exit,
     });
+    // WARMUP (plan/WARMUP-PLAN.md): tạo agent + prefill prefix system+tools nền
+    // NGAY khi mở TUI — TTFT của câu chat đầu không còn phải trả cold-load model
+    // và 20–60k token prefill. Bỏ qua khi có initialTask (submit trả prefill ngay
+    // sau mount, warm-up chỉ nhân đôi việc — settleWarmup sẽ abort nó).
+    const warmupRef = useRef(false);
+    useEffect(() => {
+        if (initialTask || warmupRef.current)
+            return;
+        warmupRef.current = true;
+        void createAgent().warmup();
+    }, [initialTask]);
     // Submit an initial task passed on the command line once, after mount.
     const bootRef = useRef(false);
     useEffect(() => {
@@ -164,19 +190,20 @@ export function TuiApp({ config, initialTask }) {
             setScrollOffset(0);
         prevStatusRef.current = state.status;
     }, [state.status]);
-    // The viewport renders items at full height so scroll math (content.height) is
-    // always correct. Ink clips with overflow="hidden"; contentOffsetY shifts the
-    // content column upward to reveal items above the current bottom.
+    // P1-8: viewport mount CỬA SỔ item quanh scrollTop (transcriptWindow), không
+    // mount cả transcript — chi phí layout/wrap mỗi frame hết tỷ lệ với tổng text.
+    // Ink clip bằng overflow="hidden"; contentOffsetY = số dòng phải ẩn ở đầu
+    // cửa sổ (scrollTop - startRow[item_start]).
     const { rows, columns } = useWindowSize();
     const showSidebar = (columns ?? 100) >= SIDEBAR_MIN_COLS;
     return (
     // flexShrink={0}: pinned chrome must never be squeezed when the chat
     // content overflows — Ink defaults every box to flexShrink:1, which
     // shrank the input bar to zero rows once the log outgrew the terminal.
-    _jsxs(Box, { flexDirection: "column", height: rows || 24, flexShrink: 0, children: [_jsx(BuildRail, { state: state, config: cfg }), _jsxs(Box, { flexDirection: "row", flexGrow: 1, flexShrink: 1, minHeight: 0, children: [_jsx(Box, { ref: viewportRef, flexDirection: "column", flexGrow: 1, flexShrink: 1, minHeight: 0, overflow: "hidden", contentOffsetY: scrollTop, children: _jsxs(Box, { ref: contentRef, flexDirection: "column", paddingX: 1, flexShrink: 0, children: [state.items.length === 0 ? (
+    _jsxs(Box, { flexDirection: "column", height: rows || 24, flexShrink: 0, children: [_jsx(BuildRail, { state: state, config: cfg }), _jsxs(Box, { flexDirection: "row", flexGrow: 1, flexShrink: 1, minHeight: 0, children: [_jsx(Box, { ref: viewportRef, flexDirection: "column", flexGrow: 1, flexShrink: 1, minHeight: 0, overflow: "hidden", contentOffsetY: contentOffset, children: _jsxs(Box, { ref: contentRef, flexDirection: "column", paddingX: 1, flexShrink: 0, children: [state.items.length === 0 ? (
                                 // Welcome: căn giữa cả 2 chiều — height = chiều cao đo được của
                                 // viewport (flexGrow không giãn được vì content box flexShrink=0).
-                                _jsxs(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", height: viewport.clientHeight || undefined, children: [(columns ?? 100) - (showSidebar ? SIDEBAR_WIDTH + 2 : 4) >= 54 ? (_jsx(Box, { flexDirection: "column", alignItems: "center", children: (isAsciiMode() ? BANNER_ASCII : BANNER).map((line, i) => (_jsx(Text, { bold: true, color: theme.brand, children: line }, i))) })) : (_jsx(Text, { bold: true, color: theme.brand, children: "\u2691 SCoder" })), _jsx(Text, { dimColor: true, children: `autonomous coding agent · v${getVersion()}` }), _jsx(Text, {}), _jsx(Text, { dimColor: true, children: "type a task to start \u2014 the agent plans, edits, and builds" }), _jsx(Text, {}), _jsxs(Text, { children: [_jsx(Text, { bold: true, color: theme.accent, children: "\u23CE" }), _jsx(Text, { dimColor: true, children: " send   " }), _jsx(Text, { bold: true, color: theme.accent, children: "ctrl+s" }), _jsx(Text, { dimColor: true, children: " sessions   " }), _jsx(Text, { bold: true, color: theme.accent, children: "tab" }), _jsx(Text, { dimColor: true, children: " complete   " }), _jsx(Text, { bold: true, color: theme.accent, children: "/help" }), _jsx(Text, { dimColor: true, children: " commands" })] })] })) : (state.items.map((item, i) => _jsx(ChatItemView, { item: item, width: (columns ?? 100) - (showSidebar ? SIDEBAR_WIDTH + 2 : 4) }, i))), lastSummary && (_jsx(Box, { marginTop: 1, children: state.status === "success" ? (_jsxs(Text, { color: theme.success, bold: true, children: ["\u2714 ", lastSummary] })) : state.status === "aborted" ? (_jsxs(Text, { color: theme.warn, bold: true, children: ["\u23F9 ", lastSummary] })) : (_jsxs(Text, { color: theme.error, bold: true, children: ["\u2718 ", lastSummary] })) }))] }) }), showSidebar && _jsx(Sidebar, { state: state, config: cfg, rows: viewport.clientHeight || undefined })] }), sessionPickerOpen && (_jsx(SessionPicker, { workdir: cfg.workdir, onSelect: handleSessionSelect, onClose: () => setSessionPickerOpen(false) })), paletteOpen && (_jsxs(Box, { flexDirection: "column", borderStyle: boxBorderStyle(), borderColor: theme.accent, paddingX: 1, paddingY: 1, children: [_jsx(Text, { color: theme.accent, bold: true, children: "Command palette (Ctrl+P to close)" }), SLASH_COMMANDS.slice(0, 40).map((c) => (_jsxs(Text, { children: [c.cmd.padEnd(12), " ", c.desc] }, c.cmd)))] })), helpOpen && (_jsxs(Box, { flexDirection: "column", borderStyle: boxBorderStyle(), borderColor: theme.dim, paddingX: 1, paddingY: 1, children: [_jsx(Text, { color: theme.brand, bold: true, children: "Help (?)" }), _jsx(Text, { children: formatSlashHelp("scoder tui") })] })), permPrompt && _jsx(PermissionModal, { prompt: permPrompt }), _jsx(Box, { paddingX: 1, paddingTop: 0, paddingBottom: 0, flexShrink: 0, alignSelf: "stretch", children: _jsx(Input, { valueRef: inputRef, value: input, onChange: writeInput, onSubmit: (v) => void submit(v), historyRef: historyRef, skillNames: skillNames, agentRef: agentRef, config: cfg, atSources: atSources, modalRef: permPromptRef }) }), _jsx(StatusBar, { state: state, scroll: scrollOffset > 0 ? `↑ ${Math.min(scrollOffset, maxScroll)}/${maxScroll}` : null })] }));
+                                _jsxs(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", height: viewport.clientHeight || undefined, children: [(columns ?? 100) - (showSidebar ? SIDEBAR_WIDTH + 2 : 4) >= 54 ? (_jsx(Box, { flexDirection: "column", alignItems: "center", children: (isAsciiMode() ? BANNER_ASCII : BANNER).map((line, i) => (_jsx(Text, { bold: true, color: theme.brand, children: line }, i))) })) : (_jsx(Text, { bold: true, color: theme.brand, children: "\u2691 SCoder" })), _jsx(Text, { dimColor: true, children: `autonomous coding agent · v${getVersion()}` }), _jsx(Text, {}), _jsx(Text, { dimColor: true, children: "type a task to start \u2014 the agent plans, edits, and builds" }), _jsx(Text, {}), _jsxs(Text, { children: [_jsx(Text, { bold: true, color: theme.accent, children: "\u23CE" }), _jsx(Text, { dimColor: true, children: " send   " }), _jsx(Text, { bold: true, color: theme.accent, children: "ctrl+s" }), _jsx(Text, { dimColor: true, children: " sessions   " }), _jsx(Text, { bold: true, color: theme.accent, children: "tab" }), _jsx(Text, { dimColor: true, children: " complete   " }), _jsx(Text, { bold: true, color: theme.accent, children: "/help" }), _jsx(Text, { dimColor: true, children: " commands" })] }), _jsxs(Text, { children: [_jsx(Text, { bold: true, color: theme.accent, children: "ctrl+o" }), _jsx(Text, { dimColor: true, children: " select/copy (t\u1EAFt mouse tracking \u0111\u1EC3 t\u00F4 \u0111en k\u00E9o chu\u1ED9t)" })] })] })) : (state.items.slice(win.start, win.end).map((item, i) => (_jsx(ChatItemView, { item: item, width: (columns ?? 100) - (showSidebar ? SIDEBAR_WIDTH + 2 : 4) }, win.start + i)))), lastSummary && (_jsx(Box, { marginTop: 1, children: state.status === "success" ? (_jsxs(Text, { color: theme.success, bold: true, children: ["\u2714 ", lastSummary] })) : state.status === "aborted" ? (_jsxs(Text, { color: theme.warn, bold: true, children: ["\u23F9 ", lastSummary] })) : (_jsxs(Text, { color: theme.error, bold: true, children: ["\u2718 ", lastSummary] })) }))] }) }), showSidebar && _jsx(Sidebar, { state: state, config: cfg, rows: viewport.clientHeight || undefined })] }), sessionPickerOpen && (_jsx(SessionPicker, { workdir: cfg.workdir, onSelect: handleSessionSelect, onClose: () => setSessionPickerOpen(false) })), paletteOpen && (_jsxs(Box, { flexDirection: "column", borderStyle: boxBorderStyle(), borderColor: theme.accent, paddingX: 1, paddingY: 1, children: [_jsx(Text, { color: theme.accent, bold: true, children: "Command palette (Ctrl+P to close)" }), SLASH_COMMANDS.slice(0, 40).map((c) => (_jsxs(Text, { children: [c.cmd.padEnd(12), " ", c.desc] }, c.cmd)))] })), helpOpen && (_jsxs(Box, { flexDirection: "column", borderStyle: boxBorderStyle(), borderColor: theme.dim, paddingX: 1, paddingY: 1, children: [_jsx(Text, { color: theme.brand, bold: true, children: "Help (?)" }), _jsx(Text, { children: formatSlashHelp("scoder tui") })] })), permPrompt && _jsx(PermissionModal, { prompt: permPrompt }), _jsx(Box, { paddingX: 1, paddingTop: 0, paddingBottom: 0, flexShrink: 0, alignSelf: "stretch", children: _jsx(Input, { valueRef: inputRef, value: input, onChange: writeInput, onSubmit: (v) => void submit(v), historyRef: historyRef, skillNames: skillNames, agentRef: agentRef, config: cfg, atSources: atSources, modalRef: permPromptRef }) }), _jsx(StatusBar, { state: state, scroll: scrollOffset > 0 ? `↑ ${Math.min(scrollOffset, maxScroll)}/${maxScroll}` : null, selectMode: selectMode })] }));
 }
 /** Mount the TUI (called from the `scoder tui` subcommand). */
 export async function runTui(config, initialTask) {

package/dist/tui/chrome.js

@@ -67,9 +67,10 @@ function PhaseBreadcrumb({ phases }) {
 /** 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.
+ * Right: scroll position OR keyboard hints. In select mode (Ctrl+O) the hints
+ * swap to the copy reminder — the mouse belongs to the terminal there.
  */
-export function StatusBar({ state, scroll }) {
+export function StatusBar({ state, scroll, selectMode = false }) {
     const { columns } = useWindowSize();
     const width = Math.max(40, (columns ?? 100) - 6);
     const statusColor = state.status === "running" ? theme.accent :
@@ -86,10 +87,12 @@ export function StatusBar({ state, scroll }) {
             state.status === "aborted" ? "⚠" :
                 state.status === "idle" ? "○" : null;
     const model = state.model || "—";
-    // 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`;
+    // Right side: select-mode reminder OR scroll position OR keybind hints
+    const rightText = selectMode
+        ? "⊝ select · drag to highlight · ⌘C/ctrl+c copy · ctrl+o back"
+        : 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 (model && model !== "—") {

package/dist/tui/hooks/use-keybinds.js

@@ -3,13 +3,18 @@ import { useInput } from "ink";
 import { useEffect, useRef } from "react";
 import { markAborted } from "../state.js";
 export function useTuiKeybinds(deps) {
-    const { scrollOffset, permPromptRef, setPermPrompt, agentRef, runningRef, sessionPickerOpen, setSessionPickerOpen, setPaletteOpen, inputRef, setHelpOpen, update, viewportRowsRef, setScrollOffset, exit } = deps;
+    const { scrollOffset, permPromptRef, setPermPrompt, agentRef, runningRef, sessionPickerOpen, setSessionPickerOpen, setPaletteOpen, inputRef, setHelpOpen, update, viewportRowsRef, setScrollOffset, selectMode, setSelectMode, exit } = deps;
     // Esc aborts the running task (like SIGINT in the CLI); when scrolled up,
     // the first Esc returns to the bottom instead.
     const scrollOffsetRef = useRef(0);
     useEffect(() => {
         scrollOffsetRef.current = scrollOffset;
     }, [scrollOffset]);
+    // useInput closures go stale between renders (same reason as scrollOffsetRef).
+    const selectModeRef = useRef(false);
+    useEffect(() => {
+        selectModeRef.current = selectMode;
+    }, [selectMode]);
     // T-03: permission modal keybinds — intercepts y/a/n/q while open.
     useInput((input, key) => {
         const p = permPromptRef.current;
@@ -47,6 +52,24 @@ export function useTuiKeybinds(deps) {
             update((s) => ({ ...s, thinkingVisible: !s.thinkingVisible }));
             return;
         }
+        // Ctrl+O: toggle select mode — mouse tracking off (native drag-select +
+        // Cmd/Ctrl+C copy) / on (wheel scroll). Scroll with PgUp/PgDn while off.
+        if (key.ctrl && _input === "o") {
+            const next = !selectModeRef.current;
+            selectModeRef.current = next;
+            setSelectMode(next);
+            update((s) => ({
+                ...s,
+                items: [...s.items, {
+                        kind: "notice",
+                        text: next
+                            ? "select mode ON — drag to highlight, copy with ⌘C/Ctrl+C · scroll via PgUp/PgDn · Ctrl+O back to mouse wheel"
+                            : "select mode OFF — mouse wheel scrolling restored",
+                        level: "info",
+                    }],
+            }));
+            return;
+        }
         if (key.pageUp || key.pageDown || key.home || key.end) {
             const page = Math.max(1, Math.floor((viewportRowsRef.current ?? 20) * 0.8));
             if (key.pageUp)

package/dist/tui/hooks/use-scroll.js

@@ -1,8 +1,13 @@
-/** Scroll viewport metrics + mouse wheel (SGR 1006) wiring for the TUI. */
+/** Scroll viewport metrics + mouse wheel (SGR 1006) wiring for the TUI.
+ * P1-8: contentRef giờ đo CỬA SỔ item đã mount (không phải cả transcript) —
+ * chi phí đo O(window) nên vẫn rẻ; số đo thật dùng cho follow-bottom chính
+ * xác, ước lượng (transcriptWindow) chỉ dùng khi scroll lên trên.
+ * mouseEnabled=false (select mode, Ctrl+O): nhả mouse tracking để terminal
+ * cho tô đen kéo chuột + copy thường — wheel scroll tắt, dùng PgUp/PgDn. */
 import { useCallback, useEffect, useRef } from "react";
 import { useBoxMetrics, useStdin } from "ink";
 import { parseWheel, MOUSE_ENABLE, MOUSE_DISABLE } from "../mouse.js";
-export function useScrollMetrics(setScrollOffset) {
+export function useScrollMetrics(setScrollOffset, mouseEnabled = true) {
     const viewportRef = useRef(null);
     const contentRef = useRef(null);
     const viewport = useBoxMetrics(viewportRef);
@@ -14,6 +19,8 @@ export function useScrollMetrics(setScrollOffset) {
     // T5: mouse wheel scroll (SGR 1006) — raw stdin listener; Ink's useInput
     // drops unrepresentable CSI sequences, so wheel events must be read here.
     // Only in alt-screen TTY (mouse tracking sequences corrupt plain pipes).
+    // Select mode (mouseEnabled=false): MOUSE_DISABLE → native terminal drag
+    // selection/copy returns; setRawMode calls stay balanced across toggles.
     const { stdin, setRawMode, isRawModeSupported } = useStdin();
     const wheelScroll = useCallback((dir) => {
         setScrollOffset((o) => Math.max(0, o + (dir === "up" ? 3 : -3)));
@@ -21,6 +28,10 @@ export function useScrollMetrics(setScrollOffset) {
     useEffect(() => {
         if (process.stdout.isTTY !== true || !isRawModeSupported)
             return;
+        if (!mouseEnabled) {
+            process.stdout.write(MOUSE_DISABLE);
+            return;
+        }
         process.stdout.write(MOUSE_ENABLE);
         setRawMode(true);
         const onData = (chunk) => {
@@ -32,7 +43,8 @@ export function useScrollMetrics(setScrollOffset) {
         return () => {
             stdin.off("data", onData);
             process.stdout.write(MOUSE_DISABLE);
+            setRawMode(false);
         };
-    }, [stdin, setRawMode, isRawModeSupported, wheelScroll]);
-    return { viewportRef, contentRef, viewport, content, viewportRowsRef };
+    }, [stdin, setRawMode, isRawModeSupported, wheelScroll, mouseEnabled]);
+    return { viewportRef, viewport, contentRef, content, viewportRowsRef };
 }

package/dist/tui/selectors.js

@@ -70,11 +70,13 @@ export function estimateMarkdownRows(text, width = EST_WIDTH) {
 export function estimateItemRows(item) {
     switch (item.kind) {
         case "user":
-            return 2 + Math.ceil(item.text.length / 80);
+            // Render: marginTop 1 + border-left box paddingX 1, wrap theo chat width
+            // (~60–96 cột). 60 là giả định hẹp an toàn (over-estimate nhẹ).
+            return 2 + wrapEstimate(item.text ?? "", 60);
         case "assistant":
             // +1 marginTop; streaming raw text dùng wrap đơn giản (chưa qua markdown).
             return item.streaming
-                ? wrapEstimate(item.text ?? "", EST_WIDTH)
+                ? (item.text ? 1 : 0) + wrapEstimate(item.text ?? "", 76)
                 : 1 + estimateMarkdownRows(item.text ?? "", EST_WIDTH);
         case "thinking":
             // Render: collapse to last 4 lines.
@@ -82,7 +84,7 @@ export function estimateItemRows(item) {
         case "tool":
             return 1 + 2; // title + preview 2 lines
         case "compaction":
-            return 1;
+            return 2; // marginTop + divider
         case "diff":
             return 3 + Math.min(24, (item.text?.split("\n").length ?? 0)); // header + ≤24 lines + border
         case "todo":
@@ -90,15 +92,19 @@ export function estimateItemRows(item) {
             // chiếm 0 dòng thực tế trong transcript.
             return 0;
         case "build":
-            return 1;
+            return 3; // marginTop + label + command
         case "notice":
-            return 1 + Math.ceil(item.text.length / 2000);
+            // Render raw text (cap 2000 chars) với wrap thật theo width — /help là
+            // notice 40 dòng; estimate cũ (1 + len/2000) under-estimate khiến
+            // follow-bottom clip dòng kế tiếp ( regression caught by tui.test E2E).
+            return 1 + wrapEstimate(item.text.length > 2000 ? item.text.slice(0, 2000) + "…" : item.text, 76);
     }
 }
 /**
  * T4: chọn window item để render: lấy từ cuối lên tới khi tổng rows ước
  * lượng ≥ viewportRows + margin (render dư phía trên để scroll mượt), nhưng
- * giữ toàn bộ khi tổng nhỏ. Trả về slice của items (không mutate).
+ * giữ toàn bộ khi tổng nhỏ. Trả về slice của items (không rẻ — dùng
+ * transcriptWindow cho scroll đúng offset, hàm này chỉ còn cho callers cũ).
  */
 export function visibleWindow(items, viewportRows, margin = 50) {
     const budget = viewportRows + margin;
@@ -110,6 +116,55 @@ export function visibleWindow(items, viewportRows, margin = 50) {
     }
     return start === 0 ? items : items.slice(start);
 }
+// P1-8: cache số dòng ước lượng theo IDENTITY của item. state.ts patch item
+// kiểu immutable (object mới khi nội dung đổi) ⇒ item finalized không bao giờ
+// tính lại; chỉ item đang stream (mỗi flush đổi reference) mới estimate lại.
+const itemRowsCache = new WeakMap();
+function itemRowsCached(item) {
+    const hit = itemRowsCache.get(item);
+    if (hit !== undefined)
+        return hit;
+    const v = estimateItemRows(item);
+    itemRowsCache.set(item, v);
+    return v;
+}
+/** Tổng chiều cao ước lượng của cả transcript — O(n) phép cộng số nhỏ. */
+export function estimateTotalRows(items) {
+    let acc = 0;
+    for (const it of items)
+        acc += itemRowsCached(it);
+    return acc;
+}
+/**
+ * P1-8 — virtualization cho transcript viewport. Mount duy các item phủ
+ * [scrollTop - overscan, scrollTop + viewportRows + overscan] thay vì cả
+ * transcript: chi phí React diff + Yoga layout + wrap mỗi frame hết tỷ lệ
+ * với tổng số text (đo: 42–53 ms/frame ở 300–400 item → ~7 ms khi window).
+ * Scroll dùng ước lượng rows (estimateItemRows, cache theo identity item),
+ * nên khi estimate lệch thực tế thì offset chỉ sai vài dòng — cùng trade-off
+ * mọi TUI virtualized dùng.
+ */
+export function transcriptWindow(items, scrollTop, viewportRows, overscan = 24) {
+    const n = items.length;
+    // Cumulative start rows một lượt O(n) nhưng chỉ là phép cộng số nhỏ.
+    const startRow = new Array(n + 1);
+    startRow[0] = 0;
+    for (let i = 0; i < n; i++)
+        startRow[i + 1] = startRow[i] + itemRowsCached(items[i]);
+    const totalRows = startRow[n];
+    const top = Math.max(0, Math.min(scrollTop, totalRows));
+    const target = Math.max(0, top - overscan);
+    let start = 0;
+    while (start + 1 < n && startRow[start + 1] <= target)
+        start++;
+    const bottomTarget = top + viewportRows + overscan;
+    let end = start;
+    while (end < n && startRow[end] < bottomTarget)
+        end++;
+    if (end === start && start < n)
+        end = start + 1; // item khổng lồ vẫn phải hiện
+    return { start, end, offset: top - startRow[start], totalRows };
+}
 /**
  * Plan mới nhất cho sidebar — todo items được append mỗi lần update nhưng
  * sidebar chỉ cần snapshot hiện tại (last-wins), null khi chưa có plan.

package/dist/tui/state.js

@@ -79,7 +79,7 @@ function applyGuardrail(state, ev) {
 }
 // Pure selectors live in ./selectors.js (Phase 5.4) — re-exported so existing
 // import sites (app.tsx, hooks, tests) keep working unchanged.
-export { estimateItemRows, visibleWindow, latestPlan, toolPhase } from "./selectors.js";
+export { estimateItemRows, visibleWindow, transcriptWindow, estimateTotalRows, latestPlan, toolPhase } from "./selectors.js";
 /**
  * Fold one AgentEvent into the state (mutates `state`, returns it for
  * reducer-style chaining). Unknown events are ignored.

package/dist/workspace/file-index.js

@@ -8,7 +8,7 @@ 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;
+const cache = new Map();
 /**
  * File index for `workdir` (cached, TTL 5s; invalidateFileIndex on tool writes).
  * `force` (P1-2) bỏ qua cache — dùng cho fingerprint, nơi một file mới được tạo
@@ -16,8 +16,9 @@ let cache = null;
  * sẽ được tái sử dụng sai.
  */
 export function fileIndex(workdir, force = false) {
-    if (!force && cache && Date.now() - cache.built < 5_000)
-        return cache.files;
+    const hit = cache.get(workdir);
+    if (!force && hit && Date.now() - hit.built < 5_000)
+        return hit.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).
@@ -36,12 +37,12 @@ export function fileIndex(workdir, force = false) {
     if (files.length === 0)
         walkFiles(workdir, "", files, 0);
     files.sort();
-    cache = { files, built: Date.now() };
+    cache.set(workdir, { files, built: Date.now() });
     return files;
 }
 /** Cache invalidate — call after write/edit tool_result (scope: whole index). */
 export function invalidateFileIndex() {
-    cache = null;
+    cache.clear();
 }
 function walkFiles(root, prefix, out, depth) {
     if (depth > 6)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "s-app-scoder-agent",
-  "version": "0.9.9",
+  "version": "0.9.14",
   "description": "Autonomous coding agent CLI — writes, edits, and builds code autonomously until the project compiles without errors.",
   "type": "module",
   "main": "dist/index.js",