jinzd-ai-cli 0.1.62 → 0.1.63

package/CLAUDE.md

@@ -6,7 +6,14 @@
 带有 **AI 工具调用（Agentic）** 能力，支持执行 bash 命令、读写文件、运行交互式程序、流式生成大文档。
 代理支持（`proxy` 配置字段 + 环境变量），Gemini 完整支持（2.5 Pro/Flash，array items schema 修复）。
 **MCP 协议支持**：可接入外部 MCP 服务器，自动发现并注册工具，无缝融入 agentic 循环。
-设计上可扩展至 Electron/Tauri 桌面 GUI。
+设计上可扩展至 Electron/Tauri 桌面 GUI。
+
+> 当前代码基线（2026-03-12）：
+> - 版本：`v0.1.62`
+> - 默认 REPL 命令：35 个
+> - 当前注册的内置工具：17 个
+> - `stream_to_file` 已正式接入 `ToolRegistry`
+> - `ora` 依赖已从 `package.json` 移除，spinner 使用 `src/repl/renderer.ts` 中的自实现版本
 
 ## 技术栈
 
@@ -41,7 +48,7 @@ src/
 │   ├── session.ts                  # Session（addMessage / clear / compact / fork / toJSON / fromJSON）
 │   └── session-manager.ts          # CRUD + forkSession for ~/.aicli/history/*.json
 ├── repl/
-│   ├── repl.ts                     # 主 REPL 循环（MAX_TOOL_ROUNDS=20，handleChatWithTools agentic loop）
+│   ├── repl.ts                     # 主 REPL 循环（MAX_TOOL_ROUNDS=25，handleChatWithTools agentic loop）
 │   ├── renderer.ts                 # 终端输出（renderStream / renderResponse 均不加前置 \n）
 │   ├── theme.ts                    # 集中式主题系统（dark/light/custom 主题 + 语义色槽 Proxy 导出）
 │   ├── dev-state.ts                # 开发状态交接（provider/model 切换时快照生成、save/load/clear）
@@ -58,7 +65,7 @@ src/
 │   └── manager.ts                  # McpManager（多服务器管理，工具发现与注册，MCP→Tool 转换）
 └── tools/
     ├── types.ts                    # ToolDefinition / ToolCall / ToolResult / DangerLevel / getDangerLevel / isFileWriteTool
-    ├── registry.ts                 # ToolRegistry（注册全部内置工具，共15个）
+    ├── registry.ts                 # ToolRegistry（注册全部内置工具，共17个）
     ├── hooks.ts                    # 工具执行钩子（runHook，shell 命令模板替换 + execSync）
     ├── permissions.ts              # 基于规则的工具权限控制（checkPermission，首匹配规则）
     ├── executor.ts                 # ToolExecutor（确认逻辑 + 批量文件写入预览 + batchConfirm + hooks + permissions）
@@ -71,8 +78,9 @@ src/
         ├── ask-user.ts             # ask_user 工具（agentic 循环中向用户提问，等待文本回答）
         ├── write-todos.ts          # write_todos 工具（任务拆解与进度跟踪，终端实时渲染）
         ├── google-search.ts        # google_search 工具（Google Custom Search API 搜索网页）
-        ├── spawn-agent.ts          # spawn_agent 工具（独立子代理 agentic 循环 + SubAgentExecutor）
-        └── run-tests.ts            # run_tests 工具（自动检测项目类型、运行测试、JUnit XML 解析、结构化报告）
+        ├── stream-to-file.ts       # stream_to_file 工具（流式生成大文档并直接写入文件）
+        ├── spawn-agent.ts          # spawn_agent 工具（独立子代理 agentic 循环 + SubAgentExecutor）
+        └── run-tests.ts            # run_tests 工具（自动检测项目类型、运行测试、JUnit XML 解析、结构化报告）
 ```
 
 ## 常用命令
@@ -120,7 +128,7 @@ npm run pack:all        # 同时打包所有平台
 - **持久记忆**: `~/.aicli/memory.md`（AI 通过 `save_memory` 工具写入，跨会话自动加载）
 - **开发状态快照**: `~/.aicli/dev-state.md`（provider/model 切换时由前一 AI 自动生成，新模型启动后注入 system prompt）
 - **对话历史**: `~/.aicli/history/*.json`
-- **插件目录**: `~/.aicli/plugins/`（暂未实现）
+- **插件目录**: `~/.aicli/plugins/`（已实现，默认关闭，需 `allowPlugins: true` 显式启用）
 
 当前已配置（用户机器）：
 ```json
@@ -210,9 +218,10 @@ AICLI_NO_STREAM          设为 1 禁用流式输出
 | `grep_files` | safe | 正则搜索文件内容 |
 | `glob_files` | safe | 按 glob 模式匹配文件路径 |
 | `run_interactive` | safe | spawn 直连可执行文件 + stdin_lines 依次输入，用于交互式程序（猜数游戏等） |
-| `web_fetch` | safe | 抓取网页内容并转为 Markdown（含私有 IP 防 SSRF） |
-| `save_last_response` | write（需确认） | 保存上一次 AI 回答到文件（tee 流式写盘） |
-| `save_memory` | safe | 将重要信息追加到 `~/.aicli/memory.md`，跨会话持久化，启动时自动注入 system prompt |
+| `web_fetch` | safe | 抓取网页内容并转为 Markdown（含私有 IP 防 SSRF） |
+| `save_last_response` | write（需确认） | 保存上一次 AI 回答到文件（tee 流式写盘） |
+| `stream_to_file` | write（需确认） | 流式生成大文档并直接写入文件，规避长文本被 token 截断 |
+| `save_memory` | safe | 将重要信息追加到 `~/.aicli/memory.md`，跨会话持久化，启动时自动注入 system prompt |
 | `ask_user` | safe | AI 在 agentic 循环中向用户提问，等待文本回答后继续执行 |
 | `write_todos` | safe | AI 拆解复杂任务为子任务列表，终端实时渲染进度（pending/in_progress/completed） |
 | `google_search` | safe | Google Custom Search API 搜索网页，需配置 API Key + Search Engine ID (cx) |
@@ -232,7 +241,7 @@ AICLI_NO_STREAM          设为 1 禁用流式输出
 ```
 用户输入 → rl.pause() + rl.output=null（静默 readline）
   → chatWithTools(messages + toolDefs) → AI 返回 { toolCalls } 或 { content }
-  → 若 toolCalls：executor.executeAll() → buildToolResultMessages() → 下一轮（最多 20 轮）
+  → 若 toolCalls：executor.executeAll() → buildToolResultMessages() → 下一轮（最多 25 轮）
   → 若 content：renderResponse() → rl.output=savedOutput + rl.resume() + showPrompt()
 ```
 

package/dist/{chunk-LPE66KZ3.js → chunk-J6WSEEPI.js}

@@ -82,7 +82,7 @@ var AGENTIC_BEHAVIOR_GUIDELINE = `# \u91CD\u8981\u884C\u4E3A\u51C6\u5219
 var AUTHOR = "\u664B\u6B63\u4E1C";
 var AUTHOR_EMAIL = "zhengdong.jin@gmail.com";
 var DESCRIPTION = "\u8DE8\u5E73\u53F0 REPL \u98CE\u683C AI \u5BF9\u8BDD\u5DE5\u5177\uFF0C\u652F\u6301\u591A Provider \u4E0E Agentic \u5DE5\u5177\u8C03\u7528";
-var REPO_URL = "https://gitee.com/jinzhengdong/ai-courses";
+var REPO_URL = "https://github.com/jinzhengdong/ai-cli";
 
 // src/tools/builtin/run-tests.ts
 var IS_WINDOWS = platform() === "win32";

package/dist/index.js

@@ -30,7 +30,7 @@ import {
   SUBAGENT_MAX_ROUNDS_LIMIT,
   VERSION,
   runTestsTool
-} from "./chunk-LPE66KZ3.js";
+} from "./chunk-J6WSEEPI.js";
 
 // src/index.ts
 import { program } from "commander";
@@ -369,7 +369,7 @@ var BaseProvider = class {
 
 // src/tools/types.ts
 function isFileWriteTool(name) {
-  return name === "write_file" || name === "edit_file";
+  return name === "write_file" || name === "edit_file" || name === "stream_to_file";
 }
 function getDangerLevel(toolName, args) {
   if (toolName.startsWith("mcp__")) return "safe";
@@ -387,6 +387,7 @@ function getDangerLevel(toolName, args) {
   if (toolName === "write_file") return "write";
   if (toolName === "edit_file") return "write";
   if (toolName === "save_last_response") return "write";
+  if (toolName === "stream_to_file") return "write";
   if (toolName === "run_interactive") {
     const exe = String(args["executable"] ?? "").toLowerCase();
     if (/\b(rm|rmdir|del|format|mkfs|Remove-Item)\b/i.test(exe)) return "destructive";
@@ -2325,7 +2326,7 @@ var SessionManager = class {
 // src/repl/repl.ts
 import * as readline from "readline";
 import { existsSync as existsSync19, readFileSync as readFileSync12, readdirSync as readdirSync11, statSync as statSync9 } from "fs";
-import { join as join14, resolve as resolve5, extname as extname4, dirname as dirname6, basename as basename6 } from "path";
+import { join as join14, resolve as resolve5, extname as extname4, dirname as dirname7, basename as basename6 } from "path";
 import chalk9 from "chalk";
 
 // src/repl/renderer.ts
@@ -2527,7 +2528,7 @@ var Renderer = class {
     console.log(theme.dim("    Gemini (Google) \xB7 \u667A\u8C31\u6E05\u8A00 \xB7 \u81EA\u5B9A\u4E49 OpenAI \u517C\u5BB9"));
     console.log(HR);
     const mcpToolCount = mcpInfo?.tools ?? 0;
-    const toolTotal = 16 + pluginCount + mcpToolCount;
+    const toolTotal = 17 + pluginCount + mcpToolCount;
     const extras = [];
     if (pluginCount > 0) extras.push(`${pluginCount} \u4E2A\u63D2\u4EF6`);
     if (mcpToolCount > 0) extras.push(`${mcpToolCount} \u4E2A MCP`);
@@ -2544,6 +2545,7 @@ var Renderer = class {
     console.log(tool("web_fetch", "\u6293\u53D6\u7F51\u9875\u5185\u5BB9\uFF08\u8F6C Markdown\uFF09"));
     console.log(tool("google_search", "Google \u641C\u7D22\uFF08\u9700\u914D\u7F6E API Key + CX\uFF09"));
     console.log(tool("save_last_response", "\u4FDD\u5B58 AI \u56DE\u7B54\u5230\u6587\u4EF6\uFF08tee \u6D41\u5F0F\u5199\u76D8\uFF09"));
+    console.log(tool("stream_to_file", "\u6D41\u5F0F\u751F\u6210\u5927\u6587\u6863\u5E76\u76F4\u63A5\u5199\u5165\u6587\u4EF6\uFF08\u89C4\u907F token \u622A\u65AD\uFF09"));
     console.log(tool("save_memory", "\u5C06\u91CD\u8981\u4FE1\u606F\u6301\u4E45\u5316\u5230 ~/.aicli/memory.md\uFF0C\u8DE8\u4F1A\u8BDD\u81EA\u52A8\u6CE8\u5165"));
     console.log(tool("ask_user", "\u5411\u7528\u6237\u63D0\u95EE\u5E76\u7B49\u5F85\u56DE\u7B54\uFF08agentic \u5FAA\u73AF\u4E2D\u8BF7\u6C42\u6F84\u6E05\uFF09"));
     console.log(tool("write_todos", "\u62C6\u89E3\u4EFB\u52A1\u4E3A\u5B50\u4EFB\u52A1\u5217\u8868\uFF0C\u5B9E\u65F6\u663E\u793A\u8FDB\u5EA6"));
@@ -4597,7 +4599,7 @@ ${hint}` : "")
       description: "Run project tests and show structured report",
       usage: "/test [command|filter]",
       async execute(args, _ctx) {
-        const { executeTests } = await import("./run-tests-YGTHER7T.js");
+        const { executeTests } = await import("./run-tests-77ZV7BUW.js");
         const argStr = args.join(" ").trim();
         let testArgs = {};
         if (argStr) {
@@ -6625,8 +6627,110 @@ var saveLastResponseTool = {
   }
 };
 
+// src/tools/builtin/stream-to-file.ts
+import { createWriteStream as createWriteStream2, mkdirSync as mkdirSync7 } from "fs";
+import { dirname as dirname6 } from "path";
+var streamToFileContext = {
+  provider: null,
+  model: "",
+  systemPrompt: void 0,
+  messages: [],
+  extraMessages: []
+};
+var streamToFileTool = {
+  definition: {
+    name: "stream_to_file",
+    description: `\u5C06\u5927\u578B\u5185\u5BB9\uFF08\u8D85\u8FC7 5KB \u6216 300 \u884C\u7684\u8BD5\u5377\u3001\u62A5\u544A\u7B49\uFF09\u76F4\u63A5\u4EE5\u6D41\u5F0F\u65B9\u5F0F\u751F\u6210\u5E76\u4FDD\u5B58\u5230\u6587\u4EF6\u3002
+\u9002\u7528\u573A\u666F\uFF1A\u5F53\u4F60\u9700\u8981\u751F\u6210\u5B8C\u6574\u7684\u6A21\u8003\u8BD5\u9898\uFF08600-700\u884C\uFF09\u3001\u957F\u7BC7\u62A5\u544A\u7B49\u5927\u6587\u6863\u65F6\uFF0C\u5FC5\u987B\u4F7F\u7528\u6B64\u5DE5\u5177\uFF0C
+\u4E0D\u8981\u5148\u5728\u5BF9\u8BDD\u4E2D\u8F93\u51FA\u518D\u4FDD\u5B58\uFF08\u90A3\u6837\u4F1A\u88AB maxTokens \u622A\u65AD\uFF09\u3002
+\u4F7F\u7528\u65B9\u6CD5\uFF1A\u4F20\u5165\u76EE\u6807\u6587\u4EF6\u8DEF\u5F84\u548C\u751F\u6210\u6307\u4EE4\uFF0C\u5DE5\u5177\u4F1A\u81EA\u52A8\u5411 AI \u53D1\u8D77\u6D41\u5F0F\u8BF7\u6C42\u5E76\u5C06\u5185\u5BB9\u5B9E\u65F6\u5199\u5165\u6587\u4EF6\u3002
+\u6CE8\u610F\uFF1Aprompt \u53C2\u6570\u5E94\u5305\u542B\u5B8C\u6574\u7684\u751F\u6210\u6307\u4EE4\uFF0C\u5982"\u8BF7\u751F\u6210\u4E00\u4EFD\u91D1\u6807\u98CE\u683C\u8FDB\u9636\u96BE\u5EA6\u7684\u5B8C\u6574\u6A21\u8003\u8BD5\u9898\uFF0C\u5305\u542B\u6240\u6709\u9898\u76EE\u548C\u53C2\u8003\u7B54\u6848"\u3002`,
+    parameters: {
+      path: {
+        type: "string",
+        description: "\u4FDD\u5B58\u6587\u4EF6\u7684\u8DEF\u5F84\uFF08\u542B\u6587\u4EF6\u540D\uFF09\uFF0C\u5982 exam_papers/20260221-01-\u6A21\u8003-\u8FDB\u9636.md",
+        required: true
+      },
+      prompt: {
+        type: "string",
+        description: "\u751F\u6210\u5185\u5BB9\u7684\u5B8C\u6574\u6307\u4EE4\uFF08\u4F1A\u643A\u5E26\u5F53\u524D\u5BF9\u8BDD\u5386\u53F2\u4F5C\u4E3A\u4E0A\u4E0B\u6587\uFF09",
+        required: true
+      }
+    },
+    dangerous: false
+  },
+  async execute(args) {
+    const filePath = String(args["path"] ?? "");
+    const prompt = String(args["prompt"] ?? "");
+    if (!filePath) throw new Error("path is required");
+    if (!prompt) throw new Error("prompt is required");
+    const ctx = streamToFileContext;
+    if (!ctx.provider) {
+      throw new Error("stream_to_file: provider not initialized");
+    }
+    const requestMessages = [
+      ...ctx.messages,
+      { role: "user", content: prompt, timestamp: /* @__PURE__ */ new Date() }
+    ];
+    undoStack.push(filePath, `stream_to_file: ${filePath}`);
+    mkdirSync7(dirname6(filePath), { recursive: true });
+    const writeStream = createWriteStream2(filePath, { encoding: "utf-8" });
+    let streamError = null;
+    writeStream.on("error", (err) => {
+      streamError = err;
+    });
+    let totalBytes = 0;
+    let totalChars = 0;
+    const startTime = Date.now();
+    let lastProgressAt = 0;
+    const showProgress = (done) => {
+      const now = Date.now();
+      if (!done && now - lastProgressAt < 200) return;
+      lastProgressAt = now;
+      const elapsed = ((now - startTime) / 1e3).toFixed(1);
+      const kb = (totalBytes / 1024).toFixed(1);
+      process.stdout.write(`\r  \u270D  Writing ${filePath} ... ${kb} KB (${elapsed}s)`);
+    };
+    try {
+      const stream = ctx.provider.chatStream({
+        messages: requestMessages,
+        model: ctx.model,
+        systemPrompt: ctx.systemPrompt,
+        stream: true,
+        temperature: ctx.temperature,
+        maxTokens: 32768,
+        // 大文档专用，放宽到 32K tokens（约 24000 汉字）
+        timeout: ctx.timeout ?? 3e5,
+        ...ctx.extraMessages.length > 0 ? { _extraMessages: ctx.extraMessages } : {}
+      });
+      for await (const chunk of stream) {
+        if (chunk.delta) {
+          const bytes = Buffer.byteLength(chunk.delta, "utf-8");
+          totalBytes += bytes;
+          totalChars += chunk.delta.length;
+          writeStream.write(chunk.delta);
+          showProgress(false);
+        }
+      }
+      if (streamError) throw streamError;
+      await new Promise((resolve6, reject) => {
+        writeStream.end((err) => {
+          if (err) reject(err);
+          else resolve6();
+        });
+      });
+      process.stdout.write("\r\x1B[2K");
+      const lines = totalChars > 0 ? Math.round(totalChars / 40) : 0;
+      return `File saved: ${filePath} (~${lines} lines, ${(totalBytes / 1024).toFixed(1)} KB)`;
+    } catch (err) {
+      writeStream.destroy();
+      throw err;
+    }
+  }
+};
+
 // src/tools/builtin/save-memory.ts
-import { existsSync as existsSync13, statSync as statSync8, appendFileSync as appendFileSync3, mkdirSync as mkdirSync7 } from "fs";
+import { existsSync as existsSync13, statSync as statSync8, appendFileSync as appendFileSync3, mkdirSync as mkdirSync8 } from "fs";
 import { join as join9 } from "path";
 import { homedir as homedir3 } from "os";
 function getMemoryFilePath() {
@@ -6656,7 +6760,7 @@ var saveMemoryTool = {
     const memoryPath = getMemoryFilePath();
     const configDir = join9(homedir3(), CONFIG_DIR_NAME);
     if (!existsSync13(configDir)) {
-      mkdirSync7(configDir, { recursive: true });
+      mkdirSync8(configDir, { recursive: true });
     }
     const timestamp = formatTimestamp();
     const entry = `
@@ -7212,7 +7316,7 @@ var spawnAgentTool = {
 
 // src/tools/registry.ts
 import { pathToFileURL } from "url";
-import { existsSync as existsSync14, mkdirSync as mkdirSync8, readdirSync as readdirSync8 } from "fs";
+import { existsSync as existsSync14, mkdirSync as mkdirSync9, readdirSync as readdirSync8 } from "fs";
 import { join as join10 } from "path";
 var ToolRegistry = class {
   tools = /* @__PURE__ */ new Map();
@@ -7229,6 +7333,7 @@ var ToolRegistry = class {
     this.register(runInteractiveTool);
     this.register(webFetchTool);
     this.register(saveLastResponseTool);
+    this.register(streamToFileTool);
     this.register(saveMemoryTool);
     this.register(askUserTool);
     this.register(writeTodosTool);
@@ -7288,7 +7393,7 @@ var ToolRegistry = class {
   async loadPlugins(pluginsDir, allowPlugins = false) {
     if (!existsSync14(pluginsDir)) {
       try {
-        mkdirSync8(pluginsDir, { recursive: true });
+        mkdirSync9(pluginsDir, { recursive: true });
       } catch {
       }
       return 0;
@@ -7806,15 +7911,6 @@ var ToolExecutor = class {
   }
 };
 
-// src/tools/builtin/stream-to-file.ts
-var streamToFileContext = {
-  provider: null,
-  model: "",
-  systemPrompt: void 0,
-  messages: [],
-  extraMessages: []
-};
-
 // src/repl/setup-wizard.ts
 import { password, select, input } from "@inquirer/prompts";
 var PROVIDERS = [
@@ -8043,7 +8139,7 @@ Managing ${displayName} API Key`);
 };
 
 // src/repl/custom-commands.ts
-import { existsSync as existsSync16, readFileSync as readFileSync10, readdirSync as readdirSync9, mkdirSync as mkdirSync9 } from "fs";
+import { existsSync as existsSync16, readFileSync as readFileSync10, readdirSync as readdirSync9, mkdirSync as mkdirSync10 } from "fs";
 import { join as join11, extname as extname3 } from "path";
 import { execSync as execSync7 } from "child_process";
 
@@ -8152,7 +8248,7 @@ var CustomCommandManager = class {
   loadCommands() {
     this.commands.clear();
     if (!existsSync16(this.commandsDir)) {
-      mkdirSync9(this.commandsDir, { recursive: true });
+      mkdirSync10(this.commandsDir, { recursive: true });
       return 0;
     }
     let count = 0;
@@ -8175,7 +8271,7 @@ var CustomCommandManager = class {
 };
 
 // src/repl/dev-state.ts
-import { existsSync as existsSync17, readFileSync as readFileSync11, writeFileSync as writeFileSync8, unlinkSync as unlinkSync3, mkdirSync as mkdirSync10 } from "fs";
+import { existsSync as existsSync17, readFileSync as readFileSync11, writeFileSync as writeFileSync8, unlinkSync as unlinkSync3, mkdirSync as mkdirSync11 } from "fs";
 import { join as join12 } from "path";
 import { homedir as homedir4 } from "os";
 var DEV_STATE_MAX_CHARS = 6e3;
@@ -8235,7 +8331,7 @@ function getDevStatePath() {
 function saveDevState(content) {
   const configDir = join12(homedir4(), CONFIG_DIR_NAME);
   if (!existsSync17(configDir)) {
-    mkdirSync10(configDir, { recursive: true });
+    mkdirSync11(configDir, { recursive: true });
   }
   let trimmed = content.trim();
   if (trimmed.length > DEV_STATE_MAX_CHARS) {
@@ -8762,7 +8858,7 @@ var McpManager = class {
 };
 
 // src/skills/manager.ts
-import { existsSync as existsSync18, readdirSync as readdirSync10, mkdirSync as mkdirSync11 } from "fs";
+import { existsSync as existsSync18, readdirSync as readdirSync10, mkdirSync as mkdirSync12 } from "fs";
 import { join as join13 } from "path";
 var SKILL_CONTENT_WARN_CHARS = 5e3;
 var SkillManager = class {
@@ -8777,7 +8873,7 @@ var SkillManager = class {
     this.skills.clear();
     if (!existsSync18(this.skillsDir)) {
       try {
-        mkdirSync11(this.skillsDir, { recursive: true });
+        mkdirSync12(this.skillsDir, { recursive: true });
       } catch {
       }
       return 0;
@@ -10061,7 +10157,7 @@ Session '${this.resumeSessionId}' not found.
   completeFilePath(partial) {
     try {
       const normalized = partial.replace(/\\/g, "/");
-      const dir = normalized.includes("/") ? dirname6(normalized) : ".";
+      const dir = normalized.includes("/") ? dirname7(normalized) : ".";
       const prefix = normalized.includes("/") ? basename6(normalized) : normalized;
       const absDir = resolve5(process.cwd(), dir);
       if (!existsSync19(absDir)) return [];

package/dist/{run-tests-YGTHER7T.js → run-tests-77ZV7BUW.js}

@@ -2,7 +2,7 @@
 import {
   executeTests,
   runTestsTool
-} from "./chunk-LPE66KZ3.js";
+} from "./chunk-J6WSEEPI.js";
 export {
   executeTests,
   runTestsTool

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jinzd-ai-cli",
-  "version": "0.1.62",
+  "version": "0.1.63",
   "description": "Cross-platform REPL-style AI CLI with multi-provider support",
   "type": "module",
   "main": "./dist/index.js",
@@ -71,7 +71,6 @@
     "marked": "^15.0.0",
     "marked-terminal": "^7.3.0",
     "openai": "^4.77.0",
-    "ora": "^8.2.0",
     "undici": "^7.22.0",
     "uuid": "^11.0.5",
     "zod": "^3.24.1"