clixad 0.0.1-beta.6 → 0.0.1-beta.8

package/dist/clixad.mjs

@@ -643,7 +643,7 @@ function rel(root, abs) {
 async function gate(ctx, req) {
   if (!ctx.permit) return;
   const res = await ctx.permit(req);
-  if (!res.allowed) throw new ToolError(res.reason);
+  if (!res.allowed) throw new PermissionDeniedError(res.reason, res.notice);
 }
 function commandSignature(command) {
   return `run:${command.replace(/\s+/g, " ").trim()}`;
@@ -779,14 +779,30 @@ function globToRegExp(pattern) {
   const anchored = p.includes("/") ? `^${re}$` : `^(?:.*/)?${re}$`;
   return new RegExp(anchored);
 }
-var ToolError, MAX_FILE_BYTES, MAX_OUTPUT_CHARS, MAX_GLOB_RESULTS, MAX_GREP_MATCHES, MAX_WALK_FILES, DEFAULT_COMMAND_TIMEOUT, SKIP_DIRS, TOOLS, TOOL_SCHEMA;
+function toolSchemaFor(mode) {
+  if (mode !== "plan") return TOOL_SCHEMA;
+  return [
+    ...TOOL_SCHEMA.filter((t) => READ_ONLY_TOOLS.includes(t.function.name)),
+    EXIT_PLAN_MODE_SCHEMA
+  ];
+}
+var ToolError, PermissionDeniedError, MAX_FILE_BYTES, MAX_READ_LINES, MAX_READ_LINE_CHARS, MAX_OUTPUT_CHARS, MAX_GLOB_RESULTS, MAX_GREP_MATCHES, MAX_WALK_FILES, DEFAULT_COMMAND_TIMEOUT, SKIP_DIRS, TOOLS, READ_ONLY_TOOLS, EXIT_PLAN_MODE_SCHEMA, TOOL_SCHEMA;
 var init_tools = __esm({
   "src/tools.ts"() {
     "use strict";
     init_diff();
     ToolError = class extends Error {
     };
+    PermissionDeniedError = class extends ToolError {
+      notice;
+      constructor(message, notice) {
+        super(message);
+        this.notice = notice;
+      }
+    };
     MAX_FILE_BYTES = 4e5;
+    MAX_READ_LINES = 2e3;
+    MAX_READ_LINE_CHARS = 2e3;
     MAX_OUTPUT_CHARS = 3e4;
     MAX_GLOB_RESULTS = 200;
     MAX_GREP_MATCHES = 100;
@@ -805,16 +821,46 @@ var init_tools = __esm({
       ".venv"
     ]);
     TOOLS = {
+      /**
+       * Read a file, numbered, and optionally only a window of it.
+       *
+       * The numbers are what let the model say `app.tsx:412` instead of "the bit
+       * near the top", and the window is what stops a 400 kB file being poured into
+       * a metered context to look at forty lines of it. Both are how Claude Code
+       * reads files, and the cost of neither is small on a product where the
+       * context is the bill.
+       *
+       * The obvious hazard is that `edit_file` matches text exactly, so a model
+       * that copies the numbers into `old_string` gets nothing. Two things guard
+       * it: the tool description says the numbers are display only, and
+       * `edit_file`'s not-found error names them, so a model that does it anyway
+       * is told precisely what went wrong instead of guessing.
+       */
       read_file(ctx, args) {
         const abs = safeResolve(ctx.root, args.path);
         if (!existsSync(abs)) throw new ToolError(`not found: ${args.path}`);
         if (statSync(abs).isDirectory()) throw new ToolError(`${args.path} is a directory \u2014 use list_dir`);
-        const content = readFileSync2(abs, "utf8");
-        if (content.length > MAX_FILE_BYTES) {
-          return content.slice(0, MAX_FILE_BYTES) + `
-\u2026 [truncated at ${MAX_FILE_BYTES} chars]`;
+        const raw = readFileSync2(abs, "utf8");
+        const all = raw.split("\n");
+        const total = all.length > 1 && all[all.length - 1] === "" ? all.length - 1 : all.length;
+        const first = Math.max(1, Math.floor(args.offset ?? 1));
+        const want = Math.max(1, Math.floor(args.limit ?? MAX_READ_LINES));
+        const last = Math.min(total, first + want - 1);
+        if (first > total) {
+          return `${args.path} has ${total} lines; offset ${first} is past the end`;
         }
-        return content;
+        const body = all.slice(first - 1, last).map((line2, i) => {
+          const n = String(first + i).padStart(5, " ");
+          const text = line2.length > MAX_READ_LINE_CHARS ? `${line2.slice(0, MAX_READ_LINE_CHARS)}\u2026 [line truncated]` : line2;
+          return `${n}	${text}`;
+        }).join("\n");
+        const note = last < total || first > 1 ? `
+\u2026 showing lines ${first}-${last} of ${total}. Read on with offset: ${last + 1}.` : "";
+        if (body.length > MAX_FILE_BYTES) {
+          return `${body.slice(0, MAX_FILE_BYTES)}
+\u2026 [truncated at ${MAX_FILE_BYTES} chars \u2014 read a smaller range with offset/limit]`;
+        }
+        return body + note;
       },
       list_dir(ctx, args) {
         const abs = safeResolve(ctx.root, args.path ?? ".");
@@ -907,7 +953,11 @@ var init_tools = __esm({
         if (args.old_string === args.new_string) throw new ToolError("old_string and new_string are identical");
         const before = readFileSync2(abs, "utf8");
         const count = occurrences(before, args.old_string);
-        if (count === 0) throw new ToolError(`old_string not found in ${args.path} \u2014 read the file and copy the exact text`);
+        if (count === 0) {
+          throw new ToolError(
+            `old_string not found in ${args.path} \u2014 read the file and copy the exact text, without the line numbers read_file puts in front of each line`
+          );
+        }
         if (count > 1 && !args.replace_all) {
           throw new ToolError(
             `old_string appears ${count} times in ${args.path} \u2014 add more surrounding context, or pass replace_all: true`
@@ -938,6 +988,47 @@ var init_tools = __esm({
           preview: command
         });
         return execute(ctx, command, args.timeout ?? DEFAULT_COMMAND_TIMEOUT);
+      },
+      /**
+       * The way out of plan mode — the thing plan mode did not have.
+       *
+       * It changes no files. Its whole job is to put the plan in front of the user
+       * and report back what they chose, so the model can carry on **in the same
+       * turn** rather than being told to ask for an approval nothing could grant.
+       *
+       * The mode switch itself is not done here: `approvePlan` is wired to the
+       * permission state in the TUI, which owns the mode, and this tool only
+       * reports the answer. Keeping the two apart is what stops a tool from being
+       * able to grant itself write access.
+       */
+      async exit_plan_mode(ctx, args) {
+        const plan = (args.plan ?? "").trim();
+        if (!plan) throw new ToolError("exit_plan_mode needs a plan");
+        if (!ctx.approvePlan) {
+          throw new ToolError(
+            "there is no one to approve a plan in this run \u2014 present the plan as your answer instead"
+          );
+        }
+        const decision = await ctx.approvePlan(plan);
+        if (decision === "keepPlanning") {
+          return "the user did not approve this plan. Stay read-only, ask what they would change, and call exit_plan_mode again when you have a plan they agree with.";
+        }
+        return `the user approved the plan. Permission mode is now "${decision}"` + (decision === "acceptEdits" ? " \u2014 file edits apply without asking, shell commands are still put to them." : " \u2014 each write and each command is put to them first.") + " Carry out the plan now.";
+      }
+    };
+    READ_ONLY_TOOLS = ["read_file", "list_dir", "glob", "grep"];
+    EXIT_PLAN_MODE_SCHEMA = {
+      type: "function",
+      function: {
+        name: "exit_plan_mode",
+        description: "Present your plan to the user and ask them to approve leaving plan mode. Call this once you know what you intend to do. Writes and commands stay unavailable until they approve; on approval you continue in the same turn.",
+        parameters: {
+          type: "object",
+          properties: {
+            plan: { type: "string", description: "The plan, in a few short lines of markdown." }
+          },
+          required: ["plan"]
+        }
       }
     };
     TOOL_SCHEMA = [
@@ -945,10 +1036,14 @@ var init_tools = __esm({
         type: "function",
         function: {
           name: "read_file",
-          description: "Read a UTF-8 text file from the workspace.",
+          description: "Read a UTF-8 text file from the workspace. Lines come back as '<number>\\t<text>'. The numbers are for referring to places in the file and are NOT part of it \u2014 never include them in edit_file arguments. Long files are cut off; read on with offset.",
           parameters: {
             type: "object",
-            properties: { path: { type: "string" } },
+            properties: {
+              path: { type: "string" },
+              offset: { type: "number", description: "First line to read, 1-based. Defaults to 1." },
+              limit: { type: "number", description: "How many lines to read. Defaults to 2000." }
+            },
             required: ["path"]
           }
         }
@@ -1047,7 +1142,8 @@ async function runAgent(client, task, opts) {
   const ctx = {
     root: opts.root,
     permit: opts.permit,
-    signal: opts.signal
+    signal: opts.signal,
+    approvePlan: opts.approvePlan
   };
   const messages = [
     { role: "system", content: opts.systemPrompt ?? SYSTEM_PROMPT },
@@ -1062,7 +1158,7 @@ async function runAgent(client, task, opts) {
     let turn;
     try {
       turn = await client.chatStream(messages, opts.model, {
-        tools: TOOL_SCHEMA,
+        tools: opts.tools ? opts.tools() : TOOL_SCHEMA,
         signal: opts.signal,
         onDelta: (text) => emit({ type: "delta", text })
       });
@@ -1129,7 +1225,14 @@ async function executeToolCall(ctx, call, emit) {
   } catch (err) {
     if (err instanceof ToolError) {
       const msg = `error: ${err.message}`;
-      emit({ type: "tool_result", id, name, result: msg, ok: false });
+      emit({
+        type: "tool_result",
+        id,
+        name,
+        result: msg,
+        ok: false,
+        ...err instanceof PermissionDeniedError ? { display: err.notice } : {}
+      });
       return msg;
     }
     throw err;
@@ -1151,6 +1254,8 @@ async function dispatch(ctx, name, args) {
       return TOOLS.write_file(ctx, args);
     case "run_command":
       return TOOLS.run_command(ctx, args);
+    case "exit_plan_mode":
+      return TOOLS.exit_plan_mode(ctx, args);
     default:
       return `error: unknown tool ${name}`;
   }
@@ -1160,7 +1265,7 @@ var init_agent = __esm({
   "src/agent.ts"() {
     "use strict";
     init_tools();
-    SYSTEM_PROMPT = "You are Clixad, a terminal coding agent. You can read, search, write and edit files and run shell commands, all confined to the user's workspace. Find your way around with glob and grep before reading whole files. Prefer edit_file over write_file for existing files. Make minimal correct edits, verify them when a test or build command is available, and stop when the task is complete. Keep your final message short: say what you changed and why.";
+    SYSTEM_PROMPT = "You are Clixad, a terminal coding agent. You can read, search, write and edit files and run shell commands, all confined to the user's workspace. Find your way around with glob and grep before reading whole files. Prefer edit_file over write_file for existing files. Make minimal correct edits, verify them when a test or build command is available, and stop when the task is complete. Keep your final message short: say what you did and why.\n\nNot every message is a task. If the user asks a question, or asks you to say something, answer in plain text and call no tools at all. Reach for a file or a command only when the request is actually about one, and when a message is ambiguous, prefer the reading of it that changes nothing.\n\nA tool call that was refused did not happen. Never describe it as done, and do not repeat it on a later message unless the user asks for it again.";
   }
 });
 
@@ -1240,6 +1345,30 @@ var init_context = __esm({
 });
 
 // src/permissions.ts
+function modeInstruction(mode) {
+  switch (mode) {
+    case "plan":
+      return [
+        "# Permission mode: plan (read-only)",
+        "You cannot write files or run commands right now \u2014 those tools are not available to you",
+        "in this mode. Investigate with read_file, list_dir, glob and grep, then call exit_plan_mode",
+        "with a short plan. The user approves or rejects it there; on approval you carry straight on",
+        "in the same turn with the write tools available. Do not ask for approval in prose \u2014 the user",
+        "has no way to answer that."
+      ].join("\n");
+    case "acceptEdits":
+      return [
+        "# Permission mode: auto-accept edits",
+        "File edits apply without asking. Shell commands are still put to the user first."
+      ].join("\n");
+    default:
+      return [
+        "# Permission mode: ask before edits",
+        "Each write and each shell command is put to the user before it runs. A refusal is their",
+        "decision: the call did not happen, so do not report it as done and do not retry it."
+      ].join("\n");
+  }
+}
 function isEdit(tool) {
   return tool === "write_file" || tool === "edit_file";
 }
@@ -1254,7 +1383,8 @@ function decide(state, req) {
   if (state.mode === "plan") {
     return {
       kind: "deny",
-      reason: `plan mode is on, so ${req.summary} was not executed. Do not attempt further writes or commands \u2014 describe the plan instead and let the user approve it.`
+      reason: `plan mode is on, so ${req.summary} was not executed. Do not attempt further writes or commands \u2014 describe the plan instead and let the user approve it.`,
+      notice: `plan mode \u2014 ${req.summary} was not run`
     };
   }
   if (state.allowed.has(req.signature)) return { kind: "allow" };
@@ -1266,14 +1396,23 @@ function createPermit(getState, ask2) {
     const state = getState();
     const verdict = decide(state, req);
     if (verdict.kind === "allow") return { allowed: true };
-    if (verdict.kind === "deny") return { allowed: false, reason: verdict.reason };
+    if (verdict.kind === "deny") return { allowed: false, reason: verdict.reason, notice: verdict.notice };
     const answer = await ask2(req);
     if (answer === "always") {
       state.allowed.add(req.signature);
       return { allowed: true };
     }
     if (answer === "once") return { allowed: true };
-    return { allowed: false, reason: `the user denied ${req.summary}` };
+    return {
+      allowed: false,
+      // Stated as a fact about the world, not just as a verdict. A refused call
+      // that reads like a pending one is how the model ends up describing work
+      // it never did — or repeating the call on the next message.
+      reason: `the user denied ${req.summary}. It did not happen. Do not retry it \u2014 ask what they would prefer, or carry on with the rest of the task.`,
+      // The TUI has already said "denied: <summary>" the moment the key was
+      // pressed, so repeating it in red under the tool call is noise.
+      notice: `denied by you`
+    };
   };
 }
 var MODES, MODE_LABEL, denyAll;
@@ -1288,7 +1427,8 @@ var init_permissions = __esm({
     };
     denyAll = async (req) => ({
       allowed: false,
-      reason: `${req.summary} needs approval, but this run is non-interactive (use the REPL to approve it)`
+      reason: `${req.summary} needs approval, but this run is non-interactive (use the REPL to approve it)`,
+      notice: `${req.summary} needs approval \u2014 this run is non-interactive`
     });
   }
 });
@@ -1504,6 +1644,10 @@ function centered(rendered, visibleW, colW) {
   const lead = Math.max(0, Math.floor((colW - visibleW) / 2));
   return cell(" ".repeat(lead) + rendered, lead + visibleW);
 }
+function bannerTip(index) {
+  const i = index ?? Math.floor(Math.random() * BANNER_TIPS.length);
+  return BANNER_TIPS[(i % BANNER_TIPS.length + BANNER_TIPS.length) % BANNER_TIPS.length];
+}
 function earnedLabel(opts) {
   return `$${opts.earnedUsdToday.toFixed(2)}/$${opts.maxRewardUsd.toFixed(2)} today`;
 }
@@ -1515,14 +1659,19 @@ function welcomeBanner(opts) {
   const cwd = opts.cwd.replace(homedir5(), "~").replace(/\\/g, "/");
   const welcome = opts.name ? `Welcome back, ${truncate(opts.name, 18)}!` : "Welcome to Clixad!";
   const duck = duckLines();
-  const model = truncate(opts.model, leftW - 4);
   const home = truncate(cwd, leftW);
+  const hint = bannerTip(opts.tipIndex);
+  const hintDesc = truncate(hint.desc, Math.max(1, leftW - 3 - hint.key.length));
   const left = [
     centered(BOLD + TEXT + welcome + R2, welcome.length, leftW),
     cell("", 0),
     ...duck.map((d) => centered(d, DUCK_W, leftW)),
     cell("", 0),
-    centered(MANGO + "\u25C6 " + R2 + TEXT + model + R2, 2 + model.length, leftW),
+    centered(
+      MANGO + "\u25C6 " + R2 + BOLD + TEXT + hint.key + R2 + FAINT + " " + hintDesc + R2,
+      2 + hint.key.length + 1 + hintDesc.length,
+      leftW
+    ),
     centered(FAINT + home + R2, home.length, leftW)
   ];
   const tip = (k, d) => cell(MANGO + k + R2 + FAINT + " " + d + R2, k.length + 1 + d.length);
@@ -1553,10 +1702,11 @@ function welcomeBanner(opts) {
 }
 function compactBanner(opts) {
   const welcome = opts.name ? `Welcome back, ${opts.name}!` : "Welcome to Clixad!";
+  const hint = bannerTip(opts.tipIndex);
   return duckLines().map((d) => "  " + d).join("\n") + `
 
   ${BOLD}${TEXT}${welcome}${R2}
-  ${MANGO}\u25C6${R2} ${opts.model}  ${FAINT}\xB7${R2} ${opts.balance.toLocaleString("en-US")} credits
+  ${MANGO}\u25C6${R2} ${BOLD}${TEXT}${hint.key}${R2} ${FAINT}${hint.desc}${R2}  ${FAINT}\xB7${R2} ${opts.balance.toLocaleString("en-US")} credits
 `;
 }
 function clearScreen() {
@@ -1568,7 +1718,7 @@ function clearScreen() {
 function visibleLength(s) {
   return s.replace(/\x1b\[[0-9;]*m/g, "").length;
 }
-var R2, BOLD, fg, bg, MANGO, TEXT, MUTED, FAINT, PAL, DUCK, DUCK_W, cell, padTo, truncate, MIN_BANNER_WIDTH, RIGHT_MAX;
+var R2, BOLD, fg, bg, MANGO, TEXT, MUTED, FAINT, PAL, DUCK, DUCK_W, cell, padTo, truncate, BANNER_TIPS, MIN_BANNER_WIDTH, RIGHT_MAX;
 var init_banner = __esm({
   "src/banner.ts"() {
     "use strict";
@@ -1610,6 +1760,15 @@ var init_banner = __esm({
     cell = (text, w) => ({ text, w });
     padTo = (c2, width) => (c2?.text ?? "") + " ".repeat(Math.max(0, width - (c2?.w ?? 0)));
     truncate = (s, max) => s.length > max ? s.slice(0, max - 1) + "\u2026" : s;
+    BANNER_TIPS = [
+      { key: "/init", desc: "make a CLIXAD.md" },
+      { key: "shift+tab", desc: "switch mode" },
+      { key: "@file", desc: "add a file to context" },
+      { key: "ctrl+o", desc: "expand tool output" },
+      { key: "esc", desc: "stop the current turn" },
+      { key: "/compact", desc: "free up context" },
+      { key: "/earn", desc: "top up credits" }
+    ];
     MIN_BANNER_WIDTH = 66;
     RIGHT_MAX = 34;
   }
@@ -1635,6 +1794,59 @@ var init_version = __esm({
   }
 });
 
+// src/mentions.ts
+function findMentions(text) {
+  const out = [];
+  for (const match of text.matchAll(/(?:^|\s)@([^\s]+)/g)) {
+    const path = match[1].replace(TRAILING, "");
+    if (path && !out.includes(path)) out.push(path);
+  }
+  return out;
+}
+function expandMentions(text, root, limit = MAX_MENTION_CHARS) {
+  const mentions = findMentions(text);
+  if (mentions.length === 0) return { text, attached: [] };
+  const blocks = [];
+  const attached = [];
+  let used = 0;
+  for (const path of mentions) {
+    if (used >= limit) break;
+    let body;
+    try {
+      safeResolve(root, path);
+      body = TOOLS.read_file({ root }, { path });
+    } catch {
+      continue;
+    }
+    const room = limit - used;
+    const clipped = body.length > room ? `${body.slice(0, room)}
+\u2026 [attachment truncated \u2014 read the rest with read_file]` : body;
+    used += clipped.length;
+    attached.push(path);
+    blocks.push(`--- ${path} ---
+${clipped}`);
+  }
+  if (blocks.length === 0) return { text, attached: [] };
+  return {
+    text: `${text}
+
+# Files the user referenced
+Their contents are below, already read for you \u2014 do not call read_file on them again.
+
+` + blocks.join("\n\n"),
+    attached
+  };
+}
+var TRAILING, MAX_MENTION_CHARS;
+var init_mentions = __esm({
+  "src/mentions.ts"() {
+    "use strict";
+    init_tools();
+    TRAILING = /[),;:]+$/;
+    MAX_MENTION_CHARS = 12e4;
+  }
+});
+
 // src/compact.ts
 function estimateTokens(text) {
   return Math.ceil(text.length / 4);
@@ -1811,9 +2023,10 @@ function commandLabel(c2) {
 function helpText() {
   const w = Math.max(...COMMANDS.map((c2) => commandLabel(c2).length));
   return COMMANDS.map((c2) => `  ${commandLabel(c2).padEnd(w + 2)}${c2.desc}`).join("\n") + "\n\n" + [
-    "  @path        reference a file (tab completes)",
+    "  @path        attach a file to the message (tab completes)",
+    "  !command     run a shell command yourself, no model call",
     "  shift+tab    cycle permission mode \xB7 esc  stop the current turn",
-    "  ctrl+o       expand the last tool output \xB7 ctrl+c twice  quit",
+    "  ctrl+o       expand the newest collapsed tool output \xB7 ctrl+c twice  quit",
     "  \\ + enter    continue on a new line"
   ].join("\n");
 }
@@ -1843,7 +2056,11 @@ var init_commands = __esm({
       // somebody in a 401 loop needs.
       { name: "login", desc: "sign in, or switch account" },
       { name: "compact", desc: "summarise the conversation to free context" },
-      { name: "clear", desc: "clear the conversation context" },
+      { name: "clear", desc: "clear the screen and start a new session" },
+      // Deliberately *no* `args` on /resume, for /login's reason: an arg hint makes
+      // enter complete the command instead of running it, and the picker is the
+      // point. `/resume <id>` still works when typed in full.
+      { name: "resume", desc: "pick up an earlier session in this directory" },
       { name: "init", desc: "write a CLIXAD.md for this project" },
       { name: "exit", desc: "quit clixad" }
     ];
@@ -2158,6 +2375,45 @@ import { jsx, jsxs } from "react/jsx-runtime";
 function lineCount(text, cols) {
   return text.split("\n").reduce((n, line2) => n + Math.max(1, Math.ceil(visibleLength(line2) / Math.max(1, cols))), 0);
 }
+function tailRows(text, cols, max) {
+  if (max <= 0) return "";
+  const width = Math.max(1, cols);
+  const lines = text.split("\n");
+  const kept = [];
+  let used = 0;
+  for (let i = lines.length - 1; i >= 0; i--) {
+    const line2 = lines[i];
+    const h = Math.max(1, Math.ceil(visibleLength(line2) / width));
+    if (used + h <= max) {
+      kept.unshift(line2);
+      used += h;
+      continue;
+    }
+    const room = max - used;
+    if (room > 0) kept.unshift(line2.slice(-(room * width)));
+    break;
+  }
+  return kept.join("\n");
+}
+function headRows(text, cols, max) {
+  if (max <= 0) return "";
+  const width = Math.max(1, cols);
+  const lines = text.split("\n");
+  const kept = [];
+  let used = 0;
+  for (const line2 of lines) {
+    const h = Math.max(1, Math.ceil(visibleLength(line2) / width));
+    if (used + h <= max) {
+      kept.push(line2);
+      used += h;
+      continue;
+    }
+    const room = max - used;
+    if (room > 0) kept.push(line2.slice(0, room * width));
+    break;
+  }
+  return kept.join("\n");
+}
 function entryHeight(entry, cols) {
   const margin = entry.kind === "banner" ? 0 : 1;
   switch (entry.kind) {
@@ -2204,7 +2460,7 @@ function EntryView({ entry }) {
       ) });
   }
 }
-var MANGO3, MANGO_BRIGHT;
+var MANGO3, MANGO_BRIGHT, SLATE, MODE_STYLE;
 var init_views = __esm({
   "src/tui/views.tsx"() {
     "use strict";
@@ -2212,12 +2468,18 @@ var init_views = __esm({
     init_markdown();
     MANGO3 = "#f5b841";
     MANGO_BRIGHT = "#ffcf6b";
+    SLATE = "#8b98ae";
+    MODE_STYLE = {
+      normal: { color: SLATE, glyph: "\u23F5" },
+      acceptEdits: { color: "#7ee787", glyph: "\u23F5\u23F5" },
+      plan: { color: "#79c0ff", glyph: "\u23F8" }
+    };
   }
 });
 
 // src/tui/app.tsx
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { Box as Box2, Static, Text as Text2, useApp, useInput } from "ink";
+import { Box as Box2, Static, Text as Text2, useApp, useInput, usePaste, useStdout } from "ink";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 function useTerminalSize() {
   const [size, setSize] = useState({
@@ -2235,6 +2497,7 @@ function useTerminalSize() {
 }
 function App({ client, config, wallet, session, initialTask }) {
   const { exit } = useApp();
+  const { write: writeToStdout } = useStdout();
   const idRef = useRef(1);
   const { rows, cols } = useTerminalSize();
   const root = process.cwd();
@@ -2255,6 +2518,7 @@ function App({ client, config, wallet, session, initialTask }) {
       })
     }
   ]);
+  const [staticEpoch, setStaticEpoch] = useState(0);
   const [messages, setMessages] = useState(session?.messages ?? []);
   const [editor, setEditor] = useState(EMPTY);
   const [busy, setBusy] = useState(false);
@@ -2268,6 +2532,7 @@ function App({ client, config, wallet, session, initialTask }) {
   const [sel, setSel] = useState(0);
   const [menuOff, setMenuOff] = useState(false);
   const [ask2, setAsk] = useState(null);
+  const [plan, setPlan] = useState(null);
   const [picker, setPicker] = useState(null);
   const [pickerSel, setPickerSel] = useState(0);
   const [tick, setTick] = useState(0);
@@ -2277,6 +2542,10 @@ function App({ client, config, wallet, session, initialTask }) {
   const [sponsor, setSponsor] = useState(null);
   const messagesRef = useRef(messages);
   messagesRef.current = messages;
+  const busyRef = useRef(false);
+  busyRef.current = busy;
+  const queueRef = useRef([]);
+  const [queueView, setQueueView] = useState([]);
   const permRef = useRef(createState("normal"));
   const abortRef = useRef(null);
   const busyAbortRef = useRef(null);
@@ -2286,16 +2555,54 @@ function App({ client, config, wallet, session, initialTask }) {
   const runStartedAtRef = useRef(Date.now());
   const contextRef = useRef(collectContext(root));
   const catalogRef = useRef([]);
-  const lastOutputRef = useRef("");
+  const outputsRef = useRef([]);
+  const expandedRef = useRef(/* @__PURE__ */ new Set());
+  const pickerWindowRef = useRef({ from: 0, count: 0 });
   const runningToolRef = useRef(null);
   const pendingTaskRef = useRef(null);
+  const deltaBufRef = useRef("");
+  const deltaTimerRef = useRef(null);
   const sponsorRef = useRef(sponsorSource());
   const sponsorIdxRef = useRef(0);
   const sponsorPrevRef = useRef(void 0);
   const tallyRef = useRef(createTally());
+  const heightCacheRef = useRef(/* @__PURE__ */ new Map());
   const push = useCallback((e) => {
-    setEntries((prev) => [...prev, { ...e, id: idRef.current++ }]);
+    const id = idRef.current++;
+    setEntries((prev) => [...prev, { ...e, id }]);
+    return id;
   }, []);
+  const syncQueue = useCallback(() => setQueueView([...queueRef.current]), []);
+  const enqueue = useCallback(
+    (line2) => {
+      queueRef.current.push(line2);
+      syncQueue();
+    },
+    [syncQueue]
+  );
+  const dequeue = useCallback(() => {
+    const next = queueRef.current.shift();
+    if (next !== void 0) syncQueue();
+    return next;
+  }, [syncQueue]);
+  const flushDelta = useCallback(() => {
+    if (deltaTimerRef.current) {
+      clearTimeout(deltaTimerRef.current);
+      deltaTimerRef.current = null;
+    }
+    const buffered = deltaBufRef.current;
+    if (!buffered) return;
+    deltaBufRef.current = "";
+    setLive((l) => ({ ...l ?? { text: "" }, text: (l?.text ?? "") + buffered }));
+  }, []);
+  const dropDelta = useCallback(() => {
+    if (deltaTimerRef.current) {
+      clearTimeout(deltaTimerRef.current);
+      deltaTimerRef.current = null;
+    }
+    deltaBufRef.current = "";
+  }, []);
+  useEffect(() => dropDelta, [dropDelta]);
   useEffect(() => {
     const files = contextRef.current.files;
     if (files.length) push({ kind: "notice", text: `  context: ${files.join(", ")}` });
@@ -2344,6 +2651,21 @@ function App({ client, config, wallet, session, initialTask }) {
     []
   );
   const permit = useMemo(() => createPermit(() => permRef.current, askUser), [askUser]);
+  const approvePlan = useCallback(
+    (proposed) => new Promise((resolve2) => {
+      setPlan({
+        plan: proposed,
+        resolve: (decision) => {
+          if (decision !== "keepPlanning") {
+            permRef.current.mode = decision;
+            setMode(decision);
+          }
+          resolve2(decision);
+        }
+      });
+    }),
+    []
+  );
   const cycleMode = useCallback(() => {
     const next = nextMode(permRef.current.mode);
     permRef.current.mode = next;
@@ -2351,10 +2673,13 @@ function App({ client, config, wallet, session, initialTask }) {
   }, []);
   const handleEvent = useCallback(
     (event) => {
+      if (event.type === "delta") {
+        deltaBufRef.current += event.text;
+        if (!deltaTimerRef.current) deltaTimerRef.current = setTimeout(flushDelta, DELTA_FLUSH_MS);
+        return;
+      }
+      flushDelta();
       switch (event.type) {
-        case "delta":
-          setLive((l) => ({ ...l ?? { text: "" }, text: (l?.text ?? "") + event.text }));
-          return;
         case "message":
           push({ kind: "assistant", text: event.content });
           setLive((l) => ({ ...l ?? { text: "" }, text: "" }));
@@ -2371,18 +2696,27 @@ function App({ client, config, wallet, session, initialTask }) {
           );
           return;
         case "tool_result": {
-          lastOutputRef.current = event.result;
+          const summary = runningToolRef.current?.summary ?? "";
+          setLive((l) => l ? { text: l.text, tool: void 0 } : l);
+          if (event.display) {
+            push({ kind: "tool", name: event.name, summary, output: `  ${event.display}`, ok: event.ok });
+            runningToolRef.current = null;
+            return;
+          }
           const lines = event.result.split("\n").filter((l) => l.trim() !== "");
           const shown = lines.slice(0, COMMITTED_OUTPUT_LINES).map((l) => l.slice(0, Math.max(20, cols - 8)));
-          setLive((l) => l ? { text: l.text, tool: void 0 } : l);
-          push({
+          const more = Math.max(0, lines.length - shown.length);
+          const id = push({
             kind: "tool",
             name: event.name,
-            summary: runningToolRef.current?.summary ?? "",
+            summary,
             output: shown.join("\n"),
-            outputMore: Math.max(0, lines.length - shown.length),
+            outputMore: more,
             ok: event.ok
           });
+          if (more > 0) {
+            outputsRef.current.push({ id, label: `${event.name} ${summary}`.trim(), output: event.result });
+          }
           runningToolRef.current = null;
           return;
         }
@@ -2394,7 +2728,7 @@ function App({ client, config, wallet, session, initialTask }) {
           return;
       }
     },
-    [cols, push]
+    [cols, flushDelta, push]
   );
   const runTurn2 = useCallback(
     async (task) => {
@@ -2427,8 +2761,18 @@ function App({ client, config, wallet, session, initialTask }) {
           model,
           root,
           history,
-          systemPrompt: contextRef.current.systemPrompt,
+          // The mode is read at the moment the turn starts and appended to the
+          // project context, so the model is told the rule instead of paying a
+          // round-trip to discover it. Rebuilt per turn: shift+tab, `/mode` and
+          // an approved plan all move it mid-conversation.
+          systemPrompt: `${contextRef.current.systemPrompt}
+
+${modeInstruction(permRef.current.mode)}`,
           permit,
+          approvePlan,
+          // Asked per model call, not once: approving a plan restores the write
+          // tools in the middle of a turn.
+          tools: () => toolSchemaFor(permRef.current.mode),
           signal: ac.signal,
           onEvent: handleEvent
         });
@@ -2440,7 +2784,10 @@ function App({ client, config, wallet, session, initialTask }) {
           updated: (/* @__PURE__ */ new Date()).toISOString(),
           cwd: root,
           model,
-          title: (session?.title || task).slice(0, 80),
+          // The first line only: an `@path` message carries the whole file after
+          // a blank line, and a session titled with a file's contents is not a
+          // title. What the user typed is always the first line.
+          title: (session?.title || task.split("\n")[0] || task).slice(0, 80),
           messages: next
         });
         if (result.stopped === "aborted") {
@@ -2474,12 +2821,25 @@ function App({ client, config, wallet, session, initialTask }) {
         }
       } finally {
         abortRef.current = null;
+        dropDelta();
         setLive(null);
         setBusy(false);
         setSponsor(null);
       }
     },
-    [client, contextWindow, handleEvent, model, nextSponsor, permit, push, root, session?.title]
+    [
+      approvePlan,
+      client,
+      contextWindow,
+      dropDelta,
+      handleEvent,
+      model,
+      nextSponsor,
+      permit,
+      push,
+      root,
+      session?.title
+    ]
   );
   const stopCurrent = useCallback(() => {
     abortRef.current?.abort();
@@ -2612,10 +2972,20 @@ function App({ client, config, wallet, session, initialTask }) {
         case "help":
           push({ kind: "notice", text: helpText() });
           return;
+        // Clears both halves of what "clear" means: the model's context *and*
+        // the screen. It used to drop only the context, so nothing visibly
+        // happened and the transcript of a conversation the agent could no
+        // longer remember stayed sitting there.
         case "clear":
           setMessages([]);
+          setEntries([]);
+          setStaticEpoch((n) => n + 1);
+          outputsRef.current = [];
+          expandedRef.current = /* @__PURE__ */ new Set();
+          heightCacheRef.current = /* @__PURE__ */ new Map();
           sessionRef.current = { id: newSessionId(), started: (/* @__PURE__ */ new Date()).toISOString() };
-          push({ kind: "notice", text: "  (context cleared)" });
+          writeToStdout("\x1B[2J\x1B[3J\x1B[H");
+          push({ kind: "notice", text: "  cleared \u2014 new session, empty context" });
           return;
         case "mode": {
           const wanted = MODES.find((m) => m.toLowerCase() === arg.toLowerCase().replace(/[-\s]/g, ""));
@@ -2643,7 +3013,7 @@ function App({ client, config, wallet, session, initialTask }) {
               [{ role: "system", content: contextRef.current.systemPrompt }, ...messagesRef.current],
               { signal }
             );
-            if (!res) return push({ kind: "notice", text: "  nothing to compact yet" });
+            if (!res) return void push({ kind: "notice", text: "  nothing to compact yet" });
             setMessages(res.messages.slice(1));
             setBalance(res.balance);
             setSpent((s) => s + res.creditsCharged);
@@ -2662,7 +3032,7 @@ function App({ client, config, wallet, session, initialTask }) {
           await runBusy(LOADING, async (signal) => {
             const models = catalogRef.current.length ? catalogRef.current : await client.models(signal);
             catalogRef.current = models;
-            if (!models.length) return push({ kind: "notice", tone: "error", text: "  could not load the model list" });
+            if (!models.length) return void push({ kind: "notice", tone: "error", text: "  could not load the model list" });
             if (arg && !models.some((m) => m.id === arg)) {
               push({ kind: "notice", tone: "warn", text: `  unknown model: ${arg}` });
             }
@@ -2716,6 +3086,47 @@ function App({ client, config, wallet, session, initialTask }) {
         // The same browser handoff the paywall takes, rather than a second way of
         // doing it: /earn used to call the dev-only /v1/ads/reward simulator, so
         // in production the slash command the paywall itself recommends was a 404.
+        // Resuming without leaving the REPL. `--continue` and `--resume` have
+        // always existed as flags, which means the only way to pick up an
+        // earlier conversation was to quit the one you were in.
+        case "resume":
+        case "sessions": {
+          const metas = listSessions(root, 10);
+          if (!metas.length) {
+            push({ kind: "notice", tone: "warn", text: "  no saved sessions in this directory yet" });
+            return;
+          }
+          const load = (id) => {
+            const found = loadSession(id);
+            if (!found) {
+              push({ kind: "notice", tone: "error", text: `  no such session: ${id}` });
+              return;
+            }
+            setMessages(found.messages);
+            sessionRef.current = { id: found.id, started: found.started };
+            push({
+              kind: "notice",
+              tone: "good",
+              text: `  resumed ${found.id} \u2014 ${found.messages.length} messages
+  ${found.title}`
+            });
+          };
+          if (arg) return load(arg);
+          const items = metas.map((m) => ({
+            value: m.id,
+            label: m.updated.slice(0, 16).replace("T", " "),
+            hint: m.title.slice(0, 60),
+            current: m.id === sessionRef.current.id
+          }));
+          setPickerSel(0);
+          setPicker({
+            title: "Resume a session",
+            subtitle: "Replaces the current conversation; nothing on screen is lost.",
+            items,
+            onPick: (choice) => load(choice.value)
+          });
+          return;
+        }
         case "earn":
           await runAdWall();
           return;
@@ -2726,7 +3137,74 @@ function App({ client, config, wallet, session, initialTask }) {
           push({ kind: "notice", tone: "warn", text: `  unknown command: /${cmd} \u2014 try /help` });
       }
     },
-    [client, config, cycleMode, exit, model, push, runAdWall, runBusy, runLogin, runTurn2]
+    [client, config, cycleMode, exit, model, push, root, runAdWall, runBusy, runLogin, runTurn2, writeToStdout]
+  );
+  const runShell = useCallback(
+    async (command) => {
+      push({ kind: "user", text: `!${command}` });
+      let output = "";
+      await runBusy(RUNNING, async (signal) => {
+        output = await TOOLS.run_command(
+          {
+            root,
+            signal,
+            onOutput: (chunk) => setLive((l) => ({
+              text: l?.text ?? "",
+              tool: { name: "!", summary: command, output: tailLines((l?.tool?.output ?? "") + chunk, LIVE_OUTPUT_LINES) }
+            }))
+          },
+          { command }
+        );
+        const lines = output.split("\n").filter((l) => l.trim() !== "");
+        const shown = lines.slice(0, COMMITTED_OUTPUT_LINES).map((l) => l.slice(0, Math.max(20, cols - 8)));
+        const more = Math.max(0, lines.length - shown.length);
+        const id = push({
+          kind: "tool",
+          name: "!",
+          summary: command,
+          output: shown.join("\n"),
+          outputMore: more,
+          ok: true
+        });
+        if (more > 0) outputsRef.current.push({ id, label: `! ${command}`, output });
+      });
+      setLive(null);
+      if (output) {
+        setMessages((prev) => [
+          ...prev,
+          { role: "user", content: `I ran \`${command}\` in the workspace myself. Its output:
+
+${output}` }
+        ]);
+      }
+    },
+    [cols, push, root, runBusy]
+  );
+  const dispatchLine = useCallback(
+    async (line2) => {
+      if (line2.startsWith("!")) {
+        const command = line2.slice(1).trim();
+        if (!command) return;
+        return runShell(command);
+      }
+      push({ kind: "user", text: line2 });
+      if (line2.startsWith("/")) return runCommand(line2);
+      const { text: task, attached } = expandMentions(line2, root);
+      if (attached.length) {
+        push({ kind: "notice", text: `  attached ${attached.join(", ")}` });
+      }
+      return runTurn2(task);
+    },
+    [push, root, runCommand, runShell, runTurn2]
+  );
+  const runSerially = useCallback(
+    async (line2) => {
+      await dispatchLine(line2);
+      for (let next = dequeue(); next !== void 0; next = dequeue()) {
+        await dispatchLine(next);
+      }
+    },
+    [dequeue, dispatchLine]
   );
   const submit = useCallback(
     async (raw) => {
@@ -2740,16 +3218,14 @@ function App({ client, config, wallet, session, initialTask }) {
         saveHistory(next);
         return next;
       });
-      push({ kind: "user", text: line2 });
-      if (line2.startsWith("/")) return runCommand(line2);
-      return runTurn2(line2);
+      if (busyRef.current) return void enqueue(line2);
+      return runSerially(line2);
     },
-    [push, runCommand, runTurn2]
+    [enqueue, runSerially]
   );
   useEffect(() => {
     if (!initialTask) return;
-    push({ kind: "user", text: initialTask });
-    void runTurn2(initialTask);
+    void runSerially(initialTask);
   }, []);
   const text = toText(editor);
   const cursor = offset(editor);
@@ -2760,7 +3236,7 @@ function App({ client, config, wallet, session, initialTask }) {
     }) : [],
     [query, root]
   );
-  const menu = menuOff || busy || ask2 || picker ? [] : matches;
+  const menu = menuOff || ask2 || picker || plan ? [] : matches;
   useEffect(() => {
     setSel(0);
     setMenuOff(false);
@@ -2773,6 +3249,11 @@ function App({ client, config, wallet, session, initialTask }) {
     },
     [cursor, query, text]
   );
+  usePaste((text2) => {
+    if (ask2 || picker || plan) return;
+    setEditor((state) => insert(state, text2));
+    setHistIdx(-1);
+  });
   useInput((ch, key) => {
     if (key.ctrl && ch === "c") {
       if (busy) return stopCurrent();
@@ -2783,8 +3264,32 @@ function App({ client, config, wallet, session, initialTask }) {
       return;
     }
     if (quitHint) setQuitHint(false);
+    if (plan) {
+      const decision = ch === "y" || ch === "j" || key.return ? "normal" : ch === "a" ? "acceptEdits" : ch === "n" ? "keepPlanning" : void 0;
+      if (key.escape) {
+        setPlan(null);
+        plan.resolve("keepPlanning");
+        stopCurrent();
+        return;
+      }
+      if (!decision) return;
+      setPlan(null);
+      plan.resolve(decision);
+      push({
+        kind: "notice",
+        tone: decision === "keepPlanning" ? "warn" : "good",
+        text: decision === "keepPlanning" ? "  keeping plan mode on \u2014 say what you'd like changed" : `  plan approved \xB7 mode \u2192 ${MODE_LABEL[decision]}`
+      });
+      return;
+    }
     if (ask2) {
-      const answer = ch === "y" || ch === "j" || key.return ? "once" : ch === "a" ? "always" : ch === "n" || key.escape ? "deny" : void 0;
+      if (key.escape) {
+        setAsk(null);
+        ask2.resolve("deny");
+        stopCurrent();
+        return;
+      }
+      const answer = ch === "y" || ch === "j" || key.return ? "once" : ch === "a" ? "always" : ch === "n" ? "deny" : void 0;
       if (!answer) return;
       setAsk(null);
       ask2.resolve(answer);
@@ -2801,7 +3306,10 @@ function App({ client, config, wallet, session, initialTask }) {
       if (key.upArrow) return setPickerSel((s) => (s - 1 + n) % n);
       if (key.downArrow) return setPickerSel((s) => (s + 1) % n);
       if (/^[1-9]$/.test(ch)) {
-        const choice = picker.items[Number(ch) - 1];
+        const { from, count } = pickerWindowRef.current;
+        const row = Number(ch);
+        if (row > count) return;
+        const choice = picker.items[from + row - 1];
         if (!choice) return;
         setPicker(null);
         return picker.onPick(choice);
@@ -2813,14 +3321,38 @@ function App({ client, config, wallet, session, initialTask }) {
       }
       return;
     }
-    if (busy) {
-      if (key.escape) stopCurrent();
+    if (busy && key.escape) {
+      const dropped = queueRef.current;
+      if (dropped.length) {
+        queueRef.current = [];
+        syncQueue();
+        push({
+          kind: "notice",
+          tone: "warn",
+          text: `  not sent:
+${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
+        });
+      }
+      stopCurrent();
       return;
     }
     if (key.tab && key.shift) return cycleMode();
     if (key.ctrl && ch === "o") {
-      const out = lastOutputRef.current;
-      if (out) push({ kind: "notice", text: out.split("\n").map((l) => `  ${l}`).join("\n") });
+      const next = [...outputsRef.current].reverse().find((o) => !expandedRef.current.has(o.id));
+      if (!next) {
+        push({ kind: "notice", text: "  nothing left to expand" });
+        return;
+      }
+      expandedRef.current.add(next.id);
+      const lines = next.output.split("\n");
+      const shown = lines.slice(0, EXPAND_MAX_LINES);
+      const dropped = lines.length - shown.length;
+      push({
+        kind: "notice",
+        text: `  ${next.label}
+` + shown.map((l) => `  ${l}`).join("\n") + (dropped > 0 ? `
+  \u2026 +${dropped} more lines (not shown)` : "")
+      });
       return;
     }
     if (menu.length > 0) {
@@ -2836,7 +3368,7 @@ function App({ client, config, wallet, session, initialTask }) {
     if (key.return) {
       if (key.meta || key.shift) return setEditor(newline(editor));
       if (endsWithContinuation(editor)) return setEditor(continueLine(editor));
-      if (pendingTaskRef.current && isEmpty(editor)) return void runAdWall();
+      if (!busy && pendingTaskRef.current && isEmpty(editor)) return void runAdWall();
       return void submit(toText(editor));
     }
     if (key.ctrl && ch === "j") return setEditor(newline(editor));
@@ -2860,62 +3392,120 @@ function App({ client, config, wallet, session, initialTask }) {
   const elapsed = busy && startedAt ? Math.floor((Date.now() - startedAt) / 1e3) : 0;
   const spinner = SPINNER[tick % SPINNER.length];
   const sponsorLine = busy && sponsor ? sponsorText(sponsor, cols) : null;
-  const liveText = live?.text ? tailLines(live.text, Math.max(4, rows - 12)) : "";
-  const liveBlock = [
-    liveText,
+  const viewport = Math.max(6, rows - 1);
+  const inputRows = Math.max(1, Math.min(MAX_INPUT_ROWS, editor.lines.length));
+  const inputFrom = windowStart(editor.row, editor.lines.length, inputRows);
+  const inputBoxHeight = 2 + inputRows;
+  const queueRows = [
+    ...queueView.slice(0, MAX_QUEUE_ROWS).map((line2) => line2.replace(/\s+/g, " ").slice(0, Math.max(10, cols - 6))),
+    ...queueView.length > MAX_QUEUE_ROWS ? [`+${queueView.length - MAX_QUEUE_ROWS} more queued`] : []
+  ];
+  const chromeHeight = inputBoxHeight + 2 + (sponsorLine ? 1 : 0) + queueRows.length;
+  let budget = Math.max(0, viewport - chromeHeight - menu.length);
+  const PICKER_CHROME = 8;
+  const pickerRows = picker ? Math.max(1, Math.min(MAX_PICKER_ROWS, picker.items.length, budget - PICKER_CHROME)) : 0;
+  const pickerFrom = picker ? windowStart(pickerSel, picker.items.length, pickerRows) : 0;
+  const pickerItems = picker ? picker.items.slice(pickerFrom, pickerFrom + pickerRows) : [];
+  const pickerHeight = picker ? pickerItems.length + PICKER_CHROME : 0;
+  pickerWindowRef.current = { from: pickerFrom, count: pickerItems.length };
+  const pickerLabelW = picker ? picker.items.reduce((w, i) => Math.max(w, i.label.length), 0) : 0;
+  budget -= pickerHeight;
+  const ASK_CHROME = 4;
+  const askSummaryRows = ask2 ? lineCount(ask2.req.summary, cols) : 0;
+  const askPreview = ask2?.req.preview ? headRows(ask2.req.preview, cols, Math.max(1, budget - ASK_CHROME - askSummaryRows)) : "";
+  const askHeight = ask2 ? askSummaryRows + lineCount(askPreview, cols) * (askPreview ? 1 : 0) + ASK_CHROME : 0;
+  budget -= askHeight;
+  const PLAN_CHROME = 6;
+  const planBlock = plan ? headRows(plan.plan, cols, Math.max(1, budget - PLAN_CHROME)) : "";
+  const planHeight = plan ? lineCount(planBlock, cols) + PLAN_CHROME : 0;
+  budget -= planHeight;
+  const busyHeight = busy ? 2 : 0;
+  budget -= busyHeight;
+  const liveRaw = [
+    // Trailing blank lines are rows the clamp would spend on nothing, and a
+    // streamed answer ends on one more often than not.
+    (live?.text ?? "").replace(/\n+$/, ""),
     live?.tool ? `\u23FA ${live.tool.name} ${live.tool.summary}` : "",
     live?.tool?.output ?? ""
   ].filter(Boolean).join("\n");
-  const askBlock = ask2 ? [ask2.req.summary, ask2.req.preview ?? ""].filter(Boolean).join("\n") : "";
-  const pickerHeight = picker ? picker.items.length + 8 : 0;
-  const pickerLabelW = picker ? picker.items.reduce((w, i) => Math.max(w, i.label.length), 0) : 0;
-  const inputBoxHeight = 2 + editor.lines.length;
-  const chromeHeight = inputBoxHeight + 2 + (sponsorLine ? 1 : 0);
+  const liveBlock = tailRows(liveRaw, cols, Math.max(0, budget - 1));
   const liveHeight = liveBlock ? lineCount(liveBlock, cols) + 1 : 0;
-  const askHeight = ask2 ? lineCount(askBlock, cols) + 2 : 0;
-  const printed = useMemo(() => entries.reduce((n, e) => n + entryHeight(e, cols), 0), [entries, cols]);
-  const spacer = Math.max(
-    0,
-    rows - 1 - printed - chromeHeight - menu.length - pickerHeight - liveHeight - askHeight
-  );
+  const printed = useMemo(() => {
+    const cache = heightCacheRef.current;
+    return entries.reduce((n, e) => {
+      const key = `${e.id}:${cols}`;
+      let h = cache.get(key);
+      if (h === void 0) {
+        h = entryHeight(e, cols);
+        cache.set(key, h);
+      }
+      return n + h;
+    }, 0);
+  }, [entries, cols]);
+  const used = chromeHeight + menu.length + pickerHeight + askHeight + planHeight + busyHeight + liveHeight;
+  const spacer = Math.max(0, viewport - printed - used);
   const labelW = menu.reduce((w, c2) => Math.max(w, c2.label.length), 0);
+  const contextPct = useMemo(() => {
+    const window = contextWindow(model);
+    if (!window) return 0;
+    const used2 = conversationTokens([
+      { role: "system", content: contextRef.current.systemPrompt },
+      ...messages
+    ]);
+    return used2 / window;
+  }, [contextWindow, messages, model]);
   return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx2(Static, { items: entries, children: (entry) => /* @__PURE__ */ jsx2(EntryView, { entry }, entry.id) }),
+    /* @__PURE__ */ jsx2(Static, { items: entries, children: (entry) => /* @__PURE__ */ jsx2(EntryView, { entry }, entry.id) }, staticEpoch),
     spacer > 0 ? /* @__PURE__ */ jsx2(Box2, { height: spacer }) : null,
     liveBlock ? /* @__PURE__ */ jsx2(Box2, { marginTop: 1, children: /* @__PURE__ */ jsx2(Text2, { children: liveBlock }) }) : null,
+    busy ? /* @__PURE__ */ jsxs2(Box2, { marginTop: 1, children: [
+      /* @__PURE__ */ jsxs2(Text2, { color: MANGO3, children: [
+        spinner,
+        " "
+      ] }),
+      /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
+        busyLabel,
+        " ",
+        elapsed,
+        "s \xB7 esc to stop"
+      ] })
+    ] }) : null,
     ask2 ? /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", marginTop: 1, borderStyle: "round", borderColor: "yellow", paddingX: 1, children: [
       /* @__PURE__ */ jsx2(Text2, { bold: true, color: "yellow", children: ask2.req.summary }),
-      ask2.req.preview ? /* @__PURE__ */ jsx2(Text2, { children: ask2.req.preview }) : null,
-      /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "[y/\u23CE] once \xB7 [a] always \xB7 [n] no \xB7 esc cancels" })
+      askPreview ? /* @__PURE__ */ jsx2(Text2, { children: askPreview }) : null,
+      /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "[y/\u23CE] once \xB7 [a] always \xB7 [n] no \xB7 esc stops the turn" })
+    ] }) : null,
+    plan ? /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", marginTop: 1, borderStyle: "round", borderColor: MODE_STYLE.plan.color, paddingX: 1, children: [
+      /* @__PURE__ */ jsx2(Text2, { bold: true, color: MODE_STYLE.plan.color, children: `${MODE_STYLE.plan.glyph} Ready to act on this plan?` }),
+      /* @__PURE__ */ jsx2(Box2, { height: 1 }),
+      /* @__PURE__ */ jsx2(Text2, { children: renderMarkdown(planBlock) }),
+      /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "[y/\u23CE] yes, ask before edits \xB7 [a] yes, auto-accept edits \xB7 [n] keep planning \xB7 esc stops the turn" })
     ] }) : null,
     picker ? /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", marginTop: 1, borderStyle: "round", borderColor: MANGO3, paddingX: 1, children: [
       /* @__PURE__ */ jsx2(Text2, { bold: true, color: MANGO_BRIGHT, children: picker.title }),
       /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: picker.subtitle }),
       /* @__PURE__ */ jsx2(Box2, { height: 1 }),
-      picker.items.map((item, i) => /* @__PURE__ */ jsxs2(Box2, { children: [
-        /* @__PURE__ */ jsxs2(Text2, { color: i === pickerSel ? MANGO_BRIGHT : void 0, bold: i === pickerSel, children: [
-          i === pickerSel ? "\u276F " : "  ",
-          `${i + 1}. `,
-          item.label.padEnd(pickerLabelW + 2)
-        ] }),
-        /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: item.hint }),
-        item.current ? /* @__PURE__ */ jsx2(Text2, { color: "green", children: "  \u2190 current" }) : null
-      ] }, item.value)),
+      pickerItems.map((item, i) => {
+        const index = pickerFrom + i;
+        return /* @__PURE__ */ jsxs2(Box2, { children: [
+          /* @__PURE__ */ jsxs2(Text2, { color: index === pickerSel ? MANGO_BRIGHT : void 0, bold: index === pickerSel, children: [
+            index === pickerSel ? "\u276F " : "  ",
+            `${i + 1}. `,
+            item.label.padEnd(pickerLabelW + 2)
+          ] }),
+          /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: item.hint }),
+          item.current ? /* @__PURE__ */ jsx2(Text2, { color: "green", children: "  \u2190 current" }) : null
+        ] }, item.value);
+      }),
       /* @__PURE__ */ jsx2(Box2, { height: 1 }),
-      /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "\u2191\u2193 choose \xB7 1-9 jump straight to a row \xB7 \u23CE confirm \xB7 esc cancel" })
+      /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: picker.items.length > pickerItems.length ? `\u2191\u2193 choose (${pickerFrom + 1}-${pickerFrom + pickerItems.length} of ${picker.items.length}) \xB7 1-${pickerItems.length} jump \xB7 \u23CE confirm \xB7 esc cancel` : `\u2191\u2193 choose \xB7 1-${Math.min(9, pickerItems.length)} jump straight to a row \xB7 \u23CE confirm \xB7 esc cancel` })
     ] }) : null,
     /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", marginTop: 1, children: [
+      queueRows.map((line2, i) => /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: `  \u23F3 ${line2}` }, i)),
       sponsorLine ? /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: sponsorLine }) : null,
-      /* @__PURE__ */ jsxs2(Box2, { borderStyle: "round", borderColor: busy ? MANGO_BRIGHT : MANGO3, paddingX: 1, children: [
+      /* @__PURE__ */ jsxs2(Box2, { borderStyle: "round", borderColor: busy ? MANGO3 : MANGO_BRIGHT, paddingX: 1, children: [
         /* @__PURE__ */ jsx2(Text2, { color: MANGO_BRIGHT, children: "\u276F " }),
-        busy ? /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
-          spinner,
-          " ",
-          busyLabel,
-          " ",
-          elapsed,
-          "s \xB7 esc to stop"
-        ] }) : /* @__PURE__ */ jsx2(Text2, { children: renderInput(editor) })
+        /* @__PURE__ */ jsx2(Text2, { children: renderInput(editor, inputFrom, inputRows) })
       ] }),
       menu.map((item, i) => /* @__PURE__ */ jsxs2(Box2, { children: [
         /* @__PURE__ */ jsxs2(Text2, { color: i === sel ? MANGO_BRIGHT : MANGO3, bold: i === sel, children: [
@@ -2924,17 +3514,21 @@ function App({ client, config, wallet, session, initialTask }) {
         ] }),
         /* @__PURE__ */ jsx2(Text2, { dimColor: i !== sel, children: item.hint })
       ] }, item.value)),
-      /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
+      quitHint || menu.length > 0 ? /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
         "  ",
-        statusLine({
-          menu: menu.length > 0,
-          quitHint,
-          model,
-          balance,
-          spent,
-          mode,
-          minutes: (Date.now() - runStartedAtRef.current) / 6e4
-        })
+        quitHint ? "press ctrl+c again to quit" : "\u2191\u2193 choose \xB7 \u23CE run \xB7 tab complete \xB7 esc close"
+      ] }) : /* @__PURE__ */ jsxs2(Box2, { children: [
+        /* @__PURE__ */ jsx2(Text2, { color: MODE_STYLE[mode].color, bold: true, children: `  ${MODE_STYLE[mode].glyph} ${MODE_LABEL[mode]}` }),
+        /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
+          "  ",
+          statusLine({
+            model,
+            balance,
+            spent,
+            contextPct,
+            minutes: (Date.now() - runStartedAtRef.current) / 6e4
+          })
+        ] })
       ] })
     ] })
   ] });
@@ -2951,9 +3545,10 @@ function sleep2(ms, signal) {
     signal.addEventListener("abort", done, { once: true });
   });
 }
-function renderInput(state) {
-  return state.lines.map((line2, row) => {
-    const prefix = row === 0 ? "" : "\n";
+function renderInput(state, from, rows) {
+  return state.lines.slice(from, from + rows).map((line2, i) => {
+    const row = from + i;
+    const prefix = i === 0 ? "" : "\n";
     if (row !== state.row) return /* @__PURE__ */ jsx2(Text2, { children: prefix + line2 }, row);
     const before = line2.slice(0, state.col);
     const at = line2.slice(state.col, state.col + 1) || " ";
@@ -2966,19 +3561,21 @@ function renderInput(state) {
   });
 }
 function statusLine(o) {
-  if (o.quitHint) return "press ctrl+c again to quit";
-  if (o.menu) return "\u2191\u2193 choose \xB7 \u23CE run \xB7 tab complete \xB7 esc close";
   const burn = o.spent > 0 && o.minutes >= 1 ? `${Math.round(o.spent / o.minutes).toLocaleString("en-US")} cr/min` : void 0;
   const parts = [
     o.model,
     `${o.balance.toLocaleString("en-US")} cr`,
-    o.spent > 0 ? `\u2212${o.spent.toLocaleString("en-US")} this session` : void 0,
+    o.spent > 0 ? `\u2212${o.spent.toLocaleString("en-US")}` : void 0,
     burn,
-    MODE_LABEL[o.mode],
+    o.contextPct >= CONTEXT_NOTICE_AT ? `context ${Math.round(o.contextPct * 100)}%` : void 0,
     "/help"
   ].filter(Boolean);
   return parts.join(" \xB7 ");
 }
+function windowStart(sel, total, size) {
+  if (total <= size) return 0;
+  return Math.max(0, Math.min(total - size, sel - Math.floor(size / 2)));
+}
 function toEditorKey(ch, key) {
   const name = key.leftArrow ? "left" : key.rightArrow ? "right" : key.upArrow ? "up" : key.downArrow ? "down" : key.backspace ? "backspace" : key.delete ? "delete" : void 0;
   return {
@@ -3011,7 +3608,7 @@ function tailLines(text, max) {
   const lines = text.split("\n");
   return lines.length <= max ? text : lines.slice(-max).join("\n");
 }
-var SPINNER, WORKING, WAITING_FOR_REWARD, LOADING, COMPACTING, SIGNING_IN, NOT_SIGNED_IN, LIVE_OUTPUT_LINES, COMMITTED_OUTPUT_LINES;
+var SPINNER, WORKING, WAITING_FOR_REWARD, LOADING, COMPACTING, SIGNING_IN, RUNNING, NOT_SIGNED_IN, LIVE_OUTPUT_LINES, COMMITTED_OUTPUT_LINES, DELTA_FLUSH_MS, MAX_INPUT_ROWS, MAX_PICKER_ROWS, MAX_QUEUE_ROWS, EXPAND_MAX_LINES, CONTEXT_NOTICE_AT;
 var init_app = __esm({
   "src/tui/app.tsx"() {
     "use strict";
@@ -3021,12 +3618,14 @@ var init_app = __esm({
     init_banner();
     init_agent();
     init_context();
+    init_mentions();
     init_compact();
     init_kimi();
     init_browser();
     init_version();
     init_tools();
     init_permissions();
+    init_tools();
     init_session();
     init_counter();
     init_provider();
@@ -3034,6 +3633,7 @@ var init_app = __esm({
     init_commands();
     init_editor();
     init_suggest();
+    init_markdown();
     init_views();
     SPINNER = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
     WORKING = "working\u2026";
@@ -3041,9 +3641,16 @@ var init_app = __esm({
     LOADING = "loading\u2026";
     COMPACTING = "compacting\u2026";
     SIGNING_IN = "signing in\u2026";
+    RUNNING = "running\u2026";
     NOT_SIGNED_IN = "  Not signed in, or the stored token isn't valid for this gateway.\n  Run /login to sign in.";
     LIVE_OUTPUT_LINES = 5;
     COMMITTED_OUTPUT_LINES = 4;
+    DELTA_FLUSH_MS = 50;
+    MAX_INPUT_ROWS = 10;
+    MAX_PICKER_ROWS = 12;
+    MAX_QUEUE_ROWS = 3;
+    EXPAND_MAX_LINES = 400;
+    CONTEXT_NOTICE_AT = 0.6;
   }
 });
 
@@ -3165,9 +3772,13 @@ async function main() {
     case void 0:
       return repl(client, config);
     default:
-      console.error(c.red(`unknown command: ${cmd}`));
-      printHelp();
-      process.exitCode = 1;
+      if (cmd.startsWith("-")) {
+        console.error(c.red(`unknown option: ${cmd}`));
+        printHelp();
+        process.exitCode = 1;
+        return;
+      }
+      return repl(client, config, { task: [cmd, ...rest].join(" ").trim() });
   }
 }
 async function login(client, config, args) {
@@ -3527,7 +4138,8 @@ function printHelp() {
   ${c.cyan("--continue")}        resume the last session in this directory
   ${c.cyan("--resume")} [id]     list saved sessions, or resume one
   ${c.cyan("--version")}         print the version and exit
-  (no command)        interactive coding REPL ${c.dim("(signs you in if needed)")}`);
+  (no command)        interactive coding REPL ${c.dim("(signs you in if needed)")}
+  "<task>"            same as ${c.cyan("agent")} \u2014 anything that is not a command is a task`);
 }
 main().catch((err) => {
   console.error(c.red(err.message));