@zhin.js/runtime 1.1.6 → 1.1.8

package/lib/config-composer.d.ts

@@ -234,6 +234,28 @@ export declare const HOST_CONFIG_SCHEMA: {
                             description: string;
                             "x-descriptionZh": string;
                         };
+                        network: {
+                            type: string;
+                            additionalProperties: boolean;
+                            description: string;
+                            "x-descriptionZh": string;
+                            properties: {
+                                enabled: {
+                                    type: string;
+                                    default: boolean;
+                                    description: string;
+                                    "x-descriptionZh": string;
+                                };
+                                allowedDomains: {
+                                    type: string;
+                                    items: {
+                                        type: string;
+                                    };
+                                    description: string;
+                                    "x-descriptionZh": string;
+                                };
+                            };
+                        };
                         masterShell: {
                             type: string;
                             enum: string[];

package/lib/host-config-schema.json

@@ -152,6 +152,26 @@
                             "description": "Command allowlist preset used outside full mode.",
                             "x-descriptionZh": "非 full 模式使用的命令白名单预设。"
                         },
+                        "network": {
+                            "type": "object",
+                            "additionalProperties": false,
+                            "description": "Network access for IM turns (web_fetch / web_search and networked commands). Off by default; enabled allows HTTPS egress, optionally limited to allowedDomains. When enabled is unset, execPreset: network still enables it for compatibility.",
+                            "x-descriptionZh": "IM 回合的出网权限（web_fetch / web_search 与联网命令）。默认关闭；enabled 开启 HTTPS 出网，allowedDomains 非空时只允许这些域名。未设置 enabled 时兼容旧配置：execPreset: network 视为开启。",
+                            "properties": {
+                                "enabled": {
+                                    "type": "boolean",
+                                    "default": false,
+                                    "description": "Allow HTTPS egress for IM turns.",
+                                    "x-descriptionZh": "是否允许 IM 回合 HTTPS 出网。"
+                                },
+                                "allowedDomains": {
+                                    "type": "array",
+                                    "items": { "type": "string" },
+                                    "description": "When non-empty, only these domains (and their subdomains) are reachable.",
+                                    "x-descriptionZh": "非空时只允许访问这些域名（含子域名）。"
+                                }
+                            }
+                        },
                         "masterShell": {
                             "type": "string",
                             "enum": ["off", "isolated"],
@@ -247,8 +267,8 @@
                                 { "type": "string", "enum": ["segments"] },
                                 { "type": "object" }
                             ],
-                            "description": "Structured final-output mode: false for text, true or segments for canonical message segments, or a custom JSON Schema object.",
-                            "x-descriptionZh": "结构化最终输出：false 表示文本，true 或 segments 表示规范消息段，也可传入自定义 JSON Schema 对象。"
+                            "description": "Final-output mode: defaults to segments for IM conversations; false for text, true or segments for ordered canonical segments, or a custom JSON Schema object. Detached and non-IM turns do not inherit the IM preset.",
+                            "x-descriptionZh": "最终输出默认在 IM 会话使用 segments：false 显式使用文本，true 或 segments 使用有序规范消息段，也可传入自定义 JSON Schema。隔离及非 IM 调用不应用 IM 预设。"
                         },
                         "schedule": {
                             "type": "object",

package/lib/missing-tool-package.d.ts

@@ -0,0 +1,5 @@
+export declare const TOOL_PACKAGE_INSTALL_HINT = "\u7F3A\u5C11\u4F9D\u8D56 @zhin.js/tool\uFF08tools/ \u4E0B\u7684 defineAgentTool \u9700\u8981\u5B83\uFF09\u3002\u8BF7\u8FD0\u884C: pnpm add @zhin.js/tool";
+/** True only for ERR_MODULE_NOT_FOUND naming the `@zhin.js/tool` package root. */
+export declare function isToolPackageMissing(error: unknown): boolean;
+/** Return an error that carries the exact install command when `@zhin.js/tool` is missing. */
+export declare function withToolPackageInstallHint(error: unknown): unknown;

package/lib/missing-tool-package.js

@@ -0,0 +1,21 @@
+const TOOL_PACKAGE = '@zhin.js/tool';
+const TOOL_ROOT_SPECIFIER = /['"]@zhin\.js\/tool['"]/u;
+export const TOOL_PACKAGE_INSTALL_HINT = `缺少依赖 ${TOOL_PACKAGE}（tools/ 下的 defineAgentTool 需要它）。请运行: pnpm add ${TOOL_PACKAGE}`;
+/** True only for ERR_MODULE_NOT_FOUND naming the `@zhin.js/tool` package root. */
+export function isToolPackageMissing(error) {
+    if (!error || typeof error !== 'object')
+        return false;
+    const { code, message } = error;
+    return code === 'ERR_MODULE_NOT_FOUND'
+        && typeof message === 'string'
+        && TOOL_ROOT_SPECIFIER.test(message);
+}
+/** Return an error that carries the exact install command when `@zhin.js/tool` is missing. */
+export function withToolPackageInstallHint(error) {
+    if (!isToolPackageMissing(error))
+        return error;
+    const original = error;
+    const augmented = new Error(`${TOOL_PACKAGE_INSTALL_HINT}\n原始错误: ${original.message}`, { cause: error });
+    augmented.code = original.code;
+    return augmented;
+}

package/lib/native-development-runtime.js

@@ -3,6 +3,7 @@ import { readdirSync, statSync, watch as watchDirectory, } from 'node:fs';
 import { basename, extname, isAbsolute, relative, resolve, sep } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { ModuleDependencyIndex, } from './module-dependency-index.js';
+import { withToolPackageInstallHint } from './missing-tool-package.js';
 import { ensureTypeScriptSpecifierRemap } from './typescript-specifier-remap.js';
 const ignoredDirectories = new Set([
     '.git', '.zhin', 'coverage', 'data', 'dist', 'lib', 'node_modules',
@@ -53,9 +54,14 @@ export class NativeDevelopmentModuleRuntime {
         }
         catch (error) {
             if (!normalized.endsWith('.tsx') || !isUnsupportedTsxError(error) || !this.#tsxLoader) {
-                throw error;
+                throw withToolPackageInstallHint(error);
+            }
+            try {
+                loaded = await this.#tsxLoader.load(url.href, pathToFileURL(`${this.#projectRoot}${sep}`).href);
+            }
+            catch (tsxError) {
+                throw withToolPackageInstallHint(tsxError);
             }
-            loaded = await this.#tsxLoader.load(url.href, pathToFileURL(`${this.#projectRoot}${sep}`).href);
         }
         if (this.#pendingDependencies)
             this.#pendingDependencies.set(normalized, analysis);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/runtime",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "Static Plugin graph, generation transaction and HMR Root runtime for Zhin.js",
   "type": "module",
   "main": "./lib/index.js",
@@ -8,7 +8,6 @@
   "exports": {
     ".": {
       "types": "./lib/index.d.ts",
-      "development": "./src/index.ts",
       "import": "./lib/index.js"
     }
   },
@@ -20,25 +19,25 @@
     "es-module-lexer": "2.3.1",
     "import-meta-resolve": "4.2.0",
     "semver": "7.8.5",
-    "@zhin.js/feature-kit": "1.1.4",
-    "@zhin.js/plugin-runtime": "1.1.13"
+    "@zhin.js/feature-kit": "1.1.5",
+    "@zhin.js/plugin-runtime": "1.1.14"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
     "tsx": "^4.23.1",
     "typescript": "^6.0.3",
-    "@zhin.js/adapter": "1.1.18",
-    "@zhin.js/agent-feature": "1.1.5",
-    "@zhin.js/command": "1.1.6",
-    "@zhin.js/component": "1.1.5",
-    "@zhin.js/handler": "1.1.4",
-    "@zhin.js/layout": "1.1.5",
-    "@zhin.js/mcp-feature": "1.1.5",
-    "@zhin.js/middleware": "1.1.5",
-    "@zhin.js/page": "1.1.5",
-    "@zhin.js/prompt-section": "1.1.4",
-    "@zhin.js/skill": "1.1.5",
-    "@zhin.js/tool": "1.1.5"
+    "@zhin.js/adapter": "1.1.19",
+    "@zhin.js/agent-feature": "1.1.6",
+    "@zhin.js/command": "1.1.7",
+    "@zhin.js/component": "1.1.6",
+    "@zhin.js/handler": "1.1.5",
+    "@zhin.js/layout": "1.1.6",
+    "@zhin.js/mcp-feature": "1.1.6",
+    "@zhin.js/middleware": "1.1.6",
+    "@zhin.js/page": "1.1.6",
+    "@zhin.js/prompt-section": "1.1.5",
+    "@zhin.js/skill": "1.1.6",
+    "@zhin.js/tool": "1.1.6"
   },
   "repository": {
     "type": "git",
@@ -50,7 +49,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "engines": {
-    "node": "^20.19.0 || >=22.12.0"
+    "node": ">=22.19.0"
   },
   "license": "MIT",
   "scripts": {