@ai-zen/agents-sdk 1.0.0-alpha.1 → 1.0.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [1.0.0-alpha.3] - 2026-10-03
+
+### 🔧 Fixed
+
+- **`generateImage` `model` parameter description no longer points at a host-CLI command** — the description used to read "配置中的图片模型可通过 'aiz config show' 查看" (the configured image models can be viewed via `aiz config show`). Since tool descriptions ship inside every request's `tools` payload, that hint propagated into **every layer** of the agent stack: the model would `exec("aiz config show")`, but the CLI resolves a bare `aiz config show` invocation as stdio mode with the instruction `config show` — i.e. a **brand-new agent** — whose own `generateImage` description repeats the very same hint, producing a self-referential recursion that keeps spawning nested agents. The parameter now reads "若指定的模型不存在，本工具会返回当前可用的模型列表" (if the specified model does not exist, this tool returns the list of currently available models), which matches the actual `!imageModel` branch in `call()` and stops the model from shelling out to the host CLI.
+
+### 📄 Docs
+
+- Current-version references in `docs/zh` and `docs/en` updated to `1.0.0-alpha.3`.
+
+## [1.0.0-alpha.2] - 2026-10-03
+
+### 🚀 New Features
+
+- **`chrome-devtools` added to the factory default MCP config** — `DEFAULT_MCP_CONFIG` now ships two servers instead of one: alongside `socket-pty`, a freshly released `~/.ai-zen/mcp.json` includes `chrome-devtools` (`npx -y chrome-devtools-mcp@latest`, Google's official `chrome-devtools-mcp`), so browser debugging and automation work out of the box — page navigation, performance traces, network and console inspection, screenshots. Existing `mcp.json` files are still never overwritten, so user configurations (including custom flags such as `--executablePath`) are untouched. Defined in `packages/sdk/src/config/constants.ts`, released by `ConfigManager.ensureDefaultMcpConfig()`.
+
+### ✅ Tests
+
+- `ConfigManager.bootstrap.test.ts` now asserts the factory-default `mcp.json` carries both `socket-pty` and `chrome-devtools` (the latter resolved from the `chrome-devtools-mcp` package via `npx`), covering both the `bootstrap()` and `ensureDefaultMcpConfig()` paths.
+
+### 📄 Docs
+
+- Factory-default MCP descriptions in `docs/zh/mcp.md` / `docs/en/mcp.md` and `docs/zh/sdk.md` / `docs/en/sdk.md` now list both `socket-pty` and `chrome-devtools`.
+- Current-version references in `docs/zh` and `docs/en` updated to `1.0.0-alpha.2`.
+
 ## [1.0.0-alpha.1] - 2026-10-03
 
 ### 💥 Breaking Changes

package/dist/config/ConfigManager.d.ts

@@ -55,7 +55,7 @@ export declare class ConfigManager {
     /** mcp.json 路径：{basePath}/mcp.json */
     get mcpPath(): string;
     /**
-     * 确保 basePath/mcp.json 存在。不存在时写入出厂默认 MCP 配置（含 socket-pty）。
+     * 确保 basePath/mcp.json 存在。不存在时写入出厂默认 MCP 配置（含 socket-pty 与 chrome-devtools）。
      * 已有文件不被覆盖，尊重用户已配置的 MCP 服务器。
      * @returns 返回当前生效的 MCP 配置原始内容
      */

package/dist/config/ConfigManager.js

@@ -188,7 +188,7 @@ export class ConfigManager {
         return join(this.basePath, "mcp.json");
     }
     /**
-     * 确保 basePath/mcp.json 存在。不存在时写入出厂默认 MCP 配置（含 socket-pty）。
+     * 确保 basePath/mcp.json 存在。不存在时写入出厂默认 MCP 配置（含 socket-pty 与 chrome-devtools）。
      * 已有文件不被覆盖，尊重用户已配置的 MCP 服务器。
      * @returns 返回当前生效的 MCP 配置原始内容
      */

package/dist/config/constants.d.ts

@@ -11,7 +11,9 @@ export declare const DEFAULT_SUBAGENT_DEFINITION: Omit<AgentDefinition, "created
 export declare const DEFAULT_APP_CONFIG: AppConfig;
 /**
  * SDK 出厂默认 MCP 服务器配置（mcp.json 内容，业界标准格式）。
- * 首次初始化时释放到 ~/.ai-zen/mcp.json，让用户开箱即用 socket-pty 终端能力。
+ * 首次初始化时释放到 ~/.ai-zen/mcp.json，让用户开箱即用：
+ *   - socket-pty       伪终端（pty）能力
+ *   - chrome-devtools  Chrome DevTools 浏览器调试/自动化能力（Google 官方 chrome-devtools-mcp）
  *
  * 若文件已存在则不覆盖（尊重用户已有配置）。
  */

package/dist/config/constants.js

@@ -214,11 +214,13 @@ export const DEFAULT_APP_CONFIG = {
     maxToolOutput: 32_768,
 };
 // ---------------------------------------------------------------------------
-// 默认 MCP 配置（socket-pty 终端 MCP）
+// 默认 MCP 配置（socket-pty 终端 MCP + chrome-devtools 浏览器调试 MCP）
 // ---------------------------------------------------------------------------
 /**
  * SDK 出厂默认 MCP 服务器配置（mcp.json 内容，业界标准格式）。
- * 首次初始化时释放到 ~/.ai-zen/mcp.json，让用户开箱即用 socket-pty 终端能力。
+ * 首次初始化时释放到 ~/.ai-zen/mcp.json，让用户开箱即用：
+ *   - socket-pty       伪终端（pty）能力
+ *   - chrome-devtools  Chrome DevTools 浏览器调试/自动化能力（Google 官方 chrome-devtools-mcp）
  *
  * 若文件已存在则不覆盖（尊重用户已有配置）。
  */
@@ -230,6 +232,12 @@ export const DEFAULT_MCP_CONFIG = {
             args: ["-y", "@ai-zen/socket-pty", "mcp"],
             description: "可托管的伪终端（pty）：spawn/read/wait/write/resize/status/kill",
         },
+        "chrome-devtools": {
+            type: "stdio",
+            command: "npx",
+            args: ["-y", "chrome-devtools-mcp@latest"],
+            description: "Chrome DevTools 浏览器调试与自动化（Google chrome-devtools-mcp）：页面导航、性能追踪、网络与控制台检查、截图等",
+        },
     },
 };
 // ---------------------------------------------------------------------------

package/dist/scope/plugins/builtin/GenerateImageTool.js

@@ -25,7 +25,7 @@ export class GenerateImageTool extends SdkCallbackTool {
                 },
                 model: {
                     type: "string",
-                    description: "图片模型 ID，不指定则使用配置中的默认图片模型。配置中的图片模型可通过 'aiz config show' 查看。",
+                    description: "图片模型 ID，不指定则使用配置中的默认图片模型；若指定的模型不存在，本工具会返回当前可用的模型列表。",
                 },
                 size: {
                     type: "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-zen/agents-sdk",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.3",
   "description": "AI-Zen Agents SDK — shared business logic for CLI and Desktop",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",