hyacinth-ai 0.9.6

package/dist/tools/bundle-tools.js

@@ -0,0 +1,168 @@
+/**
+ * 工具包管理工具 — list / activate / deactivate / create / add / remove / delete
+ *
+ * 从 factory.ts 中提取，统一注册到 ToolRegistry。
+ */
+export function registerBundleTools(toolRegistry, bundleRegistry) {
+    const tools = [
+        {
+            name: 'list_bundles',
+            description: 'List all available tool bundles with their tools and activation status.',
+            inputSchema: { type: 'object', properties: {} },
+            async execute() {
+                try {
+                    const bundles = bundleRegistry.list();
+                    const activeNames = new Set(bundleRegistry.getActive().map(b => b.name));
+                    const lines = bundles.map(b => {
+                        const marker = activeNames.has(b.name) ? ' [已激活]' : '';
+                        const toolList = b.tools.length > 0 ? b.tools.join(', ') : '(全量)';
+                        return `- ${b.name}: ${b.description}${marker}\n  工具: ${toolList}`;
+                    });
+                    return lines.length > 0 ? lines.join('\n\n') : '(无工具包)';
+                }
+                catch (err) {
+                    return `Error: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        },
+        {
+            name: 'activate_bundle',
+            description: 'Activate one or more tool bundles (comma-separated names). Use deactivate_bundle to return to full mode.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    names: { type: 'string', description: '工具包名称，多个用逗号分隔。传 "all" 或留空 = 全量模式。' },
+                },
+                required: [],
+            },
+            async execute(args) {
+                try {
+                    const raw = typeof args.names === 'string' ? args.names.trim() : '';
+                    if (!raw || raw === 'all') {
+                        bundleRegistry.deactivate();
+                        return '已切换至全量模式，所有工具可用';
+                    }
+                    const names = raw.split(',').map(s => s.trim()).filter(Boolean);
+                    bundleRegistry.activate(names);
+                    const count = bundleRegistry.getActiveToolNames().length;
+                    return `已激活 ${names.length} 个工具包（${count} 个工具去重并集），下一轮生效`;
+                }
+                catch (err) {
+                    return `Error: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        },
+        {
+            name: 'deactivate_bundle',
+            description: 'Deactivate all bundles and return to full tool mode.',
+            inputSchema: { type: 'object', properties: {} },
+            async execute() {
+                try {
+                    bundleRegistry.deactivate();
+                    return '已取消所有工具包限制，回到全量模式';
+                }
+                catch (err) {
+                    return `Error: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        },
+        {
+            name: 'create_bundle',
+            description: 'Create a new tool bundle.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: '工具包名称' },
+                    description: { type: 'string', description: '工具包描述' },
+                    tools: { type: 'array', items: { type: 'string' }, description: '工具名称列表' },
+                },
+                required: ['name', 'description'],
+            },
+            async execute(args) {
+                try {
+                    const name = String(args.name);
+                    const desc = String(args.description);
+                    const tools = (Array.isArray(args.tools) ? args.tools : []);
+                    bundleRegistry.create(name, desc, tools);
+                    return `工具包 "${name}" 已创建（${tools.length} 个工具），使用 activate_bundle 激活`;
+                }
+                catch (err) {
+                    return `Error: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        },
+        {
+            name: 'add_to_bundle',
+            description: 'Add tools to an existing bundle.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    bundle: { type: 'string', description: '目标工具包名称' },
+                    tools: { type: 'array', items: { type: 'string' }, description: '要追加的工具名称列表' },
+                },
+                required: ['bundle', 'tools'],
+            },
+            async execute(args) {
+                try {
+                    const bundleName = String(args.bundle);
+                    const toolNames = (Array.isArray(args.tools) ? args.tools : []);
+                    bundleRegistry.addTools(bundleName, toolNames);
+                    const b = bundleRegistry.get(bundleName);
+                    return `已向 "${bundleName}" 追加 ${toolNames.length} 个工具，当前共 ${b?.tools?.length ?? 0} 个`;
+                }
+                catch (err) {
+                    return `Error: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        },
+        {
+            name: 'remove_from_bundle',
+            description: 'Remove tools from a bundle.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    bundle: { type: 'string', description: '目标工具包名称' },
+                    tools: { type: 'array', items: { type: 'string' }, description: '要移除的工具名称列表' },
+                },
+                required: ['bundle', 'tools'],
+            },
+            async execute(args) {
+                try {
+                    const bundleName = String(args.bundle);
+                    const toolNames = (Array.isArray(args.tools) ? args.tools : []);
+                    bundleRegistry.removeTools(bundleName, toolNames);
+                    const b = bundleRegistry.get(bundleName);
+                    return b
+                        ? `已从 "${bundleName}" 移除 ${toolNames.length} 个工具，当前共 ${b.tools.length} 个`
+                        : `"${bundleName}" 不存在`;
+                }
+                catch (err) {
+                    return `Error: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        },
+        {
+            name: 'delete_bundle',
+            description: 'Delete a tool bundle (builtin and common cannot be deleted).',
+            inputSchema: {
+                type: 'object',
+                properties: { bundle: { type: 'string', description: '要删除的工具包名称' } },
+                required: ['bundle'],
+            },
+            async execute(args) {
+                try {
+                    const bundleName = String(args.bundle);
+                    bundleRegistry.delete(bundleName);
+                    return `工具包 "${bundleName}" 已删除`;
+                }
+                catch (err) {
+                    return `Error: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        },
+    ];
+    for (const tool of tools) {
+        toolRegistry.register(tool);
+    }
+}
+//# sourceMappingURL=bundle-tools.js.map

package/dist/tools/channel-info.d.ts

@@ -0,0 +1,5 @@
+import type { Tool } from './interface.js';
+import type { ChannelsInfo } from '../env/env-collector.js';
+export declare function setChannelsInfo(channels: ChannelsInfo[]): void;
+export declare function createChannelInfoTool(): Tool;
+//# sourceMappingURL=channel-info.d.ts.map

package/dist/tools/channel-info.js

@@ -0,0 +1,38 @@
+import { createLogger } from '../logging/logger.js';
+const logger = createLogger('channel-info');
+/** 渠道信息缓存（由 factory.ts 在启动时注入） */
+let cachedChannels = [];
+export function setChannelsInfo(channels) {
+    cachedChannels = channels;
+}
+function formatChannelsInfo(channels) {
+    if (channels.length === 0) {
+        return 'No external channels connected. Only the built-in TUI/HTTP API channels are active.';
+    }
+    const lines = ['Connected channels:'];
+    for (const ch of channels) {
+        const connInfo = ch.isGroup ? 'group' : 'DM';
+        lines.push(`- ${ch.displayName} (${ch.name}) [${connInfo}]:`);
+        lines.push(`  Connection mode: ${ch.connectionMode}`);
+        lines.push(`  DM policy: ${ch.dmPolicy} | Group policy: ${ch.groupPolicy}`);
+        lines.push(`  Require @mention: ${ch.requireMention ? 'yes' : 'no'}`);
+        if (ch.sessionId) {
+            lines.push(`  Current session: ${ch.sessionId}`);
+        }
+    }
+    return lines.join('\n');
+}
+export function createChannelInfoTool() {
+    return {
+        name: 'channel_info',
+        description: 'Query current channel configuration: which channels are connected, connection mode, DM/group policies, whether @mention is required.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        async execute(_args) {
+            return formatChannelsInfo(cachedChannels);
+        },
+    };
+}
+//# sourceMappingURL=channel-info.js.map

package/dist/tools/compression.d.ts

@@ -0,0 +1,7 @@
+/**
+ * trigger_compression — 手动触发上下文压缩
+ */
+import type { Tool } from './interface.js';
+import type { AgentLoop } from '../orchestrator/loop.js';
+export declare function createTriggerCompressionTool(agentLoop: AgentLoop): Tool;
+//# sourceMappingURL=compression.d.ts.map

package/dist/tools/compression.js

@@ -0,0 +1,21 @@
+export function createTriggerCompressionTool(agentLoop) {
+    return {
+        name: 'trigger_compression',
+        description: 'Trigger context compression to free token space when the conversation grows too long.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        async execute(_args) {
+            try {
+                const loop = agentLoop;
+                loop.needsCompression = true;
+                return '压缩已触发。将在下一轮对话前执行。';
+            }
+            catch (err) {
+                return 'Error: ' + (err instanceof Error ? err.message : String(err));
+            }
+        },
+    };
+}
+//# sourceMappingURL=compression.js.map

package/dist/tools/config.d.ts

@@ -0,0 +1,23 @@
+import type { Tool } from './interface.js';
+import type { RuntimeConfigCenter } from '../runtime/config-center.js';
+/**
+ * createGetConfigTool — reads current effective configuration.
+ * Accepts optional `path` for a single value; otherwise returns full config.
+ */
+export declare function createGetConfigTool(configCenter: RuntimeConfigCenter): Tool;
+/**
+ * createUpdateConfigTool — updates configuration at runtime.
+ * Supports both dot-path flat keys and nested objects.
+ * Persists changes via configCenter.save().
+ */
+export declare function createUpdateConfigTool(configCenter: RuntimeConfigCenter): Tool;
+/**
+ * createConfigSchemaTool — returns the configuration schema with defaults and current values.
+ */
+export declare function createConfigSchemaTool(configCenter: RuntimeConfigCenter): Tool;
+/**
+ * createResetConfigTool — resets runtime config overrides back to defaults.
+ * Reset a single path or all paths.
+ */
+export declare function createResetConfigTool(configCenter: RuntimeConfigCenter): Tool;
+//# sourceMappingURL=config.d.ts.map

package/dist/tools/config.js

@@ -0,0 +1,255 @@
+import { getDefaultConfig } from '../runtime/defaults.js';
+// ============================================================
+// Shared helpers (retained from original for update_config merge)
+// ============================================================
+/**
+ * 深度合并 source 到 target（原地修改 target）
+ * 支持嵌套对象，数组直接替换
+ */
+function deepMerge(target, source) {
+    for (const key of Object.keys(source)) {
+        if (source[key] !== null &&
+            typeof source[key] === 'object' &&
+            !Array.isArray(source[key])) {
+            if (!target[key] || typeof target[key] !== 'object' || Array.isArray(target[key])) {
+                target[key] = {};
+            }
+            deepMerge(target[key], source[key]);
+        }
+        else {
+            target[key] = source[key];
+        }
+    }
+}
+/**
+ * 将点分隔路径的扁平对象展开为嵌套对象
+ * 例如 { "training.enabled": true } => { training: { enabled: true } }
+ */
+function expandDotPaths(flat) {
+    const result = {};
+    for (const [key, value] of Object.entries(flat)) {
+        if (key.includes('.')) {
+            const parts = key.split('.');
+            let current = result;
+            for (let i = 0; i < parts.length - 1; i++) {
+                if (!current[parts[i]] || typeof current[parts[i]] !== 'object') {
+                    current[parts[i]] = {};
+                }
+                current = current[parts[i]];
+            }
+            const lastPart = parts[parts.length - 1];
+            if (value !== null &&
+                typeof value === 'object' &&
+                !Array.isArray(value)) {
+                if (!current[lastPart] || typeof current[lastPart] !== 'object') {
+                    current[lastPart] = {};
+                }
+                deepMerge(current[lastPart], value);
+            }
+            else {
+                current[lastPart] = value;
+            }
+        }
+        else {
+            if (value !== null &&
+                typeof value === 'object' &&
+                !Array.isArray(value) &&
+                result[key] &&
+                typeof result[key] === 'object') {
+                deepMerge(result[key], value);
+            }
+            else {
+                result[key] = value;
+            }
+        }
+    }
+    return result;
+}
+// ============================================================
+// Schema walker used by createConfigSchemaTool
+// ============================================================
+/**
+ * Recursively walk the default config tree and the current effective config
+ * to produce a flat list of ConfigSchemaEntry descriptors.
+ */
+function buildSchemaEntries(defaults, current, prefix = '') {
+    const entries = [];
+    for (const key of Object.keys(defaults)) {
+        const fullPath = prefix ? `${prefix}.${key}` : key;
+        const defaultVal = defaults[key];
+        // Read current value (may be overridden)
+        let currentVal = undefined;
+        if (current && typeof current === 'object') {
+            currentVal = current[key];
+        }
+        if (defaultVal !== null &&
+            typeof defaultVal === 'object' &&
+            !Array.isArray(defaultVal)) {
+            // Recurse into nested objects
+            const childCurrent = currentVal !== null && typeof currentVal === 'object' && !Array.isArray(currentVal)
+                ? currentVal
+                : {};
+            entries.push(...buildSchemaEntries(defaultVal, childCurrent, fullPath));
+        }
+        else {
+            // Leaf value
+            const typeLabel = Array.isArray(defaultVal) ? 'array' : typeof defaultVal;
+            entries.push({
+                path: fullPath,
+                type: typeLabel,
+                description: `Configuration: ${fullPath}`,
+                defaultValue: defaultVal,
+                currentValue: currentVal !== undefined ? currentVal : defaultVal,
+            });
+        }
+    }
+    return entries;
+}
+// ============================================================
+// Tool factory functions
+// ============================================================
+/**
+ * createGetConfigTool — reads current effective configuration.
+ * Accepts optional `path` for a single value; otherwise returns full config.
+ */
+export function createGetConfigTool(configCenter) {
+    return {
+        name: 'get_config',
+        description: 'Read current Agent configuration. Provide an optional dot-path to read a single value, or omit to get the full config.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: {
+                    type: 'string',
+                    description: 'Optional dot-path to a specific config key (e.g. "provider.active"). Omit to get full config.',
+                },
+            },
+        },
+        async execute(args) {
+            try {
+                const path = args.path;
+                if (path) {
+                    const value = configCenter.get(path);
+                    if (value === undefined) {
+                        return `Error: config path "${path}" not found.`;
+                    }
+                    return JSON.stringify(value, null, 2);
+                }
+                const config = configCenter.getAll();
+                return JSON.stringify(config, null, 2);
+            }
+            catch (err) {
+                return `Error reading config: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    };
+}
+/**
+ * createUpdateConfigTool — updates configuration at runtime.
+ * Supports both dot-path flat keys and nested objects.
+ * Persists changes via configCenter.save().
+ */
+export function createUpdateConfigTool(configCenter) {
+    return {
+        name: 'update_config',
+        description: 'Update Agent configuration. Accepts key-value pairs. Keys can use dot-path notation (e.g. "session.maxTurns": 60) or be nested objects. Changes are persisted immediately.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                updates: {
+                    type: 'object',
+                    description: 'Key-value pairs to update. Supports dot-path keys or nested objects.',
+                },
+            },
+            required: ['updates'],
+        },
+        async execute(args) {
+            try {
+                const updates = args.updates;
+                if (!updates || typeof updates !== 'object') {
+                    return 'Error: updates must be a non-null object';
+                }
+                // Separate dot-path keys from non-dot-path keys for set-by-path vs merge.
+                const dotPaths = [];
+                const nested = {};
+                for (const [key, value] of Object.entries(updates)) {
+                    if (key.includes('.')) {
+                        dotPaths.push({ path: key, value });
+                    }
+                    else {
+                        nested[key] = value;
+                    }
+                }
+                // Apply dot-path keys one by one to benefit from validation.
+                for (const { path, value } of dotPaths) {
+                    configCenter.set(path, value);
+                }
+                // Merge nested objects (these are already structured).
+                if (Object.keys(nested).length > 0) {
+                    configCenter.merge(nested);
+                }
+                // Persist.
+                await configCenter.save();
+                return `Configuration updated successfully. Applied keys: ${Object.keys(updates).join(', ')}`;
+            }
+            catch (err) {
+                return `Error updating config: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    };
+}
+/**
+ * createConfigSchemaTool — returns the configuration schema with defaults and current values.
+ */
+export function createConfigSchemaTool(configCenter) {
+    return {
+        name: 'config_schema',
+        description: 'Return the full configuration schema including path, type, description, default values, and current values for every config key.',
+        inputSchema: { type: 'object', properties: {} },
+        async execute(_args) {
+            try {
+                const defaults = getDefaultConfig();
+                const current = configCenter.getAll();
+                const schema = buildSchemaEntries(defaults, current);
+                return JSON.stringify(schema, null, 2);
+            }
+            catch (err) {
+                return `Error building config schema: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    };
+}
+/**
+ * createResetConfigTool — resets runtime config overrides back to defaults.
+ * Reset a single path or all paths.
+ */
+export function createResetConfigTool(configCenter) {
+    return {
+        name: 'reset_config',
+        description: 'Reset runtime configuration overrides back to default values. Provide a dot-path to reset a single key, or omit to reset everything.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: {
+                    type: 'string',
+                    description: 'Optional dot-path to reset. Omit to reset all runtime overrides.',
+                },
+            },
+        },
+        async execute(args) {
+            try {
+                const path = args.path;
+                if (path) {
+                    configCenter.reset(path);
+                    return `Config path "${path}" reset to default value.`;
+                }
+                configCenter.reset(); // no arg = reset all
+                return 'All runtime config overrides have been reset to defaults.';
+            }
+            catch (err) {
+                return `Error resetting config: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/tools/db-query.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from './interface.js';
+/**
+ * DbQueryTool — SQLite 内置支持，参数化查询。
+ * 使用 better-sqlite3 进行本地 SQLite 查询。
+ */
+export declare class DbQueryTool implements Tool {
+    readonly name = "db_query";
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    execute(args: Record<string, unknown>): Promise<string>;
+}
+//# sourceMappingURL=db-query.d.ts.map

package/dist/tools/db-query.js

@@ -0,0 +1,107 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * DbQueryTool — SQLite 内置支持，参数化查询。
+ * 使用 better-sqlite3 进行本地 SQLite 查询。
+ */
+export class DbQueryTool {
+    name = 'db_query';
+    description = 'Execute a parameterized SQL query against a SQLite database. ' +
+        'For SELECT, returns results as a formatted table (JSON array of objects). ' +
+        'For INSERT/UPDATE/DELETE, returns the number of affected rows. ' +
+        'Parameters are passed as a JSON array for safe, injection-free queries. ' +
+        'Supports read-only and read-write modes.';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            database: {
+                type: 'string',
+                description: 'Path to the SQLite database file (absolute or relative to cwd)',
+            },
+            query: {
+                type: 'string',
+                description: 'SQL query to execute. Use ? placeholders for parameters.',
+            },
+            params: {
+                type: 'string',
+                description: 'JSON array of parameter values to bind to ? placeholders. Example: [1, "hello"]',
+            },
+            readonly: {
+                type: 'boolean',
+                description: 'If true, opens database in read-only mode. Default: false for SELECT, true otherwise.',
+            },
+        },
+        required: ['database', 'query'],
+    };
+    async execute(args) {
+        const dbPath = args.database;
+        const query = args.query;
+        const paramsRaw = args.params;
+        const readonlyFlag = args.readonly;
+        if (!dbPath || !query)
+            return 'Error: database and query are required.';
+        const cwd = process.cwd();
+        const absDb = path.isAbsolute(dbPath) ? dbPath : path.resolve(cwd, dbPath);
+        if (!fs.existsSync(absDb)) {
+            return `Error: Database file not found: ${absDb}`;
+        }
+        // Parse params
+        let params = [];
+        if (paramsRaw) {
+            try {
+                params = JSON.parse(paramsRaw);
+                if (!Array.isArray(params)) {
+                    return 'Error: params must be a JSON array.';
+                }
+            }
+            catch {
+                return 'Error: params must be a valid JSON array string.';
+            }
+        }
+        // Determine read-only mode
+        const isSelect = /^\s*SELECT|PRAGMA|EXPLAIN/i.test(query.trim());
+        const readOnly = readonlyFlag ?? isSelect;
+        // Dynamic import of better-sqlite3 (optional dependency)
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let BetterSqlite3;
+        try {
+            BetterSqlite3 = (await import('better-sqlite3')).default;
+        }
+        catch {
+            return 'Error: better-sqlite3 module not available.';
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const db = new BetterSqlite3(absDb, { readonly: readOnly });
+        try {
+            const isQuery = /^\s*SELECT|PRAGMA|EXPLAIN|WITH\s/i.test(query.trim());
+            if (isQuery) {
+                const stmt = db.prepare(query);
+                const rows = params.length > 0 ? stmt.all(...params) : stmt.all();
+                if (rows.length === 0)
+                    return '(empty result set)';
+                // Format as a Markdown table for readability
+                const columns = Object.keys(rows[0]);
+                const header = '| ' + columns.join(' | ') + ' |';
+                const separator = '|' + columns.map(() => '---').join('|') + '|';
+                const bodyRows = rows.map(row => '| ' + columns.map(c => String(row[c] ?? 'NULL')).join(' | ') + ' |');
+                const result = [header, separator, ...bodyRows.slice(0, 200)].join('\n');
+                const suffix = rows.length > 200
+                    ? `\n\n... (${rows.length - 200} more rows, ${rows.length} total)`
+                    : `\n\n${rows.length} row(s)`;
+                return result + suffix;
+            }
+            else {
+                const stmt = db.prepare(query);
+                const result = params.length > 0 ? stmt.run(...params) : stmt.run();
+                return `Query OK. ${result.changes} row(s) affected.`;
+            }
+        }
+        catch (err) {
+            return `Error: ${err.message}`;
+        }
+        finally {
+            db.close();
+        }
+    }
+}
+//# sourceMappingURL=db-query.js.map

package/dist/tools/diagnostics.d.ts

@@ -0,0 +1,30 @@
+/**
+ * diagnostics — 代码修改后自动运行类型检查/编译检查
+ *
+ * 在 write/edit/multi_edit 工具执行后自动检测项目类型并运行对应的
+ * 类型检查命令，结果在下轮对话中注入供 LLM 参考。
+ *
+ * 设计原则：
+ *   - 不影响工具执行流（结果通过 pending 机制在下轮注入）
+ *   - 超时保护（默认 15 秒，防止阻塞）
+ *   - 静默降级（无已知项目类型时跳过）
+ */
+type ProjectType = 'typescript' | 'go' | 'rust' | 'python';
+interface DiagnosticsCommand {
+    cmd: string;
+    args: string[];
+}
+/** 检测当前工作目录的项目类型 */
+export declare function detectProjectType(cwd: string): ProjectType | null;
+/** 获取项目类型对应的诊断命令 */
+export declare function getDiagnosticsCommand(type: ProjectType): DiagnosticsCommand;
+/**
+ * 运行诊断命令并返回格式化结果。
+ *
+ * @param cwd     工作目录
+ * @param timeout 超时时间（毫秒），默认 15000
+ * @returns 格式化的诊断结果字符串，超时或无法运行时返回 null
+ */
+export declare function runDiagnostics(cwd: string, timeout?: number): Promise<string | null>;
+export {};
+//# sourceMappingURL=diagnostics.d.ts.map