minimal-agent 0.1.7 → 0.1.9

package/dist/main.js

@@ -2,9 +2,9 @@
 
 // src/main.tsx
 import { render } from "ink";
-import { existsSync as existsSync9, mkdirSync } from "fs";
+import { existsSync as existsSync10, mkdirSync } from "fs";
 import { createRequire } from "module";
-import { resolve as resolve8 } from "path";
+import { resolve as resolve9 } from "path";
 
 // src/bootstrap/cwdArg.ts
 function extractCwdArg(argv) {
@@ -50,6 +50,7 @@ async function readSavedConfig() {
       model: data.model,
       provider: typeof data.provider === "string" ? data.provider : void 0,
       contextWindow: typeof data.contextWindow === "number" && data.contextWindow > 0 ? data.contextWindow : void 0,
+      tavilyApiKey: typeof data.tavilyApiKey === "string" && data.tavilyApiKey.length > 0 ? data.tavilyApiKey : void 0,
       savedAt: typeof data.savedAt === "number" ? data.savedAt : 0
     };
   } catch {
@@ -98,6 +99,13 @@ async function loadProviderLayered() {
     contextWindow
   };
 }
+async function applyToolKeysToEnv() {
+  const saved = await readSavedConfig();
+  if (!saved) return;
+  if (!process.env.TAVILY_API_KEY && saved.tavilyApiKey) {
+    process.env.TAVILY_API_KEY = saved.tavilyApiKey;
+  }
+}
 
 // src/context/persistContext.ts
 import { mkdir as mkdir3, readFile as readFile2, readdir, rmdir, unlink, writeFile as writeFile2 } from "fs/promises";
@@ -221,7 +229,11 @@ async function loadProjectInstructions(cwd) {
 
 // src/prompts/skillList.ts
 import { readFile as readFile4, readdir as readdir2 } from "fs/promises";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
+
+// src/utils/resourcePaths.ts
+import { existsSync as existsSync2 } from "fs";
+import { join as join5, resolve as resolve4 } from "path";
 
 // src/utils/packageRoot.ts
 import { existsSync } from "fs";
@@ -245,8 +257,26 @@ function findPackageRoot(metaUrl) {
   throw new Error(`packageRoot: \u627E\u4E0D\u5230 package.json\uFF08\u8D77\u70B9 ${metaUrl}\uFF09`);
 }
 
+// src/utils/resourcePaths.ts
+function getResourceSearchPaths(name, metaUrl) {
+  const paths = [];
+  const cwdPath = resolve4(join5(getWorkingDir(), name));
+  if (existsSync2(cwdPath)) {
+    paths.push(cwdPath);
+  }
+  let pkgPath;
+  try {
+    pkgPath = resolve4(join5(findPackageRoot(metaUrl), name));
+  } catch {
+    return paths;
+  }
+  if (pkgPath !== cwdPath && existsSync2(pkgPath)) {
+    paths.push(pkgPath);
+  }
+  return paths;
+}
+
 // src/prompts/skillList.ts
-var SKILLS_DIR = join5(findPackageRoot(import.meta.url), "skills");
 function stripQuotes(s) {
   const trimmed = s.trim();
   if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
@@ -254,7 +284,7 @@ function stripQuotes(s) {
   }
   return trimmed;
 }
-function parseFrontmatter(content) {
+function parseFrontmatter(content, sourceDir) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
   if (!match) return null;
   const frontmatter = match[1];
@@ -267,26 +297,33 @@ function parseFrontmatter(content) {
     name: stripQuotes(nameMatch[1]),
     description: stripQuotes(descMatch[1]),
     type: typeMatch ? stripQuotes(typeMatch[1]) : void 0,
-    triggers: triggersMatch ? stripQuotes(triggersMatch[1]) : void 0
+    triggers: triggersMatch ? stripQuotes(triggersMatch[1]) : void 0,
+    sourceDir
   };
 }
 async function getSkillList() {
   const skills = [];
-  try {
-    const entries = await readdir2(SKILLS_DIR, { withFileTypes: true });
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const skillPath = join5(SKILLS_DIR, entry.name, "SKILL.md");
-      try {
-        const content = await readFile4(skillPath, "utf8");
-        const meta = parseFrontmatter(content);
-        if (meta) {
-          skills.push(meta);
+  const seenNames = /* @__PURE__ */ new Set();
+  const searchPaths = getResourceSearchPaths("skills", import.meta.url);
+  for (const root of searchPaths) {
+    try {
+      const entries = await readdir2(root, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        const sourceDir = join6(root, entry.name);
+        const skillPath = join6(sourceDir, "SKILL.md");
+        try {
+          const content = await readFile4(skillPath, "utf8");
+          const meta = parseFrontmatter(content, sourceDir);
+          if (meta && !seenNames.has(meta.name)) {
+            seenNames.add(meta.name);
+            skills.push(meta);
+          }
+        } catch {
         }
-      } catch {
       }
+    } catch {
     }
-  } catch {
   }
   return skills;
 }
@@ -297,13 +334,11 @@ function formatSkillHint(skills) {
   const lines = [];
   lines.push("# \u53EF\u7528\u6280\u80FD\uFF08/\u547D\u4EE4\uFF09");
   lines.push("");
-  lines.push(`> Skills \u6839\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84\uFF1A\`${SKILLS_DIR}\``);
-  lines.push("");
   lines.push(
-    "\u4EE5\u4E0B\u662F\u5F53\u524D\u53EF\u7528\u7684\u6280\u80FD\u3002**\u5F53\u7528\u6237\u610F\u56FE\u5339\u914D\u67D0\u4E2A\u6280\u80FD\u7684\u89E6\u53D1\u65F6\u673A\u65F6\uFF0C\u4F60\u5E94\u8BE5\u4E3B\u52A8\u4F7F\u7528\u5B83**\u3002"
+    "\u4EE5\u4E0B\u662F\u5F53\u524D\u53EF\u7528\u7684\u6280\u80FD\uFF08**\u53CC\u6E90**\uFF1A\u7528\u6237\u9879\u76EE\u76EE\u5F55 + minimal-agent \u5305\u76EE\u5F55\uFF0C\u540C\u540D\u65F6\u9879\u76EE\u4F18\u5148\uFF09\u3002**\u5F53\u7528\u6237\u610F\u56FE\u5339\u914D\u67D0\u4E2A\u6280\u80FD\u7684\u89E6\u53D1\u65F6\u673A\u65F6\uFF0C\u4F60\u5E94\u8BE5\u4E3B\u52A8\u4F7F\u7528\u5B83**\u3002"
   );
   lines.push(
-    `\u5728\u4F7F\u7528\u524D\uFF0C\u5148\u7528 Read \u5DE5\u5177\u8BFB\u53D6 \`${SKILLS_DIR}/{name}/SKILL.md\` \u4E86\u89E3\u5B8C\u6574\u6D41\u7A0B\u3002`
+    "\u5728\u4F7F\u7528\u524D\uFF0C\u5148\u7528 Read \u5DE5\u5177\u8BFB\u53D6\u4E0B\u65B9\u6BCF\u4E2A\u6280\u80FD\u5361\u7247\u91CC\u7684 `**\u6280\u80FD\u76EE\u5F55**` \u8DEF\u5F84 + `/SKILL.md` \u4E86\u89E3\u5B8C\u6574\u6D41\u7A0B\u3002"
   );
   lines.push("");
   for (const skill of skills) {
@@ -313,14 +348,14 @@ function formatSkillHint(skills) {
     lines.push(`- **\u89E6\u53D1\u65F6\u673A**: ${triggers}`);
     lines.push(`- **\u529F\u80FD**: ${skill.description}`);
     lines.push(`- **\u7C7B\u578B**: ${type}`);
-    lines.push(`- **\u6280\u80FD\u76EE\u5F55**: \`${SKILLS_DIR}/${skill.name}/\``);
+    lines.push(`- **\u6280\u80FD\u76EE\u5F55**: \`${skill.sourceDir}\``);
     lines.push("");
   }
   lines.push("## \u6280\u80FD\u8C03\u7528\u6D41\u7A0B");
   lines.push("");
   lines.push("```");
   lines.push("1. \u5728 T \u9636\u6BB5\u5224\u65AD\u7528\u6237\u610F\u56FE\u662F\u5426\u5339\u914D\u67D0\u4E2A\u6280\u80FD\u7684\u89E6\u53D1\u65F6\u673A");
-  lines.push(`2. \u5339\u914D \u2192 \u5728 A \u9636\u6BB5\u7528 Read \u5DE5\u5177\u8BFB\u53D6 ${SKILLS_DIR}/{name}/SKILL.md`);
+  lines.push('2. \u5339\u914D \u2192 \u5728 A \u9636\u6BB5\u7528 Read \u5DE5\u5177\u8BFB\u53D6\u8BE5\u6280\u80FD\u5361\u7247\u7684"\u6280\u80FD\u76EE\u5F55"/SKILL.md');
   lines.push("3. \u6309\u7167 SKILL.md \u7684 Quick Reference \u548C\u6D41\u7A0B\u6267\u884C");
   lines.push("4. \u6280\u80FD\u811A\u672C\uFF08scripts/\uFF09\u4E0E SKILL.md \u4F4D\u4E8E\u540C\u4E00\u76EE\u5F55\u4E0B\uFF0C\u7528\u7EDD\u5BF9\u8DEF\u5F84\u6267\u884C");
   lines.push("5. \u5982\u679C\u6280\u80FD\u7C7B\u578B\u662F prompt\uFF0C\u5C06\u5176\u5185\u5BB9\u4F5C\u4E3A\u989D\u5916\u4E0A\u4E0B\u6587\u6307\u5BFC\u540E\u7EED\u64CD\u4F5C");
@@ -360,6 +395,8 @@ ${toolList}
   "\u6211\u8BB0\u5F97"\u3001"\u6211\u4E4B\u524D\u770B\u8FC7"\u3001"\u5E94\u8BE5\u5DEE\u4E0D\u591A"\u90FD\u4E0D\u7B97\u8BFB\u8FC7\u2014\u2014\u5FC5\u987B\u5728\u672C\u8F6E\u4EFB\u52A1\u4E2D\u5B9E\u9645\u8C03\u7528 Read\u3002
   \u5C24\u5176\u5F53\u4F60\u8981\u53C2\u8003\u67D0\u4E2A\u6587\u4EF6\u7684\u5199\u6CD5\u6765\u5B9E\u73B0\u7C7B\u4F3C\u529F\u80FD\u65F6\uFF0C\u5FC5\u987B\u5148\u91CD\u8BFB\u8BE5\u6587\u4EF6\u7684\u5173\u952E\u90E8\u5206\uFF08\u51FD\u6570\u5B9E\u73B0\u3001\u5224\u65AD\u903B\u8F91\u3001\u6570\u636E\u6D41\uFF09\uFF0C\u7406\u89E3\u6E05\u695A\u540E\u518D\u52A8\u624B\u3002
 - Edit \u5DE5\u5177\u7684 old_string \u5FC5\u987B\u5728\u6587\u4EF6\u4E2D\u552F\u4E00\uFF1B\u4E0D\u552F\u4E00\u65F6\u8BF7\u6269\u5927\u4E0A\u4E0B\u6587\u6216\u663E\u5F0F replace_all=true\u3002
+- \u540C\u4E00\u6587\u4EF6\u9700\u8981\u4FEE\u6539\u591A\u5904\uFF083 \u5904\u53CA\u4EE5\u4E0A\uFF09\u65F6\u4F18\u5148\u7528 MultiEdit\uFF1A\u6240\u6709 edit \u6309\u987A\u5E8F\u5728\u5185\u5B58\u4E2D\u5E94\u7528\uFF0C**\u5168\u90E8\u6210\u529F\u624D\u843D\u76D8**\uFF1B\u4EFB\u4E00\u5931\u8D25\u78C1\u76D8\u4E0D\u52A8\uFF0C\u907F\u514D\u4E2D\u95F4\u72B6\u6001\u6C61\u67D3\u3002\u5355\u70B9\u4FEE\u6539\u7EE7\u7EED\u7528 Edit\u3002
+- Write \u8986\u76D6\u65E2\u6709\u6587\u4EF6\u524D\u540C\u6837\u5FC5\u987B\u5148 Read\uFF08\u4E0E Edit \u5BF9\u79F0\uFF0C\u672A\u5148 Read \u4F1A\u88AB\u62D2\u7EDD\u5E76\u63D0\u793A"\u8BF7\u5148 Read"\uFF09\uFF1B\u5199\u65B0\u6587\u4EF6\u65E0\u6B64\u8981\u6C42\u3002
 - \u521B\u5EFA\u65B0\u6587\u4EF6\u7528 Write\uFF0C\u6216 Edit \u65F6 old_string \u4F20\u7A7A\u5B57\u7B26\u4E32\u3002
 - \u627E\u6587\u4EF6\u7528 Glob\uFF08"**/*.ts"\uFF09\uFF0C\u627E\u6587\u4EF6\u5185\u5BB9\u7528 Grep\uFF08\u57FA\u4E8E ripgrep\uFF09\u3002
 - \u5F53\u7528\u6237\u95EE\u5230\u8BAD\u7EC3\u622A\u6B62\u540E\u624D\u51FA\u73B0\u7684\u4FE1\u606F\uFF08\u6700\u65B0\u7248\u672C\u53F7\u3001\u8FD1\u671F\u65B0\u95FB\u3001\u7B2C\u4E09\u65B9 API \u6587\u6863\uFF09\u65F6\u7528 WebSearch\uFF1B\u4F18\u5148\u7CBE\u786E\u7684\u81EA\u7136\u8BED\u8A00\u67E5\u8BE2\u3002
@@ -369,6 +406,8 @@ ${toolList}
   Bash \u6709\u5B89\u5168\u9ED1\u540D\u5355\uFF08rm -rf /\u3001mkfs\u3001shutdown \u7B49\u5371\u9669\u547D\u4EE4\u4F1A\u88AB\u62E6\u622A\uFF09\uFF0C\u4F46\u4ECD\u9700\u8C28\u614E\uFF1A
   \u5148\u786E\u8BA4\u547D\u4EE4\u65E0\u5BB3\u518D\u6267\u884C\uFF0C\u907F\u514D\u4E0D\u53EF\u9006\u64CD\u4F5C\uFF08\u5982 git push --force\u3001git reset --hard\uFF09\u3002
   \u957F\u65F6\u95F4\u8FD0\u884C\u7684\u547D\u4EE4\uFF08npm install\u3001bun test\uFF09\u6CE8\u610F\u8D85\u65F6\u8BBE\u7F6E\uFF1B\u9700\u8981\u4EA4\u4E92\u8F93\u5165\u7684\u547D\u4EE4\u4E0D\u8981\u7528 Bash\uFF08\u7528 Write \u5199\u811A\u672C\u4EE3\u66FF\uFF09\u3002
+  Bash \u5DF2\u8BC6\u522B"\u4FE1\u606F\u6027\u9000\u51FA\u7801"\uFF1Agrep/rg/find/diff/test \u7684 exit=1\uFF08\u65E0\u5339\u914D / \u90E8\u5206\u4E0D\u53EF\u8BBF\u95EE / \u6709\u5DEE\u5F02 / \u6761\u4EF6\u5047\uFF09\u4F1A\u81EA\u52A8\u5224\u4E3A\u6210\u529F\uFF0C\u4E0D\u8981\u56E0 1 \u800C\u91CD\u8BD5\u3002
+  \u7834\u574F\u6027\u547D\u4EE4\uFF08git reset --hard / git push -f / rm -rf \u7B49\uFF09\u4F1A\u88AB Bash \u4E3B\u52A8\u5728\u8F93\u51FA\u5934\u90E8\u52A0 \u26A0\uFE0F \u8B66\u544A\uFF08\u4E0D\u62E6\u622A\uFF09\uFF0C\u770B\u5230\u65F6\u5E94\u5411\u7528\u6237\u786E\u8BA4\u610F\u56FE\u3002
 - \u5F53\u9700\u8981\u83B7\u53D6\u7F51\u9875\u9759\u6001\u6587\u672C\u5185\u5BB9\uFF08\u6293\u53D6\u6587\u6863\u3001\u8BFB\u53D6\u6587\u7AE0\uFF09\u65F6\u7528 WebFetch\u3002
   WebBrowser \u4F9D\u8D56\u53EF\u9009\u5305\uFF08playwright-core + chromium\uFF09\u2014\u2014 **\u9ED8\u8BA4\u5047\u5B9A\u672A\u5B89\u88C5**\uFF0C
   \u4EC5\u5728 WebFetch \u660E\u786E\u65E0\u6CD5\u6EE1\u8DB3\uFF08\u5982\u9700\u8981 JS \u6E32\u67D3\u540E\u7684\u5185\u5BB9\u3001\u70B9\u51FB\u6309\u94AE\u3001\u586B\u8868\u5355\u3001\u622A\u56FE\uFF09\u65F6\u518D\u5C1D\u8BD5\u3002
@@ -378,6 +417,18 @@ ${toolList}
 # \u6280\u80FD\u7CFB\u7EDF\uFF08\u79EF\u6781\u4F7F\u7528\uFF09
 ${skillHint}
 
+# \u63D2\u4EF6\u7CFB\u7EDF\uFF08\u88AB\u52A8\u89E6\u53D1\uFF09
+- minimal-agent \u5728 \`plugins/\` \u76EE\u5F55\u4E0B\u52A0\u8F7D\u7528\u6237\u5B89\u88C5\u7684\u63D2\u4EF6\uFF0C\u66B4\u9732\u5F62\u5982 \`/ralph-loop\` \u7684\u547D\u4EE4\u3002
+  \u4E0E skill \u4E0D\u540C\uFF0C**\u63D2\u4EF6\u547D\u4EE4\u5FC5\u987B\u7531\u7528\u6237\u4E3B\u52A8\u8F93\u5165\u624D\u89E6\u53D1**\u2014\u2014\u4F60**\u4E0D\u8981**\u4E3B\u52A8\u8C03\u7528\u6216\u6A21\u62DF\u8FD9\u4E9B\u547D\u4EE4\uFF0C
+  \u4E5F\u4E0D\u8981\u5728\u5DE5\u5177\u8C03\u7528\u91CC\u5047\u88C5\u5728\u8DD1\u63D2\u4EF6\u3002
+- \u5F53\u7528\u6237\u7684\u9700\u6C42\u662F **"\u81EA\u52A8\u91CD\u590D\u5C1D\u8BD5\u76F4\u5230\u6210\u529F / \u8FED\u4EE3\u4FEE\u590D\u6D4B\u8BD5\u76F4\u5230\u5168\u7EFF / \u53CD\u590D\u6253\u78E8\u540C\u4E00\u4EFD\u4EA7\u7269"** \u7B49
+  \u957F\u5FAA\u73AF\u573A\u666F\u65F6\uFF0C\u53EF\u4EE5\u5EFA\u8BAE\u7528\u6237\u6539\u7528\uFF1A\`/ralph-loop "<\u76EE\u6807>" [--max-iterations N] [--verify ...]\`
+  \uFF08\u5185\u7F6E\u7684\u590D\u5236\u4EFB\u52A1\u5FAA\u73AF\uFF0C\u4E94\u9636\u6BB5 FSM\uFF1APLAN \u2192 BUILD \u2192 VERIFY \u2192 HEAL \u2192 DONE\uFF09\u3002
+- \u5982\u679C\u5F53\u8F6E\u7528\u6237\u6D88\u606F\u91CC\u51FA\u73B0 \`<promise>DONE</promise>\` / \`<PROMISE>NEED_REPLAN</PROMISE>\` \u54E8\u5175
+  \u6216 PLAN/BUILD/VERIFY/HEAL \u9636\u6BB5\u6807\u8BB0\uFF0C\u8BF4\u660E\u4F60\u6B63\u8FD0\u884C\u5728 ralph-loop \u5185\u2014\u2014\u4E25\u683C\u6309\u7167\u5F53\u8F6E\u6CE8\u5165\u7684
+  freshContext \u6307\u5F15\u884C\u52A8\uFF0C**\u4EC5\u5728\u4EFB\u52A1\u771F\u6B63\u5B8C\u6210\u65F6**\u8F93\u51FA \`<promise>DONE</promise>\`\u3002
+- \u5728**\u5E38\u89C4\u5BF9\u8BDD**\uFF08\u65E0\u4E0A\u8FF0\u9636\u6BB5\u6807\u8BB0\uFF09\u4E2D**\u7981\u6B62**\u4F7F\u7528\u8FD9\u4E9B\u54E8\u5175\u548C\u9636\u6BB5\u8BCD\u3002
+
 # \u6587\u4EF6\u8BFB\u53D6\u89C4\u8303\uFF08\u91CD\u8981\uFF01\u9632\u6B62\u4E0A\u4E0B\u6587\u6C61\u67D3\uFF09
 ## \u8BFB\u53D6\u7B56\u7565\uFF08\u6309\u573A\u666F\u9009\u62E9\uFF09
 ### \u573A\u666F 1\uFF1A\u4E0D\u786E\u5B9A\u6587\u4EF6\u5185\u5BB9
@@ -713,6 +764,14 @@ While the Bash tool can do similar things, it's better to use the built-in tools
   - Never skip hooks (--no-verify) or bypass signing (--no-gpg-sign, -c commit.gpgsign=false) unless the user has explicitly asked for it. If a hook fails, investigate and fix the underlying issue.
  - Avoid unnecessary \`sleep\` commands; do not retry failing commands in a sleep loop \u2014 diagnose the root cause.
 
+# Exit code semantics
+Some commands return non-zero exit codes for informational (non-error) reasons. Bash recognizes these and reports them as success (ok=true) \u2014 do NOT retry just because exit code is 1:
+ - \`grep\` / \`rg\` exit 1 \u2192 no match found (not an error)
+ - \`find\` exit 1 \u2192 some directories inaccessible (non-fatal, partial results still returned)
+ - \`diff\` / \`cmp\` exit 1 \u2192 files differ (informational, not an error)
+ - \`test\` / \`[\` exit 1 \u2192 condition is false (the answer to a question, not a failure)
+Only exit codes \u2265 2 from these commands indicate a real failure. For all other commands, non-zero exit codes are treated as failures normally.
+
 # Safety
 The following command patterns are blocked at the tool level and will fail before execution (no need to try them):
  - \`rm -rf /\` and variants targeting root, $HOME, ~, or system directories (/etc, /usr, /bin, /Windows, /Users, /home, ...)
@@ -722,7 +781,9 @@ The following command patterns are blocked at the tool level and will fail befor
  - Pipe-to-shell from network: \`curl ... | sh\`, \`wget ... | bash\`, etc.
  - \`chmod 777 /\`, Windows full-disk \`del /s\` / \`rmdir /s\`, \`diskpart\`
 
-If you have a legitimate use case that requires one of the above patterns, ask the user to run the command themselves in their terminal \u2014 do not try to bypass the check.`;
+If you have a legitimate use case that requires one of the above patterns, ask the user to run the command themselves in their terminal \u2014 do not try to bypass the check.
+
+Separately, Bash scans for common destructive-but-recoverable patterns (\`git reset --hard\`, \`git push -f\` / \`--force\` / \`--force-with-lease\`, \`git checkout .\`, \`git restore .\`, \`git clean -f\`, \`git stash drop/clear\`, \`git branch -D\`, \`git commit --amend\` / \`--no-verify\`, \`rm -rf <path>\`, \`DROP TABLE\`, \`TRUNCATE\`, \`DELETE FROM\`, \`kubectl delete\`, \`terraform destroy\`, etc.) and prepends a \`\u26A0\uFE0F \u8B66\u544A:\` line to the output. These commands are NOT blocked \u2014 the warning is informational. Treat it as a signal to double-check intent and surface the warning to the user when relevant.`;
 async function call(input, signal) {
   const command = input.command;
   const timeoutMs = Math.min(input.timeout ?? DEFAULT_TIMEOUT_MS, MAX_TIMEOUT_MS);
@@ -847,14 +908,14 @@ var bashTool = {
 
 // src/tools/edit/edit.ts
 import { readFile as readFile6, writeFile as writeFile3, mkdir as mkdir4 } from "fs/promises";
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
 import { dirname as dirname5 } from "path";
-import { z as z2 } from "zod";
+import { z as z3 } from "zod";
 
 // src/tools/shared/fileUtils.ts
 import { open, readFile as readFile5 } from "fs/promises";
 import { homedir as homedir4 } from "os";
-import { extname, resolve as resolve4 } from "path";
+import { extname, resolve as resolve5 } from "path";
 var BLOCKED_DEVICE_PATHS = /* @__PURE__ */ new Set([
   "/dev/zero",
   "/dev/random",
@@ -890,7 +951,7 @@ function validateAndResolvePath(rawPath, workingDir) {
     return { ok: false, error: `\u4E0D\u5141\u8BB8\u8BFB\u53D6\u8BBE\u5907\u6587\u4EF6\uFF1A${rawPath}\u3002\u8BE5\u8DEF\u5F84\u53EF\u80FD\u4EA7\u751F\u65E0\u9650\u8F93\u51FA\u6216\u963B\u585E\u8FDB\u7A0B\u3002` };
   }
   const expanded = expandPath(rawPath);
-  const resolved = resolve4(workingDir, expanded);
+  const resolved = resolve5(workingDir, expanded);
   if (isBlockedDevicePath(resolved)) {
     return { ok: false, error: `\u4E0D\u5141\u8BB8\u8BFB\u53D6\u8BBE\u5907\u6587\u4EF6\uFF1A${resolved}\u3002\u8BE5\u8DEF\u5F84\u53EF\u80FD\u4EA7\u751F\u65E0\u9650\u8F93\u51FA\u6216\u963B\u585E\u8FDB\u7A0B\u3002` };
   }
@@ -901,10 +962,13 @@ function validateAndResolvePath(rawPath, workingDir) {
 }
 function expandPath(p) {
   if (p.startsWith("~/") || p === "~") {
-    return resolve4(homedir4(), p.slice(2));
+    return resolve5(homedir4(), p.slice(2));
   }
   return p;
 }
+function resolveToolPath(rawPath) {
+  return validateAndResolvePath(rawPath, getWorkingDir());
+}
 function detectLineEndingsForString(content) {
   let crlfCount = 0;
   let lfCount = 0;
@@ -1094,9 +1158,28 @@ function applyCurlySingleQuotes(str) {
   }
   return result.join("");
 }
+function countOccurrences(haystack, needle) {
+  if (needle.length === 0) return 0;
+  let count = 0;
+  let pos = 0;
+  while ((pos = haystack.indexOf(needle, pos)) !== -1) {
+    count++;
+    pos += needle.length;
+  }
+  return count;
+}
+function splitReplaceAll(haystack, needle, replacement) {
+  return haystack.split(needle).join(replacement);
+}
+
+// src/tools/shared/schemas.ts
+import { z as z2 } from "zod";
+function filePathField(action) {
+  return z2.string().min(1, "\u5FC5\u987B\u63D0\u4F9B file_path").describe(`\u8981${action}\u7684\u6587\u4EF6\u8DEF\u5F84\uFF08\u7EDD\u5BF9\u8DEF\u5F84\u4F18\u5148\uFF0C\u76F8\u5BF9\u8DEF\u5F84\u57FA\u4E8E working dir \u89E3\u6790\uFF09`);
+}
 
 // src/tools/shared/fileState.ts
-import { existsSync as existsSync2, statSync } from "fs";
+import { existsSync as existsSync3, statSync } from "fs";
 var fileState = /* @__PURE__ */ new Map();
 function recordRead(absPath) {
   try {
@@ -1108,7 +1191,7 @@ function recordRead(absPath) {
 function assertFresh(absPath) {
   const entry = fileState.get(absPath);
   if (!entry) {
-    if (existsSync2(absPath)) {
+    if (existsSync3(absPath)) {
       return {
         ok: false,
         error: `\u6587\u4EF6 ${absPath} \u5DF2\u5B58\u5728\u4F46\u672A\u5728\u672C\u4F1A\u8BDD Read \u8FC7\u3002\u8BF7\u5148\u7528 Read \u5DE5\u5177\u8BFB\u53D6\uFF0C\u786E\u8BA4\u5185\u5BB9\u540E\u518D\u4FEE\u6539\u3002`
@@ -1135,13 +1218,13 @@ function clearFileState() {
 
 // src/tools/edit/edit.ts
 var MAX_EDIT_FILE_SIZE_BYTES = 1024 * 1024 * 1024;
-var inputSchema2 = z2.object({
-  file_path: z2.string().min(1).describe("\u8981\u7F16\u8F91\u7684\u6587\u4EF6\u8DEF\u5F84"),
-  old_string: z2.string().describe(
+var inputSchema2 = z3.object({
+  file_path: filePathField("\u7F16\u8F91"),
+  old_string: z3.string().describe(
     "\u8981\u66FF\u6362\u7684\u539F\u6587\u672C\uFF08\u5FC5\u987B\u5728\u6587\u4EF6\u4E2D\u552F\u4E00\uFF0C\u9664\u975E replace_all=true\uFF09\uFF1B\u4E3A\u7A7A\u5B57\u7B26\u4E32\u4E14\u6587\u4EF6\u4E0D\u5B58\u5728\u65F6\u521B\u5EFA\u65B0\u6587\u4EF6"
   ),
-  new_string: z2.string().describe("\u66FF\u6362\u4E3A\u7684\u65B0\u6587\u672C\uFF08\u4E0E old_string \u5FC5\u987B\u4E0D\u540C\uFF09"),
-  replace_all: z2.boolean().optional().describe("\u662F\u5426\u66FF\u6362\u6240\u6709\u51FA\u73B0\u4F4D\u7F6E\uFF08\u9ED8\u8BA4 false\uFF09")
+  new_string: z3.string().describe("\u66FF\u6362\u4E3A\u7684\u65B0\u6587\u672C\uFF08\u4E0E old_string \u5FC5\u987B\u4E0D\u540C\uFF09"),
+  replace_all: z3.boolean().optional().describe("\u662F\u5426\u66FF\u6362\u6240\u6709\u51FA\u73B0\u4F4D\u7F6E\uFF08\u9ED8\u8BA4 false\uFF09")
 });
 var parameters2 = toToolParameters(inputSchema2);
 var description2 = `Performs exact string replacements in files.
@@ -1150,7 +1233,8 @@ Usage:
 - You MUST use your \`Read\` tool to read the current content of the file BEFORE calling Edit.
   Memory is unreliable \u2014 if you think you "remember" how the code looks, you are probably wrong.
   Re-read the relevant sections (function, module, or area you plan to change) every time.
-- To create a new file, pass an empty \`old_string\` and the desired contents as \`new_string\`.
+- To create a new file, pass an empty \`old_string\` and the desired contents as \`new_string\`. When creating a new file (path does not yet exist), you may call Edit directly \u2014 no prior Read is needed.
+- If the file already exists and you pass an empty \`old_string\`, the edit is rejected with a clear error. To replace the entire content of an existing file, use the Write tool instead.
 - ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.
 - The edit will FAIL if \`old_string\` is not unique in the file. Either provide a larger string with more surrounding context to make it unique or use \`replace_all\` to change every instance of \`old_string\`.
 - Use \`replace_all\` for replacing and renaming strings across the file. This parameter is useful if you want to rename a variable for instance.
@@ -1158,7 +1242,7 @@ Usage:
 async function call2(input) {
   const { old_string, new_string } = input;
   const replaceAll = input.replace_all ?? false;
-  const pathResult = validateAndResolvePath(input.file_path, getWorkingDir());
+  const pathResult = resolveToolPath(input.file_path);
   if (!pathResult.ok) return pathResult;
   const filePath = pathResult.resolvedPath;
   const freshness = assertFresh(filePath);
@@ -1168,10 +1252,11 @@ async function call2(input) {
   if (old_string === new_string) {
     return { ok: false, error: "old_string \u4E0E new_string \u5B8C\u5168\u76F8\u540C\uFF0C\u6CA1\u6709\u53EF\u6539\u7684\u5185\u5BB9\u3002" };
   }
-  if (old_string === "" && !existsSync3(filePath)) {
+  if (old_string === "" && !existsSync4(filePath)) {
     try {
       await mkdir4(dirname5(filePath), { recursive: true });
       await writeFile3(filePath, new_string, "utf8");
+      recordRead(filePath);
       return {
         ok: true,
         content: `\u5DF2\u521B\u5EFA\u65B0\u6587\u4EF6\uFF1A${filePath}\uFF08${new_string.length} \u5B57\u7B26\uFF09`
@@ -1180,7 +1265,7 @@ async function call2(input) {
       return { ok: false, error: `\u521B\u5EFA\u6587\u4EF6\u5931\u8D25\uFF1A${e.message}` };
     }
   }
-  if (!existsSync3(filePath)) {
+  if (!existsSync4(filePath)) {
     return {
       ok: false,
       error: `\u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${filePath}
@@ -1236,6 +1321,7 @@ async function call2(input) {
   const normalizedReplaced = applyLineEnding(replaced, originalLineEnding);
   try {
     await writeFile3(filePath, normalizedReplaced, "utf8");
+    recordRead(filePath);
   } catch (e) {
     return { ok: false, error: `\u5199\u5165\u5931\u8D25\uFF1A${e.message}` };
   }
@@ -1248,19 +1334,6 @@ async function call2(input) {
 \u884C\u6570\uFF1A${linesBefore} \u2192 ${linesAfter}`
   };
 }
-function countOccurrences(haystack, needle) {
-  if (needle.length === 0) return 0;
-  let count = 0;
-  let pos = 0;
-  while ((pos = haystack.indexOf(needle, pos)) !== -1) {
-    count++;
-    pos += needle.length;
-  }
-  return count;
-}
-function splitReplaceAll(haystack, needle, replacement) {
-  return haystack.split(needle).join(replacement);
-}
 function findFuzzyMatchHint(fileContent, target) {
   const MIN_OVERLAP_RATIO = 0.5;
   const MAX_HINTS = 3;
@@ -1335,16 +1408,16 @@ var editTool = {
 
 // src/tools/edit/multi-edit.ts
 import { readFile as readFile7, writeFile as writeFile4 } from "fs/promises";
-import { existsSync as existsSync4 } from "fs";
-import { z as z3 } from "zod";
-var editItemSchema = z3.object({
-  old_string: z3.string().min(1).describe("\u8981\u66FF\u6362\u7684\u539F\u6587\u672C\uFF08\u4E0D\u5141\u8BB8\u4E3A\u7A7A \u2014\u2014 \u521B\u5EFA\u65B0\u6587\u4EF6\u8BF7\u7528 Edit \u5DE5\u5177\uFF09"),
-  new_string: z3.string().describe("\u66FF\u6362\u4E3A\u7684\u65B0\u6587\u672C"),
-  replace_all: z3.boolean().optional().describe("\u662F\u5426\u66FF\u6362\u6240\u6709\u51FA\u73B0\u4F4D\u7F6E\uFF08\u9ED8\u8BA4 false\uFF0C\u8981\u6C42 old_string \u5728\u5F53\u524D\u5185\u5BB9\u4E2D\u552F\u4E00\uFF09")
+import { existsSync as existsSync5 } from "fs";
+import { z as z4 } from "zod";
+var editItemSchema = z4.object({
+  old_string: z4.string().min(1).describe("\u8981\u66FF\u6362\u7684\u539F\u6587\u672C\uFF08\u4E0D\u5141\u8BB8\u4E3A\u7A7A \u2014\u2014 \u521B\u5EFA\u65B0\u6587\u4EF6\u8BF7\u7528 Edit \u5DE5\u5177\uFF09"),
+  new_string: z4.string().describe("\u66FF\u6362\u4E3A\u7684\u65B0\u6587\u672C"),
+  replace_all: z4.boolean().optional().describe("\u662F\u5426\u66FF\u6362\u6240\u6709\u51FA\u73B0\u4F4D\u7F6E\uFF08\u9ED8\u8BA4 false\uFF0C\u8981\u6C42 old_string \u5728\u5F53\u524D\u5185\u5BB9\u4E2D\u552F\u4E00\uFF09")
 });
-var inputSchema3 = z3.object({
-  file_path: z3.string().min(1).describe("\u8981\u7F16\u8F91\u7684\u6587\u4EF6\u8DEF\u5F84"),
-  edits: z3.array(editItemSchema).min(1).max(50).describe("\u6309\u987A\u5E8F\u5E94\u7528\u7684 edit \u5217\u8868\uFF081-50 \u6761\uFF09\uFF0C\u539F\u5B50\u5316\u6267\u884C\uFF1A\u5168\u90E8\u6210\u529F\u624D\u843D\u76D8")
+var inputSchema3 = z4.object({
+  file_path: filePathField("\u7F16\u8F91"),
+  edits: z4.array(editItemSchema).min(1).max(50).describe("\u6309\u987A\u5E8F\u5E94\u7528\u7684 edit \u5217\u8868\uFF081-50 \u6761\uFF09\uFF0C\u539F\u5B50\u5316\u6267\u884C\uFF1A\u5168\u90E8\u6210\u529F\u624D\u843D\u76D8")
 });
 var parameters3 = toToolParameters(inputSchema3);
 var description3 = `Performs multiple exact string replacements in a single file, applied atomically (all-or-nothing).
@@ -1357,28 +1430,15 @@ Usage:
 - Each \`old_string\` must be unique in the current content (after prior edits) unless \`replace_all=true\`.
 - Empty \`old_string\` is NOT allowed in MultiEdit. To create a new file, use the \`Edit\` tool with a single empty-old_string call.
 - Preserve exact indentation (tabs/spaces).`;
-function countOccurrences2(haystack, needle) {
-  if (needle.length === 0) return 0;
-  let count = 0;
-  let pos = 0;
-  while ((pos = haystack.indexOf(needle, pos)) !== -1) {
-    count++;
-    pos += needle.length;
-  }
-  return count;
-}
-function splitReplaceAll2(haystack, needle, replacement) {
-  return haystack.split(needle).join(replacement);
-}
 async function call3(input) {
-  const pathResult = validateAndResolvePath(input.file_path, getWorkingDir());
+  const pathResult = resolveToolPath(input.file_path);
   if (!pathResult.ok) return pathResult;
   const filePath = pathResult.resolvedPath;
   const freshness = assertFresh(filePath);
   if (!freshness.ok) {
     return { ok: false, error: freshness.error };
   }
-  if (!existsSync4(filePath)) {
+  if (!existsSync5(filePath)) {
     return {
       ok: false,
       error: `\u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${filePath}
@@ -1419,7 +1479,7 @@ async function call3(input) {
       searchTarget = actualOld;
       processedNewString = preserveQuoteStyle(edit.old_string, actualOld, edit.new_string);
     }
-    const occurrences = countOccurrences2(currentContent, searchTarget);
+    const occurrences = countOccurrences(currentContent, searchTarget);
     if (occurrences === 0) {
       return {
         ok: false,
@@ -1432,12 +1492,13 @@ async function call3(input) {
         error: `edits[${i}].old_string \u5728\u5F53\u524D\u5185\u5BB9\u4E2D\u51FA\u73B0 ${occurrences} \u6B21\uFF0C\u4E0D\u552F\u4E00\u3002\u8BF7\u6269\u5927 old_string \u5305\u542B\u66F4\u591A\u4E0A\u4E0B\u6587\uFF0C\u6216\u663E\u5F0F\u4F20 replace_all=true\u3002`
       };
     }
-    currentContent = replaceAll ? splitReplaceAll2(currentContent, searchTarget, processedNewString) : currentContent.replace(searchTarget, processedNewString);
+    currentContent = replaceAll ? splitReplaceAll(currentContent, searchTarget, processedNewString) : currentContent.replace(searchTarget, processedNewString);
   }
   const lineEnding = await detectFileLineEndings(filePath);
   const finalContent = applyLineEnding(currentContent, lineEnding);
   try {
     await writeFile4(filePath, finalContent, "utf8");
+    recordRead(filePath);
   } catch (e) {
     return { ok: false, error: `\u5199\u5165\u5931\u8D25\uFF1A${e.message}` };
   }
@@ -1459,12 +1520,12 @@ var multiEditTool = {
 
 // src/tools/glob/glob.ts
 import { stat as stat2 } from "fs/promises";
-import { isAbsolute, resolve as resolve5 } from "path";
+import { isAbsolute, resolve as resolve6 } from "path";
 import fg from "fast-glob";
-import { z as z4 } from "zod";
-var inputSchema4 = z4.object({
-  pattern: z4.string().min(1).describe('glob \u6A21\u5F0F\uFF0C\u4F8B\u5982 "**/*.ts" \u6216 "src/components/**/*.tsx"'),
-  path: z4.string().optional().describe('\u641C\u7D22\u7684\u6839\u76EE\u5F55\uFF08\u9ED8\u8BA4\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\uFF09\uFF1B\u7701\u7565\u65F6\u4E0D\u8981\u4F20 "undefined" \u5B57\u7B26\u4E32')
+import { z as z5 } from "zod";
+var inputSchema4 = z5.object({
+  pattern: z5.string().min(1).describe('glob \u6A21\u5F0F\uFF0C\u4F8B\u5982 "**/*.ts" \u6216 "src/components/**/*.tsx"'),
+  path: z5.string().optional().describe('\u641C\u7D22\u7684\u6839\u76EE\u5F55\uFF08\u9ED8\u8BA4\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\uFF09\uFF1B\u7701\u7565\u65F6\u4E0D\u8981\u4F20 "undefined" \u5B57\u7B26\u4E32')
 });
 var parameters4 = toToolParameters(inputSchema4);
 var description4 = `- Fast file pattern matching tool that works with any codebase size
@@ -1473,7 +1534,7 @@ var description4 = `- Fast file pattern matching tool that works with any codeba
 - Use this tool when you need to find files by name patterns
 - When you need to do an open ended search that may require multiple rounds, prefer the Grep tool for content search`;
 async function call4(input) {
-  const cwd = input.path ? resolve5(input.path) : getWorkingDir();
+  const cwd = input.path ? resolve6(input.path) : getWorkingDir();
   const pattern = input.pattern.replace(/\\/g, "/");
   let matches;
   try {
@@ -1494,7 +1555,7 @@ async function call4(input) {
   }
   const withMtime = await Promise.all(
     matches.map(async (rel) => {
-      const abs = isAbsolute(rel) ? rel : resolve5(cwd, rel);
+      const abs = isAbsolute(rel) ? rel : resolve6(cwd, rel);
       try {
         const st = await stat2(abs);
         return { path: rel, mtime: st.mtimeMs };
@@ -1530,13 +1591,13 @@ var globTool = {
 
 // src/tools/grep/grep.ts
 import { spawn as spawn3 } from "child_process";
-import { resolve as resolve7 } from "path";
-import { z as z5 } from "zod";
+import { resolve as resolve8 } from "path";
+import { z as z6 } from "zod";
 
 // src/tools/grep/rgPath.ts
 import { spawn as spawn2 } from "child_process";
-import { chmodSync, existsSync as existsSync5 } from "fs";
-import { resolve as resolve6 } from "path";
+import { chmodSync, existsSync as existsSync6 } from "fs";
+import { resolve as resolve7 } from "path";
 var cached;
 async function resolveRgPath() {
   if (cached !== void 0) return cached;
@@ -1545,15 +1606,15 @@ async function resolveRgPath() {
 }
 async function detect() {
   const fromEnv = process.env.MINIMAL_AGENT_RIPGREP_PATH;
-  if (fromEnv && existsSync5(fromEnv)) return fromEnv;
+  if (fromEnv && existsSync6(fromEnv)) return fromEnv;
   const vendored = vendoredRgPath();
-  if (vendored && existsSync5(vendored)) {
+  if (vendored && existsSync6(vendored)) {
     ensureExecutable(vendored);
     return vendored;
   }
   if (await trySpawn("rg")) return "rg";
   for (const candidate of claudeCodeCandidates()) {
-    if (existsSync5(candidate)) {
+    if (existsSync6(candidate)) {
       ensureExecutable(candidate);
       return candidate;
     }
@@ -1563,7 +1624,7 @@ async function detect() {
 function vendoredRgPath() {
   try {
     const projectRoot = findPackageRoot(import.meta.url);
-    return resolve6(projectRoot, "vendor", "ripgrep", subdir(), exeName());
+    return resolve7(projectRoot, "vendor", "ripgrep", subdir(), exeName());
   } catch {
     return null;
   }
@@ -1622,42 +1683,42 @@ function claudeCodeCandidates() {
   const npmRoots = [];
   if (platform === "win32") {
     if (process.env.APPDATA) {
-      npmRoots.push(resolve6(process.env.APPDATA, "npm", "node_modules"));
+      npmRoots.push(resolve7(process.env.APPDATA, "npm", "node_modules"));
     }
     if (process.env.USERPROFILE) {
       npmRoots.push(
-        resolve6(process.env.USERPROFILE, "AppData", "Roaming", "npm", "node_modules")
+        resolve7(process.env.USERPROFILE, "AppData", "Roaming", "npm", "node_modules")
       );
     }
   } else {
     const home = process.env.HOME ?? "";
     if (home) {
-      npmRoots.push(resolve6(home, ".npm-global", "lib", "node_modules"));
-      npmRoots.push(resolve6(home, ".npm", "lib", "node_modules"));
-      npmRoots.push(resolve6(home, "node_modules"));
+      npmRoots.push(resolve7(home, ".npm-global", "lib", "node_modules"));
+      npmRoots.push(resolve7(home, ".npm", "lib", "node_modules"));
+      npmRoots.push(resolve7(home, "node_modules"));
     }
     npmRoots.push("/usr/local/lib/node_modules");
     npmRoots.push("/usr/lib/node_modules");
     npmRoots.push("/opt/homebrew/lib/node_modules");
   }
   return npmRoots.map(
-    (root) => resolve6(root, "@anthropic-ai", "claude-code", "vendor", "ripgrep", subdir2, exe)
+    (root) => resolve7(root, "@anthropic-ai", "claude-code", "vendor", "ripgrep", subdir2, exe)
   );
 }
 
 // src/tools/grep/grep.ts
-var inputSchema5 = z5.object({
-  pattern: z5.string().min(1).describe("\u6B63\u5219\u8868\u8FBE\u5F0F\uFF08ripgrep \u517C\u5BB9\u8BED\u6CD5\uFF09"),
-  path: z5.string().optional().describe("\u641C\u7D22\u7684\u6839\u76EE\u5F55\u6216\u6587\u4EF6\uFF08\u9ED8\u8BA4\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\uFF09"),
-  glob: z5.string().optional().describe('\u6587\u4EF6\u540D glob \u8FC7\u6EE4\uFF0C\u5982 "*.ts"'),
-  type: z5.string().optional().describe('rg \u7684\u6587\u4EF6\u7C7B\u578B\u5FEB\u6377\u540D\uFF0C\u5982 "py"\u3001"rust"\u3001"js"'),
-  output_mode: z5.enum(["content", "files_with_matches", "count"]).optional().describe("\u8F93\u51FA\u6A21\u5F0F\uFF1Acontent=\u5339\u914D\u884C\uFF1Bfiles_with_matches=\u53EA\u5217\u6587\u4EF6\uFF1Bcount=\u6BCF\u6587\u4EF6\u8BA1\u6570"),
-  "-i": z5.boolean().optional().describe("\u5FFD\u7565\u5927\u5C0F\u5199"),
-  "-n": z5.boolean().optional().describe("\u663E\u793A\u884C\u53F7\uFF08\u4EC5 content \u6A21\u5F0F\uFF09"),
-  "-A": z5.number().int().min(0).optional().describe("\u5339\u914D\u540E\u5C55\u793A\u51E0\u884C\u4E0A\u4E0B\u6587"),
-  "-B": z5.number().int().min(0).optional().describe("\u5339\u914D\u524D\u5C55\u793A\u51E0\u884C\u4E0A\u4E0B\u6587"),
-  "-C": z5.number().int().min(0).optional().describe("\u5339\u914D\u524D\u540E\u5404\u5C55\u793A\u51E0\u884C\uFF08\u8986\u76D6 -A/-B\uFF09"),
-  head_limit: z5.number().int().positive().optional().describe("\u8F93\u51FA\u6700\u591A\u4FDD\u7559\u524D N \u884C\uFF08\u9632\u6B62\u7ED3\u679C\u8FC7\u5927\uFF09")
+var inputSchema5 = z6.object({
+  pattern: z6.string().min(1).describe("\u6B63\u5219\u8868\u8FBE\u5F0F\uFF08ripgrep \u517C\u5BB9\u8BED\u6CD5\uFF09"),
+  path: z6.string().optional().describe("\u641C\u7D22\u7684\u6839\u76EE\u5F55\u6216\u6587\u4EF6\uFF08\u9ED8\u8BA4\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\uFF09"),
+  glob: z6.string().optional().describe('\u6587\u4EF6\u540D glob \u8FC7\u6EE4\uFF0C\u5982 "*.ts"'),
+  type: z6.string().optional().describe('rg \u7684\u6587\u4EF6\u7C7B\u578B\u5FEB\u6377\u540D\uFF0C\u5982 "py"\u3001"rust"\u3001"js"'),
+  output_mode: z6.enum(["content", "files_with_matches", "count"]).optional().describe("\u8F93\u51FA\u6A21\u5F0F\uFF1Acontent=\u5339\u914D\u884C\uFF1Bfiles_with_matches=\u53EA\u5217\u6587\u4EF6\uFF1Bcount=\u6BCF\u6587\u4EF6\u8BA1\u6570"),
+  "-i": z6.boolean().optional().describe("\u5FFD\u7565\u5927\u5C0F\u5199"),
+  "-n": z6.boolean().optional().describe("\u663E\u793A\u884C\u53F7\uFF08\u4EC5 content \u6A21\u5F0F\uFF09"),
+  "-A": z6.number().int().min(0).optional().describe("\u5339\u914D\u540E\u5C55\u793A\u51E0\u884C\u4E0A\u4E0B\u6587"),
+  "-B": z6.number().int().min(0).optional().describe("\u5339\u914D\u524D\u5C55\u793A\u51E0\u884C\u4E0A\u4E0B\u6587"),
+  "-C": z6.number().int().min(0).optional().describe("\u5339\u914D\u524D\u540E\u5404\u5C55\u793A\u51E0\u884C\uFF08\u8986\u76D6 -A/-B\uFF09"),
+  head_limit: z6.number().int().positive().optional().describe("\u8F93\u51FA\u6700\u591A\u4FDD\u7559\u524D N \u884C\uFF08\u9632\u6B62\u7ED3\u679C\u8FC7\u5927\uFF09")
 });
 var parameters5 = toToolParameters(inputSchema5);
 var description5 = `A powerful search tool built on ripgrep.
@@ -1687,7 +1748,7 @@ async function call5(input, signal) {
   args.push("--max-columns-preview");
   args.push("--sort", "modified");
   args.push("-e", input.pattern);
-  args.push(input.path ? resolve7(input.path) : ".");
+  args.push(input.path ? resolve8(input.path) : ".");
   const rgPath = await resolveRgPath();
   if (!rgPath) {
     return {
@@ -1758,31 +1819,30 @@ var grepTool = {
 import { createReadStream } from "fs";
 import { readFile as readFile8, stat as stat3 } from "fs/promises";
 import { createInterface } from "readline";
-import { z as z6 } from "zod";
-var inputSchema6 = z6.object({
-  file_path: z6.string().min(1, "\u5FC5\u987B\u63D0\u4F9B file_path").describe("\u8981\u8BFB\u53D6\u7684\u6587\u4EF6\u8DEF\u5F84\uFF0C\u7EDD\u5BF9\u8DEF\u5F84\u4F18\u5148"),
-  offset: z6.number().int().positive().optional().describe("\u8D77\u59CB\u884C\u53F7\uFF081-indexed\uFF09\uFF1B\u4E0D\u586B\u5219\u4ECE\u6587\u4EF6\u5F00\u5934\u8BFB"),
-  limit: z6.number().int().positive().optional().describe(`\u6700\u591A\u8BFB\u591A\u5C11\u884C\uFF1B\u4E0D\u586B\u5219\u7528\u9ED8\u8BA4\u503C ${MAX_LINES_TO_READ}`)
+import { z as z7 } from "zod";
+var inputSchema6 = z7.object({
+  file_path: filePathField("\u8BFB\u53D6"),
+  offset: z7.number().int().positive().optional().describe("\u8D77\u59CB\u884C\u53F7\uFF081-indexed\uFF09\uFF1B\u4E0D\u586B\u5219\u4ECE\u6587\u4EF6\u5F00\u5934\u8BFB"),
+  limit: z7.number().int().positive().optional().describe(`\u6700\u591A\u8BFB\u591A\u5C11\u884C\uFF1B\u4E0D\u586B\u5219\u7528\u9ED8\u8BA4\u503C ${MAX_LINES_TO_READ}`)
 });
 var parameters6 = toToolParameters(inputSchema6);
 var description6 = `Reads a file from the local filesystem. You can access any file directly by using this tool.
 Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
 
 Usage:
-- The file_path parameter must be an absolute path, not a relative path
+- The file_path parameter is preferably an absolute path. Relative paths are accepted and will be resolved against the agent's working directory (locked at startup via \`-d <dir>\` or process cwd).
 - By default, it reads up to ${MAX_LINES_TO_READ} lines starting from the beginning of the file
 - You can optionally specify a line offset and limit (especially handy for long files)
 - Results are returned using cat -n format, with line numbers starting at 1
 - This tool can only read text files, not directories. To read a directory, use the Glob tool.
-- If you read a file that exists but has empty contents you will receive a warning in place of file contents.`;
+- If you read a file that exists but has empty contents you will receive a warning in place of file contents.
+- This tool cannot read binary files. Files whose extensions are on the binary blocklist (images: .png/.jpg/.gif/.webp/..., documents: .pdf/.docx/.xlsx/..., executables: .exe/.dll/.so/..., archives: .zip/.tar/.gz/..., and others) will be rejected with a clear error. If the file is actually text despite the extension (e.g., a misnamed log), rename it or use Bash \`cat\` to read it directly \u2014 do not retry Read with the same path.`;
 var STREAM_THRESHOLD = 1024 * 1024;
 async function call6(input) {
   const offset = input.offset ?? 1;
   const limit = input.limit ?? MAX_LINES_TO_READ;
-  const pathResult = validateAndResolvePath(input.file_path, getWorkingDir());
-  if (!pathResult.ok) {
-    return { ok: false, error: pathResult.error };
-  }
+  const pathResult = resolveToolPath(input.file_path);
+  if (!pathResult.ok) return pathResult;
   const filePath = pathResult.resolvedPath;
   if (isBlockedDevicePath(filePath)) {
     return { ok: false, error: `\u4E0D\u5141\u8BB8\u8BFB\u53D6\u8BBE\u5907\u6587\u4EF6\uFF1A${filePath}\u3002\u8BE5\u8DEF\u5F84\u53EF\u80FD\u4EA7\u751F\u65E0\u9650\u8F93\u51FA\u6216\u963B\u585E\u8FDB\u7A0B\u3002` };
@@ -1914,7 +1974,7 @@ var readTool = {
 };
 
 // src/tools/webfetch/webfetch.ts
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 
 // src/tools/webfetch/preapproved.ts
 var PREAPPROVED_HOSTS = /* @__PURE__ */ new Set([
@@ -2199,9 +2259,9 @@ function cleanCache() {
     }
   }
 }
-var inputSchema7 = z7.object({
-  url: z7.string().describe("\u8981\u83B7\u53D6\u5185\u5BB9\u7684 URL"),
-  prompt: z7.string().describe("\u5BF9\u5185\u5BB9\u8FDB\u884C\u5904\u7406\u7684\u6307\u4EE4\uFF0C\u63CF\u8FF0\u4F60\u60F3\u4ECE\u9875\u9762\u63D0\u53D6\u4EC0\u4E48\u4FE1\u606F")
+var inputSchema7 = z8.object({
+  url: z8.string().describe("\u8981\u83B7\u53D6\u5185\u5BB9\u7684 URL"),
+  prompt: z8.string().describe("\u5BF9\u5185\u5BB9\u8FDB\u884C\u5904\u7406\u7684\u6307\u4EE4\uFF0C\u63CF\u8FF0\u4F60\u60F3\u4ECE\u9875\u9762\u63D0\u53D6\u4EC0\u4E48\u4FE1\u606F")
 });
 var parameters7 = toToolParameters(inputSchema7);
 var description7 = `- Fetches content from a specified URL and processes it using an AI model.
@@ -2421,7 +2481,7 @@ var webfetchTool = {
 };
 
 // src/tools/webbrowser/webbrowser.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 
 // src/tools/webbrowser/browser.ts
 import os from "os";
@@ -2457,12 +2517,12 @@ function screenshotPath(prefix = "browser") {
 }
 
 // src/tools/webbrowser/webbrowser.ts
-var inputSchema8 = z8.object({
-  action: z8.enum(["navigate", "screenshot", "getContent", "click", "fill", "submit"]).describe("Browser action to perform"),
-  url: z8.string().url().optional().describe("URL to navigate to (required for navigate action)"),
-  selector: z8.string().optional().describe("CSS selector for click/fill/submit actions"),
-  value: z8.string().optional().describe("Value to fill in input fields"),
-  timeout: z8.number().int().positive().optional().describe("Timeout in milliseconds (default: 30000)")
+var inputSchema8 = z9.object({
+  action: z9.enum(["navigate", "screenshot", "getContent", "click", "fill", "submit"]).describe("Browser action to perform"),
+  url: z9.string().url().optional().describe("URL to navigate to (required for navigate action)"),
+  selector: z9.string().optional().describe("CSS selector for click/fill/submit actions"),
+  value: z9.string().optional().describe("Value to fill in input fields"),
+  timeout: z9.number().int().positive().optional().describe("Timeout in milliseconds (default: 30000)")
 });
 var parameters8 = toToolParameters(inputSchema8);
 var description8 = `Control a headless web browser. Navigate to URLs, take screenshots, and interact with web pages.
@@ -2610,12 +2670,12 @@ var webbrowserTool = {
 };
 
 // src/tools/websearch/websearch.ts
-import { z as z9 } from "zod";
-var inputSchema9 = z9.object({
-  query: z9.string().min(1, "\u5FC5\u987B\u63D0\u4F9B\u641C\u7D22\u5173\u952E\u8BCD").max(400, "\u641C\u7D22\u5173\u952E\u8BCD\u592A\u957F\uFF08>400 \u5B57\uFF09").describe("\u641C\u7D22\u5173\u952E\u8BCD\uFF0C\u5EFA\u8BAE\u81EA\u7136\u8BED\u8A00\u63CF\u8FF0\u9700\u8981\u67E5\u7684\u4FE1\u606F"),
-  max_results: z9.number().int().min(1).max(20).optional().describe("\u8FD4\u56DE\u7ED3\u679C\u6570\u91CF\uFF0C1-20\uFF0C\u9ED8\u8BA4 5"),
-  search_depth: z9.enum(["basic", "advanced"]).optional().describe("basic \u5FEB\u4F46\u6D45\uFF1Badvanced \u6162\u4F46\u6DF1\uFF08\u542B answer \u6458\u8981\uFF09\uFF0C\u9ED8\u8BA4 basic"),
-  topic: z9.enum(["general", "news"]).optional().describe("general=\u901A\u7528\u7F51\u9875\uFF1Bnews=\u504F\u65B0\u95FB\u6E90\uFF1B\u9ED8\u8BA4 general")
+import { z as z10 } from "zod";
+var inputSchema9 = z10.object({
+  query: z10.string().min(1, "\u5FC5\u987B\u63D0\u4F9B\u641C\u7D22\u5173\u952E\u8BCD").max(400, "\u641C\u7D22\u5173\u952E\u8BCD\u592A\u957F\uFF08>400 \u5B57\uFF09").describe("\u641C\u7D22\u5173\u952E\u8BCD\uFF0C\u5EFA\u8BAE\u81EA\u7136\u8BED\u8A00\u63CF\u8FF0\u9700\u8981\u67E5\u7684\u4FE1\u606F"),
+  max_results: z10.number().int().min(1).max(20).optional().describe("\u8FD4\u56DE\u7ED3\u679C\u6570\u91CF\uFF0C1-20\uFF0C\u9ED8\u8BA4 5"),
+  search_depth: z10.enum(["basic", "advanced"]).optional().describe("basic \u5FEB\u4F46\u6D45\uFF1Badvanced \u6162\u4F46\u6DF1\uFF08\u542B answer \u6458\u8981\uFF09\uFF0C\u9ED8\u8BA4 basic"),
+  topic: z10.enum(["general", "news"]).optional().describe("general=\u901A\u7528\u7F51\u9875\uFF1Bnews=\u504F\u65B0\u95FB\u6E90\uFF1B\u9ED8\u8BA4 general")
 });
 var parameters9 = toToolParameters(inputSchema9);
 var description9 = `- Searches the public web via the Tavily Search API and returns structured results.
@@ -2715,25 +2775,26 @@ var webSearchTool = {
 };
 
 // src/tools/write/write.ts
-import { existsSync as existsSync6 } from "fs";
+import { existsSync as existsSync7 } from "fs";
 import { mkdir as mkdir5, stat as stat4, writeFile as writeFile5 } from "fs/promises";
 import { dirname as dirname6 } from "path";
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 var MAX_WRITE_SIZE_BYTES = 1024 * 1024 * 1024;
-var inputSchema10 = z10.object({
-  file_path: z10.string().min(1).describe("\u8981\u5199\u5165\u7684\u6587\u4EF6\u8DEF\u5F84"),
-  content: z10.string().describe("\u6587\u4EF6\u5B8C\u6574\u5185\u5BB9\uFF08\u4F1A\u8986\u76D6\u65E2\u6709\u5185\u5BB9\uFF09")
+var inputSchema10 = z11.object({
+  file_path: filePathField("\u5199\u5165"),
+  content: z11.string().describe("\u6587\u4EF6\u5B8C\u6574\u5185\u5BB9\uFF08\u4F1A\u8986\u76D6\u65E2\u6709\u5185\u5BB9\uFF09")
 });
 var parameters10 = toToolParameters(inputSchema10);
 var description10 = `Writes a file to the local filesystem.
 
 Usage:
 - This tool will overwrite the existing file if there is one at the provided path.
+- If you intend to overwrite an existing file, you MUST use your \`Read\` tool to read its current content at least once in the current session BEFORE calling Write. This tool will error with a "\u8BF7\u5148 Read" message if you attempt to overwrite a file that has not been read. To create a new file (path does not yet exist), you can call Write directly without a prior Read.
 - If the parent directory does not exist, it will be created recursively.
 - ALWAYS prefer editing existing files in the codebase via the Edit tool. NEVER write new files unless explicitly required.
 - NEVER create documentation files (*.md) or README files unless explicitly requested by the User.`;
 async function call10(input) {
-  const pathResult = validateAndResolvePath(input.file_path, getWorkingDir());
+  const pathResult = resolveToolPath(input.file_path);
   if (!pathResult.ok) return pathResult;
   const filePath = pathResult.resolvedPath;
   const freshness = assertFresh(filePath);
@@ -2750,7 +2811,7 @@ async function call10(input) {
   try {
     await mkdir5(dirname6(filePath), { recursive: true });
     let originalSize = 0;
-    const fileExisted = existsSync6(filePath);
+    const fileExisted = existsSync7(filePath);
     if (fileExisted) {
       try {
         const st = await stat4(filePath);
@@ -2779,8 +2840,10 @@ async function call10(input) {
     } else {
       await writeFile5(filePath, contentToWrite, "utf8");
     }
+    recordRead(filePath);
     const action = fileExisted ? "\u5DF2\u8986\u76D6" : "\u5DF2\u521B\u5EFA\u65B0\u6587\u4EF6";
-    const sizeInfo = fileExisted ? `\uFF08\u539F\u6587\u4EF6 ${originalSize} \u5B57\u7B26 \u2192 \u65B0\u5185\u5BB9 ${contentToWrite.length} \u5B57\u7B26\uFF09` : `\uFF08${contentToWrite.length} \u5B57\u7B26\uFF09`;
+    const newSize = Buffer.byteLength(contentToWrite, "utf8");
+    const sizeInfo = fileExisted ? `\uFF08\u539F\u6587\u4EF6 ${originalSize} \u5B57\u8282 \u2192 \u65B0\u5185\u5BB9 ${newSize} \u5B57\u8282\uFF09` : `\uFF08${newSize} \u5B57\u8282\uFF09`;
     const bomInfo = bomEncoding === "utf8-bom" ? "\uFF0C\u5DF2\u4FDD\u7559 UTF-8 BOM" : "";
     return {
       ok: true,
@@ -2860,39 +2923,52 @@ import { Box as Box7, Text as Text7 } from "ink";
 import { useCallback, useMemo, useState } from "react";
 import { Box, Text, useApp, useInput } from "ink";
 import { jsx, jsxs } from "react/jsx-runtime";
-var DEFAULT_CONTEXT_WINDOW2 = 128e3;
+var FALLBACK_CONTEXT_WINDOW = 128e3;
 var PRESETS = [
   {
     name: "minimax",
     label: "MiniMax (\u6D77\u87BA)",
     baseURL: "https://api.minimax.chat/v1",
-    models: ["MiniMax-M2.7", "MiniMax-M1", "abab6.5s-chat"]
+    models: ["MiniMax-M2.7", "MiniMax-M1", "abab6.5s-chat"],
+    contextWindow: 204800
   },
   {
     name: "deepseek",
     label: "DeepSeek",
     baseURL: "https://api.deepseek.com/v1",
-    models: ["deepseek-chat", "deepseek-reasoner"]
+    models: ["deepseek-chat", "deepseek-reasoner"],
+    contextWindow: 128e3
   },
   {
     name: "openai",
     label: "OpenAI",
     baseURL: "https://api.openai.com/v1",
-    models: ["gpt-4o", "gpt-4o-mini"]
+    models: ["gpt-4o", "gpt-4o-mini"],
+    contextWindow: 128e3
   },
   {
     name: "moonshot",
     label: "Moonshot (Kimi)",
     baseURL: "https://api.moonshot.cn/v1",
-    models: ["moonshot-v1-8k", "moonshot-v1-32k", "moonshot-v1-128k"]
+    models: ["moonshot-v1-8k", "moonshot-v1-32k", "moonshot-v1-128k"],
+    contextWindow: 128e3,
+    modelContextWindows: {
+      "moonshot-v1-8k": 8e3,
+      "moonshot-v1-32k": 32e3,
+      "moonshot-v1-128k": 128e3
+    }
   },
   {
     name: "custom",
     label: "\u81EA\u5B9A\u4E49\uFF08\u624B\u52A8\u586B baseURL\uFF09",
     baseURL: "",
-    models: []
+    models: [],
+    contextWindow: FALLBACK_CONTEXT_WINDOW
   }
 ];
+function resolveContextWindow(preset, model) {
+  return preset.modelContextWindows?.[model] ?? preset.contextWindow ?? FALLBACK_CONTEXT_WINDOW;
+}
 function ConfigWizard({ onSuccess }) {
   const { exit } = useApp();
   const [step, setStep] = useState("preset");
@@ -2921,51 +2997,68 @@ function ConfigWizard({ onSuccess }) {
     },
     [baseURL, model, preset]
   );
-  const handleTest = useCallback(async () => {
-    setStep("testing");
-    setErrorMsg(null);
-    try {
-      const url = `${baseURL.replace(/\/$/, "")}/chat/completions`;
-      const resp = await fetch(url, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${apiKey}`
-        },
-        body: JSON.stringify({
-          model,
-          messages: [{ role: "user", content: "ping" }],
-          max_tokens: 5,
-          stream: false
-        })
-      });
-      if (!resp.ok) {
-        const body = await resp.text().catch(() => "");
-        throw new Error(`HTTP ${resp.status}: ${body.slice(0, 200) || resp.statusText}`);
-      }
-      const data = await resp.json();
-      if (!Array.isArray(data.choices)) {
-        throw new Error("\u54CD\u5E94\u4E2D\u6CA1\u6709 choices \u5B57\u6BB5\uFF0C\u53EF\u80FD\u4E0D\u662F OpenAI \u517C\u5BB9\u534F\u8BAE");
+  const handleTest = useCallback(
+    async (finalModel) => {
+      setStep("testing");
+      setErrorMsg(null);
+      try {
+        const url = `${baseURL.replace(/\/$/, "")}/chat/completions`;
+        const resp = await fetch(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`
+          },
+          body: JSON.stringify({
+            model: finalModel,
+            messages: [{ role: "user", content: "ping" }],
+            max_tokens: 5,
+            stream: false
+          })
+        });
+        if (!resp.ok) {
+          const body = await resp.text().catch(() => "");
+          throw new Error(
+            `HTTP ${resp.status}: ${body.slice(0, 200) || resp.statusText}`
+          );
+        }
+        const data = await resp.json();
+        if (!Array.isArray(data.choices)) {
+          throw new Error("\u54CD\u5E94\u4E2D\u6CA1\u6709 choices \u5B57\u6BB5\uFF0C\u53EF\u80FD\u4E0D\u662F OpenAI \u517C\u5BB9\u534F\u8BAE");
+        }
+        setDraft("");
+        setStep("tavily");
+      } catch (e) {
+        setErrorMsg(e.message || "\u8FDE\u63A5\u5931\u8D25");
+        setStep("error");
       }
+    },
+    [apiKey, baseURL]
+  );
+  const finalize = useCallback(
+    async (finalModel, tavilyApiKey) => {
+      const contextWindow = resolveContextWindow(preset, finalModel);
       await saveConfig({
         baseURL,
         apiKey,
-        model,
+        model: finalModel,
         provider: preset.name,
-        contextWindow: DEFAULT_CONTEXT_WINDOW2
+        contextWindow,
+        tavilyApiKey
       });
+      if (tavilyApiKey) {
+        process.env.TAVILY_API_KEY = tavilyApiKey;
+      }
       onSuccess({
         name: preset.name,
         baseURL,
         apiKey,
-        model,
-        contextWindow: DEFAULT_CONTEXT_WINDOW2
+        model: finalModel,
+        contextWindow
       });
-    } catch (e) {
-      setErrorMsg(e.message || "\u8FDE\u63A5\u5931\u8D25");
-      setStep("error");
-    }
-  }, [apiKey, baseURL, model, onSuccess, preset.name]);
+    },
+    [apiKey, baseURL, onSuccess, preset]
+  );
   useInput((input, key) => {
     if (key.escape || key.ctrl && input === "c") {
       exit();
@@ -3020,9 +3113,10 @@ function ConfigWizard({ onSuccess }) {
         }
       }
       if (key.return) {
-        if (draft.trim().length === 0) return;
-        setModel(draft.trim());
-        void handleTest();
+        const finalModel = draft.trim();
+        if (finalModel.length === 0) return;
+        setModel(finalModel);
+        void handleTest(finalModel);
       } else if (key.backspace || key.delete) {
         setDraft((s) => s.slice(0, -1));
       } else if (input && !key.meta && !key.ctrl && !key.upArrow && !key.downArrow) {
@@ -3030,6 +3124,17 @@ function ConfigWizard({ onSuccess }) {
       }
       return;
     }
+    if (step === "tavily") {
+      if (key.return) {
+        const tavilyApiKey = draft.trim().length > 0 ? draft.trim() : void 0;
+        void finalize(model, tavilyApiKey);
+      } else if (key.backspace || key.delete) {
+        setDraft((s) => s.slice(0, -1));
+      } else if (input && !key.meta && !key.ctrl) {
+        setDraft((s) => s + input);
+      }
+      return;
+    }
     if (step === "error") {
       if (key.return) {
         enterStep("preset");
@@ -3042,7 +3147,7 @@ function ConfigWizard({ onSuccess }) {
     /* @__PURE__ */ jsx(Box, { marginBottom: 1, children: /* @__PURE__ */ jsx(Text, { color: "cyan", bold: true, children: "minimal-agent \xB7 \u9996\u6B21\u914D\u7F6E\u5411\u5BFC" }) }),
     /* @__PURE__ */ jsx(Box, { marginBottom: 1, children: /* @__PURE__ */ jsx(Text, { color: "gray", children: "\u6309 ESC \u6216 Ctrl+C \u9000\u51FA\uFF08\u4E0D\u5199\u914D\u7F6E\uFF0C\u4E0B\u6B21\u542F\u52A8\u7EE7\u7EED\u5411\u5BFC\uFF09" }) }),
     step === "preset" && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
-      /* @__PURE__ */ jsx(Text, { children: "Step 1/4 \xB7 \u9009\u62E9 provider \u9884\u8BBE\uFF08\u2191\u2193 \u79FB\u52A8\uFF0CEnter \u786E\u8BA4\uFF09" }),
+      /* @__PURE__ */ jsx(Text, { children: "Step 1/5 \xB7 \u9009\u62E9 provider \u9884\u8BBE\uFF08\u2191\u2193 \u79FB\u52A8\uFF0CEnter \u786E\u8BA4\uFF09" }),
       /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, children: PRESETS.map((p, i) => /* @__PURE__ */ jsxs(Text, { color: i === presetIndex ? "cyan" : void 0, children: [
         i === presetIndex ? "> " : "  ",
         p.label,
@@ -3050,12 +3155,12 @@ function ConfigWizard({ onSuccess }) {
       ] }, p.name)) })
     ] }),
     step === "baseURL" && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
-      /* @__PURE__ */ jsx(Text, { children: "Step 2/4 \xB7 \u8F93\u5165 API base URL\uFF08\u9ED8\u8BA4\u4E3A\u9884\u8BBE\u503C\uFF0C\u53EF\u6539\uFF09" }),
+      /* @__PURE__ */ jsx(Text, { children: "Step 2/5 \xB7 \u8F93\u5165 API base URL\uFF08\u9ED8\u8BA4\u4E3A\u9884\u8BBE\u503C\uFF0C\u53EF\u6539\uFF09" }),
       /* @__PURE__ */ jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "cyan", paddingX: 1, children: /* @__PURE__ */ jsx(Text, { children: draft || " " }) }),
       /* @__PURE__ */ jsx(Text, { color: "gray", children: "Enter \u786E\u8BA4 \xB7 Backspace \u5220\u9664" })
     ] }),
     step === "apiKey" && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
-      /* @__PURE__ */ jsx(Text, { children: "Step 3/4 \xB7 \u8F93\u5165 API key\uFF08\u8F93\u5165\u5185\u5BB9\u4E0D\u4F1A\u663E\u793A\uFF09" }),
+      /* @__PURE__ */ jsx(Text, { children: "Step 3/5 \xB7 \u8F93\u5165 API key\uFF08\u8F93\u5165\u5185\u5BB9\u4E0D\u4F1A\u663E\u793A\uFF09" }),
       /* @__PURE__ */ jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "cyan", paddingX: 1, children: /* @__PURE__ */ jsx(Text, { children: maskedApiKey || " " }) }),
       /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
         "Enter \u786E\u8BA4 \xB7 Backspace \u5220\u9664\uFF08\u5DF2\u8F93\u5165 ",
@@ -3065,7 +3170,7 @@ function ConfigWizard({ onSuccess }) {
     ] }),
     step === "model" && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
       /* @__PURE__ */ jsxs(Text, { children: [
-        "Step 4/4 \xB7 \u8F93\u5165\u6216\u9009\u62E9 model",
+        "Step 4/5 \xB7 \u8F93\u5165\u6216\u9009\u62E9 model",
         preset.models.length > 0 ? "\uFF08\u2191\u2193 \u5207\u6362\u9884\u8BBE\uFF0C\u6216\u76F4\u63A5\u7F16\u8F91\uFF09" : ""
       ] }),
       preset.models.length > 0 && /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, children: preset.models.map((m, i) => /* @__PURE__ */ jsxs(Text, { color: i === modelIndex ? "cyan" : "gray", children: [
@@ -3086,6 +3191,17 @@ function ConfigWizard({ onSuccess }) {
         model
       ] })
     ] }),
+    step === "tavily" && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx(Text, { color: "green", children: "\u2713 LLM \u8FDE\u63A5\u6D4B\u8BD5\u901A\u8FC7" }),
+      /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text, { children: "Step 5/5 \xB7 \u53EF\u9009 - Tavily API key\uFF08\u7528\u4E8E WebSearch \u5DE5\u5177\uFF09" }) }),
+      /* @__PURE__ */ jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "cyan", paddingX: 1, children: /* @__PURE__ */ jsx(Text, { children: maskedApiKey || " " }) }),
+      /* @__PURE__ */ jsx(Text, { color: "gray", children: "\u76F4\u63A5 Enter \u8DF3\u8FC7\uFF08\u4E4B\u540E\u53EF\u5728\u5BF9\u8BDD\u91CC\u8F93\u5165 /config \u6DFB\u52A0\uFF0C\u6216\u8BBE env TAVILY_API_KEY\uFF09" }),
+      /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
+        "\u514D\u8D39 key \u7533\u8BF7\uFF1Ahttps://tavily.com/  \xB7  \u5DF2\u8F93\u5165 ",
+        draft.length,
+        " \u5B57\u7B26"
+      ] })
+    ] }),
     step === "error" && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx(Text, { color: "red", children: "\u2717 \u8FDE\u63A5\u6D4B\u8BD5\u5931\u8D25" }),
       /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text, { color: "red", children: errorMsg ?? "\u672A\u77E5\u9519\u8BEF" }) }),
@@ -4215,8 +4331,7 @@ async function reactiveCompactIfApplicable(messages, provider, error, state = de
 
 // src/plugins/commandRouter.ts
 import { readFile as readFile9, readdir as readdir3 } from "fs/promises";
-import { join as join6 } from "path";
-var PLUGINS_DIR = join6(findPackageRoot(import.meta.url), "plugins");
+import { join as join7 } from "path";
 var pluginCache = /* @__PURE__ */ new Map();
 var discoveryDone = false;
 function stripQuotes2(s) {
@@ -4241,7 +4356,7 @@ function parseMarkdownFrontmatter(content) {
 }
 async function loadPlugin(pluginDirPath) {
   const dirName = pluginDirPath.split("/").pop() ?? pluginDirPath;
-  const manifestPath = join6(pluginDirPath, ".claude-plugin", "plugin.json");
+  const manifestPath = join7(pluginDirPath, ".claude-plugin", "plugin.json");
   let manifestName = dirName;
   let manifestVersion;
   let manifestDesc;
@@ -4253,13 +4368,13 @@ async function loadPlugin(pluginDirPath) {
     manifestDesc = parsed.description;
   } catch {
   }
-  const commandsDir = join6(pluginDirPath, "commands");
+  const commandsDir = join7(pluginDirPath, "commands");
   const commands = [];
   try {
     const entries = await readdir3(commandsDir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.name.endsWith(".md")) continue;
-      const cmdPath = join6(commandsDir, entry.name);
+      const cmdPath = join7(commandsDir, entry.name);
       try {
         const content = await readFile9(cmdPath, "utf8");
         const fm = parseMarkdownFrontmatter(content);
@@ -4278,7 +4393,7 @@ async function loadPlugin(pluginDirPath) {
     }
   } catch {
   }
-  const hooksJsonPath = join6(pluginDirPath, "hooks", "hooks.json");
+  const hooksJsonPath = join7(pluginDirPath, "hooks", "hooks.json");
   let hasStopHook = false;
   try {
     const hooksRaw = await readFile9(hooksJsonPath, "utf8");
@@ -4305,17 +4420,20 @@ async function discoverPlugins() {
   }
   pluginCache.clear();
   discoveryDone = true;
-  try {
-    const entries = await readdir3(PLUGINS_DIR, { withFileTypes: true });
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      if (entry.name.startsWith(".")) continue;
-      const plugin = await loadPlugin(join6(PLUGINS_DIR, entry.name));
-      if (plugin) {
+  const searchPaths = getResourceSearchPaths("plugins", import.meta.url);
+  for (const root of searchPaths) {
+    try {
+      const entries = await readdir3(root, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        if (entry.name.startsWith(".")) continue;
+        const plugin = await loadPlugin(join7(root, entry.name));
+        if (!plugin) continue;
+        if (pluginCache.has(plugin.name)) continue;
         pluginCache.set(plugin.name, plugin);
       }
+    } catch {
     }
-  } catch {
   }
   return Array.from(pluginCache.values());
 }
@@ -4375,10 +4493,10 @@ function getActiveStopHookPlugins() {
 
 // src/plugins/stopHook.ts
 import { readFile as readFile10 } from "fs/promises";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 import { spawn as spawn4 } from "child_process";
 async function loadStopHookConfig(pluginRoot) {
-  const hooksJsonPath = join7(pluginRoot, "hooks", "hooks.json");
+  const hooksJsonPath = join8(pluginRoot, "hooks", "hooks.json");
   try {
     const raw = await readFile10(hooksJsonPath, "utf8");
     const parsed = JSON.parse(raw);
@@ -4417,7 +4535,7 @@ async function executeStopHooks(pluginRoots, transcriptText) {
 }
 function runSingleStopHook(hookConfig, pluginRoot, transcriptText) {
   const resolvedCommand = hookConfig.command.replaceAll("${CLAUDE_PLUGIN_ROOT}", pluginRoot);
-  return new Promise((resolve9) => {
+  return new Promise((resolve10) => {
     const child = spawn4("bash", [resolvedCommand], {
       env: {
         ...process.env,
@@ -4429,31 +4547,31 @@ function runSingleStopHook(hookConfig, pluginRoot, transcriptText) {
       stdout += data.toString();
     });
     child.on("error", () => {
-      resolve9({ decision: "pass" });
+      resolve10({ decision: "pass" });
     });
     child.on("close", (code) => {
       if (code !== 0) {
-        resolve9({ decision: "pass" });
+        resolve10({ decision: "pass" });
         return;
       }
       const trimmed = stdout.trim();
       if (!trimmed) {
-        resolve9({ decision: "pass" });
+        resolve10({ decision: "pass" });
         return;
       }
       try {
         const parsed = JSON.parse(trimmed);
         if (parsed.decision === "block") {
-          resolve9({
+          resolve10({
             decision: "block",
             reason: typeof parsed.reason === "string" ? parsed.reason : void 0,
             systemMessage: typeof parsed.systemMessage === "string" ? parsed.systemMessage : void 0
           });
           return;
         }
-        resolve9({ decision: "pass" });
+        resolve10({ decision: "pass" });
       } catch {
-        resolve9({ decision: "pass" });
+        resolve10({ decision: "pass" });
       }
     });
     child.stdin.write(transcriptText);
@@ -4462,7 +4580,7 @@ function runSingleStopHook(hookConfig, pluginRoot, transcriptText) {
 }
 
 // src/plugins/verificationGate.ts
-import { existsSync as existsSync7, readFileSync } from "fs";
+import { existsSync as existsSync8, readFileSync } from "fs";
 import { spawn as spawn5 } from "child_process";
 function parseVerifyArg(arg) {
   const colonIdx = arg.indexOf(":");
@@ -4504,7 +4622,7 @@ function parseVerifyArgs(args) {
   return checks;
 }
 function runShell(command, timeout) {
-  return new Promise((resolve9) => {
+  return new Promise((resolve10) => {
     const isWin = process.platform === "win32";
     const child = isWin ? spawn5("cmd", ["/c", command], { timeout, env: process.env }) : spawn5("bash", ["-c", command], { timeout, env: process.env });
     let stdout = "";
@@ -4516,10 +4634,10 @@ function runShell(command, timeout) {
       stderr += d.toString();
     });
     child.on("error", () => {
-      resolve9({ exitCode: null, stdout, stderr, errored: true });
+      resolve10({ exitCode: null, stdout, stderr, errored: true });
     });
     child.on("close", (code) => {
-      resolve9({ exitCode: code, stdout, stderr, errored: false });
+      resolve10({ exitCode: code, stdout, stderr, errored: false });
     });
   });
 }
@@ -4539,7 +4657,7 @@ async function verifyShell(command, timeout) {
   };
 }
 function verifyFileExists(file) {
-  const exists = existsSync7(file);
+  const exists = existsSync8(file);
   return {
     check: { type: "file_exists", file },
     passed: exists,
@@ -4640,8 +4758,8 @@ function formatCheckName(check) {
 
 // src/plugins/goalState.ts
 import { mkdir as mkdir6, appendFile, writeFile as writeFile6, unlink as unlink2, rmdir as rmdir2 } from "fs/promises";
-import { existsSync as existsSync8, readFileSync as readFileSync2 } from "fs";
-import { join as join8 } from "path";
+import { existsSync as existsSync9, readFileSync as readFileSync2 } from "fs";
+import { join as join9 } from "path";
 var Phase = /* @__PURE__ */ ((Phase2) => {
   Phase2["PLAN"] = "plan";
   Phase2["BUILD"] = "build";
@@ -4683,13 +4801,13 @@ var GoalState = class {
   dir;
   constructor(workspaceDir, sessionTag) {
     const suffix = sessionTag ? `-${sessionTag}` : "";
-    this.dir = join8(workspaceDir, `.minimal-agent${suffix}`);
+    this.dir = join9(workspaceDir, `.minimal-agent${suffix}`);
   }
   async reset() {
     const files = ["goal.md", "completion.md", "phase.md", "progress.md", "learnings.md", "decisions.md"];
     for (const f of files) {
       try {
-        await unlink2(join8(this.dir, f));
+        await unlink2(join9(this.dir, f));
       } catch {
       }
     }
@@ -4708,22 +4826,22 @@ ${goal}
       decisions: ""
     };
     for (const [name, content] of Object.entries(files)) {
-      const path2 = join8(this.dir, `${name}.md`);
-      if (!existsSync8(path2)) {
+      const path2 = join9(this.dir, `${name}.md`);
+      if (!existsSync9(path2)) {
         await writeFile6(path2, content);
       }
     }
   }
   get goal() {
     try {
-      return readFileSync2(join8(this.dir, "goal.md"), "utf8").trim();
+      return readFileSync2(join9(this.dir, "goal.md"), "utf8").trim();
     } catch {
       return "";
     }
   }
   get completionCriteria() {
     try {
-      const raw = readFileSync2(join8(this.dir, "completion.md"), "utf8").trim();
+      const raw = readFileSync2(join9(this.dir, "completion.md"), "utf8").trim();
       return JSON.parse(raw);
     } catch {
       return [];
@@ -4731,7 +4849,7 @@ ${goal}
   }
   get currentPhase() {
     try {
-      const raw = readFileSync2(join8(this.dir, "phase.md"), "utf8").trim();
+      const raw = readFileSync2(join9(this.dir, "phase.md"), "utf8").trim();
       if (VALID_PHASES.has(raw)) {
         return raw;
       }
@@ -4754,24 +4872,24 @@ ${goal}
         `\u975E\u6CD5\u9636\u6BB5\u5207\u6362: ${current} \u2192 ${phase}\u3002\u8BE5\u76EE\u6807\u9636\u6BB5\u4E0D\u5728 PHASE_TRANSITIONS[${current}] \u7684\u53EF\u8FBE\u96C6\u5408\u5185\uFF0C\u9700\u8981\u8D70 forceSetPhase\u3002`
       );
     }
-    await writeFile6(join8(this.dir, "phase.md"), phase);
+    await writeFile6(join9(this.dir, "phase.md"), phase);
     await this.appendProgress(`PHASE \u2192 ${phase}: ${reason}`);
   }
   async forceSetPhase(phase, reason) {
     if (!VALID_PHASES.has(phase)) {
       throw new Error(`Invalid phase: ${phase}`);
     }
-    await writeFile6(join8(this.dir, "phase.md"), phase);
+    await writeFile6(join9(this.dir, "phase.md"), phase);
     await this.appendProgress(`PHASE \u2192 ${phase}: ${reason}`);
   }
   async appendProgress(line) {
     const timestamp = (/* @__PURE__ */ new Date()).toLocaleTimeString("en-US", { hour12: false });
-    await appendFile(join8(this.dir, "progress.md"), `[${timestamp}] ${line}
+    await appendFile(join9(this.dir, "progress.md"), `[${timestamp}] ${line}
 `);
   }
   tailProgress(n) {
     try {
-      const content = readFileSync2(join8(this.dir, "progress.md"), "utf8");
+      const content = readFileSync2(join9(this.dir, "progress.md"), "utf8");
       const lines = content.trim().split("\n").filter(Boolean);
       return lines.slice(-n).join("\n");
     } catch {
@@ -4779,12 +4897,12 @@ ${goal}
     }
   }
   async appendLearning(lesson) {
-    await appendFile(join8(this.dir, "learnings.md"), `- ${lesson}
+    await appendFile(join9(this.dir, "learnings.md"), `- ${lesson}
 `);
   }
   get learnings() {
     try {
-      const raw = readFileSync2(join8(this.dir, "learnings.md"), "utf8").trim();
+      const raw = readFileSync2(join9(this.dir, "learnings.md"), "utf8").trim();
       if (!raw) return "";
       const lines = raw.split("\n").filter(Boolean);
       return lines.slice(-LEARNINGS_TAIL_LINES).join("\n");
@@ -4802,12 +4920,12 @@ ${goal}
       reasoning
     };
     const line = JSON.stringify(entry);
-    await appendFile(join8(this.dir, "decisions.md"), `${line}
+    await appendFile(join9(this.dir, "decisions.md"), `${line}
 `);
   }
   findSimilarDecisions(ctx, k = 3) {
     try {
-      const content = readFileSync2(join8(this.dir, "decisions.md"), "utf8");
+      const content = readFileSync2(join9(this.dir, "decisions.md"), "utf8");
       const lines = content.trim().split("\n").filter(Boolean);
       const entries = [];
       for (const line of lines) {
@@ -4827,7 +4945,7 @@ ${goal}
   }
   summarizeDecisions(maxEntries = 5) {
     try {
-      const content = readFileSync2(join8(this.dir, "decisions.md"), "utf8");
+      const content = readFileSync2(join9(this.dir, "decisions.md"), "utf8");
       const lines = content.trim().split("\n").filter(Boolean);
       const entries = [];
       for (const line of lines.slice(-maxEntries * 2)) {
@@ -4873,7 +4991,7 @@ ${recentProgress}`);
     const files = ["goal.md", "completion.md", "phase.md", "progress.md", "learnings.md", "decisions.md"];
     for (const f of files) {
       try {
-        await unlink2(join8(this.dir, f));
+        await unlink2(join9(this.dir, f));
       } catch {
       }
     }
@@ -5699,13 +5817,13 @@ function handleEvent2(event, output, verbose) {
   }
 }
 function readFromStdin() {
-  return new Promise((resolve9) => {
+  return new Promise((resolve10) => {
     let data = "";
     let settled = false;
     const timer = setTimeout(() => {
       if (!settled) {
         settled = true;
-        resolve9("");
+        resolve10("");
       }
     }, STDIN_TIMEOUT_MS);
     process.stdin.setEncoding("utf8");
@@ -5716,7 +5834,7 @@ function readFromStdin() {
       if (!settled) {
         clearTimeout(timer);
         settled = true;
-        resolve9(data.trim());
+        resolve10(data.trim());
       }
     }
     process.stdin.on("data", onData);
@@ -5732,14 +5850,15 @@ async function main() {
   const args = process.argv.slice(2);
   const dirArg = extractCwdArg(args);
   if (dirArg) {
-    const abs = resolve8(dirArg);
-    if (!existsSync9(abs)) {
+    const abs = resolve9(dirArg);
+    if (!existsSync10(abs)) {
       mkdirSync(abs, { recursive: true });
     }
     process.chdir(abs);
   }
   initWorkingDir();
   await migrateLegacyContext(getWorkingDir());
+  await applyToolKeysToEnv();
   if (args.includes("-h") || args.includes("--help")) {
     printHelp();
     return;