hyacinth-ai 0.9.6

package/dist/bypass/agents/orchestrator.js

@@ -0,0 +1,377 @@
+// ============================================================
+// bypass/agents/orchestrator — ContextOrchestrator
+// ============================================================
+//
+// 普通模式下的旁路Agent。维护主Agent的记忆文件。
+//
+//   preTurn:  读取记忆 + 意图识别 → 注入相关记忆到 system 区
+//   postTurn: 观察对话 → 提取事实 → 写入/更新主Agent记忆
+//
+// 设计原则：
+//   - 直接操作 memory.md，不经过 SQLite 知识库
+//   - 沉默是默认：无价值信息时不注入、不写入
+//   - 异常隔离：任何错误不影响主流程
+// ============================================================
+import { BypassAgentBase } from '../base.js';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+// ── 调试日志（用完注释掉） ───────────────────────────────────
+const LOG_DIR = path.join(os.homedir(), '.agent', 'NormalBypassAgent');
+const LOG_FILE = path.join(LOG_DIR, 'orchestrator.log');
+function log(msg) {
+    const ts = new Date().toISOString();
+    const line = `[${ts}] ${msg}\n`;
+    try {
+        if (!fs.existsSync(LOG_DIR))
+            fs.mkdirSync(LOG_DIR, { recursive: true });
+        fs.appendFileSync(LOG_FILE, line, 'utf-8');
+    }
+    catch { /* ignore */ }
+}
+// ── 系统提示词 ───────────────────────────────────────────────
+const PRETURN_SYSTEM = [
+    '你是主Agent的"元认知层"。主Agent记忆里存放的只有关键的底层约束：',
+    '用户习惯、行为规范、环境约定。不是普通事实或项目上下文。',
+    '',
+    '你的任务：',
+    '1. 分析当前用户输入，判断意图',
+    '2. 检查「主Agent记忆」中是否有直接适用于当前情境的约束',
+    '3. 仅当记忆中的约束与当前操作直接相关时，才注入一条简短提醒',
+    '',
+    '什么需要提醒：',
+    '- 用户明确要求过"不要做X" → 当前操作可能触发X → 提醒',
+    '- 用户有固定的工具/命令习惯 → 偏离了习惯 → 提醒',
+    '',
+    '什么不需要提醒：',
+    '- 记忆里有的但对当前操作无影响的条目',
+    '- 泛泛的上下文补充',
+    '',
+    '输出 SILENT 或一行简短提示。默认 SILENT。',
+].join('\n');
+const POSTTURN_SYSTEM = [
+    '你是主Agent的"记忆维护者"。只记录真正底层的、跨会话的约束信息。',
+    '',
+    '值得记（严格）：',
+    '- 用户明确表达的行为偏好（"以后都..."、"不要..."）',
+    '- 用户的工作习惯/命令行惯例',
+    '- 环境约束（"我们的项目必须兼容 Windows"）',
+    '',
+    '不记：',
+    '- 一次性的任务信息',
+    '- 代码细节、项目结构',
+    '- 普通的事实陈述',
+    '- 闲聊中的随口一提',
+    '',
+    '门槛很高。大多数会话不产生新记忆。有疑问就不记。',
+    '',
+    '工具：memory_search / memory_add / memory_update / memory_remove',
+    '写入前先 search 去重。无值得记的内容时直接结束。',
+].join('\n');
+// ── 工具定义 ─────────────────────────────────────────────────
+const ORCHESTRATOR_TOOLS = [
+    {
+        name: 'memory_add',
+        description: '新增一条记忆。写入前先搜索是否已有类似条目——更新优于新建。',
+        input_schema: {
+            type: 'object',
+            properties: {
+                text: { type: 'string', description: '记忆内容，一行文字' },
+            },
+            required: ['text'],
+        },
+    },
+    {
+        name: 'memory_update',
+        description: '修改已有记忆。需提供旧文本（完全匹配）和新文本。',
+        input_schema: {
+            type: 'object',
+            properties: {
+                old_text: { type: 'string', description: '要替换的旧文本（需完全匹配）' },
+                new_text: { type: 'string', description: '新文本' },
+            },
+            required: ['old_text', 'new_text'],
+        },
+    },
+    {
+        name: 'memory_remove',
+        description: '删除一条记忆。需提供要删除的文本（完全匹配）。',
+        input_schema: {
+            type: 'object',
+            properties: {
+                text: { type: 'string', description: '要删除的文本（需完全匹配）' },
+            },
+            required: ['text'],
+        },
+    },
+    {
+        name: 'memory_search',
+        description: '搜索已有记忆，返回匹配条目。用于去重判断。',
+        input_schema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: '搜索关键词' },
+            },
+            required: ['query'],
+        },
+    },
+];
+// ── 记忆文件操作 ─────────────────────────────────────────────
+const MEMORY_HEADER = '# 记忆\n';
+function readMemory(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const lines = raw.split('\n');
+        return lines
+            .filter(l => l.startsWith('- '))
+            .map(l => l.slice(2).trim())
+            .filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+function writeMemory(filePath, entries) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const content = MEMORY_HEADER + entries.map(e => `- ${e}`).join('\n') + '\n';
+    fs.writeFileSync(filePath, content, 'utf-8');
+}
+function searchMemory(entries, query) {
+    const q = query.toLowerCase();
+    return entries.filter(e => e.toLowerCase().includes(q));
+}
+function createToolExecutor(memoryPath) {
+    return async (name, input) => {
+        const entries = readMemory(memoryPath);
+        switch (name) {
+            case 'memory_add': {
+                const text = input.text?.trim();
+                if (!text)
+                    return 'Error: text 不能为空';
+                if (entries.includes(text))
+                    return `已存在相同条目，跳过。`;
+                entries.push(text);
+                writeMemory(memoryPath, entries);
+                return `ok: 已添加记忆 (共 ${entries.length} 条)`;
+            }
+            case 'memory_update': {
+                const oldText = input.old_text?.trim();
+                const newText = input.new_text?.trim();
+                if (!oldText || !newText)
+                    return 'Error: old_text 和 new_text 必填';
+                const idx = entries.indexOf(oldText);
+                if (idx === -1)
+                    return `Error: 未找到匹配条目。用 memory_search 确认内容后再试。`;
+                entries[idx] = newText;
+                writeMemory(memoryPath, entries);
+                return `ok: 已更新记忆`;
+            }
+            case 'memory_remove': {
+                const text = input.text?.trim();
+                if (!text)
+                    return 'Error: text 不能为空';
+                const idx = entries.indexOf(text);
+                if (idx === -1)
+                    return `Error: 未找到匹配条目。用 memory_search 确认内容后再试。`;
+                entries.splice(idx, 1);
+                writeMemory(memoryPath, entries);
+                return `ok: 已删除记忆 (共 ${entries.length} 条)`;
+            }
+            case 'memory_search': {
+                const query = input.query?.trim();
+                if (!query)
+                    return 'Error: query 不能为空';
+                const results = searchMemory(entries, query);
+                if (results.length === 0)
+                    return '(无匹配记忆)';
+                return results.map((e, i) => `${i + 1}. ${e}`).join('\n');
+            }
+            default:
+                return `Error: 未知工具 "${name}"`;
+        }
+    };
+}
+// ── 审查 ─────────────────────────────────────────────────────
+const REVIEW_SYSTEM = [
+    '你是主Agent的"监督者"。审查主Agent本轮回复是否偏离用户意图。',
+    '',
+    '判断标准：',
+    '- 方向正确：回复正朝着用户的目标前进',
+    '- 偏离：回复忽略了核心需求、跑题、做了用户没说的事',
+    '- 用户意图不清晰时：主Agent是否主动确认澄清？没有 → 偏离',
+    '- 仅审查文本回复，工具调用（如 read/write/bash）本身不算偏离',
+    '',
+    '输出 OK 或 DEVIATION: <简短原因>。不确定时输出 OK。',
+].join('\n');
+function shouldInject(ctx) {
+    const THRESHOLD = 2; // 连续偏离 2 次才介入
+    const COOLDOWN = 3; // 注入后冷却 3 轮
+    return (ctx.consecutiveDeviations >= THRESHOLD &&
+        ctx.iterationCount - ctx.lastInjectionIteration >= COOLDOWN);
+}
+// ── Orchestrator ──────────────────────────────────────────────
+export class ContextOrchestrator extends BypassAgentBase {
+    memoryPath;
+    _ctx = {
+        intent: '',
+        iterationCount: 0,
+        consecutiveDeviations: 0,
+        lastInjectionIteration: -999,
+    };
+    constructor(memoryPath) {
+        const config = {
+            name: 'orchestrator',
+            modes: ['normal'],
+            modelChannel: 'orchestrator',
+            tools: ORCHESTRATOR_TOOLS,
+            executeTool: createToolExecutor(memoryPath),
+        };
+        super(config);
+        this.memoryPath = memoryPath;
+    }
+    async start() {
+        this._ctx = { intent: '', iterationCount: 0, consecutiveDeviations: 0, lastInjectionIteration: -999 };
+        log('START');
+    }
+    async stop() {
+        log('STOP');
+    }
+    // ── preTurn：读记忆 + 意图识别 → 注入（每轮用户消息仅首轮） ──
+    async preTurn(ctx) {
+        const provider = this.getProvider();
+        if (!provider)
+            return { injections: [] };
+        // 重置本轮迭代状态
+        this._ctx.iterationCount = 0;
+        this._ctx.consecutiveDeviations = 0;
+        // 读当前记忆
+        const memories = readMemory(this.memoryPath);
+        const memoryText = memories.length > 0
+            ? memories.map((e, i) => `${i + 1}. ${e}`).join('\n')
+            : '(暂无记忆)';
+        const recentMsgs = ctx.recentHistory.slice(-8);
+        const conversationCtx = recentMsgs.length > 0
+            ? recentMsgs.map(m => {
+                const role = m.role === 'user' ? '用户' : '主Agent';
+                const text = extractText(m);
+                return `[${role}] ${text.slice(0, 200)}`;
+            }).join('\n')
+            : '(新会话)';
+        const userPrompt = [
+            '【主Agent记忆】',
+            memoryText,
+            '',
+            '【当前用户输入】',
+            ctx.userInput.slice(0, 500),
+            '',
+            '【最近对话】',
+            conversationCtx,
+        ].join('\n');
+        const output = await this.callLLM(PRETURN_SYSTEM, userPrompt);
+        if (!output || output === 'SILENT') {
+            log('preTurn → SILENT');
+            return { injections: [] };
+        }
+        this._ctx.intent = output.split('\n')[0]?.trim() || output;
+        log(`preTurn → intent="${this._ctx.intent}" injection="${output.slice(0, 100)}"`);
+        return {
+            injections: [
+                {
+                    section: 'orchestrator_hint',
+                    content: output,
+                    role: 'system',
+                    mode: 'replace',
+                },
+            ],
+        };
+    }
+    // ── postTurn ────────────────────────────────────────────────
+    async postTurn(ctx) {
+        this._ctx.iterationCount++;
+        if (ctx.isLastIteration) {
+            await this.reviewAndRemember(ctx);
+        }
+        else {
+            await this.reviewOnly(ctx);
+        }
+    }
+    /** 审查本轮回复（每次迭代） */
+    async reviewOnly(ctx) {
+        const provider = this.getProvider();
+        if (!provider || !ctx.assistantOutput)
+            return;
+        const userPrompt = [
+            `【意图】${this._ctx.intent || '(未设定)'}`,
+            '',
+            '【主Agent本轮回复】',
+            ctx.assistantOutput.slice(0, 500),
+            '',
+            '【工具调用】',
+            ctx.toolCallsThisTurn.join(', ') || '(无)',
+        ].join('\n');
+        const verdict = await this.callLLM(REVIEW_SYSTEM, userPrompt);
+        if (!verdict || verdict === 'OK') {
+            this._ctx.consecutiveDeviations = 0;
+            log(`review #${this._ctx.iterationCount} → OK`);
+            return;
+        }
+        this._ctx.consecutiveDeviations++;
+        log(`review #${this._ctx.iterationCount} → DEVIATION #${this._ctx.consecutiveDeviations}: ${verdict.slice(0, 100)}`);
+        if (shouldInject(this._ctx)) {
+            const correction = verdict.replace(/^DEVIATION:\s*/, '');
+            this._manager?.inject('orchestrator', {
+                section: 'orchestrator_hint',
+                content: `[纠正] ${correction}`,
+                role: 'system',
+                mode: 'replace',
+            });
+            this._ctx.lastInjectionIteration = this._ctx.iterationCount;
+            this._ctx.consecutiveDeviations = 0;
+            log(`INJECT correction at #${this._ctx.iterationCount}: "${correction.slice(0, 80)}"`);
+        }
+    }
+    /** 最后一轮：审查 + 记忆处理 */
+    async reviewAndRemember(ctx) {
+        log(`FINAL iteration #${this._ctx.iterationCount} → memory processing`);
+        const provider = this.getProvider();
+        if (!provider)
+            return;
+        const memories = readMemory(this.memoryPath);
+        const memoryText = memories.length > 0
+            ? memories.map((e, i) => `${i + 1}. ${e}`).join('\n')
+            : '(暂无记忆)';
+        const userPrompt = [
+            '【当前记忆】',
+            memoryText,
+            '',
+            '【用户输入】',
+            ctx.userInput.slice(0, 500),
+            '',
+            '【意图】',
+            this._ctx.intent || '(未设定)',
+            '',
+            '本轮任务已完成。请判断是否有值得长期记住的信息。',
+            '有则用工具维护记忆（先 search 去重），无则直接结束。',
+        ].join('\n');
+        await this.callLLMWithTools(POSTTURN_SYSTEM, userPrompt, 3);
+    }
+}
+// ── 辅助 ─────────────────────────────────────────────────────
+function extractText(msg) {
+    const content = msg.content;
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .filter((b) => b?.type === 'text')
+            .map((b) => b.text)
+            .join(' ');
+    }
+    if (content && typeof content === 'object' && 'text' in content) {
+        return content.text;
+    }
+    return '';
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/bypass/agents/world-engine/agent.d.ts

@@ -0,0 +1,41 @@
+import type { Message, ToolDefinition, StreamEvent } from '../../../types.js';
+import type { WorldStore } from './store.js';
+/** 只依赖结构化接口，不耦合具体 provider 实现（保持模块可移植） */
+export interface ProviderLike {
+    createStream(messages: Message[], tools?: ToolDefinition[], signal?: AbortSignal): AsyncIterable<StreamEvent>;
+}
+export interface ModelRouterLike {
+    getProvider(role: string): ProviderLike | null;
+}
+/** 角色身份（区分主角/陪伴角色/NPC 的关键） */
+export interface CharacterIdentity {
+    name: string;
+    desc?: string;
+    /** 其他称呼（名字/物种/昵称等），都指同一角色，如主角 name=天角兽, aliases=[孑遗] */
+    aliases?: string[];
+}
+export interface AgentIdentities {
+    /** 用户扮演的角色 */
+    protagonist?: CharacterIdentity;
+    /** 陪伴角色（LLM 的 soul） */
+    companion?: CharacterIdentity;
+}
+export declare class WorldAgent {
+    private readonly store;
+    private readonly modelRouter;
+    private readonly identities;
+    constructor(store: WorldStore, modelRouter: ModelRouterLike | null, identities?: AgentIdentities);
+    /** 主角/陪伴的动态身份补充（旁路学到的种族/别名/留痕），叠加到配置身份上 */
+    private characterOverlay;
+    /** observe 用的系统提示词 = 身份前言 + 世界维护规则 */
+    private observeSystem;
+    /** narrate 用的系统提示词 = 身份提示 + 旁白规则 */
+    private narrateSystem;
+    /** 主角 + 陪伴角色的名字（用于筛选相关社会关系） */
+    private mainCharacterNames;
+    narrate(pendingNarration?: string): Promise<string | undefined>;
+    observe(userInput: string, mainOutput: string): Promise<void>;
+    /** 观察对话的工具循环（最多 MAX_OBSERVE_ITERS 轮） */
+    private runToolLoop;
+}
+//# sourceMappingURL=agent.d.ts.map