@zhin.js/prompt-section 1.1.7 → 1.1.9

package/README.md

@@ -7,3 +7,5 @@ immutable capability slot 进入当前 generation。
 Prompt Section 只贡献模型上下文，不授予 Tool、文件、网络、审批或 Workroom 权限。
 `PromptSectionIndex.visible(owner, profile)` 按 Plugin owner 继承链解析，并固定到当前
 generation；HMR 原子发布新 projection，在途 Turn 继续使用旧 snapshot。
+
+平台插件可声明 `platforms` 与 `scopes: ['private' | 'group' | 'channel']`；Agent 在每轮入站按可信平台和场景筛选。未声明不限制；声明的场景列表必须非空且无重复，不使用用户消息正文推断权限。

package/lib/definition.d.ts

@@ -17,6 +17,8 @@ export interface AgentPromptSectionDefinition {
     readonly maxChars?: number;
     readonly profiles: readonly PromptProfile[];
     readonly platforms?: readonly string[];
+    /** IM conversation kinds where this section applies; omitted means unrestricted. */
+    readonly scopes?: readonly ('private' | 'group' | 'channel')[];
     readonly metadata?: Readonly<Record<string, unknown>>;
 }
 export type AgentPromptSectionInput = Omit<AgentPromptSectionDefinition, '$feature' | 'layer' | 'order' | 'retention' | 'profiles'> & Partial<Pick<AgentPromptSectionDefinition, 'layer' | 'order' | 'retention' | 'profiles'>>;

package/lib/definition.js

@@ -36,6 +36,10 @@ export function defineAgentPromptSection(input) {
         throw new TypeError('Prompt Section profiles cannot contain duplicates');
     }
     const platforms = input.platforms?.map((platform) => platform.trim());
+    if (input.scopes !== undefined && (!Array.isArray(input.scopes) || input.scopes.length === 0
+        || input.scopes.some(scope => !SCOPES.has(scope)) || new Set(input.scopes).size !== input.scopes.length)) {
+        throw new TypeError('Prompt Section scopes must contain unique private, group or channel values');
+    }
     if (platforms && (platforms.length === 0
         || platforms.some((platform) => !platform)
         || new Set(platforms).size !== platforms.length)) {
@@ -55,6 +59,7 @@ export function defineAgentPromptSection(input) {
         retention,
         profiles: Object.freeze([...profiles]),
         ...(platforms ? { platforms: Object.freeze(platforms) } : {}),
+        ...(input.scopes ? { scopes: Object.freeze([...input.scopes]) } : {}),
         ...(input.metadata ? { metadata: Object.freeze({ ...input.metadata }) } : {}),
     });
 }
@@ -94,6 +99,7 @@ export function parseAgentPromptSectionDefinition(value) {
         maxChars: definition.maxChars,
         profiles: definition.profiles,
         platforms: definition.platforms,
+        scopes: definition.scopes,
         metadata: definition.metadata,
     });
 }
@@ -102,6 +108,7 @@ const LAYERS = new Set([
 ]);
 const RETENTIONS = new Set(['required', 'preferred', 'opportunistic']);
 const PROFILES = new Set(['interactive', 'schedule']);
+const SCOPES = new Set(['private', 'group', 'channel']);
 function invalidPromptSection() {
     return new TypeError('Prompt Section module must default-export defineAgentPromptSection(...)');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/prompt-section",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "description": "Generation-owned Agent Prompt Section Feature for Zhin Plugin Runtime",
   "type": "module",
   "main": "./lib/index.js",
@@ -16,8 +16,8 @@
     "src"
   ],
   "dependencies": {
-    "@zhin.js/feature-kit": "1.1.7",
-    "@zhin.js/plugin-runtime": "1.1.15"
+    "@zhin.js/plugin-runtime": "1.1.17",
+    "@zhin.js/feature-kit": "1.1.9"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",

package/src/definition.ts

@@ -29,6 +29,8 @@ export interface AgentPromptSectionDefinition {
   readonly maxChars?: number;
   readonly profiles: readonly PromptProfile[];
   readonly platforms?: readonly string[];
+  /** IM conversation kinds where this section applies; omitted means unrestricted. */
+  readonly scopes?: readonly ('private' | 'group' | 'channel')[];
   readonly metadata?: Readonly<Record<string, unknown>>;
 }
 
@@ -79,6 +81,10 @@ export function defineAgentPromptSection(
     throw new TypeError('Prompt Section profiles cannot contain duplicates');
   }
   const platforms = input.platforms?.map((platform) => platform.trim());
+  if (input.scopes !== undefined && (!Array.isArray(input.scopes) || input.scopes.length === 0
+    || input.scopes.some(scope => !SCOPES.has(scope)) || new Set(input.scopes).size !== input.scopes.length)) {
+    throw new TypeError('Prompt Section scopes must contain unique private, group or channel values');
+  }
   if (platforms && (platforms.length === 0
     || platforms.some((platform) => !platform)
     || new Set(platforms).size !== platforms.length)) {
@@ -98,6 +104,7 @@ export function defineAgentPromptSection(
     retention,
     profiles: Object.freeze([...profiles]),
     ...(platforms ? { platforms: Object.freeze(platforms) } : {}),
+    ...(input.scopes ? { scopes: Object.freeze([...input.scopes]) } : {}),
     ...(input.metadata ? { metadata: Object.freeze({ ...input.metadata }) } : {}),
   });
 }
@@ -138,6 +145,7 @@ export function parseAgentPromptSectionDefinition(value: unknown): AgentPromptSe
     maxChars: definition.maxChars,
     profiles: definition.profiles,
     platforms: definition.platforms,
+    scopes: definition.scopes,
     metadata: definition.metadata,
   });
 }
@@ -147,6 +155,7 @@ const LAYERS = new Set<PromptSectionLayer>([
 ]);
 const RETENTIONS = new Set<PromptSectionRetention>(['required', 'preferred', 'opportunistic']);
 const PROFILES = new Set<PromptProfile>(['interactive', 'schedule']);
+const SCOPES = new Set(['private', 'group', 'channel']);
 
 function invalidPromptSection(): TypeError {
   return new TypeError('Prompt Section module must default-export defineAgentPromptSection(...)');