@osovv/vv-opencode 1.2.6 → 1.2.8

package/dist/plugins/hashline-edit/normalize-edits.js

@@ -1,9 +1,9 @@
 // FILE: src/plugins/hashline-edit/normalize-edits.ts
-// VERSION: 0.3.0
+// VERSION: 0.5.0
 // START_MODULE_CONTRACT
 //   PURPOSE: Validate and normalize raw hashline tool arguments into strongly-typed edit operations.
-//   SCOPE: Raw edit input shape, anchor trimming, required-field validation, and replace/replace_range/append/prepend normalization.
-//   DEPENDS: [src/plugins/hashline-edit/types.ts]
+//   SCOPE: Raw edit input shape, anchor trimming, three-part anchor enforcement, required-field validation, physical single-line payload enforcement, blank-payload rejection for replacements, and unified replace (optional end) with replace_range alias plus append/prepend normalization.
+//   DEPENDS: [src/plugins/hashline-edit/types.ts, src/plugins/hashline-edit/validation.ts]
 //   LINKS: [M-PLUGIN-HASHLINE-EDIT]
 //   ROLE: RUNTIME
 //   MAP_MODE: EXPORTS
@@ -15,8 +15,9 @@
 // END_MODULE_MAP
 //
 // START_CHANGE_SUMMARY
-//   LAST_CHANGE: [v0.3.0 - Split "replace" validation: "replace" rejects end, "replace_range" requires both pos and end.]
+//   LAST_CHANGE: [v0.5.0 - Unified replace to accept an optional end anchor (range semantics) with replace_range kept as an alias, rejected multi-line replace without end via add-end guidance, and enforced three-part anchors on all edit references.]
 // END_CHANGE_SUMMARY
+import { requireThreePartRef } from "./validation.js";
 function normalizeAnchor(value) {
     if (typeof value !== "string") {
         return undefined;
@@ -24,6 +25,14 @@ function normalizeAnchor(value) {
     const trimmed = value.trim();
     return trimmed === "" ? undefined : trimmed;
 }
+function requireAnchor(value, index, field) {
+    const anchor = normalizeAnchor(value);
+    if (anchor === undefined) {
+        return undefined;
+    }
+    requireThreePartRef(anchor, `Edit ${index} ${field}`);
+    return anchor;
+}
 function requireLines(edit, index) {
     if (edit.lines === undefined) {
         throw new Error(`Edit ${index}: lines is required for ${edit.op ?? "unknown"}`);
@@ -34,41 +43,47 @@ function requireLines(edit, index) {
     return edit.lines;
 }
 function normalizeReplaceEdit(edit, index) {
-    const pos = normalizeAnchor(edit.pos);
+    const pos = requireAnchor(edit.pos, index, "pos");
     if (!pos) {
         throw new Error(`Edit ${index}: replace requires pos anchor`);
     }
-    if (edit.end !== undefined && edit.end !== null && edit.end.trim() !== "") {
-        throw new Error(`Edit ${index}: replace does not accept end — use "replace_range" for multi-line replacements`);
+    const end = requireAnchor(edit.end, index, "end");
+    const lines = requireLines(edit, index);
+    assertNonBlankReplacement(edit, index, lines);
+    assertPhysicalLines(edit, index, lines);
+    // With an end anchor, replace applies as an inclusive range (pos..end).
+    if (end) {
+        return { op: "replace_range", pos, end, lines };
     }
-    if (Array.isArray(edit.lines) && edit.lines.length > 1) {
-        throw new Error(`Edit ${index}: replace is for single-line replacement only. ` +
-            `You passed ${edit.lines.length} replacement lines. Use "replace_range" with pos + end for multi-line replacement.`);
+    const lineCount = Array.isArray(lines) ? lines.length : lines.split("\n").length;
+    if (lineCount > 1) {
+        throw new Error(`Edit ${index}: replace received ${lineCount} replacement lines but no end anchor. ` +
+            "Add the end anchor of the last line to replace (pos..end is inclusive), or pass a single replacement line.");
     }
-    return {
-        op: "replace",
-        pos,
-        lines: requireLines(edit, index),
-    };
+    return { op: "replace", pos, lines };
 }
 function normalizeReplaceRangeEdit(edit, index) {
-    const pos = normalizeAnchor(edit.pos);
-    const end = normalizeAnchor(edit.end);
+    const pos = requireAnchor(edit.pos, index, "pos");
+    const end = requireAnchor(edit.end, index, "end");
     if (!pos || !end) {
         throw new Error(`Edit ${index}: replace_range requires both pos and end anchors`);
     }
+    const lines = requireLines(edit, index);
+    assertNonBlankReplacement(edit, index, lines);
+    assertPhysicalLines(edit, index, lines);
     return {
         op: "replace_range",
         pos,
         end,
-        lines: requireLines(edit, index),
+        lines,
     };
 }
 function normalizeInsertEdit(edit, index, op) {
-    const pos = normalizeAnchor(edit.pos);
-    const end = normalizeAnchor(edit.end);
+    const pos = requireAnchor(edit.pos, index, "pos");
+    const end = requireAnchor(edit.end, index, "end");
     const anchor = pos ?? end;
     const lines = requireLines(edit, index);
+    assertPhysicalLines(edit, index, lines);
     const normalized = {
         op,
         lines,
@@ -78,6 +93,27 @@ function normalizeInsertEdit(edit, index, op) {
     }
     return normalized;
 }
+function assertPhysicalLines(edit, index, lines) {
+    if (typeof lines === "string") {
+        return;
+    }
+    for (let entryIndex = 0; entryIndex < lines.length; entryIndex += 1) {
+        const entry = lines[entryIndex] ?? "";
+        if (entry.includes("\n") || entry.includes("\r")) {
+            throw new Error(`Edit ${index}: lines[${entryIndex}] for ${edit.op ?? "unknown"} contains an embedded newline. ` +
+                "Each array entry must be exactly one physical line; split the content into separate entries.");
+        }
+    }
+}
+function assertNonBlankReplacement(edit, index, lines) {
+    const isBlank = (typeof lines === "string" && lines === "") ||
+        (Array.isArray(lines) && lines.length === 1 && lines[0] === "");
+    if (!isBlank) {
+        return;
+    }
+    throw new Error(`Edit ${index}: ${edit.op ?? "unknown"} with a single blank line (lines: [""]) is ambiguous and was rejected. ` +
+        "To delete lines use lines: [] or lines: null. To insert a blank line use append or prepend.");
+}
 export function normalizeHashlineEdits(rawEdits) {
     return rawEdits.map((rawEdit, index) => {
         const edit = rawEdit ?? {};

package/dist/plugins/hashline-edit/normalize-edits.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-edits.js","sourceRoot":"","sources":["../../../src/plugins/hashline-edit/normalize-edits.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,iBAAiB;AACjB,wBAAwB;AACxB,qGAAqG;AACrG,qIAAqI;AACrI,kDAAkD;AAClD,oCAAoC;AACpC,kBAAkB;AAClB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,kFAAkF;AAClF,2FAA2F;AAC3F,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,0HAA0H;AAC1H,qBAAqB;AAmBrB,SAAS,eAAe,CAAC,KAAyB;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9C,CAAC;AAED,SAAS,YAAY,CAAC,IAAqB,EAAE,KAAa;IACxD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,2BAA2B,IAAI,CAAC,EAAE,IAAI,SAAS,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAqB,EAAE,KAAa;IAChE,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,+BAA+B,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CACb,QAAQ,KAAK,iFAAiF,CAC/F,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,QAAQ,KAAK,iDAAiD;YAC5D,cAAc,IAAI,CAAC,KAAK,CAAC,MAAM,oFAAoF,CACtH,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE,EAAE,SAAS;QACb,GAAG;QACH,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAqB,EAAE,KAAa;IACrE,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,mDAAmD,CAAC,CAAC;IACpF,CAAC;IACD,OAAO;QACL,EAAE,EAAE,eAAe;QACnB,GAAG;QACH,GAAG;QACH,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAAqB,EACrB,KAAa,EACb,EAAwB;IAExB,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;IAC1B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACxC,MAAM,UAAU,GAA6B;QAC3C,EAAE;QACF,KAAK;KACN,CAAC;IACF,IAAI,MAAM,EAAE,CAAC;QACX,UAAU,CAAC,GAAG,GAAG,MAAM,CAAC;IAC1B,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAA2B;IAChE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,OAAO,IAAI,EAAE,CAAC;QAE3B,QAAQ,IAAI,CAAC,EAAE,EAAE,CAAC;YAChB,KAAK,SAAS;gBACZ,OAAO,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3C,KAAK,eAAe;gBAClB,OAAO,yBAAyB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAChD,KAAK,QAAQ;gBACX,OAAO,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;YACpD,KAAK,SAAS;gBACZ,OAAO,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;YACrD;gBACE,MAAM,IAAI,KAAK,CACb,QAAQ,KAAK,qBAAqB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,oDAAoD,CACtG,CAAC;QACN,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"normalize-edits.js","sourceRoot":"","sources":["../../../src/plugins/hashline-edit/normalize-edits.ts"],"names":[],"mappings":"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"}

package/dist/plugins/hashline-edit/replace-engine.d.ts

@@ -0,0 +1,24 @@
+export interface ReplaceEditParams {
+    oldString: string;
+    newString: string;
+    replaceAll?: boolean;
+}
+export type ReplaceMatchLayer = "exact" | "unicode_confusables" | "trailing_whitespace";
+export type ReplaceApplyResult = {
+    ok: true;
+    content: string;
+    layer: ReplaceMatchLayer;
+    replacements: number;
+    warnings: string[];
+} | {
+    ok: false;
+    error: string;
+    warnings: string[];
+};
+export declare function applyReplaceEdit(content: string, params: ReplaceEditParams): ReplaceApplyResult;
+export declare function formatReplaceSuccess(filePath: string, beforeContent: string, result: {
+    content: string;
+    layer: ReplaceMatchLayer;
+    replacements: number;
+    warnings: string[];
+}): string;

package/dist/plugins/hashline-edit/replace-engine.js

@@ -0,0 +1,246 @@
+// FILE: src/plugins/hashline-edit/replace-engine.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Apply oldString/newString replace edits with the native qwen/kimi harness contract: exact literal matching, limited visible fallback layers, uniqueness rules, and teaching errors. Tool-facing snake_case aliases (old_string/new_string) are resolved to this engine at the plugin layer.
+//   SCOPE: Pure content-level replace application with exact, unicode-confusables, and trailing-whitespace layers; occurrence counting; replace-all mode; result formatting with bounded diff summary.
+//   DEPENDS: [src/plugins/hashline-edit/diff-summary.ts]
+//   LINKS: [M-PLUGIN-HASHLINE-EDIT]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   ReplaceEditParams - Tool-facing replace arguments (oldString, newString, replaceAll).
+//   ReplaceMatchLayer - Which matching layer produced the applied match.
+//   ReplaceApplyResult - Structured outcome: applied content with layer and replacement count, or a teaching error.
+//   applyReplaceEdit - Apply a replace edit to file content with layered fail-closed matching.
+//   formatReplaceSuccess - Render the success output with stats, warnings, and bounded diff.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v0.1.0 - Established the replace profile engine with exact, unicode-confusables, and trailing-whitespace layers adapted from the qwen-code contract (Apache-2.0).]
+// END_CHANGE_SUMMARY
+import { findFirstChangedLine, summarizeEditDiff } from "./diff-summary.js";
+// END_BLOCK_TYPES
+// START_BLOCK_CONFUSABLES
+// Character-level typography normalization adapted from qwen-code editHelper
+// (Apache-2.0). Every entry maps one code point to one code point so string
+// offsets are preserved between original and normalized text.
+const UNICODE_EQUIVALENT_MAP = {
+    "\u2010": "-",
+    "\u2011": "-",
+    "\u2012": "-",
+    "\u2013": "-",
+    "\u2014": "-",
+    "\u2015": "-",
+    "\u2212": "-",
+    "\u2018": "'",
+    "\u2019": "'",
+    "\u201A": "'",
+    "\u201B": "'",
+    "\u201C": '"',
+    "\u201D": '"',
+    "\u201E": '"',
+    "\u201F": '"',
+    "\u00A0": " ",
+    "\u2002": " ",
+    "\u2003": " ",
+    "\u2004": " ",
+    "\u2005": " ",
+    "\u2006": " ",
+    "\u2007": " ",
+    "\u2008": " ",
+    "\u2009": " ",
+    "\u200A": " ",
+    "\u202F": " ",
+    "\u205F": " ",
+    "\u3000": " ",
+};
+function normalizeConfusables(text) {
+    let normalized = "";
+    for (const char of text) {
+        normalized += UNICODE_EQUIVALENT_MAP[char] ?? char;
+    }
+    return normalized;
+}
+// END_BLOCK_CONFUSABLES
+// START_BLOCK_MATCHING
+function countOccurrences(content, needle) {
+    if (needle.length === 0) {
+        return 0;
+    }
+    let count = 0;
+    let position = 0;
+    while (position < content.length) {
+        const index = content.indexOf(needle, position);
+        if (index === -1) {
+            break;
+        }
+        count += 1;
+        position = index + needle.length;
+    }
+    return count;
+}
+function matchTrailingWhitespaceBlocks(content, oldString) {
+    const contentLines = content.split("\n");
+    const searchLines = oldString.split("\n").map((line) => line.trimEnd());
+    if (searchLines.every((line) => line === "")) {
+        return [];
+    }
+    const offsets = [];
+    let cursor = 0;
+    for (const line of contentLines) {
+        offsets.push(cursor);
+        cursor += line.length + 1;
+    }
+    const blocks = [];
+    for (let i = 0; i + searchLines.length <= contentLines.length; i += 1) {
+        let matches = true;
+        for (let j = 0; j < searchLines.length; j += 1) {
+            if ((contentLines[i + j] ?? "").trimEnd() !== searchLines[j]) {
+                matches = false;
+                break;
+            }
+        }
+        if (!matches) {
+            continue;
+        }
+        const lastIndex = i + searchLines.length - 1;
+        blocks.push({
+            start: offsets[i],
+            end: offsets[lastIndex] + (contentLines[lastIndex] ?? "").length,
+        });
+        i = lastIndex;
+    }
+    return blocks;
+}
+function ambiguityError(count) {
+    return (`Failed to edit: oldString matches ${count} locations in the file. ` +
+        "Provide more surrounding context to make the match unique, or set replaceAll to true to replace every occurrence.");
+}
+function notFoundError() {
+    return ("Failed to edit: oldString not found. The exact text was not found in the file. " +
+        "Check whitespace, indentation, and context, and use the Read tool to verify the current " +
+        "content before retrying; the file may have changed since you last read it.");
+}
+// Offsets are identical in original and normalized text because every
+// confusable maps one code point to one code point.
+function replaceNormalizedOccurrences(original, normalized, normalizedNeedle, replacement, all) {
+    let result = "";
+    let cursor = 0;
+    let position = 0;
+    while (position < normalized.length) {
+        const index = normalized.indexOf(normalizedNeedle, position);
+        if (index === -1) {
+            break;
+        }
+        result += original.slice(cursor, index) + replacement;
+        cursor = index + normalizedNeedle.length;
+        position = index + normalizedNeedle.length;
+        if (!all) {
+            break;
+        }
+    }
+    result += original.slice(cursor);
+    return result;
+}
+// END_BLOCK_MATCHING
+// START_BLOCK_APPLY
+export function applyReplaceEdit(content, params) {
+    const warnings = [];
+    const replaceAll = params.replaceAll ?? false;
+    if (params.oldString === params.newString) {
+        return {
+            ok: false,
+            error: "No changes to apply: oldString and newString are identical.",
+            warnings,
+        };
+    }
+    if (params.oldString === "") {
+        return {
+            ok: false,
+            error: "oldString cannot be empty when editing an existing file. Provide the exact text to replace.",
+            warnings,
+        };
+    }
+    // Layer 1: exact literal match.
+    const exactCount = countOccurrences(content, params.oldString);
+    if (exactCount > 0) {
+        if (!replaceAll && exactCount > 1) {
+            return { ok: false, error: ambiguityError(exactCount), warnings };
+        }
+        const next = replaceAll
+            ? content.split(params.oldString).join(params.newString)
+            : content.replace(params.oldString, params.newString);
+        return {
+            ok: true,
+            content: next,
+            layer: "exact",
+            replacements: replaceAll ? exactCount : 1,
+            warnings,
+        };
+    }
+    // Layer 2: unicode confusables (typography characters equated to ASCII).
+    const normalizedContent = normalizeConfusables(content);
+    const normalizedOld = normalizeConfusables(params.oldString);
+    if (normalizedContent !== content || normalizedOld !== params.oldString) {
+        const normalizedCount = countOccurrences(normalizedContent, normalizedOld);
+        if (normalizedCount > 0) {
+            if (!replaceAll && normalizedCount > 1) {
+                return { ok: false, error: ambiguityError(normalizedCount), warnings };
+            }
+            warnings.push("oldString matched after unicode confusables normalization (typography characters such as curly quotes, dashes, or special spaces were equated to ASCII); the replacement was applied to the original bytes.");
+            const next = replaceNormalizedOccurrences(content, normalizedContent, normalizedOld, params.newString, replaceAll);
+            return {
+                ok: true,
+                content: next,
+                layer: "unicode_confusables",
+                replacements: replaceAll ? normalizedCount : 1,
+                warnings,
+            };
+        }
+    }
+    // Layer 3: trailing whitespace ignored per line; indentation stays exact.
+    const blocks = matchTrailingWhitespaceBlocks(content, params.oldString);
+    if (blocks.length > 0) {
+        if (!replaceAll && blocks.length > 1) {
+            return { ok: false, error: ambiguityError(blocks.length), warnings };
+        }
+        warnings.push(`oldString matched after ignoring trailing whitespace on ${blocks.length} block(s); leading whitespace (indentation) was matched exactly.`);
+        const selected = replaceAll ? blocks : blocks.slice(0, 1);
+        let next = content;
+        for (let i = selected.length - 1; i >= 0; i -= 1) {
+            const block = selected[i];
+            next = next.slice(0, block.start) + params.newString + next.slice(block.end);
+        }
+        return {
+            ok: true,
+            content: next,
+            layer: "trailing_whitespace",
+            replacements: selected.length,
+            warnings,
+        };
+    }
+    return { ok: false, error: notFoundError(), warnings };
+}
+// END_BLOCK_APPLY
+// START_BLOCK_FORMAT
+export function formatReplaceSuccess(filePath, beforeContent, result) {
+    const diff = summarizeEditDiff(beforeContent, result.content);
+    const firstChangedLine = findFirstChangedLine(beforeContent, result.content);
+    const stats = `+${diff.additions}/-${diff.deletions}${firstChangedLine !== undefined ? `, first change line ${firstChangedLine}` : ""}`;
+    const parts = [`Updated ${filePath} (${stats})`];
+    if (result.layer !== "exact") {
+        parts.push(`Note: matched via ${result.layer} fallback layer.`);
+    }
+    if (result.replacements > 1) {
+        parts.push(`Note: replaced ${result.replacements} occurrences.`);
+    }
+    for (const warning of result.warnings) {
+        parts.push(`Warning: ${warning}`);
+    }
+    parts.push(...diff.rendered);
+    return parts.join("\n");
+}
+// END_BLOCK_FORMAT
+//# sourceMappingURL=replace-engine.js.map

package/dist/plugins/hashline-edit/replace-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-engine.js","sourceRoot":"","sources":["../../../src/plugins/hashline-edit/replace-engine.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,iBAAiB;AACjB,wBAAwB;AACxB,ySAAyS;AACzS,uMAAuM;AACvM,yDAAyD;AACzD,oCAAoC;AACpC,kBAAkB;AAClB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,0FAA0F;AAC1F,yEAAyE;AACzE,oHAAoH;AACpH,+FAA+F;AAC/F,6FAA6F;AAC7F,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,qLAAqL;AACrL,qBAAqB;AAErB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAwB5E,kBAAkB;AAElB,0BAA0B;AAC1B,6EAA6E;AAC7E,4EAA4E;AAC5E,8DAA8D;AAC9D,MAAM,sBAAsB,GAA2B;IACrD,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF,SAAS,oBAAoB,CAAC,IAAY;IACxC,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,UAAU,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACrD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AACD,wBAAwB;AAExB,uBAAuB;AACvB,SAAS,gBAAgB,CAAC,OAAe,EAAE,MAAc;IACvD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,OAAO,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAChD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM;QACR,CAAC;QACD,KAAK,IAAI,CAAC,CAAC;QACX,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAOD,SAAS,6BAA6B,CAAC,OAAe,EAAE,SAAiB;IACvE,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACxE,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtE,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,OAAO,GAAG,KAAK,CAAC;gBAChB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,OAAO,CAAC,CAAC,CAAE;YAClB,GAAG,EAAE,OAAO,CAAC,SAAS,CAAE,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM;SAClE,CAAC,CAAC;QACH,CAAC,GAAG,SAAS,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,CACL,qCAAqC,KAAK,0BAA0B;QACpE,mHAAmH,CACpH,CAAC;AACJ,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,CACL,iFAAiF;QACjF,0FAA0F;QAC1F,4EAA4E,CAC7E,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,oDAAoD;AACpD,SAAS,4BAA4B,CACnC,QAAgB,EAChB,UAAkB,EAClB,gBAAwB,EACxB,WAAmB,EACnB,GAAY;IAEZ,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,OAAO,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAC7D,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM;QACR,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,WAAW,CAAC;QACtD,MAAM,GAAG,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC;QACzC,QAAQ,GAAG,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAC3C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM;QACR,CAAC;IACH,CAAC;IACD,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC;AACD,qBAAqB;AAErB,oBAAoB;AACpB,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,MAAyB;IACzE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,KAAK,CAAC;IAE9C,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,6DAA6D;YACpE,QAAQ;SACT,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,EAAE,EAAE,CAAC;QAC5B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EACH,6FAA6F;YAC/F,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/D,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,UAAU,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YAClC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;QACpE,CAAC;QACD,MAAM,IAAI,GAAG,UAAU;YACrB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YACxD,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACxD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,OAAO;YACd,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACzC,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7D,IAAI,iBAAiB,KAAK,OAAO,IAAI,aAAa,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QACxE,MAAM,eAAe,GAAG,gBAAgB,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;QAC3E,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,UAAU,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;gBACvC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC;YACzE,CAAC;YACD,QAAQ,CAAC,IAAI,CACX,6MAA6M,CAC9M,CAAC;YACF,MAAM,IAAI,GAAG,4BAA4B,CACvC,OAAO,EACP,iBAAiB,EACjB,aAAa,EACb,MAAM,CAAC,SAAS,EAChB,UAAU,CACX,CAAC;YACF,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,qBAAqB;gBAC5B,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;gBAC9C,QAAQ;aACT,CAAC;QACJ,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,MAAM,MAAM,GAAG,6BAA6B,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACxE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;QACvE,CAAC;QACD,QAAQ,CAAC,IAAI,CACX,2DAA2D,MAAM,CAAC,MAAM,kEAAkE,CAC3I,CAAC;QACF,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,IAAI,IAAI,GAAG,OAAO,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;YAC3B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,qBAAqB;YAC5B,YAAY,EAAE,QAAQ,CAAC,MAAM;YAC7B,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC;AACzD,CAAC;AACD,kBAAkB;AAElB,qBAAqB;AACrB,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,aAAqB,EACrB,MAA+F;IAE/F,MAAM,IAAI,GAAG,iBAAiB,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,GACjD,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,uBAAuB,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAC/E,EAAE,CAAC;IACH,MAAM,KAAK,GAAG,CAAC,WAAW,QAAQ,KAAK,KAAK,GAAG,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,KAAK,kBAAkB,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,YAAY,eAAe,CAAC,CAAC;IACnE,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AACD,mBAAmB"}

package/dist/plugins/hashline-edit/routing.d.ts

@@ -0,0 +1,21 @@
+export declare const EDIT_MODES: readonly ["hashline", "replace", "str_replace_editor", "passthrough"];
+export type EditMode = (typeof EDIT_MODES)[number];
+export interface RoutingRule {
+    pattern: string;
+    mode: EditMode;
+}
+export interface RoutingConfig {
+    default: EditMode;
+    rules: RoutingRule[];
+}
+export declare const DEFAULT_ROUTING_CONFIG: RoutingConfig;
+export declare function parseRoutingConfig(raw: unknown): RoutingConfig;
+export interface HashlineEditPluginSettings {
+    enabled: boolean;
+    routing: RoutingConfig;
+}
+export declare function parseHashlineEditPluginEntry(raw: unknown): HashlineEditPluginSettings;
+export declare function resolveEditMode(config: RoutingConfig, model: {
+    providerID?: string;
+    modelID?: string;
+} | undefined): EditMode;

package/dist/plugins/hashline-edit/routing.js

@@ -0,0 +1,113 @@
+// FILE: src/plugins/hashline-edit/routing.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Define edit-mode routing configuration and resolve the active edit mode for a session model.
+//   SCOPE: EditMode vocabulary, strict routing config parsing with the default routing table, plugin entry union resolution, and case-insensitive provider-then-model substring matching.
+//   DEPENDS: [none]
+//   LINKS: [M-PLUGIN-HASHLINE-EDIT]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   EDIT_MODES - Canonical edit mode identifiers accepted by routing configuration.
+//   EditMode - Union type of edit mode identifiers.
+//   RoutingRule - One ordered pattern-to-mode routing entry.
+//   RoutingConfig - Parsed routing table with default mode and ordered rules.
+//   DEFAULT_ROUTING_CONFIG - Built-in routing table applied when config does not override it.
+//   parseRoutingConfig - Strictly parse an unknown routing value into a RoutingConfig or throw.
+//   HashlineEditPluginSettings - Resolved enabled flag and routing config for the hashline-edit plugin entry.
+//   parseHashlineEditPluginEntry - Resolve the plugins["hashline-edit"] boolean-or-object union into enabled flag and routing config.
+//   resolveEditMode - Resolve the active edit mode for a provider/model pair against a routing config.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v0.1.0 - Established routing vocabulary, default table, strict parsing, and provider-then-model resolution.]
+// END_CHANGE_SUMMARY
+// START_BLOCK_VOCABULARY
+export const EDIT_MODES = ["hashline", "replace", "str_replace_editor", "passthrough"];
+// END_BLOCK_VOCABULARY
+// START_BLOCK_DEFAULT_TABLE
+export const DEFAULT_ROUTING_CONFIG = {
+    default: "hashline",
+    rules: [
+        { pattern: "deepseek", mode: "str_replace_editor" },
+        { pattern: "kimi", mode: "replace" },
+        { pattern: "qwen", mode: "replace" },
+        { pattern: "gpt", mode: "passthrough" },
+        { pattern: "codex", mode: "passthrough" },
+    ],
+};
+// END_BLOCK_DEFAULT_TABLE
+// START_BLOCK_PARSE
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseEditMode(value, where) {
+    if (typeof value === "string" && EDIT_MODES.includes(value)) {
+        return value;
+    }
+    throw new Error(`hashline-edit routing: ${where} must be one of ${EDIT_MODES.join(", ")}; got ${JSON.stringify(value)}`);
+}
+export function parseRoutingConfig(raw) {
+    if (raw === undefined || raw === null) {
+        return DEFAULT_ROUTING_CONFIG;
+    }
+    if (!isRecord(raw)) {
+        throw new Error("hashline-edit routing: routing config must be an object");
+    }
+    const defaultMode = raw.default === undefined ? "hashline" : parseEditMode(raw.default, "default");
+    const rules = [];
+    if (raw.rules !== undefined) {
+        if (!isRecord(raw.rules)) {
+            throw new Error("hashline-edit routing: rules must be an object mapping patterns to modes");
+        }
+        for (const [pattern, mode] of Object.entries(raw.rules)) {
+            if (pattern.trim().length === 0) {
+                throw new Error("hashline-edit routing: rule patterns must be non-empty strings");
+            }
+            rules.push({ pattern, mode: parseEditMode(mode, `rules["${pattern}"]`) });
+        }
+    }
+    return { default: defaultMode, rules };
+}
+export function parseHashlineEditPluginEntry(raw) {
+    if (raw === undefined || raw === null) {
+        return { enabled: true, routing: DEFAULT_ROUTING_CONFIG };
+    }
+    if (typeof raw === "boolean") {
+        return { enabled: raw, routing: DEFAULT_ROUTING_CONFIG };
+    }
+    if (!isRecord(raw)) {
+        throw new Error('hashline-edit: plugins["hashline-edit"] must be a boolean or an object');
+    }
+    const enabled = raw.enabled === undefined ? true : raw.enabled;
+    if (typeof enabled !== "boolean") {
+        throw new Error("hashline-edit: enabled must be a boolean");
+    }
+    return { enabled, routing: parseRoutingConfig(raw.routing) };
+}
+// END_BLOCK_PARSE
+// START_BLOCK_RESOLVE
+export function resolveEditMode(config, model) {
+    if (!model) {
+        return config.default;
+    }
+    const providerID = model.providerID?.toLowerCase();
+    const modelID = model.modelID?.toLowerCase();
+    for (const rule of config.rules) {
+        const pattern = rule.pattern.toLowerCase();
+        if (providerID !== undefined && providerID.includes(pattern)) {
+            return rule.mode;
+        }
+    }
+    for (const rule of config.rules) {
+        const pattern = rule.pattern.toLowerCase();
+        if (modelID !== undefined && modelID.includes(pattern)) {
+            return rule.mode;
+        }
+    }
+    return config.default;
+}
+// END_BLOCK_RESOLVE
+//# sourceMappingURL=routing.js.map

package/dist/plugins/hashline-edit/routing.js.map

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

package/dist/plugins/hashline-edit/session-state.d.ts

@@ -0,0 +1,23 @@
+export interface SessionModelInfo {
+    providerID: string;
+    modelID: string;
+}
+export declare class SessionModelCache {
+    #private;
+    set(sessionID: string, model: SessionModelInfo): void;
+    get(sessionID: string): SessionModelInfo | undefined;
+    delete(sessionID: string): void;
+    clear(): void;
+}
+export interface FileSnapshot {
+    mtimeMs: number;
+    size: number;
+}
+export type FileCacheVerdict = "unread" | "fresh" | "drifted";
+export declare class SessionFileCache {
+    #private;
+    record(sessionID: string, filePath: string, snapshot: FileSnapshot): void;
+    check(sessionID: string, filePath: string, current: FileSnapshot | undefined): FileCacheVerdict;
+    forget(sessionID: string, filePath: string): void;
+    clear(): void;
+}