@zooique/memora 2.0.3 → 3.0.1

package/dist/agent/guardRail.js

@@ -0,0 +1,333 @@
+/**
+ * 守卫抽象（GuardRail）—— loop 运行时前置拦截型护栏的统一真理源
+ *
+ * 背景：联网搜索上限 / 提问上限 / 同路径连写止损 / 读取失败硬闸 / 重复读取拦截
+ * 这 5 种前置拦截型护栏统一走注册式 guard，避免以「内联 if + 独立计数字段 + 各自文案 +
+ * 各自阈值」散落在主循环里、每加一种护栏就改一遍主循环。
+ *
+ * 本模块收敛目标：**新增一种护栏 = 注册一个 guard（matches/shouldBlock/文案/阈值/life/可选 write 钩子），
+ * 主循环零改动**。护栏判定逻辑、判定顺序、提示词、阈值全部收敛到本文件，消除散落重复。
+ *
+ * 防重双轨正交登记（二者粒度不同不可合并）：
+ * - a（批级·软提示）：duplicateToolCallInterceptor，作用于**整批工具调用**（跨迭代哈希），
+ *   语义 = 叙事级死循环提醒（默认实现只返 ok/warn，永不 block），见 loop.handleIteration；
+ * - b（主体级·硬拦）：本文件 read_dedup 护栏，作用于**同一读取主体**（闭环内同工具+同参数），
+ *   语义 = 事实级去重拦截（命中后回填 `[ALREADY_READ]`），前提前 `isCachedResultStillInContext`。
+ *   两套去重同一时刻开启、判据/阈值/生命周期互不共享，靠本条登记维系语义边界。
+ *
+ * 收敛边界（不硬吞的异构护栏，维持各自为政）：
+ * - duplicateToolCallInterceptor（批级·软提示，见上「防重双轨正交登记」a 轨）；
+ * - maxIterations/stepBudget（循环终止）、self_review（后处理）——`contextLimit` 已不属此类（它只缩放有效窗口，不终止）；
+ * - interruptQueue/pause/ask 续跑（暂停-质问-续跑设计，另有定稿文档，不动）；
+ * - 文件覆盖度台账（fileExposure 分支②回显，见 toolLedger.ts）——形态不同，不收敛。
+ *
+ * 收敛现状：本模块已按注册序对 5 闸做**真拦截判定**（evaluateBlocked 由 loop 调用，命中回填拒绝文案），
+ * loop 只保留最小职责（组 GuardContext + 调 evaluateBlocked 判定 + 调 notifyExec 写侧喂数、
+ * reset 归零内部计数状态）。「## 行为护栏」节由 buildPromptSection 收敛注入。
+ */
+import { DEDUP_SUBJECT_EXTRACTORS, formatDedupSubject, failureSubjectKey, normalizePathKey, ToolResultCache, } from '../agent/toolResultCache.js';
+/** 静态阈值真源（SSOT）：只承载「纯静态、无动态覆盖」的阈值。
+ *  writeLoop / readFailed 以此为唯一真源；askLimit / maxWebSearch 属动态注入
+ *  （角色包 strategy / LOOP_CONSTANTS，历史曾把 20/8 塞进静态默认作死值、与运行时覆盖矛盾，经审查清除）。
+ *  调用方构造 GuardContext.thresholds 时须以本表为基底补齐两枚动态键。 */
+export const GUARD_THRESHOLDS = {
+    writeLoop: 5,
+    readFailed: 3,
+};
+/** read_dedup 撞墙升级阈值：同主体累计被本护栏硬拦达此值后，后续命中升级为强禁令文案
+ *  （值 2 = 第 3 次起升级；用户裁决 2026-09-28：第 2 次即升级太激进、第 3 次合适）。
+ *  不入 GUARD_THRESHOLDS——它不改变「拦不拦」，只切换文案强度。 */
+export const READ_DEDUP_ESCALATE_THRESHOLD = 2;
+/** 提取给定工具的请求主体（无该工具的 subject 提取器 → undefined，即非 info 型工具） */
+export function extractSubject(toolName, argsJson) {
+    const extractor = DEDUP_SUBJECT_EXTRACTORS[toolName];
+    return extractor ? extractor(argsJson) : undefined;
+}
+/** 解析 write_file 参数里的路径并归一（非 JSON / 空路径 → null，即不参与连写判定） */
+function parseWritePath(argsJson) {
+    try {
+        const a = JSON.parse(argsJson);
+        if (typeof a?.path === 'string' && a.path.trim())
+            return normalizePathKey(a.path);
+    }
+    catch {
+        /* 参数非 JSON → 不参与连写 */
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// 衔接提示词统一真理源（SSOT）：命中文案收敛于此，格式统一 `[TAG] 已…/请…`
+// 运行时命中时 renderPrompt(promptId, promptArgs) 即时渲染；systemPrompt 只放通用声明、不放命中文案。
+// ---------------------------------------------------------------------------
+export const GUARD_RAIL_PROMPTS = {
+    // 占位：{limit}=搜索上限；{tail}=补充指引（由 promptArgs 提供）
+    search_limit: `[SEARCH_LIMIT_REACHED] 已执行 {limit} 次联网搜索，信息应已足够；` +
+        `请停止调用 web_search，直接基于现有搜索结果作答。`,
+    // 占位：{limit}=提问上限
+    ask_limit: `[ASK_LIMIT] 本问答闭环已提问 {limit} 次（上限），请基于现有信息继续，不要再调用 ask_user。`,
+    // 占位：{n}=连续重写次数；{subject}=被反复重写的文件路径
+    write_loop_stop: `[WRITE_LOOP_STOP] 你已连续 {n} 次重写同一文件 {subject}，` +
+        `疑似在自环清理/重建内容。请先 list_dir/read_file 确认真实文件状态，或明确重写章法后再动手；` +
+        `不要对同一文件反复 write_file。`,
+    // 占位：{n}=连续失败次数；{limit}=失败阈值
+    read_failed_limit: `[READ_FAILED_LIMIT] 该目标已连续失败 {n} 次（阈值 {limit}），` +
+        `可能不存在。请先用 list_dir 确认路径，或改用其它目标。`,
+    // 占位：{n}=首次获取步序；{format}=去重主体可读描述；{tail}=主体相关确定性出口（由 promptArgs 单源供给）
+    already_read: `[ALREADY_READ] 该结果仍在你的当前上下文中（第 {n} 步获取：{format}），无需重复获取。` +
+        `{tail}直接基于已有内容继续即可。`,
+    // 占位：{count}=本主体累计被硬拦次数（含本次）；{format}=去重主体可读描述；{tail}=同 already_read 的单源出口。
+    // 升级文案（read_dedup 同主体第 3 次命中起使用，阈值 READ_DEDUP_ESCALATE_THRESHOLD）：前两次温和提示无效
+    // 后的强禁令；出口与 already_read 共用 {tail}（offset/limit 引导只写 promptArgs 一处，非文件主体为空），
+    // 另加 search_memories 记忆检索。
+    already_read_escalated: `[ALREADY_READ] 你已第 {count} 次尝试重复获取 {format}，停止重读。` +
+        `请基于上下文已有内容作答；{tail}` +
+        `已沉淀的要点可用 search_memories 检索记忆。`,
+};
+/** 渲染护栏命中文案（占位符替换；未知键原样保留） */
+export function renderPrompt(promptId, args = {}) {
+    let out = GUARD_RAIL_PROMPTS[promptId];
+    for (const [k, v] of Object.entries(args)) {
+        out = out.split(`{${k}}`).join(String(v));
+    }
+    return out;
+}
+/** 各护栏的通用约束声明（聚合进 buildSystemPrompt 的「## 行为护栏」节）。
+ *  只写**描述性约束，不嵌入运行时拒绝文案的 `[TAG]` 字面量**：system prompt 是常驻消息，
+ *  若直接暴露 `[ALREADY_READ]` 等发送令牌，会让「按令牌定位运行时拒绝消息」的消费方（测试/宿主）
+ *  误命 system prompt；令牌只在拦截真正命中时由 renderPrompt 即时产出。 */
+const GUIDELINES = {
+    read_dedup: '重复读取同一文件/搜索同一主体将被拦截并提示；如需文件其它部分请用 offset/limit 指定行区间。',
+    read_failed: '同一目标连续读取失败达阈值会被硬拦；请先 list_dir 确认路径或改用其它目标。',
+    write_loop: '同一文件被反复重写会触发写作死循环保护；请先 read_file/list_dir 确认真实状态再落笔。',
+    ask_limit: '每个问答闭环仅允许有限次提问；基于现有信息继续，不要反复追问。',
+    search_limit: '联网搜索达上限后视为信息已足；直接基于已有结果作答。',
+};
+/**
+ * 守卫容器（注册表容器 + 统一判定入口）
+ *
+ * 判定纪律：`evaluateBlocked` 按注册顺序遍历，返回**首个** `matches && shouldBlock` 的硬拦命中。
+ * 注册顺序即判定优先级（read_failed 必须先于 read_dedup——失败先于去重判定，与 loop 既有语义一致）。
+ *
+ * 判定与状态均为真拦截/真状态：evaluateBlocked 由 loop 调用并回填拒绝文案；
+ * write_loop/read_failed 的计数状态内聚进 guard 实例闭包，由 notifyExec 写侧喂数、reset 归零。
+ */
+export class GuardRail {
+    /** 有序注册表（注册序即判定序） */
+    registry = [];
+    /** 注册一条护栏（返回 this 便于链式） */
+    register(def) {
+        this.registry.push(def);
+        return this;
+    }
+    /** 注册表（只读视图，供测试/审计盘点） */
+    get guards() {
+        return this.registry;
+    }
+    /** 统一判定入口：按注册序返回首个硬拦命中；无命中返回 undefined */
+    evaluateBlocked(c) {
+        for (const g of this.registry) {
+            if (!g.blocked)
+                continue;
+            if (!g.matches(c))
+                continue;
+            if (!g.shouldBlock(c))
+                continue;
+            // promptId 函数形态：按运行态选择文案；裁决结果传给 promptArgs 按其分支（选择与参数构造性一致）
+            const promptId = typeof g.promptId === 'function' ? g.promptId(c) : g.promptId;
+            const args = g.promptArgs?.(c, promptId) ?? {};
+            return { guardId: g.id, message: renderPrompt(promptId, args) };
+        }
+        return undefined;
+    }
+    /** 拦截归属喂数：loop 在「某护栏命中并拦截」时调用，路由到该护栏的 onBlocked
+     *  （撞墙升级等「只认自己拦的」闭包计数以此喂数；未注册 onBlocked 的护栏为 no-op）。 */
+    notifyBlocked(guardId, toolName, argsJson) {
+        this.registry.find((d) => d.id === guardId)?.onBlocked?.(toolName, argsJson);
+    }
+    /** 写侧喂数钩子分发：结果处理阶段由 loop 对每个 toolCall 调此方法。
+     *  matches 校验复用 GuardContext 判定（构造最小临时 ctx）；命中即调 g.onExec 喂计数。 */
+    notifyExec(c) {
+        // 构造最小临时 GuardContext：matches 仅依赖 toolName，其余字段占位即可
+        const matchCtx = {
+            toolName: c.toolName,
+            argsJson: c.argsJson,
+            toolCallId: c.toolCallId,
+            toolResultCache: new ToolResultCache(),
+            isCachedResultStillInContext: () => false,
+            thresholds: GUARD_THRESHOLDS,
+            counters: { searchCallCount: 0, askCountThisTurn: 0 },
+        };
+        for (const g of this.registry) {
+            if (g.matches(matchCtx))
+                g.onExec?.(c);
+        }
+    }
+    /** 归零指定生命周期 guard 的内部计数状态（life 轮边界由 loop 调 resetTurnState 统一触发） */
+    reset(life) {
+        for (const g of this.registry) {
+            if (g.life === life)
+                g.reset?.();
+        }
+    }
+    /** 生成「## 行为护栏」通用声明节（注入 buildSystemPrompt；只放通用约束，不暴露逐轮计数） */
+    buildPromptSection() {
+        const lines = this.registry.map((g) => GUIDELINES[g.id]).filter((s) => Boolean(s));
+        if (lines.length === 0)
+            return '';
+        return `\n\n## 行为护栏\n${lines.map((s) => `- ${s}`).join('\n')}`;
+    }
+}
+/**
+ * 组装一份缺省护栏注册表：覆盖 5 种前置拦截型护栏，判定序 = read_failed 先于 read_dedup。
+ *
+ * 提供静态判定的**纯函数默认集**，loop 接入时可整表注册；阈值经 ctx.thresholds 由 loop 覆盖为实际值。
+ */
+export function createDefaultGuards() {
+    // write_loop / read_failed 的计数状态各归本函数闭包（createDefaultGuards 每实例一份，
+    // loop 每个实例都 new 一个守卫容器 → 状态每实例独立，安全），经 onExec 喂数、reset 归零。
+    let write = { lastWritePath: null, samePathWriteStreak: 0 };
+    const readFailBySubject = new Map();
+    // read_dedup 撞墙升级计数（键 = failureSubjectKey 口径：工具+主体，不含 read_file 区间——
+    // 同文件换区间重试仍是同一条叙事级重读链）。喂数点 = onBlocked（拦截归属回喂），
+    // 非 onExec：onExec 只知「被某种护栏拦」，台账替身回显等同为 blocked 会在 onExec 侧误计。
+    const dedupBlockBySubject = new Map();
+    const dedupBlockCountOf = (toolName, argsJson) => {
+        const subject = extractSubject(toolName, argsJson);
+        if (!subject)
+            return 0;
+        return dedupBlockBySubject.get(failureSubjectKey(toolName, subject)) ?? 0;
+    };
+    // 期望连写递增后值（读闭包 write，不做状态迁移；迁移交给 onExec）
+    const nextWriteStreak = (p) => write.lastWritePath === p ? write.samePathWriteStreak + 1 : 1;
+    // read_failed 的 subject-key 提取（无 subject → null）
+    const readFailKey = (toolName, argsJson) => {
+        const subject = extractSubject(toolName, argsJson);
+        return subject ? failureSubjectKey(toolName, subject) : null;
+    };
+    return new GuardRail()
+        .register({
+        id: 'search_limit',
+        matches: (c) => c.toolName === 'web_search',
+        // 现有 loop 语义：`searchCallCount > MAX_WEB_SEARCH_CALLS`（超上限才拦）
+        shouldBlock: (c) => c.counters.searchCallCount > c.thresholds.maxWebSearch,
+        blocked: true,
+        promptId: 'search_limit',
+        promptArgs: (c) => ({ limit: c.thresholds.maxWebSearch }),
+        life: 'perTurn',
+    })
+        .register({
+        id: 'ask_limit',
+        matches: (c) => c.toolName === 'ask_user',
+        // 现有 loop 语义：`askCountThisTurn >= askLimit`（达上限即拦）
+        shouldBlock: (c) => c.counters.askCountThisTurn >= c.thresholds.askLimit,
+        blocked: true,
+        promptId: 'ask_limit',
+        promptArgs: (c) => ({ limit: c.thresholds.askLimit }),
+        life: 'perInput',
+    })
+        .register({
+        id: 'write_loop',
+        matches: (c) => c.toolName === 'write_file',
+        // 现有 loop 语义：同路径则 streak+1、换路径则复位为 1，达到阈值拦。
+        // 计数读闭包 write，只读推断期望递增后值、不改自身状态（迁移交给 onExec）。
+        shouldBlock: (c) => {
+            const p = parseWritePath(c.argsJson);
+            if (!p)
+                return false;
+            return nextWriteStreak(p) >= c.thresholds.writeLoop;
+        },
+        blocked: true,
+        promptId: 'write_loop_stop',
+        promptArgs: (c) => {
+            const p = parseWritePath(c.argsJson);
+            if (!p)
+                return { n: c.thresholds.writeLoop, subject: '' };
+            return { n: Math.max(nextWriteStreak(p), c.thresholds.writeLoop), subject: p };
+        },
+        onExec: (c) => {
+            // blocked = 未真正执行，不累计连写（否则被拒后的同路径重写会把 streak 虚抬，误伤后续合法写入）
+            if (c.outcome === 'blocked')
+                return;
+            const p = parseWritePath(c.argsJson);
+            if (p) {
+                write.samePathWriteStreak = nextWriteStreak(p);
+                write.lastWritePath = p;
+            }
+        },
+        reset: () => {
+            write = { lastWritePath: null, samePathWriteStreak: 0 };
+        },
+        life: 'perTurn',
+    })
+        .register({
+        id: 'read_failed',
+        matches: (c) => DEDUP_SUBJECT_EXTRACTORS[c.toolName] !== undefined,
+        // 计数读闭包 readFailBySubject，状态迁移交给 onExec
+        shouldBlock: (c) => {
+            const key = readFailKey(c.toolName, c.argsJson);
+            if (key === null)
+                return false;
+            const failCount = readFailBySubject.get(key);
+            return failCount !== undefined && failCount >= c.thresholds.readFailed;
+        },
+        blocked: true,
+        promptId: 'read_failed_limit',
+        promptArgs: (c) => {
+            const key = readFailKey(c.toolName, c.argsJson);
+            return { n: key ? (readFailBySubject.get(key) ?? 0) : 0, limit: c.thresholds.readFailed };
+        },
+        onExec: (c) => {
+            const key = readFailKey(c.toolName, c.argsJson);
+            if (key === null)
+                return;
+            if (c.outcome === 'ok')
+                readFailBySubject.delete(key);
+            else if (c.outcome === 'failed')
+                readFailBySubject.set(key, (readFailBySubject.get(key) ?? 0) + 1);
+            // blocked 不计失败（未真正执行）
+        },
+        reset: () => readFailBySubject.clear(),
+        life: 'perTurn',
+    })
+        .register({
+        id: 'read_dedup',
+        matches: (c) => DEDUP_SUBJECT_EXTRACTORS[c.toolName] !== undefined,
+        // 仅在「结果确实仍在上下文」时才拦（防死锁：否则内容已压缩/裁剪，告知"基于已有"=指令撒谎）
+        shouldBlock: (c) => {
+            const subject = extractSubject(c.toolName, c.argsJson);
+            if (!subject)
+                return false;
+            const hit = c.toolResultCache.check(c.toolName, subject);
+            return hit !== undefined && c.isCachedResultStillInContext(hit);
+        },
+        blocked: true,
+        // 文案强度按运行态选择：同主体已被硬拦达阈值（前两次温和提示无效）→ 升级强禁令。
+        // 阈值判据只写本处（promptArgs 按已裁决的 chosen 分支，不重复判阈值）
+        promptId: (c) => dedupBlockCountOf(c.toolName, c.argsJson) >= READ_DEDUP_ESCALATE_THRESHOLD
+            ? 'already_read_escalated'
+            : 'already_read',
+        promptArgs: (c, chosen) => {
+            const subject = extractSubject(c.toolName, c.argsJson);
+            const format = subject ? formatDedupSubject(c.toolName, subject) : '';
+            // 「offset/limit 出口」仅对 read_file 有意义（文件可分区间续读）；URL/会话/query 等主体无此语义、
+            // 出口为空。两个 already_read 变体共用本 {tail}（SSOT）：出口引导只写这一处
+            const tail = c.toolName === 'read_file' ? `确需未读区间用 offset/limit 指定；` : '';
+            if (chosen === 'already_read_escalated') {
+                return { count: dedupBlockCountOf(c.toolName, c.argsJson) + 1, format, tail };
+            }
+            const hit = subject ? c.toolResultCache.check(c.toolName, subject) : undefined;
+            return { n: hit?.cachedAtIteration ?? 0, format, tail };
+        },
+        // 拦截归属回喂：本护栏拦下才计数（loop 命中点调 notifyBlocked）——升级阈值据此累积
+        onBlocked: (toolName, argsJson) => {
+            const subject = extractSubject(toolName, argsJson);
+            if (!subject)
+                return;
+            const key = failureSubjectKey(toolName, subject);
+            dedupBlockBySubject.set(key, (dedupBlockBySubject.get(key) ?? 0) + 1);
+        },
+        reset: () => dedupBlockBySubject.clear(),
+        life: 'perTurn',
+    });
+}
+//# sourceMappingURL=guardRail.js.map

package/dist/agent/guardRail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardRail.js","sourceRoot":"","sources":["../../src/agent/guardRail.ts"],"names":[],"mappings":"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"}