mocode-ai 1.2.7 → 1.2.9

package/dist/project-skill/initializer.js

@@ -1,178 +0,0 @@
-/**
- * 项目 Skill 初始化器 - 派生子 agent 带工具深度探索项目，生成高质量的初始 skill
- */
-import { spawnAgent } from '../agent/spawn.js';
-/**
- * 子 agent 的系统提示后缀：角色与输出格式约束
- */
-const SKILL_INIT_SUFFIX = `You are a project exploration agent. Your task is to deeply understand this project and generate a concise "Project Skill" document.
-
-## ⚠️ Complementary to Snapshot — CRITICAL
-The following information is ALREADY provided by Project Snapshot — **do NOT repeat**:
-- ✗ Project one-liner description (快照已有)
-- ✗ Module names and file locations (快照 srcTree 已有)
-- ✗ Tech stack names and versions (快照 techStack 已有)
-- ✗ Build/test commands (快照 keyCommands 已有)
-- ✗ File lists and directory structure (快照 srcTree 已有)
-
-**Your job is to capture INSIGHTS only:**
-- **WHY** — design decisions, trade-offs, reasons for choosing X over Y
-- **HOW** — module behaviors, data flows, call chains, non-obvious interactions
-- **GOTCHAS** — pitfalls, edge cases, non-intuitive behaviors
-- **CONVENTIONS** — naming patterns, code style, unwritten rules
-
-## Exploration Strategy
-1. Use \`codegraph\` to trace call chains and understand module interactions
-2. Read core modules to understand **behaviors** (not just names)
-3. Look for complex logic, error handling patterns, unusual configs
-4. Identify naming conventions, common abstractions
-
-## Output Format
-Output the skill document between these exact delimiters:
-
-\`\`\`skill-start
-## 架构要点
-### 核心模块及职责
-- **\`path/to/module\`** — 行为描述（做什么 + 怎么做）
-...
-
-### 关键设计决策
-- 决策：原因
-...
-
-## 项目约定
-- 约定（具体的，有例子的）
-...
-
-## 开发流程
-- 命令 + 注意事项/坑点（命令本身快照已有，这里只写注意什么）
-...
-
-## 常见坑点
-- 坑：解法
-...
-\`\`\`skill-end
-
-## Rules — MUST FOLLOW
-1. 禁止列出文件名清单或目录结构
-2. 禁止列出依赖名和版本
-3. 禁止写项目概述/一句话描述
-4. 禁止只写命令本身（快照已有），只写注意事项
-5. 每个模块描述必须包含行为（做什么 + 怎么协作），不只是名称
-6. **总长度目标 3000-4000 字符，硬上限 4000**
-7. 写可操作的内容，用具体路径和例子
-8. 如果某个 section 没有实质内容，省略它
-`;
-/**
- * 生成初始项目 Skill（使用子 agent 深度探索）
- * @param existingSkill 已有的 skill 内容（如果有，子 agent 会在其基础上优化）
- * @param signal AbortSignal
- */
-export async function generateInitialSkill(existingSkill, signal) {
-    const hasExisting = !!existingSkill;
-    let prompt;
-    if (hasExisting) {
-        prompt = `以下是当前的项目 Skill 内容，请深度探索项目并优化/完善它：
-
-\`\`\`markdown
-${existingSkill}
-\`\`\`
-
-## 优化方向
-1. 补充缺失的信息（架构要点、设计决策、调用链等）
-2. 修正过时或不准确的内容
-3. 让描述更具体（用实际路径和例子）
-4. 删除冗余或空泛的描述
-5. 如果发现新的坑点或约定，添加进去
-
-记住：保持精简，总长度控制在 4000-5000 字符。输出完整的优化后版本。`;
-    }
-    else {
-        prompt = `请深度探索当前项目，生成一份项目专属 Skill 文档。
-
-## 探索步骤
-1. 先用 glob 扫描项目结构（**/*.ts, **/*.json 等）
-2. 读取 package.json、README.md、tsconfig.json 等关键文件
-3. 用 codegraph 或 grep 找到主入口、核心模块、关键接口
-4. 理解架构模式、数据流向、调用关系
-5. 识别命名约定、代码风格、测试策略
-6. 找出可能的坑点（复杂配置、特殊依赖、构建陷阱）
-
-## 输出
-探索完成后，将完整的 skill 文档输出在 \`\`\`skill-start 和 \`\`\`skill-end 之间。
-
-记住：内容要精简、可操作、有具体路径和例子。总长度控制在 4000-5000 字符。`;
-    }
-    try {
-        const result = await spawnAgent({
-            prompt,
-            systemPromptSuffix: SKILL_INIT_SUFFIX,
-            tools: ['read_file', 'glob', 'grep', 'codegraph'],
-            maxSteps: 30,
-            signal,
-        });
-        if (!result.completed) {
-            return {
-                ok: false,
-                error: '子 agent 未完成（可能中断或超时）',
-                transcript: result.transcript,
-            };
-        }
-        if (!result.summary) {
-            return {
-                ok: false,
-                error: '子 agent 未返回内容',
-                transcript: result.transcript,
-            };
-        }
-        // 从 summary 中提取 skill 内容
-        const skillMatch = result.summary.match(/```skill-start\n([\s\S]*?)\n```skill-end/);
-        if (!skillMatch || !skillMatch[1]) {
-            // 如果没有找到 delimiters，尝试从最后一段 markdown 代码块提取
-            const codeBlockMatch = result.summary.match(/```(?:markdown|md)?\n([\s\S]*?)\n```/);
-            if (codeBlockMatch && codeBlockMatch[1]) {
-                return {
-                    ok: true,
-                    content: codeBlockMatch[1].trim(),
-                    transcript: result.transcript,
-                };
-            }
-            // 如果连代码块都没有，直接用 summary（但去掉开头的探索日志）
-            const lines = result.summary.split('\n');
-            const skillStartIdx = lines.findIndex((l) => l.startsWith('## '));
-            if (skillStartIdx > 0) {
-                return {
-                    ok: true,
-                    content: lines.slice(skillStartIdx).join('\n').trim(),
-                    transcript: result.transcript,
-                };
-            }
-            return {
-                ok: false,
-                error: '无法从子 agent 输出中提取 skill 内容',
-                transcript: result.transcript,
-            };
-        }
-        const content = skillMatch[1].trim();
-        // 检查长度
-        if (content.length > 6000) {
-            return {
-                ok: false,
-                error: `生成内容过长 (${content.length} 字符)，请手动精简后重试`,
-                transcript: result.transcript,
-            };
-        }
-        return {
-            ok: true,
-            content,
-            transcript: result.transcript,
-        };
-    }
-    catch (e) {
-        return {
-            ok: false,
-            error: e instanceof Error ? e.message : '未知错误',
-            transcript: '',
-        };
-    }
-}

package/dist/project-snapshot/index.js

@@ -1,85 +0,0 @@
-import { createHash } from 'node:crypto';
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import path from 'node:path';
-import { getSandboxRoot } from '../sandbox/root.js';
-/** 内存缓存：当前 session 的快照（避免重复 IO） */
-let currentSnapshot = null;
-/** 计算 sandboxRoot 的 hash，用作目录名（避免路径特殊字符） */
-export function hashRoot(root) {
-    return createHash('sha256').update(root).digest('hex').slice(0, 16);
-}
-/** 快照存储目录 */
-function snapshotDir() {
-    const root = getSandboxRoot() ?? process.cwd();
-    return path.join(process.cwd(), '.mocode', 'projects', hashRoot(root));
-}
-/** 快照文件路径 */
-function snapshotPath() {
-    return path.join(snapshotDir(), 'snapshot.md');
-}
-/** 从磁盘加载快照（不存在/损坏返 null） */
-export function loadSnapshot() {
-    if (currentSnapshot)
-        return currentSnapshot;
-    const p = snapshotPath();
-    if (!existsSync(p))
-        return null;
-    try {
-        const content = readFileSync(p, 'utf8');
-        // 从 markdown 文件头部的 YAML front matter 提取元数据
-        const match = content.match(/^---\nroot: (.+)\nbuiltAt: (.+)\nversion: (\d+)\n---\n\n([\s\S]+)$/);
-        if (!match)
-            return null;
-        const snap = {
-            version: parseInt(match[3]),
-            root: match[1],
-            builtAt: match[2],
-            content: match[4],
-        };
-        currentSnapshot = snap;
-        return snap;
-    }
-    catch {
-        return null;
-    }
-}
-/** 获取当前快照（内存缓存优先，然后磁盘） */
-export function getSnapshot() {
-    return currentSnapshot ?? loadSnapshot();
-}
-export async function buildSnapshot(signal, force = false) {
-    // 检查缓存：已有快照且不强制刷新，直接返回
-    if (!force) {
-        const cached = getSnapshot();
-        if (cached)
-            return { snapshot: cached };
-    }
-    const root = getSandboxRoot() ?? process.cwd();
-    // 动态导入避免循环依赖
-    const { generateLLMSnapshot } = await import('./llm-snapshot.js');
-    const result = await generateLLMSnapshot(root, signal);
-    if (!result.ok || !result.content) {
-        return {
-            snapshot: null,
-            error: result.error || 'LLM 未返回有效结果',
-            transcript: result.transcript,
-        };
-    }
-    const snap = {
-        version: 1,
-        root,
-        builtAt: new Date().toISOString(),
-        content: result.content,
-    };
-    // 落盘为 markdown 格式，带 YAML front matter
-    const dir = snapshotDir();
-    mkdirSync(dir, { recursive: true });
-    const mdContent = `---\nroot: ${snap.root}\nbuiltAt: ${snap.builtAt}\nversion: ${snap.version}\n---\n\n${snap.content}`;
-    writeFileSync(snapshotPath(), mdContent, 'utf8');
-    currentSnapshot = snap;
-    return { snapshot: snap };
-}
-/** 清除内存缓存（强制下次重新加载） */
-export function clearSnapshotCache() {
-    currentSnapshot = null;
-}

package/dist/project-snapshot/llm-snapshot.js

@@ -1,150 +0,0 @@
-import { spawnAgent } from '../agent/spawn.js';
-/**
- * 子 agent 系统提示：让 agent 自主探索项目并生成 markdown 快照
- */
-const SNAPSHOT_LLM_SUFFIX = `You are a project analysis agent. Your task is to explore this project and generate a concise markdown snapshot for an AI coding assistant.
-
-## Your Mission
-Explore the project using available tools (read_file, glob, grep) and generate a structured markdown snapshot that captures:
-- WHAT exists (project description, tech stack, commands, modules, directory structure)
-- WHERE it is (paths, locations)
-
-Do NOT explain WHY or HOW (that's Project Skill's job).
-
-## Exploration Strategy
-1. Read package.json, README.md, tsconfig.json (or equivalent for other languages)
-2. List top-level directories to identify modules
-3. Scan src/ directory structure (depth ≤3, directories only)
-4. Extract key commands from package.json scripts
-5. Identify tech stack from dependencies
-
-## Output Format
-Output only a markdown document between these exact delimiter lines. The delimiters are not Markdown fences and must each appear on their own line:
-
-<snapshot-md>
-# Project Snapshot
-
-## Description
-(一句话描述项目，≤80字，中文)
-
-## Tech Stack
-(关键技术栈，逗号分隔，含版本，≤15项)
-
-## Commands
-| Command | Description |
-|---------|-------------|
-| \`npm run build\` | 构建项目 |
-| \`npm test\` | 运行测试 |
-| ... | ... |
-
-## Modules
-- **module-name** — 一句话职责描述（≤20字）
-- **module-name** — 一句话职责描述
-- ...
-
-## Source Tree
-\`\`\`
-src/
-  agent/
-  tools/
-  ui/
-\`\`\`
-</snapshot-md>
-
-## Rules
-1. **Description**: ≤80字，中文，从 README 和 package.json description 提炼。不要"一个..."开头。
-2. **Tech Stack**: ≤15项，逗号分隔，含版本。格式如 "TypeScript 5.x, Node.js ≥18, openai@^4"。
-3. **Commands**: 5-8个最重要的命令，从 package.json scripts 提取。Description ≤15字。用表格格式。
-4. **Modules**: 每个顶层模块目录一条。职责≤20字，只写 WHAT（做什么）。
-5. **Source Tree**: 只列目录（不列文件），深度≤3，用缩进表示层级，放在代码块中。
-6. 不要包含：设计决策、注意事项、坑点、约定 → 这些是 Skill 的职责。
-7. 总 markdown ≤ 2500 字符。
-8. 使用中文。
-9. 不要在 <snapshot-md> 和 </snapshot-md> 之外输出任何内容。
-`;
-/**
- * 提取子 agent 输出中的 markdown。
- * 优先使用无歧义标签，同时兼容历史自定义围栏和标准 Markdown 围栏。
- */
-function extractSnapshotMarkdown(summary) {
-    const tagged = summary.match(/<snapshot-md>[ \t]*\r?\n?([\s\S]*?)\r?\n?[ \t]*<\/snapshot-md>/i);
-    if (tagged?.[1]?.trim())
-        return tagged[1].trim();
-    const legacy = summary.match(/```snapshot-md[ \t]*\r?\n([\s\S]*?)\r?\n```snapshot-md[ \t]*(?:\r?\n|$)/i);
-    if (legacy?.[1]?.trim())
-        return legacy[1].trim();
-    const opening = summary.match(/^```(?:snapshot-md|markdown)[ \t]*\r?$/im);
-    if (opening?.index === undefined)
-        return undefined;
-    let bodyStart = opening.index + opening[0].length;
-    if (summary[bodyStart] === '\n')
-        bodyStart += 1;
-    const body = summary.slice(bodyStart);
-    const closings = [...body.matchAll(/^`{3,}[ \t]*\r?$/gm)];
-    const closing = closings.at(-1);
-    if (closing?.index === undefined)
-        return undefined;
-    let content = body.slice(0, closing.index).trim();
-    // 有些模型会把内层和外层的结束围栏连成六个反引号。
-    if (closing[0].trim().length >= 6)
-        content = `${content}\n\`\`\``;
-    return content || undefined;
-}
-/**
- * 生成 LLM 快照（markdown 格式）
- * @param root 项目根目录
- * @param signal AbortSignal
- */
-export async function generateLLMSnapshot(root, signal) {
-    const prompt = `请探索项目 ${root}，生成项目快照（markdown 格式）。
-
-## 探索步骤
-1. 读取 package.json（或等效配置文件）
-2. 读取 README.md
-3. 列出顶层目录，识别模块
-4. 扫描 src/ 目录结构（深度≤3，只列目录）
-5. 从 package.json scripts 提取关键命令
-6. 从 dependencies 识别技术栈
-
-## 输出
-严格按照系统提示的 markdown 格式输出，不要添加额外解释。`;
-    try {
-        const result = await spawnAgent({
-            prompt,
-            systemPromptSuffix: SNAPSHOT_LLM_SUFFIX,
-            tools: ['read_file', 'glob', 'grep'], // 允许探索工具
-            maxSteps: 15, // 给足够的探索步数
-            signal,
-        });
-        if (!result.completed) {
-            return {
-                ok: false,
-                error: '子 agent 未完成（可能中断或超时）',
-                transcript: result.transcript,
-            };
-        }
-        if (!result.summary) {
-            return {
-                ok: false,
-                error: '子 agent 未返回内容',
-                transcript: result.transcript,
-            };
-        }
-        const content = extractSnapshotMarkdown(result.summary);
-        if (!content) {
-            return {
-                ok: false,
-                error: '无法从子 agent 输出中提取 markdown',
-                transcript: result.transcript,
-            };
-        }
-        return { ok: true, content, transcript: result.transcript };
-    }
-    catch (e) {
-        return {
-            ok: false,
-            error: e instanceof Error ? e.message : '未知错误',
-            transcript: '',
-        };
-    }
-}

package/dist/project-snapshot/static-files.js

@@ -1,87 +0,0 @@
-import { readdirSync, readFileSync, statSync } from 'node:fs';
-import path from 'node:path';
-/**
- * 静态项目文件白名单 + 扫描逻辑。
- * 这些文件通常是项目元信息，变动频率低、体积小、跨 session 稳定。
- */
-/** 静态文件白名单（文件名或模式） */
-const STATIC_FILE_PATTERNS = [
-    // 文档
-    /^README(\.[a-z]+)?(\.[a-z]+)?$/i, // README, README.md, README.zh-CN.md
-    'CHANGELOG.md',
-    'CONTRIBUTING.md',
-    'LICENSE',
-    'LICENSE.md',
-    'LICENSE.txt',
-    // Node.js
-    'package.json',
-    'tsconfig.json',
-    'jsconfig.json',
-    // Python
-    'pyproject.toml',
-    'setup.py',
-    'setup.cfg',
-    'requirements.txt',
-    'Pipfile',
-    // Go
-    'go.mod',
-    // Rust
-    'Cargo.toml',
-    // 环境变量模板
-    '.env.example',
-    '.env.template',
-];
-/**
- * 判断文件名是否匹配白名单
- */
-function matchesPattern(filename) {
-    for (const p of STATIC_FILE_PATTERNS) {
-        if (typeof p === 'string') {
-            if (filename === p)
-                return true;
-        }
-        else {
-            if (p.test(filename))
-                return true;
-        }
-    }
-    return false;
-}
-/**
- * 扫描项目根目录，收集匹配白名单的静态文件。
- * 只扫顶层（不递归），避免 node_modules 等大目录。
- * @param root 项目根目录（绝对路径）
- * @returns key = 相对路径（正斜杠），val = { mtime, content }
- */
-export function scanStaticFiles(root) {
-    const result = {};
-    let items;
-    try {
-        items = readdirSync(root, { withFileTypes: true });
-    }
-    catch {
-        return result;
-    }
-    for (const item of items) {
-        if (!item.isFile())
-            continue;
-        if (!matchesPattern(item.name))
-            continue;
-        const absPath = path.join(root, item.name);
-        try {
-            const stat = statSync(absPath);
-            // 体积限制：单文件 > 64KB 跳过（避免 README 巨长拖慢快照）
-            if (stat.size > 64 * 1024)
-                continue;
-            const content = readFileSync(absPath, 'utf8');
-            result[item.name] = {
-                mtime: stat.mtimeMs,
-                content,
-            };
-        }
-        catch {
-            // 读取失败：跳过
-        }
-    }
-    return result;
-}

package/dist/repl/index.d.ts

@@ -1,22 +0,0 @@
-import { type ChatMessage } from '../llm/index.js';
-/**
- * 把会话历史渲染成静态文本进内容区(回滚 / 续接 / --resume 后复显上下文,仿 Claude Code):
- * user→❯ 回显、assistant→正文(+ tool_calls 折叠成 ● 摘要行)、tool→↳ 结果预览;system 跳过。
- * 思考段不持久(history 只存正文),故无思考折叠。渲染后续写位在末尾,紧接 enterInputMode 画输入框。
- * 内容长于屏时 viewport 显尾(最近轮次),PgUp 可看更早——与流式态一致。
- * user 多模态:用 textOf 取 text parts;若侧 channel messageAttachments 有原文件名则追加 chip 行
- * (避免 base64 解码不可逆,旧 session 没侧 channel 时只显文本,文件名 fallback 到 image/* mime)。
- *
- * 折叠策略:遇到 assistant + tool_calls 不立即打 ● 行,而是累积到 batchEntries;
- * 跟随的连续 tool 消息按 tool_call_id 反查填 resultSummary;遇下一个非 tool 消息(或末尾)时,
- * 用 batch.writeSummaryOnly 出单行摘要(与实时 runAgent 同一渲染器,UI 一致)。
- * 回放默认全折叠;用户可鼠标点击摘要行展开(由 BatchRenderer 接管,见 ui/batch.ts)。
- */
-export declare function renderHistory(history: ChatMessage[]): void;
-/**
- * 交互式 REPL:全屏 TUI(alt screen + 固定底栏)。INPUT 态底栏=状态行+输入框(raw mode 等按键);
- * 提交后 enterRunningMode(底栏改 dim 占位、光标回内容续写位),命令分发与 runAgent 的流式输出经
- * contentWrite 落入内容区(滚动区域内自动滚动,底栏不动)。history 由本模块持有,在轮次间持久;
- * agent 只读取并追加(+ 经 session/ 压缩)。每轮成功结束后自动落盘,退出后可用 --resume / /resume 续接。
- */
-export declare function startRepl(initialHistory?: ChatMessage[], sessionId?: string, updateNotice?: string | null, sandboxRootOverride?: string): Promise<void>;

package/dist/rollback/index.d.ts

@@ -1,79 +0,0 @@
-import type { ChatMessage } from '../llm/index.js';
-/**
- * 回滚子系统:`/rollback` 菜单(↑/↓)选轮次 → 选中第 X 轮 = 删该轮及之后 + 预填该轮 user 输入(仿 Claude Code
- * rewind,Enter 重新跑);撤销被删轮次的文件改动(逐个「保留/撤销」询问)。
- *
- * 语义:选中下标 picked(0-based,= 第 picked+1 轮)→ `planRollback(picked)` 保 1..picked(删 picked+1 轮及之后),
- * 预填 userTexts[picked](= 第 picked+1 轮 user 输入)。**不是**保 1..picked+1——选中第 X 轮即"从第 X 轮重跑"。
- *
- * 撤销方案 = 落盘快照(不用 git):write_file/edit_file 执行前由 executeTool 调
- * recordMutation,把 before 内容存入快照(按轮次 turnId 打标)。回滚到第 n 轮时,
- * 对每条选「撤销」的路径,恢复 turnId > cutoffTurnId 的最小 turnId 快照的 before
- * (= 所选轮末状态;before===null = 当时不存在 → 删文件)。同文件多轮改动也能
- * 精确回到所选轮边界,不误伤更早轮次。
- *
- * 快照 + 轮次日志随 saveSession 落盘到 <sessionDir>/<id>.snapshots.json,/resume 读回
- * → 重启后仍可撤销。叶子模块:运行时只依赖 config(+ node:fs/path);ChatMessage
- * 用 import type 擦除,不拉 llm 运行时;不反向依赖任何业务。
- *
- * v1 偏离 / 局限:
- * - 撤销粒度 = 路径(非逐条 tool_call)——快照只能整路径回到轮末,无法只撤一条 edit。
- * - run_command 不撤销(shell 可任意改文件,无法跟踪)。
- * - 跨 /resume 后若文件被外部改过,恢复会用 before 覆盖(边缘情况,不处理)。
- * - 快照文件随大文件多次改动膨胀;/clear 重置;日后可按「turn 已不可回滚」裁剪。
- */
-export interface Turn {
-    turnId: number;
-    firstLine: string;
-}
-export interface Snapshot {
-    turnId: number;
-    path: string;
-    before: string | null;
-}
-export interface FileChange {
-    path: string;
-    ops: string[];
-    snapshotAvailable: boolean;
-}
-export interface RollbackPlan {
-    n: number;
-    cutoffIndex: number;
-    cutoffTurnId: number;
-    changes: FileChange[];
-}
-/** agent:runAgent 入口调——开新轮次。firstLine 已由调用方截断到 40。 */
-export declare function beginTurn(firstLine: string): void;
-/** tools/registry:write_file/edit_file 执行前调——记 before 快照(在 tool.execute 之前读)。 */
-export declare function recordMutation(p: string): void;
-/** 列出当前可回滚的轮次(1-based 序号由调用方显示)。 */
-export declare function listTurns(): Turn[];
-/**
- * 规划回滚到第 n 轮(1-based):算截断点 + 被删轮次里涉及的文件改动(按 path 去重)。
- * 调用方据 changes 逐 path 问保留 / 撤销;snapshotAvailable=false 的项无法撤销。
- */
-export declare function planRollback(n: number, history: ChatMessage[]): RollbackPlan;
-/**
- * 执行回滚:原地截断 history 到 cutoffIndex + 按选择恢复文件 + 裁剪 turns/snapshots。
- * revertPaths 为选「撤销」的相对路径集合。返回删除消息数 + 撤销文件列表。
- */
-export declare function applyRollback(plan: RollbackPlan, history: ChatMessage[], revertPaths: Set<string>): {
-    deletedMsgs: number;
-    revertedFiles: string[];
-};
-/** compact 摘要成功后调:按存活轮次数裁剪(M = 新 history 里 user 消息数)。 */
-export declare function pruneAfterCompaction(history: ChatMessage[]): void;
-/** /clear 调:清空全部状态。 */
-export declare function resetState(): void;
-/**
- * 无 snapshots 文件时(/resume 旧会话)从 history 重建 turns(扫 user 消息,1..M,
- * 无快照 → 那些轮次的文件改动不可撤销)。turnIdCounter = M,后续新轮次从 M+1 续。
- */
-export declare function rebuildFromHistory(history: ChatMessage[]): void;
-/** 随 saveSession 调:把 turns + snapshots 落盘(turns 为空则跳过,不写空文件)。 */
-export declare function persistSnapshots(id: string): void;
-/**
- * /resume / --resume 加载会话后调:读回 turns + snapshots。成功返 true(状态已覆盖);
- * 失败 / 无文件返 false,调用方应改调 rebuildFromHistory(history) 兜底。
- */
-export declare function loadSnapshots(id: string): boolean;

package/dist/sandbox/command.d.ts

@@ -1,3 +0,0 @@
-/** 返回 env 浅拷贝,删敏感键。 */
-export declare function filterEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
-export declare function isCommandDenied(cmd: string): string | null;

package/dist/sandbox/index.d.ts

@@ -1,4 +0,0 @@
-export { getSandboxRoot, setSandboxRoot } from './root.js';
-export { jailResolve, jailGlobPattern, isInsideRoot } from './jail.js';
-export { filterEnv, isCommandDenied } from './command.js';
-export { SANDBOX_EXEMPT_TOOLS, SANDBOX_PATH_TOOLS, enforceSandbox, } from './policy.js';

package/dist/sandbox/jail.d.ts

@@ -1,17 +0,0 @@
-/**
- * abs 是否在沙箱根内(含 == 根)。win32 下两边 toLowerCase 再比(node 的 path.relative 不做
- * 大小写无关比较,盘符大小写差异会误判出圈)。**不做 realpath**——用于 glob/grep 结果后置过滤;
- * 越界软链的拦挡靠 jailResolve 的 realpath。
- */
-export declare function isInsideRoot(abs: string): boolean;
-/**
- * 把输入路径解析为沙箱根内的绝对路径;越界(../、绝对外圈、符号链接出圈)抛错。
- * 供 enforceSandbox 重写 args.path(读/写/改)、readDiffContext 预读旧内容用。
- * 同步:realpathSync 仅做 fs 元数据查询(微秒级),与既有 readFileSync/existsSync 用法一致。
- */
-export declare function jailResolve(input: string): string;
-/**
- * glob pattern 校验:拒绝对路径(平台相关的 isAbsolute)与含 `..` 段的 pattern。
- * 返 null = 通过;返 string = 拒绝原因。形如 *.ts 的正常 pattern 放行。
- */
-export declare function jailGlobPattern(pattern: string): string | null;

package/dist/sandbox/policy.d.ts

@@ -1,21 +0,0 @@
-/**
- * 豁免 cwd 牢笼的工具:
- *  - memory_*:操作 ~/.mocode 与 <cwd>/.mocode(CLAUDE.md 明确不进回滚、在外圈),本就该在外圈
- *  - use_skill:读 ~/.claude/skills、~/.mocode/skills、<cwd>/.mocode/skills,部分在外圈
- *  - web_*:跨网络,非文件路径
- *  - ask_human / switch_mode:无文件路径
- *  - codegraph:只读 cwd 下 .codegraph/ 索引(只读、不写盘)
- *  - task:派生子 agent,继承全局 root(子 agent 同进程天然共享 getSandboxRoot)
- */
-export declare const SANDBOX_EXEMPT_TOOLS: Set<string>;
-/**
- * 路径类工具:enforceSandbox 集中把 args.path 重写为牢内绝对路径(默认安全;工具内
- * resolve(absolutePath) 原样返回)。**新加带 path 参数的工具须列入此集**,否则不会被牢笼挡。
- */
-export declare const SANDBOX_PATH_TOOLS: Set<string>;
-/**
- * 工具执行前的沙箱校验。返 string = 拒绝(直接喂 LLM,不执行);返 null = 放行(可能已重写 args.path)。
- * **不抛**——契约对齐「调度器永不抛错、永远返回字符串」(tools/registry.ts executeTool)。
- * run_command 不在此处理(cwd / env / denylist 在其站点)。
- */
-export declare function enforceSandbox(name: string, args: Record<string, unknown>): string | null;

package/dist/sandbox/root.d.ts

@@ -1,5 +0,0 @@
-/** 当前沙箱根(绝对路径)。未初始化返 null,调用方 ?? process.cwd() 兜底(防御)。 */
-export declare function getSandboxRoot(): string | null;
-/** 设置沙箱根。repl startRepl 启动时调一次(默认 process.cwd();--sandbox-root / SANDBOX_ROOT 可覆盖)。
- *  返回之前的值,供未来 save/restore(子 agent worktree 隔离)用。 */
-export declare function setSandboxRoot(root: string | null): string | null;