s-app-scoder-agent 0.9.10 → 0.9.15

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/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

@@ -88,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.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,190 @@ 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 {
+            // Báo UI biết warm-up đang chạy (giữ màn hình welcome + progress bar).
+            this.emit({ type: "warmup", active: true, stage: "init", percent: 5, message: "đang chuẩn bị warm-up…" });
+            // 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;
+            this.emit({ type: "warmup", active: true, stage: "context+mcp", percent: 60, message: "context window + MCP sẵn sàng" });
+            // 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(),
+                });
+            this.emit({ type: "warmup", active: true, stage: "prompt", percent: 80, message: "đang prefill system prompt…" });
+            const res = await this.client.chat(messages, tools, { signal, maxTokens: 1 });
+            this.emit({ type: "warmup", active: true, stage: "done", percent: 100, message: "warm-up xong" });
+            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 {
+            this.emit({ type: "warmup", active: false, stage: "done", percent: 100, message: "warm-up kết thúc" });
+            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 +1099,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 +1147,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 +1189,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 +1242,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 +1253,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 +1273,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 +1552,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

@@ -203,8 +203,9 @@ verifying your work with the build command. You act; you don't just advise.`,
 Your answers render in a terminal (Ink). Markdown displays best when you:
 - Tables: at most 6 columns with short cell text; no line breaks inside cells;
   escape literal pipes as \\| and keep pipes inside \`code spans\` intact.
-- Diagrams: keep \`\`\`mermaid sources simple (flowchart/sequence with plain
-  node ids). The terminal shows a structured summary, not the graph image.
+- Diagrams: \`\`\`mermaid flowchart/graph renders as a real box-drawing chart
+  in the terminal — keep it ≤12 nodes, plain node ids, short labels (line
+  breaks via <br/>). sequence/state/other types show a structured summary.
 - Numeric comparisons/trends: prefer a \`\`\`chart fence (JSON array of
   {"label","value"}) — it renders as a native terminal bar/pie chart.
 - Code fences: always tag the language; keep lines reasonably short (they wrap
@@ -259,6 +260,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
@@ -294,8 +299,9 @@ export const PROMPT_SECTIONS = {
 - Reply in the user's language; keep final reports concise. Never print
   secrets (API keys, tokens, .env contents).
 - Terminal markdown: tag code fences with the language; tables ≤6 columns,
-  short cells; keep mermaid sources simple (flowchart/sequence, plain ids);
-  numeric trends as a \`\`\`chart fence (JSON array of {"label","value"}).`,
+  short cells; \`\`\`mermaid flowcharts render as real terminal graphs (keep
+  ≤12 nodes, plain ids, short labels), sequence as a summary; numeric trends
+  as a \`\`\`chart fence (JSON array of {"label","value"}).`,
 };
 /** V6 — assembled from the sections above (order matters). */
 function assembleV6() {

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);