@zhin.js/runtime 1.0.7 → 1.0.9

package/lib/config-composer.js

@@ -119,12 +119,12 @@ export class ConfigComposer {
 const FRAMEWORK_ROLE_SCHEMA = Object.freeze({
     master: Object.freeze({
         type: ['string', 'number'],
-        description: 'Endpoint owner (framework-level master role)',
+        description: 'Framework master user id (AI/tool privileges; not group owner/admin)',
     }),
     trusted: Object.freeze({
         type: 'array',
         items: Object.freeze({ type: ['string', 'number'] }),
-        description: 'Trusted user ID list (framework-level trusted role)',
+        description: 'Framework trusted user id list (weaker than master)',
     }),
 });
 function hasArrayEndpoints(props) {
@@ -133,18 +133,50 @@ function hasArrayEndpoints(props) {
         return false;
     return ep.type === 'array';
 }
+/** 顶层 + endpoints[].properties 注入 master/trusted（已声明则不覆盖） */
+function injectFrameworkRoleSchema(properties) {
+    for (const [key, schema] of Object.entries(FRAMEWORK_ROLE_SCHEMA)) {
+        if (!Object.hasOwn(properties, key)) {
+            properties[key] = schema;
+        }
+    }
+    if (!hasArrayEndpoints(properties))
+        return;
+    const ep = properties.endpoints;
+    const items = ep.items;
+    if (!items || typeof items !== 'object' || Array.isArray(items))
+        return;
+    const itemsObj = items;
+    const rawProps = itemsObj.properties;
+    const itemProps = rawProps && typeof rawProps === 'object' && !Array.isArray(rawProps)
+        ? { ...rawProps }
+        : {};
+    let changed = false;
+    for (const [key, schema] of Object.entries(FRAMEWORK_ROLE_SCHEMA)) {
+        if (!Object.hasOwn(itemProps, key)) {
+            itemProps[key] = schema;
+            changed = true;
+        }
+    }
+    if (!changed)
+        return;
+    properties.endpoints = Object.freeze({
+        ...ep,
+        items: Object.freeze({
+            ...itemsObj,
+            properties: Object.freeze(itemProps),
+        }),
+    });
+}
 async function composeNode(node, ownSchemas) {
     const own = await readOwnSchema(node);
     ownSchemas.set(node.id, own);
     const properties = { ...schemaProperties(own) };
     // Adapter plugins (schemas declaring array-typed `endpoints`) get
-    // framework-level `master` / `trusted` injected when not already declared.
+    // framework-level `master` / `trusted` injected when not already declared
+    // (top-level and endpoints[].properties).
     if (hasArrayEndpoints(properties)) {
-        for (const [key, schema] of Object.entries(FRAMEWORK_ROLE_SCHEMA)) {
-            if (!Object.hasOwn(properties, key)) {
-                properties[key] = schema;
-            }
-        }
+        injectFrameworkRoleSchema(properties);
     }
     for (const child of node.children) {
         if (Object.hasOwn(properties, child.instanceKey)) {

package/lib/native-development-runtime.js

@@ -2,7 +2,7 @@ import { readdirSync, statSync, watch as watchDirectory, } from 'node:fs';
 import { extname, isAbsolute, relative, resolve, sep } from 'node:path';
 import { pathToFileURL } from 'node:url';
 const ignoredDirectories = new Set([
-    '.git', '.zhin', 'coverage', 'dist', 'lib', 'node_modules',
+    '.git', '.zhin', 'coverage', 'data', 'dist', 'lib', 'node_modules',
 ]);
 const watchedExtensions = new Set([
     '.cjs', '.js', '.json', '.md', '.mjs', '.ts', '.tsx', '.yaml', '.yml',

package/lib/plugin-scope-assembler.d.ts

@@ -12,6 +12,12 @@ export interface RootResourceContext {
     readonly lifecycle: DisposeStack;
     readonly handoff: GenerationHandoffRegistry;
     readonly config: PrimaryConfig;
+    /**
+     * Adds a root-owned capability to this shadow generation. The definition is
+     * validated and projected with convention/setup capabilities; it is never
+     * visible before the generation commits.
+     */
+    addFeature<TDefinition>(feature: FeatureId | string, localName: string, definition: TDefinition): void;
 }
 export type RootResourceInstaller = (context: RootResourceContext) => void | Promise<void>;
 export interface PluginAssemblySeed {

package/lib/plugin-scope-assembler.js

@@ -59,6 +59,7 @@ export class PluginScopeAssembler {
         // Every owner shadows the inherited EnvStore with its exact overlay view.
         const environment = this.#envStores.create(node.id);
         scope.provide(envStoreToken, environment);
+        const register = (feature, localName, capabilityDefinition) => this.#registerSetupCapability(node, manifest, feature, localName, capabilityDefinition);
         if (!node.parent) {
             scope.provide(runtimeEnvironmentToken, this.environment);
             const config = createPrimaryConfig(this.primaryConfigDocument, environment);
@@ -68,6 +69,7 @@ export class PluginScopeAssembler {
                 lifecycle: scope.disposers,
                 handoff: this.#handoffs,
                 config,
+                addFeature: register,
             });
         }
         if (node.parent)
@@ -123,21 +125,6 @@ export class PluginScopeAssembler {
                     throw new Error(`Missing resource ${token.id} for Plugin ${node.id}`);
                 }
             }
-            const register = (feature, localName, capabilityDefinition) => {
-                const featureName = featureId(String(feature));
-                const id = capabilityId(node.id, featureName, localName);
-                if (this.#setupCapabilities.has(id)) {
-                    throw new Error(`Duplicate setup Capability: ${id}`);
-                }
-                this.#setupCapabilities.set(id, Object.freeze({
-                    id,
-                    owner: node.id,
-                    feature: featureName,
-                    localName,
-                    source: resolve(node.package.root, manifest.entry),
-                    definition: capabilityDefinition,
-                }));
-            };
             const setupContext = {
                 plugin,
                 config: view,
@@ -169,6 +156,21 @@ export class PluginScopeAssembler {
         for (const child of node.children)
             await this.setupTree(child);
     }
+    #registerSetupCapability(node, manifest, feature, localName, definition) {
+        const featureName = featureId(String(feature));
+        const id = capabilityId(node.id, featureName, localName);
+        if (this.#setupCapabilities.has(id)) {
+            throw new Error(`Duplicate setup Capability: ${id}`);
+        }
+        this.#setupCapabilities.set(id, Object.freeze({
+            id,
+            owner: node.id,
+            feature: featureName,
+            localName,
+            source: resolve(node.package.root, manifest.entry),
+            definition,
+        }));
+    }
     synchronizeTree(node) {
         const current = this.tree.get(node.id);
         if (!current)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/runtime",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Static Plugin graph, generation transaction and HMR Root runtime for Zhin.js",
   "type": "module",
   "main": "./lib/index.js",
@@ -18,22 +18,22 @@
   "dependencies": {
     "ajv": "8.18.0",
     "semver": "7.8.5",
-    "@zhin.js/feature-kit": "1.0.6",
-    "@zhin.js/plugin-runtime": "1.1.3"
+    "@zhin.js/feature-kit": "1.0.8",
+    "@zhin.js/plugin-runtime": "1.1.5"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
     "typescript": "^6.0.3",
-    "@zhin.js/adapter": "1.1.5",
-    "@zhin.js/agent-feature": "1.0.6",
-    "@zhin.js/command": "1.0.7",
-    "@zhin.js/component": "1.0.6",
-    "@zhin.js/layout": "1.0.6",
-    "@zhin.js/mcp-feature": "1.0.6",
-    "@zhin.js/middleware": "1.0.6",
-    "@zhin.js/page": "1.0.6",
-    "@zhin.js/skill": "1.0.6",
-    "@zhin.js/tool": "1.0.6"
+    "@zhin.js/adapter": "1.1.7",
+    "@zhin.js/agent-feature": "1.0.8",
+    "@zhin.js/command": "1.0.9",
+    "@zhin.js/component": "1.0.8",
+    "@zhin.js/layout": "1.0.8",
+    "@zhin.js/mcp-feature": "1.0.8",
+    "@zhin.js/middleware": "1.0.8",
+    "@zhin.js/page": "1.0.8",
+    "@zhin.js/skill": "1.0.8",
+    "@zhin.js/tool": "1.0.8"
   },
   "repository": {
     "type": "git",