reasonix 0.34.1 → 0.36.0

package/dist/index.js

@@ -766,6 +766,20 @@ function loadApiKey(path2 = defaultConfigPath()) {
   if (process.env.DEEPSEEK_API_KEY) return process.env.DEEPSEEK_API_KEY;
   return readConfig(path2).apiKey;
 }
+function loadBaseUrl(path2 = defaultConfigPath()) {
+  if (process.env.DEEPSEEK_BASE_URL) return process.env.DEEPSEEK_BASE_URL;
+  return readConfig(path2).baseUrl;
+}
+function saveBaseUrl(url, path2 = defaultConfigPath()) {
+  const cfg = readConfig(path2);
+  const trimmed = url.trim();
+  if (trimmed) {
+    cfg.baseUrl = trimmed;
+  } else {
+    cfg.baseUrl = void 0;
+  }
+  writeConfig(cfg, path2);
+}
 function webSearchEngine(path2 = defaultConfigPath()) {
   const cfg = readConfig(path2).webSearchEngine;
   if (cfg === "searxng") return "searxng";
@@ -806,7 +820,8 @@ function addProjectShellAllowed(rootDir, prefix, path2 = defaultConfigPath()) {
 }
 function isPlausibleKey(key) {
   const trimmed = key.trim();
-  return /^sk-[A-Za-z0-9_-]{16,}$/.test(trimmed);
+  if (trimmed.length < 16) return false;
+  return !/\s/.test(trimmed);
 }
 function redactKey(key) {
   if (!key) return "";
@@ -889,14 +904,15 @@ var EN = {
       sections: [
         {
           rows: [
-            { key: "wheel", text: "scrolls the chat history above" },
+            { key: "drag", text: "select text \u2014 terminal-native, no modifier needed" },
             {
               key: "right-click",
-              text: "captured by the app \u2014 use Ctrl+V (Win/Linux) or Cmd+V (macOS) to paste"
+              text: "your terminal's native menu (paste / copy on Windows Terminal etc.)"
             },
+            { key: "wheel", text: "scrolls chat history (works on web/cloud/SSH terminals too)" },
             {
-              key: "Shift + drag",
-              text: "selects text natively (Option on iTerm2, Shift on Win Term / Alacritty / WezTerm)"
+              key: "\u2191 / \u2193",
+              text: "scroll chat \xB7 use Ctrl+P / Ctrl+N for prompt history + multi-line cursor"
             }
           ]
         }
@@ -911,7 +927,11 @@ var EN = {
           rows: [
             { key: "Enter", text: "submit the prompt" },
             { key: "Shift+Enter", text: "insert a newline in the prompt" },
-            { key: "Ctrl+P / Ctrl+N", text: "recall previous / next prompt from history" },
+            { key: "\u2191 / \u2193", text: "scroll chat history (mouse wheel routes here too)" },
+            {
+              key: "Ctrl+P / Ctrl+N",
+              text: "previous / next prompt history \xB7 cursor up / down in a multi-line draft"
+            },
             { key: "Ctrl+A / Ctrl+E", text: "jump to start / end of the current line" },
             { key: "Ctrl+W", text: "delete the word before the cursor" },
             { key: "Ctrl+U", text: "clear the entire prompt buffer" },
@@ -919,10 +939,6 @@ var EN = {
             { key: "Shift+Tab", text: "edit-gate: toggle review \u2194 AUTO mode" },
             { key: "Esc", text: "dismiss picker \xB7 abort the running model turn" },
             { key: "Ctrl+C", text: "abort the running model turn (NOT copy \u2014 see clipboard)" },
-            {
-              key: "\u2191 / \u2193",
-              text: "scroll chat history (PromptInput cursor when buffer non-empty)"
-            },
             { key: "PgUp / PgDn", text: "scroll chat history a page at a time" },
             { key: "End", text: "jump chat to the most recent line" }
           ]
@@ -930,18 +946,18 @@ var EN = {
         {
           title: "mouse",
           rows: [
-            { key: "wheel", text: "scrolls the chat history" },
-            { key: "right-click", text: "captured by the app \u2014 use Ctrl+V / Cmd+V to paste" },
-            { key: "left-click", text: "captured (no action yet \u2014 reserved for future use)" }
+            { key: "wheel", text: "scrolls chat history (works on web/cloud/SSH terminals too)" },
+            { key: "drag", text: "selects text natively \u2014 direct copy works, no modifier" },
+            { key: "right-click", text: "terminal-native (paste menu on Windows Terminal etc.)" }
           ]
         },
         {
           title: "copy / paste",
           rows: [
-            { key: "select text", text: "hold Shift while dragging (Option on iTerm2)" },
+            { key: "select text", text: "drag to select \u2014 terminal-native (no modifier needed)" },
             {
               key: "copy",
-              text: "Ctrl+Shift+C (Win/Linux) \xB7 Cmd+C (macOS) \u2014 terminal-native after selection"
+              text: "Ctrl+Shift+C (Win/Linux) \xB7 Cmd+C (macOS) \u2014 or auto-copy-on-select if your terminal does it"
             },
             { key: "paste", text: "Ctrl+V or Ctrl+Shift+V (Win/Linux) \xB7 Cmd+V (macOS)" },
             {
@@ -959,7 +975,7 @@ var EN = {
           ]
         }
       ],
-      footer: "Mouse tracking is on so the wheel scrolls chat instead of moving the cursor \u2014 that's why right-click no longer does the terminal's native paste."
+      footer: "Wheel\u2192\u2191/\u2193 via DECSET 1007 (alternate-scroll) \u2014 wheel scrolls chat on most terminals (web/cloud/SSH included) without disturbing native selection. Drag to select stays modifier-free. Pass --no-mouse to opt out."
     },
     tipShownOnce: "shown once",
     modelOverride: "override the default model",
@@ -1160,8 +1176,22 @@ var EN = {
     apiKeyGetOne: "Get one at: https://platform.deepseek.com/api_keys",
     apiKeySavedLocally: "Saved locally to {path}",
     apiKeyInputLabel: "key \u203A ",
-    apiKeyInvalid: "Doesn't look like a DeepSeek key. They start with 'sk-' and are 30+ chars.",
+    apiKeyInvalid: "Key looks too short \u2014 paste the full token (16+ chars, no spaces).",
     apiKeyPreview: "preview: {redacted}",
+    themeTitle: "Choose a theme",
+    themeSubtitle: "Preview updates live as you navigate. Change later with /theme.",
+    themeSampleHeading: "Sample",
+    themeFooter: "[\u2191\u2193] navigate \xB7 [Enter] confirm \xB7 [Esc] cancel",
+    themeCaption: {
+      default: "GitHub dark (default)",
+      dark: "Cool dark tones",
+      light: "Clean light mode",
+      "tokyo-night": "Tokyo Night palette",
+      "github-dark": "GitHub dark",
+      "github-light": "GitHub light",
+      "high-contrast": "Accessibility"
+    },
+    reviewLabelTheme: "Theme",
     presetTitle: "Pick a preset",
     mcpTitle: "Which MCP servers should Reasonix wire up for you?",
     mcpUserArgsHint: "(you'll provide {arg})",
@@ -1188,6 +1218,68 @@ var EN = {
     selectFooter: "[\u2191\u2193] navigate \xB7 [Enter] confirm \xB7 [Esc] cancel",
     stepCounter: "Step {step}/{total} \xB7 "
   },
+  planFlow: {
+    approveCardTitle: "Approve plan",
+    approveCardMetaRight: "awaiting",
+    openQuestionsBanner: "\u25B2 the plan flags open questions or risks \u2014 pick {refine} to write concrete answers before the model moves on.",
+    openQuestionsHeader: "Open questions / risks",
+    truncatedBodyMore: "\u2026 {n} more line above in scrollback",
+    truncatedBodyMorePlural: "\u2026 {n} more lines above in scrollback",
+    picker: {
+      accept: "accept",
+      acceptHint: "run it now, in order",
+      refine: "refine",
+      refineHint: "give the agent more guidance, draft a new plan",
+      revise: "revise",
+      reviseHint: "edit the plan inline before running (skip / reorder steps)",
+      reject: "reject",
+      rejectHint: "discard, agent will retry from scratch"
+    },
+    refineFooter: "\u23CE send  \xB7  esc return to picker",
+    refineQuestionsHeading: "Answer these or describe the change you want:",
+    modes: {
+      approve: {
+        title: "approving \u2014 any last instructions?",
+        hint: "Answer questions the plan raised, add constraints, or just press Enter to approve as-is.",
+        blankHint: " (Enter with blank = approve without extra instructions.)"
+      },
+      refine: {
+        title: "refining \u2014 what should the model change?",
+        hint: "Describe what's wrong or missing, or answer questions the plan raised.",
+        blankHint: " (Enter with blank = let the model pick safe defaults for any open questions.)"
+      },
+      reject: {
+        title: "rejecting \u2014 tell the model why (optional)",
+        hint: "Say what the model got wrong about your goal, or what you actually want instead.",
+        blankHint: " (Enter with blank = cancel without explanation; the model will ask what you want.)"
+      },
+      "checkpoint-revise": {
+        title: "revising \u2014 what should change before the next step?",
+        hint: "Scope change, skip steps, alternative approach \u2014 the model adjusts the remaining plan.",
+        blankHint: " (Enter with blank = continue with the current plan.)"
+      },
+      "choice-custom": {
+        title: "custom answer \u2014 type whatever fits",
+        hint: "Free-form reply. The model reads it verbatim and proceeds \u2014 no need to match the listed options.",
+        blankHint: " (Enter with blank = ask the model what you actually want.)"
+      }
+    },
+    checkpoint: {
+      title: "Checkpoint \u2014 step done",
+      continue: "Continue \u2014 run the next step",
+      continueHint: "Model resumes with the next step.",
+      revise: "Revise \u2014 give feedback before the next step",
+      reviseHint: "Stay paused, type guidance; model adjusts the remaining plan.",
+      stop: "Stop \u2014 end the plan here",
+      stopHint: "Model summarizes what was done and ends."
+    },
+    stepList: {
+      counter: "{total} steps",
+      counterSingular: "{total} step",
+      counterDone: "{done}/{total} done ({pct}%) \xB7 {total} steps",
+      counterDoneSingular: "{done}/{total} done ({pct}%) \xB7 {total} step"
+    }
+  },
   app: {
     walkCancelledRemaining: "\u25B8 walk cancelled \u2014 {count} block(s) still pending.",
     walkCancelled: "\u25B8 walk cancelled.",
@@ -1343,8 +1435,8 @@ var EN = {
       updateNpxForce: "to force a refresh sooner: `npm cache clean --force`.",
       updateUpgradeHint: "to upgrade, exit this session and run:",
       updateUpgradeCmd1: "  reasonix update           (interactive, dry-run supported via --dry-run)",
-      updateUpgradeCmd2: "  npm install -g reasonix@latest   (direct)",
-      updateInSessionDisabled: "in-session install is deliberately disabled \u2014 the npm spawn would",
+      updateUpgradeCmd2: "  {command}   (direct)",
+      updateInSessionDisabled: "in-session install is deliberately disabled \u2014 the install spawn would",
       updateInSessionDisabled2: "corrupt this TUI's rendering and Windows can lock the running binary.",
       statsNoData: "no usage data yet.",
       statsEveryTurn: "every turn you run here appends one record \u2014 this session's turns",
@@ -1598,6 +1690,56 @@ var EN = {
       newCreated: "\u25B8 created skill: {name}\n  {path}\n  edit it, then `/skill {name}` to invoke",
       newError: "\u25B2 /skill new failed: {reason}"
     }
+  },
+  cardTitles: {
+    usage: "usage",
+    context: "context",
+    search: "search",
+    subagent: "subagent",
+    reply: "reply",
+    reasoning: "reasoning",
+    reasoningAborted: "reasoning (aborted)",
+    reasoningEllipsis: "reasoning\u2026",
+    error: "error"
+  },
+  cardLabels: {
+    prompt: "prompt",
+    reason: "reason",
+    output: "output",
+    cache: "cache",
+    session: "session",
+    balance: "balance",
+    turn: "turn",
+    system: "system",
+    tools: "tools",
+    log: "log",
+    input: "input",
+    topTools: "top tools",
+    logMsgs: "log msgs",
+    hitSingular: "{count} hit \xB7 {files} file",
+    hitsPlural: "{count} hits \xB7 {files} files",
+    moreHitSingular: "\u22EE +{count} more hit",
+    moreHitsPlural: "\u22EE +{count} more hits",
+    earlierLine: "\u22EE {count} earlier line (use /tool to read full)",
+    earlierLines: "\u22EE {count} earlier lines (use /tool to read full)",
+    earlierStackLine: "\u22EE {count} earlier stack line hidden",
+    earlierStackLines: "\u22EE {count} earlier stack lines hidden",
+    agent: "agent \xB7 {name}",
+    response: "response",
+    writing: "writing \u2026",
+    tok: "tok",
+    pilcrow: "\xB6",
+    aborted: "aborted",
+    truncatedByEsc: "[truncated by esc]",
+    rejected: "rejected",
+    exit: "exit {code}",
+    bytesIn: "{bytes} in",
+    elapsedSec: "{secs}s",
+    stackTrace: "stack trace",
+    retries: "retries",
+    reasoningLabel: "reasoning \xB7 {count} \xB6",
+    runningLabel: "running",
+    workingLabel: "working"
   }
 };
 
@@ -1673,14 +1815,15 @@ var zhCN = {
       sections: [
         {
           rows: [
-            { key: "\u6EDA\u8F6E", text: "\u6EDA\u52A8\u4E0A\u65B9\u7684\u804A\u5929\u8BB0\u5F55" },
+            { key: "\u62D6\u52A8", text: "\u76F4\u63A5\u9009\u4E2D\u6587\u672C \u2014 \u7EC8\u7AEF\u539F\u751F\uFF0C\u4E0D\u9700\u8981\u6309 Shift" },
             {
               key: "\u53F3\u952E",
-              text: "\u5DF2\u88AB\u5E94\u7528\u63A5\u7BA1 \u2014 \u7528 Ctrl+V\uFF08Win/Linux\uFF09\u6216 Cmd+V\uFF08macOS\uFF09\u7C98\u8D34"
+              text: "\u7EC8\u7AEF\u539F\u751F\u83DC\u5355\uFF08Windows Terminal \u7B49\u7684\u590D\u5236 / \u7C98\u8D34\uFF09"
             },
+            { key: "\u6EDA\u8F6E", text: "\u6EDA\u52A8\u804A\u5929\u8BB0\u5F55\uFF08Web / \u4E91\u7AEF / SSH \u7EC8\u7AEF\u4E5F\u80FD\u7528\uFF09" },
             {
-              key: "Shift + \u62D6\u52A8",
-              text: "\u539F\u751F\u9009\u4E2D\u6587\u672C\uFF08iTerm2 \u7528 Option\uFF0CWin Term / Alacritty / WezTerm \u7528 Shift\uFF09"
+              key: "\u2191 / \u2193",
+              text: "\u6EDA\u52A8\u804A\u5929 \xB7 \u8F93\u5165\u6846\u5386\u53F2 + \u591A\u884C\u5149\u6807\u7528 Ctrl+P / Ctrl+N"
             }
           ]
         }
@@ -1695,7 +1838,11 @@ var zhCN = {
           rows: [
             { key: "Enter", text: "\u63D0\u4EA4\u8F93\u5165" },
             { key: "Shift+Enter", text: "\u5728\u8F93\u5165\u6846\u4E2D\u63D2\u5165\u6362\u884C" },
-            { key: "Ctrl+P / Ctrl+N", text: "\u8C03\u51FA\u4E0A\u4E00\u6761 / \u4E0B\u4E00\u6761\u5386\u53F2\u63D0\u793A" },
+            { key: "\u2191 / \u2193", text: "\u6EDA\u52A8\u804A\u5929\u8BB0\u5F55\uFF08\u9F20\u6807\u6EDA\u8F6E\u4E5F\u8D70\u8FD9\u6761\u8DEF\u5F84\uFF09" },
+            {
+              key: "Ctrl+P / Ctrl+N",
+              text: "\u4E0A\u4E00\u6761 / \u4E0B\u4E00\u6761\u8F93\u5165\u5386\u53F2 \xB7 \u591A\u884C\u8349\u7A3F\u4E2D\u6309\u884C\u79FB\u52A8\u5149\u6807"
+            },
             { key: "Ctrl+A / Ctrl+E", text: "\u8DF3\u5230\u5F53\u524D\u884C\u7684\u5F00\u5934 / \u7ED3\u5C3E" },
             { key: "Ctrl+W", text: "\u5220\u9664\u5149\u6807\u524D\u7684\u4E00\u4E2A\u8BCD" },
             { key: "Ctrl+U", text: "\u6E05\u7A7A\u6574\u4E2A\u8F93\u5165\u7F13\u51B2\u533A" },
@@ -1703,7 +1850,6 @@ var zhCN = {
             { key: "Shift+Tab", text: "\u7F16\u8F91\u95E8\u63A7\uFF1A\u5207\u6362 \u9884\u89C8 \u2194 \u81EA\u52A8 \u6A21\u5F0F" },
             { key: "Esc", text: "\u5173\u95ED\u5F39\u51FA\u9009\u62E9\u5668 \xB7 \u4E2D\u6B62\u5F53\u524D\u6A21\u578B\u56DE\u5408" },
             { key: "Ctrl+C", text: "\u4E2D\u6B62\u5F53\u524D\u6A21\u578B\u56DE\u5408\uFF08\u4E0D\u662F\u590D\u5236 \u2014 \u89C1\u526A\u8D34\u677F\u6BB5\uFF09" },
-            { key: "\u2191 / \u2193", text: "\u6EDA\u52A8\u804A\u5929\u8BB0\u5F55\uFF08\u7F13\u51B2\u533A\u975E\u7A7A\u65F6\u4E3A\u5149\u6807\u79FB\u52A8\uFF09" },
             { key: "PgUp / PgDn", text: "\u6574\u9875\u6EDA\u52A8\u804A\u5929\u8BB0\u5F55" },
             { key: "End", text: "\u8DF3\u5230\u804A\u5929\u7684\u6700\u65B0\u4E00\u884C" }
           ]
@@ -1711,18 +1857,18 @@ var zhCN = {
         {
           title: "\u9F20\u6807",
           rows: [
-            { key: "\u6EDA\u8F6E", text: "\u6EDA\u52A8\u804A\u5929\u8BB0\u5F55" },
-            { key: "\u53F3\u952E", text: "\u88AB\u5E94\u7528\u63A5\u7BA1 \u2014 \u7528 Ctrl+V / Cmd+V \u7C98\u8D34" },
-            { key: "\u5DE6\u952E", text: "\u88AB\u63A5\u7BA1\uFF08\u6682\u65E0\u52A8\u4F5C \u2014 \u9884\u7559\u7ED9\u540E\u7EED\u529F\u80FD\uFF09" }
+            { key: "\u6EDA\u8F6E", text: "\u6EDA\u52A8\u804A\u5929\u8BB0\u5F55\uFF08Web / \u4E91\u7AEF / SSH \u7EC8\u7AEF\u4E5F\u80FD\u7528\uFF09" },
+            { key: "\u62D6\u52A8", text: "\u539F\u751F\u9009\u4E2D\u6587\u672C \u2014 \u76F4\u63A5\u590D\u5236\uFF0C\u4E0D\u9700\u8981\u4FEE\u9970\u952E" },
+            { key: "\u53F3\u952E", text: "\u7EC8\u7AEF\u539F\u751F\uFF08Windows Terminal \u7B49\u7684\u7C98\u8D34\u83DC\u5355\uFF09" }
           ]
         },
         {
           title: "\u590D\u5236 / \u7C98\u8D34",
           rows: [
-            { key: "\u9009\u4E2D\u6587\u5B57", text: "\u62D6\u52A8\u65F6\u6309\u4F4F Shift\uFF08iTerm2 \u7528 Option\uFF09" },
+            { key: "\u9009\u4E2D\u6587\u5B57", text: "\u76F4\u63A5\u62D6\u52A8 \u2014 \u7EC8\u7AEF\u539F\u751F\uFF08\u4E0D\u9700\u8981\u4EFB\u4F55\u4FEE\u9970\u952E\uFF09" },
             {
               key: "\u590D\u5236",
-              text: "Ctrl+Shift+C\uFF08Win/Linux\uFF09\xB7 Cmd+C\uFF08macOS\uFF09\u2014 \u9009\u4E2D\u540E\u7531\u7EC8\u7AEF\u539F\u751F\u5904\u7406"
+              text: "Ctrl+Shift+C\uFF08Win/Linux\uFF09\xB7 Cmd+C\uFF08macOS\uFF09\u2014 \u6216\u9009\u4E2D\u5373\u590D\u5236\uFF08\u770B\u7EC8\u7AEF\u8BBE\u7F6E\uFF09"
             },
             { key: "\u7C98\u8D34", text: "Ctrl+V \u6216 Ctrl+Shift+V\uFF08Win/Linux\uFF09\xB7 Cmd+V\uFF08macOS\uFF09" },
             {
@@ -1740,7 +1886,7 @@ var zhCN = {
           ]
         }
       ],
-      footer: "\u9F20\u6807\u8FFD\u8E2A\u5DF2\u5F00\u542F\uFF0C\u6EDA\u8F6E\u7528\u6765\u6EDA\u52A8\u804A\u5929\u800C\u4E0D\u662F\u79FB\u52A8\u5149\u6807 \u2014 \u8FD9\u4E5F\u662F\u53F3\u952E\u4E0D\u518D\u89E6\u53D1\u7EC8\u7AEF\u539F\u751F\u7C98\u8D34\u7684\u539F\u56E0\u3002"
+      footer: "\u901A\u8FC7 DECSET 1007\uFF08alternate-scroll\uFF09\uFF0C\u7EC8\u7AEF\u628A\u6EDA\u8F6E\u7FFB\u8BD1\u6210 \u2191/\u2193 \u53D1\u7ED9\u5E94\u7528 \u2014 \u5927\u591A\u6570\u7EC8\u7AEF\uFF08\u542B Web / \u4E91\u7AEF / SSH\uFF09\u90FD\u80FD\u6EDA\uFF0C\u4E14\u4E0D\u5F71\u54CD\u7EC8\u7AEF\u539F\u751F\u9009\u533A\u3002\u76F4\u63A5\u62D6\u52A8\u9009\u4E2D\u6587\u672C\u65E0\u9700 Shift\u3002\u4F20\u5165 --no-mouse \u53EF\u5173\u95ED\u3002"
     },
     tipShownOnce: "\u4EC5\u663E\u793A\u4E00\u6B21",
     modelOverride: "\u8986\u76D6\u9ED8\u8BA4\u6A21\u578B",
@@ -1945,8 +2091,22 @@ var zhCN = {
     apiKeyGetOne: "\u5728\u6B64\u83B7\u53D6\uFF1Ahttps://platform.deepseek.com/api_keys",
     apiKeySavedLocally: "\u4FDD\u5B58\u5728\u672C\u5730\uFF1A{path}",
     apiKeyInputLabel: "key \u203A ",
-    apiKeyInvalid: "\u8FD9\u770B\u8D77\u6765\u4E0D\u50CF DeepSeek \u7684 key\u3002\u5B83\u4EEC\u4EE5 'sk-' \u5F00\u5934\uFF0C30 \u5B57\u7B26\u4EE5\u4E0A\u3002",
+    apiKeyInvalid: "key \u957F\u5EA6\u4E0D\u8DB3\u2014\u2014\u8BF7\u7C98\u8D34\u5B8C\u6574 token\uFF0816+ \u5B57\u7B26\uFF0C\u4E0D\u542B\u7A7A\u683C\uFF09\u3002",
     apiKeyPreview: "\u9884\u89C8\uFF1A{redacted}",
+    themeTitle: "\u9009\u62E9\u4E3B\u9898",
+    themeSubtitle: "\u65B9\u5411\u952E\u5207\u6362\u65F6\u5373\u65F6\u9884\u89C8\u6548\u679C\uFF0C\u4E4B\u540E\u53EF\u7528 /theme \u66F4\u6539\u3002",
+    themeSampleHeading: "\u793A\u4F8B",
+    themeFooter: "[\u2191\u2193] \u79FB\u52A8 \xB7 [Enter] \u786E\u8BA4 \xB7 [Esc] \u53D6\u6D88",
+    themeCaption: {
+      default: "GitHub \u6DF1\u8272\uFF08\u9ED8\u8BA4\uFF09",
+      dark: "\u6DF1\u8272\u8C03",
+      light: "\u6E05\u723D\u6D45\u8272",
+      "tokyo-night": "\u4E1C\u4EAC\u591C\u8272",
+      "github-dark": "GitHub \u6DF1\u8272",
+      "github-light": "GitHub \u6D45\u8272",
+      "high-contrast": "\u9AD8\u5BF9\u6BD4\u5EA6\uFF08\u65E0\u969C\u788D\uFF09"
+    },
+    reviewLabelTheme: "\u4E3B\u9898",
     presetTitle: "\u9009\u62E9\u9884\u8BBE",
     mcpTitle: "Reasonix \u8981\u4E3A\u4F60\u63A5\u5165\u54EA\u4E9B MCP \u670D\u52A1\u5668\uFF1F",
     mcpUserArgsHint: "\uFF08\u9700\u8981\u4F60\u63D0\u4F9B {arg}\uFF09",
@@ -1973,6 +2133,68 @@ var zhCN = {
     selectFooter: "[\u2191\u2193] \u79FB\u52A8 \xB7 [Enter] \u786E\u8BA4 \xB7 [Esc] \u53D6\u6D88",
     stepCounter: "\u6B65\u9AA4 {step}/{total} \xB7 "
   },
+  planFlow: {
+    approveCardTitle: "\u786E\u8BA4\u8BA1\u5212",
+    approveCardMetaRight: "\u7B49\u5F85\u4E2D",
+    openQuestionsBanner: "\u25B2 \u8BA1\u5212\u4E2D\u6807\u8BB0\u4E86\u5F85\u786E\u8BA4\u7684\u95EE\u9898\u6216\u98CE\u9669 \u2014\u2014 \u8BF7\u9009 {refine} \u7ED9\u51FA\u660E\u786E\u7B54\u6848\uFF0C\u518D\u8BA9\u6A21\u578B\u7EE7\u7EED\u3002",
+    openQuestionsHeader: "\u5F85\u786E\u8BA4 / \u98CE\u9669",
+    truncatedBodyMore: "\u2026 \u8FD8\u6709 {n} \u884C\u5728\u4E0A\u65B9\u6EDA\u52A8\u5386\u53F2\u4E2D",
+    truncatedBodyMorePlural: "\u2026 \u8FD8\u6709 {n} \u884C\u5728\u4E0A\u65B9\u6EDA\u52A8\u5386\u53F2\u4E2D",
+    picker: {
+      accept: "\u91C7\u7EB3",
+      acceptHint: "\u7ACB\u5373\u6309\u987A\u5E8F\u6267\u884C",
+      refine: "\u7EC6\u5316",
+      refineHint: "\u7ED9\u6A21\u578B\u66F4\u591A\u6307\u5F15\uFF0C\u91CD\u65B0\u51FA\u4E00\u7248\u8BA1\u5212",
+      revise: "\u6539\u5199",
+      reviseHint: "\u5728\u6267\u884C\u524D\u5C31\u5730\u7F16\u8F91\u8BA1\u5212\uFF08\u8DF3\u8FC7 / \u91CD\u6392\u6B65\u9AA4\uFF09",
+      reject: "\u9A73\u56DE",
+      rejectHint: "\u4E22\u5F03\uFF0C\u8BA9\u6A21\u578B\u4ECE\u5934\u518D\u6765"
+    },
+    refineFooter: "\u23CE \u53D1\u9001  \xB7  esc \u8FD4\u56DE\u9009\u9879",
+    refineQuestionsHeading: "\u56DE\u7B54\u4EE5\u4E0B\u95EE\u9898\uFF0C\u6216\u76F4\u63A5\u8BF4\u660E\u4F60\u60F3\u8981\u7684\u4FEE\u6539\uFF1A",
+    modes: {
+      approve: {
+        title: "\u91C7\u7EB3 \u2014\u2014 \u8FD8\u6709\u8865\u5145\u6307\u793A\u5417\uFF1F",
+        hint: "\u56DE\u7B54\u8BA1\u5212\u4E2D\u7684\u95EE\u9898\u3001\u8865\u5145\u7EA6\u675F\uFF0C\u6216\u76F4\u63A5\u56DE\u8F66\u6309\u73B0\u72B6\u91C7\u7EB3\u3002",
+        blankHint: "\uFF08\u7559\u7A7A\u56DE\u8F66 = \u4E0D\u9644\u52A0\u6307\u793A\u76F4\u63A5\u91C7\u7EB3\u3002\uFF09"
+      },
+      refine: {
+        title: "\u7EC6\u5316 \u2014\u2014 \u6A21\u578B\u5E94\u8BE5\u6539\u4EC0\u4E48\uFF1F",
+        hint: "\u8BF4\u660E\u95EE\u9898\u5728\u54EA\u3001\u7F3A\u4EC0\u4E48\uFF0C\u6216\u8005\u56DE\u7B54\u8BA1\u5212\u63D0\u51FA\u7684\u7591\u95EE\u3002",
+        blankHint: "\uFF08\u7559\u7A7A\u56DE\u8F66 = \u8BA9\u6A21\u578B\u5BF9\u6240\u6709\u5F85\u786E\u8BA4\u95EE\u9898\u9009\u7528\u5B89\u5168\u9ED8\u8BA4\u3002\uFF09"
+      },
+      reject: {
+        title: "\u9A73\u56DE \u2014\u2014 \u544A\u8BC9\u6A21\u578B\u539F\u56E0\uFF08\u53EF\u9009\uFF09",
+        hint: "\u8BF4\u660E\u6A21\u578B\u5BF9\u4F60\u7684\u76EE\u6807\u7406\u89E3\u9519\u5728\u54EA\u91CC\uFF0C\u6216\u4F60\u771F\u6B63\u60F3\u8981\u4EC0\u4E48\u3002",
+        blankHint: "\uFF08\u7559\u7A7A\u56DE\u8F66 = \u4E0D\u89E3\u91CA\u76F4\u63A5\u53D6\u6D88\uFF1B\u6A21\u578B\u4F1A\u53CD\u8FC7\u6765\u95EE\u4F60\u60F3\u8981\u4EC0\u4E48\u3002\uFF09"
+      },
+      "checkpoint-revise": {
+        title: "\u6539\u5199 \u2014\u2014 \u4E0B\u4E00\u6B65\u524D\u8981\u8C03\u6574\u4EC0\u4E48\uFF1F",
+        hint: "\u8303\u56F4\u8C03\u6574\u3001\u8DF3\u8FC7\u6B65\u9AA4\u3001\u6362\u4E2A\u601D\u8DEF \u2014\u2014 \u6A21\u578B\u4F1A\u636E\u6B64\u4FEE\u6539\u5269\u4F59\u6B65\u9AA4\u3002",
+        blankHint: "\uFF08\u7559\u7A7A\u56DE\u8F66 = \u6309\u5F53\u524D\u8BA1\u5212\u7EE7\u7EED\u3002\uFF09"
+      },
+      "choice-custom": {
+        title: "\u81EA\u5B9A\u4E49\u56DE\u7B54 \u2014\u2014 \u60F3\u8BF4\u4EC0\u4E48\u90FD\u884C",
+        hint: "\u81EA\u7531\u6587\u672C\u3002\u6A21\u578B\u4F1A\u539F\u6837\u8BFB\u53D6\u5E76\u7EE7\u7EED \u2014\u2014 \u4E0D\u5FC5\u5339\u914D\u5019\u9009\u9879\u3002",
+        blankHint: "\uFF08\u7559\u7A7A\u56DE\u8F66 = \u8BA9\u6A21\u578B\u53CD\u8FC7\u6765\u95EE\u4F60\u60F3\u8981\u4EC0\u4E48\u3002\uFF09"
+      }
+    },
+    checkpoint: {
+      title: "\u68C0\u67E5\u70B9 \u2014\u2014 \u5F53\u524D\u6B65\u9AA4\u5DF2\u5B8C\u6210",
+      continue: "\u7EE7\u7EED \u2014\u2014 \u6267\u884C\u4E0B\u4E00\u6B65",
+      continueHint: "\u6A21\u578B\u4ECE\u4E0B\u4E00\u6B65\u7EE7\u7EED\u3002",
+      revise: "\u8C03\u6574 \u2014\u2014 \u5728\u4E0B\u4E00\u6B65\u524D\u7ED9\u53CD\u9988",
+      reviseHint: "\u5148\u6682\u505C\uFF0C\u8F93\u5165\u6307\u5F15\uFF1B\u6A21\u578B\u4F1A\u8C03\u6574\u5269\u4F59\u8BA1\u5212\u3002",
+      stop: "\u505C\u6B62 \u2014\u2014 \u5728\u6B64\u7ED3\u675F\u8BA1\u5212",
+      stopHint: "\u6A21\u578B\u603B\u7ED3\u5DF2\u5B8C\u6210\u7684\u5DE5\u4F5C\u5E76\u7ED3\u675F\u3002"
+    },
+    stepList: {
+      counter: "{total} \u4E2A\u6B65\u9AA4",
+      counterSingular: "{total} \u4E2A\u6B65\u9AA4",
+      counterDone: "{done}/{total} \u5DF2\u5B8C\u6210\uFF08{pct}%\uFF09 \xB7 \u5171 {total} \u6B65",
+      counterDoneSingular: "{done}/{total} \u5DF2\u5B8C\u6210\uFF08{pct}%\uFF09 \xB7 \u5171 {total} \u6B65"
+    }
+  },
   app: {
     walkCancelledRemaining: "\u25B8 \u6D4F\u89C8\u5DF2\u53D6\u6D88 \u2014 \u8FD8\u6709 {count} \u4E2A\u5F85\u5904\u7406\u7F16\u8F91\u5757\u3002",
     walkCancelled: "\u25B8 \u6D4F\u89C8\u5DF2\u53D6\u6D88\u3002",
@@ -2128,8 +2350,8 @@ var zhCN = {
       updateNpxForce: "\u8981\u5F3A\u5236\u5237\u65B0\uFF1A`npm cache clean --force`\u3002",
       updateUpgradeHint: "\u8981\u5347\u7EA7\uFF0C\u8BF7\u9000\u51FA\u6B64\u4F1A\u8BDD\u5E76\u8FD0\u884C\uFF1A",
       updateUpgradeCmd1: "  reasonix update           \uFF08\u4EA4\u4E92\u5F0F\uFF0C\u652F\u6301 --dry-run \u9884\u89C8\uFF09",
-      updateUpgradeCmd2: "  npm install -g reasonix@latest   \uFF08\u76F4\u63A5\u5B89\u88C5\uFF09",
-      updateInSessionDisabled: "\u4F1A\u8BDD\u5185\u5B89\u88C5\u88AB\u523B\u610F\u7981\u7528 \u2014 npm spawn \u4F1A",
+      updateUpgradeCmd2: "  {command}   \uFF08\u76F4\u63A5\u5B89\u88C5\uFF09",
+      updateInSessionDisabled: "\u4F1A\u8BDD\u5185\u5B89\u88C5\u88AB\u523B\u610F\u7981\u7528 \u2014 \u5B89\u88C5\u547D\u4EE4\u4F1A",
       updateInSessionDisabled2: "\u7834\u574F\u6B64 TUI \u7684\u6E32\u67D3\uFF0C\u4E14 Windows \u53EF\u80FD\u9501\u5B9A\u8FD0\u884C\u4E2D\u7684\u4E8C\u8FDB\u5236\u6587\u4EF6\u3002",
       statsNoData: "\u5C1A\u65E0\u4F7F\u7528\u6570\u636E\u3002",
       statsEveryTurn: "\u60A8\u5728\u6B64\u8FD0\u884C\u7684\u6BCF\u4E00\u8F6E\u90FD\u4F1A\u8FFD\u52A0\u4E00\u6761\u8BB0\u5F55 \u2014 \u6B64\u4F1A\u8BDD\u7684\u8F6E\u6B21",
@@ -2383,6 +2605,56 @@ var zhCN = {
       newCreated: "\u25B8 \u5DF2\u521B\u5EFA\u6280\u80FD\uFF1A{name}\n  {path}\n  \u7F16\u8F91\u540E\u7528 `/skill {name}` \u8C03\u7528",
       newError: "\u25B2 /skill new \u5931\u8D25\uFF1A{reason}"
     }
+  },
+  cardTitles: {
+    usage: "\u7528\u91CF",
+    context: "\u4E0A\u4E0B\u6587",
+    search: "\u641C\u7D22",
+    subagent: "\u5B50\u4EE3\u7406",
+    reply: "\u56DE\u590D",
+    reasoning: "\u63A8\u7406\u4E2D",
+    reasoningAborted: "\u63A8\u7406\uFF08\u5DF2\u4E2D\u6B62\uFF09",
+    reasoningEllipsis: "\u63A8\u7406\u4E2D\u2026",
+    error: "\u9519\u8BEF"
+  },
+  cardLabels: {
+    prompt: "\u63D0\u793A",
+    reason: "\u63A8\u7406",
+    output: "\u8F93\u51FA",
+    cache: "\u7F13\u5B58",
+    session: "\u4F1A\u8BDD",
+    balance: "\u4F59\u989D",
+    turn: "\u8F6E",
+    system: "\u7CFB\u7EDF",
+    tools: "\u5DE5\u5177",
+    log: "\u65E5\u5FD7",
+    input: "\u8F93\u5165",
+    topTools: "Top \u5DE5\u5177",
+    logMsgs: "\u65E5\u5FD7\u6D88\u606F",
+    hitSingular: "{count} \u6761\u7ED3\u679C \xB7 {files} \u4E2A\u6587\u4EF6",
+    hitsPlural: "{count} \u6761\u7ED3\u679C \xB7 {files} \u4E2A\u6587\u4EF6",
+    moreHitSingular: "\u22EE +{count} \u6761\u7ED3\u679C",
+    moreHitsPlural: "\u22EE +{count} \u6761\u7ED3\u679C",
+    earlierLine: "\u22EE \u524D {count} \u884C\uFF08\u4F7F\u7528 /tool \u9605\u8BFB\u5168\u6587\uFF09",
+    earlierLines: "\u22EE \u524D {count} \u884C\uFF08\u4F7F\u7528 /tool \u9605\u8BFB\u5168\u6587\uFF09",
+    earlierStackLine: "\u22EE \u524D {count} \u884C\u5806\u6808\u5DF2\u9690\u85CF",
+    earlierStackLines: "\u22EE \u524D {count} \u884C\u5806\u6808\u5DF2\u9690\u85CF",
+    agent: "\u4EE3\u7406 \xB7 {name}",
+    response: "\u56DE\u590D",
+    writing: "\u8F93\u51FA\u4E2D \u2026",
+    tok: "tok",
+    pilcrow: "\xB6",
+    aborted: "\u5DF2\u4E2D\u6B62",
+    truncatedByEsc: "[\u5DF2\u88AB Esc \u622A\u65AD]",
+    rejected: "\u5DF2\u62D2\u7EDD",
+    exit: "\u9000\u51FA\u7801 {code}",
+    bytesIn: "{bytes} \u8F93\u5165",
+    elapsedSec: "{secs}\u79D2",
+    stackTrace: "\u5806\u6808\u8DDF\u8E2A",
+    retries: "\u6B21\u91CD\u8BD5",
+    reasoningLabel: "\u63A8\u7406 \xB7 {count} \xB6",
+    runningLabel: "\u8FD0\u884C\u4E2D",
+    workingLabel: "\u5DE5\u4F5C\u4E2D"
   }
 };
 
@@ -2879,6 +3151,7 @@ var ToolRegistry = class {
   _planMode = false;
   _interceptor = null;
   _auditListener = null;
+  _resultAugmenter = null;
   constructor(opts = {}) {
     this._autoFlatten = opts.autoFlatten !== false;
   }
@@ -2897,6 +3170,10 @@ var ToolRegistry = class {
   setAuditListener(fn) {
     this._auditListener = fn;
   }
+  /** Final-stage post-processor; replaces previous augmenter when called twice. Pass null to clear. */
+  setResultAugmenter(fn) {
+    this._resultAugmenter = fn;
+  }
   register(def) {
     if (!def.name) throw new Error("tool requires a name");
     const internal = { ...def };
@@ -2972,6 +3249,7 @@ var ToolRegistry = class {
         });
       }
     }
+    let finalResult;
     try {
       try {
         this._auditListener?.({ name, args });
@@ -2989,19 +3267,26 @@ var ToolRegistry = class {
       if (opts.maxResultChars !== void 0) {
         clipped = truncateForModel(clipped, opts.maxResultChars);
       }
-      return clipped;
+      finalResult = clipped;
     } catch (err) {
       const e = err;
       if (typeof e.toToolResult === "function") {
         try {
-          return JSON.stringify(e.toToolResult());
+          finalResult = JSON.stringify(e.toToolResult());
         } catch {
+          finalResult = JSON.stringify({ error: `${e.name}: ${e.message}` });
         }
+      } else {
+        finalResult = JSON.stringify({ error: `${e.name}: ${e.message}` });
       }
-      return JSON.stringify({
-        error: `${e.name}: ${e.message}`
-      });
     }
+    if (this._resultAugmenter) {
+      try {
+        return this._resultAugmenter(name, args, finalResult);
+      } catch {
+      }
+    }
+    return finalResult;
   }
 };
 function isReadOnlyCall(tool, args) {
@@ -5762,6 +6047,10 @@ var SkillStore = class {
   }
   /** Scaffold a new skill stub at the chosen scope. Refuses to overwrite. */
   create(name, scope) {
+    return this.createWithContent(name, scope, skillStubBody(name));
+  }
+  /** Like `create` but writes caller-supplied file contents instead of the stub — used by the scaffold tool. */
+  createWithContent(name, scope, content) {
     if (!isValidSkillName(name)) {
       return { error: `invalid skill name: "${name}" \u2014 use letters, digits, _, -, .` };
     }
@@ -5776,7 +6065,7 @@ var SkillStore = class {
     }
     mkdirSync3(dirname4(flat), { recursive: true });
     try {
-      writeFileSync3(flat, skillStubBody(name), { encoding: "utf8", flag: "wx" });
+      writeFileSync3(flat, content, { encoding: "utf8", flag: "wx" });
     } catch (err) {
       if (err.code === "EEXIST") {
         return { error: `skill "${name}" already exists at ${flat}` };
@@ -6643,11 +6932,14 @@ async function searchFiles(ctx, startAbs, args) {
   await walk2(startAbs);
   return matches.length === 0 ? "(no matches)" : matches.join("\n");
 }
+var MAX_HITS_PER_FILE = 30;
+var SUMMARY_MODE_TRIGGER_RATIO = 0.8;
 async function searchContent(ctx, startAbs, args) {
   throwIfAborted(args.signal);
   const caseSensitive = args.case_sensitive === true;
   const includeDeps = args.include_deps === true;
   const ctxLines = Math.max(0, Math.min(20, Math.floor(args.context ?? 0)));
+  const summaryOnly = args.summary_only === true;
   let re = null;
   try {
     re = new RegExp(args.pattern, caseSensitive ? "" : "i");
@@ -6659,6 +6951,9 @@ async function searchContent(ctx, startAbs, args) {
   let totalBytes = 0;
   let scanned = 0;
   let truncated = false;
+  let summaryMode = summaryOnly;
+  let summaryNoticeEmitted = false;
+  const fileHitCounts = /* @__PURE__ */ new Map();
   const pushLine = (out) => {
     if (totalBytes + out.length + 1 > ctx.maxListBytes) {
       matches.push(`[\u2026 truncated at ${ctx.maxListBytes} bytes \u2014 refine pattern or path \u2026]`);
@@ -6669,6 +6964,18 @@ async function searchContent(ctx, startAbs, args) {
     totalBytes += out.length + 1;
     return true;
   };
+  const maybeEnterSummaryMode = () => {
+    if (summaryMode) return;
+    if (totalBytes <= SUMMARY_MODE_TRIGGER_RATIO * ctx.maxListBytes) return;
+    summaryMode = true;
+    if (!summaryNoticeEmitted) {
+      const pct2 = Math.round(totalBytes / ctx.maxListBytes * 100);
+      pushLine(
+        `[switching to summary mode \u2014 byte budget at ${pct2}%; remaining files will report match counts only]`
+      );
+      summaryNoticeEmitted = true;
+    }
+  };
   const walk2 = async (dir) => {
     if (truncated) return;
     throwIfAborted(args.signal);
@@ -6727,33 +7034,48 @@ async function searchContent(ctx, startAbs, args) {
       }
       scanned++;
       if (hits.length === 0) continue;
+      fileHitCounts.set(rel, hits.length);
+      if (summaryMode) {
+        if (!pushLine(`${rel}: ${hits.length} match${hits.length === 1 ? "" : "es"}`)) return;
+        continue;
+      }
+      const printable = Math.min(hits.length, MAX_HITS_PER_FILE);
+      const omittedFromFile = hits.length - printable;
+      const printableHits = hits.slice(0, printable);
       if (ctxLines === 0) {
-        for (const li of hits) {
+        for (const li of printableHits) {
           if (truncated) return;
           const line = lines[li];
           const display = line.length > 200 ? `${line.slice(0, 200)}\u2026` : line;
           if (!pushLine(`${rel}:${li + 1}: ${display}`)) return;
         }
-        continue;
-      }
-      const hitSet = new Set(hits);
-      let prevWindowEnd = -2;
-      for (const li of hits) {
-        if (truncated) return;
-        const winStart = Math.max(0, li - ctxLines);
-        const winEnd = Math.min(lines.length - 1, li + ctxLines);
-        if (winStart > prevWindowEnd + 1 && prevWindowEnd >= 0) {
-          if (!pushLine("--")) return;
-        }
-        const realStart = winStart > prevWindowEnd + 1 ? winStart : prevWindowEnd + 1;
-        for (let i = realStart; i <= winEnd; i++) {
-          const line = lines[i];
-          const display = line.length > 200 ? `${line.slice(0, 200)}\u2026` : line;
-          const sep2 = hitSet.has(i) ? ":" : "-";
-          if (!pushLine(`${rel}:${i + 1}${sep2} ${display}`)) return;
+      } else {
+        const hitSet = new Set(printableHits);
+        let prevWindowEnd = -2;
+        for (const li of printableHits) {
+          if (truncated) return;
+          const winStart = Math.max(0, li - ctxLines);
+          const winEnd = Math.min(lines.length - 1, li + ctxLines);
+          if (winStart > prevWindowEnd + 1 && prevWindowEnd >= 0) {
+            if (!pushLine("--")) return;
+          }
+          const realStart = winStart > prevWindowEnd + 1 ? winStart : prevWindowEnd + 1;
+          for (let i = realStart; i <= winEnd; i++) {
+            const line = lines[i];
+            const display = line.length > 200 ? `${line.slice(0, 200)}\u2026` : line;
+            const sep2 = hitSet.has(i) ? ":" : "-";
+            if (!pushLine(`${rel}:${i + 1}${sep2} ${display}`)) return;
+          }
+          prevWindowEnd = winEnd;
         }
-        prevWindowEnd = winEnd;
       }
+      if (omittedFromFile > 0) {
+        if (!pushLine(
+          `[${rel}: ${omittedFromFile} more match${omittedFromFile === 1 ? "" : "es"} in this file \u2014 re-grep with a tighter pattern or use read_file to see them]`
+        ))
+          return;
+      }
+      maybeEnterSummaryMode();
     }
   };
   await walk2(startAbs);
@@ -6769,6 +7091,43 @@ var DEFAULT_MAX_LIST_BYTES = 256 * 1024;
 var DEFAULT_AUTO_PREVIEW_LINES = 200;
 var AUTO_PREVIEW_HEAD_LINES = 80;
 var AUTO_PREVIEW_TAIL_LINES = 40;
+var OUTLINE_MAX_ENTRIES = 30;
+var OUTLINE_TAIL_KEEP = 5;
+var TS_EXPORT_RE = /^export\s+(?:default\s+)?(?:async\s+)?(function|class|const|let|var|interface|type|enum)\s+\*?\s*(\w+)/;
+function extractTsExportOutline(lines) {
+  const out = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (!line.startsWith("export ")) continue;
+    const m = TS_EXPORT_RE.exec(line);
+    if (!m) continue;
+    out.push({ line: i + 1, kind: m[1], name: m[2] });
+  }
+  return out;
+}
+function formatOutline(entries) {
+  const total = entries.length;
+  if (total === 0) return "";
+  const lastEntry = entries[total - 1];
+  const width = String(lastEntry.line).length;
+  const fmt = (e) => `  L${String(e.line).padStart(width, " ")}  export ${e.kind} ${e.name}`;
+  const header = `[outline: ${total} top-level export${total === 1 ? "" : "s"}]`;
+  if (total <= OUTLINE_MAX_ENTRIES) {
+    return [header, ...entries.map(fmt)].join("\n");
+  }
+  const headCount = OUTLINE_MAX_ENTRIES - OUTLINE_TAIL_KEEP;
+  const headEntries = entries.slice(0, headCount);
+  const tailEntries = entries.slice(-OUTLINE_TAIL_KEEP);
+  const omitted = total - OUTLINE_MAX_ENTRIES;
+  const gapStart = headEntries[headEntries.length - 1].line;
+  const gapEnd = tailEntries[0].line;
+  return [
+    header,
+    ...headEntries.map(fmt),
+    `  [\u2026 ${omitted} more export${omitted === 1 ? "" : "s"} between L${gapStart} and L${gapEnd} \u2026]`,
+    ...tailEntries.map(fmt)
+  ].join("\n");
+}
 var SKIP_DIR_NAMES = new Set(DEFAULT_INDEX_EXCLUDES.dirs);
 var BINARY_EXTENSIONS = new Set(DEFAULT_INDEX_EXCLUDES.exts);
 function displayRel4(rootDir, full) {
@@ -6821,7 +7180,7 @@ function registerFilesystemTools(registry, opts) {
   - head: N  \u2192 first N lines (imports, public API, small configs)
   - tail: N  \u2192 last N lines (recently-added code, log tails)
   - range: "A-B"  \u2192 inclusive line range A..B, 1-indexed (e.g. "120-180" around an edit site)
-When none of these is given AND the file is longer than ${DEFAULT_AUTO_PREVIEW_LINES} lines, the tool auto-returns a head+tail preview with an "N lines omitted" marker rather than dumping everything. If you need the middle, re-call with a range. Prefer search_content to locate a symbol first, then read_file with a range around the hit \u2014 one scoped read beats three full-file reads.`,
+When none of these is given AND the file is longer than ${DEFAULT_AUTO_PREVIEW_LINES} lines, the tool auto-returns a head+tail preview with an "N lines omitted" marker, plus a top-level export outline (function / class / const / interface / type / enum names with line numbers, capped at ${OUTLINE_MAX_ENTRIES}) so you can pick a smart range without a follow-up grep. If you need the middle, re-call with a range. Prefer search_content to locate a symbol first only when the outline doesn't have what you want \u2014 one scoped read beats three full-file reads.`,
     readOnly: true,
     stormExempt: true,
     parameters: {
@@ -6889,14 +7248,19 @@ ${slice.join("\n")}`;
       const head = lines.slice(0, AUTO_PREVIEW_HEAD_LINES).join("\n");
       const tail = lines.slice(totalLines - AUTO_PREVIEW_TAIL_LINES).join("\n");
       const omitted = totalLines - AUTO_PREVIEW_HEAD_LINES - AUTO_PREVIEW_TAIL_LINES;
-      return [
+      const outline = formatOutline(extractTsExportOutline(lines));
+      const parts = [
         `[auto-preview: head ${AUTO_PREVIEW_HEAD_LINES} + tail ${AUTO_PREVIEW_TAIL_LINES} of ${totalLines} lines]`,
-        head,
+        head
+      ];
+      if (outline) parts.push("", outline);
+      parts.push(
         `
 [\u2026 ${omitted} lines omitted \u2014 call read_file again with range:"A-B" (1-indexed) or head / tail to get the middle]
 `,
         tail
-      ].join("\n");
+      );
+      return parts.join("\n");
     }
   });
   registry.register({
@@ -7029,7 +7393,7 @@ Prefer \`list_directory\` for a single-level view, \`search_files\` to find spec
   registry.register({
     name: "search_content",
     parallelSafe: true,
-    description: "Recursively grep file CONTENTS for a substring or regex. This is the right tool for 'find all places that call X', 'where is Y referenced', 'what files contain Z'. Different from search_files (which matches FILE NAMES). Returns one match per line in 'path:line: text' format. Skips dependency / VCS / build directories (node_modules, .git, dist, build, .next, target, .venv) and binary files by default.",
+    description: "Recursively grep file CONTENTS for a substring or regex. This is the right tool for 'find all places that call X', 'where is Y referenced', 'what files contain Z'. Different from search_files (which matches FILE NAMES). Returns one match per line in 'path:line: text' format. Per-file hits are capped at 30 (a footer reports any extras); when the byte budget is mostly spent the remaining files switch to a 'rel: N matches' histogram so distribution stays visible instead of one popular file drowning the rest. Pass `summary_only:true` to skip line content entirely and get just the histogram. Skips dependency / VCS / build directories (node_modules, .git, dist, build, .next, target, .venv) and binary files by default.",
     readOnly: true,
     parameters: {
       type: "object",
@@ -7057,6 +7421,10 @@ Prefer \`list_directory\` for a single-level view, \`search_files\` to find spec
         context: {
           type: "integer",
           description: "Lines of context to show around each match (both before and after). Default 0 (just the matching line). Capped at 20. Output uses ripgrep style: `:` after the line number on the matching line, `-` on context lines, `--` separating non-adjacent windows."
+        },
+        summary_only: {
+          type: "boolean",
+          description: "When true, skip line content and return one 'rel: N matches' line per matching file. Use for 'where does this exist at all' questions before drilling in with a targeted read_file."
         }
       },
       required: ["pattern"]
@@ -7593,9 +7961,14 @@ function registerSubmitPlan(registry, opts) {
         kind: "plan_proposed",
         payload: { plan, steps, summary }
       });
-      if (verdict.type === "approve") return "plan approved";
-      if (verdict.type === "refine") throw new Error("user requested refinement");
-      throw new Error("plan cancelled");
+      const fb = verdict.feedback?.trim();
+      if (verdict.type === "approve") {
+        return fb ? `plan approved. user's additional instructions: ${fb}` : "plan approved";
+      }
+      if (verdict.type === "refine") {
+        throw new Error(fb ? `user requested refinement: ${fb}` : "user requested refinement");
+      }
+      throw new Error(fb ? `plan cancelled: ${fb}` : "plan cancelled");
     }
   });
 }
@@ -7881,6 +8254,10 @@ var DEFAULT_MAX_RESULT_CHARS2 = 8e3;
 var DEFAULT_MAX_ITERS = 16;
 var MIN_MAX_ITERS = 1;
 var MAX_MAX_ITERS = 32;
+var BUDGET_WARN_THRESHOLD = 3;
+function budgetParagraph(maxToolIters) {
+  return `Tool budget: you have ${maxToolIters} tool call${maxToolIters === 1 ? "" : "s"} for this task. The cap is enforced from outside \u2014 the call after #${maxToolIters} is refused. Pace yourself: if you can't fully resolve the task within the budget, stop early and return what you have plus what's missing, rather than burning the budget on one branch.`;
+}
 var DEFAULT_SUBAGENT_MODEL = "deepseek-v4-flash";
 var DEFAULT_SUBAGENT_EFFORT = "high";
 var SUBAGENT_TOOL_NAME = "spawn_subagent";
@@ -7939,8 +8316,26 @@ async function spawnSubagent(opts) {
     new Set(opts.allowedTools),
     NEVER_INHERITED_TOOLS
   ) : forkRegistryExcluding(opts.parentRegistry, NEVER_INHERITED_TOOLS);
+  let dispatchCount = 0;
+  childTools.setResultAugmenter((_name, _args, result) => {
+    dispatchCount++;
+    const remaining = maxToolIters - dispatchCount;
+    if (remaining <= 0) {
+      return `${result}
+
+[budget: 0 of ${maxToolIters} tool calls left \u2014 finalize NOW; the next tool call will be refused]`;
+    }
+    if (remaining <= BUDGET_WARN_THRESHOLD) {
+      return `${result}
+
+[budget: ${remaining} of ${maxToolIters} tool call${remaining === 1 ? "" : "s"} left \u2014 wrap up soon]`;
+    }
+    return result;
+  });
   const childPrefix = new ImmutablePrefix({
-    system: opts.system,
+    system: `${opts.system}
+
+${budgetParagraph(maxToolIters)}`,
     toolSpecs: childTools.specs()
   });
   const childLoop = new CacheFirstLoop({
@@ -9208,6 +9603,7 @@ async function runCommand(cmd, opts) {
     });
   }
   const timeoutMs = timeoutSec * 1e3;
+  const normalizedEnv = normalizeWindowsEnvVars(process.env);
   const spawnOpts = {
     cwd: opts.cwd,
     shell: false,
@@ -9221,9 +9617,9 @@ async function runCommand(cmd, opts) {
     // sees a Python traceback instead of the script's real output
     // and goes around in circles trying to fix the wrong problem.
     // Harmless on non-Python processes (env vars they don't read).
-    env: { ...process.env, PYTHONIOENCODING: "utf-8", PYTHONUTF8: "1" }
+    env: { ...normalizedEnv, PYTHONIOENCODING: "utf-8", PYTHONUTF8: "1" }
   };
-  const { bin, args, spawnOverrides } = prepareSpawn(argv);
+  const { bin, args, spawnOverrides } = prepareSpawn(argv, { env: normalizedEnv });
   const effectiveSpawnOpts = { ...spawnOpts, ...spawnOverrides };
   return await new Promise((resolve10, reject) => {
     let child;
@@ -9304,9 +9700,9 @@ function resolveExecutable(cmd, opts = {}) {
   if (cmd.includes("/") || cmd.includes("\\") || pathMod7.isAbsolute(cmd)) return cmd;
   if (pathMod7.extname(cmd)) return cmd;
   const env = opts.env ?? process.env;
-  const pathExt = (env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";").map((e) => e.trim()).filter(Boolean);
+  const pathExt = (getEnvCaseInsensitive(env, "PATHEXT") ?? ".COM;.EXE;.BAT;.CMD").split(";").map((e) => e.trim()).filter(Boolean);
   const delimiter2 = opts.pathDelimiter ?? (platform === "win32" ? ";" : pathMod7.delimiter);
-  const pathDirs = (env.PATH ?? "").split(delimiter2).filter(Boolean);
+  const pathDirs = (getEnvCaseInsensitive(env, "PATH") ?? "").split(delimiter2).filter(Boolean);
   const isFile = opts.isFile ?? defaultIsFile;
   for (const dir of pathDirs) {
     for (const ext of pathExt) {
@@ -9316,6 +9712,52 @@ function resolveExecutable(cmd, opts = {}) {
   }
   return cmd;
 }
+function normalizeWindowsEnvVars(env, opts = {}) {
+  const platform = opts.platform ?? process.platform;
+  if (platform !== "win32") return { ...env };
+  const out = {};
+  const pathValues = [];
+  const pathExtValues = [];
+  for (const [key, value] of Object.entries(env)) {
+    const lower = key.toLowerCase();
+    if (lower === "path") {
+      if (typeof value === "string") pathValues.push(value);
+      continue;
+    }
+    if (lower === "pathext") {
+      if (typeof value === "string") pathExtValues.push(value);
+      continue;
+    }
+    out[key] = value;
+  }
+  if (pathValues.length > 0) out.Path = mergeWindowsPathLike(pathValues, ";");
+  if (pathExtValues.length > 0) out.PATHEXT = mergeWindowsPathLike(pathExtValues, ";");
+  return out;
+}
+function getEnvCaseInsensitive(env, key) {
+  const exact = env[key];
+  if (exact !== void 0) return exact;
+  const target = key.toLowerCase();
+  for (const [candidate, value] of Object.entries(env)) {
+    if (candidate.toLowerCase() === target) return value;
+  }
+  return void 0;
+}
+function mergeWindowsPathLike(values, delimiter2) {
+  const seen = /* @__PURE__ */ new Set();
+  const merged = [];
+  for (const value of values) {
+    for (const part of value.split(delimiter2)) {
+      const entry = part.trim();
+      if (!entry) continue;
+      const normalized = entry.toLowerCase();
+      if (seen.has(normalized)) continue;
+      seen.add(normalized);
+      merged.push(entry);
+    }
+  }
+  return merged.join(delimiter2);
+}
 function defaultIsFile(full) {
   try {
     return existsSync8(full) && statSync4(full).isFile();
@@ -10536,13 +10978,32 @@ function compareVersions(a, b) {
   if (!bPre) return -1;
   return aPre < bPre ? -1 : aPre > bPre ? 1 : 0;
 }
+function detectInstallSource(bin) {
+  const raw = bin ?? process.argv[1] ?? "";
+  if (!raw) return "unknown";
+  const norm = raw.replace(/\\/g, "/").toLowerCase();
+  if (/\/_npx\//.test(norm)) return "npx";
+  if (/\/\.pnpm\//.test(norm) && /dlx/i.test(norm)) return "npx";
+  const ua = (process.env.npm_config_user_agent ?? "").toLowerCase();
+  if (ua.includes("npx/")) return "npx";
+  if (/\/\.bun\//.test(norm) || /\/bun\/install\//.test(norm)) return "bun";
+  if (/\/pnpm\/global\//.test(norm) || /\/pnpm\/[^/]+\/node_modules\//.test(norm)) return "pnpm";
+  if (/\/yarn\/global\//.test(norm) || /\/\.yarn\/global\//.test(norm)) return "yarn";
+  if (/\/node_modules\/reasonix(\b|\/)/.test(norm)) return "npm";
+  return "unknown";
+}
 function isNpxInstall() {
-  const bin = process.argv[1] ?? "";
-  if (/[/\\]_npx[/\\]/.test(bin)) return true;
-  if (/[/\\]\.pnpm[/\\]/.test(bin) && /dlx/i.test(bin)) return true;
-  const ua = process.env.npm_config_user_agent ?? "";
-  if (ua.includes("npx/")) return true;
-  return false;
+  return detectInstallSource() === "npx";
+}
+function detectNpmInstallPrefix(bin) {
+  const raw = bin ?? process.argv[1] ?? "";
+  if (!raw) return null;
+  const norm = raw.replace(/\\/g, "/");
+  const posix = norm.match(/^(.+?)\/lib\/node_modules\/reasonix(?:\/|$)/i);
+  if (posix) return posix[1] ?? null;
+  const win = norm.match(/^(.+?)\/node_modules\/reasonix(?:\/|$)/i);
+  if (win) return win[1] ?? null;
+  return null;
 }
 
 // src/mcp/types.ts
@@ -11994,6 +12455,8 @@ export {
   defaultUsageLogPath,
   deleteSession,
   detectAtPicker,
+  detectInstallSource,
+  detectNpmInstallPrefix,
   detectShellOperator,
   diffTranscripts,
   expandAtMentions,
@@ -12025,6 +12488,7 @@ export {
   listFilesWithStatsSync,
   listSessions,
   loadApiKey,
+  loadBaseUrl,
   loadDotenv,
   loadHooks,
   loadSessionMessages,
@@ -12069,6 +12533,7 @@ export {
   sanitizeMemoryName,
   sanitizeName as sanitizeSessionName,
   saveApiKey,
+  saveBaseUrl,
   scavengeToolCalls,
   sessionPath,
   sessionsDir,