reasonix 0.37.0 → 0.38.0

package/dist/index.js

@@ -980,6 +980,10 @@ var EN = {
           title: "copy / paste",
           rows: [
             { key: "select text", text: "drag to select \u2014 terminal-native (no modifier needed)" },
+            {
+              key: "/copy",
+              text: "vim/tmux-style copy mode \u2014 works in SSH/mosh/tmux where drag-select can't extend past the viewport"
+            },
             {
               key: "copy",
               text: "Ctrl+Shift+C (Win/Linux) \xB7 Cmd+C (macOS) \u2014 or auto-copy-on-select if your terminal does it"
@@ -1062,6 +1066,9 @@ var EN = {
   },
   slash: {
     help: { description: "show the full command reference" },
+    copy: {
+      description: "open vim/tmux-style copy mode \u2014 j/k navigate, v select, y yank to clipboard"
+    },
     status: { description: "current model, flags, context, session" },
     preset: {
       description: "model bundle \u2014 auto escalates flash \u2192 pro, flash/pro lock",
@@ -1069,6 +1076,10 @@ var EN = {
     },
     model: { description: "switch DeepSeek model id", argsHint: "<id>" },
     models: { description: "list available models fetched from DeepSeek /models" },
+    theme: {
+      description: "show or persist the terminal theme preference. Bare opens picker.",
+      argsHint: "[auto|default|dark|light|tokyo-night|github-dark|github-light|high-contrast]"
+    },
     language: {
       description: "switch the runtime language",
       argsHint: "<EN|zh-CN>",
@@ -1124,9 +1135,15 @@ var EN = {
     context: { description: "show context-window breakdown (system / tools / log / input)" },
     retry: { description: "truncate & resend your last message (fresh sample)" },
     compact: {
-      description: "shrink oversized tool results AND tool-call args (edit_file search/replace) in the log; cap in tokens, default 4000",
+      description: "narrow oversized tool results + tool-call args in the log; cap at tokens, default 4000",
       argsHint: "[tokens]"
     },
+    cwd: {
+      description: "switch the workspace root mid-session \u2014 re-points fs / shell / memory tools, reloads project hooks, refreshes the at-mention walker",
+      argsHint: "<path>"
+    },
+    stop: { description: "abort the current model turn (typed alternative to Esc)" },
+    feedback: { description: "open a GitHub issue with diagnostic info copied to clipboard" },
     keys: { description: "keyboard + mouse + copy/paste reference" },
     plans: { description: "list this session's active + archived plans, newest first" },
     replay: {
@@ -1202,6 +1219,9 @@ var EN = {
     apiKeySavedLocally: "Saved locally to {path}",
     apiKeyInputLabel: "key \u203A ",
     apiKeyInvalid: "Key looks too short \u2014 paste the full token (16+ chars, no spaces).",
+    apiKeyChecking: "Checking API key\u2026",
+    apiKeyRejected: "DeepSeek rejected this API key. Paste a valid key, or press Esc to cancel setup.",
+    apiKeyCheckFailed: "Could not verify this API key right now ({message}). Check your network or try again.",
     apiKeyPreview: "preview: {redacted}",
     themeTitle: "Choose a theme",
     themeSubtitle: "Preview updates live as you navigate. Change later with /theme.",
@@ -1749,12 +1769,157 @@ var EN = {
     waitingForResponse: "\u2026waiting for response\u2026",
     hintSend: "send",
     hintNewline: "newline",
+    hintClear: "clear",
     hintScroll: "scroll",
     hintHistory: "history",
     hintAbort: "abort",
     hintQuit: "quit",
     abortedHint: "turn aborted by user \xB7 esc again to clear \xB7 \u23CE to ask a follow-up"
   },
+  shellConfirm: {
+    title: "Shell command",
+    bgTitle: "Background process",
+    subtitle: "model wants to run a shell command",
+    bgSubtitle: "long-running process \u2014 keeps running after approval, /kill to stop",
+    denyTitle: "Deny \u2014 provide context",
+    optional: "optional",
+    denyFooter: "type context  \xB7  \u23CE submit with reason  \xB7  esc skip (deny without reason)",
+    awaiting: "awaiting",
+    pickFooter: "\u2191\u2193 pick  \xB7  \u23CE confirm  \xB7  Tab add context  \xB7  esc cancel",
+    allowOnce: "allow once",
+    allowOnceDesc: "run this command, ask again next time",
+    allowAlways: "allow always",
+    allowAlwaysDesc: "remember `{prefix}` for this project",
+    deny: "deny",
+    denyDesc: "press Tab to add context telling the model why"
+  },
+  editConfirm: {
+    footer: "[y/Enter] apply  \xB7  [n] reject with reason  \xB7  [a] apply rest  \xB7  [A] flip AUTO  \xB7  [\u2191\u2193/Space] scroll  \xB7  [Esc] abort",
+    newTag: "NEW",
+    editTag: "EDIT",
+    linesCount: "-{removed} +{added} lines",
+    viewingRange: "viewing {start}-{end}/{total}",
+    denyFooter: "\u23CE submit  \xB7  esc skip (deny without reason)",
+    oldLabel: "  - old",
+    newLabel: "  + new",
+    sideBySide: "   side-by-side \xB7 removed lines on the left, added on the right \xB7 paired by offset",
+    linesAbove: "  \u2191 {count} line above  (\u2191/k or PgUp)",
+    linesAbovePlural: "  \u2191 {count} lines above  (\u2191/k or PgUp)",
+    linesBelow: "  \u2193 {count} line below  (\u2193/j or Space/PgDn)",
+    linesBelowPlural: "  \u2193 {count} lines below  (\u2193/j or Space/PgDn)"
+  },
+  sessionPicker: {
+    header: " \u25C8 REASONIX \xB7 pick a session ",
+    title: "pick a session \u2014 {workspace}",
+    messages: "{count} message",
+    messagesPlural: "{count} messages",
+    turns: "{count} turns",
+    pickerHint: "\u2191\u2193 pick \xB7 \u23CE open \xB7 [n] new \xB7 [d] delete \xB7 [r] rename \xB7 esc quit",
+    empty: "  no saved sessions in this workspace yet \u2014 press ",
+    emptyNew: " to start a new one",
+    renamePrompt: '  rename "{from}" \u2192 ',
+    renameHint: "  \u23CE confirm rename  \xB7  esc cancel",
+    emptyHint: "  \u23CE new session  \xB7  esc quit",
+    justNow: "just now",
+    minAgo: "{count} min ago",
+    yesterday: "yesterday",
+    hoursAgo: "{count}h ago",
+    daysAgo: "{count} days ago"
+  },
+  modelPicker: {
+    header: " \u25C8 REASONIX \xB7 pick a setup ",
+    loading: "  \xB7  loading catalog\u2026",
+    catalogEmpty: "  \xB7  catalog empty \u2014 using known fallbacks",
+    modelsAvailable: "  \xB7  {count} models available",
+    presetsHeader: "    PRESETS  \xB7  recommended \u2014 model + effort + auto-escalate",
+    modelsHeader: "    MODELS  \xB7  raw pick \u2014 auto-escalate stays as-is",
+    pickerFooter: "  \u2191\u2193 pick  \xB7  \u23CE confirm  \xB7  [r] refresh  \xB7  esc cancel",
+    currentLabel: "  \xB7 current"
+  },
+  slashSuggestions: {
+    noMatch: "no slash command matches that prefix",
+    backspaceHint: " \u2014 Backspace to edit, or /help for the full list",
+    commandCount: "{count} command",
+    commandCountPlural: "{count} commands",
+    aboveLabel: "   \u2191 {count} above",
+    belowLabel: "   \u2193 {count} below",
+    advancedHint: "  + {count} advanced  \xB7  type a letter to search",
+    footerHint: "  \u2191\u2193 navigate \xB7 Tab / \u23CE pick \xB7 esc cancel",
+    groupChat: "CHAT",
+    groupSetup: "SETUP",
+    groupInfo: "INFO",
+    groupSession: "SESSION",
+    groupExtend: "EXTEND",
+    groupCode: "CODE",
+    groupJobs: "JOBS",
+    groupAdvanced: "ADVANCED"
+  },
+  atMentions: {
+    loading: "loading\u2026",
+    entrySingular: "{count} entry",
+    entryPlural: "{count} entries",
+    searching: "searching\u2026",
+    scanned: "scanned",
+    match: "match",
+    matches: "matches",
+    forFilter: 'for "{filter}"',
+    noMatch: 'no files match "{filter}"',
+    emptyDir: "empty directory",
+    scanning: "scanning the tree\u2026",
+    footerBrowse: "\u2191\u2193 navigate \xB7 Tab drill into folder \xB7 \u23CE insert \xB7 esc cancel",
+    footerBrowseSearch: "\u2191\u2193 navigate \xB7 Tab / \u23CE insert as @path \xB7 esc cancel",
+    footerInsert: "\u2191\u2193 navigate \xB7 Tab / \u23CE insert as @path \xB7 esc cancel"
+  },
+  statsPanel: {
+    modePlan: "PLAN",
+    modeYolo: "yolo",
+    modeAuto: "auto",
+    modeReview: "review",
+    pro: "\u21E7 pro",
+    budget: "  budget  "
+  },
+  welcomeBanner: {
+    workspace: "\u25B8 workspace",
+    relaunchHint: "  (relaunch with --dir <path> to switch)",
+    dashboard: "\u25B8 web"
+  },
+  ctxBreakdown: {
+    title: "\u25A3 context",
+    compactHint: "  /compact folds (auto at 50%) \xB7 /new wipes log",
+    topTools: "  top tool results by cost ({count}):",
+    msg: "msg",
+    turnLabel: "turn"
+  },
+  startup: {
+    codeRooted: '\u25B8 reasonix code: rooted at {rootDir}, session "{session}" \xB7 {tools} native tool(s){semantic}',
+    ephemeral: "(ephemeral)",
+    semanticOn: " \xB7 semantic_search on"
+  },
+  doctorErrors: {
+    unreadable: "{path} unreadable \u2014 {message}",
+    cannotList: "cannot list \u2014 {message}",
+    parseFailed: "couldn't parse settings.json \u2014 {message}",
+    probeFailed: "probe failed \u2014 {message}"
+  },
+  webErrors: {
+    status: "web_search {status}",
+    mojeekBlocked: "web_search: Mojeek anti-bot page \u2014 rate-limited or blocked",
+    mojeekNoResults: "web_search: 0 results but response doesn't look like a real empty page ({chars} chars, first 120: {preview})",
+    invalidEndpoint: 'web_search: invalid SearXNG endpoint "{endpoint}"',
+    endpointMustBeHttp: "web_search: SearXNG endpoint must be http(s), got {protocol}",
+    cannotReach: "web_search: Cannot reach SearXNG server at {endpoint}. Please install SearXNG (https://github.com/searxng/searxng) and start it (e.g. `docker run -d -p 8080:8080 searxng/searxng`), or switch to the default engine with /search-engine mojeek.",
+    searxngNoResults: "web_search: 0 results but SearXNG response doesn't look like an empty results page ({chars} chars)",
+    fetchStatus: "web_fetch {status} for {url}",
+    fetchTooLarge: "web_fetch refused: content-length {len} bytes exceeds {cap}-byte cap ({url})",
+    fetchBodyTooLarge: "web_fetch refused: response body exceeded {cap}-byte cap ({seen} bytes seen)",
+    fetchInvalidUrl: "web_fetch: url must start with http:// or https://"
+  },
+  choiceConfirm: {
+    customLabel: "Let me type my own answer",
+    customDesc: "None of the above fits \u2014 type a free-form reply. The model reads it verbatim.",
+    cancelLabel: "Cancel \u2014 drop the question",
+    cancelDesc: "Model stops and asks what you want instead."
+  },
   cardTitles: {
     usage: "usage",
     context: "context",
@@ -1764,7 +1929,9 @@ var EN = {
     reasoning: "reasoning",
     reasoningAborted: "reasoning (aborted)",
     reasoningEllipsis: "reasoning\u2026",
-    error: "error"
+    error: "error",
+    doctor: "doctor",
+    you: "you"
   },
   cardLabels: {
     prompt: "prompt",
@@ -1803,7 +1970,42 @@ var EN = {
     retries: "retries",
     reasoningLabel: "reasoning \xB7 {count} \xB6",
     runningLabel: "running",
-    workingLabel: "working"
+    workingLabel: "working",
+    defaultFooter: "\u2191\u2193 pick  \xB7  \u23CE confirm  \xB7  esc cancel",
+    applyAction: "[a] apply",
+    skipAction: "[s] skip",
+    rejectAction: "[r] reject",
+    levelOk: "OK",
+    levelWarn: "warn",
+    levelFail: "FAIL",
+    checksLabel: "checks",
+    passed: "passed",
+    warnTag: "warn",
+    failTag: "fail",
+    stepLabel: "step",
+    done: "done",
+    inProgress: "\u2190 in progress",
+    upcoming: "upcoming",
+    resumed: "resumed \xB7 ",
+    archive: "\u23EA archive \xB7 ",
+    more: "\u22EE +{count} more",
+    categoryUser: "user",
+    categoryFeedback: "feedback",
+    categoryProject: "project",
+    categoryReference: "reference"
+  },
+  copyMode: {
+    title: "\u2500\u2500 COPY MODE \u2500\u2500",
+    help: "j/k or \u2191/\u2193 move \xB7 v select \xB7 y yank \xB7 g/G top/bottom \xB7 q quit",
+    statusBar: "line {cur}/{total} \xB7 selection: {sel}",
+    statusYanked: "yanked {size} chars (osc52={osc52})",
+    statusEmpty: "nothing selected",
+    empty: "(no chat content yet \u2014 say something to the model first)",
+    labelUser: "you",
+    labelAssistant: "assistant",
+    labelReasoning: "reasoning",
+    yankedToast: "\u25B8 copied {size} chars to clipboard (osc52)",
+    yankedToastFile: "\u25B8 copied {size} chars \xB7 file: {path}"
   }
 };
 
@@ -1930,6 +2132,10 @@ var zhCN = {
           title: "\u590D\u5236 / \u7C98\u8D34",
           rows: [
             { 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: "/copy",
+              text: "vim/tmux \u98CE\u683C\u590D\u5236\u6A21\u5F0F \u2014 SSH / mosh / tmux \u4E0B\u62D6\u9009\u8D8A\u8FC7\u53EF\u89C6\u533A\u65E0\u6548\u65F6\u7528\u8FD9\u4E2A"
+            },
             {
               key: "\u590D\u5236",
               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"
@@ -2012,6 +2218,9 @@ var zhCN = {
   },
   slash: {
     help: { description: "\u663E\u793A\u5B8C\u6574\u547D\u4EE4\u53C2\u8003" },
+    copy: {
+      description: "\u8FDB\u5165 vim/tmux \u98CE\u683C\u590D\u5236\u6A21\u5F0F \u2014 j/k \u79FB\u52A8\u3001v \u8D77\u9009\u533A\u3001y \u590D\u5236\u5230\u526A\u8D34\u677F"
+    },
     status: { description: "\u5F53\u524D\u6A21\u578B\u3001\u6807\u5FD7\u3001\u4E0A\u4E0B\u6587\u3001\u4F1A\u8BDD" },
     preset: {
       description: "\u6A21\u578B\u7EC4\u5408 \u2014 \u81EA\u52A8\u5728 flash \u2192 pro \u4E4B\u95F4\u5207\u6362\uFF0C\u6216\u9501\u5B9A flash/pro",
@@ -2019,6 +2228,10 @@ var zhCN = {
     },
     model: { description: "\u5207\u6362 DeepSeek \u6A21\u578B ID", argsHint: "<id>" },
     models: { description: "\u5217\u51FA\u4ECE DeepSeek /models \u83B7\u53D6\u7684\u53EF\u7528\u6A21\u578B" },
+    theme: {
+      description: "\u663E\u793A\u6216\u6301\u4E45\u5316\u7EC8\u7AEF\u4E3B\u9898\u504F\u597D\u3002\u65E0\u53C2\u6570\u65F6\u6253\u5F00\u9009\u62E9\u5668\u3002",
+      argsHint: "[auto|default|dark|light|tokyo-night|github-dark|github-light|high-contrast]"
+    },
     language: {
       description: "\u5207\u6362\u8FD0\u884C\u65F6\u8BED\u8A00",
       argsHint: "<en|zh-CN>",
@@ -2080,6 +2293,12 @@ var zhCN = {
       argsHint: "[tokens]"
     },
     keys: { description: "\u952E\u76D8 + \u9F20\u6807 + \u590D\u5236\u7C98\u8D34\u53C2\u8003" },
+    cwd: {
+      description: "\u5207\u6362\u5DE5\u4F5C\u533A\u6839\u76EE\u5F55 \u2014 \u91CD\u65B0\u6307\u5411\u6587\u4EF6/Shell/\u8BB0\u5FC6\u5DE5\u5177\uFF0C\u91CD\u8F7D\u9879\u76EE hooks\uFF0C\u5237\u65B0 @ \u5F15\u7528\u904D\u5386\u5668",
+      argsHint: "<path>"
+    },
+    stop: { description: "\u4E2D\u6B62\u5F53\u524D\u6A21\u578B\u56DE\u5408\uFF08\u6309 Esc \u7684\u66FF\u4EE3\u65B9\u5F0F\uFF09" },
+    feedback: { description: "\u6253\u5F00 GitHub Issue\uFF0C\u8BCA\u65AD\u4FE1\u606F\u5DF2\u590D\u5236\u5230\u526A\u8D34\u677F" },
     plans: { description: "\u5217\u51FA\u6B64\u4F1A\u8BDD\u7684\u6D3B\u8DC3 + \u5F52\u6863\u8BA1\u5212\uFF08\u6700\u65B0\u5728\u524D\uFF09" },
     replay: {
       description: "\u52A0\u8F7D\u5F52\u6863\u8BA1\u5212\u4E3A\u53EA\u8BFB\u7684\u65F6\u95F4\u65C5\u884C\u5FEB\u7167\uFF08\u9ED8\u8BA4\uFF1A\u6700\u65B0\uFF09",
@@ -2156,6 +2375,9 @@ var zhCN = {
     apiKeySavedLocally: "\u4FDD\u5B58\u5728\u672C\u5730\uFF1A{path}",
     apiKeyInputLabel: "key \u203A ",
     apiKeyInvalid: "key \u957F\u5EA6\u4E0D\u8DB3\u2014\u2014\u8BF7\u7C98\u8D34\u5B8C\u6574 token\uFF0816+ \u5B57\u7B26\uFF0C\u4E0D\u542B\u7A7A\u683C\uFF09\u3002",
+    apiKeyChecking: "\u6B63\u5728\u68C0\u67E5 API key\u2026",
+    apiKeyRejected: "DeepSeek \u62D2\u7EDD\u4E86\u8FD9\u4E2A API key\u3002\u8BF7\u7C98\u8D34\u6709\u6548 key\uFF0C\u6216\u6309 Esc \u53D6\u6D88\u8BBE\u7F6E\u3002",
+    apiKeyCheckFailed: "\u6682\u65F6\u65E0\u6CD5\u9A8C\u8BC1 API key\uFF08{message}\uFF09\u3002\u8BF7\u68C0\u67E5\u7F51\u7EDC\u540E\u91CD\u8BD5\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",
@@ -2689,10 +2911,10 @@ var zhCN = {
     plan: "\u8BA1\u5212",
     yolo: "\u81EA\u7531",
     auto: "\u81EA\u52A8",
-    review: "\u5BA1\u6838",
-    writesGated: "   \u5199\u5165\u53D7\u9650 \xB7 /plan off \u89E3\u9664",
+    review: "\u5BA1\u67E5",
+    writesGated: "   \u5DF2\u9650\u5236\u5199\u5165 \xB7 /plan off \u89E3\u9664",
     editsShellAuto: "\u7F16\u8F91 + Shell \u81EA\u52A8 \xB7 /undo \u53EF\u56DE\u6EDA",
-    editsLandNow: "\u7F16\u8F91\u7ACB\u5373\u751F\u6548 \xB7 \u6309 u \u64A4\u6D88",
+    editsLandNow: "\u7F16\u8F91\u5DF2\u751F\u6548 \xB7 \u6309 u \u64A4\u6D88",
     queuedApplyDiscard: "{count} \u4E2A\u5F85\u5904\u7406 \xB7 y \u5E94\u7528 \xB7 n \u4E22\u5F03",
     editsQueued: "\u7F16\u8F91\u5DF2\u6392\u961F \xB7 y \u5E94\u7528 \xB7 n \u4E22\u5F03",
     shiftTabFlip: "   {mid} \xB7 Shift+Tab \u5207\u6362",
@@ -2703,12 +2925,157 @@ var zhCN = {
     waitingForResponse: "\u2026\u7B49\u5F85\u54CD\u5E94\u2026",
     hintSend: "\u53D1\u9001",
     hintNewline: "\u6362\u884C",
+    hintClear: "\u6E05\u7A7A",
     hintScroll: "\u6EDA\u52A8",
     hintHistory: "\u5386\u53F2",
     hintAbort: "\u4E2D\u6B62",
     hintQuit: "\u9000\u51FA",
     abortedHint: "\u7528\u6237\u5DF2\u4E2D\u6B62\u672C\u8F6E \xB7 \u518D\u6309 Esc \u6E05\u9664 \xB7 \u23CE \u7EE7\u7EED\u63D0\u95EE"
   },
+  shellConfirm: {
+    title: "Shell \u547D\u4EE4",
+    bgTitle: "\u540E\u53F0\u8FDB\u7A0B",
+    subtitle: "\u6A21\u578B\u8BF7\u6C42\u6267\u884C Shell \u547D\u4EE4",
+    bgSubtitle: "\u957F\u65F6\u95F4\u8FD0\u884C \u2014 \u6279\u51C6\u540E\u6301\u7EED\u8FD0\u884C\uFF0C/kill \u53EF\u505C\u6B62",
+    denyTitle: "\u62D2\u7EDD \u2014 \u63D0\u4F9B\u539F\u56E0",
+    optional: "\u53EF\u9009",
+    denyFooter: "\u8F93\u5165\u539F\u56E0 \xB7 \u23CE \u63D0\u4EA4 \xB7 Esc \u8DF3\u8FC7\uFF08\u76F4\u63A5\u62D2\u7EDD\uFF09",
+    awaiting: "\u7B49\u5F85\u4E2D",
+    pickFooter: "\u2191\u2193 \u9009\u62E9 \xB7 \u23CE \u786E\u8BA4 \xB7 Tab \u6DFB\u52A0\u8BF4\u660E \xB7 Esc \u53D6\u6D88",
+    allowOnce: "\u5141\u8BB8\u4E00\u6B21",
+    allowOnceDesc: "\u6267\u884C\u6B64\u547D\u4EE4\uFF0C\u4E0B\u6B21\u518D\u95EE",
+    allowAlways: "\u59CB\u7EC8\u5141\u8BB8",
+    allowAlwaysDesc: "\u8BB0\u4F4F `{prefix}`\uFF0C\u672C\u9879\u76EE\u5185\u4E0D\u518D\u8BE2\u95EE",
+    deny: "\u62D2\u7EDD",
+    denyDesc: "\u6309 Tab \u6DFB\u52A0\u8BF4\u660E\uFF0C\u544A\u8BC9\u6A21\u578B\u539F\u56E0"
+  },
+  editConfirm: {
+    footer: "[y/Enter] \u5E94\u7528 \xB7 [n] \u62D2\u7EDD\u5E76\u8BF4\u660E \xB7 [a] \u5E94\u7528\u5269\u4F59 \xB7 [A] \u5207\u6362 AUTO \xB7 [\u2191\u2193/Space] \u6EDA\u52A8 \xB7 [Esc] \u4E2D\u6B62",
+    newTag: "\u65B0\u589E",
+    editTag: "\u7F16\u8F91",
+    linesCount: "-{removed} +{added} \u884C",
+    viewingRange: "\u6B63\u5728\u67E5\u770B {start}-{end}/{total}",
+    denyFooter: "\u23CE \u63D0\u4EA4 \xB7 Esc \u8DF3\u8FC7\uFF08\u76F4\u63A5\u62D2\u7EDD\uFF09",
+    oldLabel: "  \u65E7\u5185\u5BB9",
+    newLabel: "  \u65B0\u5185\u5BB9",
+    sideBySide: "  \u5DE6\u53F3\u5BF9\u6BD4 \xB7 \u5DE6\u4FA7\u5220\u9664\uFF0C\u53F3\u4FA7\u65B0\u589E \xB7 \u6309\u504F\u79FB\u914D\u5BF9",
+    linesAbove: "  \u2191 \u4E0A\u65B9 {count} \u884C\uFF08\u2191/k \u6216 PgUp\uFF09",
+    linesAbovePlural: "  \u2191 \u4E0A\u65B9 {count} \u884C\uFF08\u2191/k \u6216 PgUp\uFF09",
+    linesBelow: "  \u2193 \u4E0B\u65B9 {count} \u884C\uFF08\u2193/j \u6216 Space/PgDn\uFF09",
+    linesBelowPlural: "  \u2193 \u4E0B\u65B9 {count} \u884C\uFF08\u2193/j \u6216 Space/PgDn\uFF09"
+  },
+  sessionPicker: {
+    header: " \u25C8 REASONIX \xB7 \u9009\u62E9\u4F1A\u8BDD ",
+    title: "\u9009\u62E9\u4F1A\u8BDD \u2014 {workspace}",
+    messages: "{count} \u6761\u6D88\u606F",
+    messagesPlural: "{count} \u6761\u6D88\u606F",
+    turns: "{count} \u8F6E",
+    pickerHint: "\u2191\u2193 \u9009\u62E9 \xB7 \u23CE \u6253\u5F00 \xB7 [n] \u65B0\u5EFA \xB7 [d] \u5220\u9664 \xB7 [r] \u91CD\u547D\u540D \xB7 Esc \u9000\u51FA",
+    empty: "  \u6B64\u5DE5\u4F5C\u533A\u6682\u65E0\u5DF2\u4FDD\u5B58\u7684\u4F1A\u8BDD \u2014 \u6309 ",
+    emptyNew: " \u5F00\u59CB\u65B0\u4F1A\u8BDD",
+    renamePrompt: '  \u91CD\u547D\u540D "{from}" \u2192 ',
+    renameHint: "  \u23CE \u786E\u8BA4\u91CD\u547D\u540D \xB7 Esc \u53D6\u6D88",
+    emptyHint: "  \u23CE \u65B0\u5EFA\u4F1A\u8BDD \xB7 Esc \u9000\u51FA",
+    justNow: "\u521A\u521A",
+    minAgo: "{count} \u5206\u949F\u524D",
+    yesterday: "\u6628\u5929",
+    hoursAgo: "{count} \u5C0F\u65F6\u524D",
+    daysAgo: "{count} \u5929\u524D"
+  },
+  modelPicker: {
+    header: " \u25C8 REASONIX \xB7 \u9009\u62E9\u914D\u7F6E ",
+    loading: "  \xB7  \u52A0\u8F7D\u76EE\u5F55\u2026",
+    catalogEmpty: "  \xB7  \u76EE\u5F55\u4E3A\u7A7A \u2014 \u4F7F\u7528\u5DF2\u77E5\u5907\u9009",
+    modelsAvailable: "  \xB7  {count} \u4E2A\u6A21\u578B\u53EF\u7528",
+    presetsHeader: "    \u9884\u8BBE  \xB7  \u63A8\u8350 \u2014 \u6A21\u578B + \u5F3A\u5EA6 + \u81EA\u52A8\u5347\u7EA7",
+    modelsHeader: "    \u6A21\u578B  \xB7  \u76F4\u63A5\u9009\u62E9 \u2014 \u81EA\u52A8\u5347\u7EA7\u4FDD\u6301\u4E0D\u53D8",
+    pickerFooter: "  \u2191\u2193 \u9009\u62E9 \xB7 \u23CE \u786E\u8BA4 \xB7 [r] \u5237\u65B0 \xB7 Esc \u53D6\u6D88",
+    currentLabel: "  \xB7 \u5F53\u524D"
+  },
+  slashSuggestions: {
+    noMatch: "\u6CA1\u6709\u5339\u914D\u6B64\u524D\u7F00\u7684\u659C\u6760\u547D\u4EE4",
+    backspaceHint: " \u2014 \u6309 Backspace \u4FEE\u6539\uFF0C\u6216 /help \u67E5\u770B\u5B8C\u6574\u5217\u8868",
+    commandCount: "{count} \u4E2A\u547D\u4EE4",
+    commandCountPlural: "{count} \u4E2A\u547D\u4EE4",
+    aboveLabel: "   \u2191 {count} \u4E2A\u4EE5\u4E0A",
+    belowLabel: "   \u2193 {count} \u4E2A\u4EE5\u4E0B",
+    advancedHint: "  + {count} \u4E2A\u9AD8\u7EA7\u547D\u4EE4 \xB7  \u8F93\u5165\u5B57\u6BCD\u641C\u7D22",
+    footerHint: "  \u2191\u2193 \u5BFC\u822A \xB7 Tab / \u23CE \u9009\u62E9 \xB7 Esc \u53D6\u6D88",
+    groupChat: "\u804A\u5929",
+    groupSetup: "\u8BBE\u7F6E",
+    groupInfo: "\u4FE1\u606F",
+    groupSession: "\u4F1A\u8BDD",
+    groupExtend: "\u6269\u5C55",
+    groupCode: "\u4EE3\u7801",
+    groupJobs: "\u4EFB\u52A1",
+    groupAdvanced: "\u9AD8\u7EA7"
+  },
+  atMentions: {
+    loading: "\u52A0\u8F7D\u4E2D\u2026",
+    entrySingular: "{count} \u6761",
+    entryPlural: "{count} \u6761",
+    searching: "\u641C\u7D22\u4E2D\u2026",
+    scanned: "\u5DF2\u626B\u63CF",
+    match: "\u4E2A\u5339\u914D",
+    matches: "\u4E2A\u5339\u914D",
+    forFilter: '\u5339\u914D "{filter}"',
+    noMatch: '\u6CA1\u6709\u5339\u914D "{filter}" \u7684\u6587\u4EF6',
+    emptyDir: "\u7A7A\u76EE\u5F55",
+    scanning: "\u6B63\u5728\u626B\u63CF\u76EE\u5F55\u6811\u2026",
+    footerBrowse: "\u2191\u2193 \u5BFC\u822A \xB7 Tab \u8FDB\u5165\u6587\u4EF6\u5939 \xB7 \u23CE \u63D2\u5165 \xB7 Esc \u53D6\u6D88",
+    footerBrowseSearch: "\u2191\u2193 \u5BFC\u822A \xB7 Tab / \u23CE \u4EE5 @path \u63D2\u5165 \xB7 Esc \u53D6\u6D88",
+    footerInsert: "\u2191\u2193 \u5BFC\u822A \xB7 Tab / \u23CE \u4EE5 @path \u63D2\u5165 \xB7 Esc \u53D6\u6D88"
+  },
+  statsPanel: {
+    modePlan: "\u8BA1\u5212",
+    modeYolo: "\u81EA\u7531",
+    modeAuto: "\u81EA\u52A8",
+    modeReview: "\u5BA1\u67E5",
+    pro: "\u21E7 \u4E13\u4E1A",
+    budget: "  \u9884\u7B97  "
+  },
+  welcomeBanner: {
+    workspace: "\u25B8 \u5DE5\u4F5C\u533A",
+    relaunchHint: "\uFF08\u91CD\u542F\u65F6\u7528 --dir <path> \u5207\u6362\uFF09",
+    dashboard: "\u25B8 \u7F51\u9875"
+  },
+  ctxBreakdown: {
+    title: "\u25A3 \u4E0A\u4E0B\u6587",
+    compactHint: "  /compact \u6298\u53E0\uFF08\u8D85\u8FC7 50% \u81EA\u52A8\u89E6\u53D1\uFF09\xB7 /new \u6E05\u7A7A\u65E5\u5FD7",
+    topTools: "  \u5E38\u7528\u5DE5\u5177\uFF08\u6309\u6210\u672C\u6392\u5E8F\uFF0C{count} \u4E2A\uFF09\uFF1A",
+    msg: "\u6761",
+    turnLabel: "\u8F6E"
+  },
+  startup: {
+    codeRooted: '\u25B8 reasonix code\uFF1A\u6839\u76EE\u5F55 {rootDir}\uFF0C\u4F1A\u8BDD "{session}" \xB7 {tools} \u4E2A\u539F\u751F\u5DE5\u5177{semantic}',
+    ephemeral: "\uFF08\u4E34\u65F6\uFF09",
+    semanticOn: " \xB7 \u8BED\u4E49\u641C\u7D22\u5DF2\u5F00\u542F"
+  },
+  doctorErrors: {
+    unreadable: "{path} \u65E0\u6CD5\u8BFB\u53D6 \u2014 {message}",
+    cannotList: "\u65E0\u6CD5\u5217\u51FA \u2014 {message}",
+    parseFailed: "\u65E0\u6CD5\u89E3\u6790 settings.json \u2014 {message}",
+    probeFailed: "\u63A2\u6D4B\u5931\u8D25 \u2014 {message}"
+  },
+  webErrors: {
+    status: "web_search \u72B6\u6001\u7801 {status}",
+    mojeekBlocked: "web_search: Mojeek \u53CD\u722C\u9875\u9762 \u2014 \u9891\u7387\u9650\u5236\u6216\u88AB\u5C4F\u853D",
+    mojeekNoResults: "web_search: \u8FD4\u56DE 0 \u6761\u7ED3\u679C\u4F46\u54CD\u5E94\u770B\u8D77\u6765\u4E0D\u662F\u6B63\u5E38\u7A7A\u7ED3\u679C\u9875\uFF08{chars} \u5B57\u7B26\uFF0C\u524D 120 \u5B57\u7B26\uFF1A{preview}\uFF09",
+    invalidEndpoint: 'web_search: \u65E0\u6548\u7684 SearXNG \u7AEF\u70B9 "{endpoint}"',
+    endpointMustBeHttp: "web_search: SearXNG \u7AEF\u70B9\u5FC5\u987B\u662F http(s) \u534F\u8BAE\uFF0C\u5F53\u524D\u4E3A {protocol}",
+    cannotReach: "web_search: \u65E0\u6CD5\u8BBF\u95EE SearXNG \u670D\u52A1\u5668 {endpoint}\u3002\u8BF7\u5B89\u88C5 SearXNG\uFF08https://github.com/searxng/searxng\uFF09\u5E76\u542F\u52A8\uFF08\u4F8B\u5982 `docker run -d -p 8080:8080 searxng/searxng`\uFF09\uFF0C\u6216\u4F7F\u7528 /search-engine mojeek \u5207\u6362\u5230\u9ED8\u8BA4\u5F15\u64CE\u3002",
+    searxngNoResults: "web_search: \u8FD4\u56DE 0 \u6761\u7ED3\u679C\u4F46 SearXNG \u54CD\u5E94\u770B\u8D77\u6765\u4E0D\u662F\u6B63\u5E38\u7A7A\u7ED3\u679C\u9875\uFF08{chars} \u5B57\u7B26\uFF09",
+    fetchStatus: "web_fetch \u72B6\u6001\u7801 {status}\uFF08{url}\uFF09",
+    fetchTooLarge: "web_fetch \u62D2\u7EDD\uFF1Acontent-length {len} \u5B57\u8282\u8D85\u8FC7\u4E0A\u9650 {cap} \u5B57\u8282\uFF08{url}\uFF09",
+    fetchBodyTooLarge: "web_fetch \u62D2\u7EDD\uFF1A\u54CD\u5E94\u4F53\u8D85\u8FC7 {cap} \u5B57\u8282\u4E0A\u9650\uFF08\u5DF2\u63A5\u6536 {seen} \u5B57\u8282\uFF09",
+    fetchInvalidUrl: "web_fetch: URL \u5FC5\u987B\u4EE5 http:// \u6216 https:// \u5F00\u5934"
+  },
+  choiceConfirm: {
+    customLabel: "\u81EA\u5B9A\u4E49\u56DE\u7B54",
+    customDesc: "\u4EE5\u4E0A\u9009\u9879\u90FD\u4E0D\u5408\u9002 \u2014 \u8F93\u5165\u81EA\u7531\u683C\u5F0F\u56DE\u590D\uFF0C\u6A21\u578B\u4F1A\u539F\u6837\u8BFB\u53D6",
+    cancelLabel: "\u53D6\u6D88 \u2014 \u653E\u5F03\u95EE\u9898",
+    cancelDesc: "\u6A21\u578B\u505C\u6B62\u5E76\u8BE2\u95EE\u4F60\u771F\u6B63\u7684\u9700\u6C42"
+  },
   cardTitles: {
     usage: "\u7528\u91CF",
     context: "\u4E0A\u4E0B\u6587",
@@ -2718,7 +3085,9 @@ var zhCN = {
     reasoning: "\u63A8\u7406\u4E2D",
     reasoningAborted: "\u63A8\u7406\uFF08\u5DF2\u4E2D\u6B62\uFF09",
     reasoningEllipsis: "\u63A8\u7406\u4E2D\u2026",
-    error: "\u9519\u8BEF"
+    error: "\u9519\u8BEF",
+    doctor: "\u73AF\u5883\u8BCA\u65AD",
+    you: "\u4F60"
   },
   cardLabels: {
     prompt: "\u63D0\u793A",
@@ -2732,7 +3101,7 @@ var zhCN = {
     tools: "\u5DE5\u5177",
     log: "\u65E5\u5FD7",
     input: "\u8F93\u5165",
-    topTools: "Top \u5DE5\u5177",
+    topTools: "\u5E38\u7528\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",
@@ -2757,7 +3126,42 @@ var zhCN = {
     retries: "\u6B21\u91CD\u8BD5",
     reasoningLabel: "\u63A8\u7406 \xB7 {count} \xB6",
     runningLabel: "\u8FD0\u884C\u4E2D",
-    workingLabel: "\u5DE5\u4F5C\u4E2D"
+    workingLabel: "\u5904\u7406\u4E2D",
+    defaultFooter: "\u2191\u2193 \u9009\u62E9 \xB7 \u23CE \u786E\u8BA4 \xB7 Esc \u53D6\u6D88",
+    applyAction: "[a] \u5E94\u7528",
+    skipAction: "[s] \u8DF3\u8FC7",
+    rejectAction: "[r] \u62D2\u7EDD",
+    levelOk: "\u6B63\u5E38",
+    levelWarn: "\u8B66\u544A",
+    levelFail: "\u5931\u8D25",
+    checksLabel: "\u68C0\u67E5\u9879",
+    passed: "\u901A\u8FC7",
+    warnTag: "\u8B66\u544A",
+    failTag: "\u5931\u8D25",
+    stepLabel: "\u6B65\u9AA4",
+    done: "\u5DF2\u5B8C\u6210",
+    inProgress: "\u2190 \u8FDB\u884C\u4E2D",
+    upcoming: "\u5F85\u5904\u7406",
+    resumed: "\u5DF2\u6062\u590D \xB7 ",
+    archive: "\u23EA \u5F52\u6863 \xB7 ",
+    more: "\u22EE +{count} \u66F4\u591A",
+    categoryUser: "\u7528\u6237",
+    categoryFeedback: "\u53CD\u9988",
+    categoryProject: "\u9879\u76EE",
+    categoryReference: "\u53C2\u8003"
+  },
+  copyMode: {
+    title: "\u2500\u2500 \u590D\u5236\u6A21\u5F0F \u2500\u2500",
+    help: "j/k \u6216 \u2191/\u2193 \u79FB\u52A8 \xB7 v \u8D77\u9009\u533A \xB7 y \u590D\u5236 \xB7 g/G \u9876/\u5E95 \xB7 q \u9000\u51FA",
+    statusBar: "\u7B2C {cur}/{total} \u884C \xB7 \u9009\u533A\uFF1A{sel}",
+    statusYanked: "\u5DF2\u590D\u5236 {size} \u5B57\u7B26\uFF08osc52={osc52}\uFF09",
+    statusEmpty: "\u672A\u9009\u4E2D\u5185\u5BB9",
+    empty: "\uFF08\u8FD8\u6CA1\u6709\u804A\u5929\u5185\u5BB9 \u2014 \u5148\u548C\u6A21\u578B\u8BF4\u70B9\u4EC0\u4E48\uFF09",
+    labelUser: "\u4F60",
+    labelAssistant: "\u52A9\u624B",
+    labelReasoning: "\u63A8\u7406",
+    yankedToast: "\u25B8 \u5DF2\u590D\u5236 {size} \u5B57\u7B26\u5230\u526A\u8D34\u677F (osc52)",
+    yankedToastFile: "\u25B8 \u5DF2\u590D\u5236 {size} \u5B57\u7B26 \xB7 \u6587\u4EF6\uFF1A{path}"
   }
 };
 
@@ -3277,6 +3681,10 @@ var ToolRegistry = class {
   setResultAugmenter(fn) {
     this._resultAugmenter = fn;
   }
+  /** True when an augmenter is already wired — lets late-installing callers skip clobbering an earlier one. */
+  get hasResultAugmenter() {
+    return this._resultAugmenter !== null;
+  }
   register(def) {
     if (!def.name) throw new Error("tool requires a name");
     const internal = { ...def };
@@ -4799,6 +5207,7 @@ function signature(call) {
 
 // src/loop.ts
 var ESCALATION_MODEL = "deepseek-v4-pro";
+var PARENT_BUDGET_WARN_THRESHOLD = 5;
 var CacheFirstLoop = class {
   client;
   prefix;
@@ -4835,6 +5244,7 @@ var CacheFirstLoop = class {
   _turnFailures = new TurnFailureTracker();
   _turnSelfCorrected = false;
   _foldedThisTurn = false;
+  _toolDispatchesThisStep = 0;
   context;
   /** Subscribe API so UI hooks can derive `running` from finally-guaranteed insertions. */
   get inflight() {
@@ -4889,6 +5299,23 @@ var CacheFirstLoop = class {
       stormThreshold: parsePositiveIntEnv(process.env.REASONIX_STORM_THRESHOLD),
       stormWindow: parsePositiveIntEnv(process.env.REASONIX_STORM_WINDOW)
     });
+    if (!this.tools.hasResultAugmenter) {
+      this.tools.setResultAugmenter((_name, _args, result) => {
+        this._toolDispatchesThisStep++;
+        const remaining = this.maxToolIters - this._toolDispatchesThisStep;
+        if (remaining <= 0) {
+          return `${result}
+
+[budget: 0 of ${this.maxToolIters} tool calls left this turn \u2014 finalize NOW; the next iter forces a summary]`;
+        }
+        if (remaining <= PARENT_BUDGET_WARN_THRESHOLD) {
+          return `${result}
+
+[budget: ${remaining} of ${this.maxToolIters} tool calls left this turn \u2014 wrap up soon]`;
+        }
+        return result;
+      });
+    }
     this.sessionName = opts.session ?? null;
     if (this.sessionName) {
       const prior = loadSessionMessages(this.sessionName);
@@ -5142,6 +5569,7 @@ ${reason}`
     this._turnSelfCorrected = false;
     this._escalateThisTurn = false;
     this._foldedThisTurn = false;
+    this._toolDispatchesThisStep = 0;
     let armedConsumed = false;
     if (this._proArmedForNextTurn) {
       this._escalateThisTurn = true;
@@ -7823,6 +8251,74 @@ Prefer \`list_directory\` for a single-level view, \`search_files\` to find spec
       return `moved ${displayRel4(rootDir, src)} \u2192 ${displayRel4(rootDir, dst)}`;
     }
   });
+  registry.register({
+    name: "delete_file",
+    description: "Delete one file under the sandbox root. Refuses directories \u2014 use delete_directory for those. Errors if the path doesn't exist.",
+    parameters: {
+      type: "object",
+      properties: { path: { type: "string" } },
+      required: ["path"]
+    },
+    fn: async (args) => {
+      const abs = safePath(args.path);
+      const st = await fs4.lstat(abs);
+      if (st.isDirectory()) {
+        throw new Error(
+          `delete_file: ${args.path} is a directory \u2014 use delete_directory to remove it`
+        );
+      }
+      await fs4.unlink(abs);
+      return `deleted ${displayRel4(rootDir, abs)}`;
+    }
+  });
+  registry.register({
+    name: "delete_directory",
+    description: "Recursively delete a directory under the sandbox root. Pass `recursive:false` to refuse non-empty directories. Errors if the path doesn't exist.",
+    parameters: {
+      type: "object",
+      properties: {
+        path: { type: "string" },
+        recursive: {
+          type: "boolean",
+          description: "When true (default) deletes the directory and all its contents. When false, only removes empty directories \u2014 non-empty refuses with an error."
+        }
+      },
+      required: ["path"]
+    },
+    fn: async (args) => {
+      const abs = safePath(args.path);
+      const st = await fs4.lstat(abs);
+      if (!st.isDirectory()) {
+        throw new Error(`delete_directory: ${args.path} is a file \u2014 use delete_file to remove it`);
+      }
+      const recursive = args.recursive !== false;
+      if (recursive) {
+        await fs4.rm(abs, { recursive: true, force: false });
+      } else {
+        await fs4.rmdir(abs);
+      }
+      return `deleted ${displayRel4(rootDir, abs)}/${recursive ? " (recursive)" : ""}`;
+    }
+  });
+  registry.register({
+    name: "copy_file",
+    description: "Copy a file or directory under the sandbox root. Both source and destination resolve under the sandbox. Parent directories of the destination are created as needed. Refuses to overwrite an existing destination \u2014 delete it first if you want to replace it.",
+    parameters: {
+      type: "object",
+      properties: {
+        source: { type: "string" },
+        destination: { type: "string" }
+      },
+      required: ["source", "destination"]
+    },
+    fn: async (args) => {
+      const src = safePath(args.source);
+      const dst = safePath(args.destination);
+      await fs4.mkdir(pathMod4.dirname(dst), { recursive: true });
+      await fs4.cp(src, dst, { recursive: true, force: false, errorOnExist: true });
+      return `copied ${displayRel4(rootDir, src)} \u2192 ${displayRel4(rootDir, dst)}`;
+    }
+  });
   return registry;
 }
 
@@ -8479,6 +8975,18 @@ var DEFAULT_SUBAGENT_MODEL = "deepseek-v4-flash";
 var DEFAULT_SUBAGENT_EFFORT = "high";
 var SUBAGENT_TOOL_NAME = "spawn_subagent";
 var NEVER_INHERITED_TOOLS = /* @__PURE__ */ new Set([SUBAGENT_TOOL_NAME, "submit_plan"]);
+var SOFT_HINT_AFTER_SPAWNS = 1;
+var STRONG_HINT_AFTER_SPAWNS = 4;
+var STRONG_HINT_TOKEN_THRESHOLD = 5e4;
+function subagentBudgetHint(spawnCount, totalTokens) {
+  if (spawnCount > STRONG_HINT_AFTER_SPAWNS || totalTokens >= STRONG_HINT_TOKEN_THRESHOLD) {
+    return `[budget: this session has now spawned ${spawnCount} subagents totalling ${totalTokens} tokens. Each spawn pays a fresh prefix-cache miss plus a full child loop \u2014 confirm the next spawn is genuinely needed (parallel fan-out or >10-read context blow-up) before calling spawn_subagent again. If you can answer with direct tools, do that instead.]`;
+  }
+  if (spawnCount > SOFT_HINT_AFTER_SPAWNS) {
+    return `[note: this session has spawned ${spawnCount} subagents totalling ${totalTokens} tokens; confirm this one is worth it.]`;
+  }
+  return null;
+}
 async function spawnSubagent(opts) {
   const model = opts.model ?? DEFAULT_SUBAGENT_MODEL;
   const maxToolIters = opts.maxToolIters ?? DEFAULT_MAX_ITERS;
@@ -8700,10 +9208,12 @@ function registerSubagentTool(parentRegistry, opts) {
   const maxToolIters = opts.maxToolIters ?? DEFAULT_MAX_ITERS;
   const maxResultChars = opts.maxResultChars ?? DEFAULT_MAX_RESULT_CHARS2;
   const sink = opts.sink;
+  let sessionSpawnCount = 0;
+  let sessionSpawnTokens = 0;
   parentRegistry.register({
     name: SUBAGENT_TOOL_NAME,
     parallelSafe: true,
-    description: "Spawn an isolated subagent to handle a self-contained subtask in a fresh context, returning only its final answer. Use for: deep codebase exploration that would flood the main context, multi-step research where you only need the conclusion, or any focused subtask whose intermediate reasoning the user does not need to see. The subagent inherits all your tools (filesystem, shell, web, MCP, etc.) but runs in its own isolated message log \u2014 its tool calls and reasoning never enter your context. Only the final assistant message comes back as this tool's result. Keep tasks focused; the subagent has a stricter iter budget than you do.",
+    description: "Spawn an isolated subagent to handle a self-contained subtask in a fresh context, returning only its final answer. **Prefer direct tools.** Spawn primarily for parallel fan-out (2+ independent investigations issued in one tool batch) or when the work would otherwise need >10 file reads/searches whose trail you don't need to keep. Single greps, 1-3 file cross-references, and 'keep my context clean for one question' are NOT good reasons to spawn \u2014 direct tools are cheaper and let you reference the evidence later. Each spawn pays a fresh prefix-cache miss plus a full child loop. The subagent inherits your tools but runs in its own isolated message log; only the final assistant message comes back. Keep tasks focused; the subagent has a stricter iter budget than you do.",
     parameters: {
       type: "object",
       properties: {
@@ -8758,7 +9268,12 @@ ${escalationContract(model)}`;
         sink,
         parentSignal: ctx?.signal
       });
-      return formatSubagentResult(result);
+      sessionSpawnCount++;
+      sessionSpawnTokens += result.usage.totalTokens;
+      const formatted = formatSubagentResult(result);
+      const hint = subagentBudgetHint(sessionSpawnCount, sessionSpawnTokens);
+      return hint ? `${formatted}
+${hint}` : formatted;
     }
   });
   return parentRegistry;
@@ -10074,7 +10589,7 @@ function registerShellTools(registry, opts) {
   const isAllowAll = typeof opts.allowAll === "function" ? opts.allowAll : () => opts.allowAll === true;
   registry.register({
     name: "run_command",
-    description: "Run a shell command in the project root and return its combined stdout+stderr.\n\nConstraints (read these before the first call):\n\u2022 Chain operators `|`, `||`, `&&`, `;` ARE supported \u2014 parsed natively, no shell invoked, so semantics are identical on Windows / macOS / Linux. Each chain segment is allowlist-checked individually: `git status | grep main` runs if both halves are allowed.\n\u2022 File redirects ARE supported: `>` truncate, `>>` append, `<` stdin from file, `2>` / `2>>` stderr to file, `2>&1` merge stderr\u2192stdout, `&>` both to file. Targets resolve relative to the project root. At most one redirect per fd per segment.\n\u2022 Background `&`, heredoc `<<`, command substitution `$(\u2026)`, subshells `(\u2026)`, and process substitution `<(\u2026)` are NOT supported. Wrap a literal `&` arg in quotes; for input use a `<` file or the binary's own --input flag.\n\u2022 Env-var expansion `$VAR` is NOT performed \u2014 `$VAR` is passed as a literal string. Use the binary's own --env flag or substitute the value yourself.\n\u2022 `cd` DOES NOT PERSIST between calls \u2014 each call spawns a fresh process rooted at the project. `cd` also does not persist within parsed chains like `cd dir && command`. Use a command-native cwd flag instead: `npm --prefix <dir> run <script>`, `npm --prefix <dir> exec -- <bin>`, `git -C <dir> ...`, `cargo -C <dir> ...`, `pytest <dir>/tests`.\n\u2022 Glob patterns (`*.ts`) are passed through as literal arguments \u2014 no shell expansion. Use `grep -r`, `rg`, `find -name`, etc.\n\u2022 Avoid commands with unbounded output (`netstat -ano`, `find /`, etc.) \u2014 they waste tokens. Filter at source: `netstat -ano -p TCP`, `find src -name '*.ts'`, `grep -c`, `wc -l`.\n\nCommon read-only inspection and test/lint/typecheck commands run immediately; anything that could mutate state, install dependencies, or touch the network is refused until the user confirms it in the TUI. Prefer this over asking the user to run a command manually \u2014 after edits, run the project's tests to verify.",
+    description: "Run a shell command in the project root; returns combined stdout+stderr. Allowlisted read-only / test / lint / typecheck commands run immediately; anything that could mutate state, install deps, or touch the network is gated by user confirmation. Prefer this over asking the user to run a command manually \u2014 after edits, run the project's tests to verify.\n\nConstraints (no real shell \u2014 argv is parsed natively for cross-platform parity):\n\u2022 Supported: chain ops `|` / `||` / `&&` / `;` (each segment allowlist-checked individually), file redirects `>` / `>>` / `<` / `2>` / `2>>` / `2>&1` / `&>` (target paths resolve relative to project root, max one redirect per fd per segment).\n\u2022 NOT supported: background `&`, heredoc `<<`, command substitution `$(\u2026)`, subshells `(\u2026)`, process substitution `<(\u2026)`, `$VAR` env expansion, glob expansion. To pass an operator char as literal arg, quote it (`grep \"a|b\" file`).\n\u2022 `cd` does NOT persist \u2014 between calls OR within a chain like `cd dir && cmd`. Use the binary's own cwd flag: `npm --prefix <dir>`, `git -C <dir>`, `cargo -C <dir>`, `pytest <dir>/tests`.\n\u2022 Filter at source \u2014 unbounded output (`netstat -ano`, `find /`) wastes tokens. Use `grep -c`, `wc -l`, narrower paths, etc.",
     // Plan-mode gate: allow allowlisted commands through (git status,
     // cargo check, ls, grep …) so the model can actually investigate
     // during planning. Anything that would otherwise trigger a
@@ -10126,7 +10641,7 @@ function registerShellTools(registry, opts) {
   });
   registry.register({
     name: "run_background",
-    description: "Spawn a long-running process (dev server, watcher, any command that doesn't naturally exit) and detach. Waits up to `waitSec` seconds for startup (or until the output matches a readiness signal like 'Local:', 'listening on', 'compiled successfully'), then returns the job id + startup preview. The process keeps running; call `job_output` to tail its logs, `stop_job` to kill it, `list_jobs` to see all running jobs.\n\nSame shell constraints as run_command: NO `&&` / `||` / `|` / `;` / `>` / `<` / `2>&1`, `cd` doesn't persist. Dev servers that need a subdirectory: use the tool's own --prefix / --cwd flag. For Vite specifically, `--prefix` on npm only tells npm where package.json is; vite's server root still defaults to process cwd, so pass `vite <project-dir>` or configure via `vite.config.ts` root.\n\nUSE THIS \u2014 not `run_command` \u2014 for: npm/yarn/pnpm run dev, uvicorn / flask run, go run, cargo watch, tsc --watch, webpack serve, anything with 'dev' / 'serve' / 'watch' in the name.",
+    description: "Spawn a long-running process (dev server, watcher) and detach. Waits up to `waitSec` for startup or a readiness signal ('Local:', 'listening on', 'compiled successfully'), then returns the job id + startup preview. Tail logs with `job_output`, kill with `stop_job`, list with `list_jobs`.\n\nSingle process only \u2014 chains / redirects / `cd` work as in run_command, but a typical dev-server invocation is one binary. Use the binary's own --cwd / --prefix flag for subdirectories. Vite gotcha: npm's `--prefix` only finds package.json; vite's server root still uses process cwd \u2014 pass `vite <project-dir>` instead.\n\nUSE THIS \u2014 not run_command \u2014 for: npm/yarn/pnpm dev, uvicorn / flask run, cargo watch, tsc --watch, webpack serve, anything with dev/serve/watch in the name.",
     parameters: {
       type: "object",
       properties: {
@@ -10198,6 +10713,8 @@ function registerShellTools(registry, opts) {
     name: "wait_for_job",
     description: "Block until a background job exits or produces new output, bounded by `timeoutMs`. Use this instead of polling `job_output` with identical args when you're intentionally waiting for state to change. Returns JSON with `exited`, `exitCode`, and `latestOutput`.",
     readOnly: true,
+    parallelSafe: true,
+    stormExempt: true,
     parameters: {
       type: "object",
       properties: {
@@ -10316,16 +10833,19 @@ async function searchMojeek(query, opts = {}) {
     signal: opts.signal,
     redirect: "follow"
   });
-  if (!resp.ok) throw new Error(`web_search ${resp.status}`);
+  if (!resp.ok) throw new Error(t("webErrors.status", { status: resp.status }));
   const html = await resp.text();
   const results = parseMojeekResults(html).slice(0, topK);
   if (results.length === 0) {
     if (/no results found|did not match any documents/i.test(html)) return [];
     if (/captcha|verify you are human|access denied|forbidden/i.test(html)) {
-      throw new Error("web_search: Mojeek anti-bot page \u2014 rate-limited or blocked");
+      throw new Error(t("webErrors.mojeekBlocked"));
     }
     throw new Error(
-      `web_search: 0 results but response doesn't look like a real empty page (${html.length} chars, first 120: ${html.slice(0, 120).replace(/\s+/g, " ")})`
+      t("webErrors.mojeekNoResults", {
+        chars: html.length,
+        preview: html.slice(0, 120).replace(/\s+/g, " ")
+      })
     );
   }
   return results;
@@ -10335,10 +10855,10 @@ function normalizeSearxngEndpoint(raw) {
   try {
     url = new URL(raw.includes("://") ? raw : `http://${raw}`);
   } catch {
-    throw new Error(`web_search: invalid SearXNG endpoint "${raw}"`);
+    throw new Error(t("webErrors.invalidEndpoint", { endpoint: raw }));
   }
   if (url.protocol !== "http:" && url.protocol !== "https:") {
-    throw new Error(`web_search: SearXNG endpoint must be http(s), got ${url.protocol}`);
+    throw new Error(t("webErrors.endpointMustBeHttp", { protocol: url.protocol }));
   }
   return url.origin;
 }
@@ -10358,19 +10878,17 @@ async function searchSearxng(query, opts = {}) {
   } catch (err) {
     if (err instanceof TypeError && err.message.includes("fetch")) {
       throw new Error(
-        `web_search: Cannot reach SearXNG server at ${opts.endpoint ?? "http://localhost:8080"}. Please install SearXNG (https://github.com/searxng/searxng) and start it (e.g. \`docker run -d -p 8080:8080 searxng/searxng\`), or switch to the default engine with /search-engine mojeek.`
+        t("webErrors.cannotReach", { endpoint: opts.endpoint ?? "http://localhost:8080" })
       );
     }
     throw err;
   }
-  if (!resp.ok) throw new Error(`web_search ${resp.status}`);
+  if (!resp.ok) throw new Error(t("webErrors.status", { status: resp.status }));
   const html = await resp.text();
   const results = parseSearxngHtmlResults(html).slice(0, topK);
   if (results.length === 0) {
     if (/no results found|did not match any documents/i.test(html)) return [];
-    throw new Error(
-      `web_search: 0 results but SearXNG response doesn't look like an empty results page (${html.length} chars)`
-    );
+    throw new Error(t("webErrors.searxngNoResults", { chars: html.length }));
   }
   return results;
 }
@@ -10464,13 +10982,11 @@ async function webFetch(url, opts = {}) {
     clearTimeout(timer);
     opts.signal?.removeEventListener("abort", cancel);
   }
-  if (!resp.ok) throw new Error(`web_fetch ${resp.status} for ${url}`);
+  if (!resp.ok) throw new Error(t("webErrors.fetchStatus", { status: resp.status, url }));
   const contentType = resp.headers.get("content-type") ?? "";
   const declaredLen = Number(resp.headers.get("content-length") ?? "");
   if (Number.isFinite(declaredLen) && declaredLen > FETCH_MAX_BYTES) {
-    throw new Error(
-      `web_fetch refused: content-length ${declaredLen} bytes exceeds ${FETCH_MAX_BYTES}-byte cap (${url})`
-    );
+    throw new Error(t("webErrors.fetchTooLarge", { len: declaredLen, cap: FETCH_MAX_BYTES, url }));
   }
   const raw = await readBodyCapped(resp, FETCH_MAX_BYTES);
   const title = extractTitle(raw);
@@ -10497,9 +11013,7 @@ async function readBodyCapped(resp, maxBytes) {
           await reader.cancel();
         } catch {
         }
-        throw new Error(
-          `web_fetch refused: response body exceeded ${maxBytes}-byte cap (${total} bytes seen)`
-        );
+        throw new Error(t("webErrors.fetchBodyTooLarge", { cap: maxBytes, seen: total }));
       }
       out += decoder.decode(value, { stream: true });
     }
@@ -10627,7 +11141,7 @@ function registerWebTools(registry, opts = {}) {
     },
     fn: async (args, ctx) => {
       if (!/^https?:\/\//i.test(args.url)) {
-        throw new Error("web_fetch: url must start with http:// or https://");
+        throw new Error(t("webErrors.fetchInvalidUrl"));
       }
       const page = await webFetch(args.url, { maxChars: maxFetchChars, signal: ctx?.signal });
       const header = page.title ? `${page.title}
@@ -12180,6 +12694,17 @@ If you are about to write "X is missing" or "Y is not implemented" \u2014 **STOP
 
 Asserting absence without a search is the #1 way evaluative answers go wrong. Treat the urge to write "missing" as a red flag in your own reasoning.
 
+# When auditing or reviewing this codebase
+
+When you're asked to audit / review / critique Reasonix itself ("what tools are missing?", "review the prompt system", "anything wrong with how X works?"), the failure mode isn't hallucinating absences \u2014 it's building confident, well-structured proposals on factually wrong premises. Six rails:
+
+- **Auto-preview is for locating, not auditing.** Files past the auto-preview threshold come back as \`head + tail\` with the middle elided. Don't conclude what's in the elided section \u2014 runtime behavior, current architectural state, whether a plan doc is still accurate \u2014 off the preview. Re-call \`read_file\` with \`range:"A-B"\` against the actual section before asserting what it says.
+- **Flag \u2192 consumer trace.** Reading a type field (\`parallelSafe?: boolean\`, \`stormExempt?: boolean\`) is not understanding behavior. Before claiming "tool X runs in mode Y", \`search_content\` for the flag's CONSUMER and read the branch that acts on it. **For inventory claims** ("which tools have flag F?"), grep the flag \u2014 don't enumerate from memory; the field is set per-tool and easily mis-recalled.
+- **No fabricated percentages.** "Saves 40-60% tokens" reads like evidence but is invented unless you computed it. Ground numbers in a cited transcript / token count, or use hedged language ("small but non-zero", "may compound") \u2014 never present an unmeasured number as a measured one.
+- **Schema cost is real.** Every tool's description ships in every request. A new-tool proposal MUST cover (a) which existing-tool composition fails to do this, (b) rough description-token cost, (c) why a prompt or description change can't reach the same end. Default to "tighten prompt / existing tool" before "add tool".
+- **MEMORY.md is part of the design space.** The pinned memory blocks above are loaded user feedback \u2014 recommendations contradicting them ("auto-commit checkpoints", "free-credit messaging", anything the user has explicitly ruled out) are wrong by construction. Cross-check before proposing.
+- **User-facing \u2260 model-facing \u2260 library-facing.** Reasonix has four action surfaces: slash commands (user), tools (model), UI (user), and library exports (\`src/index.ts\`). Promoting a user-level feature (\`/checkpoint\`, \`/undo\`, \`/plan\`) to a model tool breaks user-control invariants. Treating a library export as "dead code" because the CLI doesn't register it to the model misreads the design \u2014 embedders consume \`src/index.ts\` directly.
+
 # When to propose a plan (submit_plan)
 
 You have a \`submit_plan\` tool that shows the user a markdown plan and lets them Approve / Refine / Cancel before you execute. Use it proactively when the task is large enough to deserve a review gate:
@@ -12224,7 +12749,7 @@ Call shape: \`{ todos: [{ content, activeForm, status }, ...] }\` \u2014 \`conte
 # Plan mode (/plan)
 
 The user can ALSO enter "plan mode" via /plan, which is a stronger, explicit constraint:
-- Write tools (edit_file, multi_edit, write_file, create_directory, move_file) and non-allowlisted run_command calls are BOUNCED at dispatch \u2014 you'll get a tool result like "unavailable in plan mode". Don't retry them.
+- Write tools (edit_file, multi_edit, write_file, create_directory, move_file, copy_file, delete_file, delete_directory) and non-allowlisted run_command calls are BOUNCED at dispatch \u2014 you'll get a tool result like "unavailable in plan mode". Don't retry them.
 - Read tools (read_file, list_directory, search_files, directory_tree, get_file_info) and allowlisted read-only / test shell commands still work \u2014 use them to investigate.
 - You MUST call submit_plan before anything will execute. Approve exits plan mode; Refine stays in; Cancel exits without implementing.
 
@@ -12239,15 +12764,18 @@ Two built-ins ship by default:
 - **explore** \`[\u{1F9EC} subagent]\` \u2014 read-only investigation across the codebase. Use when the user says things like "find all places that...", "how does X work across the project", "survey the code for Y". Pass \`arguments\` describing the concrete question.
 - **research** \`[\u{1F9EC} subagent]\` \u2014 combines web search + code reading. Use for "is X supported by lib Y", "what's the canonical way to Z", "compare our impl to the spec".
 
-When to delegate (call \`run_skill\` with a subagent skill):
-- The task would otherwise need >5 file reads or searches.
-- You only need the conclusion, not the exploration trail.
-- The work is self-contained (you can describe it in one paragraph).
+**Default: don't delegate.** Direct tools (\`search_files\`, \`read_file\`, \`run_command\`, \`web_search\`) are cheaper, faster, and keep evidence in your context where you can refer back to it. A subagent spawn pays a fresh prefix-cache miss and a full child loop \u2014 hundreds of ms of overhead and full input pricing for the child's first turn. For most questions the spawn costs more than it saves.
+
+Spawn ONLY in these two cases:
+1. **True parallelism** \u2014 you have 2+ independent investigations that can run concurrently in the same tool batch. The wall-time win is real and only achievable via fan-out.
+2. **Context blow-up** \u2014 the work would otherwise need >10 file reads/searches and you only need the conclusion. Keeping the trail out of your context is the actual saving.
 
-When NOT to delegate:
-- Direct, narrow questions answerable in 1-2 tool calls \u2014 just do them.
-- Anything where you need to track intermediate results yourself (planning, multi-step edits).
-- Anything that requires user interaction (subagents can't submit plans or ask you for clarification).
+Anti-patterns \u2014 do NOT spawn for any of these:
+- single grep / single file read \u2192 call the tool directly
+- 1-3 file cross-reference \u2192 read them directly
+- "to keep my context clean for one question" \u2192 not enough saving to justify the spawn
+- anything that needs user interaction (subagents can't submit plans or ask for clarification)
+- anything where you need to track intermediate results yourself (planning, multi-step edits)
 
 Always pass a clear, self-contained \`arguments\` \u2014 that text is the **only** context the subagent gets.