hyacinth-ai 0.9.6

package/dist/registry/channel.registry.js

@@ -0,0 +1,87 @@
+import { GenericRegistry } from './base.js';
+import { ChannelManager } from '../channels/manager.js';
+// ---------------------------------------------------------------------------
+// ChannelRegistry
+// ---------------------------------------------------------------------------
+/**
+ * ChannelRegistry — 带 enable/disable 能力的渠道注册表。
+ *
+ * 包装 ChannelManager，在其基础上添加启用/禁用控制：
+ * - 禁用的渠道不会被启动（startAll 时自动过滤）
+ * - 查询接口（getAll / get）仅返回已启用的渠道
+ */
+export class ChannelRegistry extends GenericRegistry {
+    manager;
+    constructor(manager) {
+        super();
+        this.manager = manager ?? new ChannelManager();
+    }
+    // ── 注册 / 注销 ──────────────────────────────────────────────
+    register(item) {
+        super.register(item);
+        this.manager.register(item.handler, item.config);
+    }
+    unregister(name) {
+        // ChannelManager 没有 unregister 方法，仅从 Registry 中移除
+        return super.unregister(name);
+    }
+    // ── 查询（仅已启用） ──────────────────────────────────────────
+    /** 获取指定渠道（禁用的返回 undefined） */
+    get(name) {
+        return super.get(name);
+    }
+    /** 获取所有已启用的渠道 */
+    getAll() {
+        return super.getAll();
+    }
+    // ── 启用 / 禁用 ──────────────────────────────────────────────
+    disable(name) {
+        super.disable(name);
+    }
+    enable(name) {
+        super.enable(name);
+    }
+    // ── 生命周期代理 ─────────────────────────────────────────────
+    /**
+     * 启动所有已启用的渠道。
+     *
+     * 如果提供了 enabledIds，仅启动其中已启用的渠道。
+     * 否则，启动所有本注册表中未禁用的渠道。
+     */
+    async startAll(agentFactory, enabledIds) {
+        // 如果指定了 enabledIds，过滤出已启用的
+        if (enabledIds) {
+            const filtered = enabledIds.filter((id) => this.isEnabled(id));
+            return this.manager.startAll(agentFactory, filtered);
+        }
+        return this.manager.startAll(agentFactory);
+    }
+    /** 停止所有渠道 */
+    async stopAll() {
+        return this.manager.stopAll();
+    }
+    /** 重启指定渠道 */
+    async restart(id, agentFactory) {
+        return this.manager.restart(id, agentFactory);
+    }
+    // ── 发送代理 ─────────────────────────────────────────────────
+    /** 通过指定渠道发送回复 */
+    async send(channelId, sessionId, reply) {
+        return this.manager.send(channelId, sessionId, reply);
+    }
+    // ── 状态查询 ─────────────────────────────────────────────────
+    /** 获取所有渠道状态摘要 */
+    getStatusSummary() {
+        return this.manager.getStatusSummary();
+    }
+    /** 是否已启动 */
+    isStarted() {
+        return this.manager.isStarted();
+    }
+    // ── 内部工具 ─────────────────────────────────────────────────
+    /** 获取内部 ChannelManager */
+    getManager() {
+        return this.manager;
+    }
+}
+//# sourceMappingURL=channel.registry.js.map

package/dist/registry/index.d.ts

@@ -0,0 +1,9 @@
+export { GenericRegistry } from './base.js';
+export type { RegistryItem, RegistryEvent, RegistryEventListener } from './base.js';
+export { ToolRegistry } from './tool.registry.js';
+export { SkillRegistry, createBuiltinSkills } from './skill.registry.js';
+export { AgentRegistry } from './agent.registry.js';
+export { ProviderRegistry } from './provider.registry.js';
+export { ChannelRegistry } from './channel.registry.js';
+export { PluginRegistry } from './plugin.registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.js

@@ -0,0 +1,10 @@
+// 统一 Registry 导出
+export { GenericRegistry } from './base.js';
+export { ToolRegistry } from './tool.registry.js';
+export { SkillRegistry, createBuiltinSkills } from './skill.registry.js';
+export { AgentRegistry } from './agent.registry.js';
+export { ProviderRegistry } from './provider.registry.js';
+export { ChannelRegistry } from './channel.registry.js';
+export { PluginRegistry } from './plugin.registry.js';
+// McpRegistry 已移除 — MCP 统一由 MCPSystem 管理，不再需要独立 Registry 包装
+//# sourceMappingURL=index.js.map

package/dist/registry/mcp.registry.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp.registry.d.ts.map

package/dist/registry/mcp.registry.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp.registry.js.map

package/dist/registry/plugin.registry.d.ts

@@ -0,0 +1,33 @@
+import { GenericRegistry, type RegistryItem } from './base.js';
+import type { PluginManager } from '../plugins/manager.js';
+interface RegisteredPlugin extends RegistryItem {
+    name: string;
+    source?: string;
+}
+/**
+ * PluginRegistry — 带 enable/disable 能力的插件注册表。
+ *
+ * 包装 PluginManager，在其基础上添加启用/禁用控制：
+ * - 禁用的插件不会出现在 getAll 中
+ * - 查询接口（getAll / get）仅返回已启用的插件
+ */
+export declare class PluginRegistry extends GenericRegistry<RegisteredPlugin> {
+    private manager;
+    constructor(manager: PluginManager);
+    /** 获取所有已启用的插件 */
+    getAll(): RegisteredPlugin[];
+    /** 获取指定插件（禁用的返回 undefined） */
+    get(name: string): RegisteredPlugin | undefined;
+    disable(name: string): void;
+    enable(name: string): void;
+    /** 激活指定插件 */
+    activate(id: string, config?: Record<string, unknown>): Promise<void>;
+    /** 停用指定插件 */
+    deactivate(id: string): Promise<void>;
+    /** 完整流程：发现 → 加载 → 激活 → 连接 MCP → 注册 Skill 源 */
+    loadAll(): Promise<void>;
+    /** 获取内部 PluginManager */
+    getManager(): PluginManager;
+}
+export {};
+//# sourceMappingURL=plugin.registry.d.ts.map

package/dist/registry/plugin.registry.js

@@ -0,0 +1,66 @@
+import { GenericRegistry } from './base.js';
+// ---------------------------------------------------------------------------
+// PluginRegistry
+// ---------------------------------------------------------------------------
+/**
+ * PluginRegistry — 带 enable/disable 能力的插件注册表。
+ *
+ * 包装 PluginManager，在其基础上添加启用/禁用控制：
+ * - 禁用的插件不会出现在 getAll 中
+ * - 查询接口（getAll / get）仅返回已启用的插件
+ */
+export class PluginRegistry extends GenericRegistry {
+    manager;
+    constructor(manager) {
+        super();
+        this.manager = manager;
+    }
+    // ── 查询（仅已启用） ──────────────────────────────────────────
+    /** 获取所有已启用的插件 */
+    getAll() {
+        const allPlugins = this.manager.getAll().map((p) => ({
+            name: p.manifest.id,
+            source: 'plugin',
+        }));
+        // 过滤掉已禁用的
+        return allPlugins.filter((p) => this.isEnabled(p.name));
+    }
+    /** 获取指定插件（禁用的返回 undefined） */
+    get(name) {
+        if (!this.isEnabled(name))
+            return undefined;
+        const instance = this.manager.get(name);
+        if (!instance)
+            return undefined;
+        return { name: instance.manifest.id, source: 'plugin' };
+    }
+    // ── 启用 / 禁用 ──────────────────────────────────────────────
+    disable(name) {
+        // 确保插件存在再禁用
+        if (this.manager.get(name)) {
+            super.disable(name);
+        }
+    }
+    enable(name) {
+        super.enable(name);
+    }
+    // ── 生命周期代理 ─────────────────────────────────────────────
+    /** 激活指定插件 */
+    async activate(id, config) {
+        return this.manager.activate(id, config);
+    }
+    /** 停用指定插件 */
+    async deactivate(id) {
+        return this.manager.deactivate(id);
+    }
+    /** 完整流程：发现 → 加载 → 激活 → 连接 MCP → 注册 Skill 源 */
+    async loadAll() {
+        return this.manager.loadAll();
+    }
+    // ── 内部工具 ─────────────────────────────────────────────────
+    /** 获取内部 PluginManager */
+    getManager() {
+        return this.manager;
+    }
+}
+//# sourceMappingURL=plugin.registry.js.map

package/dist/registry/provider.registry.d.ts

@@ -0,0 +1,51 @@
+import { GenericRegistry, type RegistryItem } from './base.js';
+import { ProviderRouter, type AssessmentInput } from '../provider/router.js';
+import type { Provider } from '../provider/interface.js';
+interface RegisteredProvider extends RegistryItem {
+    name: string;
+    provider: Provider;
+    source?: string;
+}
+/**
+ * ProviderRegistry — 带 enable/disable 能力的 Provider 路由注册表。
+ *
+ * 包装 ProviderRouter，在其基础上添加启用/禁用控制：
+ * - 禁用的 Provider 不会参与路由
+ * - 查询接口（get / list）仅返回已启用的 Provider
+ */
+export declare class ProviderRegistry extends GenericRegistry<RegisteredProvider> {
+    private router;
+    constructor(router?: ProviderRouter);
+    register(item: RegisteredProvider): void;
+    unregister(name: string): boolean;
+    /** 禁用一个 Provider（将排除在路由之外） */
+    disable(name: string): void;
+    /** 启用一个之前禁用的 Provider */
+    enable(name: string): void;
+    /** 获取指定 Provider（禁用的返回 undefined） */
+    get(name: string): RegisteredProvider | undefined;
+    /** 列出所有已启用的 Provider 名称 */
+    list(): string[];
+    /**
+     * 根据复杂度评估选择 Provider。
+     *
+     * 委托 ProviderRouter.route() 进行路由，但如果结果被禁用，
+     * 则 fallback 到其他已启用的 Provider。
+     */
+    route(assessment: AssessmentInput): Provider;
+    /** 设置默认 Provider（手动覆盖） */
+    setDefault(name: string): void;
+    /** 清除手动覆盖，恢复自动路由 */
+    clearDefault(): void;
+    /** 获取当前路由模式信息 */
+    getRoutingInfo(): import("../provider/router.js").RoutingInfo;
+    /** 获取内部 ProviderRouter */
+    getRouter(): ProviderRouter;
+    /**
+     * 在注册表中查找匹配给定 Provider 的条目。
+     * 通过引用相等或 getProviderType 进行匹配。
+     */
+    private findRegisteredProvider;
+}
+export {};
+//# sourceMappingURL=provider.registry.d.ts.map

package/dist/registry/provider.registry.js

@@ -0,0 +1,104 @@
+import { GenericRegistry } from './base.js';
+import { ProviderRouter } from '../provider/router.js';
+// ---------------------------------------------------------------------------
+// ProviderRegistry
+// ---------------------------------------------------------------------------
+/**
+ * ProviderRegistry — 带 enable/disable 能力的 Provider 路由注册表。
+ *
+ * 包装 ProviderRouter，在其基础上添加启用/禁用控制：
+ * - 禁用的 Provider 不会参与路由
+ * - 查询接口（get / list）仅返回已启用的 Provider
+ */
+export class ProviderRegistry extends GenericRegistry {
+    router;
+    constructor(router) {
+        super();
+        this.router = router ?? new ProviderRouter();
+    }
+    // ── 注册 / 注销 ──────────────────────────────────────────────
+    register(item) {
+        super.register(item);
+        this.router.register(item.name, item.provider);
+    }
+    unregister(name) {
+        this.router.unregister(name);
+        return super.unregister(name);
+    }
+    // ── 启用 / 禁用 ──────────────────────────────────────────────
+    /** 禁用一个 Provider（将排除在路由之外） */
+    disable(name) {
+        super.disable(name);
+    }
+    /** 启用一个之前禁用的 Provider */
+    enable(name) {
+        super.enable(name);
+    }
+    // ── 查询（仅已启用） ──────────────────────────────────────────
+    /** 获取指定 Provider（禁用的返回 undefined） */
+    get(name) {
+        return super.get(name);
+    }
+    /** 列出所有已启用的 Provider 名称 */
+    list() {
+        return this.getAll().map((r) => r.name);
+    }
+    // ── 路由代理 ─────────────────────────────────────────────────
+    /**
+     * 根据复杂度评估选择 Provider。
+     *
+     * 委托 ProviderRouter.route() 进行路由，但如果结果被禁用，
+     * 则 fallback 到其他已启用的 Provider。
+     */
+    route(assessment) {
+        const result = this.router.route(assessment);
+        // 检查路由结果对应的注册条目是否被禁用
+        const regItem = this.findRegisteredProvider(result);
+        if (regItem && this.isEnabled(regItem.name)) {
+            return result;
+        }
+        // 路由结果被禁用或未找到，fallback 到第一个已启用的 Provider
+        const enabled = this.getAll();
+        if (enabled.length === 0) {
+            throw new Error('ProviderRegistry.route: No enabled providers available.');
+        }
+        return enabled[0].provider;
+    }
+    // ── 手动覆盖代理 ─────────────────────────────────────────────
+    /** 设置默认 Provider（手动覆盖） */
+    setDefault(name) {
+        this.router.setDefault(name);
+    }
+    /** 清除手动覆盖，恢复自动路由 */
+    clearDefault() {
+        this.router.clearDefault();
+    }
+    // ── 路由信息 ─────────────────────────────────────────────────
+    /** 获取当前路由模式信息 */
+    getRoutingInfo() {
+        return this.router.getRoutingInfo();
+    }
+    // ── 内部工具 ─────────────────────────────────────────────────
+    /** 获取内部 ProviderRouter */
+    getRouter() {
+        return this.router;
+    }
+    /**
+     * 在注册表中查找匹配给定 Provider 的条目。
+     * 通过引用相等或 getProviderType 进行匹配。
+     */
+    findRegisteredProvider(provider) {
+        for (const [, item] of this.items) {
+            if (item.provider === provider)
+                return item;
+        }
+        // fallback: 通过 getProviderType 匹配
+        const providerType = provider.getProviderType();
+        for (const [, item] of this.items) {
+            if (item.provider.getProviderType() === providerType)
+                return item;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=provider.registry.js.map

package/dist/registry/skill.registry.d.ts

@@ -0,0 +1,33 @@
+import { GenericRegistry } from './base.js';
+import type { SkillDefinition } from '../types.js';
+/**
+ * Skill 注册表
+ * 负责注册、查询 Skill，以及生成索引/完整定义文本
+ *
+ * 支持启用/禁用（enable/disable）机制：
+ * - disable() 可作用于任意 skill，将其标记为不可用
+ * - enable() 恢复被禁用的 skill
+ * - get() / getAll() / getIndex() / getFullDefinitions() 均会跳过已禁用的 skill
+ * - unregister() 允许注销任意 skill（包括内置的）
+ *
+ * SkillDefinition 已包含 name 和 source，结构上满足 RegistryItem 约束。
+ */
+export declare class SkillRegistry extends GenericRegistry<SkillDefinition> {
+    private builtins;
+    constructor();
+    /** 注册内置 Skill 并保存快照，用于文件覆盖删除后恢复 */
+    registerBuiltin(skill: SkillDefinition): void;
+    /** 注销后如果存在同名内置快照则自动恢复 */
+    unregister(name: string): boolean;
+    /** 获取索引格式（名称+描述列表），用于 Zone 2 manifest */
+    getIndex(): string;
+    /** 获取指定 Skill 列表的完整定义文本（跳过已禁用的） */
+    getFullDefinitions(names: string[]): string;
+    /** @deprecated 使用 enable() 替代 */
+    enableSkill(name: string): void;
+    /** @deprecated 使用 disable() 替代 */
+    disableSkill(name: string): void;
+}
+/** 创建内置 Skill 列表（内容从 src/prompts/skills/ 加载） */
+export declare function createBuiltinSkills(): SkillDefinition[];
+//# sourceMappingURL=skill.registry.d.ts.map

package/dist/registry/skill.registry.js

@@ -0,0 +1,95 @@
+import { GenericRegistry } from './base.js';
+import { loadPrompt } from '../prompts/loader.js';
+/**
+ * Skill 注册表
+ * 负责注册、查询 Skill，以及生成索引/完整定义文本
+ *
+ * 支持启用/禁用（enable/disable）机制：
+ * - disable() 可作用于任意 skill，将其标记为不可用
+ * - enable() 恢复被禁用的 skill
+ * - get() / getAll() / getIndex() / getFullDefinitions() 均会跳过已禁用的 skill
+ * - unregister() 允许注销任意 skill（包括内置的）
+ *
+ * SkillDefinition 已包含 name 和 source，结构上满足 RegistryItem 约束。
+ */
+export class SkillRegistry extends GenericRegistry {
+    builtins = new Map();
+    constructor() {
+        super();
+    }
+    /** 注册内置 Skill 并保存快照，用于文件覆盖删除后恢复 */
+    registerBuiltin(skill) {
+        this.builtins.set(skill.name, { ...skill });
+        this.register(skill);
+    }
+    /** 注销后如果存在同名内置快照则自动恢复 */
+    unregister(name) {
+        const deleted = super.unregister(name);
+        if (deleted) {
+            const builtin = this.builtins.get(name);
+            if (builtin) {
+                this.register({ ...builtin });
+            }
+        }
+        return deleted;
+    }
+    // ── 索引 / 定义 ──────────────────────────────────────────────
+    /** 获取索引格式（名称+描述列表），用于 Zone 2 manifest */
+    getIndex() {
+        const skills = this.getAll();
+        if (skills.length === 0)
+            return '';
+        return 'Available skills:\n' + skills.map(s => `- ${s.name}: ${s.description}`).join('\n');
+    }
+    /** 获取指定 Skill 列表的完整定义文本（跳过已禁用的） */
+    getFullDefinitions(names) {
+        return names
+            .map(name => this.items.get(name))
+            .filter((s) => s != null && !this._disabled.has(s.name))
+            .map(s => `[Skill: ${s.name}]\nDescription: ${s.description}\nRelated Tools: ${s.relatedTools.join(', ')}\nPrompt Template:\n${s.promptTemplate}`)
+            .join('\n\n');
+    }
+    // ── 向后兼容别名 ──────────────────────────────────────────────
+    /** @deprecated 使用 enable() 替代 */
+    enableSkill(name) {
+        this.enable(name);
+    }
+    /** @deprecated 使用 disable() 替代 */
+    disableSkill(name) {
+        this.disable(name);
+    }
+}
+/** 创建内置 Skill 列表（内容从 src/prompts/skills/ 加载） */
+export function createBuiltinSkills() {
+    return [
+        {
+            name: 'code-review',
+            description: 'Review code for bugs, style issues, and best practices',
+            promptTemplate: loadPrompt('skills/code-review'),
+            relatedTools: ['read', 'glob'],
+            source: 'builtin',
+        },
+        {
+            name: 'debug',
+            description: 'Debug an issue by analyzing error messages and tracing code paths',
+            promptTemplate: loadPrompt('skills/debug'),
+            relatedTools: ['read', 'bash', 'glob'],
+            source: 'builtin',
+        },
+        {
+            name: 'refactor',
+            description: 'Refactor code to improve structure, readability, and maintainability',
+            promptTemplate: loadPrompt('skills/refactor'),
+            relatedTools: ['read', 'edit', 'glob'],
+            source: 'builtin',
+        },
+        {
+            name: 'framework-reference',
+            description: 'Agent 框架配置指南 — 配置项、旁路Agent、模型通道等框架能力说明',
+            promptTemplate: loadPrompt('skills/framework-reference'),
+            relatedTools: ['get_config', 'update_config', 'list_model_channels', 'channel_info', 'config_schema'],
+            source: 'builtin',
+        },
+    ];
+}
+//# sourceMappingURL=skill.registry.js.map

package/dist/registry/tool.registry.d.ts

@@ -0,0 +1,68 @@
+import { GenericRegistry, type RegistryItem } from './base.js';
+import type { Tool } from '../tools/interface.js';
+import type { ToolDefinition } from '../types.js';
+import type { RuntimeConfigCenter } from '../runtime/config-center.js';
+/** Tool 扩展 RegistryItem，增加可选的 source 字段 */
+interface RegisteredTool extends Tool, RegistryItem {
+}
+/**
+ * 工具注册表
+ * 负责注册、查询工具，以及生成 LLM 格式的工具定义
+ * 继承自 GenericRegistry，复用通用增删改查逻辑
+ */
+export declare class ToolRegistry extends GenericRegistry<RegisteredTool> {
+    /** 会话中热插拔添加的工具名集合。下次启动时清空，工具自然归位到 tool_rules。 */
+    private hotAddedNames;
+    constructor();
+    /** 标记工具为热插拔添加（会话临时）。调用方：hot-reload/tool-watcher.ts */
+    markHotAdded(name: string): void;
+    /** 获取所有热插拔工具名（用于 Zone 5 session_tools 展示） */
+    getHotAddedNames(): string[];
+    /** 清空热插拔标记（下次启动时，所有工具自然都在 ToolRegistry 中） */
+    clearHotAdded(): void;
+    /**
+     * 生成 LLM 格式的工具定义数组
+     * 用于发送给 LLM API，告知可用工具及其参数格式
+     * 禁用的工具不会被包含。
+     *
+     * 陪伴模式下优先使用 companionDescription（拟人化描述），
+     * 避免「退出陪伴模式」等人设冲突措辞。
+     */
+    getToolDefinitions(companionMode?: boolean): ToolDefinition[];
+    /**
+     * 注册配置管理工具（get_config, update_config, config_schema, reset_config）
+     */
+    registerConfigTools(configCenter: RuntimeConfigCenter): void;
+    /**
+     * 注册所有运行时控制工具（30+ tools）
+     *
+     * ⚠️ 新增运行时工具的正确方式：
+     *   1. 在 src/tools/runtime-control.ts 中创建 createXxxTool() 工厂函数
+     *   2. 在下方各分类段落中按类别注册
+     *   3. 禁止在 factory.ts / loop.ts 中直接 new Tool() 硬编码
+     *
+     * Provider tools (4):
+     *   switch_provider, list_providers, provider_info, switch_to_auto_route
+     *
+     * Registry control tools (9):
+     *   toggle_tool, list_tools, toggle_skill, list_skills,
+     *   toggle_sub_agent, list_sub_agents, spawn_sub_agent, create_sub_agent,
+     *   update_sub_agent
+     *
+     * Session control tools (7):
+     *   interrupt, session_stats, current_session, list_sessions, new_session, switch_session, delete_session
+     *
+     * Permission whitelist tools (3):
+     *   allow_tool, disallow_tool, list_allowlist
+     *
+     * Schedule task management tools (4):
+     *   add_task, remove_task, list_tasks, toggle_task
+     */
+    registerRuntimeControlTools(agentLoop: any, providerRouter: any, skillRegistry: any, agentRegistry: any, configCenter: any, cwd: string, heartbeatScheduler?: any, mcpSystem?: any, modelRouter?: any): void;
+    /** @deprecated 使用 enable() 替代 */
+    enableTool(name: string): void;
+    /** @deprecated 使用 disable() 替代 */
+    disableTool(name: string): void;
+}
+export {};
+//# sourceMappingURL=tool.registry.d.ts.map