@zhin.js/agent 1.1.22 → 1.1.26

package/lib/skill/skill-instruction-reader.d.ts

@@ -0,0 +1,22 @@
+export type SkillInstructionReadResult = Readonly<{
+    status: 'found';
+    instructions: string;
+} | {
+    status: 'missing';
+    name: string;
+}>;
+export interface SkillInstructionSource {
+    read(name: string): Promise<SkillInstructionReadResult>;
+}
+export interface SkillInstructionReaderOptions {
+    readonly registeredFile?: (name: string) => string | undefined;
+    readonly directories: () => readonly string[];
+    readonly maxChars: number;
+}
+/** Resolves and reads Skill instructions without exposing filesystem lookup rules to callers. */
+export declare class SkillInstructionReader implements SkillInstructionSource {
+    #private;
+    constructor(options: SkillInstructionReaderOptions);
+    read(name: string): Promise<SkillInstructionReadResult>;
+}
+//# sourceMappingURL=skill-instruction-reader.d.ts.map

package/lib/skill/skill-instruction-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-instruction-reader.d.ts","sourceRoot":"","sources":["../../src/skill/skill-instruction-reader.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAC7C;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CACtC,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,iGAAiG;AACjG,qBAAa,sBAAuB,YAAW,sBAAsB;;gBAGvD,OAAO,EAAE,6BAA6B;IAO5C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;CA8B9D"}

package/lib/skill/skill-instruction-reader.js

@@ -0,0 +1,44 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { checkSkillDependencies, extractSkillInstructions } from './skill-instructions.js';
+/** Resolves and reads Skill instructions without exposing filesystem lookup rules to callers. */
+export class SkillInstructionReader {
+    #options;
+    constructor(options) {
+        if (!Number.isInteger(options.maxChars) || options.maxChars <= 0) {
+            throw new TypeError('Skill instruction maxChars must be a positive integer');
+        }
+        this.#options = options;
+    }
+    async read(name) {
+        const canonicalName = name.trim();
+        if (!canonicalName
+            || canonicalName !== name
+            || canonicalName === '.'
+            || canonicalName === '..'
+            || canonicalName.includes('/')
+            || canonicalName.includes('\\')) {
+            throw new TypeError('Skill name must be a non-empty canonical name');
+        }
+        const registered = this.#options.registeredFile?.(canonicalName);
+        if (registered && existsSync(registered))
+            return this.#readFile(canonicalName, registered);
+        for (const directory of this.#options.directories()) {
+            const candidate = join(directory, canonicalName, 'SKILL.md');
+            if (existsSync(candidate))
+                return this.#readFile(canonicalName, candidate);
+        }
+        return Object.freeze({ status: 'missing', name: canonicalName });
+    }
+    async #readFile(name, file) {
+        const content = await readFile(file, 'utf8');
+        const dependencyWarning = await checkSkillDependencies(content);
+        const instructions = extractSkillInstructions(name, content, this.#options.maxChars);
+        return Object.freeze({
+            status: 'found',
+            instructions: dependencyWarning ? `${dependencyWarning}\n\n${instructions}` : instructions,
+        });
+    }
+}
+//# sourceMappingURL=skill-instruction-reader.js.map

package/lib/skill/skill-instruction-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-instruction-reader.js","sourceRoot":"","sources":["../../src/skill/skill-instruction-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAiB3F,iGAAiG;AACjG,MAAM,OAAO,sBAAsB;IACxB,QAAQ,CAAgC;IAEjD,YAAY,OAAsC;QAChD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,SAAS,CAAC,uDAAuD,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,IACE,CAAC,aAAa;eACX,aAAa,KAAK,IAAI;eACtB,aAAa,KAAK,GAAG;eACrB,aAAa,KAAK,IAAI;eACtB,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC;eAC3B,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC/B,CAAC;YACD,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,aAAa,CAAC,CAAC;QACjE,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAC3F,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;YACpD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;YAC7D,IAAI,UAAU,CAAC,SAAS,CAAC;gBAAE,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,IAAY;QACxC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,iBAAiB,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,YAAY,GAAG,wBAAwB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrF,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,OAAO;YACf,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,iBAAiB,OAAO,YAAY,EAAE,CAAC,CAAC,CAAC,YAAY;SAC3F,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/skill/skill-instructions.d.ts

@@ -0,0 +1,5 @@
+/** Return a readable warning when a Skill declares unavailable executable dependencies. */
+export declare function checkSkillDependencies(content: string): Promise<string>;
+/** Extract bounded, action-oriented instructions from a SKILL.md document. */
+export declare function extractSkillInstructions(name: string, content: string, maxBodyLength?: number): string;
+//# sourceMappingURL=skill-instructions.d.ts.map

package/lib/skill/skill-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-instructions.d.ts","sourceRoot":"","sources":["../../src/skill/skill-instructions.ts"],"names":[],"mappings":"AAKA,2FAA2F;AAC3F,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB7E;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,aAAa,SAAO,GACnB,MAAM,CAsBR"}

package/lib/skill/skill-instructions.js

@@ -0,0 +1,78 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/** Return a readable warning when a Skill declares unavailable executable dependencies. */
+export async function checkSkillDependencies(content) {
+    const frontmatter = content.match(/^---\s*\n([\s\S]*?)\n---/u);
+    if (!frontmatter)
+        return '';
+    const module = await import('js-yaml');
+    const yaml = module.default ?? module;
+    const metadata = yaml.load(frontmatter[1]);
+    const dependencies = metadata?.compatibility?.deps;
+    if (!Array.isArray(dependencies))
+        return '';
+    const missing = [];
+    for (const value of dependencies) {
+        if (typeof value !== 'string' || !value.trim())
+            continue;
+        try {
+            await execFileAsync('which', [value]);
+        }
+        catch {
+            missing.push(value);
+        }
+    }
+    return missing.length === 0
+        ? ''
+        : `⚠️ 当前环境缺少以下依赖，请先安装后再使用本技能：${missing.join(', ')}`;
+}
+/** Extract bounded, action-oriented instructions from a SKILL.md document. */
+export function extractSkillInstructions(name, content, maxBodyLength = 4000) {
+    const lines = [`Skill '${name}' loaded. 请立即根据以下指导执行工具调用：`, ''];
+    const frontmatter = content.match(/^---\s*\n([\s\S]*?)\n---/u);
+    if (frontmatter) {
+        const tools = frontmatter[1].match(/tools:\s*\n((?:\s+-\s+.+\n?)+)/u);
+        if (tools)
+            lines.push('## 可用工具', tools[0].trim(), '');
+    }
+    const body = frontmatter && frontmatter.index !== undefined
+        ? content.slice(frontmatter.index + frontmatter[0].length).replace(/^\s+/u, '')
+        : content;
+    const quickActions = body.match(/## (?:快速操作|Quick\s*Actions)[\s\S]*?(?=\n## [^\s]|$)/iu);
+    if (quickActions && maxBodyLength <= 2000) {
+        lines.push(quickActions[0].trim(), '', immediateAction());
+        return lines.join('\n');
+    }
+    const rules = content.match(/## 执行规则[\s\S]*?(?=\n## [^\s]|$)/u);
+    const workflow = content.match(/## (?:Workflow|Instructions|使用说明)[\s\S]*?(?=\n## [^\s]|$)/iu);
+    if (rules)
+        lines.push(rules[0].trim(), '');
+    else if (workflow)
+        lines.push(workflow[0].trim(), '');
+    else
+        appendIntro(lines, body, maxBodyLength);
+    lines.push(immediateAction());
+    return lines.join('\n');
+}
+function appendIntro(lines, body, maxBodyLength) {
+    if (!body.trim())
+        return;
+    const firstHeading = body.match(/\n## [^\s]/u);
+    const intro = firstHeading ? body.slice(0, firstHeading.index).trim() : body.trim();
+    const quickStart = body.match(/## (?:快速开始|Quick\s*Start|Getting\s*Started)[\s\S]*?(?=\n## [^\s]|$)/iu);
+    const authentication = body.match(/## (?:认证|Authentication|Auth)[\s\S]*?(?=\n## [^\s]|$)/iu);
+    lines.push('## 指导', intro, '');
+    if (!quickStart && !authentication && !(intro.length < 200 && body.length > intro.length))
+        return;
+    const detail = [quickStart?.[0].trim(), authentication?.[0].trim()]
+        .filter((value) => Boolean(value))
+        .join('\n\n') || body.slice(intro.length).trim();
+    lines.push(detail.length > maxBodyLength
+        ? `${detail.slice(0, maxBodyLength)}\n...(truncated)`
+        : detail, '');
+}
+function immediateAction() {
+    return '## 立即行动\n根据上面的指导，立即调用工具完成用户请求。禁止重复调用 load_skill，禁止用文本描述代替实际工具调用。';
+}
+//# sourceMappingURL=skill-instructions.js.map

package/lib/skill/skill-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-instructions.js","sourceRoot":"","sources":["../../src/skill/skill-instructions.ts"],"names":[],"mappings":"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"}

package/lib/skill/skill-registry-as-service.d.ts

@@ -5,7 +5,7 @@
  * 使其符合统一的能力接缝（Capability Seam）架构。
  */
 import type { SeamScope } from '../seam/seam-provider.js';
-import type { SkillService, SkillMetadata, SkillInvocationRequest, SkillInvocationResult } from '../seam/skill-service.js';
+import type { SkillService, SkillMetadata } from '../seam/skill-service.js';
 import type { SkillRegistry } from '../resource-hub/skill-registry.js';
 /**
  * 将 SkillRegistry 适配为 SkillService
@@ -21,9 +21,9 @@ export declare class SkillRegistryAsService implements SkillService {
     readonly description = "Zhin skill registry";
     readonly tags: string[];
     constructor(registry: SkillRegistry);
-    catalog(_scope: SeamScope | 'global'): Promise<SkillMetadata[]>;
-    describe(_scope: SeamScope | 'global', skillId: string): Promise<string>;
-    invoke(_scope: SeamScope | 'global', request: SkillInvocationRequest): Promise<SkillInvocationResult>;
-    isAvailable(_scope: SeamScope | 'global', skillId: string): boolean;
+    catalog(scope: SeamScope | 'global'): Promise<SkillMetadata[]>;
+    describe(scope: SeamScope | 'global', skillId: string): Promise<string>;
+    isAvailable(scope: SeamScope | 'global', skillId: string): boolean;
+    private findSkill;
 }
 //# sourceMappingURL=skill-registry-as-service.d.ts.map

package/lib/skill/skill-registry-as-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-registry-as-service.d.ts","sourceRoot":"","sources":["../../src/skill/skill-registry-as-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAEvE;;;;;;;GAOG;AACH,qBAAa,sBAAuB,YAAW,YAAY;IAK7C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,QAAQ,CAAC,WAAW,yBAAyB;IAC7C,QAAQ,CAAC,IAAI,WAA2B;gBAEX,QAAQ,EAAE,aAAa;IAE9C,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAS/D,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxE,MAAM,CACV,MAAM,EAAE,SAAS,GAAG,QAAQ,EAC5B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC;IAYjC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;CAGpE"}
+{"version":3,"file":"skill-registry-as-service.d.ts","sourceRoot":"","sources":["../../src/skill/skill-registry-as-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGvE;;;;;;;GAOG;AACH,qBAAa,sBAAuB,YAAW,YAAY;IAK7C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,QAAQ,CAAC,WAAW,yBAAyB;IAC7C,QAAQ,CAAC,IAAI,WAA2B;gBAEX,QAAQ,EAAE,aAAa;IAE9C,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAY9D,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7E,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlE,OAAO,CAAC,SAAS;CAMlB"}

package/lib/skill/skill-registry-as-service.js

@@ -4,6 +4,7 @@
  * 将现有的 SkillRegistry 和约定目录发现逻辑包装为标准的 SkillService，
  * 使其符合统一的能力接缝（Capability Seam）架构。
  */
+import { readFile } from 'node:fs/promises';
 /**
  * 将 SkillRegistry 适配为 SkillService
  *
@@ -20,34 +21,38 @@ export class SkillRegistryAsService {
     constructor(registry) {
         this.registry = registry;
     }
-    async catalog(_scope) {
-        return this.registry.getAll().map((skill) => ({
+    async catalog(scope) {
+        const skills = scope === 'global'
+            ? this.registry.getAll()
+            : this.registry.getForAgent(String(scope));
+        return skills.map((skill) => ({
             name: skill.name,
             description: skill.description,
             keywords: skill.keywords,
             category: skill.tags?.[0],
         }));
     }
-    async describe(_scope, skillId) {
-        const skill = this.registry.getByName(skillId);
+    async describe(scope, skillId) {
+        const skill = this.findSkill(scope, skillId);
         if (!skill)
             throw new Error(`Skill not found: ${skillId}`);
-        return skill.description;
-    }
-    async invoke(_scope, request) {
+        if (!skill.filePath)
+            return skill.description;
         try {
-            const skill = this.registry.getByName(request.skillId);
-            if (!skill) {
-                return { success: false, error: `Skill not found: ${request.skillId}` };
-            }
-            return { success: true, output: skill };
+            return await readFile(skill.filePath, 'utf8');
         }
-        catch (err) {
-            return { success: false, error: err.message };
+        catch {
+            return skill.description;
         }
     }
-    isAvailable(_scope, skillId) {
-        return this.registry.getByName(skillId) !== undefined;
+    isAvailable(scope, skillId) {
+        return this.findSkill(scope, skillId) !== undefined;
+    }
+    findSkill(scope, skillId) {
+        const skills = scope === 'global'
+            ? this.registry.getAll()
+            : this.registry.getForAgent(String(scope));
+        return skills.find((skill) => skill.name === skillId);
     }
 }
 //# sourceMappingURL=skill-registry-as-service.js.map

package/lib/skill/skill-registry-as-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-registry-as-service.js","sourceRoot":"","sources":["../../src/skill/skill-registry-as-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAsB;IAKJ;IAJpB,EAAE,GAAG,aAAa,CAAC;IACnB,WAAW,GAAG,qBAAqB,CAAC;IACpC,IAAI,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAExC,YAA6B,QAAuB;QAAvB,aAAQ,GAAR,QAAQ,CAAe;IAAG,CAAC;IAExD,KAAK,CAAC,OAAO,CAAC,MAA4B;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;SAC1B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAA4B,EAAE,OAAe;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO,KAAK,CAAC,WAAW,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,MAAM,CACV,MAA4B,EAC5B,OAA+B;QAE/B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACvD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1E,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,WAAW,CAAC,MAA4B,EAAE,OAAe;QACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC;IACxD,CAAC;CACF"}
+{"version":3,"file":"skill-registry-as-service.js","sourceRoot":"","sources":["../../src/skill/skill-registry-as-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAsB;IAKJ;IAJpB,EAAE,GAAG,aAAa,CAAC;IACnB,WAAW,GAAG,qBAAqB,CAAC;IACpC,IAAI,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAExC,YAA6B,QAAuB;QAAvB,aAAQ,GAAR,QAAQ,CAAe;IAAG,CAAC;IAExD,KAAK,CAAC,OAAO,CAAC,KAA2B;QACvC,MAAM,MAAM,GAAG,KAAK,KAAK,QAAQ;YAC/B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YACxB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;SAC1B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAA2B,EAAE,OAAe;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC,WAAW,CAAC;QAC9C,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC,WAAW,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,WAAW,CAAC,KAA2B,EAAE,OAAe;QACtD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,SAAS,CAAC;IACtD,CAAC;IAEO,SAAS,CAAC,KAA2B,EAAE,OAAe;QAC5D,MAAM,MAAM,GAAG,KAAK,KAAK,QAAQ;YAC/B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YACxB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IACxD,CAAC;CACF"}

package/lib/skill/skill-system.js

@@ -1,10 +1,10 @@
-import { sharedToolSelection } from '../resource-hub/tool-selection.js';
+import { normalizeTool } from '../resource-hub/tool-selection.js';
 import { SkillRegistry } from '../resource-hub/skill-registry.js';
 function toBlueprintSkill(skill) {
     return {
         name: skill.name,
         description: skill.description,
-        tools: skill.tools.map((tool) => sharedToolSelection.normalize(tool)),
+        tools: skill.tools.map((tool) => normalizeTool(tool)),
         keywords: skill.keywords ?? [],
         tags: skill.tags ?? [],
         platforms: skill.platforms,
@@ -36,7 +36,7 @@ export class SkillSystem {
     }
     collectTools(context, agentId) {
         const tools = this.registry.collectAllTools(agentId);
-        return tools.map((tool) => sharedToolSelection.normalize(tool, context.message));
+        return tools.map((tool) => normalizeTool(tool, context.message));
     }
     getAlwaysSkills(agentId) {
         if (typeof this.registry.getAlwaysSkills !== 'function')

package/lib/skill/skill-system.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-system.js","sourceRoot":"","sources":["../../src/skill/skill-system.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AASlE,SAAS,gBAAgB,CAAC,KAAuB;IAC/C,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAc,CAAC;QAClF,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,WAAW;IAKH;IAJF,QAAQ,CAAgB;IAEzC,YACE,QAAwB,EACP,UAA6B,EAAE;QAA/B,YAAO,GAAP,OAAO,CAAwB;QAEhD,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,aAAa,EAAE,CAAC;IAClD,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,QAAQ,CAAC,KAAuB,EAAE,KAAwD,EAAE,MAAe;QACzG,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,OAA4B;QAChD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE;YAC/C,UAAU;YACV,QAAQ,EAAE,OAAO,EAAE,QAAQ;SAC5B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACvC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC;YAC9B,KAAK;SACN,CAAC,CAAC,CAAC;IACN,CAAC;IAED,YAAY,CAAC,OAAoB,EAAE,OAAgB;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,eAAe,CAAC,OAAgB;QAC9B,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,KAAK,UAAU;YAAE,OAAO,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAwB;IACxD,OAAO,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,WAAW,EAAE,CAAC"}
+{"version":3,"file":"skill-system.js","sourceRoot":"","sources":["../../src/skill/skill-system.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AASlE,SAAS,gBAAgB,CAAC,KAAuB;IAC/C,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAc,CAAC;QAClE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,WAAW;IAKH;IAJF,QAAQ,CAAgB;IAEzC,YACE,QAAwB,EACP,UAA6B,EAAE;QAA/B,YAAO,GAAP,OAAO,CAAwB;QAEhD,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,aAAa,EAAE,CAAC;IAClD,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,QAAQ,CAAC,KAAuB,EAAE,KAAwD,EAAE,MAAe;QACzG,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,OAA4B;QAChD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE;YAC/C,UAAU;YACV,QAAQ,EAAE,OAAO,EAAE,QAAQ;SAC5B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACvC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC;YAC9B,KAAK;SACN,CAAC,CAAC,CAAC;IACN,CAAC;IAED,YAAY,CAAC,OAAoB,EAAE,OAAgB;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,eAAe,CAAC,OAAgB;QAC9B,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,KAAK,UAAU;YAAE,OAAO,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAwB;IACxD,OAAO,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/lib/{builtin → spawn}/spawn-task-tool.d.ts

@@ -1,11 +1,10 @@
 /**
  * spawn_task — 主会话将耗时任务派给后台子 agent（与 issue #396 对齐）
  */
-import { type Message, type Tool, type ToolParametersSchema, type ToolResult } from '@zhin.js/core';
+import { type Message, type ToolParametersSchema, type ToolResult } from '@zhin.js/core';
 import type { AgentTool } from '@zhin.js/ai';
 import type { SubagentSystem, SubagentOrigin } from '../subagent/index.js';
-import { BuiltinBaseTool } from './builtin-base-tool.js';
-import { type PermissionTaskRules } from '../spawn/permission-task.js';
+import { type PermissionTaskRules } from './permission-task.js';
 export interface SpawnTaskToolOptions {
     /** 经 permission.task 过滤后可展示的子 agent 名 */
     allowedAgents?: string[];
@@ -13,7 +12,7 @@ export interface SpawnTaskToolOptions {
 }
 export declare const SPAWN_TASK_PARAMETERS: ToolParametersSchema;
 export declare function originFromMessage(message: Message): SubagentOrigin;
-export declare class SpawnTaskBuiltinTool extends BuiltinBaseTool {
+export declare class SpawnTaskTool {
     private readonly sessionCommMessage;
     private readonly manager;
     readonly name = "spawn_task";
@@ -21,8 +20,8 @@ export declare class SpawnTaskBuiltinTool extends BuiltinBaseTool {
     readonly parameters: ToolParametersSchema<Record<string, any>>;
     private readonly permissionTaskRules?;
     constructor(sessionCommMessage: Message, manager: SubagentSystem, options?: SpawnTaskToolOptions);
-    toTool(): Tool;
-    run(args: Record<string, unknown>, _commMessage?: Message): Promise<ToolResult>;
+    definition(): AgentTool;
+    execute(args: Record<string, unknown>): Promise<ToolResult>;
 }
 export declare function createSpawnTaskTool(commMessage: Message, manager: SubagentSystem, options?: SpawnTaskToolOptions): AgentTool;
 //# sourceMappingURL=spawn-task-tool.d.ts.map

package/lib/spawn/spawn-task-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-task-tool.d.ts","sourceRoot":"","sources":["../../src/spawn/spawn-task-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3E,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAgBD,eAAO,MAAM,qBAAqB,EAAE,oBAqCnC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAElE;AAUD,qBAAa,aAAa;IAOtB,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,4CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAsB;gBAGxC,kBAAkB,EAAE,OAAO,EAC3B,OAAO,EAAE,cAAc,EACxC,OAAO,CAAC,EAAE,oBAAoB;IAMhC,UAAU,IAAI,SAAS;IAYjB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CA8ClE;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,SAAS,CAMX"}

package/lib/{builtin → spawn}/spawn-task-tool.js

@@ -1,6 +1,5 @@
-import { BuiltinBaseTool } from './builtin-base-tool.js';
 import { getActiveDeferredTurnController } from '../tool-catalog/deferred-turn-controller.js';
-import { assertSpawnAgentAllowed, } from '../spawn/permission-task.js';
+import { assertSpawnAgentAllowed, } from './permission-task.js';
 function buildSpawnTaskDescription(allowedAgents) {
     const lines = [
         'Delegate complex or long-running work to a temporary chat sub-agent. This does not create or update a durable Workroom Task. It runs asynchronously and returns an ephemeral subtask ID; set wait=true to block until completion.',
@@ -11,7 +10,7 @@ function buildSpawnTaskDescription(allowedAgents) {
         lines.push(`Allowed sub-agent types: ${allowedAgents.join(', ')}.`);
     }
     else {
-        lines.push('Allowed sub-agent types are defined in ai.agents and agents/*.agent.md.');
+        lines.push('Allowed sub-agent types are defined in ai.agents and agents/<name>/agent.json.');
     }
     return lines.join(' ');
 }
@@ -28,7 +27,7 @@ export const SPAWN_TASK_PARAMETERS = {
         },
         agent: {
             type: 'string',
-            description: 'Sub-agent name (must exist in ai.agents and agents/<name>.agent.md; default subtask toolset).',
+            description: 'Sub-agent name (must exist in ai.agents and agents/<name>/agent.json; default subtask toolset).',
         },
         wait: {
             type: 'boolean',
@@ -37,7 +36,7 @@ export const SPAWN_TASK_PARAMETERS = {
         context: {
             type: 'string',
             enum: ['fork', 'fresh'],
-            description: 'Context mode: fork injects recent parent session messages; fresh starts empty. Default follows *.agent.md or role.',
+            description: 'Context mode: fork injects recent parent session messages; fresh starts empty. Default follows agent.json or role.',
         },
         tools: {
             type: 'array',
@@ -63,7 +62,7 @@ function parseStringArray(value) {
         .map(item => item.trim());
     return items.length > 0 ? items : undefined;
 }
-export class SpawnTaskBuiltinTool extends BuiltinBaseTool {
+export class SpawnTaskTool {
     sessionCommMessage;
     manager;
     name = 'spawn_task';
@@ -71,20 +70,23 @@ export class SpawnTaskBuiltinTool extends BuiltinBaseTool {
     parameters = SPAWN_TASK_PARAMETERS;
     permissionTaskRules;
     constructor(sessionCommMessage, manager, options) {
-        super();
         this.sessionCommMessage = sessionCommMessage;
         this.manager = manager;
         this.description = buildSpawnTaskDescription(options?.allowedAgents);
         this.permissionTaskRules = options?.permissionTaskRules;
-        this.tags.push('agent', 'async', 'task', '后台', '子任务');
-        this.keywords.push('后台', '异步', '子任务', 'spawn', 'background', '并行', '独立处理');
     }
-    toTool() {
-        const tool = super.toTool();
-        tool.source = 'builtin:context';
-        return tool;
+    definition() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: this.parameters,
+            source: 'builtin:context',
+            tags: ['agent', 'async', 'task', '后台', '子任务'],
+            keywords: ['后台', '异步', '子任务', 'spawn', 'background', '并行', '独立处理'],
+            execute: (args) => this.execute(args),
+        };
     }
-    async run(args, _commMessage) {
+    async execute(args) {
         const task = args.task;
         const label = args.label;
         const agentName = args.agent;
@@ -127,6 +129,6 @@ export class SpawnTaskBuiltinTool extends BuiltinBaseTool {
     }
 }
 export function createSpawnTaskTool(commMessage, manager, options) {
-    return new SpawnTaskBuiltinTool(commMessage, manager, options).toTool();
+    return new SpawnTaskTool(commMessage, manager, options).definition();
 }
 //# sourceMappingURL=spawn-task-tool.js.map

package/lib/spawn/spawn-task-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-task-tool.js","sourceRoot":"","sources":["../../src/spawn/spawn-task-tool.ts"],"names":[],"mappings":"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"}

package/lib/stability/memory-pressure.d.ts

@@ -1,7 +1,8 @@
 /**
- * ADR 0014 P2-1 — 关键全局 Map / RSS 内存压力监控
+ * ADR 0014 P2-1 — 实例级 Agent 状态 / RSS 内存压力监控
  */
 import { Logger } from '@zhin.js/logger';
+import type { AgentCompactionRuntime } from '../memory/compaction-runtime.js';
 export interface StabilityMetricCollector {
     name: string;
     collect: () => number;
@@ -12,18 +13,18 @@ export interface StabilityMetricCollector {
 }
 export interface StabilityMetricSnapshot {
     compactionStates: number;
-    pendingOrchestration: number;
     rssMb?: number;
     [key: string]: number | undefined;
 }
 export interface StabilityMonitorOptions {
+    compactionRuntime: AgentCompactionRuntime;
     intervalMs?: number;
     logger?: Logger;
     collectors?: StabilityMetricCollector[];
     includeRss?: boolean;
 }
-export declare function collectStabilityMetrics(options?: {
+export declare function collectStabilityMetrics(compactionRuntime: AgentCompactionRuntime, options?: {
     includeRss?: boolean;
 }): Promise<StabilityMetricSnapshot>;
-export declare function startStabilityMonitor(options?: StabilityMonitorOptions): () => void;
+export declare function startStabilityMonitor(options: StabilityMonitorOptions): () => void;
 //# sourceMappingURL=memory-pressure.d.ts.map

package/lib/stability/memory-pressure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-pressure.d.ts","sourceRoot":"","sources":["../../src/stability/memory-pressure.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiB,MAAM,EAAa,MAAM,iBAAiB,CAAC;AASnE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAiBD,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACrC,OAAO,CAAC,uBAAuB,CAAC,CAWlC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,IAAI,CA+BvF"}
+{"version":3,"file":"memory-pressure.d.ts","sourceRoot":"","sources":["../../src/stability/memory-pressure.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiB,MAAM,EAAa,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAI9E,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE,sBAAsB,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAWD,wBAAsB,uBAAuB,CAC3C,iBAAiB,EAAE,sBAAsB,EACzC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACrC,OAAO,CAAC,uBAAuB,CAAC,CAUlC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,IAAI,CA+BlF"}

package/lib/stability/memory-pressure.js

@@ -1,38 +1,29 @@
 /**
- * ADR 0014 P2-1 — 关键全局 Map / RSS 内存压力监控
+ * ADR 0014 P2-1 — 实例级 Agent 状态 / RSS 内存压力监控
  */
 import { formatCompact, getLogger } from '@zhin.js/logger';
-import { getCompactionStateCount, evictCompactionStatesIfOverPressure } from '../memory/compaction-runtime.js';
-import { getPendingOrchestrationCount, evictPendingOrchestrationIfOverPressure, } from '../security/owner-approve-always-store.js';
 const defaultLogger = getLogger('StabilityMonitor');
-const DEFAULT_COLLECTORS = [
-    {
-        name: 'compactionStates',
-        collect: getCompactionStateCount,
-        threshold: 4000,
-        evict: evictCompactionStatesIfOverPressure,
-    },
-    {
-        name: 'pendingOrchestration',
-        collect: getPendingOrchestrationCount,
-        threshold: 100,
-        evict: evictPendingOrchestrationIfOverPressure,
-    },
-];
-export async function collectStabilityMetrics(options = {}) {
+function defaultCollectors(compactionRuntime) {
+    return [{
+            name: 'compactionStates',
+            collect: () => compactionRuntime.stateCount,
+            threshold: 4000,
+            evict: () => compactionRuntime.evictIfOverPressure(),
+        }];
+}
+export async function collectStabilityMetrics(compactionRuntime, options = {}) {
     const snapshot = {
-        compactionStates: getCompactionStateCount(),
-        pendingOrchestration: getPendingOrchestrationCount(),
+        compactionStates: compactionRuntime.stateCount,
     };
     if (options.includeRss !== false && typeof process.memoryUsage === 'function') {
         snapshot.rssMb = Math.round(process.memoryUsage().rss / (1024 * 1024));
     }
     return snapshot;
 }
-export function startStabilityMonitor(options = {}) {
+export function startStabilityMonitor(options) {
     const log = options.logger ?? defaultLogger;
     const intervalMs = options.intervalMs ?? 60_000;
-    const collectors = options.collectors ?? DEFAULT_COLLECTORS;
+    const collectors = options.collectors ?? defaultCollectors(options.compactionRuntime);
     const includeRss = options.includeRss !== false;
     const timer = setInterval(() => {
         void (async () => {
@@ -48,7 +39,7 @@ export function startStabilityMonitor(options = {}) {
                     }
                 }
                 if (includeRss) {
-                    const metrics = await collectStabilityMetrics({ includeRss: true });
+                    const metrics = await collectStabilityMetrics(options.compactionRuntime, { includeRss: true });
                     log.debug(formatCompact({ op: 'stability', ...metrics }));
                 }
             }

package/lib/stability/memory-pressure.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-pressure.js","sourceRoot":"","sources":["../../src/stability/memory-pressure.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-pressure.js","sourceRoot":"","sources":["../../src/stability/memory-pressure.ts"],"names":[],"mappings":"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"}

package/lib/standalone/standalone-tool-catalog.d.ts

@@ -0,0 +1,13 @@
+import type { AgentTool } from '@zhin.js/ai';
+export interface ResolveStandaloneToolsOptions {
+    readonly includeRegisteredTools: boolean;
+    readonly explicitTools: readonly AgentTool[];
+}
+/** Owns the explicit Tool namespace used by programmatic standalone Agents. */
+export declare class StandaloneToolCatalog {
+    #private;
+    register(tool: AgentTool): () => void;
+    snapshot(): readonly AgentTool[];
+    resolve(options: ResolveStandaloneToolsOptions): AgentTool[];
+}
+//# sourceMappingURL=standalone-tool-catalog.d.ts.map

package/lib/standalone/standalone-tool-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone-tool-catalog.d.ts","sourceRoot":"","sources":["../../src/standalone/standalone-tool-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,SAAS,SAAS,EAAE,CAAC;CAC9C;AAED,+EAA+E;AAC/E,qBAAa,qBAAqB;;IAGhC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,IAAI;IAcrC,QAAQ,IAAI,SAAS,SAAS,EAAE;IAIhC,OAAO,CAAC,OAAO,EAAE,6BAA6B,GAAG,SAAS,EAAE;CAe7D"}