hyacinth-ai 0.9.6

package/dist/registry/tool.registry.js

@@ -0,0 +1,185 @@
+import { GenericRegistry } from './base.js';
+import { getActiveRouterName } from '../context/profiles.js';
+import path from 'node:path';
+import fs from 'node:fs';
+import { createGetConfigTool, createUpdateConfigTool, createConfigSchemaTool, createResetConfigTool, } from '../tools/config.js';
+import { createSwitchProviderTool, createListProvidersTool, createProviderInfoTool, createSwitchToAutoRouteTool, createToggleToolTool, createListToolsTool, createToggleSkillTool, createListSkillsTool, createToggleSubAgentTool, createListSubAgentsTool, createSpawnSubAgentTool, createCreateSubAgentTool, createUpdateSubAgentTool, createInterruptTool, createSessionStatsTool, createCurrentSessionTool, createListSessionsTool, createNewSessionTool, createSwitchSessionTool, createDeleteSessionTool, createAllowToolTool, createDisallowToolTool, createListAllowlistTool, createAddTaskTool, createRemoveTaskTool, createListTasksTool, createToggleTaskTool, createMcpStatusTool, createListModelChannelsTool, createAddModelChannelTool, createRemoveModelChannelTool, createSetChannelRoleTool, createSetChannelModelTool, createResetChannelModelTool, createChannelInfoTool, } from '../tools/runtime-control.js';
+/**
+ * 工具注册表
+ * 负责注册、查询工具，以及生成 LLM 格式的工具定义
+ * 继承自 GenericRegistry，复用通用增删改查逻辑
+ */
+export class ToolRegistry extends GenericRegistry {
+    /** 会话中热插拔添加的工具名集合。下次启动时清空，工具自然归位到 tool_rules。 */
+    hotAddedNames = new Set();
+    constructor() {
+        super();
+    }
+    // ── 热插拔工具追踪 ──────────────────────────────────────────
+    /** 标记工具为热插拔添加（会话临时）。调用方：hot-reload/tool-watcher.ts */
+    markHotAdded(name) {
+        this.hotAddedNames.add(name);
+    }
+    /** 获取所有热插拔工具名（用于 Zone 5 session_tools 展示） */
+    getHotAddedNames() {
+        return [...this.hotAddedNames].sort();
+    }
+    /** 清空热插拔标记（下次启动时，所有工具自然都在 ToolRegistry 中） */
+    clearHotAdded() {
+        this.hotAddedNames.clear();
+    }
+    // ── LLM 工具定义 ──────────────────────────────────────────────
+    /**
+     * 生成 LLM 格式的工具定义数组
+     * 用于发送给 LLM API，告知可用工具及其参数格式
+     * 禁用的工具不会被包含。
+     *
+     * 陪伴模式下优先使用 companionDescription（拟人化描述），
+     * 避免「退出陪伴模式」等人设冲突措辞。
+     */
+    getToolDefinitions(companionMode) {
+        const isCompanion = companionMode ?? false;
+        return this.getAll()
+            .map((tool) => ({
+            name: tool.name,
+            description: isCompanion && tool.companionDescription
+                ? tool.companionDescription
+                : tool.description,
+            input_schema: tool.inputSchema,
+        }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    // ── 批量注册辅助方法 ──────────────────────────────────────────
+    /**
+     * 注册配置管理工具（get_config, update_config, config_schema, reset_config）
+     */
+    registerConfigTools(configCenter) {
+        this.register(createGetConfigTool(configCenter));
+        this.register(createUpdateConfigTool(configCenter));
+        this.register(createConfigSchemaTool(configCenter));
+        this.register(createResetConfigTool(configCenter));
+    }
+    /**
+     * 注册所有运行时控制工具（30+ tools）
+     *
+     * ⚠️ 新增运行时工具的正确方式：
+     *   1. 在 src/tools/runtime-control.ts 中创建 createXxxTool() 工厂函数
+     *   2. 在下方各分类段落中按类别注册
+     *   3. 禁止在 factory.ts / loop.ts 中直接 new Tool() 硬编码
+     *
+     * Provider tools (4):
+     *   switch_provider, list_providers, provider_info, switch_to_auto_route
+     *
+     * Registry control tools (9):
+     *   toggle_tool, list_tools, toggle_skill, list_skills,
+     *   toggle_sub_agent, list_sub_agents, spawn_sub_agent, create_sub_agent,
+     *   update_sub_agent
+     *
+     * Session control tools (7):
+     *   interrupt, session_stats, current_session, list_sessions, new_session, switch_session, delete_session
+     *
+     * Permission whitelist tools (3):
+     *   allow_tool, disallow_tool, list_allowlist
+     *
+     * Schedule task management tools (4):
+     *   add_task, remove_task, list_tasks, toggle_task
+     */
+    registerRuntimeControlTools(agentLoop, providerRouter, skillRegistry, agentRegistry, configCenter, cwd, heartbeatScheduler, mcpSystem, modelRouter) {
+        // ── Provider tools (4) ──────────────────────────────────────────
+        this.register(createSwitchProviderTool(agentLoop));
+        this.register(createListProvidersTool(providerRouter));
+        this.register(createProviderInfoTool(agentLoop));
+        this.register(createSwitchToAutoRouteTool(agentLoop));
+        // ── Model channel tools (4) ─────────────────────────────────────
+        if (modelRouter) {
+            this.register(createListModelChannelsTool(modelRouter));
+            this.register(createAddModelChannelTool(modelRouter));
+            this.register(createRemoveModelChannelTool(modelRouter));
+            this.register(createSetChannelRoleTool(modelRouter));
+            this.register(createSetChannelModelTool(modelRouter));
+            this.register(createResetChannelModelTool(modelRouter));
+            this.register(createChannelInfoTool(modelRouter));
+        }
+        // ── Registry control tools (8) ──────────────────────────────────
+        this.register(createToggleToolTool(this, configCenter));
+        this.register(createListToolsTool(this));
+        this.register(createToggleSkillTool(skillRegistry, configCenter));
+        this.register(createListSkillsTool(skillRegistry));
+        this.register(createToggleSubAgentTool(agentRegistry, configCenter));
+        this.register(createListSubAgentsTool(agentRegistry));
+        this.register(createSpawnSubAgentTool(agentRegistry));
+        this.register(createCreateSubAgentTool(agentRegistry, cwd));
+        this.register(createUpdateSubAgentTool(agentRegistry));
+        // destroy_sub_agent needs factory.ts sessionDir; register in factory.ts after loop is created
+        // (handled by importing and registering createDestroySubAgentTool directly in factory.ts)
+        // ── Session control tools (7) ────────────────────────
+        this.register(createInterruptTool(agentLoop));
+        this.register(createSessionStatsTool(agentLoop));
+        this.register(createCurrentSessionTool(agentLoop));
+        this.register(createListSessionsTool(agentLoop, cwd));
+        this.register(createNewSessionTool(agentLoop, cwd));
+        this.register(createSwitchSessionTool(agentLoop, cwd));
+        this.register(createDeleteSessionTool(agentLoop, cwd));
+        // ── MCP status tool ────────────────────────────────────────────
+        if (mcpSystem) {
+            this.register(createMcpStatusTool(mcpSystem));
+        }
+        // ── Permission whitelist tools (3) ───────────────────────────────
+        if (configCenter) {
+            this.register(createAllowToolTool(configCenter));
+            this.register(createDisallowToolTool(configCenter));
+            this.register(createListAllowlistTool(configCenter));
+        }
+        // ── Schedule task management tools (4) ───────────────────────────
+        if (heartbeatScheduler) {
+            // 自动检测当前 session 的渠道（从 meta.json 读取），
+            // 这样模型无需手动指定 channel，任务自动归属到创建时的渠道。
+            const getChannel = () => {
+                try {
+                    const sessionDir = agentLoop?.sessionDir;
+                    if (sessionDir) {
+                        const metaPath = path.join(sessionDir, 'meta.json');
+                        if (fs.existsSync(metaPath)) {
+                            const meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+                            return meta.channel || undefined;
+                        }
+                    }
+                }
+                catch { /* 读取失败不阻塞 */ }
+                return undefined;
+            };
+            // 自动检测当前 sessionId（多会话渠道如飞书需要此字段确定回复目标）
+            const getSessionId = () => {
+                try {
+                    const sessionDir = agentLoop?.sessionDir;
+                    if (sessionDir) {
+                        return path.basename(sessionDir);
+                    }
+                }
+                catch { /* 读取失败不阻塞 */ }
+                return undefined;
+            };
+            // 自动检测当前模式（正常/陪伴），用于任务隔离
+            const getMode = () => {
+                const routerName = getActiveRouterName();
+                if (routerName === 'companion')
+                    return 'companion';
+                return 'normal';
+            };
+            this.register(createAddTaskTool(heartbeatScheduler, getChannel, getSessionId, getMode));
+            this.register(createRemoveTaskTool(heartbeatScheduler, getMode));
+            this.register(createListTasksTool(heartbeatScheduler, getMode));
+            this.register(createToggleTaskTool(heartbeatScheduler, getMode));
+        }
+    }
+    // ── 向后兼容别名 ──────────────────────────────────────────────
+    /** @deprecated 使用 enable() 替代 */
+    enableTool(name) {
+        this.enable(name);
+    }
+    /** @deprecated 使用 disable() 替代 */
+    disableTool(name) {
+        this.disable(name);
+    }
+}
+//# sourceMappingURL=tool.registry.js.map

package/dist/repair/loop-guard.d.ts

@@ -0,0 +1,98 @@
+/**
+ * LoopGuard — 统一防重复输出检测器
+ *
+ * 两层检测：
+ *   ToolGuard — 工具调用重复检测（原 StormBreaker）
+ *   TextGuard — 文本输出重复检测（新增）
+ *
+ * 每次用户输入时调用 reset()，同一轮内累积检测。
+ */
+import type { ToolCall } from '../types.js';
+export interface LoopGuardConfig {
+    /** 工具检测 */
+    tool: {
+        enabled: boolean;
+        windowSize: number;
+        threshold: number;
+        /** 豁免工具名列表 */
+        exemptTools: string[];
+    };
+    /** 文本检测 */
+    text: {
+        enabled: boolean;
+        windowSize: number;
+        threshold: number;
+        minLength: number;
+        similarity: number;
+    };
+}
+export declare const DEFAULT_LOOP_GUARD_CONFIG: LoopGuardConfig;
+export declare function isMutating(name: string): boolean;
+export declare class TextGuard {
+    private window;
+    private streak;
+    private config;
+    constructor(config?: Partial<LoopGuardConfig['text']>);
+    reset(): void;
+    /**
+     * 检查一条 assistant 文本输出是否与最近输出重复。
+     * 返回 true 表示检测到文本输出循环（连续超过 threshold 次高相似度）。
+     */
+    check(text: string): boolean;
+    /** 获取反思提示词 */
+    static reflectionPrompt(): string;
+}
+export declare class ToolGuard {
+    private window;
+    private config;
+    constructor(config?: Partial<LoopGuardConfig['tool']>);
+    reset(): void;
+    /**
+     * 检查工具调用是否应被抑制。
+     * 返回被抑制的 ToolCall ID 集合。
+     */
+    check(calls: ToolCall[]): Set<string>;
+    static reflectionPrompt(call: ToolCall): string;
+}
+export type LoopGuardEvent = 'tool_storm' | 'text_loop';
+export interface LoopGuardCheckResult {
+    /** 触发的检测类型 */
+    triggered: LoopGuardEvent[];
+    /** 被抑制的工具调用 ID（tool_storm 时） */
+    suppressedToolIds: Set<string>;
+    /** 是否有文本循环（text_loop 时） */
+    textLoopDetected: boolean;
+    /** 文本循环的反思消息 */
+    textReflection?: string;
+    /** 被抑制的工具调用的反思消息（按 tool_use_id 索引） */
+    toolReflections: Map<string, string>;
+}
+/**
+ * LoopGuard — 统一防重复输出检测器。
+ *
+ * 每次用户输入时调用 reset() 清零所有计数。
+ * guardCount 记录连续触发次数（工具抑制或文本循环），
+ * 外部在每轮 runTurn 后检查 guardCount，超过阈值后强制 stop。
+ */
+export declare class LoopGuard {
+    readonly toolGuard: ToolGuard;
+    readonly textGuard: TextGuard;
+    /** 连续触发次数（工具抑制 + 文本循环，取并集） */
+    guardCount: number;
+    private maxTriggers;
+    /** 是否已达到触发上限，外部应在每轮后检查并强制 stop */
+    get escalated(): boolean;
+    constructor(config?: Partial<LoopGuardConfig & {
+        maxTriggers?: number;
+    }>);
+    reset(): void;
+    checkToolCalls(calls: ToolCall[]): {
+        suppressed: Set<string>;
+        reflections: Map<string, string>;
+    };
+    checkTextOutput(text: string): {
+        loop: boolean;
+        reflection?: string;
+    };
+}
+//# sourceMappingURL=loop-guard.d.ts.map

package/dist/repair/loop-guard.js

@@ -0,0 +1,217 @@
+/**
+ * LoopGuard — 统一防重复输出检测器
+ *
+ * 两层检测：
+ *   ToolGuard — 工具调用重复检测（原 StormBreaker）
+ *   TextGuard — 文本输出重复检测（新增）
+ *
+ * 每次用户输入时调用 reset()，同一轮内累积检测。
+ */
+// ── Constants ──────────────────────────────────────────────────────────
+const TOOL_WINDOW = 6;
+const TOOL_THRESHOLD = 3;
+const TEXT_WINDOW = 6;
+const TEXT_THRESHOLD = 3;
+const TEXT_MIN_LENGTH = 30; // 短于 30 字符不检测
+const TEXT_SIMILARITY = 0.90; // Jaccard 相似度阈值（LLM 循环时输出高度一致）
+const MUTATING_TOOLS = new Set(['write', 'edit', 'bash', 'delete', 'multi_edit']);
+const MCP_SIDE_EFFECT_KEYWORDS = new Set([
+    'navigate', 'create', 'delete', 'open', 'write', 'execute',
+    'run', 'start', 'launch', 'install', 'remove', 'update',
+    'send', 'post', 'put', 'patch',
+]);
+export const DEFAULT_LOOP_GUARD_CONFIG = {
+    tool: {
+        enabled: true,
+        windowSize: TOOL_WINDOW,
+        threshold: TOOL_THRESHOLD,
+        exemptTools: [],
+    },
+    text: {
+        enabled: true,
+        windowSize: TEXT_WINDOW,
+        threshold: TEXT_THRESHOLD,
+        minLength: TEXT_MIN_LENGTH,
+        similarity: TEXT_SIMILARITY,
+    },
+};
+// ── Helpers ────────────────────────────────────────────────────────────
+export function isMutating(name) {
+    if (MUTATING_TOOLS.has(name))
+        return true;
+    if (name.startsWith('mcp__')) {
+        const toolName = name.split('__')[2];
+        if (toolName) {
+            const lower = toolName.toLowerCase();
+            for (const kw of MCP_SIDE_EFFECT_KEYWORDS) {
+                // 用词边界匹配，避免 "open" 误杀 "openFileInfo" 等只读工具
+                const re = new RegExp(`(^|_)${kw}($|_)`);
+                if (re.test(lower))
+                    return true;
+            }
+        }
+    }
+    return false;
+}
+function argsSignature(input) {
+    return JSON.stringify(input, Object.keys(input).sort());
+}
+/**
+ * 单词级 Jaccard 相似度。
+ * 两个文本分词后计算交集 / 并集。
+ */
+function wordJaccard(a, b) {
+    const tokenize = (s) => {
+        const tokens = s.toLowerCase().split(/[\s,.;:!?(){}\[\]"'-]+/).filter(t => t.length > 1);
+        return new Set(tokens);
+    };
+    const sa = tokenize(a);
+    const sb = tokenize(b);
+    if (sa.size === 0 || sb.size === 0)
+        return 0;
+    const intersection = new Set([...sa].filter(x => sb.has(x)));
+    const union = new Set([...sa, ...sb]);
+    return intersection.size / union.size;
+}
+// ── TextGuard ──────────────────────────────────────────────────────────
+export class TextGuard {
+    window = [];
+    streak = 0;
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_LOOP_GUARD_CONFIG.text, ...config };
+    }
+    reset() {
+        this.window = [];
+        this.streak = 0;
+    }
+    /**
+     * 检查一条 assistant 文本输出是否与最近输出重复。
+     * 返回 true 表示检测到文本输出循环（连续超过 threshold 次高相似度）。
+     */
+    check(text) {
+        if (!this.config.enabled)
+            return false;
+        if (!text || text.length < this.config.minLength)
+            return false;
+        // 与窗口内已有文本对比
+        let maxSim = 0;
+        for (const prev of this.window) {
+            // 完全一致 → 1.0
+            const sim = text === prev ? 1.0 : wordJaccard(text, prev);
+            maxSim = Math.max(maxSim, sim);
+        }
+        if (maxSim >= this.config.similarity) {
+            this.streak++;
+        }
+        else {
+            this.streak = 0;
+        }
+        // 加入窗口
+        this.window.push(text);
+        if (this.window.length > this.config.windowSize) {
+            this.window.shift();
+        }
+        return this.streak >= this.config.threshold;
+    }
+    /** 获取反思提示词 */
+    static reflectionPrompt() {
+        return `[LoopGuard] 检测到最近的回复高度相似。你可能陷入了重复输出循环。请尝试不同的思路或询问用户。`;
+    }
+}
+// ── ToolGuard (原 StormBreaker) ────────────────────────────────────────
+export class ToolGuard {
+    window = [];
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_LOOP_GUARD_CONFIG.tool, ...config };
+    }
+    reset() {
+        this.window = [];
+    }
+    /**
+     * 检查工具调用是否应被抑制。
+     * 返回被抑制的 ToolCall ID 集合。
+     */
+    check(calls) {
+        const suppressed = new Set();
+        for (const call of calls) {
+            if (this.config.exemptTools.includes(call.name)) {
+                this.window.push({ name: call.name, argsSignature: argsSignature(call.input) });
+                continue;
+            }
+            if (isMutating(call.name)) {
+                this.window = [];
+                this.window.push({ name: call.name, argsSignature: argsSignature(call.input) });
+                continue;
+            }
+            const sig = argsSignature(call.input);
+            const existing = this.window.filter(w => w.name === call.name && w.argsSignature === sig);
+            if (existing.length >= this.config.threshold - 1) {
+                suppressed.add(call.id);
+            }
+            else {
+                this.window.push({ name: call.name, argsSignature: sig });
+                if (this.window.length > this.config.windowSize) {
+                    this.window.shift();
+                }
+            }
+        }
+        return suppressed;
+    }
+    static reflectionPrompt(call) {
+        // 使用 [LoopGuard] 而非 [System]，避免被 injection-filter 误杀
+        return `[LoopGuard] 工具 \`${call.name}\` 被重复调用且参数相同。请考虑其他方式或询问用户。`;
+    }
+}
+/**
+ * LoopGuard — 统一防重复输出检测器。
+ *
+ * 每次用户输入时调用 reset() 清零所有计数。
+ * guardCount 记录连续触发次数（工具抑制或文本循环），
+ * 外部在每轮 runTurn 后检查 guardCount，超过阈值后强制 stop。
+ */
+export class LoopGuard {
+    toolGuard;
+    textGuard;
+    /** 连续触发次数（工具抑制 + 文本循环，取并集） */
+    guardCount = 0;
+    maxTriggers;
+    /** 是否已达到触发上限，外部应在每轮后检查并强制 stop */
+    get escalated() {
+        return this.guardCount >= this.maxTriggers;
+    }
+    constructor(config) {
+        this.toolGuard = new ToolGuard(config?.tool);
+        this.textGuard = new TextGuard(config?.text);
+        this.maxTriggers = config?.maxTriggers ?? 5;
+    }
+    reset() {
+        this.toolGuard.reset();
+        this.textGuard.reset();
+        this.guardCount = 0;
+    }
+    checkToolCalls(calls) {
+        const suppressed = this.toolGuard.check(calls);
+        const reflections = new Map();
+        if (suppressed.size > 0) {
+            this.guardCount++;
+            for (const id of suppressed) {
+                const call = calls.find(c => c.id === id);
+                if (call)
+                    reflections.set(id, ToolGuard.reflectionPrompt(call));
+            }
+        }
+        return { suppressed, reflections };
+    }
+    checkTextOutput(text) {
+        const loop = this.textGuard.check(text);
+        if (loop) {
+            this.guardCount++;
+        }
+        return loop
+            ? { loop: true, reflection: TextGuard.reflectionPrompt() }
+            : { loop: false };
+    }
+}
+//# sourceMappingURL=loop-guard.js.map

package/dist/repair/scavenge.d.ts

@@ -0,0 +1,19 @@
+import type { ToolCall } from '../types.js';
+/**
+ * 从 thinking/content 文本中回收遗漏的工具调用。
+ *
+ * 某些模型（尤其是 DeepSeek R1）可能在 reasoning/thinking 块中生成
+ * 完整的工具调用 JSON，但忘记在正式的 tool_calls 中声明。
+ * Scavenge 扫描两个通道（thinking + text），提取遗漏的调用并补充到 toolCalls 数组。
+ *
+ * @param thinkingParts - 流式收集的 thinking 块内容
+ * @param textParts - 流式收集的 text 块内容
+ * @param existingCalls - 模型正式声明的 tool_calls（避免重复）
+ * @param allowedNames - 可选的工具名白名单，null 表示允许所有
+ * @returns 合并后的 ToolCall 数组（原有 + 回收的）
+ */
+export declare function scavengeToolCalls(thinkingParts: string[], textParts: string[], existingCalls: ToolCall[], allowedNames?: Set<string> | null): ToolCall[];
+export declare function isScavengeEnabled(config?: {
+    enabled?: boolean;
+}): boolean;
+//# sourceMappingURL=scavenge.d.ts.map

package/dist/repair/scavenge.js

@@ -0,0 +1,81 @@
+const TOOL_CALL_PATTERNS = [
+    /\{\s*"name"\s*:\s*"([^"]+)",\s*"(?:arguments|input)"\s*:\s*(\{[^}]+\})\s*\}/g,
+    /<tool_call>\s*(\{[\s\S]*?\})\s*<\/tool_call>/g,
+    /<function=([a-z_][\w]*)>\s*(\{[\s\S]*?\})\s*<\/function>/g,
+    /\n?```json\s*\n(\{[\s\S]*?\})\s*\n```\n?/g,
+];
+function extractJsonObjects(text) {
+    const results = [];
+    const seen = new Set();
+    for (const pattern of TOOL_CALL_PATTERNS) {
+        pattern.lastIndex = 0;
+        let match;
+        while ((match = pattern.exec(text)) !== null) {
+            const jsonStr = match[1] || match[2];
+            if (!jsonStr)
+                continue;
+            if (seen.has(jsonStr))
+                continue;
+            seen.add(jsonStr);
+            try {
+                const parsed = JSON.parse(jsonStr);
+                if (parsed && typeof parsed === 'object' && typeof parsed.name === 'string') {
+                    results.push(parsed);
+                }
+            }
+            catch {
+                // 不是有效 JSON，跳过
+            }
+        }
+    }
+    return results;
+}
+function generateToolCallId(name, args) {
+    const hash = JSON.stringify(args).length.toString(36) + Date.now().toString(36).slice(-4);
+    return `scvg_${name}_${hash}`;
+}
+function isDuplicate(existing, name, args) {
+    return existing.some(tc => tc.name === name && JSON.stringify(tc.input) === JSON.stringify(args));
+}
+/**
+ * 从 thinking/content 文本中回收遗漏的工具调用。
+ *
+ * 某些模型（尤其是 DeepSeek R1）可能在 reasoning/thinking 块中生成
+ * 完整的工具调用 JSON，但忘记在正式的 tool_calls 中声明。
+ * Scavenge 扫描两个通道（thinking + text），提取遗漏的调用并补充到 toolCalls 数组。
+ *
+ * @param thinkingParts - 流式收集的 thinking 块内容
+ * @param textParts - 流式收集的 text 块内容
+ * @param existingCalls - 模型正式声明的 tool_calls（避免重复）
+ * @param allowedNames - 可选的工具名白名单，null 表示允许所有
+ * @returns 合并后的 ToolCall 数组（原有 + 回收的）
+ */
+export function scavengeToolCalls(thinkingParts, textParts, existingCalls, allowedNames) {
+    const combined = [...thinkingParts, ...textParts].filter(Boolean).join('\n');
+    if (!combined.trim())
+        return existingCalls;
+    const scavenged = [];
+    const found = extractJsonObjects(combined);
+    for (const obj of found) {
+        const name = obj.name;
+        const args = (obj.arguments || obj.input || {});
+        if (!name)
+            continue;
+        if (allowedNames && !allowedNames.has(name))
+            continue;
+        if (isDuplicate(existingCalls, name, args))
+            continue;
+        if (isDuplicate(scavenged, name, args))
+            continue;
+        scavenged.push({
+            id: generateToolCallId(name, args),
+            name,
+            input: args,
+        });
+    }
+    return [...existingCalls, ...scavenged];
+}
+export function isScavengeEnabled(config) {
+    return config?.enabled !== false;
+}
+//# sourceMappingURL=scavenge.js.map

package/dist/repair/storm.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 向后兼容层 — 所有实现已迁移至 loop-guard.ts
+ *
+ * @deprecated 新代码请直接从 ../repair/loop-guard.js 导入 LoopGuard / ToolGuard 等
+ */
+export { ToolGuard as StormBreaker, isMutating } from './loop-guard.js';
+//# sourceMappingURL=storm.d.ts.map

package/dist/repair/storm.js

@@ -0,0 +1,7 @@
+/**
+ * 向后兼容层 — 所有实现已迁移至 loop-guard.ts
+ *
+ * @deprecated 新代码请直接从 ../repair/loop-guard.js 导入 LoopGuard / ToolGuard 等
+ */
+export { ToolGuard as StormBreaker, isMutating } from './loop-guard.js';
+//# sourceMappingURL=storm.js.map

package/dist/rollback/index.d.ts

@@ -0,0 +1,5 @@
+export { TurnStore } from './turn-store.js';
+export { TurnRecorder } from './turn-recorder.js';
+export { createRollbackStatusTool, createRollbackTool } from './rollback-tool.js';
+export type { TurnRecord, ChangedFile, RollbackStatusResult, RollbackStatusEntry, RollbackIndex } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/rollback/index.js

@@ -0,0 +1,4 @@
+export { TurnStore } from './turn-store.js';
+export { TurnRecorder } from './turn-recorder.js';
+export { createRollbackStatusTool, createRollbackTool } from './rollback-tool.js';
+//# sourceMappingURL=index.js.map

package/dist/rollback/rollback-tool.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 回滚工具 — rollback_status + rollback
+ *
+ * 两个独立工具，通过工厂函数创建：
+ *   - createRollbackStatusTool: 查看可回滚的回合列表
+ *   - createRollbackTool: 执行回滚操作
+ */
+import type { Tool } from '../tools/interface.js';
+import type { TurnStore } from './turn-store.js';
+import type { GitManager } from '../evolution/git-manager.js';
+export declare function createRollbackStatusTool(turnStore: TurnStore, getCurrentTurn: () => number): Tool;
+export declare function createRollbackTool(turnStore: TurnStore, gitManager: GitManager, getCurrentTurn: () => number): Tool;
+//# sourceMappingURL=rollback-tool.d.ts.map