@cryer/star-cli 0.3.8 → 0.3.9

package/dist/{repl-YA23CK5R.js → repl-OO7C6V7M.js}

@@ -6,8 +6,8 @@ import {
   buildDisplayMessages,
   clearSessions,
   computeCostUsd,
-  coreMessageText,
   estimateCost,
+  folderIcon,
   formatByteCount,
   formatDollars,
   formatElapsedSeconds,
@@ -25,65 +25,81 @@ import {
   shortSessionId,
   splitCommittableLines,
   summarizeArgs,
+  thinkingIcon,
   toTerminalSafe,
-  upsertEnvContent
-} from "./chunk-IYWYSFSF.js";
+  toolIcon
+} from "./chunk-VJFWTXWN.js";
 import {
   AgentLoop,
-  MAX_IMAGE_DIMENSION,
-  SKIP_DIRS,
-  TodoStore,
   WORKING_DIFF_MAX_LINES,
   appendUserMemory,
-  bashTool,
   buildAllowRule,
   buildCommitPrompt,
-  clearSnapshots,
   collectCommitContext,
   collectWorkingDiff,
   compactMessages,
+  discoverSkills,
+  estimateTokens,
+  getGitSummaryCached,
+  isAllowedByRules,
+  isDangerousCommand,
+  isGitRepo,
+  summarizeMessages
+} from "./chunk-RE3NOULF.js";
+import {
   contextWindowTokens,
+  coreMessageText,
+  diffTreeNames,
+  reconcileStarMessages,
+  toCoreMessages
+} from "./chunk-56ZIA57D.js";
+import {
+  createModel,
+  reasoningEffortMetadata
+} from "./chunk-MVAMPVTA.js";
+import {
+  listModels,
+  resolveModelConfig
+} from "./chunk-4IRY44TG.js";
+import {
   createDefaultRegistry,
+  formatTaskFinished,
+  formatTaskList,
+  formatTaskStarted
+} from "./chunk-OIJYNQFZ.js";
+import {
+  MAX_IMAGE_DIMENSION,
+  SKIP_DIRS,
+  TodoStore,
+  bashTool,
+  clearSnapshots,
   createIgnorePredicate,
-  createModel,
   defaultAgentTasks,
   defaultTaskManager,
-  diffTreeNames,
-  discoverSkills,
   downsampleImageIfNeeded,
   envFilePath,
-  estimateTokens,
   formatAgentTaskUpdate,
-  formatTaskFinished,
-  formatTaskList,
-  formatTaskStarted,
   formatTodos,
-  getGitSummaryCached,
   globalConfigPath,
   hydrateSnapshots,
-  isAllowedByRules,
-  isDangerousCommand,
-  isGitRepo,
-  listModels,
   listSnapshots,
   listTurnSnapshots,
   loadTodos,
   parseTodoArgs,
-  reasoningEffortMetadata,
-  reconcileToolCalls,
   resetTodos,
-  resolveModelConfig,
   resolveShell,
   resolveSnapshotContent,
   rewindToSnapshot,
+  sessionsDir,
+  setTodoSession,
   starHome,
-  summarizeMessages,
+  upsertEnvContent,
   userMemoryPath
-} from "./chunk-OHLA2DP7.js";
+} from "./chunk-A5PXPWHB.js";
 
 // src/cli/repl.tsx
 import { Box as Box13, Text as Text14, render, useApp } from "ink";
-import { useCallback, useEffect as useEffect3, useMemo, useRef as useRef6, useState as useState5 } from "react";
+import { useCallback, useEffect as useEffect4, useMemo, useRef as useRef6, useState as useState7 } from "react";
 
 // src/config/save.ts
 import fs from "fs";
@@ -99,6 +115,10 @@ async function writeFileAtomic(filePath, content) {
   const tmpPath = `${filePath}.${process.pid}.tmp`;
   await fs.promises.writeFile(tmpPath, content, "utf8");
   await fs.promises.rename(tmpPath, filePath);
+  try {
+    await fs.promises.chmod(filePath, 384);
+  } catch {
+  }
 }
 function upsertPermissionRuleText(content, kind, rules, hadPermissionsTable) {
   const newLine = `${kind} = [${rules.map(tomlString).join(", ")}]`;
@@ -265,8 +285,8 @@ async function saveReasoningEffort(modelName, effort) {
 async function resumeSession(id) {
   const store = await SessionStore.open(id);
   if (!store) return null;
-  const [meta, loaded] = await Promise.all([store.meta(), store.messages()]);
-  const messages = reconcileToolCalls(loaded);
+  const [meta, loaded] = await Promise.all([store.meta(), store.starMessages()]);
+  const messages = reconcileStarMessages(loaded);
   if (messages.length !== loaded.length) {
     await store.replaceMessages(messages);
   }
@@ -609,14 +629,14 @@ async function compactSession(opts) {
   if (!(backend instanceof AgentLoop)) {
     return { message: "Current backend does not support compaction.", compacted: false };
   }
-  const messages = [...backend.getMessages()];
+  const messages = [...backend.getStarMessages()];
   if (messages.length < MIN_COMPACT_MESSAGES) {
     return {
       message: `Nothing to compact: history has only ${messages.length} message(s).`,
       compacted: false
     };
   }
-  const beforeTokens = estimateTokens(messages);
+  const beforeTokens = estimateTokens(toCoreMessages(messages));
   const compacted = compactMessages(messages, config.contextMaxTokens, { force: true });
   if (!compacted.compacted) {
     return {
@@ -629,33 +649,44 @@ async function compactSession(opts) {
     compacted,
     config,
     backend.getAuxModel(),
-    backend.getAuxTemperature()
+    backend.getAuxTemperature(),
+    opts.signal
   );
+  if (next === null || opts.signal?.aborted) {
+    return { message: "Compaction cancelled \u2014 history left unchanged.", compacted: false };
+  }
   await backend.loadMessages(next);
   await sessionStore?.replaceMessages(next);
-  const afterTokens = estimateTokens(next);
+  const coreNext = toCoreMessages(next);
+  const afterTokens = estimateTokens(coreNext);
   return {
     message: `Compacted context: ${messages.length} -> ${next.length} messages (~${formatTokens(beforeTokens)} -> ~${formatTokens(afterTokens)} estimated tokens).`,
     compacted: true,
-    messages: next
+    messages: coreNext
   };
 }
-async function applyCompactionSummary(original, compacted, config, model, temperature) {
+async function applyCompactionSummary(original, compacted, config, model, temperature, signal) {
   if (config.contextCompaction !== "summary") {
     return compacted.messages;
   }
-  const headCount = compacted.messages[0]?.role === "system" ? 1 : 0;
-  const dropped = original.slice(headCount, headCount + compacted.droppedCount);
+  const headCount = compacted.messages[0]?.message.role === "system" ? 1 : 0;
+  const dropped = toCoreMessages(original.slice(headCount, headCount + compacted.droppedCount));
   try {
-    const summary = await summarizeMessages(dropped, model, void 0, temperature);
-    const messages = compacted.messages.slice();
-    messages[headCount] = {
-      role: "user",
-      content: `[earlier conversation summarized]
+    const summary = await summarizeMessages(dropped, model, signal, temperature);
+    if (summary.trim().length > 0) {
+      const messages = compacted.messages.slice();
+      messages[headCount] = {
+        message: {
+          role: "user",
+          content: `[earlier conversation summarized]
 ${summary}`
-    };
-    return messages;
+        }
+      };
+      return messages;
+    }
+    return compacted.messages;
   } catch {
+    if (signal?.aborted) return null;
     return compacted.messages;
   }
 }
@@ -741,7 +772,11 @@ function stringifyPart(value) {
 import { readFileSync } from "fs";
 
 // src/session/search.ts
+import fs3 from "fs/promises";
+import path4 from "path";
+import { StringDecoder } from "string_decoder";
 var SNIPPET_LENGTH = 100;
+var SEARCH_READ_CHUNK_BYTES = 64 * 1024;
 function flattenMessage(message) {
   const content = message.content;
   if (typeof content === "string") return content;
@@ -768,17 +803,113 @@ function makeSnippet(text, query) {
   start = Math.max(0, end - SNIPPET_LENGTH);
   return `${start > 0 ? "\u2026" : ""}${flat.slice(start, end)}${end < flat.length ? "\u2026" : ""}`;
 }
+async function streamSessionPieces(id, onPiece) {
+  let handle = null;
+  try {
+    handle = await fs3.open(path4.join(sessionsDir(), id, "messages.jsonl"), "r");
+    const decoder = new StringDecoder("utf8");
+    const buffer = Buffer.alloc(SEARCH_READ_CHUNK_BYTES);
+    let tail = "";
+    let stop = false;
+    const pushLine = (line) => {
+      if (stop) return;
+      const trimmed = line.trim();
+      if (!trimmed) return;
+      let message;
+      try {
+        message = JSON.parse(trimmed);
+      } catch {
+        return;
+      }
+      const piece = flattenMessage(message);
+      if (piece !== "") stop = onPiece(piece);
+    };
+    while (!stop) {
+      const { bytesRead } = await handle.read(buffer, 0, buffer.length, null);
+      if (bytesRead === 0) break;
+      const chunk = tail + decoder.write(buffer.subarray(0, bytesRead));
+      const lines = chunk.split("\n");
+      tail = lines.pop() ?? "";
+      for (const line of lines) pushLine(line);
+    }
+    if (!stop) pushLine(tail + decoder.end());
+  } catch {
+  } finally {
+    await handle?.close().catch(() => {
+    });
+  }
+}
+async function sessionTextContains(id, needle) {
+  let lowerTail = "";
+  let found = false;
+  let joined = false;
+  await streamSessionPieces(id, (piece) => {
+    const segment = joined ? `
+${piece}` : piece;
+    joined = true;
+    const haystack = lowerTail + segment.toLowerCase();
+    lowerTail = needle.length > 1 ? haystack.slice(1 - needle.length) : "";
+    if (haystack.includes(needle)) {
+      found = true;
+      return true;
+    }
+    return false;
+  });
+  return found;
+}
+async function buildSessionSnippet(id, needle, query) {
+  const parts = [];
+  let lowerTail = "";
+  let mode = needle === "" ? "window" : "scan";
+  let flatLength = 0;
+  let flatLastChar = "";
+  let matchEndFlat = 0;
+  let stoppedEarly = false;
+  const foldCollapsed = (segment) => {
+    let folded = (flatLastChar + segment).replace(/\s+/g, " ");
+    if (flatLength === 0) {
+      if (folded.startsWith(" ")) folded = folded.slice(1);
+    } else {
+      folded = folded.slice(1);
+    }
+    flatLength += folded.length;
+    if (folded.length > 0) flatLastChar = folded.at(-1) ?? "";
+  };
+  await streamSessionPieces(id, (piece) => {
+    const segment = parts.length === 0 ? piece : `
+${piece}`;
+    parts.push(piece);
+    if (mode === "scan") {
+      const haystack = lowerTail + segment.toLowerCase();
+      lowerTail = needle.length > 1 ? haystack.slice(1 - needle.length) : "";
+      if (!haystack.includes(needle)) return false;
+      const collapsed = parts.join("\n").replace(/\s+/g, " ").replace(/^ /, "");
+      const index = collapsed.toLowerCase().indexOf(needle);
+      if (index === -1) {
+        mode = "head";
+        return false;
+      }
+      mode = "window";
+      matchEndFlat = index + needle.length;
+      flatLength = collapsed.length;
+      flatLastChar = collapsed.at(-1) ?? "";
+    } else if (mode === "window") {
+      foldCollapsed(segment);
+    }
+    const stop = mode === "window" && flatLength > matchEndFlat + SNIPPET_LENGTH;
+    if (stop) stoppedEarly = true;
+    return stop;
+  });
+  const text = parts.join("\n");
+  return makeSnippet(stoppedEarly ? `${text}\0` : text, query);
+}
 async function searchSessions(query, limit = 10) {
   const hits = [];
   const needle = query.toLowerCase();
   for (const meta of await SessionStore.list()) {
     if (hits.length >= limit) break;
-    const store = await SessionStore.open(meta.id);
-    if (!store) continue;
-    const text = (await store.messages()).map(flattenMessage).filter((part) => part.length > 0).join("\n");
-    if (text.toLowerCase().includes(needle)) {
-      hits.push({ meta, snippet: makeSnippet(text, query) });
-    }
+    if (needle !== "" && !await sessionTextContains(meta.id, needle)) continue;
+    hits.push({ meta, snippet: await buildSessionSnippet(meta.id, needle, query) });
   }
   return hits;
 }
@@ -794,7 +925,7 @@ function formatSearchResults(hits, query) {
 
 // src/cli/diff-preview.ts
 import { readFile as readFile2 } from "fs/promises";
-import path4 from "path";
+import path5 from "path";
 var CONTEXT_LINES = 2;
 var MAX_HUNK_LINES = 15;
 var MAX_TOTAL_LINES = 12;
@@ -955,7 +1086,7 @@ async function generateDiffPreview(toolName, args, cwd) {
   if (toolName !== "edit_file" && toolName !== "write_file") return null;
   const filePath = getStringArg(args, "path");
   if (filePath === void 0) return null;
-  const absolute = path4.resolve(cwd, filePath);
+  const absolute = path5.resolve(cwd, filePath);
   let existing;
   try {
     existing = await readFile2(absolute, "utf8");
@@ -1027,6 +1158,7 @@ ${sections.join("\n\n")}`);
     description: "Delete stored sessions: this directory by default, every session with --all (the current session is kept)",
     usage: "/clear-sessions [--all]",
     category: "Sessions",
+    argHints: ["--all"],
     async run(args, ctx) {
       const arg = args.trim();
       if (arg !== "" && arg !== "--all") {
@@ -1180,6 +1312,7 @@ ${sections.join("\n\n")}`);
     description: "Set the permission mode (opens a picker when no mode is given)",
     usage: "/permission [ask|auto|readonly|yolo]",
     category: "Settings",
+    argHints: ["ask", "auto", "readonly", "yolo", "plan"],
     async run(args, ctx) {
       const arg = args.trim();
       if (!arg) {
@@ -1203,6 +1336,7 @@ ${sections.join("\n\n")}`);
     description: "Show user memory (MEMORY.md), or add an entry",
     usage: "/memory [add <text>]",
     category: "Settings",
+    argHints: ["add"],
     run(args, ctx) {
       const arg = args.trim();
       if (arg === "add" || arg.startsWith("add ")) {
@@ -1282,6 +1416,7 @@ ${content}`);
     description: "Generate an AGENTS.md for the current project",
     usage: "/init [force]",
     category: "Settings",
+    argHints: ["force"],
     async run(args, ctx) {
       ctx.addSystemMessage(await ctx.initProject(args));
     }
@@ -1341,6 +1476,7 @@ ${lines.join("\n")}`);
     description: "Copy the last assistant reply to the clipboard (`all` for the whole conversation)",
     usage: "/copy [all]",
     category: "Sessions",
+    argHints: ["all"],
     async run(args, ctx) {
       const arg = args.trim();
       if (arg !== "" && arg !== "all") {
@@ -1406,8 +1542,8 @@ ${result.diff}${note ? `
 
 // src/cli/commands/connect.ts
 import { spawn } from "child_process";
-import fs3 from "fs";
-import path5 from "path";
+import fs4 from "fs";
+import path6 from "path";
 var PROVIDER_PRESETS = [
   {
     key: "openai",
@@ -1547,14 +1683,14 @@ function saveConnection(answers, configPath = globalConfigPath(), envPath = envF
     promptPrice: 0,
     completionPrice: 0
   };
-  fs3.mkdirSync(path5.dirname(envPath), { recursive: true });
+  fs4.mkdirSync(path6.dirname(envPath), { recursive: true });
   let envContent = "";
   try {
-    envContent = fs3.readFileSync(envPath, "utf8");
+    envContent = fs4.readFileSync(envPath, "utf8");
   } catch {
     envContent = "";
   }
-  fs3.writeFileSync(
+  fs4.writeFileSync(
     envPath,
     upsertEnvContent(envContent, provider.apiKeyEnv ?? "", answers.apiKey),
     {
@@ -1563,21 +1699,21 @@ function saveConnection(answers, configPath = globalConfigPath(), envPath = envF
     }
   );
   try {
-    fs3.chmodSync(envPath, 384);
+    fs4.chmodSync(envPath, 384);
   } catch {
   }
   if (provider.apiKeyEnv) {
     process.env[provider.apiKeyEnv] = answers.apiKey;
   }
-  fs3.mkdirSync(path5.dirname(configPath), { recursive: true });
+  fs4.mkdirSync(path6.dirname(configPath), { recursive: true });
   let existing = "";
   try {
-    existing = fs3.readFileSync(configPath, "utf8");
+    existing = fs4.readFileSync(configPath, "utf8");
   } catch {
     existing = "";
   }
   const separator = existing === "" ? "" : existing.endsWith("\n") ? "\n" : "\n\n";
-  fs3.writeFileSync(
+  fs4.writeFileSync(
     configPath,
     existing + separator + buildProviderTomlBlock(provider) + buildModelTomlBlock(model),
     "utf8"
@@ -1602,12 +1738,12 @@ ${content}`;
 function saveDefaultModel(modelName, configPath = globalConfigPath()) {
   let content = "";
   try {
-    content = fs3.readFileSync(configPath, "utf8");
+    content = fs4.readFileSync(configPath, "utf8");
   } catch {
     content = "";
   }
-  fs3.mkdirSync(path5.dirname(configPath), { recursive: true });
-  fs3.writeFileSync(configPath, setDefaultModelInToml(content, modelName), "utf8");
+  fs4.mkdirSync(path6.dirname(configPath), { recursive: true });
+  fs4.writeFileSync(configPath, setDefaultModelInToml(content, modelName), "utf8");
 }
 function openConfigFile(filePath) {
   const [command, args] = process.platform === "win32" ? ["cmd", ["/c", "start", "", filePath]] : process.platform === "darwin" ? ["open", [filePath]] : ["xdg-open", [filePath]];
@@ -1622,7 +1758,7 @@ function openConfigFile(filePath) {
 
 // src/cli/commands/custom.ts
 import { readFileSync as readFileSync2, readdirSync } from "fs";
-import path6 from "path";
+import path7 from "path";
 var NAME_PATTERN = /^[a-z0-9-]+$/;
 var DESCRIPTION_PATTERN = /^<!--\s*description:\s*(.+?)\s*-->\s*$/;
 var DEFAULT_DESCRIPTION = "Custom prompt command";
@@ -1657,14 +1793,14 @@ function scanDir(dir, into) {
     if (!entry.endsWith(".md")) continue;
     const name = entry.slice(0, -".md".length);
     if (!NAME_PATTERN.test(name)) continue;
-    const parsed = parseCommandFile(path6.join(dir, entry), name);
+    const parsed = parseCommandFile(path7.join(dir, entry), name);
     if (parsed) into.set(name, parsed);
   }
 }
 function loadCustomCommands(cwd, home = starHome()) {
   const byName = /* @__PURE__ */ new Map();
-  scanDir(path6.join(home, "commands"), byName);
-  scanDir(path6.join(cwd, ".star", "commands"), byName);
+  scanDir(path7.join(home, "commands"), byName);
+  scanDir(path7.join(cwd, ".star", "commands"), byName);
   return [...byName.values()];
 }
 function registerCustomCommands(registry, cwd, home) {
@@ -1690,8 +1826,8 @@ function registerCustomCommands(registry, cwd, home) {
 }
 
 // src/cli/commands/doctor.ts
-import fs4 from "fs/promises";
-import path7 from "path";
+import fs5 from "fs/promises";
+import path8 from "path";
 var MIN_NODE_MAJOR = 20;
 var REGISTRY_URL = "https://registry.npmjs.org/";
 var REGISTRY_TIMEOUT_MS = 5e3;
@@ -1705,7 +1841,7 @@ function nodeMajor(version) {
 }
 async function pathExists(target) {
   try {
-    await fs4.access(target);
+    await fs5.access(target);
     return true;
   } catch {
     return false;
@@ -1743,7 +1879,7 @@ async function runDoctor(opts) {
       detail: `${spec.label} (${spec.shell})`
     });
   }
-  const configPath = path7.join(home, "config.toml");
+  const configPath = path8.join(home, "config.toml");
   const configExists = await pathExists(configPath);
   checks.push({
     name: "STAR_HOME / config",
@@ -1780,14 +1916,14 @@ async function runDoctor(opts) {
       });
     }
   }
-  const sessions = path7.join(home, "sessions");
+  const sessions = path8.join(home, "sessions");
   let writable = false;
   let writeError = "";
   try {
-    await fs4.mkdir(sessions, { recursive: true });
-    const probe = path7.join(sessions, `.doctor-probe-${process.pid}`);
-    await fs4.writeFile(probe, "ok");
-    await fs4.unlink(probe);
+    await fs5.mkdir(sessions, { recursive: true });
+    const probe = path8.join(sessions, `.doctor-probe-${process.pid}`);
+    await fs5.writeFile(probe, "ok");
+    await fs5.unlink(probe);
     writable = true;
   } catch (error) {
     writeError = error instanceof Error ? error.message : String(error);
@@ -1822,15 +1958,15 @@ function formatDoctorReport(report) {
 }
 
 // src/cli/commands/init-project.ts
-import fs5 from "fs/promises";
-import path8 from "path";
+import fs6 from "fs/promises";
+import path9 from "path";
 import { generateText } from "ai";
 var IGNORED_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", "out", "coverage"]);
 var MAX_ENTRIES = 20;
 var README_HEAD_LINES = 5;
 async function fileExists2(target) {
   try {
-    await fs5.access(target);
+    await fs6.access(target);
     return true;
   } catch {
     return false;
@@ -1838,7 +1974,7 @@ async function fileExists2(target) {
 }
 async function readPackageJson(cwd) {
   try {
-    const raw = await fs5.readFile(path8.join(cwd, "package.json"), "utf8");
+    const raw = await fs6.readFile(path9.join(cwd, "package.json"), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed !== "object" || parsed === null) return null;
     return parsed;
@@ -1855,10 +1991,10 @@ function stringRecord(value) {
   return out;
 }
 async function detectPackageManager(cwd) {
-  if (await fileExists2(path8.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (await fileExists2(path8.join(cwd, "yarn.lock"))) return "yarn";
-  if (await fileExists2(path8.join(cwd, "package-lock.json"))) return "npm";
-  if (await fileExists2(path8.join(cwd, "bun.lockb"))) return "bun";
+  if (await fileExists2(path9.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (await fileExists2(path9.join(cwd, "yarn.lock"))) return "yarn";
+  if (await fileExists2(path9.join(cwd, "package-lock.json"))) return "npm";
+  if (await fileExists2(path9.join(cwd, "bun.lockb"))) return "bun";
   return null;
 }
 function inferCommands(pm, scripts) {
@@ -1873,7 +2009,7 @@ function inferCommands(pm, scripts) {
 }
 async function listEntries(cwd) {
   try {
-    const dirents = await fs5.readdir(cwd, { withFileTypes: true });
+    const dirents = await fs6.readdir(cwd, { withFileTypes: true });
     const entries = [];
     for (const dirent of dirents) {
       if (dirent.isDirectory()) {
@@ -1892,7 +2028,7 @@ async function listEntries(cwd) {
 async function readReadmeHead(cwd) {
   for (const name of ["README.md", "readme.md", "README"]) {
     try {
-      const raw = await fs5.readFile(path8.join(cwd, name), "utf8");
+      const raw = await fs6.readFile(path9.join(cwd, name), "utf8");
       return raw.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).slice(0, README_HEAD_LINES);
     } catch {
     }
@@ -1905,14 +2041,14 @@ async function scanProject(cwd) {
   const scripts = stringRecord(pkg?.scripts);
   return {
     name: typeof pkg?.name === "string" ? pkg.name : null,
-    dirName: path8.basename(cwd),
+    dirName: path9.basename(cwd),
     packageManager,
     scripts,
     dependencies: Object.keys(stringRecord(pkg?.dependencies)),
     devDependencies: Object.keys(stringRecord(pkg?.devDependencies)),
     commands: inferCommands(packageManager, scripts),
-    hasTsconfig: await fileExists2(path8.join(cwd, "tsconfig.json")),
-    isGitRepo: await fileExists2(path8.join(cwd, ".git")),
+    hasTsconfig: await fileExists2(path9.join(cwd, "tsconfig.json")),
+    isGitRepo: await fileExists2(path9.join(cwd, ".git")),
     readmeHead: await readReadmeHead(cwd),
     entries: await listEntries(cwd)
   };
@@ -1979,7 +2115,7 @@ Write the AGENTS.md.`
 }
 async function initProject(opts) {
   const { cwd, args, model } = opts;
-  const target = path8.join(cwd, "AGENTS.md");
+  const target = path9.join(cwd, "AGENTS.md");
   const force = args.split(/\s+/).includes("force");
   if (!force && await fileExists2(target)) {
     return {
@@ -2013,7 +2149,7 @@ async function initProject(opts) {
     content = renderAgentsMd(facts);
     note = " No model available; used the template \u2014 review and refine manually.";
   }
-  await fs5.writeFile(target, content);
+  await fs6.writeFile(target, content);
   const lines = content.split("\n").length;
   const how = usedLlm ? "generated with model refinement" : "generated from template";
   return {
@@ -2069,7 +2205,7 @@ function parseSlashCommand(input) {
 }
 
 // src/cli/commands/rewind.ts
-import path9 from "path";
+import path10 from "path";
 function planRewind(snapshots, id) {
   const target = snapshots.find((snapshot) => snapshot.id === id);
   if (!target) return null;
@@ -2083,7 +2219,7 @@ function planRewind(snapshots, id) {
   return { target, affected, messageIndex };
 }
 function displayPath(filePath, cwd) {
-  const relative = path9.relative(cwd, filePath);
+  const relative = path10.relative(cwd, filePath);
   return relative !== "" && !relative.startsWith("..") ? relative : filePath;
 }
 function formatTime(timestamp) {
@@ -2132,12 +2268,27 @@ function didYouMeanSuffix(names) {
   const listed = names.slice(0, 3).map((name) => `/${name}`);
   return ` Did you mean: ${listed.join(", ")}?`;
 }
+function filterArgHints(input, commands) {
+  if (!input.startsWith("/")) return [];
+  const spaceIndex = input.search(/\s/);
+  if (spaceIndex === -1) return [];
+  const name = input.slice(1, spaceIndex).toLowerCase();
+  const command = commands.find((cmd) => cmd.name.toLowerCase() === name);
+  if (!command?.argHints) return [];
+  const tokenMatch = /\S+$/.exec(input.slice(spaceIndex));
+  const argPrefix = tokenMatch ? tokenMatch[0] : "";
+  const source = command.argHints;
+  const candidates = typeof source === "function" ? source(argPrefix) : source;
+  const prefix = argPrefix.toLowerCase();
+  const stem = input.slice(0, input.length - argPrefix.length);
+  return candidates.filter((candidate) => candidate.toLowerCase().startsWith(prefix)).slice(0, MAX_SUGGESTIONS).map((value) => ({ value, replacement: `${stem}${value} ` }));
+}
 
 // src/cli/commands/undo.ts
 import { readFile as readFile3 } from "fs/promises";
-import path10 from "path";
+import path11 from "path";
 function displayPath2(filePath, cwd) {
-  const relative = path10.relative(cwd, filePath);
+  const relative = path11.relative(cwd, filePath);
   return relative !== "" && !relative.startsWith("..") ? relative : filePath;
 }
 async function buildUndoDiffs(snapshots, cwd) {
@@ -2524,11 +2675,11 @@ import { useRef as useRef4, useState as useState3 } from "react";
 
 // src/cli/components/InputBox.tsx
 import { Box as Box2, Text as Text2, useStdout } from "ink";
-import { useEffect as useEffect2, useRef as useRef3, useState as useState2 } from "react";
+import { memo, useEffect as useEffect2, useRef as useRef3, useState as useState2 } from "react";
 
 // src/cli/path-suggest.ts
 import { readdir } from "fs/promises";
-import path11 from "path";
+import path12 from "path";
 var MAX_SCAN_ENTRIES = 2e3;
 function extractAtToken(value, cursor) {
   const before = value.slice(0, cursor);
@@ -2543,7 +2694,7 @@ async function suggestPaths(token, cwd, maxScanEntries = MAX_SCAN_ENTRIES, maxSu
   const dirPart = slash >= 0 ? normalized.slice(0, slash + 1) : "";
   const basePrefix = slash >= 0 ? normalized.slice(slash + 1) : normalized;
   if (dirPart.split("/").some((segment) => SKIP_DIRS.has(segment))) return [];
-  const dirAbs = path11.resolve(cwd, dirPart === "" ? "." : dirPart);
+  const dirAbs = path12.resolve(cwd, dirPart === "" ? "." : dirPart);
   const entries = await readdir(dirAbs, { withFileTypes: true }).catch(() => null);
   if (!entries) return [];
   const ignore = createIgnorePredicate(cwd);
@@ -2558,7 +2709,7 @@ async function suggestPaths(token, cwd, maxScanEntries = MAX_SCAN_ENTRIES, maxSu
     if (isDir && SKIP_DIRS.has(entry.name)) continue;
     if (entry.name.startsWith(".") && !basePrefix.startsWith(".")) continue;
     if (!entry.name.toLowerCase().startsWith(lower)) continue;
-    if (ignore?.(path11.join(dirAbs, entry.name), isDir)) continue;
+    if (ignore?.(path12.join(dirAbs, entry.name), isDir)) continue;
     matches.push({ path: `${dirPart}${entry.name}${isDir ? "/" : ""}`, isDir });
   }
   matches.sort((a, b) => a.path.localeCompare(b.path));
@@ -2656,7 +2807,7 @@ function pasteToken(id, lineCount) {
 function stylePasteTokens(segment) {
   return segment.replace(PASTE_TOKEN_RE, (match) => `\x1B[2m${match}\x1B[22m`);
 }
-function InputBox({
+var InputBox = memo(function InputBox2({
   isStreaming,
   disabled,
   commands,
@@ -2789,6 +2940,7 @@ function InputBox({
   });
   const suggestionsEnabled = !isStreaming && !disabled && !suggestionsDismissed && !search;
   const suggestions = suggestionsEnabled && commands ? filterCommands(value, commands) : [];
+  const argHints = suggestionsEnabled && commands && cursor === value.length ? filterArgHints(value, commands) : [];
   useEffect2(() => {
     if (!suggestionsEnabled || !cwd) {
       setPathSuggestions([]);
@@ -2807,8 +2959,8 @@ function InputBox({
       cancelled = true;
     };
   }, [value, cursor, cwd, suggestionsEnabled]);
-  const showPathSuggestions = suggestions.length === 0 && pathSuggestions.length > 0;
-  const suggestionCount = suggestions.length > 0 ? suggestions.length : pathSuggestions.length;
+  const showPathSuggestions = suggestions.length === 0 && argHints.length === 0 && pathSuggestions.length > 0;
+  const suggestionCount = suggestions.length > 0 ? suggestions.length : argHints.length > 0 ? argHints.length : pathSuggestions.length;
   const activeIndex = suggestionCount === 0 ? 0 : Math.min(highlight, suggestionCount - 1);
   const completeHighlighted = () => {
     if (suggestions.length > 0) {
@@ -2818,6 +2970,12 @@ function InputBox({
       edit(text, text.length);
       return;
     }
+    if (argHints.length > 0) {
+      const hint = argHints[activeIndex];
+      if (!hint) return;
+      edit(hint.replacement, hint.replacement.length);
+      return;
+    }
     const sugg = pathSuggestions[activeIndex];
     const token = extractAtToken(value, cursor);
     if (!sugg || !token) return;
@@ -3070,6 +3228,9 @@ ${value.slice(cursor)}`, cursor + 1);
         /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: ` - ${cmd.description}` })
       ] }, cmd.name);
     }) }),
+    argHints.length > 0 && /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", paddingLeft: 2, children: argHints.map(
+      (hint, index) => index === activeIndex ? /* @__PURE__ */ jsx2(Text2, { bold: true, inverse: true, children: hint.value }, hint.value) : /* @__PURE__ */ jsx2(Text2, { color: "cyan", children: hint.value }, hint.value)
+    ) }),
     showPathSuggestions && /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", paddingLeft: 2, children: pathSuggestions.map(
       (sugg, index) => index === activeIndex ? /* @__PURE__ */ jsx2(Text2, { bold: true, inverse: true, children: `@${sugg.path}` }, sugg.path) : /* @__PURE__ */ jsxs2(Text2, { children: [
         /* @__PURE__ */ jsx2(Text2, { color: "cyan", children: `@${sugg.path}` }),
@@ -3077,7 +3238,7 @@ ${value.slice(cursor)}`, cursor + 1);
       ] }, sugg.path)
     ) })
   ] });
-}
+});
 
 // src/cli/components/TextField.tsx
 import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
@@ -3374,7 +3535,7 @@ function ExitPlanPrompt({ onDecision }) {
 
 // src/cli/components/MessageList.tsx
 import { Box as Box6, Static, Text as Text7, useStdout as useStdout2 } from "ink";
-import { memo } from "react";
+import { memo as memo2, useState as useState5 } from "react";
 
 // src/cli/components/DiffLines.tsx
 import { Text as Text6 } from "ink";
@@ -3409,10 +3570,28 @@ var roleStyles = {
   system: { label: "\u25CF system", color: "yellow" }
 };
 var interruptedMarker = (text) => /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: text.length > 0 ? " [interrupted]" : "[interrupted]" });
-var MessageList = memo(function MessageList2({ messages }) {
+var INITIAL_RENDER_LIMIT = 100;
+function collapseInitialMessages(messages, limit = INITIAL_RENDER_LIMIT) {
+  if (messages.length <= limit) return { hidden: 0, visible: [...messages] };
+  return { hidden: messages.length - limit, visible: messages.slice(-limit) };
+}
+var MessageList = memo2(function MessageList2({ messages }) {
   const { stdout } = useStdout2();
   const termWidth = stdout.columns ?? 80;
-  return /* @__PURE__ */ jsx7(Static, { items: messages, children: (message) => {
+  const [initial] = useState5(() => ({
+    length: messages.length,
+    view: collapseInitialMessages(messages)
+  }));
+  const placeholder = initial.view.hidden > 0 ? [{ id: -1, role: "system", text: "", collapsed: initial.view.hidden }] : [];
+  const items = [...placeholder, ...initial.view.visible, ...messages.slice(initial.length)];
+  return /* @__PURE__ */ jsx7(Static, { items, children: (message) => {
+    if (message.collapsed !== void 0) {
+      return /* @__PURE__ */ jsx7(Box6, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs7(Text7, { dimColor: true, children: [
+        "\u2026 ",
+        message.collapsed,
+        " earlier messages hidden \u2014 full history in the session file"
+      ] }) }, message.id);
+    }
     const marginBottom = message.tight ? 0 : 1;
     if (message.role === "assistant-cont") {
       return /* @__PURE__ */ jsx7(Box6, { flexDirection: "column", marginBottom, children: /* @__PURE__ */ jsxs7(Text7, { color: "green", children: [
@@ -3437,7 +3616,7 @@ var MessageList = memo(function MessageList2({ messages }) {
     }
     if (message.role === "tool") {
       return /* @__PURE__ */ jsxs7(Box6, { flexDirection: "column", marginBottom, children: [
-        /* @__PURE__ */ jsx7(Text7, { color: "magenta", children: message.text }),
+        /* @__PURE__ */ jsx7(Text7, { color: message.dim ? void 0 : "magenta", dimColor: message.dim, children: message.text }),
         message.diff && /* @__PURE__ */ jsx7(DiffLines, { lines: message.diff })
       ] }, message.id);
     }
@@ -3527,73 +3706,7 @@ function RewindConfirmPrompt({
 
 // src/cli/components/StatusBar.tsx
 import { Box as Box9, Text as Text10, useStdout as useStdout3 } from "ink";
-import { memo as memo2 } from "react";
-
-// src/cli/icons.ts
-var EMOJI_TERM_PROGRAMS = /* @__PURE__ */ new Set([
-  "vscode",
-  "WezTerm",
-  "iTerm.app",
-  "Apple_Terminal",
-  "ghostty",
-  "kitty",
-  "Hyper",
-  "WarpTerminal"
-]);
-function resolveIconMode(env = process.env) {
-  const override = env.STAR_ICONS;
-  if (override === "emoji" || override === "plain") return override;
-  if (env.WT_SESSION) return "emoji";
-  if (EMOJI_TERM_PROGRAMS.has(env.TERM_PROGRAM ?? "")) return "emoji";
-  const term = env.TERM ?? "";
-  if (term.includes("kitty") || term.includes("alacritty")) return "emoji";
-  return "plain";
-}
-var EMOJI_TOOL_ICONS = {
-  bash: "\u{1F4BB}",
-  read_file: "\u{1F4C4}",
-  write_file: "\u{1F4DD}",
-  edit_file: "\u270F\uFE0F",
-  glob: "\u{1F4C2}",
-  grep: "\u{1F50D}",
-  web_search: "\u{1F50E}",
-  web_fetch: "\u{1F310}",
-  todo_write: "\u{1F4CB}",
-  todo_read: "\u{1F4CB}",
-  task_list: "\u{1F9F5}",
-  task_output: "\u{1F9F5}",
-  task_kill: "\u{1F6D1}",
-  subagent: "\u{1F916}",
-  skill: "\u2728",
-  remember: "\u{1F9E0}"
-};
-var PLAIN_TOOL_ICONS = {
-  bash: "$",
-  read_file: "\u2261",
-  write_file: "+",
-  edit_file: "\u270E",
-  glob: "*",
-  grep: "/",
-  web_search: "?",
-  web_fetch: "\u21D3",
-  todo_write: "\u2023",
-  todo_read: "\u2023",
-  task_list: "\xB6",
-  task_output: "\xB6",
-  task_kill: "\xD7",
-  subagent: "\u25C9",
-  skill: "\u2727",
-  remember: "\u203B"
-};
-var iconMode = resolveIconMode();
-function toolIcon(name) {
-  const map = iconMode === "emoji" ? EMOJI_TOOL_ICONS : PLAIN_TOOL_ICONS;
-  return map[name] ?? (iconMode === "emoji" ? "\u{1F527}" : "\u25B8");
-}
-var thinkingIcon = iconMode === "emoji" ? "\u{1F4AD}" : "\u2727";
-var folderIcon = iconMode === "emoji" ? "\u{1F4C1} " : "";
-
-// src/cli/components/StatusBar.tsx
+import { memo as memo3 } from "react";
 import { jsxs as jsxs10 } from "react/jsx-runtime";
 var BG_LABEL_MAX = 40;
 var WIDE_COLUMNS = 120;
@@ -3602,7 +3715,7 @@ function cwdLabel(cwd, wide) {
   const base = cwd.replace(/[\\/]+$/, "").split(/[\\/]/).pop();
   return base && base.length > 0 ? base : cwd;
 }
-var StatusBar = memo2(function StatusBar2({
+var StatusBar = memo3(function StatusBar2({
   cwd,
   model,
   permissionMode,
@@ -3660,9 +3773,9 @@ var StatusBar = memo2(function StatusBar2({
 
 // src/cli/components/StreamingMessage.tsx
 import { Box as Box10, Text as Text11, useStdout as useStdout4 } from "ink";
-import { memo as memo3 } from "react";
+import { memo as memo4 } from "react";
 import { jsx as jsx10, jsxs as jsxs11 } from "react/jsx-runtime";
-var StreamingMessage = memo3(function StreamingMessage2({
+var StreamingMessage = memo4(function StreamingMessage2({
   text,
   continuation
 }) {
@@ -3675,6 +3788,24 @@ var StreamingMessage = memo3(function StreamingMessage2({
 
 // src/cli/components/ThinkingIndicator.tsx
 import { Box as Box11, Text as Text12 } from "ink";
+import { memo as memo5, useEffect as useEffect3, useState as useState6 } from "react";
+
+// src/cli/ticker.ts
+var TICK_MS = 100;
+function nextFlush(prev, next) {
+  if (prev.streamed === next.streamed && prev.reasoning === next.reasoning) return null;
+  return next;
+}
+function startTicker(onTick, intervalMs = TICK_MS) {
+  let tick = 0;
+  const timer = setInterval(() => {
+    tick += 1;
+    onTick(tick);
+  }, intervalMs);
+  return () => clearInterval(timer);
+}
+
+// src/cli/components/ThinkingIndicator.tsx
 import { jsxs as jsxs12 } from "react/jsx-runtime";
 var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
 var REASONING_TAIL_LENGTH = 200;
@@ -3684,15 +3815,18 @@ function truncateTail(text, max) {
   if (flat.length <= max) return flat;
   return `\u2026${flat.slice(flat.length - max)}`;
 }
-function ThinkingIndicator({
+var ThinkingIndicator = memo5(function ThinkingIndicator2({
   reasoning,
-  frame = 0,
+  frame,
   activity,
-  elapsedSec
+  startedAt
 }) {
+  const [tick, setTick] = useState6(0);
+  useEffect3(() => startTicker((t) => setTick(t)), []);
   const tail = reasoning ? truncateTail(reasoning, REASONING_TAIL_LENGTH) : "";
-  const spinner = SPINNER_FRAMES[frame % SPINNER_FRAMES.length];
+  const spinner = SPINNER_FRAMES[(frame ?? tick) % SPINNER_FRAMES.length];
   const label = activity ?? `${thinkingIcon} star is thinking\u2026`;
+  const elapsedSec = startedAt === void 0 ? void 0 : Math.max(0, Math.floor((Date.now() - startedAt) / 1e3));
   const elapsed = elapsedSec !== void 0 && elapsedSec >= 3 ? ` (${formatElapsedSeconds(elapsedSec)})` : "";
   return /* @__PURE__ */ jsxs12(Box11, { flexDirection: "column", children: [
     /* @__PURE__ */ jsxs12(Text12, { dimColor: true, children: [
@@ -3706,10 +3840,11 @@ function ThinkingIndicator({
       tail
     ] })
   ] });
-}
+});
 
 // src/cli/components/TodoPanel.tsx
 import { Box as Box12, Text as Text13 } from "ink";
+import { memo as memo6 } from "react";
 import { jsxs as jsxs13 } from "react/jsx-runtime";
 var SYMBOLS = {
   pending: "\u25CB",
@@ -3728,7 +3863,7 @@ function visibleTodoWindow(todos, max = MAX_VISIBLE_TODOS) {
     hiddenAfter: todos.length - start - items.length
   };
 }
-function TodoPanel({ todos }) {
+var TodoPanel = memo6(function TodoPanel2({ todos }) {
   if (todos.length === 0 || todos.every((t) => t.status === "done")) return null;
   const { items, hiddenBefore, hiddenAfter } = visibleTodoWindow(todos);
   return /* @__PURE__ */ jsxs13(Box12, { flexDirection: "column", children: [
@@ -3757,7 +3892,7 @@ function TodoPanel({ todos }) {
       " more"
     ] })
   ] });
-}
+});
 
 // src/cli/components/ToolCallCard.tsx
 function formatToolCard(card) {
@@ -3775,20 +3910,20 @@ function isDoubleEscape(previous, now, windowMs = DOUBLE_ESC_WINDOW_MS) {
 }
 
 // src/cli/history.ts
-import fs6 from "fs";
-import path12 from "path";
+import fs7 from "fs";
+import path13 from "path";
 var HISTORY_LIMIT = 50;
 var JUNK_ENTRY_PATTERN = /^(.)\1{19,}$/;
 function historyPath() {
-  return path12.join(starHome(), "history");
+  return path13.join(starHome(), "history");
 }
 function readLines(file) {
-  const raw = fs6.readFileSync(file, "utf8");
+  const raw = fs7.readFileSync(file, "utf8");
   return raw.split("\n").map((line) => line.replace(/\r$/, "")).filter((line) => line.trim().length > 0);
 }
 function writeHistory(file, lines) {
-  fs6.mkdirSync(path12.dirname(file), { recursive: true });
-  fs6.writeFileSync(file, `${lines.join("\n")}
+  fs7.mkdirSync(path13.dirname(file), { recursive: true });
+  fs7.writeFileSync(file, `${lines.join("\n")}
 `);
 }
 function isJunkHistoryEntry(line) {
@@ -3825,8 +3960,8 @@ function appendHistory(entry) {
       writeHistory(file, [...existing.slice(-(HISTORY_LIMIT - 1)), line]);
       return;
     }
-    fs6.mkdirSync(path12.dirname(file), { recursive: true });
-    fs6.appendFileSync(file, `${line}
+    fs7.mkdirSync(path13.dirname(file), { recursive: true });
+    fs7.appendFileSync(file, `${line}
 `);
   } catch {
   }
@@ -3900,27 +4035,38 @@ async function executeShellBang(raw, cwd, signal) {
   };
 }
 
-// src/cli/ticker.ts
-var TICK_MS = 100;
-function nextFlush(prev, next) {
-  if (prev.streamed === next.streamed && prev.reasoning === next.reasoning) return null;
-  return next;
-}
-function startTicker(onTick, intervalMs = TICK_MS) {
-  let tick = 0;
-  const timer = setInterval(() => {
-    tick += 1;
-    onTick(tick);
-  }, intervalMs);
-  return () => clearInterval(timer);
-}
-
 // src/cli/update-check.ts
+import { mkdir, readFile as readFile4, rename, writeFile } from "fs/promises";
+import path14 from "path";
 var REGISTRY_URL2 = "https://registry.npmjs.org/@cryer%2fstar-cli/latest";
 var TIMEOUT_MS = 5e3;
+var THROTTLE_MS = 24 * 60 * 60 * 1e3;
 async function defaultFetcher2(url) {
   return fetch(url, { signal: AbortSignal.timeout(TIMEOUT_MS) });
 }
+function defaultStatePath() {
+  return path14.join(starHome(), "update-check.json");
+}
+async function readState(statePath) {
+  try {
+    const raw = JSON.parse(await readFile4(statePath, "utf8"));
+    if (typeof raw !== "object" || raw === null) return null;
+    const { lastCheckAt, latest } = raw;
+    if (typeof lastCheckAt !== "number" || !Number.isFinite(lastCheckAt)) return null;
+    return { lastCheckAt, latest: typeof latest === "string" ? latest : null };
+  } catch {
+    return null;
+  }
+}
+async function writeState(statePath, state) {
+  try {
+    await mkdir(path14.dirname(statePath), { recursive: true });
+    const tmp = `${statePath}.tmp-${process.pid}`;
+    await writeFile(tmp, JSON.stringify(state), "utf8");
+    await rename(tmp, statePath);
+  } catch {
+  }
+}
 function isNewerVersion(latest, current) {
   const parse2 = (v) => v.split(".").slice(0, 3).map((part) => Number.parseInt(part, 10));
   const a = parse2(latest);
@@ -3933,14 +4079,25 @@ function isNewerVersion(latest, current) {
   }
   return false;
 }
-async function checkForUpdate(currentVersion, fetcher = defaultFetcher2) {
+function noticeFor(latest, currentVersion) {
+  if (typeof latest !== "string" || !isNewerVersion(latest, currentVersion)) return null;
+  return `New version available: ${currentVersion} -> ${latest} \u2014 run: npm i -g @cryer/star-cli`;
+}
+async function checkForUpdate(currentVersion, fetcher = defaultFetcher2, statePath = defaultStatePath()) {
   try {
+    const state = await readState(statePath);
+    if (state && Date.now() - state.lastCheckAt < THROTTLE_MS) {
+      return noticeFor(state.latest, currentVersion);
+    }
     const res = await fetcher(REGISTRY_URL2);
     if (!res.ok) return null;
     const data = await res.json();
     const latest = typeof data === "object" && data !== null ? data.version : null;
-    if (typeof latest !== "string" || !isNewerVersion(latest, currentVersion)) return null;
-    return `New version available: ${currentVersion} -> ${latest} \u2014 run: npm i -g @cryer/star-cli`;
+    await writeState(statePath, {
+      lastCheckAt: Date.now(),
+      latest: typeof latest === "string" ? latest : null
+    });
+    return noticeFor(typeof latest === "string" ? latest : null, currentVersion);
   } catch {
     return null;
   }
@@ -3989,30 +4146,30 @@ function Repl({
   initialUsage
 }) {
   const { exit } = useApp();
-  const [initialDisplay] = useState5(() => buildDisplayMessages(initialMessages ?? []));
-  const [messages, setMessages] = useState5(initialDisplay);
-  const [epoch, setEpoch] = useState5(0);
-  const [streamingText, setStreamingText] = useState5(null);
-  const [isStreaming, setIsStreaming] = useState5(false);
-  const [thinking, setThinking] = useState5(false);
-  const [thinkingText, setThinkingText] = useState5("");
-  const [thoughtSummary, setThoughtSummary] = useState5(null);
-  const [, setUsageVersion] = useState5(0);
-  const [modelName, setModelName] = useState5(model);
-  const [pending, setPending] = useState5(null);
-  const [spinnerTick, setSpinnerTick] = useState5(0);
-  const [activity, setActivity] = useState5(null);
-  const [bgLabels, setBgLabels] = useState5(() => runningTaskLabels());
-  const [todos, setTodos] = useState5([]);
-  const [permissionModeState, setPermissionModeState] = useState5(permissionMode);
-  const [planApproval, setPlanApprovalState] = useState5(false);
-  const [pendingRewind, setPendingRewindState] = useState5(null);
-  const [picker, setPickerState] = useState5(null);
-  const [pendingConnect, setPendingConnectState] = useState5(null);
+  const [initialDisplay] = useState7(() => buildDisplayMessages(initialMessages ?? []));
+  const [messages, setMessages] = useState7(initialDisplay);
+  const [epoch, setEpoch] = useState7(0);
+  const [streamingText, setStreamingText] = useState7(null);
+  const [isStreaming, setIsStreaming] = useState7(false);
+  const [thinking, setThinking] = useState7(false);
+  const [thinkingText, setThinkingText] = useState7("");
+  const [thoughtSummary, setThoughtSummary] = useState7(null);
+  const [, setUsageVersion] = useState7(0);
+  const [modelName, setModelName] = useState7(model);
+  const [pending, setPending] = useState7(null);
+  const [activity, setActivity] = useState7(null);
+  const [bgLabels, setBgLabels] = useState7(() => runningTaskLabels());
+  const [todos, setTodos] = useState7([]);
+  const [permissionModeState, setPermissionModeState] = useState7(permissionMode);
+  const [planApproval, setPlanApprovalState] = useState7(false);
+  const [pendingRewind, setPendingRewindState] = useState7(null);
+  const [picker, setPickerState] = useState7(null);
+  const [pendingConnect, setPendingConnectState] = useState7(null);
   const backendRef = useRef6(backend);
   const nextIdRef = useRef6(initialDisplay.length);
   const abortRef = useRef6(null);
   const busyCommandRef = useRef6(null);
+  const busyAbortRef = useRef6(null);
   const streamedRef = useRef6("");
   const turnStartedAtRef = useRef6(0);
   const lastCommittedLenRef = useRef6(0);
@@ -4024,6 +4181,7 @@ function Repl({
   const pendingRef = useRef6(null);
   const permissionChainRef = useRef6(Promise.resolve());
   const alwaysAllowedRef = useRef6(/* @__PURE__ */ new Set());
+  const alwaysAllowedListRef = useRef6([]);
   const prevModeRef = useRef6(null);
   const planApprovalRef = useRef6(false);
   const pendingRewindRef = useRef6(null);
@@ -4032,23 +4190,23 @@ function Repl({
   const modelNameRef = useRef6(model);
   const sessionStoreRef = useRef6(sessionStore);
   const configRef = useRef6(config);
-  useEffect3(() => {
+  useEffect4(() => {
     configRef.current = config;
   }, [config]);
   const usageRef = useRef6(initialUsage ? { ...initialUsage } : emptyUsage());
   const turnChunksRef = useRef6(0);
   const messagesRef = useRef6(initialDisplay);
-  const [queueItems, setQueueItems] = useState5([]);
+  const [queueItems, setQueueItems] = useState7([]);
   const queueRef = useRef6(new PromptQueue());
-  const [pendingImages, setPendingImages] = useState5([]);
+  const [pendingImages, setPendingImages] = useState7([]);
   const pendingImagesRef = useRef6([]);
   const imageSeqRef = useRef6(1);
-  const [inputRefill, setInputRefill] = useState5();
+  const [inputRefill, setInputRefill] = useState7();
   const refillSeqRef = useRef6(0);
   const lastEscRef = useRef6(null);
-  const [gitBranch, setGitBranch] = useState5(null);
-  const [contextPercent, setContextPercent] = useState5(null);
-  const [initialHistory] = useState5(() => loadHistory());
+  const [gitBranch, setGitBranch] = useState7(null);
+  const [contextPercent, setContextPercent] = useState7(null);
+  const [initialHistory] = useState7(() => loadHistory());
   const budgetWarnedRef = useRef6(false);
   const budgetExceededRef = useRef6(false);
   const runStreamRef = useRef6(
@@ -4214,7 +4372,7 @@ function Repl({
   const attachConfirmHandler = useCallback(
     (target) => {
       target.confirmHandler = (req) => {
-        if (isAllowedByRules([...alwaysAllowedRef.current], req)) {
+        if (isAllowedByRules(alwaysAllowedListRef.current, req)) {
           return Promise.resolve(true);
         }
         const ask = async () => {
@@ -4234,7 +4392,7 @@ function Repl({
     },
     [setPendingPermission, cwd, pushMessage]
   );
-  useEffect3(() => {
+  useEffect4(() => {
     attachConfirmHandler(backendRef.current);
     return () => {
       tickerStopRef.current?.();
@@ -4242,19 +4400,19 @@ function Repl({
       pendingRef.current?.resolve(false);
     };
   }, [attachConfirmHandler]);
-  useEffect3(() => {
+  useEffect4(() => {
     if (process.env.STAR_NO_UPDATE_CHECK === "1") return;
     void checkForUpdate(VERSION).then((message) => {
       if (message) pushMessage("system", message);
     });
   }, [pushMessage]);
   const resumedAtStart = initialMessages !== void 0;
-  useEffect3(() => {
+  useEffect4(() => {
     if (!resumedAtStart) return;
-    loadTodos(cwd).then(setTodos).catch(() => {
+    loadTodos(cwd, sessionStoreRef.current?.id).then(setTodos).catch(() => {
     });
   }, [cwd, resumedAtStart]);
-  useEffect3(() => {
+  useEffect4(() => {
     const onUpdate = (task) => {
       setBgLabels(runningTaskLabels());
       pushMessage(
@@ -4348,6 +4506,11 @@ function Repl({
         lastEscRef.current = null;
         return;
       }
+      if (busyCommandRef.current) {
+        lastEscRef.current = null;
+        busyAbortRef.current?.abort();
+        return;
+      }
       const busy = abortRef.current !== null || pendingRef.current !== null;
       if (busy) {
         lastEscRef.current = null;
@@ -4365,7 +4528,7 @@ function Repl({
     }
     lastEscRef.current = null;
     if (key.shift && key.tab) {
-      if (abortRef.current || pendingRef.current || planApprovalRef.current || pendingRewindRef.current || pendingConnectRef.current || pickerRef.current)
+      if (abortRef.current || pendingRef.current || busyCommandRef.current || planApprovalRef.current || pendingRewindRef.current || pendingConnectRef.current || pickerRef.current)
         return;
       const current = config.permissionMode;
       const index = SESSION_MODE_CYCLE.indexOf(current);
@@ -4380,6 +4543,7 @@ function Repl({
       if (decision === "always") {
         const rule = buildAllowRule(p.request);
         alwaysAllowedRef.current.add(rule);
+        alwaysAllowedListRef.current = [...alwaysAllowedRef.current];
         void addAllowRule(rule).then((added) => {
           pushMessage(
             "system",
@@ -4410,11 +4574,13 @@ function Repl({
           providerMetadata: reasoningEffortMetadata(config, name),
           temperature: modelConfig.temperature,
           streamIdleTimeoutSec: modelConfig.streamIdleTimeoutSec,
-          streamFirstChunkTimeoutSec: modelConfig.streamFirstChunkTimeoutSec
+          streamFirstChunkTimeoutSec: modelConfig.streamFirstChunkTimeoutSec,
+          vision: modelConfig.vision,
+          modelName: name
         });
         const prev = backendRef.current;
         if (prev instanceof AgentLoop) {
-          await loop.loadMessages([...prev.getMessages()]);
+          await loop.loadMessages([...prev.getStarMessages()]);
         }
         attachConfirmHandler(loop);
         backendRef.current = loop;
@@ -4495,9 +4661,10 @@ function Repl({
       await current.loadMessages(resumed.messages);
       current.setSessionStore(store);
       sessionStoreRef.current = store;
-      setTodos(await loadTodos(cwd));
+      setTodoSession(store.id);
+      setTodos(await loadTodos(cwd, store.id));
       hydrateSnapshots(await loadSessionSnapshots(store.dir));
-      const display = buildDisplayMessages(resumed.messages);
+      const display = buildDisplayMessages(toCoreMessages(resumed.messages));
       nextIdRef.current = display.length;
       applyMessages(display);
       usageRef.current = resumed.meta.usage ? { ...resumed.meta.usage } : emptyUsage();
@@ -4544,8 +4711,7 @@ function Repl({
         flushedRef.current = { ...flushedRef.current, streamed: "" };
         setStreamingText("");
       };
-      tickerStopRef.current = startTicker((tick) => {
-        setSpinnerTick(tick);
+      tickerStopRef.current = startTicker(() => {
         const uncommitted = streamedRef.current.slice(lastCommittedLenRef.current);
         const split = splitCommittableLines(uncommitted, 8);
         if (split) {
@@ -4761,7 +4927,7 @@ function Repl({
       sessionCostUsd
     ]
   );
-  useEffect3(() => {
+  useEffect4(() => {
     runStreamRef.current = runStream;
   }, [runStream]);
   const handlePlanDecision = useCallback(
@@ -4919,7 +5085,7 @@ ${lines.join("\n")}`;
         if (!(current instanceof AgentLoop) || !store) {
           return "Nothing to fork \u2014 no active session.";
         }
-        const messages2 = await store.messages();
+        const messages2 = await store.starMessages();
         if (messages2.length === 0) {
           return "Nothing to fork \u2014 the current session has no messages yet.";
         }
@@ -4930,6 +5096,7 @@ ${lines.join("\n")}`;
         await fork.setTitle(title);
         current.setSessionStore(fork);
         sessionStoreRef.current = fork;
+        setTodoSession(fork.id);
         return `Forked into new session ${fork.id} ("${title}") and switched to it. Checkpoints and rewind history do not carry over.`;
       },
       newSession: async () => {
@@ -4941,8 +5108,9 @@ ${lines.join("\n")}`;
         const store = await SessionStore.create(cwd, modelNameRef.current);
         current.setSessionStore(store);
         sessionStoreRef.current = store;
-        const [first] = current.getMessages();
-        await current.loadMessages(first?.role === "system" ? [first] : []);
+        setTodoSession(store.id);
+        const [first] = current.getStarMessages();
+        await current.loadMessages(first?.message.role === "system" ? [first] : []);
         clearSnapshots();
         redrawMessages([]);
         resetTodos();
@@ -4987,14 +5155,16 @@ ${estimateCost(usageRef.current, modelNameRef.current, modelConfig)}`;
           return `Busy \u2014 /${busyCommandRef.current} is still running.`;
         }
         busyCommandRef.current = "compact";
+        const controller = new AbortController();
+        busyAbortRef.current = controller;
         turnStartedAtRef.current = Date.now();
-        tickerStopRef.current = startTicker((tick) => setSpinnerTick(tick));
         setActivity("compacting context\u2026");
         try {
           const result = await compactSession({
             backend: backendRef.current,
             sessionStore: sessionStoreRef.current,
-            config
+            config,
+            signal: controller.signal
           });
           if (result.compacted && result.messages) {
             const display = buildDisplayMessages(result.messages);
@@ -5007,6 +5177,7 @@ ${estimateCost(usageRef.current, modelNameRef.current, modelConfig)}`;
           tickerStopRef.current = null;
           setActivity(null);
           busyCommandRef.current = null;
+          busyAbortRef.current = null;
           const nextPrompt = queueRef.current.dequeue();
           if (nextPrompt) {
             setQueueItems(queueRef.current.list());
@@ -5200,6 +5371,8 @@ ${plan.affected.length} file change(s) will be reverted, ${messageCount} message
     };
     const reg = new CommandRegistry();
     registerBuiltinCommands(reg);
+    const modelCommand = reg.get("model");
+    if (modelCommand) modelCommand.argHints = () => config.models.map((m) => m.name);
     registerCustomCommands(reg, cwd);
     return Object.assign(reg, { ctx });
   }, [
@@ -5318,16 +5491,17 @@ ${plan.affected.length} file change(s) will be reverted, ${messageCount} message
     () => registry.list().map((cmd) => ({
       name: cmd.name,
       description: cmd.description,
-      usage: cmd.usage ?? `/${cmd.name}`
+      usage: cmd.usage ?? `/${cmd.name}`,
+      argHints: cmd.argHints
     })),
     [registry]
   );
-  useEffect3(() => {
+  useEffect4(() => {
     setGitBranch(getGitSummaryCached(cwd)?.branch ?? null);
     const current = backendRef.current;
     if (current instanceof AgentLoop) {
       const window_ = contextWindowTokens(config, modelNameRef.current);
-      const pct = estimateTokens([...current.getMessages()]) / window_ * 100;
+      const pct = (estimateTokens(current.getMessages()) + current.getToolSchemaTokens()) / window_ * 100;
       setContextPercent(pct < 10 ? Math.round(pct * 10) / 10 : Math.round(pct));
     } else {
       setContextPercent(null);
@@ -5340,9 +5514,8 @@ ${plan.affected.length} file change(s) will be reverted, ${messageCount} message
       ThinkingIndicator,
       {
         reasoning: thinkingText,
-        frame: spinnerTick,
         activity: activity ?? void 0,
-        elapsedSec: Math.max(0, Math.floor((Date.now() - turnStartedAtRef.current) / 1e3))
+        startedAt: turnStartedAtRef.current
       }
     ),
     !thinking && activity === null && thoughtSummary !== null && /* @__PURE__ */ jsx11(Text14, { dimColor: true, children: thoughtSummary }),
@@ -5461,4 +5634,4 @@ export {
   Repl,
   renderRepl
 };
-//# sourceMappingURL=repl-YA23CK5R.js.map
+//# sourceMappingURL=repl-OO7C6V7M.js.map