@sema-ai/core 1.275.1

package/dist/tools/fs/repo-map.js

@@ -0,0 +1,251 @@
+// design/72 §1 OPT-1 — repo-context (repo_map), v1.
+//
+// An agent pointed at a REAL repo (vs a curated task that lists the relevant files) doesn't know what
+// the codebase contains — blind grep/glob burns turns and context, and misses related code. `repo_map`
+// gives it a compact, token-budgeted map of the tree's top-level symbols so it can locate the relevant
+// files in one call.
+//
+// Constitution (§1.1): this is a FIRST-PARTY TOOL (profile/band layer), NOT a core mechanism — it
+// mounts opt-in via the hands toolkit and runs on the same ExecutionEnv (local or remote), exactly like
+// grep/glob. The core run loop has no `if (repo)` branch.
+//
+// v1 design choices (the §1.4 questions, answered for v1):
+//  ① symbol extraction = language-agnostic REGEX on TOP-LEVEL lines (no tree-sitter — design/71 just
+//     removed deps to stay lean; high-fidelity parsing is a v2 injected capability via the ExecutionEnv
+//     seam, like an embedder).
+//  ② on-demand TOOL only — NOT a constant prompt-prefix injection. A standing map would bloat the
+//     cacheable stable prefix and churn it on every file change (we guard prefix stability hard,
+//     design/64 §20). The agent calls `repo_map` when it needs orientation; zero prefix cost otherwise.
+//  ③ no cache — per-task, on-demand, recomputed each call. A cache + cwd-change invalidation is
+//     complexity v1 doesn't need (the walk is bounded and fast).
+//  ④ ranking = LIGHT heuristic (symbol-bearing first, shallower path first, more symbols first), NOT a
+//     reference-graph PageRank (that needs a parsed import graph = heavy; not worth it at v1).
+//  ⑤ honesty markers on every bound: the walk's incomplete/skippedLarge flags AND a token-budget
+//     truncation note are surfaced verbatim — a bounded map must never read as exhaustive (the A-4
+//     class discipline, design/64 cap rule).
+import { Type } from "typebox";
+import { defineTool } from "../../core/tools.js";
+import { resolveKey, violationText } from "./safety.js";
+import { buildIgnore, walk } from "./search.js";
+/** Default token budget for the rendered map (~4k tokens at ≈4 chars/token). */
+const DEFAULT_MAX_CHARS = 16_000;
+/** Default cap on files scanned for symbols (the walk has its own file-count ceiling too). */
+const DEFAULT_MAX_FILES = 400;
+/** Per-file byte cap for symbol scanning — a huge source file isn't worth fully reading for a map. */
+const FILE_SCAN_MAX_BYTES = 256 * 1024;
+/** Max top-level symbols shown per file (the rest summarized as "+N more"). */
+const MAX_SYMBOLS_PER_FILE = 24;
+/** Source-code extensions worth scanning for symbols (everything else is listed path-only at the end). */
+const SOURCE_EXTENSIONS = new Set([
+    "ts", "tsx", "mts", "cts", "js", "jsx", "mjs", "cjs",
+    "py", "go", "rs", "java", "kt", "kts", "rb", "php", "swift", "scala", "ex", "exs",
+    "c", "h", "cc", "cpp", "hpp", "cxx", "cs", "m", "mm", "dart", "lua", "sh", "bash",
+]);
+/** Top-level symbol declarations, language-agnostic. Tested ONLY against lines that start at column 0
+ *  (no leading whitespace) — that approximates "top-level" across braces/indent languages without a
+ *  real parser (nested/method symbols are intentionally skipped at v1). */
+const SYMBOL_PATTERNS = [
+    /^export\s+(?:default\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/,
+    /^(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/,
+    /^export\s+(?:default\s+)?(?:abstract\s+)?class\s+([A-Za-z_$][\w$]*)/, // council #3: include `default`
+    /^(?:abstract\s+)?class\s+([A-Za-z_$][\w$]*)/,
+    /^export\s+(?:default\s+)?(?:interface|type|enum|namespace)\s+([A-Za-z_$][\w$]*)/, // #3: include `default`
+    /^(?:interface|type|enum|namespace)\s+([A-Za-z_$][\w$]*)/,
+    /^export\s+(?:const|let|var)\s+([A-Za-z_$][\w$]*)/, // council #6: let/var too (was const-only)
+    /^(?:pub\s+)?(?:async\s+)?fn\s+([A-Za-z_][\w]*)/, // rust
+    /^func\s+(?:\([^)]*\)\s*)?([A-Za-z_][\w]*)/, // go / swift
+    /^(?:pub\s+)?(?:struct|trait|impl|enum)\s+(?:for\s+)?([A-Za-z_][\w]*)/, // rust
+    /^def\s+([A-Za-z_][\w]*)/, // python / ruby (top-level)
+    /^type\s+([A-Za-z_][\w]*)\s+(?:struct|interface)/, // go type decl
+];
+function extOf(path) {
+    const dot = path.lastIndexOf(".");
+    const slash = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\")); // [384] sweep
+    return dot > slash ? path.slice(dot + 1).toLowerCase() : "";
+}
+/** Extract top-level symbol names (deduped, in first-seen order) from source text. A lightweight
+ *  comment/docstring state machine (council #4) skips column-0 declaration-like lines that are really
+ *  inside a `/* … *​/` block comment or a Python `"""`/`'''` docstring — otherwise e.g. a module
+ *  docstring containing `def foo():` at column 0 produces a phantom symbol. Not a full parser (v1
+ *  heuristic): it tracks whole-line block/docstring regions, the common false-positive source.
+ *
+ *  ⚠️ **Exported ONLY as a v1 heuristic, NOT a containment proof** (design/79 §3): it is column-0 /
+ *  source-only and skips indented lines, so it CANNOT enumerate everything an artifact can call. The
+ *  auto-promote tripwire (src/core/auto-promote.ts) consumes it in ESCALATE-ONLY mode — a clean scan
+ *  contributes nothing; it can only ever raise an escalation, never clear one. */
+export function extractSymbols(text) {
+    const seen = new Set();
+    const out = [];
+    let inBlock = false; // inside /* … */
+    let inDoc = null; // inside """ … """ or ' '' … ' '' (the quote that opened it)
+    for (const line of text.split("\n")) {
+        if (inDoc !== null) {
+            if (line.includes(inDoc))
+                inDoc = null;
+            continue; // whole line is inside a docstring
+        }
+        if (inBlock) {
+            if (line.includes("*/"))
+                inBlock = false;
+            continue; // whole line is inside a block comment
+        }
+        if (line.length === 0 || /^\s/.test(line))
+            continue; // top-level only (column 0)
+        // A column-0 line that OPENS a block comment / docstring without closing it on the same line:
+        // enter that state and skip it (its body is not code).
+        if (line.startsWith("/*") && !line.includes("*/")) {
+            inBlock = true;
+            continue;
+        }
+        const docOpen = /^("""|''')/.exec(line);
+        if (docOpen && line.indexOf(docOpen[1], docOpen[1].length) === -1) {
+            inDoc = docOpen[1];
+            continue;
+        }
+        for (const re of SYMBOL_PATTERNS) {
+            const m = re.exec(line);
+            if (m && m[1] && !seen.has(m[1])) {
+                seen.add(m[1]);
+                out.push(m[1]);
+                break; // one symbol per line
+            }
+        }
+    }
+    return out;
+}
+/** Light heuristic ranking (§1.4 ④): symbol-bearing files first, then shallower paths, then more
+ *  symbols, then lexicographic for determinism. No reference-graph PageRank at v1. */
+function rankEntries(a, b) {
+    const aHas = a.symbols.length > 0 ? 0 : 1;
+    const bHas = b.symbols.length > 0 ? 0 : 1;
+    if (aHas !== bHas)
+        return aHas - bHas;
+    if (a.depth !== b.depth)
+        return a.depth - b.depth;
+    if (a.symbols.length !== b.symbols.length)
+        return b.symbols.length - a.symbols.length;
+    return a.rel < b.rel ? -1 : a.rel > b.rel ? 1 : 0;
+}
+export function makeRepoMapTool(env, rootCanonical, additionalRoots) {
+    return defineTool({
+        name: "RepoMap",
+        description: "Get a compact map of the repository: each source file with its top-level symbols (functions, " +
+            "classes, types). Use this FIRST to orient in an unfamiliar codebase before grepping — it shows " +
+            "what exists and where, so you can jump to the relevant files. Token-budgeted and honest about " +
+            "truncation. Optionally scope to a sub-directory.",
+        parameters: Type.Object({
+            path: Type.Optional(Type.String({ description: "Restrict the map to a sub-directory (relative to root)." })),
+            max_chars: Type.Optional(Type.Number({ description: `Token budget for the rendered map in chars (default ${DEFAULT_MAX_CHARS}; a very small value yields only a truncation note).` })),
+            max_files: Type.Optional(Type.Number({ description: `Max files to scan (default ${DEFAULT_MAX_FILES}).` })),
+        }),
+        effect: "read",
+        execute: async (args, ctx) => {
+            const a = args;
+            const signal = ctx.signal;
+            const rootPrefix = rootCanonical.replace(/[\\/]+$/, "") + (rootCanonical.includes("\\") ? "\\" : "/"); // [384] sweep(Opus 复审补漏)
+            // Scope: same canonicalize+within gate as grep's `path` (a sub-dir must stay in root).
+            let start = rootCanonical;
+            if (a.path !== undefined) {
+                const r = await resolveKey(env, rootCanonical, a.path, signal, rootCanonical, additionalRoots);
+                if (!r.ok)
+                    return violationText("RepoMap", r.violation);
+                start = r.key;
+            }
+            const maxChars = Math.max(1, Math.floor(a.max_chars ?? DEFAULT_MAX_CHARS));
+            const maxFiles = Math.max(1, Math.floor(a.max_files ?? DEFAULT_MAX_FILES));
+            const ignore = await buildIgnore(env, rootCanonical, signal);
+            const walked = await walk(env, rootCanonical, start, ignore, signal);
+            const rel = (abs) => (abs.startsWith(rootPrefix) ? abs.slice(rootPrefix.length) : abs);
+            // Scan source files for symbols (bounded by maxFiles); non-source files are listed path-only.
+            const entries = [];
+            const nonSource = [];
+            let scanned = 0;
+            let scanIncomplete = false;
+            for (const abs of walked.files) {
+                const r = rel(abs);
+                if (!SOURCE_EXTENSIONS.has(extOf(abs))) {
+                    nonSource.push(r);
+                    continue;
+                }
+                if (scanned >= maxFiles) {
+                    scanIncomplete = true;
+                    break;
+                }
+                scanned++;
+                const read = await env.readTextFile(abs, signal).catch(() => undefined);
+                if (!read || !read.ok)
+                    continue;
+                let text = read.value;
+                if (text.length > FILE_SCAN_MAX_BYTES) {
+                    // council #1: a mid-line byte slice would let the unanchored regexes capture a TRUNCATED
+                    // identifier (a false symbol). Slice, then drop the trailing partial line unless it happened
+                    // to end exactly on a newline.
+                    text = text.slice(0, FILE_SCAN_MAX_BYTES);
+                    if (!text.endsWith("\n"))
+                        text = text.slice(0, text.lastIndexOf("\n") + 1);
+                }
+                entries.push({ rel: r, depth: r.split(/[\\/]/).length, symbols: extractSymbols(text) });
+            }
+            entries.sort(rankEntries);
+            // Render within the char budget; stop honestly when the budget is hit.
+            const lines = [];
+            let used = 0;
+            let rendered = 0;
+            let budgetHit = false;
+            for (const e of entries) {
+                const shown = e.symbols.slice(0, MAX_SYMBOLS_PER_FILE);
+                const more = e.symbols.length > shown.length ? ` (+${e.symbols.length - shown.length} more)` : "";
+                const line = shown.length > 0 ? `${e.rel}: ${shown.join(", ")}${more}` : `${e.rel}`;
+                if (used + line.length + 1 > maxChars) {
+                    budgetHit = true;
+                    break;
+                }
+                lines.push(line);
+                used += line.length + 1;
+                rendered++;
+            }
+            // Build the honesty notes FIRST (council #2/#5): they must reach the model on EVERY path,
+            // including the "nothing rendered" early return — a bounded/empty result must never read as
+            // exhaustive (A-4 class discipline).
+            const notes = [];
+            if (budgetHit || rendered < entries.length) {
+                notes.push(`…[map truncated to fit the token budget: ${rendered} of ${entries.length} source files shown; raise max_chars or scope with path]`);
+            }
+            if (scanIncomplete)
+                notes.push(`…[only the first ${maxFiles} source files were scanned for symbols; raise max_files]`);
+            if (walked.incomplete)
+                notes.push("…[the directory walk hit its file/depth ceiling — some files may be missing]");
+            // Non-source files: shown in full when the budget allows; otherwise still COUNTED in a note
+            // (council #5 — never silently dropped, even when source entries hit the budget).
+            if (nonSource.length > 0) {
+                if (!budgetHit) {
+                    const NON_SOURCE_CAP = 40;
+                    const head = nonSource.slice(0, NON_SOURCE_CAP);
+                    lines.push("", "Other files:", ...head.map((f) => `  ${f}`));
+                    if (nonSource.length > NON_SOURCE_CAP)
+                        lines.push(`…[and ${nonSource.length - NON_SOURCE_CAP} more non-source files]`);
+                }
+                else {
+                    notes.push(`…[${nonSource.length} non-source file(s) not shown — budget exhausted]`);
+                }
+            }
+            // 18-tool toolUseResult 尾批: RepoMap is sema-ONLY (no CC counterpart — CC has no repo map; that's the
+            // Aider paradigm) → minimal structured summary, sema 形状: counts + honesty flags, never the full map
+            // text twice (the map body stays model-facing only).
+            const mapDetails = {
+                type: "repo-map",
+                sourceFiles: entries.length,
+                renderedFiles: rendered,
+                nonSourceFiles: nonSource.length,
+                truncated: budgetHit || scanIncomplete || walked.incomplete || rendered < entries.length,
+            };
+            if (lines.length === 0) {
+                // Nothing rendered. Honest even here: if a bound caused it, say so; else it's genuinely empty.
+                const base = start === rootCanonical ? "Repository is empty or has no readable files." : `No readable files under "${a.path}".`;
+                return { content: notes.length > 0 ? ["(no map entries fit — see below)", ...notes].join("\n") : base, details: mapDetails };
+            }
+            return { content: [lines.join("\n"), ...notes].filter(Boolean).join("\n"), details: mapDetails };
+        },
+    });
+}
+//# sourceMappingURL=repo-map.js.map

package/dist/tools/fs/repo-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-map.js","sourceRoot":"","sources":["../../../src/tools/fs/repo-map.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,sGAAsG;AACtG,uGAAuG;AACvG,uGAAuG;AACvG,qBAAqB;AACrB,EAAE;AACF,kGAAkG;AAClG,wGAAwG;AACxG,0DAA0D;AAC1D,EAAE;AACF,2DAA2D;AAC3D,qGAAqG;AACrG,wGAAwG;AACxG,+BAA+B;AAC/B,kGAAkG;AAClG,iGAAiG;AACjG,wGAAwG;AACxG,gGAAgG;AAChG,iEAAiE;AACjE,uGAAuG;AACvG,+FAA+F;AAC/F,iGAAiG;AACjG,mGAAmG;AACnG,6CAA6C;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEhD,gFAAgF;AAChF,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACjC,8FAA8F;AAC9F,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,sGAAsG;AACtG,MAAM,mBAAmB,GAAG,GAAG,GAAG,IAAI,CAAC;AACvC,+EAA+E;AAC/E,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,0GAA0G;AAC1G,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;IACpD,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK;IACjF,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM;CAClF,CAAC,CAAC;AAEH;;2EAE2E;AAC3E,MAAM,eAAe,GAAa;IAChC,qEAAqE;IACrE,6CAA6C;IAC7C,qEAAqE,EAAE,gCAAgC;IACvG,6CAA6C;IAC7C,iFAAiF,EAAE,wBAAwB;IAC3G,yDAAyD;IACzD,kDAAkD,EAAE,2CAA2C;IAC/F,gDAAgD,EAAE,OAAO;IACzD,2CAA2C,EAAE,aAAa;IAC1D,sEAAsE,EAAE,OAAO;IAC/E,yBAAyB,EAAE,4BAA4B;IACvD,iDAAiD,EAAE,eAAe;CACnE,CAAC;AAEF,SAAS,KAAK,CAAC,IAAY;IACzB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc;IACrF,OAAO,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;;;;;kFASkF;AAClF,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,OAAO,GAAG,KAAK,CAAC,CAAC,iBAAiB;IACtC,IAAI,KAAK,GAAkB,IAAI,CAAC,CAAC,6DAA6D;IAC9F,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,KAAK,GAAG,IAAI,CAAC;YACvC,SAAS,CAAC,mCAAmC;QAC/C,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO,GAAG,KAAK,CAAC;YACzC,SAAS,CAAC,uCAAuC;QACnD,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,4BAA4B;QACjF,8FAA8F;QAC9F,uDAAuD;QACvD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAClE,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACf,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACf,MAAM,CAAC,sBAAsB;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAQD;sFACsF;AACtF,SAAS,WAAW,CAAC,CAAY,EAAE,CAAY;IAC7C,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,GAAG,IAAI,CAAC;IACtC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAClD,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACtF,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAiB,EAAE,aAAqB,EAAE,eAAmC;IAC3G,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,SAAS;QACf,WAAW,EACT,+FAA+F;YAC/F,iGAAiG;YACjG,gGAAgG;YAChG,kDAAkD;QACpD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yDAAyD,EAAE,CAAC,CAAC;YAC5G,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,uDAAuD,iBAAiB,sDAAsD,EAAE,CAAC,CAAC;YACtL,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,8BAA8B,iBAAiB,IAAI,EAAE,CAAC,CAAC;SAC5G,CAAC;QACF,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC3B,MAAM,CAAC,GAAG,IAAiE,CAAC;YAC5E,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;YAC1B,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,yBAAyB;YAEhI,uFAAuF;YACvF,IAAI,KAAK,GAAG,aAAa,CAAC;YAC1B,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,CAAC,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;gBAC/F,IAAI,CAAC,CAAC,CAAC,EAAE;oBAAE,OAAO,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;gBACxD,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC;YAChB,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,iBAAiB,CAAC,CAAC,CAAC;YAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,iBAAiB,CAAC,CAAC,CAAC;YAC3E,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACrE,MAAM,GAAG,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAEvG,8FAA8F;YAC9F,MAAM,OAAO,GAAgB,EAAE,CAAC;YAChC,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,IAAI,cAAc,GAAG,KAAK,CAAC;YAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC/B,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;gBACnB,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;oBACvC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAClB,SAAS;gBACX,CAAC;gBACD,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;oBACxB,cAAc,GAAG,IAAI,CAAC;oBACtB,MAAM;gBACR,CAAC;gBACD,OAAO,EAAE,CAAC;gBACV,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACxE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE;oBAAE,SAAS;gBAChC,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;gBACtB,IAAI,IAAI,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;oBACtC,yFAAyF;oBACzF,6FAA6F;oBAC7F,+BAA+B;oBAC/B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;oBAC1C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;wBAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC7E,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1F,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAE1B,uEAAuE;YACvE,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,IAAI,GAAG,CAAC,CAAC;YACb,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;gBACvD,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClG,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;gBACpF,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,QAAQ,EAAE,CAAC;oBACtC,SAAS,GAAG,IAAI,CAAC;oBACjB,MAAM;gBACR,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;gBACxB,QAAQ,EAAE,CAAC;YACb,CAAC;YAED,0FAA0F;YAC1F,4FAA4F;YAC5F,qCAAqC;YACrC,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,SAAS,IAAI,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC,4CAA4C,QAAQ,OAAO,OAAO,CAAC,MAAM,0DAA0D,CAAC,CAAC;YAClJ,CAAC;YACD,IAAI,cAAc;gBAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,QAAQ,0DAA0D,CAAC,CAAC;YACvH,IAAI,MAAM,CAAC,UAAU;gBAAE,KAAK,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;YAElH,4FAA4F;YAC5F,kFAAkF;YAClF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,cAAc,GAAG,EAAE,CAAC;oBAC1B,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;oBAChD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;oBAC7D,IAAI,SAAS,CAAC,MAAM,GAAG,cAAc;wBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,GAAG,cAAc,yBAAyB,CAAC,CAAC;gBACzH,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,MAAM,mDAAmD,CAAC,CAAC;gBACvF,CAAC;YACH,CAAC;YAED,qGAAqG;YACrG,oGAAoG;YACpG,qDAAqD;YACrD,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,OAAO,CAAC,MAAM;gBAC3B,aAAa,EAAE,QAAQ;gBACvB,cAAc,EAAE,SAAS,CAAC,MAAM;gBAChC,SAAS,EAAE,SAAS,IAAI,cAAc,IAAI,MAAM,CAAC,UAAU,IAAI,QAAQ,GAAG,OAAO,CAAC,MAAM;aACzF,CAAC;YACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,+FAA+F;gBAC/F,MAAM,IAAI,GAAG,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,+CAA+C,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,IAAI,IAAI,CAAC;gBAChI,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,kCAAkC,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;YAC/H,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QACnG,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/fs/safety.d.ts

@@ -0,0 +1,168 @@
+import type { ExecutionEnv } from "../../internal/harness.js";
+/**
+ * batch-B (CC 2.1.187 parity): Read/Edit/Write take the file path as `file_path`, with the legacy `path` as a
+ * durable back-compat alias. Read the target the same way EVERYWHERE the path is consumed from a tool-call's args —
+ * not just the tool body but ALSO every gate that extracts the write target to confine it (sensitive-path,
+ * skill allowPaths, session allowDirs). A gate that only read `args.path` would see `undefined` for a `file_path`
+ * call and either fail-OPEN (bypass the guard — a real hole) or fail-closed (deny a legitimate write). Single source.
+ */
+export declare function fileArgPath(args: unknown): string | undefined;
+/**
+ * The "hand" file tools (design/44) — safety invariants ported from CC's `FileEditTool` (design/43 Rule
+ * 7): without these a weak model blind-edits / overwrites files (P0 safety, not polish). This module is
+ * the pure/testable core (path resolution + the three edit invariants + content hashing); the tools in
+ * this dir compose it. Per-task state and the execution env are passed in (factory-closure wiring,
+ * design/44 §11 ruling A), never read from a shared/global.
+ */
+/** What we remember about a file the agent has read (design/44 §4). */
+export interface ReadEntry {
+    /** SHA-256 of the content at read time. Staleness is detected by content hash, NOT mtime — mtime is
+     *  unreliable across containers/volumes/NFS and across a design/45 suspend→resume on another replica. */
+    hash: string;
+    /** Total line count at read time, and whether the read was truncated (for the edit truncation hint, S2). */
+    totalLines: number;
+    truncated: boolean;
+    /** The line window actually served to the model on the last read (design/64 §7.2(6) dedup stub). Lets
+     *  read_file return a `file_unchanged` stub when the SAME window is re-requested and the content hash is
+     *  unchanged — saving the re-transmitted body. Optional/additive: undefined (e.g. an entry seeded from an
+     *  older design/45 checkpoint) just means "no dedup", never a false hit. */
+    view?: {
+        start: number;
+        end: number;
+    };
+    /** Millisecond timestamp of the last read/write-back that recorded this entry (blackboard
+     *  2026-07-03, compact re-read parity: the post-compaction attachment picks the most RECENTLY
+     *  read files — CC sorts readFileState by timestamp). Optional/additive: undefined (an entry
+     *  seeded from an older checkpoint) sorts last, never breaks. */
+    lastReadAt?: number;
+    /** CC 2.1.204 parity (`seededFromContext`, cc204-bundle @17889409 / seeding @17917159; 198 zero
+     *  hits): TRUE when the Runner pre-seeded this entry because the file's FULL disk-verbatim text
+     *  was injected into the model's context at startup (ProjectMemoryLoad.seededFiles — CC's
+     *  CLAUDE.md/nested-memory seeding). A DEFAULT whole-file Read of an UNCHANGED seeded file
+     *  answers with the already-in-context reminder instead of re-transmitting the body. Any real
+     *  Read / edit write-back records a FRESH entry without this flag, so a file that changed on
+     *  disk (hash mismatch) always serves real content and the dedup disarms permanently.
+     *  Optional/additive: absent = normal entry. */
+    seededFromContext?: boolean;
+}
+/** Per-task record of which files have been read, keyed by canonical path (design/44 §4, §11 ruling A:
+ *  owned by prepare-task, closure-captured by the tools; serialized into a design/45 Checkpoint later). */
+export type ReadFileState = Map<string, ReadEntry>;
+/** SHA-256 hex of UTF-8 content — the staleness/identity key (design/44 §4 inv 2, jury M1). */
+export declare function sha256(content: string): string;
+/** A failed path resolution / invariant check, surfaced to the model as a self-correctable tool error. */
+export interface FsViolation {
+    code: "path_not_in_root" | "not_read" | "stale" | "ambiguous_edit" | "invalid";
+    message: string;
+}
+export declare function isBlockedDevicePath(key: string): boolean;
+/** True if `path`'s extension is a known binary format (pure check — no I/O). Used by read_file and grep. */
+export declare function hasBinaryExtension(path: string): boolean;
+/** The MIME type to return an image file AS (a visual `ImageContent` block), or `undefined` if `path` is not a
+ *  Read-supported image. Pure — no I/O. */
+export declare function imageMimeForRead(path: string): string | undefined;
+/** Verify the raw bytes actually ARE the image format the extension claims (magic-number sniff). Extension alone
+ *  is forgeable: a `.png` holding text / an empty file / a truncated blob would otherwise become a malformed
+ *  `ImageContent` that makes the NEXT provider request fail (400). Pure — no I/O. (batch-C, codex review.) */
+export declare function imageMagicMatches(bytes: Uint8Array, mimeType: string): boolean;
+/**
+ * Content sniff for binary data (design/64 §17.1, CC `constants/files.ts` `isBinaryContent`): a NUL byte,
+ * or more than 10% non-printable characters in the sample, means binary. Second layer behind
+ * {@link hasBinaryExtension} — catches extension-less or mis-named binaries (a `Dockerfile` that is really
+ * a compiled blob) that would otherwise be read as mojibake. Plain text (incl. UTF-8, tabs/newlines) passes.
+ */
+export declare function isBinaryContent(sample: string): boolean;
+/** True for a Windows/SMB UNC path (`\\host\share`) or a `//`-prefixed network path — refused to avoid
+ *  NTLM credential leaks (design/64 §7.2(8), CC validateInput). Pure check on the RAW model path. */
+export declare function isUncPath(path: string): boolean;
+/**
+ * Resolve a model-supplied path to a canonical key AND enforce rootPath containment (design/44 §4
+ * inv 5/6/7). Existing paths use `canonicalPath` (resolves symlinks, so the same file can't get two
+ * keys). New paths canonicalize the **deepest existing ancestor** then rejoin the missing tail — a
+ * symlinked parent therefore can't smuggle the target outside root. Returns the canonical key, or a
+ * `path_not_in_root` violation. (Defense-in-depth at the tool layer; NOT a substitute for a sandboxed
+ * `executionEnv` — see design/44 §5.)
+ */
+export declare function resolveKey(env: ExecutionEnv, rootCanonical: string, path: string, signal?: AbortSignal, baseCwd?: string, additionalRootsCanonical?: readonly string[]): Promise<{
+    ok: true;
+    key: string;
+} | {
+    ok: false;
+    violation: FsViolation;
+}>;
+/**
+ * Canonicalize a model-supplied path to its real on-disk target (symlinks resolved; for a path that
+ * doesn't exist yet, the deepest EXISTING ancestor is canonicalized then the missing tail rejoined —
+ * so a symlinked parent can't smuggle the target elsewhere). NO containment check — this is the pure
+ * canonicalization shared by `resolveKey` (which adds rootPath containment) and
+ * `createSensitivePathPolicy` (design/72 §2.1, which matches the real target against a guarded list).
+ * A single source of truth for symlink resolution: a sensitive-path guard that matched the raw path
+ * instead of the real target would be one-shot bypassable by a symlink (the bug §2.1 calls out).
+ */
+export declare function canonicalizeTarget(env: ExecutionEnv, path: string, signal?: AbortSignal, baseCwd?: string): Promise<{
+    ok: true;
+    key: string;
+} | {
+    ok: false;
+    message: string;
+    unresolvedSymlink?: true;
+}>;
+/** Render a `FsViolation` as the model-facing tool error text (returned, never thrown — model retries). */
+export declare function violationText(toolName: string, v: FsViolation): string;
+/** inv 1 (read-before-edit): a file must have been read this task before it can be edited/overwritten.
+ *  Message is CC 2.1.198 live-verbatim (all-tools-live-probe 2026-07-08 §2.1/§3.1/§5.1 — one message for
+ *  Edit/Write/NotebookEdit: "before writing to it", not the old sema "before editing"). */
+export declare function requireRead(state: ReadFileState, key: string): FsViolation | undefined;
+/**
+ * Edit "no-op" guard (design/64 §7.2(4), CC `FileEditTool:148-153`): refuse an edit whose `old_string`
+ * equals `new_string` — without it the edit passes the match check and writes the file back unchanged (a
+ * silent no-op that wastes a turn and dirties mtime). Verbatim CC message so a CC-trained model recognizes it.
+ */
+export declare function checkNoChange(oldString: string, newString: string): FsViolation | undefined;
+/** inv 2 (staleness): the file's current content hash must match what was recorded at read time. */
+export declare function checkStale(entry: ReadEntry, currentHash: string): FsViolation | undefined;
+/** Count non-overlapping occurrences of `needle` in `haystack` (`needle` must be non-empty). */
+export declare function countOccurrences(haystack: string, needle: string): number;
+/**
+ * Suggest a sibling filename for a missing path (CC `File does not exist… Did you mean X?` self-heal
+ * path, bundle :335883/:478419). Honest scope (1.253 双轨终审): this is the FALLBACK tier — an
+ * approximation of CC's Cxe same-directory scan plus a sema-added case-insensitive exact-name match
+ * (the case-typo class CC misses). CC's FIRST preference (aY: re-resolve the filename against cwd
+ * and suggest the cwd path on an exists hit) needs env probing and therefore lives at the call site
+ * (fs/index.ts enoentMessage) — this function stays pure over a listed sibling set. (a) CC's
+ * findSimilarFile rule — same stem, different extension/name in the same directory; (b) the
+ * case-insensitive exact-name match. Returns the suggested NAME (not a full path), or undefined.
+ */
+export declare function similarNameSuggestion(siblingNames: readonly string[], missingName: string): string | undefined;
+/** Replace curly single/double quotes with their straight ASCII forms (CC qDa, 1:1 char mapping). */
+export declare function normalizeQuotes(s: string): string;
+/**
+ * Resolve `oldString` against `content` with the CC quote-forgiveness layer: exact match first; on a
+ * miss, match in the curly→straight normalized coordinate and return the ACTUAL file substring at
+ * that span (CC kOe). Returns undefined when even the normalized form does not appear.
+ */
+export declare function resolveQuoteMatch(content: string, oldString: string): string | undefined;
+/**
+ * When the quote-forgiving match resolved to a curly-quoted file span, convert the straight quotes in
+ * `newString` to the matching curly forms so the replacement stays style-consistent with the file
+ * (CC Dmt/yPp/TPp: openers vs closers by preceding char; a letter-adjacent single quote is an
+ * apostrophe U+2019). Call ONLY when the matched span differs from the model's old_string.
+ */
+export declare function adaptNewStringQuotes(matchedOld: string, newString: string): string;
+/**
+ * The effective old_string a DELETION should replace: `oldString + "\n"` when new_string is empty,
+ * old_string doesn't already end with a newline, and the newline-suffixed form exists in the content;
+ * otherwise old_string unchanged (CC KDa parity). SINGLE (non-replace_all) edits only: a widened
+ * needle under replace_all would miss occurrences not followed by a newline and desync the
+ * replacement count — the Edit tool restricts the widening to single edits (1.253 双轨终审 MED).
+ */
+export declare function deletionOldString(content: string, oldString: string, newString: string): string;
+/**
+ * inv 3 (edit uniqueness): `oldString` must match exactly once unless `replaceAll`. Zero → not found;
+ * >1 without replaceAll → ambiguous. `truncated` adds a hint that unseen content may hold more matches (S2).
+ * Messages are CC 2.1.198 live-verbatim (all-tools-live-probe 2026-07-08 §2.1): first sentence(s) byte-exact,
+ * then a `String: <needle>` echo line (CC form). The sema truncated-read hint survives as a parenthetical
+ * appended to the sentence (probe verdict: "truncated 提示可并入括注保留").
+ */
+export declare function checkEditMatch(content: string, oldString: string, replaceAll: boolean, truncated: boolean): FsViolation | undefined;
+//# sourceMappingURL=safety.d.ts.map

package/dist/tools/fs/safety.d.ts.map

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