@zooique/memora 2.0.3 → 3.0.1

package/dist/agent/contextPreparer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextPreparer.d.ts","sourceRoot":"","sources":["../../src/agent/contextPreparer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,uBAAuB;IACvB,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,cAAc,CAAC;IAC/B,yBAAyB;IACzB,MAAM,EAAE;QACN,8BAA8B;QAC9B,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;QACvB,6BAA6B;QAC7B,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;QACjC,uIAAuI;QACvI,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,+BAA+B;IAC/B,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACtD;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,2BAA2B;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;gBAE/B,IAAI,EAAE,mBAAmB;IAIrC;;;;;;;;OAQG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzC;;;;;;;;;OASG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAuFpD"}

package/dist/agent/contextPreparer.js

@@ -0,0 +1,128 @@
+/**
+ * Agent 输入增强管线 — 外部输入 → 上下文装配
+ *
+ * 职责：
+ *   - assembleContext：上下文装配（预算派生 + 对话层注入 + 占用快照）。
+ *     每轮无自动记忆召回（memory-tool-recall-design §3/§4），检索由 LLM 经 search_memories 工具主动触发。
+ *   - 角色包只能手动切换，无 autoMatch / LLM 语义兜底（无角色自动匹配）
+ *
+ * 设计原则：
+ *   - 只依赖 Agent 注入的稳定能力（deps），不反向依赖 Agent 私有状态（与 AgentHooks 同构）
+ *   - 管线逻辑单一真理源：对话层注入/占用快照随管线走
+ *   - Agent 门面保留编排骨架（thinking 阶段 yield 与调用点），叶子逻辑在此唯一实现
+ *   - 事件发射（inputTooLarge）经 emit 回调由 Agent 承接
+ */
+import { computeContextBudget, isInputTooLarge, estimateOccupancy } from '../agent/budget.js';
+import { AGENT_EVENTS } from '../utils/eventEmitter.js';
+import { logger } from '../logging/logger.js';
+/**
+ * 输入增强管线协调器
+ *
+ * 承载 chat() 回答前的输入增强：记忆召回 + 固定轮次注入。Agent.prepareChatContext
+ * 保留编排骨架，本类唯一实现叶子逻辑。
+ */
+export class ContextPreparer {
+    /** 依赖注入集合（Agent 稳定能力窄面） */
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * 运行时更新上下文窗口上限（token）
+     *
+     * 模型热切换（Agent.setContextWindow）后调用：deps.config.maxContextTokens 为装配期
+     * 值拷贝，须显式同步——否则每轮 prepare 的预算派生（computeContextBudget）与占用快照
+     * （recordOccupancy 的 totalTokens / outputReserve / free）仍用旧窗口。
+     *
+     * @param tokens 新窗口 token 数
+     */
+    setMaxContextTokens(tokens) {
+        this.deps.config.maxContextTokens = tokens;
+    }
+    /**
+     * 上下文装配（纯上下文装配，无自动召回）
+     *
+     * 记忆检索由 LLM 经 search_memories 工具主动触发（builtinToolHandlers.searchMemories），
+     * 本方法不代模型猜测"此刻需要什么记忆"，只做纯**上下文装配**：预算派生 + roundId 互斥 +
+     * 对话层注入 + 上下文占用快照，不返回任何自动召回的注入记忆。
+     * 对话层注入恒走 hybrid（最近对话摘要注入），无 fixed/query 分支。
+     *
+     * @param input 用户输入（仅作顶级锚点预算估算，不再作为召回 query）
+     */
+    async assembleContext(input) {
+        const { deps } = this;
+        // ── 上下文预算：动态预算装配（role-pack-spec §C） ──
+        // 容量来源：windowTokens = deps.config.maxContextTokens —— 单一数字，已由宿主在构造内核 Agent 前
+        // 经内核 resolveContextWindow(window) 解析（per-LLM 窗口为唯一真理源，缺失回退默认 120K）后注入；内核预算路径只消费单一数字，不认 provider/用户双层来源。
+        // 固定开销取 system prompt；顶级锚点 = 本轮用户输入（独立划块，永不压缩）；完整对话层从最近往回塞到 ~90% 止
+        const loop = deps.loop;
+        const loopMessages = loop.getMessages();
+        const fixedOverheadTokens = loopMessages.length > 0 ? loop.estimateTokens([loopMessages[0]]) : 0;
+        const inputTokens = loop.estimateTokens([{ role: 'user', content: input }]);
+        const budget = computeContextBudget({
+            windowTokens: deps.config.maxContextTokens,
+            fixedOverheadTokens,
+            inputTokens,
+        });
+        // 预算透出（预算可视化）：暂存最近一轮预算供指标快照展示"预算花到哪"
+        deps.loop.recordBudget?.(budget);
+        // ── 装配前判负（独立路径） ──
+        // 顶级锚点划走后剩余预算低于最小可运行阈值 → 该输入无法支撑至少一轮正文，
+        // 装配前确定性降级（跳过召回与完整对话层注入），并通知宿主提示放文件用 read_file 读。
+        // 与软上限（摘要饱和）是不同失败原因，不占用软上限统计。
+        if (isInputTooLarge(budget)) {
+            deps.emit(AGENT_EVENTS.inputTooLarge, {
+                inputLength: input.length,
+                remainingTokens: budget.remainingTokens,
+                hint: '内容过大，建议放进文件用 read_file 读',
+            });
+            logger.warn({ inputLength: input.length, remainingTokens: budget.remainingTokens }, '装配前判负：输入过大，跳过上下文装配与完整对话层注入');
+            return;
+        }
+        // 派生完整对话层轮次集合（动态轮数 + 第一条必在场，次级锚点）
+        const dialogue = loop.getRecentHistoryWithinBudget(budget.dialogueBudgetTokens);
+        // ── 完整对话层注入：恒 hybrid（无 fixed/query 分支） ──
+        // 对话按预算截断，注入的最近轮次摘要提供结构化视图，避免 LLM 丢失上下文连续性。
+        const recentHistory = dialogue.history;
+        if (recentHistory.length > 0) {
+            const msgs = deps.config.messages;
+            const label = msgs?.recentConversationLabel ?? '[Recent conversation]';
+            const userLabel = msgs?.userLabel ?? 'User';
+            const assistantLabel = msgs?.assistantLabel ?? 'Assistant';
+            const recentPrompt = `${label}\n` +
+                recentHistory
+                    .map((m) => `${m.role === 'user' ? userLabel : assistantLabel}：${m.content}`)
+                    .join('\n');
+            loop.injectSystemMessage(recentPrompt);
+            logger.debug({ turns: recentHistory.length / 2 }, '最近对话已注入');
+        }
+        // ── 上下文占用快照（预算可视化）：记录各层真实用量，供输入区指示器展示 ──
+        // 单一真理源 = 本 prepare 已算出的实际值；宿主/webview 只渲染、不重算。
+        //   rolePackBase = fixedOverheadTokens（system prompt：persona+rules+技能L1+工具schema）
+        //   dialogue     = 问答闭环完整对话 token（全量 user+assistant，与装配模式无关——容量诚实
+        //                  统计问答闭环总和；loop.append 侧 refreshOccupancyDialogue 以
+        //                  同一估算器重算覆盖，prepare 与实时刷新同源同数据，无口径漂移）
+        //   inputAnchor  = 顶级锚点（本轮用户输入，budget.anchorTokens）
+        //   outputReserve= 窗口 × 输出预留比例（留给模型回答的容量，非已用）
+        //   free         = 总容量 − 各段，≥ 0 收敛（窗口过小/输入过大时各段归零）
+        // 注：记忆不占用上下文，占用模型无记忆维度。
+        const dialogueTokens = loop.estimateTokens(loop.getConversationMessages());
+        // 条数语义：以「用户输入」为计数标准——一个问答闭环（user 消息）计 1 条，
+        // 哪怕 assistant 回答残缺/被中止也如实记录（尊重用户保留意图）；assistant 不计入条数，但计入 dialogueTokens 容量。
+        // 关键：dialogueCount 与 dialogueTokens 统一取 loop.messages 全量（user 计数 + 全量 token），
+        // 与装配模式无关——否则 hybrid 模式下 getRecentHistoryWithinBudget 按预算截取「最近 N 轮」
+        // 会把最新轮挤掉最旧轮、轮数守恒，导致「发一条消息后完整对话数不涨」（用户实测 bug），
+        // 且进窗口径与 loop 侧实时刷新（refreshOccupancyDialogue 按全量重算）产生语义漂移。
+        // 统一全量后 prepare 与刷新共用同一估算器、同一数据源（SSOT），杜绝口径分叉。
+        const dialogueCount = loop.getConversationMessages().filter((m) => m.role === 'user').length;
+        // 占用组装复用 estimateOccupancy（SSOT 单点：free 收敛 + 拼满 + 输出预留，宿主历史会话重算共用）
+        deps.loop.recordOccupancy(estimateOccupancy({
+            totalTokens: deps.config.maxContextTokens,
+            rolePackBaseTokens: fixedOverheadTokens,
+            dialogueTokens,
+            dialogueCount,
+            inputAnchorTokens: budget.anchorTokens,
+        }));
+    }
+}
+//# sourceMappingURL=contextPreparer.js.map

package/dist/agent/contextPreparer.js.map

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

package/dist/agent/duplicateInterceptor.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 重复工具调用拦截器实现
+ *
+ * 策略参数化的宿主扩展点
+ *
+ * 将"机械重复检测"从 AgentLoop 内部逻辑剥离为独立类，
+ * 宿主可通过注入自定义 DuplicateCallInterceptor 实现不同策略：
+ *   - 按工具名差异化阈值（search 阈值大，delete 阈值小）
+ *   - 按工具结果内容做语义重复判定
+ *   - 直接 block（硬拦截）而非 warn（软提醒）
+ *
+ * 设计哲学：
+ *   - 默认实现基于"工具名+参数哈希"的机械检测，零配置开箱即用
+ *   - 接口极简：check() 返回 'ok'/'warn'/'block' 三态
+ *   - 状态管理在 AgentLoop（避免拦截器实例跨会话状态泄漏）
+ */
+import type { DuplicateCallInterceptor, DuplicateCheckContext, DuplicateCheckVerdict } from '../agent/types.js';
+/**
+ * 默认重复调用拦截器（基于哈希的机械检测）
+ *
+ * 策略：对比当前轮与上一轮的工具调用哈希，连续 N 次相同触发 warn。
+ * N 由构造参数 threshold 控制（默认 3，表示累计 3 次重复后触发）。
+ *
+ * 哈希算法：
+ *   1. 按工具名 + 参数排序（消除顺序影响）
+ *   2. 参数 JSON 规范化（解析后再序列化，消除空白/键顺序差异）
+ *   3. 拼接为 "name(args)|name(args)" 格式
+ *   4. SHA256 哈希
+ */
+export declare class DefaultDuplicateCallInterceptor implements DuplicateCallInterceptor {
+    readonly name = "default-hash-interceptor";
+    private readonly threshold;
+    constructor(threshold?: number);
+    /** 当前阈值（loop 据此 SSOT 取阈值，不硬编码） */
+    getThreshold(): number;
+    /**
+     * 检查工具调用是否构成重复死循环
+     *
+     * @param toolCalls 本轮有效的工具调用列表
+     * @param context 上下文信息（含 AgentLoop 已计算的 hash 和 count）
+     * @returns 判定结果
+     */
+    check(toolCalls: readonly {
+        id: string;
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }[], context: DuplicateCheckContext): DuplicateCheckVerdict;
+    /**
+     * 对工具调用列表生成稳定哈希（供 AgentLoop 和外部使用）
+     *
+     * 静态方法，方便 AgentLoop 在不持有拦截器实例时也能计算哈希。
+     * 序列化规则唯一实现：loop 的调用哈希直接调用本方法，单一实现无镜像。
+     *
+     * @param toolCalls 工具调用列表
+     * @returns SHA256 哈希十六进制字符串；空数组返回空字符串
+     */
+    static hash(toolCalls: readonly {
+        id: string;
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }[]): string;
+}
+//# sourceMappingURL=duplicateInterceptor.d.ts.map

package/dist/agent/duplicateInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicateInterceptor.d.ts","sourceRoot":"","sources":["../../src/agent/duplicateInterceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;;;;GAWG;AACH,qBAAa,+BAAgC,YAAW,wBAAwB;IAC9E,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,SAAS,GAAE,MAAU;IAIjC,kCAAkC;IAClC,YAAY,IAAI,MAAM;IAItB;;;;;;OAMG;IACH,KAAK,CACH,SAAS,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EAAE,EACnF,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB;IAkBxB;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,CACT,SAAS,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EAAE,GAClF,MAAM;CAuBV"}

package/dist/agent/duplicateInterceptor.js

@@ -0,0 +1,82 @@
+import { sha256Fingerprint } from '../utils/hash.js';
+/**
+ * 默认重复调用拦截器（基于哈希的机械检测）
+ *
+ * 策略：对比当前轮与上一轮的工具调用哈希，连续 N 次相同触发 warn。
+ * N 由构造参数 threshold 控制（默认 3，表示累计 3 次重复后触发）。
+ *
+ * 哈希算法：
+ *   1. 按工具名 + 参数排序（消除顺序影响）
+ *   2. 参数 JSON 规范化（解析后再序列化，消除空白/键顺序差异）
+ *   3. 拼接为 "name(args)|name(args)" 格式
+ *   4. SHA256 哈希
+ */
+export class DefaultDuplicateCallInterceptor {
+    name = 'default-hash-interceptor';
+    threshold;
+    constructor(threshold = 3) {
+        this.threshold = threshold;
+    }
+    /** 当前阈值（loop 据此 SSOT 取阈值，不硬编码） */
+    getThreshold() {
+        return this.threshold;
+    }
+    /**
+     * 检查工具调用是否构成重复死循环
+     *
+     * @param toolCalls 本轮有效的工具调用列表
+     * @param context 上下文信息（含 AgentLoop 已计算的 hash 和 count）
+     * @returns 判定结果
+     */
+    check(toolCalls, context) {
+        // 空工具调用列表 → ok
+        if (toolCalls.length === 0)
+            return 'ok';
+        // 哈希不匹配 → ok（工具调用已变化）
+        if (context.currentHash === '' || context.currentHash !== context.lastHash) {
+            return 'ok';
+        }
+        // 达到阈值 → warn
+        if (context.duplicateCount >= this.threshold) {
+            return 'warn';
+        }
+        // 未达阈值 → ok（让 AgentLoop 继续累计）
+        return 'ok';
+    }
+    /**
+     * 对工具调用列表生成稳定哈希（供 AgentLoop 和外部使用）
+     *
+     * 静态方法，方便 AgentLoop 在不持有拦截器实例时也能计算哈希。
+     * 序列化规则唯一实现：loop 的调用哈希直接调用本方法，单一实现无镜像。
+     *
+     * @param toolCalls 工具调用列表
+     * @returns SHA256 哈希十六进制字符串；空数组返回空字符串
+     */
+    static hash(toolCalls) {
+        if (toolCalls.length === 0)
+            return '';
+        // 按工具名 + 参数排序，消除顺序影响
+        const sorted = [...toolCalls].sort((a, b) => {
+            const na = a.function.name;
+            const nb = b.function.name;
+            if (na !== nb)
+                return na < nb ? -1 : 1;
+            return a.function.arguments < b.function.arguments ? -1 : 1;
+        });
+        const signature = sorted
+            .map((tc) => {
+            // 参数 JSON 规范化：解析后再序列化，消除空白/键顺序差异
+            let normalizedArgs = tc.function.arguments;
+            try {
+                normalizedArgs = JSON.stringify(JSON.parse(tc.function.arguments));
+            }
+            catch {
+                // 非 JSON 字符串（如纯文本参数），保持原样
+            }
+            return `${tc.function.name}(${normalizedArgs})`;
+        })
+            .join('|');
+        return sha256Fingerprint(signature);
+    }
+}
+//# sourceMappingURL=duplicateInterceptor.js.map

package/dist/agent/duplicateInterceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicateInterceptor.js","sourceRoot":"","sources":["../../src/agent/duplicateInterceptor.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,+BAA+B;IACjC,IAAI,GAAG,0BAA0B,CAAC;IAC1B,SAAS,CAAS;IAEnC,YAAY,YAAoB,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,kCAAkC;IAClC,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CACH,SAAmF,EACnF,OAA8B;QAE9B,eAAe;QACf,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAExC,sBAAsB;QACtB,IAAI,OAAO,CAAC,WAAW,KAAK,EAAE,IAAI,OAAO,CAAC,WAAW,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,cAAc;QACd,IAAI,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC7C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,8BAA8B;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,CACT,SAAmF;QAEnF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACtC,qBAAqB;QACrB,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC1C,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC3B,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC3B,IAAI,EAAE,KAAK,EAAE;gBAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvC,OAAO,CAAC,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,MAAM;aACrB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACV,iCAAiC;YACjC,IAAI,cAAc,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3C,IAAI,CAAC;gBACH,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;YACrE,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;YACD,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,IAAI,cAAc,GAAG,CAAC;QAClD,CAAC,CAAC;aACD,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/agent/guardRail.d.ts

@@ -0,0 +1,166 @@
+/**
+ * 守卫抽象（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 { ToolResultCache, type CacheEntry, type DedupSubject } from '../agent/toolResultCache.js';
+/** 护栏类型 id（收敛集合，新增护栏在此扩联合） */
+export type GuardRailId = 'search_limit' | 'ask_limit' | 'write_loop' | 'read_failed' | 'read_dedup';
+/** 命中提示词 id（与 GuardRailPromptId 一一对应，文案收敛到 GUARD_RAIL_PROMPTS） */
+export type GuardRailPromptId = 'search_limit' | 'ask_limit' | 'write_loop_stop' | 'read_failed_limit' | 'already_read' | 'already_read_escalated';
+/** 护栏运行态计数（loop 注入，仅承载 search_limit / ask_limit 两枚；write_loop 连写 / read_failed 失败
+ *  计数内聚进各自 guard 实例闭包，经 onExec 自持更新） */
+export interface GuardCounters {
+    /** 本闭环内 web_search 调用次数（含被拒绝的）—— search_limit 用 */
+    searchCallCount: number;
+    /** 本用户输入的提问累计数（life:'perInput'）—— ask_limit 用 */
+    askCountThisTurn: number;
+}
+/** onExec 写侧喂数上下文：结果处理阶段由 loop 构造，仅承载 feeds 所需字段 + 本次执行结果 */
+export interface GuardExecContext {
+    toolName: string;
+    /** 原始工具参数 JSON 串（用于 path/subject 提取） */
+    argsJson: string;
+    toolCallId: string;
+    /** 本次执行结果：ok=真实成功 / failed=执行失败 / blocked=被护栏或台账拦截（未真正执行） */
+    outcome: 'ok' | 'failed' | 'blocked';
+}
+/** 护栏阈值（运行时由调用方注入 GuardContext；真源分配见下） */
+export interface GuardThresholds {
+    /** 同路径连写止损阈值（原 WRITE_LOOP_THRESHOLD = 5）：第 N 次触发硬拦 —— 静态真源 GUARD_THRESHOLDS */
+    writeLoop: number;
+    /** 同主体连续失败硬闸阈值（原默认 3）—— 静态真源 GUARD_THRESHOLDS */
+    readFailed: number;
+    /** 单次用户输入提问上限（life:'perInput'）—— 动态真源 role-pack strategy.askLimit（不塞静态默认） */
+    askLimit: number;
+    /** 单闭环联网搜索硬上限 —— 动态真源 LOOP_CONSTANTS.MAX_WEB_SEARCH_CALLS（不塞静态默认） */
+    maxWebSearch: number;
+}
+/** 静态阈值真源（SSOT）：只承载「纯静态、无动态覆盖」的阈值。
+ *  writeLoop / readFailed 以此为唯一真源；askLimit / maxWebSearch 属动态注入
+ *  （角色包 strategy / LOOP_CONSTANTS，历史曾把 20/8 塞进静态默认作死值、与运行时覆盖矛盾，经审查清除）。
+ *  调用方构造 GuardContext.thresholds 时须以本表为基底补齐两枚动态键。 */
+export declare const GUARD_THRESHOLDS: {
+    readonly writeLoop: 5;
+    readonly readFailed: 3;
+};
+/** read_dedup 撞墙升级阈值：同主体累计被本护栏硬拦达此值后，后续命中升级为强禁令文案
+ *  （值 2 = 第 3 次起升级；用户裁决 2026-09-28：第 2 次即升级太激进、第 3 次合适）。
+ *  不入 GUARD_THRESHOLDS——它不改变「拦不拦」，只切换文案强度。 */
+export declare const READ_DEDUP_ESCALATE_THRESHOLD = 2;
+/** 单工具 + 本 turn 运行态的护栏判定上下文 */
+export interface GuardContext {
+    toolName: string;
+    /** 原始工具参数 JSON 串（用于 subject 提取） */
+    argsJson: string;
+    toolCallId: string;
+    /** 工具结果防重缓存（read_dedup 分支①核查用） */
+    toolResultCache: ToolResultCache;
+    /** 分支①「结果仍是否在上下文」判定（loop 注入：读上下文内容） */
+    isCachedResultStillInContext: (hit: CacheEntry) => boolean;
+    /** 护栏阈值（loop 构造时填实际值；缺省回落 GUARD_THRESHOLDS） */
+    thresholds: GuardThresholds;
+    /** 运行态计数（loop 注入，供 search_limit/ask_limit 用；write_loop/read_failed 的计数已在 guard 闭包内） */
+    counters: GuardCounters;
+}
+/** 护栏定义（注册一条，主循环零改动） */
+export interface GuardRailDef {
+    /** 护栏类型 id */
+    id: GuardRailId;
+    /** 适用工具判定 */
+    matches: (c: GuardContext) => boolean;
+    /** 前置拦截判定：true = 需拦截 */
+    shouldBlock: (c: GuardContext) => boolean;
+    /** true = 真拦截（回填拒绝文案）/ false = 软提示 */
+    blocked: boolean;
+    /** 命中文案 key（引用 GUARD_RAIL_PROMPTS，勿内联文案）；函数形态 = 按 GuardContext 运行态选择
+     *  （read_dedup 撞墙升级：同主体被硬拦达阈值后切换 already_read_escalated） */
+    promptId: GuardRailPromptId | ((c: GuardContext) => GuardRailPromptId);
+    /** 模板插值参数（路径 / 次数 / 阈值等）；第二参 = evaluateBlocked 已裁决的命中文案 id，
+     *  参数按裁决结果分支（promptId 与 promptArgs 构造性一致，阈值判据不重复计算） */
+    promptArgs?: (c: GuardContext, chosen: GuardRailPromptId) => Record<string, unknown>;
+    /** 生命周期：perInput=按一次用户输入累计（含暂停-续跑链，跨 turn 保留）/ perTurn=按 turn（问答闭环）累计 */
+    life: 'perInput' | 'perTurn';
+    /** 副钩（仅 search）：命中后置 searchDisabled + rebuild system message；须幂等 */
+    afterBlock?: (c: GuardContext) => void;
+    /** 写侧钩子：结果处理阶段由 loop 对每个 toolCall 调 notifyExec 分发本钩子喂计数
+     *  （失败+1 / 成功清0 / 连写递增 / 拦截不计）。守卫自持闭包状态的统一入口。 */
+    onExec?: (c: GuardExecContext) => void;
+    /** 拦截归属钩子：本护栏**作为首个命中护栏**拦下调用时，由 loop 经 `notifyBlocked` 回喂。
+     *  与 onExec 的分工：onExec 只知「被某种护栏拦了」（三态喂入，无法区分拦截归属），
+     *  本钩子明确「被本护栏拦了」——read_dedup 撞墙升级计数以此喂数，
+     *  台账替身回显等非本护栏拦截不会误计。 */
+    onBlocked?: (toolName: string, argsJson: string) => void;
+    /** 归零 guard 自身内部计数状态（life 过期 / 轮边界由 GuardRail.reset 统一调用） */
+    reset?: () => void;
+    /** 注入 systemPrompt「## 行为护栏」节的通用约束声明（不强塞逐轮计数） */
+    promptGuideline?: string;
+}
+/** 命中结果：命中的护栏 + 渲染后的拒绝文案 */
+export interface GuardHit {
+    guardId: GuardRailId;
+    message: string;
+}
+/** 提取给定工具的请求主体（无该工具的 subject 提取器 → undefined，即非 info 型工具） */
+export declare function extractSubject(toolName: string, argsJson: string): DedupSubject | undefined;
+export declare const GUARD_RAIL_PROMPTS: Readonly<Record<GuardRailPromptId, string>>;
+/** 渲染护栏命中文案（占位符替换；未知键原样保留） */
+export declare function renderPrompt(promptId: GuardRailPromptId, args?: Record<string, unknown>): string;
+/**
+ * 守卫容器（注册表容器 + 统一判定入口）
+ *
+ * 判定纪律：`evaluateBlocked` 按注册顺序遍历，返回**首个** `matches && shouldBlock` 的硬拦命中。
+ * 注册顺序即判定优先级（read_failed 必须先于 read_dedup——失败先于去重判定，与 loop 既有语义一致）。
+ *
+ * 判定与状态均为真拦截/真状态：evaluateBlocked 由 loop 调用并回填拒绝文案；
+ * write_loop/read_failed 的计数状态内聚进 guard 实例闭包，由 notifyExec 写侧喂数、reset 归零。
+ */
+export declare class GuardRail {
+    /** 有序注册表（注册序即判定序） */
+    private readonly registry;
+    /** 注册一条护栏（返回 this 便于链式） */
+    register(def: GuardRailDef): this;
+    /** 注册表（只读视图，供测试/审计盘点） */
+    get guards(): ReadonlyArray<GuardRailDef>;
+    /** 统一判定入口：按注册序返回首个硬拦命中；无命中返回 undefined */
+    evaluateBlocked(c: GuardContext): GuardHit | undefined;
+    /** 拦截归属喂数：loop 在「某护栏命中并拦截」时调用，路由到该护栏的 onBlocked
+     *  （撞墙升级等「只认自己拦的」闭包计数以此喂数；未注册 onBlocked 的护栏为 no-op）。 */
+    notifyBlocked(guardId: GuardRailId, toolName: string, argsJson: string): void;
+    /** 写侧喂数钩子分发：结果处理阶段由 loop 对每个 toolCall 调此方法。
+     *  matches 校验复用 GuardContext 判定（构造最小临时 ctx）；命中即调 g.onExec 喂计数。 */
+    notifyExec(c: GuardExecContext): void;
+    /** 归零指定生命周期 guard 的内部计数状态（life 轮边界由 loop 调 resetTurnState 统一触发） */
+    reset(life: 'perInput' | 'perTurn'): void;
+    /** 生成「## 行为护栏」通用声明节（注入 buildSystemPrompt；只放通用约束，不暴露逐轮计数） */
+    buildPromptSection(): string;
+}
+/**
+ * 组装一份缺省护栏注册表：覆盖 5 种前置拦截型护栏，判定序 = read_failed 先于 read_dedup。
+ *
+ * 提供静态判定的**纯函数默认集**，loop 接入时可整表注册；阈值经 ctx.thresholds 由 loop 覆盖为实际值。
+ */
+export declare function createDefaultGuards(): GuardRail;
+//# sourceMappingURL=guardRail.d.ts.map

package/dist/agent/guardRail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardRail.d.ts","sourceRoot":"","sources":["../../src/agent/guardRail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAKL,eAAe,EACf,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,4BAA4B,CAAC;AAEpC,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,WAAW,GACX,YAAY,GACZ,aAAa,GACb,YAAY,CAAC;AAEjB,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GACzB,cAAc,GACd,WAAW,GACX,iBAAiB,GACjB,mBAAmB,GACnB,cAAc,GACd,wBAAwB,CAAC;AAE7B;wCACwC;AACxC,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,OAAO,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC;CACtC;AAED,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;qDAGqD;AACrD,eAAO,MAAM,gBAAgB;;;CAGyC,CAAC;AAEvE;;8CAE8C;AAC9C,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,+BAA+B;AAC/B,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,eAAe,EAAE,eAAe,CAAC;IACjC,uCAAuC;IACvC,4BAA4B,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC;IAC3D,+CAA+C;IAC/C,UAAU,EAAE,eAAe,CAAC;IAC5B,uFAAuF;IACvF,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,wBAAwB;AACxB,MAAM,WAAW,YAAY;IAC3B,cAAc;IACd,EAAE,EAAE,WAAW,CAAC;IAChB,aAAa;IACb,OAAO,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACtC,wBAAwB;IACxB,WAAW,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IAC1C,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB;gEAC4D;IAC5D,QAAQ,EAAE,iBAAiB,GAAG,CAAC,CAAC,CAAC,EAAE,YAAY,KAAK,iBAAiB,CAAC,CAAC;IACvE;2DACuD;IACvD,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrF,yEAAyE;IACzE,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,oEAAoE;IACpE,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC;qDACiD;IACjD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACvC;;;6BAGyB;IACzB,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,4BAA4B;AAC5B,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAG3F;AAiBD,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CA4B1E,CAAC;AAEF,8BAA8B;AAC9B,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,MAAM,CAMR;AAgBD;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACpB,qBAAqB;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAE/C,2BAA2B;IAC3B,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;IAKjC,yBAAyB;IACzB,IAAI,MAAM,IAAI,aAAa,CAAC,YAAY,CAAC,CAExC;IAED,0CAA0C;IAC1C,eAAe,CAAC,CAAC,EAAE,YAAY,GAAG,QAAQ,GAAG,SAAS;IAatD;4DACwD;IACxD,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI7E;sEACkE;IAClE,UAAU,CAAC,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAgBrC,mEAAmE;IACnE,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI;IAMzC,4DAA4D;IAC5D,kBAAkB,IAAI,MAAM;CAK7B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,CA4I/C"}