jinzd-ai-cli 0.4.15 → 0.4.17

package/dist/{chunk-HOOMQACE.js → chunk-NLT5FT2W.js}

@@ -129,6 +129,61 @@ var UndoStack = class {
 };
 var undoStack = new UndoStack();
 
+// src/core/errors.ts
+var AiCliError = class extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "AiCliError";
+  }
+};
+var ProviderError = class extends AiCliError {
+  constructor(providerId, message, cause) {
+    super(`[${providerId}] ${message}`, cause !== void 0 ? { cause } : void 0);
+    this.providerId = providerId;
+    this.name = "ProviderError";
+  }
+};
+var AuthError = class extends ProviderError {
+  constructor(providerId) {
+    super(providerId, "Invalid or missing API key. Run: ai-cli config");
+    this.name = "AuthError";
+  }
+};
+var RateLimitError = class extends ProviderError {
+  constructor(providerId) {
+    super(providerId, "Rate limit exceeded. Please wait before trying again.");
+    this.name = "RateLimitError";
+  }
+};
+var ConfigError = class extends AiCliError {
+  constructor(message) {
+    super(message);
+    this.name = "ConfigError";
+  }
+};
+var ProviderNotFoundError = class extends AiCliError {
+  constructor(providerId) {
+    super(
+      `Provider '${providerId}' is not configured. Run: ai-cli config`
+    );
+    this.name = "ProviderNotFoundError";
+  }
+};
+var ToolError = class extends AiCliError {
+  constructor(toolName, message, cause) {
+    super(`[${toolName}] ${message}`, cause !== void 0 ? { cause } : void 0);
+    this.toolName = toolName;
+    this.name = "ToolError";
+  }
+};
+var NetworkError = class extends AiCliError {
+  constructor(message, statusCode, cause) {
+    super(message, cause !== void 0 ? { cause } : void 0);
+    this.statusCode = statusCode;
+    this.name = "NetworkError";
+  }
+};
+
 // src/tools/builtin/bash.ts
 var IS_WINDOWS = platform() === "win32";
 var SHELL = IS_WINDOWS ? "powershell.exe" : process.env["SHELL"] ?? "/bin/bash";
@@ -174,7 +229,7 @@ Important rules:
     const timeout = Math.min(Math.max(Number(args["timeout"] ?? 3e4), 1e3), MAX_TIMEOUT);
     const cwdArg = args["cwd"] ? String(args["cwd"]) : void 0;
     if (!command.trim()) {
-      throw new Error("command is required");
+      throw new ToolError("bash", "command is required");
     }
     if (!existsSync2(persistentCwd)) {
       const fallback = process.cwd();
@@ -188,7 +243,8 @@ Important rules:
     if (cwdArg) {
       const resolved = resolve(persistentCwd, cwdArg);
       if (!existsSync2(resolved)) {
-        throw new Error(
+        throw new ToolError(
+          "bash",
           `cwd directory does not exist: "${resolved}". Create it first (e.g. mkdir -p "${resolved}") before specifying it as cwd.`
         );
       }
@@ -232,7 +288,8 @@ Important rules:
         const stderr = IS_WINDOWS && Buffer.isBuffer(execErr.stderr) ? execErr.stderr.toString("utf-8").trim() : execErr.stderr?.toString().trim() ?? "";
         const stdout = IS_WINDOWS && Buffer.isBuffer(execErr.stdout) ? execErr.stdout.toString("utf-8").trim() : execErr.stdout?.toString().trim() ?? "";
         const combined = [stdout, stderr].filter(Boolean).join("\n");
-        throw new Error(
+        throw new ToolError(
+          "bash",
           `Exit code ${execErr.status}:
 ${combined || (execErr.message ?? "Unknown error")}
 
@@ -479,12 +536,13 @@ var readFileTool = {
   async execute(args) {
     const filePath = String(args["path"] ?? "");
     const encoding = args["encoding"] ?? "utf-8";
-    if (!filePath) throw new Error("path is required");
+    if (!filePath) throw new ToolError("read_file", "path is required");
     const normalizedPath = resolve2(filePath);
     if (!existsSync3(normalizedPath)) {
       const suggestions = findSimilarFiles(filePath);
       if (suggestions.length > 0) {
-        throw new Error(
+        throw new ToolError(
+          "read_file",
           `File not found: ${filePath}
 Current working directory: ${process.cwd()}
 Found similar files, did you mean:
@@ -492,7 +550,8 @@ Found similar files, did you mean:
 Please retry with the correct relative path.`
         );
       }
-      throw new Error(
+      throw new ToolError(
+        "read_file",
         `File not found: ${filePath}
 Current working directory: ${process.cwd()}
 Please use list_dir to verify the file path and retry.`
@@ -535,14 +594,8 @@ Suggestion: read existing text versions (.md / .txt) in the project, or install
       return `[Binary file: ${filePath} (${ext})]
 This is a binary file and cannot be read as text. If there is a text version (.md / .txt) in the project, please read that instead.`;
     }
-    try {
-      const fstat = statSync2(normalizedPath);
-      if (fstat.size > MAX_FILE_BYTES) {
-        return `[File too large: ${filePath} | ${(fstat.size / 1024 / 1024).toFixed(1)} MB exceeds ${MAX_FILE_BYTES / 1024 / 1024} MB limit]`;
-      }
-    } catch {
-    }
-    const buf = readFileSync2(normalizedPath);
+    const { readFile: readFile2 } = await import("fs/promises");
+    const buf = size > 1048576 ? await readFile2(normalizedPath) : readFileSync2(normalizedPath);
     if (encoding === "base64") {
       return `[File: ${filePath} | base64]
 
@@ -599,7 +652,7 @@ Important: For long content (over 500 lines or 3000 chars), you MUST split into
     const content = String(args["content"] ?? "");
     const encoding = args["encoding"] ?? "utf-8";
     const appendMode = String(args["append"] ?? "false").toLowerCase() === "true";
-    if (!filePath) throw new Error("path is required");
+    if (!filePath) throw new ToolError("write_file", "path is required");
     undoStack.push(filePath, `write_file${appendMode ? " (append)" : ""}: ${filePath}`);
     mkdirSync(dirname2(filePath), { recursive: true });
     if (appendMode) {
@@ -739,15 +792,15 @@ Note: Path can be absolute or relative to the current working directory.`,
   async execute(args) {
     const filePath = String(args["path"] ?? "");
     const encoding = args["encoding"] ?? "utf-8";
-    if (!filePath) throw new Error("path is required");
-    if (!existsSync4(filePath)) throw new Error(`File not found: ${filePath}`);
+    if (!filePath) throw new ToolError("edit_file", "path is required");
+    if (!existsSync4(filePath)) throw new ToolError("edit_file", `File not found: ${filePath}`);
     const original = readFileSync3(filePath, encoding);
     if (args["old_str"] !== void 0) {
       const oldStr = String(args["old_str"]);
       const newStr = String(args["new_str"] ?? "");
       const ignoreWs = Boolean(args["ignore_whitespace"]);
       const replaceAll = Boolean(args["replace_all"]);
-      if (oldStr === "") throw new Error("old_str cannot be empty");
+      if (oldStr === "") throw new ToolError("edit_file", "old_str cannot be empty");
       if (ignoreWs) {
         const fileLines = original.split("\n");
         const searchLines = oldStr.split("\n");
@@ -825,7 +878,7 @@ Tip: You can also try ignore_whitespace: true to match ignoring indentation diff
       const content = String(args["insert_content"] ?? "");
       const lines = original.split("\n");
       if (afterLine < 0 || afterLine > lines.length) {
-        throw new Error(`insert_after_line ${afterLine} is out of range (file has ${lines.length} lines)`);
+        throw new ToolError("edit_file", `insert_after_line ${afterLine} is out of range (file has ${lines.length} lines)`);
       }
       undoStack.push(filePath, `edit_file (insert): ${filePath}`);
       lines.splice(afterLine, 0, content);
@@ -837,7 +890,8 @@ Tip: You can also try ignore_whitespace: true to match ignoring indentation diff
       const toLine = Number(args["delete_to_line"] ?? args["delete_from_line"]);
       const lines = original.split("\n");
       if (fromLine < 1 || toLine < fromLine || toLine > lines.length) {
-        throw new Error(
+        throw new ToolError(
+          "edit_file",
           `Invalid line range: ${fromLine}-${toLine} (file has ${lines.length} lines, lines are 1-indexed)`
         );
       }
@@ -846,7 +900,8 @@ Tip: You can also try ignore_whitespace: true to match ignoring indentation diff
       writeFileSync3(filePath, lines.join("\n"), encoding);
       return `Successfully deleted lines ${fromLine}-${toLine} (${deleted.length} lines) from ${filePath}`;
     }
-    throw new Error(
+    throw new ToolError(
+      "edit_file",
       "No operation specified. Provide either: (old_str + new_str) for replace, (insert_after_line + insert_content) for insert, or (delete_from_line + delete_to_line) for delete."
     );
   }
@@ -894,7 +949,8 @@ var listDirTool = {
       } catch {
       }
       if (suggestions.length > 0) {
-        throw new Error(
+        throw new ToolError(
+          "list_dir",
           `Directory not found: ${dirPath}
 Current working directory: ${cwd}
 Found similar directories:
@@ -902,7 +958,8 @@ Found similar directories:
 Please retry with the correct relative path.`
         );
       }
-      throw new Error(
+      throw new ToolError(
+        "list_dir",
         `Directory not found: ${dirPath}
 Current working directory: ${cwd}
 Please use list_dir (without path) to see the current directory structure first.`
@@ -958,6 +1015,7 @@ function formatSize(bytes) {
 
 // src/tools/builtin/grep-files.ts
 import { readdirSync as readdirSync4, readFileSync as readFileSync4, statSync as statSync4, existsSync as existsSync6 } from "fs";
+import { readFile } from "fs/promises";
 import { join as join2, relative } from "path";
 var grepFilesTool = {
   definition: {
@@ -1008,11 +1066,11 @@ Supports regex. Automatically skips node_modules, dist, .git directories.`,
     const ignoreCase = Boolean(args["ignore_case"] ?? false);
     const contextLines = Math.max(0, Number(args["context_lines"] ?? 0));
     const maxResults = Math.max(1, Number(args["max_results"] ?? 50));
-    if (!pattern) throw new Error("pattern is required");
-    if (!existsSync6(rootPath)) throw new Error(`Path not found: ${rootPath}`);
+    if (!pattern) throw new ToolError("grep_files", "pattern is required");
+    if (!existsSync6(rootPath)) throw new ToolError("grep_files", `Path not found: ${rootPath}`);
     const MAX_PATTERN_LENGTH = 1e3;
     if (pattern.length > MAX_PATTERN_LENGTH) {
-      throw new Error(`Pattern too long (${pattern.length} chars, max ${MAX_PATTERN_LENGTH}). Use a shorter pattern.`);
+      throw new ToolError("grep_files", `Pattern too long (${pattern.length} chars, max ${MAX_PATTERN_LENGTH}). Use a shorter pattern.`);
     }
     let regex;
     try {
@@ -1026,7 +1084,22 @@ Supports regex. Automatically skips node_modules, dist, .git directories.`,
     if (stat.isFile()) {
       searchInFile(rootPath, rootPath, regex, contextLines, maxResults, results);
     } else {
-      collectFiles(rootPath, filePattern, results, regex, contextLines, maxResults, rootPath);
+      const filePaths = collectFilePaths(rootPath, filePattern, maxResults);
+      const BATCH_SIZE = 16;
+      for (let i = 0; i < filePaths.length && results.length < maxResults; i += BATCH_SIZE) {
+        const batch = filePaths.slice(i, i + BATCH_SIZE);
+        const batchResults = await Promise.all(
+          batch.map(
+            ({ fullPath, relPath }) => searchInFileAsync(fullPath, relPath, regex, contextLines, maxResults - results.length)
+          )
+        );
+        for (const br of batchResults) {
+          for (const r of br) {
+            if (results.length >= maxResults) break;
+            results.push(r);
+          }
+        }
+      }
     }
     if (results.length === 0) {
       return `No matches found for pattern: ${pattern}
@@ -1074,27 +1147,69 @@ function isBinary(filename) {
   const ext = filename.slice(filename.lastIndexOf(".")).toLowerCase();
   return BINARY_EXTS.has(ext);
 }
-function collectFiles(dirPath, filePattern, results, regex, contextLines, maxResults, rootPath) {
-  if (results.length >= maxResults) return;
-  let entries;
+function collectFilePaths(rootPath, filePattern, maxFiles) {
+  const paths = [];
+  function walk(dirPath) {
+    if (paths.length >= maxFiles) return;
+    let entries;
+    try {
+      entries = readdirSync4(dirPath, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (paths.length >= maxFiles) return;
+      if (entry.isDirectory()) {
+        if (SKIP_DIRS.has(entry.name) || entry.name.startsWith(".")) continue;
+        walk(join2(dirPath, entry.name));
+      } else if (entry.isFile()) {
+        if (isBinary(entry.name)) continue;
+        if (filePattern && !matchesFilePattern(entry.name, filePattern)) continue;
+        const fullPath = join2(dirPath, entry.name);
+        try {
+          if (statSync4(fullPath).size > 1e6) continue;
+        } catch {
+          continue;
+        }
+        paths.push({ fullPath, relPath: relative(rootPath, fullPath) });
+      }
+    }
+  }
+  walk(rootPath);
+  return paths;
+}
+async function searchInFileAsync(fullPath, displayPath, regex, contextLines, maxResults) {
+  let content;
   try {
-    entries = readdirSync4(dirPath, { withFileTypes: true });
+    content = await readFile(fullPath, "utf-8");
   } catch {
-    return;
+    return [];
   }
-  for (const entry of entries) {
-    if (results.length >= maxResults) return;
-    if (entry.isDirectory()) {
-      if (SKIP_DIRS.has(entry.name) || entry.name.startsWith(".")) continue;
-      collectFiles(join2(dirPath, entry.name), filePattern, results, regex, contextLines, maxResults, rootPath);
-    } else if (entry.isFile()) {
-      if (isBinary(entry.name)) continue;
-      if (filePattern && !matchesFilePattern(entry.name, filePattern)) continue;
-      const fullPath = join2(dirPath, entry.name);
-      const relPath = relative(rootPath, fullPath);
-      searchInFile(fullPath, relPath, regex, contextLines, maxResults, results);
+  const results = [];
+  const lines = content.split("\n");
+  regex.lastIndex = 0;
+  for (let i = 0; i < lines.length && results.length < maxResults; i++) {
+    regex.lastIndex = 0;
+    if (regex.test(lines[i])) {
+      const match = {
+        file: displayPath.replace(/\\/g, "/"),
+        lineNumber: i + 1,
+        lineText: lines[i]
+      };
+      if (contextLines > 0) {
+        match.contextBefore = [];
+        for (let j = Math.max(0, i - contextLines); j < i; j++) {
+          match.contextBefore.push([j + 1, lines[j]]);
+        }
+        match.contextAfter = [];
+        for (let j = i + 1; j <= Math.min(lines.length - 1, i + contextLines); j++) {
+          match.contextAfter.push([j + 1, lines[j]]);
+        }
+      }
+      results.push(match);
     }
   }
+  return results;
 }
 function searchInFile(fullPath, displayPath, regex, contextLines, maxResults, results) {
   try {
@@ -1169,8 +1284,8 @@ Results sorted by most recent modification time. Automatically skips node_module
     const pattern = String(args["pattern"] ?? "");
     const rootPath = String(args["path"] ?? process.cwd());
     const maxResults = Math.max(1, Number(args["max_results"] ?? 100));
-    if (!pattern) throw new Error("pattern is required");
-    if (!existsSync7(rootPath)) throw new Error(`Path not found: ${rootPath}`);
+    if (!pattern) throw new ToolError("glob_files", "pattern is required");
+    if (!existsSync7(rootPath)) throw new ToolError("glob_files", `Path not found: ${rootPath}`);
     const regex = globToRegex(pattern);
     const matches = [];
     collectMatchingFiles(rootPath, rootPath, regex, matches, maxResults);
@@ -1319,7 +1434,7 @@ var runInteractiveTool = {
     })() : [];
     const timeout = Math.min(Math.max(Number(args["timeout"] ?? 2e4), 1e3), 3e5);
     if (!executable) {
-      throw new Error("executable is required");
+      throw new ToolError("run_interactive", "executable is required");
     }
     const env = {
       ...process.env,
@@ -1461,7 +1576,7 @@ async function resolveAndCheck(hostname) {
   try {
     const { address } = await dnsPromises.lookup(h);
     if (isPrivateHost(address)) {
-      throw new Error(`Blocked: "${hostname}" resolves to private address ${address}. web_fetch is restricted to public URLs.`);
+      throw new NetworkError(`Blocked: "${hostname}" resolves to private address ${address}. web_fetch is restricted to public URLs.`);
     }
   } catch (e) {
     if (e.message.startsWith("Blocked:")) throw e;
@@ -1488,17 +1603,17 @@ var webFetchTool = {
     const url = String(args["url"] ?? "").trim();
     const selector = args["selector"] ? String(args["selector"]).trim() : "";
     if (!url.startsWith("http://") && !url.startsWith("https://")) {
-      throw new Error(`Invalid URL: "${url}". URL must start with http:// or https://`);
+      throw new NetworkError(`Invalid URL: "${url}". URL must start with http:// or https://`);
     }
     try {
       const parsedUrl = new URL(url);
       if (isPrivateHost(parsedUrl.hostname)) {
-        throw new Error(`Blocked: "${url}" resolves to a private/internal address. web_fetch is restricted to public URLs.`);
+        throw new NetworkError(`Blocked: "${url}" resolves to a private/internal address. web_fetch is restricted to public URLs.`);
       }
       await resolveAndCheck(parsedUrl.hostname);
     } catch (e) {
       if (e.message.startsWith("Blocked:")) throw e;
-      throw new Error(`Invalid URL: "${url}"`);
+      throw new NetworkError(`Invalid URL: "${url}"`);
     }
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), 2e4);
@@ -1517,7 +1632,7 @@ var webFetchTool = {
       for (let hop = 0; hop <= MAX_REDIRECTS; hop++) {
         const parsedHop = new URL(currentUrl);
         if (isPrivateHost(parsedHop.hostname)) {
-          throw new Error(`Blocked: redirect to private/internal address "${currentUrl}".`);
+          throw new NetworkError(`Blocked: redirect to private/internal address "${currentUrl}".`);
         }
         await resolveAndCheck(parsedHop.hostname);
         const r = await fetch(currentUrl, {
@@ -1528,7 +1643,7 @@ var webFetchTool = {
         });
         if (r.status >= 300 && r.status < 400) {
           if (hop >= MAX_REDIRECTS) {
-            throw new Error(`Too many redirects (>${MAX_REDIRECTS}): ${url}`);
+            throw new NetworkError(`Too many redirects (>${MAX_REDIRECTS}): ${url}`);
           }
           const location = r.headers.get("Location");
           if (!location) {
@@ -1542,18 +1657,18 @@ var webFetchTool = {
         break;
       }
       clearTimeout(timeoutId);
-      if (!resp) throw new Error(`Too many redirects (>${MAX_REDIRECTS}): ${url}`);
+      if (!resp) throw new NetworkError(`Too many redirects (>${MAX_REDIRECTS}): ${url}`);
       finalUrl = currentUrl;
       contentType = resp.headers.get("content-type") ?? "";
       if (!resp.ok) {
-        throw new Error(`HTTP ${resp.status} ${resp.statusText}`);
+        throw new NetworkError(`HTTP ${resp.status} ${resp.statusText}`, resp.status);
       }
       const buf = await resp.arrayBuffer();
       rawHtml = new TextDecoder("utf-8", { fatal: false }).decode(buf.slice(0, 2e6));
     } catch (err) {
       clearTimeout(timeoutId);
       if (err.name === "AbortError") {
-        throw new Error(`Request timed out after 20s: ${url}`);
+        throw new NetworkError(`Request timed out after 20s: ${url}`, void 0, err);
       }
       throw err;
     }
@@ -1625,10 +1740,10 @@ var saveLastResponseTool = {
   },
   async execute(args) {
     const filePath = String(args["path"] ?? "");
-    if (!filePath) throw new Error("path is required");
+    if (!filePath) throw new ToolError("save_last_response", "path is required");
     const content = lastResponseStore.content;
     if (!content) {
-      throw new Error("No content to save: AI has not produced any response yet, or the last response was empty.");
+      throw new ToolError("save_last_response", "No content to save: AI has not produced any response yet, or the last response was empty.");
     }
     undoStack.push(filePath, `save_last_response: ${filePath}`);
     mkdirSync2(dirname3(filePath), { recursive: true });
@@ -1665,7 +1780,7 @@ var saveMemoryTool = {
   },
   async execute(args) {
     const content = String(args["content"] ?? "").trim();
-    if (!content) throw new Error("content is required");
+    if (!content) throw new ToolError("save_memory", "content is required");
     const memoryPath = getMemoryFilePath();
     const configDir = join4(homedir2(), CONFIG_DIR_NAME);
     if (!existsSync8(configDir)) {
@@ -1702,9 +1817,9 @@ var askUserTool = {
   },
   async execute(args) {
     const question = String(args["question"] ?? "").trim();
-    if (!question) throw new Error("question parameter is required");
+    if (!question) throw new ToolError("ask_user", "question parameter is required");
     if (!askUserContext.rl) {
-      throw new Error("ask_user is not available in this context (readline not initialized)");
+      throw new ToolError("ask_user", "readline not initialized \u2014 not available in this context");
     }
     const answer = await promptUser(askUserContext.rl, question);
     if (answer === null) {
@@ -1769,30 +1884,30 @@ Valid statuses: pending, in_progress, completed.`,
     let parsed;
     if (typeof raw === "string") {
       const trimmed = raw.trim();
-      if (!trimmed) throw new Error("todos parameter is required");
+      if (!trimmed) throw new ToolError("write_todos", "todos parameter is required");
       try {
         parsed = JSON.parse(trimmed);
       } catch (err) {
-        throw new Error(`Invalid JSON in todos parameter: ${err.message}`);
+        throw new ToolError("write_todos", `Invalid JSON in todos parameter: ${err.message}`, err);
       }
     } else if (Array.isArray(raw)) {
       parsed = raw;
     } else {
-      throw new Error("todos parameter must be a JSON array string");
+      throw new ToolError("write_todos", "todos parameter must be a JSON array string");
     }
     if (!Array.isArray(parsed)) {
-      throw new Error("todos must be a JSON array");
+      throw new ToolError("write_todos", "todos must be a JSON array");
     }
     const todos = parsed.map((item, i) => {
       if (typeof item !== "object" || item === null) {
-        throw new Error(`todos[${i}] must be an object`);
+        throw new ToolError("write_todos", `todos[${i}] must be an object`);
       }
       const obj = item;
       const title = String(obj["title"] ?? "").trim();
       const status = String(obj["status"] ?? "").trim();
-      if (!title) throw new Error(`todos[${i}].title is required`);
+      if (!title) throw new ToolError("write_todos", `todos[${i}].title is required`);
       if (!VALID_STATUSES.has(status)) {
-        throw new Error(`todos[${i}].status must be one of: pending, in_progress, completed (got "${status}")`);
+        throw new ToolError("write_todos", `todos[${i}].status must be one of: pending, in_progress, completed (got "${status}")`);
       }
       return { title, status };
     });
@@ -1907,7 +2022,7 @@ var googleSearchTool = {
   },
   async execute(args) {
     const query = String(args["query"] ?? "").trim();
-    if (!query) throw new Error("query parameter is required");
+    if (!query) throw new ToolError("google_search", "query parameter is required");
     const numResults = Math.min(
       Math.max(Math.floor(Number(args["num_results"] ?? DEFAULT_RESULTS)), 1),
       MAX_RESULTS
@@ -1931,24 +2046,26 @@ var googleSearchTool = {
       if (!response.ok) {
         const errorBody = await response.text().catch(() => "");
         if (response.status === 403) {
-          throw new Error(
+          throw new NetworkError(
             `Google Search API 403 Forbidden \u2014 Invalid API Key or daily free quota exceeded (100/day).
-Please check your API Key and Search Engine ID configuration.`
+Please check your API Key and Search Engine ID configuration.`,
+            403
           );
         }
         if (response.status === 429) {
-          throw new Error("Google Search API 429 \u2014 Too many requests, please try again later.");
+          throw new NetworkError("Google Search API 429 \u2014 Too many requests, please try again later.", 429);
         }
-        throw new Error(
+        throw new NetworkError(
           `Google Search API error: HTTP ${response.status} ${response.statusText}
-${errorBody.slice(0, 500)}`
+${errorBody.slice(0, 500)}`,
+          response.status
         );
       }
       const data = await response.json();
       return formatResults(query, data, numResults);
     } catch (err) {
       if (err instanceof Error && err.name === "AbortError") {
-        throw new Error(`Google Search request timed out (${REQUEST_TIMEOUT_MS / 1e3}s). Please check your network or proxy configuration.`);
+        throw new NetworkError(`Google Search request timed out (${REQUEST_TIMEOUT_MS / 1e3}s). Please check your network or proxy configuration.`, void 0, err);
       }
       throw err;
     } finally {
@@ -1967,12 +2084,14 @@ function resolveConfig() {
     cx = EnvLoader.getGoogleSearchEngineId();
   }
   if (!apiKey) {
-    throw new Error(
+    throw new ToolError(
+      "google_search",
       'Google Search API Key not configured.\nConfigure via one of:\n  1. Run /config \u2192 Configure Google Search\n  2. Set env var AICLI_API_KEY_GOOGLESEARCH\n  3. Add apiKeys["google-search"] to ~/.aicli/config.json'
     );
   }
   if (!cx) {
-    throw new Error(
+    throw new ToolError(
+      "google_search",
       "Google Search Engine ID (cx) not configured.\nConfigure via one of:\n  1. Run /config \u2192 Configure Google Search\n  2. Set env var AICLI_GOOGLE_CX\n  3. Add googleSearchEngineId to ~/.aicli/config.json\n\nGet one at: https://programmablesearchengine.google.com/ \u2192 Create search engine \u2192 Copy Search Engine ID"
     );
   }
@@ -2309,7 +2428,7 @@ var spawnAgentTool = {
   },
   async execute(args) {
     const task = String(args["task"] ?? "").trim();
-    if (!task) throw new Error("task parameter is required");
+    if (!task) throw new ToolError("spawn_agent", "task parameter is required");
     const rawMaxRounds = Number(args["max_rounds"] ?? SUBAGENT_DEFAULT_MAX_ROUNDS);
     const maxRounds = Math.min(
       Math.max(Math.round(rawMaxRounds), 1),
@@ -2317,7 +2436,7 @@ var spawnAgentTool = {
     );
     const ctx = spawnAgentContext;
     if (!ctx.provider) {
-      throw new Error("spawn_agent: provider not initialized (context not injected)");
+      throw new ToolError("spawn_agent", "provider not initialized (context not injected)");
     }
     const subRegistry = new ToolRegistry();
     for (const tool of subRegistry.listAll()) {
@@ -2533,6 +2652,11 @@ var ToolRegistry = class {
 
 export {
   EnvLoader,
+  ProviderError,
+  AuthError,
+  RateLimitError,
+  ConfigError,
+  ProviderNotFoundError,
   isFileWriteTool,
   getDangerLevel,
   schemaToJsonSchema,

package/dist/{chunk-KYWU74D5.js → chunk-OBFFL5DJ.js}

@@ -1,8 +1,13 @@
 #!/usr/bin/env node
 import {
+  AuthError,
+  ConfigError,
   EnvLoader,
+  ProviderError,
+  ProviderNotFoundError,
+  RateLimitError,
   schemaToJsonSchema
-} from "./chunk-HOOMQACE.js";
+} from "./chunk-NLT5FT2W.js";
 import {
   APP_NAME,
   CONFIG_DIR_NAME,
@@ -152,47 +157,6 @@ var ConfigSchema = z.object({
   allowPlugins: z.boolean().default(false)
 });
 
-// src/core/errors.ts
-var AiCliError = class extends Error {
-  constructor(message, options) {
-    super(message, options);
-    this.name = "AiCliError";
-  }
-};
-var ProviderError = class extends AiCliError {
-  constructor(providerId, message, cause) {
-    super(`[${providerId}] ${message}`, cause !== void 0 ? { cause } : void 0);
-    this.providerId = providerId;
-    this.name = "ProviderError";
-  }
-};
-var AuthError = class extends ProviderError {
-  constructor(providerId) {
-    super(providerId, "Invalid or missing API key. Run: ai-cli config");
-    this.name = "AuthError";
-  }
-};
-var RateLimitError = class extends ProviderError {
-  constructor(providerId) {
-    super(providerId, "Rate limit exceeded. Please wait before trying again.");
-    this.name = "RateLimitError";
-  }
-};
-var ConfigError = class extends AiCliError {
-  constructor(message) {
-    super(message);
-    this.name = "ConfigError";
-  }
-};
-var ProviderNotFoundError = class extends AiCliError {
-  constructor(providerId) {
-    super(
-      `Provider '${providerId}' is not configured. Run: ai-cli config`
-    );
-    this.name = "ProviderNotFoundError";
-  }
-};
-
 // src/config/config-manager.ts
 var ConfigManager = class {
   configDir;
@@ -978,10 +942,13 @@ var GeminiProvider = class extends BaseProvider {
   }
   wrapError(err) {
     if (err instanceof Error) {
-      if (err.message.includes("API key") || err.message.includes("PERMISSION_DENIED")) {
+      const msg = err.message;
+      const statusMatch = msg.match(/\b(4\d{2}|5\d{2})\b/);
+      const status = statusMatch ? Number(statusMatch[1]) : void 0;
+      if (msg.includes("API key") || msg.includes("PERMISSION_DENIED") || status === 401 || status === 403) {
         return new AuthError("gemini");
       }
-      if (err.message.includes("429") || err.message.includes("Too Many Requests") || err.message.includes("RESOURCE_EXHAUSTED") || err.message.includes("quota")) {
+      if (status === 429 || msg.includes("RESOURCE_EXHAUSTED") || msg.includes("quota")) {
         return new ProviderError(
           "gemini",
           `Rate limit exceeded (429): The current model requires a paid plan or the free quota has been exhausted.
@@ -990,17 +957,17 @@ var GeminiProvider = class extends BaseProvider {
           err
         );
       }
-      if (err.message.includes("fetch failed") || err.message.includes("ECONNREFUSED") || err.message.includes("ETIMEDOUT")) {
+      if (msg.includes("fetch failed") || msg.includes("ECONNREFUSED") || msg.includes("ETIMEDOUT") || msg.includes("ENOTFOUND") || msg.includes("socket hang up")) {
         return new ProviderError(
           "gemini",
-          `Network connection failed: ${err.message}
+          `Network connection failed: ${msg}
 Node.js does not automatically use system proxies. Try one of the following:
   1. Set environment variable: set HTTPS_PROXY=http://127.0.0.1:<proxy-port>
   2. Configure an accessible Gemini API mirror URL in config.json under customBaseUrls.gemini`,
           err
         );
       }
-      return new ProviderError("gemini", err.message, err);
+      return new ProviderError("gemini", msg, err);
     }
     return new ProviderError("gemini", String(err));
   }
@@ -2083,7 +2050,7 @@ var ProviderRegistry = class {
 };
 
 // src/session/session-manager.ts
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, unlinkSync, renameSync } from "fs";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, unlinkSync, renameSync, openSync, readSync, closeSync } from "fs";
 import { join as join2 } from "path";
 import { v4 as uuidv4 } from "uuid";
 
@@ -2289,6 +2256,11 @@ function safeDate(value) {
   const d = new Date(value);
   return isNaN(d.getTime()) ? /* @__PURE__ */ new Date(0) : d;
 }
+function extractJsonField(header, field) {
+  const re = new RegExp(`"${field}"\\s*:\\s*"([^"]*)"`, "i");
+  const m = header.match(re);
+  return m ? m[1] : void 0;
+}
 var SessionManager = class {
   constructor(config) {
     this.config = config;
@@ -2333,18 +2305,8 @@ var SessionManager = class {
     const metas = [];
     for (const file of files) {
       try {
-        const data = JSON.parse(
-          readFileSync2(join2(this.historyDir, file), "utf-8")
-        );
-        metas.push({
-          id: data.id,
-          provider: data.provider,
-          model: data.model,
-          messageCount: data.messages?.length ?? 0,
-          created: safeDate(data.created),
-          updated: safeDate(data.updated),
-          title: data.title
-        });
+        const meta = this.readSessionMeta(join2(this.historyDir, file));
+        if (meta) metas.push(meta);
       } catch (err) {
         process.stderr.write(
           `[Warning] Skipping corrupted session file "${file}": ${err instanceof Error ? err.message : String(err)}
@@ -2354,6 +2316,59 @@ var SessionManager = class {
     }
     return metas.sort((a, b) => b.updated.getTime() - a.updated.getTime());
   }
+  /**
+   * P1-B: Read only the first ~1KB of a session file to extract metadata fields.
+   * Session JSON format puts id/provider/model/created/updated/title before the
+   * large "messages" array, so a small header read suffices for metadata extraction.
+   * Falls back to full file read if header parsing fails.
+   */
+  readSessionMeta(filePath) {
+    const HEADER_SIZE = 1024;
+    let header;
+    try {
+      const fd = openSync(filePath, "r");
+      const buf = Buffer.alloc(HEADER_SIZE);
+      const bytesRead = readSync(fd, buf, 0, HEADER_SIZE, 0);
+      closeSync(fd);
+      header = buf.toString("utf-8", 0, bytesRead);
+    } catch {
+      return null;
+    }
+    const id = extractJsonField(header, "id");
+    const provider = extractJsonField(header, "provider");
+    const model = extractJsonField(header, "model");
+    const created = extractJsonField(header, "created");
+    const updated = extractJsonField(header, "updated");
+    const title = extractJsonField(header, "title");
+    if (id && provider && model) {
+      let messageCount = 0;
+      try {
+        const full = readFileSync2(filePath, "utf-8");
+        const matches = full.match(/"role"\s*:/g);
+        messageCount = matches ? matches.length : 0;
+      } catch {
+      }
+      return {
+        id,
+        provider,
+        model,
+        messageCount,
+        created: safeDate(created),
+        updated: safeDate(updated),
+        title: title || void 0
+      };
+    }
+    const data = JSON.parse(readFileSync2(filePath, "utf-8"));
+    return {
+      id: data.id,
+      provider: data.provider,
+      model: data.model,
+      messageCount: data.messages?.length ?? 0,
+      created: safeDate(data.created),
+      updated: safeDate(data.updated),
+      title: data.title
+    };
+  }
   deleteSession(id) {
     const filePath = join2(this.historyDir, `${id}.json`);
     if (!existsSync2(filePath)) return false;
@@ -2920,8 +2935,12 @@ var McpManager = class {
    * 关闭所有 MCP 服务器连接。
    */
   async closeAll() {
-    const promises = [...this.clients.values()].map((c) => c.close().catch(() => {
-    }));
+    const promises = [...this.clients.entries()].map(
+      ([id, c]) => c.close().catch((err) => {
+        process.stderr.write(`[mcp] Failed to close ${id}: ${err instanceof Error ? err.message : err}
+`);
+      })
+    );
     await Promise.allSettled(promises);
     this.clients.clear();
   }

package/dist/{hub-34MLKYPL.js → hub-WF6CNNUT.js}

@@ -381,7 +381,7 @@ ${content}`);
   }
 }
 async function runTaskMode(config, providers, configManager, topic) {
-  const { TaskOrchestrator } = await import("./task-orchestrator-AFMHSW4N.js");
+  const { TaskOrchestrator } = await import("./task-orchestrator-FVBUXFLC.js");
   const orchestrator = new TaskOrchestrator(config, providers, configManager);
   let interrupted = false;
   const onSigint = () => {

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   saveDevState,
   sessionHasMeaningfulContent,
   setupProxy
-} from "./chunk-KYWU74D5.js";
+} from "./chunk-OBFFL5DJ.js";
 import {
   ToolRegistry,
   askUserContext,
@@ -38,7 +38,7 @@ import {
   theme,
   truncateOutput,
   undoStack
-} from "./chunk-HOOMQACE.js";
+} from "./chunk-NLT5FT2W.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   AUTHOR,
@@ -442,8 +442,20 @@ var Renderer = class {
   }
   renderError(err) {
     const message = err instanceof Error ? err.message : String(err);
+    const lines = [message];
+    if (err instanceof Error && err.cause) {
+      let cause = err.cause;
+      let depth = 0;
+      while (cause && depth < 3) {
+        const causeMsg = cause instanceof Error ? cause.message : String(cause);
+        lines.push(`  Caused by: ${causeMsg}`);
+        cause = cause instanceof Error ? cause.cause : void 0;
+        depth++;
+      }
+    }
+    const typeName = err instanceof Error && err.name !== "Error" ? ` [${err.name}]` : "";
     console.error(theme.error(`
-Error: ${message}
+Error${typeName}: ${lines.join("\n")}
 `));
   }
   /**
@@ -4158,21 +4170,27 @@ Session '${this.resumeSessionId}' not found.
     }
     if (Object.keys(mergedMcpServers).length > 0) {
       this.mcpManager = new McpManager();
-      await this.mcpManager.connectAll(mergedMcpServers);
-      const mcpTools = this.mcpManager.getAllTools();
-      for (const tool of mcpTools) {
-        this.toolRegistry.registerMcpTool(tool);
-      }
-      const connectedCount = this.mcpManager.getConnectedCount();
-      const totalTools = this.mcpManager.getTotalToolCount();
-      if (connectedCount > 0) {
-        const projectCount = Object.keys(projectMcpServers).length;
-        const sourceInfo = projectCount > 0 ? ` (${projectCount} from .mcp.json)` : "";
-        process.stdout.write(
-          theme.dim(`  \u{1F50C} MCP: ${connectedCount} server(s), ${totalTools} tool(s)${sourceInfo}
+      const mcpProjectCount = Object.keys(projectMcpServers).length;
+      this.mcpManager.connectAll(mergedMcpServers).then(() => {
+        const mcpTools = this.mcpManager.getAllTools();
+        for (const tool of mcpTools) {
+          this.toolRegistry.registerMcpTool(tool);
+        }
+        const connectedCount = this.mcpManager.getConnectedCount();
+        const totalTools = this.mcpManager.getTotalToolCount();
+        if (connectedCount > 0) {
+          const sourceInfo = mcpProjectCount > 0 ? ` (${mcpProjectCount} from .mcp.json)` : "";
+          process.stdout.write(
+            theme.dim(`
+  \u{1F50C} MCP: ${connectedCount} server(s), ${totalTools} tool(s)${sourceInfo}
 `)
-        );
-      }
+          );
+          this.showPrompt();
+        }
+      }).catch((err) => {
+        process.stderr.write(`[mcp] connectAll error: ${err instanceof Error ? err.message : err}
+`);
+      });
     }
     this.setupClipboardPaste();
     this.rl.on("SIGINT", () => {
@@ -5436,7 +5454,9 @@ Tip: You can continue the conversation by asking the AI to proceed.`
     if (sessionId) {
       this.events.emit("session.end", { sessionId });
     }
-    this.mcpManager?.closeAll().catch(() => {
+    this.mcpManager?.closeAll().catch((err) => {
+      process.stderr.write(`[mcp] cleanup error: ${err instanceof Error ? err.message : err}
+`);
     });
     this.rl.close();
     console.log(theme.dim("\nGoodbye!"));
@@ -5528,7 +5548,7 @@ program.command("web").description("Start Web UI server with browser-based chat
     console.error("Error: Invalid port number. Must be between 1 and 65535.");
     process.exit(1);
   }
-  const { startWebServer } = await import("./server-CL6Q5R2O.js");
+  const { startWebServer } = await import("./server-KSH5U7QY.js");
   await startWebServer({ port, host: options.host });
 });
 program.command("user [action] [username]").description("Manage Web UI users (list | create <name> | delete <name> | reset-password <name> | migrate <name>)").action(async (action, username) => {
@@ -5761,7 +5781,7 @@ program.command("hub [topic]").description("Start multi-agent hub (discuss / bra
     }),
     config.get("customProviders")
   );
-  const { startHub } = await import("./hub-34MLKYPL.js");
+  const { startHub } = await import("./hub-WF6CNNUT.js");
   await startHub(
     {
       topic: topic ?? "",

package/dist/{server-CL6Q5R2O.js → server-KSH5U7QY.js}

@@ -18,7 +18,7 @@ import {
   renderDiff,
   runHook,
   setupProxy
-} from "./chunk-KYWU74D5.js";
+} from "./chunk-OBFFL5DJ.js";
 import {
   AuthManager
 } from "./chunk-BYNY5JPB.js";
@@ -32,7 +32,7 @@ import {
   spawnAgentContext,
   truncateOutput,
   undoStack
-} from "./chunk-HOOMQACE.js";
+} from "./chunk-NLT5FT2W.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   AUTHOR,
@@ -658,7 +658,15 @@ var SessionHandler = class _SessionHandler {
         await this.handleChatSimple(provider, session.messages);
       }
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
+      const parts = [];
+      let current = err;
+      let depth = 0;
+      while (current && depth < 3) {
+        parts.push(current instanceof Error ? current.message : String(current));
+        current = current instanceof Error ? current.cause : void 0;
+        depth++;
+      }
+      const message = parts.join(" \u2192 Caused by: ");
       this.send({ type: "error", message });
     } finally {
       this.processing = false;
@@ -1963,7 +1971,9 @@ Add .md files to create commands.` });
       if (existsSync3(memPath)) {
         content = readFileSync3(memPath, "utf-8");
       }
-    } catch {
+    } catch (err) {
+      process.stderr.write(`[web] Failed to read memory file: ${err instanceof Error ? err.message : err}
+`);
     }
     this.send({
       type: "memory_content",

package/dist/{task-orchestrator-AFMHSW4N.js → task-orchestrator-FVBUXFLC.js}

@@ -4,7 +4,7 @@ import {
   getDangerLevel,
   googleSearchContext,
   truncateOutput
-} from "./chunk-HOOMQACE.js";
+} from "./chunk-NLT5FT2W.js";
 import {
   SUBAGENT_ALLOWED_TOOLS
 } from "./chunk-KOD3C2CU.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jinzd-ai-cli",
-  "version": "0.4.15",
+  "version": "0.4.17",
   "description": "Cross-platform REPL-style AI CLI with multi-provider support",
   "type": "module",
   "main": "./dist/index.js",