jinzd-ai-cli 0.4.14 → 0.4.16

package/dist/{chunk-ROMSAKP6.js → chunk-2OKRGXVU.js}

@@ -1,8 +1,13 @@
 #!/usr/bin/env node
 import {
+  AuthError,
+  ConfigError,
   EnvLoader,
+  ProviderError,
+  ProviderNotFoundError,
+  RateLimitError,
   schemaToJsonSchema
-} from "./chunk-WIWNSN7U.js";
+} from "./chunk-DMM3XL26.js";
 import {
   APP_NAME,
   CONFIG_DIR_NAME,
@@ -15,7 +20,7 @@ import {
   MCP_TOOL_PREFIX,
   PLUGINS_DIR_NAME,
   VERSION
-} from "./chunk-244SVJXW.js";
+} from "./chunk-KOD3C2CU.js";
 
 // src/config/config-manager.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
@@ -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));
   }
@@ -2920,8 +2887,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/{chunk-WIWNSN7U.js → chunk-DMM3XL26.js}

@@ -6,7 +6,7 @@ import {
   SUBAGENT_DEFAULT_MAX_ROUNDS,
   SUBAGENT_MAX_ROUNDS_LIMIT,
   runTestsTool
-} from "./chunk-244SVJXW.js";
+} from "./chunk-KOD3C2CU.js";
 
 // src/tools/builtin/bash.ts
 import { execSync } from "child_process";
@@ -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.`
@@ -599,7 +658,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 +798,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 +884,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 +896,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 +906,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 +955,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 +964,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.`
@@ -1008,11 +1071,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 {
@@ -1169,8 +1232,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 +1382,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 +1524,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 +1551,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 +1580,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 +1591,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 +1605,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 +1688,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 +1728,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 +1765,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 +1832,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 };
     });
@@ -1854,10 +1917,6 @@ var EnvLoader = class {
    */
   static getApiKey(providerId) {
     const fixedEnvVar = ENV_KEY_MAP[providerId];
-    if (fixedEnvVar) {
-      const val = process.env[fixedEnvVar];
-      if (val) return val;
-    }
     const dynamicEnvVar = `AICLI_API_KEY_${providerId.toUpperCase().replace(/-/g, "_")}`;
     if (fixedEnvVar && fixedEnvVar !== dynamicEnvVar) {
       const fixedVal = process.env[fixedEnvVar];
@@ -1867,6 +1926,10 @@ var EnvLoader = class {
 `);
       }
     }
+    if (fixedEnvVar) {
+      const val = process.env[fixedEnvVar];
+      if (val) return val;
+    }
     return process.env[dynamicEnvVar] || void 0;
   }
   static getDefaultProvider() {
@@ -1907,7 +1970,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 +1994,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 +2032,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 +2376,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 +2384,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 +2600,11 @@ var ToolRegistry = class {
 
 export {
   EnvLoader,
+  ProviderError,
+  AuthError,
+  RateLimitError,
+  ConfigError,
+  ProviderNotFoundError,
   isFileWriteTool,
   getDangerLevel,
   schemaToJsonSchema,

package/dist/{chunk-244SVJXW.js → chunk-KOD3C2CU.js}

@@ -8,7 +8,7 @@ import { platform } from "os";
 import chalk from "chalk";
 
 // src/core/constants.ts
-var VERSION = "0.4.14";
+var VERSION = "0.4.15";
 var APP_NAME = "ai-cli";
 var CONFIG_DIR_NAME = ".aicli";
 var CONFIG_FILE_NAME = "config.json";

package/dist/{chunk-QW2UGW6D.js → chunk-SNUHVNSD.js}

@@ -6,7 +6,7 @@ import { platform } from "os";
 import chalk from "chalk";
 
 // src/core/constants.ts
-var VERSION = "0.4.14";
+var VERSION = "0.4.15";
 var APP_NAME = "ai-cli";
 var CONFIG_DIR_NAME = ".aicli";
 var CONFIG_FILE_NAME = "config.json";

package/dist/{hub-QZXQ6JYS.js → hub-2MUUWFAZ.js}

@@ -381,7 +381,7 @@ ${content}`);
   }
 }
 async function runTaskMode(config, providers, configManager, topic) {
-  const { TaskOrchestrator } = await import("./task-orchestrator-EGJZA6Y4.js");
+  const { TaskOrchestrator } = await import("./task-orchestrator-USDQ6J6V.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-ROMSAKP6.js";
+} from "./chunk-2OKRGXVU.js";
 import {
   ToolRegistry,
   askUserContext,
@@ -38,7 +38,7 @@ import {
   theme,
   truncateOutput,
   undoStack
-} from "./chunk-WIWNSN7U.js";
+} from "./chunk-DMM3XL26.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   AUTHOR,
@@ -58,7 +58,7 @@ import {
   REPO_URL,
   SKILLS_DIR_NAME,
   VERSION
-} from "./chunk-244SVJXW.js";
+} from "./chunk-KOD3C2CU.js";
 
 // src/index.ts
 import { program } from "commander";
@@ -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")}
 `));
   }
   /**
@@ -1914,7 +1926,7 @@ ${hint}` : "")
       description: "Run project tests and show structured report",
       usage: "/test [command|filter]",
       async execute(args, _ctx) {
-        const { executeTests } = await import("./run-tests-YU52BWHE.js");
+        const { executeTests } = await import("./run-tests-H7IVHUZO.js");
         const argStr = args.join(" ").trim();
         let testArgs = {};
         if (argStr) {
@@ -5436,7 +5448,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 +5542,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-KVHJCPUO.js");
+  const { startWebServer } = await import("./server-4JOL6AJL.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 +5775,7 @@ program.command("hub [topic]").description("Start multi-agent hub (discuss / bra
     }),
     config.get("customProviders")
   );
-  const { startHub } = await import("./hub-QZXQ6JYS.js");
+  const { startHub } = await import("./hub-2MUUWFAZ.js");
   await startHub(
     {
       topic: topic ?? "",

package/dist/{run-tests-YU52BWHE.js → run-tests-H7IVHUZO.js}

@@ -2,7 +2,7 @@
 import {
   executeTests,
   runTestsTool
-} from "./chunk-244SVJXW.js";
+} from "./chunk-KOD3C2CU.js";
 export {
   executeTests,
   runTestsTool

package/dist/{run-tests-QDMBYWZA.js → run-tests-VB4UVV6Q.js}

@@ -1,7 +1,7 @@
 import {
   executeTests,
   runTestsTool
-} from "./chunk-QW2UGW6D.js";
+} from "./chunk-SNUHVNSD.js";
 export {
   executeTests,
   runTestsTool

package/dist/{server-KVHJCPUO.js → server-4JOL6AJL.js}

@@ -18,7 +18,7 @@ import {
   renderDiff,
   runHook,
   setupProxy
-} from "./chunk-ROMSAKP6.js";
+} from "./chunk-2OKRGXVU.js";
 import {
   AuthManager
 } from "./chunk-BYNY5JPB.js";
@@ -32,7 +32,7 @@ import {
   spawnAgentContext,
   truncateOutput,
   undoStack
-} from "./chunk-WIWNSN7U.js";
+} from "./chunk-DMM3XL26.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   AUTHOR,
@@ -49,7 +49,7 @@ import {
   PLUGINS_DIR_NAME,
   SKILLS_DIR_NAME,
   VERSION
-} from "./chunk-244SVJXW.js";
+} from "./chunk-KOD3C2CU.js";
 
 // src/web/server.ts
 import express from "express";
@@ -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;
@@ -1482,7 +1490,7 @@ ${undoResults.map((r) => `  \u2022 ${r}`).join("\n")}` });
       case "test": {
         this.send({ type: "info", message: "\u{1F9EA} Running tests..." });
         try {
-          const { executeTests } = await import("./run-tests-YU52BWHE.js");
+          const { executeTests } = await import("./run-tests-H7IVHUZO.js");
           const argStr = args.join(" ").trim();
           let testArgs = {};
           if (argStr) {
@@ -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-EGJZA6Y4.js → task-orchestrator-USDQ6J6V.js}

@@ -4,10 +4,10 @@ import {
   getDangerLevel,
   googleSearchContext,
   truncateOutput
-} from "./chunk-WIWNSN7U.js";
+} from "./chunk-DMM3XL26.js";
 import {
   SUBAGENT_ALLOWED_TOOLS
-} from "./chunk-244SVJXW.js";
+} from "./chunk-KOD3C2CU.js";
 
 // src/hub/task-orchestrator.ts
 import { createInterface } from "readline";

package/package.json

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