hyacinth-ai 0.9.6

package/dist/hot-reload/agent-watcher.d.ts

@@ -0,0 +1,24 @@
+import fs from 'node:fs';
+import type { AgentRegistry } from '../agents/registry.js';
+import type { LayeredContextComposer } from '../context/composer.js';
+interface AgentWatcherDeps {
+    agentRegistry: AgentRegistry;
+    contextComposer: LayeredContextComposer;
+    cwd: string;
+    debounceMs: number;
+}
+/**
+ * 监听 agents.json 配置文件变化，自动重载 Agent 定义。
+ *
+ * 监听路径（按优先级）：
+ *   1. process.env.AGENTS_CONFIG_PATH
+ *   2. <cwd>/.agent/agents.json
+ *   3. ~/.agent/agents.json
+ *
+ * 任一文件变化时，debounce 后：
+ *   - 重新加载配置
+ *   - 对比新旧列表，增量注册/注销/更新
+ */
+export declare function watchAgentsJson(deps: AgentWatcherDeps): fs.FSWatcher[];
+export {};
+//# sourceMappingURL=agent-watcher.d.ts.map

package/dist/hot-reload/agent-watcher.js

@@ -0,0 +1,175 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { loadAgentConfigs } from '../agents/config-loader.js';
+import { createLogger } from '../logging/logger.js';
+/**
+ * 判断两个 AgentDefinition 的配置是否相同（忽略 instanceId 等运行时字段）。
+ */
+function isSameConfig(a, b) {
+    return (a.name === b.name &&
+        a.description === b.description &&
+        a.systemPrompt === b.systemPrompt &&
+        a.maxTurns === b.maxTurns &&
+        a.collaborationMode === b.collaborationMode &&
+        a.modelPreference === b.modelPreference &&
+        arraysEqual(a.allowedTools, b.allowedTools));
+}
+function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+/**
+ * 监听 agents.json 配置文件变化，自动重载 Agent 定义。
+ *
+ * 监听路径（按优先级）：
+ *   1. process.env.AGENTS_CONFIG_PATH
+ *   2. <cwd>/.agent/agents.json
+ *   3. ~/.agent/agents.json
+ *
+ * 任一文件变化时，debounce 后：
+ *   - 重新加载配置
+ *   - 对比新旧列表，增量注册/注销/更新
+ */
+export function watchAgentsJson(deps) {
+    const logger = createLogger('hot-reload:agents');
+    const watchPaths = [];
+    // 收集所有需要监听的文件路径
+    const globalPath = path.join(os.homedir(), '.agent', 'agents.json');
+    const projectPath = path.join(deps.cwd, '.agent', 'agents.json');
+    const envPath = process.env['AGENTS_CONFIG_PATH'];
+    if (envPath)
+        watchPaths.push(path.resolve(envPath));
+    watchPaths.push(projectPath);
+    watchPaths.push(globalPath);
+    // 去重
+    const uniquePaths = [...new Set(watchPaths)];
+    let timer = null;
+    const watchers = [];
+    for (const watchPath of uniquePaths) {
+        // 确保父目录存在
+        const dir = path.dirname(watchPath);
+        try {
+            // 静默跳过，目录不存在时 fs.watch 会抛出异常
+        }
+        catch {
+            // 忽略
+        }
+        try {
+            const watcher = fs.watch(watchPath, (_event) => {
+                if (timer)
+                    clearTimeout(timer);
+                timer = setTimeout(async () => {
+                    try {
+                        logger.info('agents.json changed, reloading...');
+                        await reloadAgents(deps, logger);
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        logger.warn('agent reload failed', { error: msg });
+                    }
+                }, deps.debounceMs);
+            });
+            watchers.push(watcher);
+        }
+        catch {
+            // 文件不存在或无法监听，静默跳过（watch 会在第一次文件创建时失效）
+        }
+    }
+    return watchers;
+}
+async function reloadAgents(deps, logger) {
+    // 1. 重新加载配置
+    const newAgents = await loadAgentConfigs(deps.cwd);
+    // 2. 获取当前已注册的 Agent（按 name 建立索引）
+    const oldAgents = deps.agentRegistry.getAll();
+    const oldMap = new Map();
+    for (const a of oldAgents) {
+        oldMap.set(a.name, a);
+    }
+    const newMap = new Map();
+    for (const a of newAgents) {
+        newMap.set(a.name, a);
+    }
+    // 3. 找出变化
+    const oldNames = new Set(oldMap.keys());
+    const newNames = new Set(newMap.keys());
+    const added = [...newNames].filter((n) => !oldNames.has(n));
+    const removed = [...oldNames].filter((n) => !newNames.has(n));
+    const changed = [];
+    for (const name of newNames) {
+        if (oldNames.has(name)) {
+            const oldDef = oldMap.get(name);
+            const newDef = newMap.get(name);
+            if (!isSameConfig(oldDef, newDef)) {
+                changed.push(name);
+            }
+        }
+    }
+    if (added.length === 0 && removed.length === 0 && changed.length === 0) {
+        logger.info('agents.json unchanged, no reload needed');
+        return;
+    }
+    logger.info('agent changes detected', {
+        added: added.length > 0 ? added : undefined,
+        removed: removed.length > 0 ? removed : undefined,
+        changed: changed.length > 0 ? changed : undefined,
+    });
+    // 4. 应用变更
+    // 处理新增
+    for (const name of added) {
+        const def = newMap.get(name);
+        deps.agentRegistry.register(def);
+        registerAgentContextSource(deps, def, logger);
+        logger.info('agent added', { agent: name });
+    }
+    // 处理变更：先注销旧的，再注册新的
+    for (const name of changed) {
+        const def = newMap.get(name);
+        deps.agentRegistry.unregister(name);
+        removeAgentContextSource(deps, name, logger);
+        deps.agentRegistry.register(def);
+        registerAgentContextSource(deps, def, logger);
+        logger.info('agent updated', { agent: name });
+    }
+    // 处理删除
+    for (const name of removed) {
+        deps.agentRegistry.unregister(name);
+        removeAgentContextSource(deps, name, logger);
+        logger.info('agent removed', { agent: name });
+    }
+    logger.info('agents reload complete', {
+        added: added.length,
+        removed: removed.length,
+        changed: changed.length,
+    });
+}
+function registerAgentContextSource(deps, def, logger) {
+    try {
+        deps.contextComposer.registerSource({
+            name: `agent-${def.name}`,
+            strategy: 'lazy_expand',
+            cacheability: 'manifest',
+            description: def.description,
+            getContent: () => deps.agentRegistry.getFullDefinitions([def.name]),
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logger.warn('failed to register agent context source', { agent: def.name, error: msg });
+    }
+}
+function removeAgentContextSource(deps, agentName, logger) {
+    const sourceName = `agent-${agentName}`;
+    const existing = deps.contextComposer.getSource(sourceName);
+    if (existing) {
+        deps.contextComposer.unregisterSource(sourceName);
+        logger.debug('unregistered agent context source', { agent: agentName });
+    }
+}
+//# sourceMappingURL=agent-watcher.js.map

package/dist/hot-reload/bundle-watcher.d.ts

@@ -0,0 +1,12 @@
+import fs from 'node:fs';
+import type { ToolBundleRegistry } from '../tools/bundle-registry.js';
+export interface BundleWatcherDeps {
+    registry: ToolBundleRegistry;
+    cwd: string;
+    debounceMs: number;
+}
+/**
+ * 监听 .agent/tool-bundles.json 变更 → registry.reload()
+ */
+export declare function watchBundles(deps: BundleWatcherDeps): fs.FSWatcher;
+//# sourceMappingURL=bundle-watcher.d.ts.map

package/dist/hot-reload/bundle-watcher.js

@@ -0,0 +1,35 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { createLogger } from '../logging/logger.js';
+const logger = createLogger('hot-reload:bundle-watcher');
+/**
+ * 监听 .agent/tool-bundles.json 变更 → registry.reload()
+ */
+export function watchBundles(deps) {
+    const { registry, cwd, debounceMs } = deps;
+    const filePath = path.join(os.homedir(), '.agent', 'tool-bundles.json');
+    let debounceTimer = null;
+    logger.info(`Watching bundle config: ${filePath}`);
+    // Use fs.watch on the directory (more reliable cross-platform than watching a single file)
+    const watcher = fs.watch(path.dirname(filePath), (_eventType, filename) => {
+        if (filename !== 'tool-bundles.json')
+            return;
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(() => {
+            try {
+                registry.reload();
+                logger.info('Bundle config reloaded');
+            }
+            catch (err) {
+                logger.warn(`Bundle reload failed: ${err.message}`);
+            }
+        }, debounceMs);
+    });
+    watcher.on('error', (err) => {
+        logger.warn(`Bundle watcher error: ${err.message}`);
+    });
+    return watcher;
+}
+//# sourceMappingURL=bundle-watcher.js.map

package/dist/hot-reload/channel-watcher.d.ts

@@ -0,0 +1,19 @@
+import fs from 'node:fs';
+import type { ModelChannelRegistry } from '../provider/model-channel-registry.js';
+interface ChannelWatcherDeps {
+    channelRegistry: ModelChannelRegistry;
+    cwd: string;
+    debounceMs: number;
+}
+/**
+ * 监听 .agent/model-channels.json 文件变化，自动热重载 ModelChannelRegistry。
+ *
+ * 监听两个文件：
+ *   - ~/.agent/model-channels.json（全局配置）
+ *   - <cwd>/.agent/model-channels.json（项目配置）
+ *
+ * 任一文件发生变化时，debounce 后调用 channelRegistry.reload()。
+ */
+export declare function watchModelChannels(deps: ChannelWatcherDeps): fs.FSWatcher[];
+export {};
+//# sourceMappingURL=channel-watcher.d.ts.map

package/dist/hot-reload/channel-watcher.js

@@ -0,0 +1,54 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { createLogger } from '../logging/logger.js';
+/**
+ * 监听 .agent/model-channels.json 文件变化，自动热重载 ModelChannelRegistry。
+ *
+ * 监听两个文件：
+ *   - ~/.agent/model-channels.json（全局配置）
+ *   - <cwd>/.agent/model-channels.json（项目配置）
+ *
+ * 任一文件发生变化时，debounce 后调用 channelRegistry.reload()。
+ */
+export function watchModelChannels(deps) {
+    const logger = createLogger('hot-reload:channels');
+    const { channelRegistry, cwd, debounceMs } = deps;
+    let timer = null;
+    function handleChange() {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            try {
+                logger.info('model-channels.json changed, reloading...');
+                channelRegistry.reload();
+                logger.info('model channels reloaded');
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                logger.warn('failed to reload model channels', { error: msg });
+            }
+        }, debounceMs);
+    }
+    const configPaths = [
+        path.join(os.homedir(), '.agent', 'model-channels.json'),
+        path.join(cwd, '.agent', 'model-channels.json'),
+    ];
+    const watchers = [];
+    for (const configPath of configPaths) {
+        try {
+            const watcher = fs.watch(configPath, (_event, _filename) => {
+                handleChange();
+            });
+            watcher.on('error', (err) => {
+                logger.warn('watcher error', { path: configPath, error: err.message });
+            });
+            watchers.push(watcher);
+        }
+        catch {
+            // 文件不存在或无法监听，静默跳过（首次保存时会自动创建）
+        }
+    }
+    return watchers;
+}
+//# sourceMappingURL=channel-watcher.js.map

package/dist/hot-reload/command-watcher.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Slash Commands 热重载监听器
+ *
+ * 监听项目根目录的 commands.json 变动，
+ * 文件修改后自动重新加载命令配置到 CommandRegistry。
+ */
+import fs from 'node:fs';
+interface CommandWatcherDeps {
+    cwd: string;
+    debounceMs?: number;
+}
+export declare function watchCommandsJson(deps: CommandWatcherDeps): fs.FSWatcher;
+export {};
+//# sourceMappingURL=command-watcher.d.ts.map

package/dist/hot-reload/command-watcher.js

@@ -0,0 +1,54 @@
+/**
+ * Slash Commands 热重载监听器
+ *
+ * 监听项目根目录的 commands.json 变动，
+ * 文件修改后自动重新加载命令配置到 CommandRegistry。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { createLogger } from '../logging/logger.js';
+const logger = createLogger('hot-reload:command-watcher');
+export function watchCommandsJson(deps) {
+    const filePath = path.join(deps.cwd, 'commands.json');
+    const debounceMs = deps.debounceMs ?? 300;
+    if (!fs.existsSync(filePath)) {
+        logger.debug('commands.json not found, watcher will activate if created');
+    }
+    const watcher = fs.watch(filePath, { persistent: false }, () => {
+        setTimeout(() => {
+            logger.info('commands.json changed, reloading...');
+            try {
+                // 延迟加载避免循环依赖
+                const { CommandRegistry } = require('../ui/command-registry.js');
+                CommandRegistry.getInstance().reload();
+                logger.info('Slash commands reloaded from commands.json');
+            }
+            catch (err) {
+                logger.warn('Failed to reload commands.json', { error: err.message });
+            }
+        }, debounceMs);
+    });
+    watcher.on('error', (err) => {
+        if (err.code !== 'ENOENT') {
+            logger.warn('Command watcher error', { error: err.message });
+        }
+    });
+    watcher.on('rename', () => {
+        // 文件被删除/重命名后重新添加监听
+        setTimeout(() => {
+            if (fs.existsSync(filePath)) {
+                logger.info('commands.json recreated, reloading...');
+                try {
+                    const { CommandRegistry } = require('../ui/command-registry.js');
+                    CommandRegistry.getInstance().reload();
+                }
+                catch (err) {
+                    logger.warn('Failed to reload commands.json', { error: err.message });
+                }
+            }
+        }, debounceMs);
+    });
+    logger.debug(`Watching ${filePath}`);
+    return watcher;
+}
+//# sourceMappingURL=command-watcher.js.map

package/dist/hot-reload/config-watcher.d.ts

@@ -0,0 +1,20 @@
+import fs from 'node:fs';
+import type { RuntimeConfigCenter } from '../runtime/config-center.js';
+interface ConfigWatcherDeps {
+    configCenter: RuntimeConfigCenter;
+    cwd: string;
+    debounceMs: number;
+}
+/**
+ * 监听 config.json 文件变化，自动重载运行时配置。
+ *
+ * 监听两个文件：
+ *   - ~/.agent/config.json（全局配置）
+ *   - <cwd>/.agent/config.json（项目配置）
+ *
+ * 任一文件发生变化时，debounce 后调用 configCenter.load() 重新加载并
+ * diff 变更事件。
+ */
+export declare function watchConfigJson(deps: ConfigWatcherDeps): fs.FSWatcher[];
+export {};
+//# sourceMappingURL=config-watcher.d.ts.map

package/dist/hot-reload/config-watcher.js

@@ -0,0 +1,58 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { createLogger } from '../logging/logger.js';
+/**
+ * 监听 config.json 文件变化，自动重载运行时配置。
+ *
+ * 监听两个文件：
+ *   - ~/.agent/config.json（全局配置）
+ *   - <cwd>/.agent/config.json（项目配置）
+ *
+ * 任一文件发生变化时，debounce 后调用 configCenter.load() 重新加载并
+ * diff 变更事件。
+ */
+export function watchConfigJson(deps) {
+    const logger = createLogger('hot-reload:config');
+    const { configCenter, cwd, debounceMs } = deps;
+    let timer = null;
+    async function handleChange() {
+        try {
+            // 跳过自身 save() 触发的文件变更，避免竞态覆盖
+            if (configCenter.isSaving) {
+                logger.debug('skipping reload: save in progress');
+                return;
+            }
+            logger.info('config.json changed, reloading...');
+            await configCenter.load();
+            logger.info('config reloaded from disk');
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn('failed to reload config', { error: msg });
+        }
+    }
+    const configPaths = [
+        path.join(os.homedir(), '.agent', 'config.json'),
+        path.join(cwd, '.agent', 'config.json'),
+    ];
+    const watchers = [];
+    for (const configPath of configPaths) {
+        try {
+            const watcher = fs.watch(configPath, (_event, _filename) => {
+                if (timer)
+                    clearTimeout(timer);
+                timer = setTimeout(handleChange, debounceMs);
+            });
+            watcher.on('error', (err) => {
+                logger.warn('watcher error', { path: configPath, error: err.message });
+            });
+            watchers.push(watcher);
+        }
+        catch {
+            // 文件不存在或无法监听，静默跳过
+        }
+    }
+    return watchers;
+}
+//# sourceMappingURL=config-watcher.js.map

package/dist/hot-reload/index.d.ts

@@ -0,0 +1,12 @@
+export { HotReloadManager } from './manager.js';
+export type { HotReloadDeps } from './manager.js';
+export { watchMcpConfig } from './mcp-watcher.js';
+export { watchPluginsDir } from './plugin-watcher.js';
+export { watchPrompts } from './prompt-watcher.js';
+export { watchAgentsJson } from './agent-watcher.js';
+export { watchConfigJson } from './config-watcher.js';
+export { watchTools } from './tool-watcher.js';
+export { watchSkills } from './skill-watcher.js';
+export { watchCommandsJson } from './command-watcher.js';
+export { watchModelChannels } from './channel-watcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hot-reload/index.js

@@ -0,0 +1,12 @@
+export { HotReloadManager } from './manager.js';
+// ── Watcher functions (conditionally loaded by HotReloadManager) ──
+export { watchMcpConfig } from './mcp-watcher.js';
+export { watchPluginsDir } from './plugin-watcher.js';
+export { watchPrompts } from './prompt-watcher.js';
+export { watchAgentsJson } from './agent-watcher.js';
+export { watchConfigJson } from './config-watcher.js';
+export { watchTools } from './tool-watcher.js';
+export { watchSkills } from './skill-watcher.js';
+export { watchCommandsJson } from './command-watcher.js';
+export { watchModelChannels } from './channel-watcher.js';
+//# sourceMappingURL=index.js.map

package/dist/hot-reload/manager.d.ts

@@ -0,0 +1,58 @@
+/**
+ * ## 热加载管理器 — 热加载原则
+ *
+ * 项目设计原则：配置变更应即时生效，不重启。
+ * 所有外部化内容（MCP、Skill、Agent、Workflow、Provider、Config 等）
+ * 均通过各自的 watcher 监听文件变化，自动重载。
+ *
+ * 已使用 fs.watchFile（stat 轮询）替代 fs.watch：
+ *   - .agent/ 目录文件密集（session、SQLite、scheduler），fs.watch 在 Windows 上性能差
+ *   - 用 5s 间隔 stat 轮询，对极少变更的配置文件影响更小
+ *
+ * 新增热加载项：
+ *   1. 在对应目录写 watcher 模块（参考 mcp-watcher.ts / provider-watcher.ts）
+ *   2. 在此文件的 start() 中注册（带 config guard）
+ *   3. 确保 watcher 返回 handle 数组，stop() 会统一 close
+ */
+import type { ToolRegistry } from '../tools/registry.js';
+import type { SkillRegistry } from '../skills/registry.js';
+import type { AgentRegistry } from '../agents/registry.js';
+import type { PluginManager } from '../plugins/manager.js';
+import type { RuntimeConfigCenter } from '../runtime/config-center.js';
+import type { LayeredContextComposer } from '../context/composer.js';
+import type { MCPSystem } from '../mcp/system.js';
+import type { ProviderConfigLoader } from '../provider/config.js';
+import type { ModelChannelRegistry } from '../provider/model-channel-registry.js';
+import type { ModelCatalog } from '../provider/catalog.js';
+import type { ToolBundleRegistry } from '../tools/bundle-registry.js';
+export interface HotReloadDeps {
+    toolRegistry: ToolRegistry;
+    skillRegistry: SkillRegistry;
+    agentRegistry: AgentRegistry;
+    pluginManager: PluginManager;
+    configCenter: RuntimeConfigCenter;
+    contextComposer: LayeredContextComposer;
+    mcpSystem: MCPSystem;
+    bundleRegistry: ToolBundleRegistry;
+    channelRegistry?: ModelChannelRegistry;
+    cwd: string;
+    providerConfigLoader: ProviderConfigLoader;
+    modelCatalog: ModelCatalog;
+}
+export declare class HotReloadManager {
+    private deps;
+    private watchers;
+    private debounceTimers;
+    private logger;
+    private started;
+    constructor(deps: HotReloadDeps);
+    static create(cwd: string, deps: HotReloadDeps): HotReloadManager;
+    start(): void;
+    stop(): void;
+    /**
+     * Call a watcher factory function and store the returned FSWatcher(s).
+     * Handles both single FSWatcher and FSWatcher[] return values.
+     */
+    registerWatcher(fn: (...args: any[]) => any, ...args: unknown[]): void;
+}
+//# sourceMappingURL=manager.d.ts.map