@zhin.js/agent 1.0.2 → 1.0.3

package/lib/discovery/agents.js

@@ -1,7 +1,7 @@
 /**
- * Agent 预设发现（*.agent.md 文件扫描）
+ * Agent 预设发现（分形 agents/<name>/ 目录）
  *
- * 加载顺序与 skills 一致：Workspace > ~/.zhin > data > 插件包
+ * 加载顺序：Workspace > ~/.zhin > data > 插件包 agent/subagents（由 register-agent-surface 处理）
  * 同名先发现者优先
  */
 import * as fs from 'node:fs';
@@ -9,15 +9,74 @@ import * as os from 'node:os';
 import * as path from 'node:path';
 import { Logger } from '@zhin.js/core';
 import { getDataDir } from './utils.js';
+import { discoverWorkspaceFractalAgent, resolvePluginPackageRoot, } from './agent-surface.js';
+import { isAuthoringDefinition } from '../authoring/types.js';
+import { normalizeToolDenylist } from '../authoring/disable-tool.js';
 const KNOWN_AGENT_ROLES = new Set([
     'subtask', 'worker', 'researcher', 'evaluator', 'executor', 'reviewer', 'planner',
 ]);
 const logger = new Logger(null, 'builtin-tools');
-// ============================================================================
-// 发现
-// ============================================================================
+async function importAgentDefinition(agentFile) {
+    try {
+        const url = `file://${path.resolve(agentFile)}?t=${Date.now()}`;
+        const mod = await import(url);
+        const exported = mod.default ?? mod;
+        if (isAuthoringDefinition(exported, 'agent'))
+            return exported;
+    }
+    catch (e) {
+        logger.debug(`Failed to import agent definition ${agentFile}: ${e}`);
+    }
+    return undefined;
+}
+function agentMetaFromFractal(name, agentDir, def, instructionsBody, ownerPlugin) {
+    const description = def?.description;
+    if (!description && !instructionsBody)
+        return null;
+    const agentFile = [path.join(agentDir, 'agent.ts'), path.join(agentDir, 'agent.js')]
+        .find((p) => fs.existsSync(p)) ?? path.join(agentDir, 'agent.ts');
+    const roleRaw = def?.role?.trim();
+    return {
+        name,
+        description: description ?? name,
+        keywords: def?.keywords,
+        tags: def?.tags,
+        toolNames: def?.toolNames,
+        disallowedTools: normalizeToolDenylist(def?.disallowedTools),
+        filePath: agentFile,
+        maxIterations: def?.maxIterations,
+        ownerPlugin,
+        role: roleRaw && KNOWN_AGENT_ROLES.has(roleRaw) ? roleRaw : undefined,
+        contextMode: def?.contextMode,
+    };
+}
+async function discoverFractalAgentsInDir(agentsDir, ownerPlugin) {
+    const agents = [];
+    if (!fs.existsSync(agentsDir))
+        return agents;
+    let entries;
+    try {
+        entries = await fs.promises.readdir(agentsDir, { withFileTypes: true });
+    }
+    catch {
+        return agents;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const agentDir = path.join(agentsDir, entry.name);
+        const fractal = await discoverWorkspaceFractalAgent(agentDir);
+        if (!fractal)
+            continue;
+        const def = fractal.agentDefinition ?? await importAgentDefinition(path.join(agentDir, 'agent.ts'));
+        const meta = agentMetaFromFractal(fractal.name, agentDir, def, fractal.instructionsBody, ownerPlugin);
+        if (meta)
+            agents.push(meta);
+    }
+    return agents;
+}
 /**
- * 扫描 agents/ 目录，发现 *.agent.md 文件
+ * 扫描 agents/ 分形目录，发现 workspace / plugin workspace agents
  */
 export async function discoverWorkspaceAgents(root) {
     const agents = [];
@@ -27,24 +86,16 @@ export async function discoverWorkspaceAgents(root) {
         path.join(os.homedir(), '.zhin', 'agents'),
         path.join(getDataDir(), 'agents'),
     ];
-    // Build dir → pluginName mapping for attribution
     const dirToPlugin = new Map();
     if (root) {
         const addPluginDir = (p) => {
             if (!p?.filePath)
                 return;
-            const dir = path.dirname(p.filePath);
-            const d = path.join(dir, 'agents');
+            const packageRoot = resolvePluginPackageRoot(p.filePath);
+            const d = path.join(packageRoot, 'agents');
             if (!agentDirs.includes(d))
                 agentDirs.push(d);
             dirToPlugin.set(d, p.name);
-            const dirName = path.basename(dir);
-            if (dirName === 'src' || dirName === 'lib') {
-                const d2 = path.join(path.dirname(dir), 'agents');
-                if (!agentDirs.includes(d2))
-                    agentDirs.push(d2);
-                dirToPlugin.set(d2, p.name);
-            }
         };
         addPluginDir(root);
         for (const child of (root.children || [])) {
@@ -52,91 +103,32 @@ export async function discoverWorkspaceAgents(root) {
         }
     }
     for (const agentsDir of agentDirs) {
-        if (!fs.existsSync(agentsDir))
-            continue;
-        let entries;
-        try {
-            entries = await fs.promises.readdir(agentsDir, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
-        for (const entry of entries) {
-            let agentMdPath;
-            if (entry.isFile() && entry.name.endsWith('.agent.md')) {
-                agentMdPath = path.join(agentsDir, entry.name);
-            }
-            else if (entry.isDirectory()) {
-                const nested = path.join(agentsDir, entry.name, `${entry.name}.agent.md`);
-                if (fs.existsSync(nested))
-                    agentMdPath = nested;
-            }
-            if (!agentMdPath)
+        const found = await discoverFractalAgentsInDir(agentsDir, dirToPlugin.get(agentsDir));
+        for (const meta of found) {
+            if (seenNames.has(meta.name)) {
+                logger.debug(`Agent '${meta.name}' 已由先序目录加载，跳过: ${meta.filePath}`);
                 continue;
-            try {
-                const content = await fs.promises.readFile(agentMdPath, 'utf-8');
-                const match = content.match(/^---\s*\n([\s\S]*?)\n---\s*(?:\n|$)/);
-                if (!match) {
-                    logger.debug(`Agent文件 ${agentMdPath} 没有有效的frontmatter格式`);
-                    continue;
-                }
-                let jsYaml;
-                try {
-                    jsYaml = await import('js-yaml');
-                    if (jsYaml.default)
-                        jsYaml = jsYaml.default;
-                }
-                catch (e) {
-                    logger.warn(`Unable to import js-yaml module: ${e}`);
-                    continue;
-                }
-                const metadata = jsYaml.load(match[1]);
-                if (!metadata || !metadata.name || !metadata.description) {
-                    logger.debug(`Agent文件 ${agentMdPath} 缺少必需的 name/description 字段`);
-                    continue;
-                }
-                if (seenNames.has(metadata.name)) {
-                    logger.debug(`Agent '${metadata.name}' 已由先序目录加载，跳过: ${agentMdPath}`);
-                    continue;
-                }
-                seenNames.add(metadata.name);
-                const roleRaw = typeof metadata.role === 'string' ? metadata.role.trim() : undefined;
-                const contextRaw = typeof metadata.contextMode === 'string' ? metadata.contextMode.trim() : undefined;
-                const effortRaw = typeof metadata.effort === 'string' ? metadata.effort.trim() : undefined;
-                const memoryRaw = typeof metadata.memory === 'string' ? metadata.memory.trim() : undefined;
-                const VALID_EFFORT = new Set(['low', 'medium', 'high', 'max']);
-                const VALID_MEMORY = new Set(['user', 'session', 'agent']);
-                agents.push({
-                    name: metadata.name,
-                    description: metadata.description,
-                    keywords: metadata.keywords || [],
-                    tags: metadata.tags || [],
-                    toolNames: Array.isArray(metadata.tools) ? metadata.tools : [],
-                    disallowedTools: Array.isArray(metadata.disallowedTools) ? metadata.disallowedTools : undefined,
-                    filePath: agentMdPath,
-                    model: metadata.model,
-                    provider: metadata.provider,
-                    maxIterations: typeof metadata.maxIterations === 'number' ? metadata.maxIterations : undefined,
-                    ownerPlugin: dirToPlugin.get(agentsDir),
-                    role: roleRaw && KNOWN_AGENT_ROLES.has(roleRaw) ? roleRaw : undefined,
-                    contextMode: contextRaw === 'fork' || contextRaw === 'fresh' ? contextRaw : undefined,
-                    toolAliases: metadata.toolAliases && typeof metadata.toolAliases === 'object' && !Array.isArray(metadata.toolAliases)
-                        ? metadata.toolAliases
-                        : undefined,
-                    effort: effortRaw && VALID_EFFORT.has(effortRaw) ? effortRaw : undefined,
-                    memory: memoryRaw && VALID_MEMORY.has(memoryRaw) ? memoryRaw : undefined,
-                });
-                logger.debug(`Agent发现成功: ${metadata.name}`);
-            }
-            catch (e) {
-                logger.warn(`Failed to parse agent.md in ${agentMdPath}:`, e);
             }
+            seenNames.add(meta.name);
+            agents.push(meta);
+            logger.debug(`Agent发现成功: ${meta.name}`);
         }
     }
     return agents;
 }
-/** 读取 *.agent.md 正文（去掉 frontmatter），供 subagent / route 使用 */
+/** 读取分形 agent instructions.md 正文 */
+export async function loadAgentInstructionsBody(agentDir) {
+    const instructionsPath = path.join(agentDir, 'instructions.md');
+    if (!fs.existsSync(instructionsPath))
+        return '';
+    const content = await fs.promises.readFile(instructionsPath, 'utf-8');
+    return content.trim();
+}
+/** @deprecated 使用 loadAgentInstructionsBody */
 export async function loadAgentMarkdownBody(filePath) {
+    if (filePath.endsWith('agent.ts') || filePath.endsWith('agent.js')) {
+        return loadAgentInstructionsBody(path.dirname(filePath));
+    }
     const content = await fs.promises.readFile(filePath, 'utf-8');
     return content.replace(/^---\s*\n[\s\S]*?\n---\s*(?:\n|$)/, '').trim();
 }

package/lib/discovery/agents.js.map

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

package/lib/discovery/register-agent-surface.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Register discovered plugin agent/ surfaces into AgentOrchestrator and schedules.
+ */
+import { type Plugin, type Tool as CoreTool } from '@zhin.js/core';
+import type { AgentOrchestrator } from '../orchestrator/index.js';
+export interface RegisterAgentSurfaceOptions {
+    connectionsConfig?: Record<string, unknown>;
+    toolService?: {
+        addTool: (tool: CoreTool, pluginName: string) => () => void;
+    } | null;
+}
+export declare function registerPluginAgentSurfaces(orchestrator: AgentOrchestrator, root: Plugin, options?: RegisterAgentSurfaceOptions): Promise<{
+    tools: number;
+    skills: number;
+    schedules: number;
+    connections: number;
+    hooks: number;
+    evals: number;
+    workspaceAgents: number;
+}>;
+export declare function runPluginEvals(root: Plugin): Promise<{
+    id: string;
+    ok: boolean;
+    error?: string;
+}[]>;
+export declare function resetAuthoringRegistrationForTests(): void;
+//# sourceMappingURL=register-agent-surface.d.ts.map

package/lib/discovery/register-agent-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-agent-surface.d.ts","sourceRoot":"","sources":["../../src/discovery/register-agent-surface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAU,KAAK,MAAM,EAAE,KAAK,IAAI,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAgClE,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACtF;AAMD,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,iBAAiB,EAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC,CAiHD;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAqBzG;AAED,wBAAgB,kCAAkC,IAAI,IAAI,CAIzD"}

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

@@ -0,0 +1,155 @@
+/**
+ * Register discovered plugin agent/ surfaces into AgentOrchestrator and schedules.
+ */
+import { Logger } from '@zhin.js/core';
+import { ScheduleEngine, getScheduleEngine, setScheduleEngine } from '@zhin.js/kernel';
+import { bridgeAuthoringConnection, bridgeAuthoringHook, bridgeAuthoringSkill, bridgeAuthoringTool, bridgeAuthoringToolToOrchestratorTool, } from '../authoring/bridge.js';
+import { discoverAllPluginAgentSurfaces, } from './agent-surface.js';
+import { errMsg } from './utils.js';
+import { registerAuthoringStateFromDefinition } from '../state/agent-state-store.js';
+import { registerDynamicResolver } from '../dynamic/dynamic-registry.js';
+const logger = new Logger(null, 'agent-surface-register');
+const registeredScheduleIds = new Set();
+const registeredAuthoringToolNames = new Set();
+const registeredAuthoringSkillNames = new Set();
+function ensureScheduleEngine() {
+    let engine = getScheduleEngine();
+    if (!engine) {
+        engine = new ScheduleEngine();
+        setScheduleEngine(engine);
+    }
+    return engine;
+}
+function flattenSurfaces(surface) {
+    return [surface, ...surface.subagents.flatMap((s) => flattenSurfaces(s))];
+}
+export async function registerPluginAgentSurfaces(orchestrator, root, options = {}) {
+    let toolCount = 0;
+    let skillCount = 0;
+    let scheduleCount = 0;
+    let connectionCount = 0;
+    let hookCount = 0;
+    let evalCount = 0;
+    const surfaces = await discoverAllPluginAgentSurfaces(root);
+    const allBridgedTools = [];
+    for (const surface of surfaces) {
+        for (const flat of flattenSurfaces(surface)) {
+            for (const discovered of flat.tools) {
+                if (registeredAuthoringToolNames.has(discovered.runtimeName))
+                    continue;
+                try {
+                    const bridged = bridgeAuthoringTool(discovered);
+                    const tool = bridgeAuthoringToolToOrchestratorTool(bridged);
+                    orchestrator.addTool(tool, undefined, discovered.pluginName);
+                    options.toolService?.addTool(tool, discovered.pluginName);
+                    allBridgedTools.push(tool);
+                    registeredAuthoringToolNames.add(discovered.runtimeName);
+                    toolCount++;
+                }
+                catch (e) {
+                    logger.warn(`Failed to register tool ${discovered.runtimeName}: ${errMsg(e)}`);
+                }
+            }
+            for (const discovered of flat.schedules) {
+                const scheduleId = discovered.runtimeName;
+                if (registeredScheduleIds.has(scheduleId))
+                    continue;
+                try {
+                    const engine = ensureScheduleEngine();
+                    engine.register(scheduleId, 'solar', async () => { await discovered.definition.execute(); }, { cron: discovered.definition.cron });
+                    registeredScheduleIds.add(scheduleId);
+                    scheduleCount++;
+                }
+                catch (e) {
+                    logger.warn(`Failed to register schedule ${scheduleId}: ${errMsg(e)}`);
+                }
+            }
+            for (const discovered of flat.connections) {
+                const configValue = options.connectionsConfig?.[discovered.slotName]
+                    ?? options.connectionsConfig?.[discovered.runtimeName];
+                if (configValue === undefined) {
+                    logger.debug(`Connection ${discovered.slotName} has no config — skipped`);
+                    continue;
+                }
+                const bridged = bridgeAuthoringConnection(discovered, configValue);
+                if (!bridged.ok) {
+                    logger.warn(bridged.error);
+                    continue;
+                }
+                orchestrator.addMcp(bridged.entry, undefined, discovered.pluginName);
+                connectionCount++;
+            }
+            for (const discovered of flat.hooks) {
+                const hook = bridgeAuthoringHook(discovered);
+                orchestrator.addHook(hook, undefined, discovered.pluginName);
+                hookCount++;
+            }
+            for (const discovered of flat.states) {
+                registerAuthoringStateFromDefinition(discovered.runtimeName, discovered.pluginName, discovered.definition.initial);
+            }
+            if (flat.dynamic) {
+                registerDynamicResolver({
+                    pluginName: flat.dynamic.pluginName,
+                    resolve: flat.dynamic.definition.resolve,
+                });
+            }
+            evalCount += flat.evals.length;
+        }
+    }
+    // Skills after tools so toolNames can resolve
+    for (const surface of surfaces) {
+        for (const flat of flattenSurfaces(surface)) {
+            for (const discovered of flat.skills) {
+                if (registeredAuthoringSkillNames.has(discovered.runtimeName))
+                    continue;
+                try {
+                    const skill = bridgeAuthoringSkill(discovered, allBridgedTools);
+                    orchestrator.addSkill(skill, undefined, discovered.pluginName);
+                    registeredAuthoringSkillNames.add(discovered.runtimeName);
+                    skillCount++;
+                }
+                catch (e) {
+                    logger.warn(`Failed to register skill ${discovered.runtimeName}: ${errMsg(e)}`);
+                }
+            }
+        }
+    }
+    return {
+        tools: toolCount,
+        skills: skillCount,
+        schedules: scheduleCount,
+        connections: connectionCount,
+        hooks: hookCount,
+        evals: evalCount,
+        workspaceAgents: 0,
+    };
+}
+export async function runPluginEvals(root) {
+    const surfaces = await discoverAllPluginAgentSurfaces(root);
+    const results = [];
+    for (const surface of surfaces) {
+        for (const ev of surface.evals) {
+            try {
+                let lastReply = '';
+                const t = {
+                    send: async (_message) => { },
+                    get reply() { return lastReply; },
+                    succeeded: () => { lastReply = 'ok'; },
+                    calledTool: (_name) => ({ soft: () => { } }),
+                };
+                await ev.definition.test(t);
+                results.push({ id: ev.runtimeName, ok: true });
+            }
+            catch (e) {
+                results.push({ id: ev.runtimeName, ok: false, error: errMsg(e) });
+            }
+        }
+    }
+    return results;
+}
+export function resetAuthoringRegistrationForTests() {
+    registeredScheduleIds.clear();
+    registeredAuthoringToolNames.clear();
+    registeredAuthoringSkillNames.clear();
+}
+//# sourceMappingURL=register-agent-surface.js.map

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

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

package/lib/dynamic/dynamic-registry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * defineDynamic turn overrides — tools / instructions (ADR 0039 P2).
+ */
+import type { Message } from '@zhin.js/core';
+import type { AgentTool } from '@zhin.js/ai';
+import type { AuthoringDynamicDefinition } from '../authoring/types.js';
+export interface DynamicResolveContext {
+    sessionId: string;
+    userId: string;
+    adapter: string;
+    commMessage: Message;
+    agentId?: string;
+}
+export interface DynamicResolveResult {
+    additionalInstructions?: string;
+    allowedToolNames?: string[];
+    deniedToolNames?: string[];
+}
+export interface RegisteredDynamicResolver {
+    pluginName: string;
+    resolve: AuthoringDynamicDefinition['resolve'];
+}
+export declare function resetDynamicRegistryForTests(): void;
+export declare function registerDynamicResolver(entry: RegisteredDynamicResolver): void;
+export declare function listDynamicResolvers(): RegisteredDynamicResolver[];
+export interface AppliedDynamicTurnOverrides {
+    tools: AgentTool[];
+    additionalInstructions?: string;
+}
+export declare function applyDynamicTurnOverrides(input: {
+    tools: AgentTool[];
+    ctx: DynamicResolveContext;
+}): Promise<AppliedDynamicTurnOverrides>;
+//# sourceMappingURL=dynamic-registry.d.ts.map

package/lib/dynamic/dynamic-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-registry.d.ts","sourceRoot":"","sources":["../../src/dynamic/dynamic-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAExE,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;CAChD;AAID,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAE9E;AAED,wBAAgB,oBAAoB,IAAI,yBAAyB,EAAE,CAElE;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE;IACL,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,GAAG,EAAE,qBAAqB,CAAC;CAC5B,GACA,OAAO,CAAC,2BAA2B,CAAC,CA0CtC"}

package/lib/dynamic/dynamic-registry.js

@@ -0,0 +1,52 @@
+const resolvers = [];
+export function resetDynamicRegistryForTests() {
+    resolvers.length = 0;
+}
+export function registerDynamicResolver(entry) {
+    resolvers.push(entry);
+}
+export function listDynamicResolvers() {
+    return [...resolvers];
+}
+export async function applyDynamicTurnOverrides(input) {
+    if (!resolvers.length) {
+        return { tools: input.tools };
+    }
+    const merged = {};
+    for (const entry of resolvers) {
+        const patch = await entry.resolve(input.ctx);
+        if (!patch)
+            continue;
+        if (patch.additionalInstructions) {
+            merged.additionalInstructions = merged.additionalInstructions
+                ? `${merged.additionalInstructions}\n\n${patch.additionalInstructions}`
+                : patch.additionalInstructions;
+        }
+        if (patch.allowedToolNames?.length) {
+            merged.allowedToolNames = [...new Set([
+                    ...(merged.allowedToolNames ?? []),
+                    ...patch.allowedToolNames,
+                ])];
+        }
+        if (patch.deniedToolNames?.length) {
+            merged.deniedToolNames = [...new Set([
+                    ...(merged.deniedToolNames ?? []),
+                    ...patch.deniedToolNames,
+                ])];
+        }
+    }
+    let tools = input.tools;
+    if (merged.allowedToolNames?.length) {
+        const allow = new Set(merged.allowedToolNames);
+        tools = tools.filter((t) => allow.has(t.name));
+    }
+    if (merged.deniedToolNames?.length) {
+        const deny = new Set(merged.deniedToolNames);
+        tools = tools.filter((t) => !deny.has(t.name));
+    }
+    return {
+        tools,
+        additionalInstructions: merged.additionalInstructions,
+    };
+}
+//# sourceMappingURL=dynamic-registry.js.map

package/lib/dynamic/dynamic-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-registry.js","sourceRoot":"","sources":["../../src/dynamic/dynamic-registry.ts"],"names":[],"mappings":"AA0BA,MAAM,SAAS,GAAgC,EAAE,CAAC;AAElD,MAAM,UAAU,4BAA4B;IAC1C,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAgC;IACtE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;AACxB,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAGC;IAED,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,IAAI,KAAK,CAAC,sBAAsB,EAAE,CAAC;YACjC,MAAM,CAAC,sBAAsB,GAAG,MAAM,CAAC,sBAAsB;gBAC3D,CAAC,CAAC,GAAG,MAAM,CAAC,sBAAsB,OAAO,KAAK,CAAC,sBAAsB,EAAE;gBACvE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;QACnC,CAAC;QACD,IAAI,KAAK,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;YACnC,MAAM,CAAC,gBAAgB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;oBACpC,GAAG,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC;oBAClC,GAAG,KAAK,CAAC,gBAAgB;iBAC1B,CAAC,CAAC,CAAC;QACN,CAAC;QACD,IAAI,KAAK,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;YAClC,MAAM,CAAC,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;oBACnC,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC;oBACjC,GAAG,KAAK,CAAC,eAAe;iBACzB,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IAED,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACxB,IAAI,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC/C,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC7C,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO;QACL,KAAK;QACL,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;KACtD,CAAC;AACJ,CAAC"}

package/lib/event/agent-stream-bus.d.ts

@@ -0,0 +1,25 @@
+/**
+ * AgentStreamBus — single egress for Eve-aligned wire events (ADR 0041).
+ */
+import type { AgentStreamEvent } from '@zhin.js/ai/agent-stream';
+export interface AgentStreamPublishContext {
+    sessionId?: string;
+    httpSessionId?: string;
+    turnId?: string;
+    agentId?: string;
+}
+export interface AgentStreamSink {
+    readonly name: string;
+    handle(event: AgentStreamEvent, ctx: AgentStreamPublishContext): void | Promise<void>;
+}
+export interface AgentStreamBus {
+    registerSink(sink: AgentStreamSink): () => void;
+    publish(event: AgentStreamEvent, ctx?: AgentStreamPublishContext): Promise<void>;
+}
+export declare class DefaultAgentStreamBus implements AgentStreamBus {
+    private readonly sinks;
+    registerSink(sink: AgentStreamSink): () => void;
+    publish(event: AgentStreamEvent, ctx?: AgentStreamPublishContext): Promise<void>;
+}
+export declare function createAgentStreamBus(): DefaultAgentStreamBus;
+//# sourceMappingURL=agent-stream-bus.d.ts.map

package/lib/event/agent-stream-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-stream-bus.d.ts","sourceRoot":"","sources":["../../src/event/agent-stream-bus.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,yBAAyB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvF;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,IAAI,CAAC;IAChD,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClF;AAED,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAE/C,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,IAAI;IAQzC,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,GAAE,yBAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;CAO3F;AAED,wBAAgB,oBAAoB,IAAI,qBAAqB,CAE5D"}

package/lib/event/agent-stream-bus.js

@@ -0,0 +1,22 @@
+export class DefaultAgentStreamBus {
+    sinks = [];
+    registerSink(sink) {
+        this.sinks.push(sink);
+        return () => {
+            const idx = this.sinks.indexOf(sink);
+            if (idx !== -1)
+                this.sinks.splice(idx, 1);
+        };
+    }
+    async publish(event, ctx = {}) {
+        const stamped = {
+            ...event,
+            timestamp: event.timestamp ?? Date.now(),
+        };
+        await Promise.all(this.sinks.map((sink) => sink.handle(stamped, ctx)));
+    }
+}
+export function createAgentStreamBus() {
+    return new DefaultAgentStreamBus();
+}
+//# sourceMappingURL=agent-stream-bus.js.map

package/lib/event/agent-stream-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-stream-bus.js","sourceRoot":"","sources":["../../src/event/agent-stream-bus.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,qBAAqB;IACf,KAAK,GAAsB,EAAE,CAAC;IAE/C,YAAY,CAAC,IAAqB;QAChC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,GAAG,KAAK,CAAC,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAuB,EAAE,MAAiC,EAAE;QACxE,MAAM,OAAO,GAAqB;YAChC,GAAG,KAAK;YACR,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;SACzC,CAAC;QACF,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,qBAAqB,EAAE,CAAC;AACrC,CAAC"}

package/lib/event/agent-stream-hooks.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bridge AgentStream wire events ↔ HookRegistry subscriptions (ADR 0039 P0).
+ */
+import type { AIHookEvent } from '../orchestrator/types.js';
+import { type AgentStreamEvent, type AgentStreamEventTypeName } from '@zhin.js/ai/agent-stream';
+/** Legacy `type:action` hook keys → Eve-aligned stream event names. */
+export declare const LEGACY_HOOK_STREAM_ALIASES: Readonly<Record<string, AgentStreamEventTypeName>>;
+export declare function isAgentStreamHookEventName(event: string): event is AgentStreamEventTypeName;
+export declare function agentStreamEventToAIHookEvent(streamEvent: AgentStreamEvent, sessionId?: string): AIHookEvent;
+//# sourceMappingURL=agent-stream-hooks.d.ts.map

package/lib/event/agent-stream-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-stream-hooks.d.ts","sourceRoot":"","sources":["../../src/event/agent-stream-hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAwB,KAAK,gBAAgB,EAAE,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEtH,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAMzF,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,wBAAwB,CAE3F;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,gBAAgB,EAC7B,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CAeb"}