@zhin.js/agent 1.0.2 → 1.0.3

package/lib/discovery/agent-surface.js

@@ -0,0 +1,422 @@
+/**
+ * Plugin `agent/` and `evals/` filesystem discovery (Eve-style authoring surface).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { Logger } from '@zhin.js/core';
+import { AUTHORING_KIND, isAuthoringDefinition, } from '../authoring/types.js';
+import { namespaceAuthoringName, slotNameFromDir, slotNameFromFile, } from '../authoring/bridge.js';
+import { errMsg } from './utils.js';
+const logger = new Logger(null, 'agent-surface');
+export function resolvePluginPackageRoot(filePath) {
+    const dir = path.dirname(filePath);
+    const base = path.basename(dir);
+    if (base === 'src' || base === 'lib')
+        return path.dirname(dir);
+    return dir;
+}
+/** Prefer compiled lib/*.js for production plugin packages. */
+export function resolveAuthoringImportPath(packageRoot, sourcePath) {
+    const rel = path.relative(packageRoot, sourcePath);
+    if (rel.startsWith('agent/') || rel.startsWith('evals/')) {
+        const jsRel = rel.replace(/\.ts$/, '.js');
+        const libCandidate = path.join(packageRoot, 'lib', jsRel);
+        if (fs.existsSync(libCandidate))
+            return libCandidate;
+    }
+    return sourcePath;
+}
+export function collectPluginAgentRoots(root) {
+    if (!root)
+        return [];
+    const out = [];
+    const seen = new Set();
+    const push = (p) => {
+        if (!p?.filePath || !p.name)
+            return;
+        const packageRoot = resolvePluginPackageRoot(p.filePath);
+        const key = `${p.name}:${packageRoot}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        out.push({
+            pluginName: p.name,
+            plugin: p,
+            packageRoot,
+            agentDir: path.join(packageRoot, 'agent'),
+            evalsDir: path.join(packageRoot, 'evals'),
+        });
+    };
+    const walk = (p) => {
+        if (!p)
+            return;
+        push(p);
+        for (const child of (p.children || []))
+            walk(child);
+    };
+    walk(root);
+    return out;
+}
+async function importAuthoringModule(filePath, packageRoot) {
+    const resolved = packageRoot
+        ? resolveAuthoringImportPath(packageRoot, path.resolve(filePath))
+        : path.resolve(filePath);
+    if (!fs.existsSync(resolved))
+        return undefined;
+    const url = `file://${resolved}?t=${Date.now()}`;
+    const mod = await import(url);
+    return mod.default ?? mod;
+}
+async function readTextIfExists(filePath) {
+    try {
+        if (!fs.existsSync(filePath))
+            return undefined;
+        return await fs.promises.readFile(filePath, 'utf-8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function listTsFiles(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    try {
+        return fs.readdirSync(dir)
+            .filter((f) => f.endsWith('.ts') || f.endsWith('.js'))
+            .map((f) => path.join(dir, f));
+    }
+    catch {
+        return [];
+    }
+}
+function listSkillFiles(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    try {
+        return fs.readdirSync(dir)
+            .filter((f) => f.endsWith('.md') || f.endsWith('.ts') || f.endsWith('.js'))
+            .map((f) => path.join(dir, f));
+    }
+    catch {
+        return [];
+    }
+}
+function listSubagentDirs(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    try {
+        return fs.readdirSync(dir, { withFileTypes: true })
+            .filter((e) => e.isDirectory())
+            .map((e) => path.join(dir, e.name));
+    }
+    catch {
+        return [];
+    }
+}
+async function loadToolFile(filePath, pluginName, bareNames, packageRoot) {
+    const slotName = slotNameFromFile(filePath);
+    const exported = await importAuthoringModule(filePath, packageRoot);
+    if (!isAuthoringDefinition(exported, 'tool')) {
+        logger.debug(`Skip non-tool authoring file: ${filePath}`);
+        return null;
+    }
+    return {
+        runtimeName: namespaceAuthoringName(pluginName, slotName, bareNames),
+        slotName,
+        pluginName,
+        filePath,
+        definition: exported,
+    };
+}
+async function loadSkillFile(filePath, pluginName, bareNames, packageRoot) {
+    const slotName = slotNameFromFile(filePath);
+    if (filePath.endsWith('.md')) {
+        const content = await readTextIfExists(filePath);
+        if (!content)
+            return null;
+        const body = content.replace(/^---\s*\n[\s\S]*?\n---\s*(?:\n|$)/, '').trim();
+        const fm = content.match(/^---\s*\n([\s\S]*?)\n---/);
+        let description = slotName;
+        let toolNames;
+        let always;
+        if (fm) {
+            try {
+                const jsYaml = await import('js-yaml');
+                const yaml = jsYaml.default ?? jsYaml;
+                const meta = yaml.load(fm[1]);
+                if (typeof meta.description === 'string')
+                    description = meta.description;
+                if (Array.isArray(meta.tools))
+                    toolNames = meta.tools.map(String);
+                if (meta.always === true)
+                    always = true;
+            }
+            catch { /* ignore */ }
+        }
+        const definition = {
+            [AUTHORING_KIND]: 'skill',
+            description,
+            content: body,
+            toolNames,
+            always,
+        };
+        return {
+            runtimeName: namespaceAuthoringName(pluginName, slotName, bareNames),
+            slotName,
+            pluginName,
+            filePath,
+            definition,
+        };
+    }
+    const exported = await importAuthoringModule(filePath, packageRoot);
+    if (!isAuthoringDefinition(exported, 'skill'))
+        return null;
+    return {
+        runtimeName: namespaceAuthoringName(pluginName, slotName, bareNames),
+        slotName,
+        pluginName,
+        filePath,
+        definition: exported,
+    };
+}
+async function loadScheduleFile(filePath, pluginName, bareNames, packageRoot) {
+    const slotName = slotNameFromFile(filePath);
+    const exported = await importAuthoringModule(filePath, packageRoot);
+    if (!isAuthoringDefinition(exported, 'schedule'))
+        return null;
+    return {
+        runtimeName: namespaceAuthoringName(pluginName, slotName, bareNames),
+        slotName,
+        pluginName,
+        filePath,
+        definition: exported,
+    };
+}
+async function loadConnectionFile(filePath, pluginName, bareNames, packageRoot) {
+    const slotName = slotNameFromFile(filePath);
+    const exported = await importAuthoringModule(filePath, packageRoot);
+    if (!isAuthoringDefinition(exported, 'connection'))
+        return null;
+    return {
+        runtimeName: namespaceAuthoringName(pluginName, slotName, bareNames),
+        slotName,
+        pluginName,
+        filePath,
+        definition: exported,
+    };
+}
+async function loadHookFile(filePath, pluginName, bareNames, packageRoot) {
+    const slotName = slotNameFromFile(filePath);
+    const exported = await importAuthoringModule(filePath, packageRoot);
+    if (!isAuthoringDefinition(exported, 'hook'))
+        return null;
+    return {
+        runtimeName: namespaceAuthoringName(pluginName, slotName, bareNames),
+        slotName,
+        pluginName,
+        filePath,
+        definition: exported,
+    };
+}
+async function loadStateFile(filePath, pluginName, bareNames, packageRoot) {
+    const slotName = slotNameFromFile(filePath);
+    const exported = await importAuthoringModule(filePath, packageRoot);
+    if (!isAuthoringDefinition(exported, 'state'))
+        return null;
+    const definition = exported;
+    const stateName = definition.name?.trim() || slotName;
+    return {
+        runtimeName: namespaceAuthoringName(pluginName, stateName, bareNames),
+        slotName: stateName,
+        pluginName,
+        filePath,
+        definition,
+    };
+}
+async function loadEvalFile(filePath, pluginName, packageRoot) {
+    const slotName = slotNameFromFile(filePath).replace(/\.eval$/, '');
+    const exported = await importAuthoringModule(filePath, packageRoot);
+    if (!isAuthoringDefinition(exported, 'eval'))
+        return null;
+    return {
+        runtimeName: `${pluginName}/${slotName}`,
+        slotName,
+        pluginName,
+        filePath,
+        definition: exported,
+    };
+}
+async function scanAgentDir(agentDir, pluginName, bareNames, packageRoot) {
+    const tools = [];
+    const skills = [];
+    const schedules = [];
+    const connections = [];
+    const hooks = [];
+    const states = [];
+    let dynamic;
+    const subagents = [];
+    let agentDefinition;
+    const agentTs = path.join(agentDir, 'agent.ts');
+    const agentJs = path.join(agentDir, 'agent.js');
+    const agentFile = fs.existsSync(agentTs) ? agentTs : (fs.existsSync(agentJs) ? agentJs : undefined);
+    if (agentFile) {
+        const exported = await importAuthoringModule(agentFile, packageRoot);
+        if (isAuthoringDefinition(exported, 'agent')) {
+            agentDefinition = exported;
+        }
+    }
+    const instructionsPath = [path.join(agentDir, 'instructions.md')]
+        .find((p) => fs.existsSync(p));
+    const instructionsBody = instructionsPath ? await readTextIfExists(instructionsPath) : undefined;
+    for (const file of listTsFiles(path.join(agentDir, 'tools'))) {
+        const item = await loadToolFile(file, pluginName, bareNames, packageRoot);
+        if (item)
+            tools.push(item);
+    }
+    for (const file of listSkillFiles(path.join(agentDir, 'skills'))) {
+        const item = await loadSkillFile(file, pluginName, bareNames, packageRoot);
+        if (item)
+            skills.push(item);
+    }
+    for (const file of listTsFiles(path.join(agentDir, 'schedules'))) {
+        const item = await loadScheduleFile(file, pluginName, bareNames, packageRoot);
+        if (item)
+            schedules.push(item);
+    }
+    for (const file of listTsFiles(path.join(agentDir, 'connections'))) {
+        const item = await loadConnectionFile(file, pluginName, bareNames, packageRoot);
+        if (item)
+            connections.push(item);
+    }
+    for (const file of listTsFiles(path.join(agentDir, 'hooks'))) {
+        const item = await loadHookFile(file, pluginName, bareNames, packageRoot);
+        if (item)
+            hooks.push(item);
+    }
+    for (const file of listTsFiles(path.join(agentDir, 'state'))) {
+        const item = await loadStateFile(file, pluginName, bareNames, packageRoot);
+        if (item)
+            states.push(item);
+    }
+    const dynamicTs = path.join(agentDir, 'dynamic.ts');
+    const dynamicJs = path.join(agentDir, 'dynamic.js');
+    const dynamicFile = fs.existsSync(dynamicTs) ? dynamicTs : (fs.existsSync(dynamicJs) ? dynamicJs : undefined);
+    if (dynamicFile) {
+        const exported = await importAuthoringModule(dynamicFile, packageRoot);
+        if (isAuthoringDefinition(exported, 'dynamic')) {
+            dynamic = {
+                pluginName,
+                filePath: dynamicFile,
+                definition: exported,
+            };
+        }
+    }
+    for (const subDir of listSubagentDirs(path.join(agentDir, 'subagents'))) {
+        const subName = slotNameFromDir(subDir);
+        const subSurface = await scanAgentDir(subDir, pluginName, bareNames, packageRoot);
+        subagents.push({
+            pluginName,
+            agentDir: subDir,
+            ...subSurface,
+            evals: [],
+            subagents: subSurface.subagents,
+        });
+        // Subagent name overrides for registry
+        const sub = subagents.at(-1);
+        if (sub) {
+            sub.agentDefinition = {
+                ...(subSurface.agentDefinition ?? { [AUTHORING_KIND]: 'agent' }),
+                description: subSurface.agentDefinition?.description ?? `Subagent ${subName}`,
+            };
+        }
+    }
+    return {
+        agentDefinition,
+        instructionsPath,
+        instructionsBody: instructionsBody?.trim() || undefined,
+        tools,
+        skills,
+        schedules,
+        connections,
+        hooks,
+        states,
+        dynamic,
+        subagents,
+    };
+}
+export async function discoverPluginAgentSurface(roots) {
+    if (!fs.existsSync(roots.agentDir) && !fs.existsSync(roots.evalsDir))
+        return null;
+    try {
+        const scanned = fs.existsSync(roots.agentDir)
+            ? await scanAgentDir(roots.agentDir, roots.pluginName, false, roots.packageRoot)
+            : {
+                tools: [],
+                skills: [],
+                schedules: [],
+                connections: [],
+                hooks: [],
+                states: [],
+                dynamic: undefined,
+                subagents: [],
+            };
+        const evals = [];
+        if (fs.existsSync(roots.evalsDir)) {
+            for (const file of listTsFiles(roots.evalsDir)) {
+                if (!file.includes('.eval.'))
+                    continue;
+                const item = await loadEvalFile(file, roots.pluginName, roots.packageRoot);
+                if (item)
+                    evals.push(item);
+            }
+        }
+        return {
+            pluginName: roots.pluginName,
+            agentDir: roots.agentDir,
+            ...scanned,
+            evals,
+        };
+    }
+    catch (e) {
+        logger.warn(`Failed to discover agent surface for ${roots.pluginName}: ${errMsg(e)}`);
+        return null;
+    }
+}
+export async function discoverAllPluginAgentSurfaces(root) {
+    const surfaces = [];
+    for (const r of collectPluginAgentRoots(root)) {
+        const surface = await discoverPluginAgentSurface(r);
+        if (surface)
+            surfaces.push(surface);
+    }
+    return surfaces;
+}
+export function workspaceAgentsDir() {
+    return path.join(process.cwd(), 'agents');
+}
+export async function discoverWorkspaceFractalAgent(agentDir) {
+    const name = slotNameFromDir(agentDir);
+    if (!fs.existsSync(agentDir))
+        return null;
+    const scanned = await scanAgentDir(agentDir, 'workspace', true);
+    return {
+        name,
+        agentDefinition: scanned.agentDefinition,
+        instructionsBody: scanned.instructionsBody,
+        agentDir,
+    };
+}
+export async function discoverWorkspaceFractalAgents() {
+    const base = workspaceAgentsDir();
+    if (!fs.existsSync(base))
+        return [];
+    const agents = [];
+    for (const dir of listSubagentDirs(base)) {
+        const item = await discoverWorkspaceFractalAgent(dir);
+        if (item?.agentDefinition?.description || item?.instructionsBody) {
+            agents.push(item);
+        }
+    }
+    return agents;
+}
+//# sourceMappingURL=agent-surface.js.map

package/lib/discovery/agent-surface.js.map

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

package/lib/discovery/agents.d.ts

@@ -1,7 +1,7 @@
 /**
- * Agent 预设发现（*.agent.md 文件扫描）
+ * Agent 预设发现（分形 agents/<name>/ 目录）
  *
- * 加载顺序与 skills 一致：Workspace > ~/.zhin > data > 插件包
+ * 加载顺序：Workspace > ~/.zhin > data > 插件包 agent/subagents（由 register-agent-surface 处理）
  * 同名先发现者优先
  */
 import { type Plugin } from '@zhin.js/core';
@@ -12,35 +12,25 @@ export interface AgentMeta {
     description: string;
     keywords?: string[];
     tags?: string[];
-    /** frontmatter 中声明的工具名列表（白名单） */
     toolNames?: string[];
-    /** 工具黑名单 — 与 toolNames 互斥，从可用工具池中排除 */
     disallowedTools?: string[];
-    /** *.agent.md 文件的绝对路径 */
     filePath: string;
-    /** 首选模型名 */
     model?: string;
-    /** 首选 Provider 名 */
     provider?: string;
-    /** 最大工具调用迭代次数 */
     maxIterations?: number;
-    /** 所属插件名（从 agents/ 目录归属推断） */
     ownerPlugin?: string;
-    /** spawn_task 使用的 AgentRole（默认 subtask 或按预设名推断） */
     role?: string;
-    /** fork：注入主会话快照；fresh：空 standalone 上下文 */
     contextMode?: SubagentContextMode;
-    /** 工具名重定向映射 — key 是 LLM 看到的名字，value 是实际执行的工具名 */
     toolAliases?: Record<string, string>;
-    /** effort 级别 — 映射到 maxIterations 和 reasoning_effort */
     effort?: AgentEffortLevel;
-    /** 记忆范围 — 决定 ContextRepository key 隔离粒度 */
     memory?: 'user' | 'session' | 'agent';
 }
 /**
- * 扫描 agents/ 目录，发现 *.agent.md 文件
+ * 扫描 agents/ 分形目录，发现 workspace / plugin workspace agents
  */
 export declare function discoverWorkspaceAgents(root?: Plugin | null): Promise<AgentMeta[]>;
-/** 读取 *.agent.md 正文（去掉 frontmatter），供 subagent / route 使用 */
+/** 读取分形 agent instructions.md 正文 */
+export declare function loadAgentInstructionsBody(agentDir: string): Promise<string>;
+/** @deprecated 使用 loadAgentInstructionsBody */
 export declare function loadAgentMarkdownBody(filePath: string): Promise<string>;
 //# sourceMappingURL=agents.d.ts.map

package/lib/discovery/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/discovery/agents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAGpD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;AAYnD,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAEjE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,uDAAuD;IACvD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;CACvC;AAMD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAiHxF;AAED,6DAA6D;AAC7D,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG7E"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/discovery/agents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AASpD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;AAQnD,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAEjE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;CACvC;AAyED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAsCxF;AAED,oCAAoC;AACpC,wBAAsB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKjF;AAED,+CAA+C;AAC/C,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM7E"}