hyacinth-ai 0.9.8 → 0.9.10

package/dist/channels/builtin/http-webhook.js

@@ -215,12 +215,18 @@ export class HttpWebhookChannel {
         const { TuiWsSession } = await import('./tui-ws-session.js');
         const { randomBytes } = await import('node:crypto');
         const tuiWss = new WebSocketServer({ noServer: true });
+        const desktopWss = new WebSocketServer({ noServer: true });
         this.app.server.on('upgrade', (request, socket, head) => {
             if (request.url === '/tui') {
                 tuiWss.handleUpgrade(request, socket, head, (ws) => {
                     tuiWss.emit('connection', ws, request);
                 });
             }
+            else if (request.url === '/desktop') {
+                desktopWss.handleUpgrade(request, socket, head, (ws) => {
+                    desktopWss.emit('connection', ws, request);
+                });
+            }
             else {
                 socket.destroy();
             }
@@ -247,6 +253,32 @@ export class HttpWebhookChannel {
                 logger.info('TUI WS client disconnected', { sessionId });
             });
         });
+        // ── Desktop GUI WebSocket 端点 ──
+        desktopWss.on('connection', (ws) => {
+            const now = new Date();
+            const date = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(2, '0')}${String(now.getDate()).padStart(2, '0')}`;
+            const time = `${String(now.getHours()).padStart(2, '0')}${String(now.getMinutes()).padStart(2, '0')}${String(now.getSeconds()).padStart(2, '0')}`;
+            const sessionId = `webui_${date}-${time}-${randomBytes(3).toString('hex')}`;
+            const session = new TuiWsSession(ws, sessionId);
+            logger.info('Desktop WS client connected', { sessionId });
+            if (this.wsAgentFactory) {
+                session.initialize(this.wsAgentFactory).catch((err) => {
+                    logger.error('Desktop WS init failed', err instanceof Error ? err : new Error(String(err)));
+                });
+            }
+            else {
+                logger.warn('Desktop WS agentFactory not available');
+            }
+            ws.on('message', (data) => {
+                session.handleMessage(data).catch((err) => {
+                    logger.error('Desktop WS msg error', err instanceof Error ? err : new Error(String(err)));
+                });
+            });
+            ws.on('close', () => {
+                session.close().catch(() => { });
+                logger.info('Desktop WS client disconnected', { sessionId });
+            });
+        });
         // ── Start ───────────────────────────────────────────────────
         await this.app.listen({ port: port, host: host });
         this.status = 'active';

package/dist/context/section-resolver.js

@@ -134,7 +134,7 @@ async function resolveRuntime(sec, ctx) {
         // # currentDate 是系统元数据标记（非用户输入），模型训练数据中识别为背景信息
         const [datePart, timePart] = ctx.timestamp.split(' ');
         const dateSlash = datePart.replace(/-/g, '/');
-        return `# currentDate\nToday is ${dateSlash}, ${timePart}.`;
+        return `# currentDate\n(系统提供) Today is ${dateSlash}, ${timePart}.`;
     }
     if (src === 'runtime:userInput') {
         return ctx.userInput || undefined;

package/dist/gateway/factory.js

@@ -27,7 +27,7 @@ import { MemoryStore } from '../memory/memory-store.js';
 import { AgentLoop } from '../orchestrator/loop.js';
 import { PluginManager } from '../plugins/index.js';
 import { initDependencyAnalyzer } from '../dependency/index.js';
-import { ensureGlobalPersonaFiles, getBootstrapStatus } from '../setup/persona-bootstrap.js';
+import { ensureGlobalPersonaFiles, ensureGlobalPromptDir, getBootstrapStatus } from '../setup/persona-bootstrap.js';
 import { ConfigManager } from '../setup/config.js';
 import { RuntimeConfigCenter } from '../runtime/config-center.js';
 import { getDefaultConfig } from '../runtime/defaults.js';
@@ -119,6 +119,17 @@ export async function createAgent(options, supervisor) {
     const personaSetup = await ensureGlobalPersonaFiles();
     const effectivePersonaDir = personaDir ?? personaSetup.personaDir;
     const effectiveBootstrapStatus = bootstrapStatus ?? (await getBootstrapStatus(effectivePersonaDir));
+    // ── 内置 Prompt 同步 ─────────────────────────────────────────────
+    // 将所有内置 prompt 同步到 ~/.agent/prompts/ 下，
+    // 使得 loadPrompt() 的查找优先级正确：外部覆盖 > 内置兜底。
+    await ensureGlobalPromptDir('attention');
+    await ensureGlobalPromptDir('tools');
+    await ensureGlobalPromptDir('agents');
+    await ensureGlobalPromptDir('flows');
+    await ensureGlobalPromptDir('skills');
+    await ensureGlobalPromptDir('precise');
+    await ensureGlobalPromptDir('environment');
+    // root 级文件 summary.md 由 loadPrompt 递归搜索找到，暂不单独同步
     // ── 注册 Flow（Bootstrap + TODO + Spec）──────────────────────────
     flowRegistry.register(new BootstrapFlow(effectivePersonaDir));
     flowRegistry.register(new TodoFlow());
@@ -255,7 +266,7 @@ export async function createAgent(options, supervisor) {
         description: '会话临时工具',
         getContent: () => {
             const names = toolRegistry.getHotAddedNames();
-            return names.length > 0 ? `[Session-only tools]\n${names.join(', ')}` : '';
+            return names.length > 0 ? `[Hot-added tools (session-scoped, additional to standard tools)]\n${names.join(', ')}` : '';
         },
     });
     const channelRegistry = new ModelChannelRegistry(cwd);

package/dist/gateway/tui.js

@@ -1415,6 +1415,10 @@ export async function runTui(provider, sessionId, shouldContinue, maxTurns, maxC
                         // 就地切换，不重启
                         await loop.switchSession(dir);
                         sessionDir = dir;
+                        lastTurnCount = 0;
+                        lastTokensUsed = 0;
+                        const newStats = await statsManager.get(dir);
+                        refreshStatus(loop.getTurnInfo(newStats.turn_count ?? 0, newStats.current_context_tokens ?? 0));
                         chatLog.clearAll();
                         replayEvents(chatLog, dir);
                         chatLog.addSystem(theme.success(`已切换到 session ${sessionId}`));
@@ -2460,6 +2464,10 @@ export async function runTui(provider, sessionId, shouldContinue, maxTurns, maxC
             await loop.switchSession(newSessionDir);
             sessionDir = newSessionDir;
             preciseModeActive = true;
+            lastTurnCount = 0;
+            lastTokensUsed = 0;
+            const psStats = await statsManager.get(newSessionDir);
+            refreshStatus(loop.getTurnInfo(psStats.turn_count ?? 0, psStats.current_context_tokens ?? 0));
             const label = existingPrecise ? '恢复已有' : '新建';
             chatLog.addSystem(theme.success(`精确模式已开启 — ${label} session: ${newSession.id}`));
             chatLog.clearAll();
@@ -2478,6 +2486,10 @@ export async function runTui(provider, sessionId, shouldContinue, maxTurns, maxC
                 await loop.switchSession(originalSessionDir);
                 sessionDir = originalSessionDir;
                 originalSessionDir = null;
+                lastTurnCount = 0;
+                lastTokensUsed = 0;
+                const origStats = await statsManager.get(sessionDir);
+                refreshStatus(loop.getTurnInfo(origStats.turn_count ?? 0, origStats.current_context_tokens ?? 0));
                 chatLog.clearAll();
                 replayEvents(chatLog, sessionDir);
             }

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

@@ -20,8 +20,9 @@ export function watchTools(deps) {
     }
     catch { /* ignore */ }
     const fileMap = new Map();
+    const mtimeMap = new Map();
     // 初始扫描不标记 hotAdded — 工具应进入 Zone 2 tool_rules
-    scanAndSync(toolsDir, toolRegistry, fileMap, true);
+    scanAndSync(toolsDir, toolRegistry, fileMap, mtimeMap, true);
     let debounceTimer = null;
     logger.info(`Watching tools directory: ${toolsDir}`);
     const watcher = fs.watch(toolsDir, { recursive: true }, (_eventType, filename) => {
@@ -32,20 +33,32 @@ export function watchTools(deps) {
         if (debounceTimer)
             clearTimeout(debounceTimer);
         // 文件变更触发的重新扫描 — 此时才标记 hotAdded，工具进 Zone 5 session-tools
-        debounceTimer = setTimeout(() => scanAndSync(toolsDir, toolRegistry, fileMap, false), debounceMs);
+        debounceTimer = setTimeout(() => scanAndSync(toolsDir, toolRegistry, fileMap, mtimeMap, false), debounceMs);
     });
     watcher.on('error', (err) => {
         logger.warn(`Tool watcher error: ${err.message}`, { error: err.message });
     });
     return watcher;
 }
-async function scanAndSync(dir, registry, fileMap, isInitialScan) {
+async function scanAndSync(dir, registry, fileMap, mtimeMap, isInitialScan) {
     const resolved = resolveToolEntries(dir);
     const currentKeys = new Set(resolved.map((r) => r.trackingKey));
     for (const entry of resolved) {
         const knownToolName = fileMap.get(entry.trackingKey);
         if (knownToolName !== undefined) {
-            // 已跟踪 → 重新加载（文件变更触发的热重载）
+            // 已跟踪 → 检查文件是否真的变了，避免 fs.watch 误触发导致全部标记为 hot-added
+            let mtime;
+            try {
+                mtime = fs.statSync(entry.filePath).mtimeMs;
+            }
+            catch { /* stat 失败则走重载 */ }
+            if (mtime !== undefined) {
+                const prevMtime = mtimeMap.get(entry.trackingKey);
+                if (prevMtime === mtime)
+                    continue; // 文件没变，跳过
+                mtimeMap.set(entry.trackingKey, mtime);
+            }
+            // 重新加载（文件变更触发的热重载）
             if (entry.factory) {
                 // Python 工具：不再解析
                 const tool = entry.factory();
@@ -79,13 +92,14 @@ async function scanAndSync(dir, registry, fileMap, isInitialScan) {
             }
         }
         else {
-            await loadAndRegister(entry, registry, fileMap, isInitialScan);
+            await loadAndRegister(entry, registry, fileMap, mtimeMap, isInitialScan);
         }
     }
     for (const [key, toolName] of fileMap.entries()) {
         if (!currentKeys.has(key)) {
             registry.unregister(toolName);
             fileMap.delete(key);
+            mtimeMap.delete(key);
             logger.info(`Tool unregistered: ${toolName} (${key})`);
         }
     }
@@ -138,7 +152,7 @@ function resolveToolEntries(dir) {
     }
     return entries;
 }
-async function loadAndRegister(entry, registry, fileMap, isInitialScan) {
+async function loadAndRegister(entry, registry, fileMap, mtimeMap, isInitialScan) {
     try {
         let tool;
         if (entry.factory) {
@@ -159,6 +173,10 @@ async function loadAndRegister(entry, registry, fileMap, isInitialScan) {
         if (!isInitialScan)
             registry.markHotAdded(tool.name);
         fileMap.set(entry.trackingKey, tool.name);
+        try {
+            mtimeMap.set(entry.trackingKey, fs.statSync(entry.filePath).mtimeMs);
+        }
+        catch { }
         logger.info(`Tool registered: ${tool.name} (${entry.label})`);
     }
     catch (err) {

package/dist/knowledge/structured-store.js

@@ -165,7 +165,7 @@ export class StructuredStore {
                     score += Math.round(3 * weight);
                 }
             }
-            if (score > 0) {
+            if (matchedTags.length > 0) {
                 results.push({ entry, score, matchedTags });
             }
         }
@@ -237,7 +237,7 @@ export class StructuredStore {
         const refs = results.slice(maxMain, maxMain + maxRefs);
         for (const r of main) {
             const tags = r.matchedTags.length > 0 ? `匹配标签: ${r.matchedTags.join(', ')}` : 'FTS5 匹配';
-            lines.push(`━━ ${r.entry.id} ── [${r.entry.category}] ── ${tags}`);
+            lines.push(`(知识库提供) ━━ ${r.entry.id} ── [${r.entry.category}] ── ${tags}`);
             lines.push(r.entry.content);
             if (r.entry.ctx_before)
                 lines.push(`前置: ${r.entry.ctx_before}`);

package/dist/prompts/attention/attention.md

@@ -1,5 +1,6 @@
 注意事项:
 - 减少不必要的对话轮次：能并行的独立工具调用一次发出，不要逐个等待
+- 子Agent 注册一次即可反复 delegate，不要重复 create_sub_agent。
 - 修改代码前先阅读相关代码，理解上下文
 - 优先使用现有工具和函数，避免重复实现
 - 执行命令时注意安全性，避免破坏性操作
@@ -10,3 +11,4 @@
 - 复杂任务可交由子agent去完成，和验收，你统领全局
 - 回复干净简洁，策划阶段不输出代码，具体执行再输出代码
 - 可以使用各种skill来协助，子智能体你可以在编排提示词阶段之间传入skill
+- 动手改任何代码之前必须先向用户询问并确认，改代码过程中如果出现不确定的也要问

package/dist/prompts/persona/PartnerSoul.md

@@ -4,4 +4,5 @@ _这里是陪伴模式的默认人设。_
 
 你可以编辑此文件（`~/.agent/prompts/persona/PartnerSoul.md`）来定制陪伴者的性格和风格。不编辑也可以正常使用陪伴模式。
 
-向用户询问，得到身份后覆盖当前文件内容
+必须立刻向用户询问，得到完整的人格后向用户确认并覆盖当前文件内容
+

package/dist/setup/persona-bootstrap.d.ts

@@ -19,6 +19,15 @@ export interface PersonaValidationResult {
 }
 export declare function getGlobalPersonaDir(configHome?: string): string;
 export declare const DEFAULT_PERSONA_DIR: string;
+/**
+ * 确保内置 prompt 目录同步到 ~/.agent/prompts/{name}/。
+ *
+ * 和 persona 不同（有 bootstrap 状态机），这只是一个简单的文件复制：
+ * 首次安装时复制，已存在则跳过。
+ *
+ * 用于 attention.md 等非 persona 的内置 prompt 文件。
+ */
+export declare function ensureGlobalPromptDir(name: string, configHome?: string): Promise<string[]>;
 export declare function ensurePersonaFiles(personaDir: string): Promise<{
     status: BootstrapStatus;
     filesCreated: string[];

package/dist/setup/persona-bootstrap.js

@@ -93,6 +93,58 @@ async function fileContentDiffersFromTemplate(filePath, template) {
         throw err;
     }
 }
+// ─── Generic Prompt Sync ──────────────────────────────────────────────
+/**
+ * 确保内置 prompt 目录同步到 ~/.agent/prompts/{name}/。
+ *
+ * 和 persona 不同（有 bootstrap 状态机），这只是一个简单的文件复制：
+ * 首次安装时复制，已存在则跳过。
+ *
+ * 用于 attention.md 等非 persona 的内置 prompt 文件。
+ */
+export async function ensureGlobalPromptDir(name, configHome = path.join(os.homedir(), '.agent')) {
+    const targetDir = path.join(configHome, 'prompts', name);
+    await fsp.mkdir(targetDir, { recursive: true });
+    // 搜索源目录（与 loadTemplateContent 的搜索策略一致）
+    const sourceDirs = [
+        path.join(__dirname, '..', 'prompts', name),
+        path.join(process.cwd(), 'src', 'prompts', name),
+        path.join(process.cwd(), 'dist', 'prompts', name),
+    ];
+    let sourceDir;
+    for (const dir of sourceDirs) {
+        try {
+            const stat = await fsp.stat(dir);
+            if (stat.isDirectory()) {
+                sourceDir = dir;
+                break;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    if (!sourceDir) {
+        logger.warn(`Source prompt directory not found: prompts/${name}. Searched: ${sourceDirs.join(', ')}`);
+        return [];
+    }
+    const filesCreated = [];
+    const entries = await fsp.readdir(sourceDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.md'))
+            continue;
+        const sourcePath = path.join(sourceDir, entry.name);
+        const targetPath = path.join(targetDir, entry.name);
+        const created = await writeFileIfMissing(targetPath, await fsp.readFile(sourcePath, 'utf-8'));
+        if (created) {
+            filesCreated.push(`${name}/${entry.name}`);
+        }
+    }
+    if (filesCreated.length > 0) {
+        logger.info('Synced built-in prompt files', { dir: name, files: filesCreated });
+    }
+    return filesCreated;
+}
 // ─── Public API ──────────────────────────────────────────────────────
 export async function ensurePersonaFiles(personaDir) {
     await fsp.mkdir(personaDir, { recursive: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyacinth-ai",
-  "version": "0.9.8",
+  "version": "0.9.10",
   "description": "Hyacinth 🪻 — multi-provider AI agent with tool system and context management",
   "type": "module",
   "main": "dist/index.js",
@@ -29,13 +29,11 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
-    "chrome-devtools-mcp": "^1.2.0",
     "commander": "^14.0.3",
     "diff": "^9.0.0",
     "fastify": "^5.8.5",
     "js-tiktoken": "^1.0.21",
     "mammoth": "^1.12.0",
-    "mcp-chrome-bridge": "^1.0.31",
     "openai": "^6.39.0",
     "picocolors": "^1.1.1",
     "sharp": "^0.35.0",
@@ -43,7 +41,9 @@
     "xlsx": "^0.18.5"
   },
   "optionalDependencies": {
-    "better-sqlite3": "^12.10.0"
+    "better-sqlite3": "^12.10.0",
+    "chrome-devtools-mcp": "^1.2.0",
+    "mcp-chrome-bridge": "^1.0.31"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",