@greppleai/grip 0.0.0-stage → 0.1.3

package/dist/core/tools/hashline/parse.js

@@ -0,0 +1,41 @@
+import { ALPH_RE, ANCHOR_LEN, DIFF_MINUS_RE, HL_PREFIX_PLUS_RE } from "./hash.js";
+function diagRef(ref) {
+    const trimmed = ref.trim();
+    if (!trimmed.length) {
+        return `[E_BAD_REF] Invalid anchor. Expected a 3-char base64 anchor (e.g. "aB3").`;
+    }
+    if (/^\d+/.test(trimmed)) {
+        return `[E_BAD_REF] Invalid anchor. Use the hash alone (e.g. "aB3") — no line numbers or trailing content.`;
+    }
+    if (trimmed.includes("│")) {
+        return `[E_BAD_REF] Invalid anchor "${trimmed}". hash_range_inclusive must contain the 3-char hash only — remove everything from "│" onward.`;
+    }
+    return `[E_BAD_REF] Invalid anchor "${trimmed}". Expected a 3-char base64 anchor (e.g. "aB3").`;
+}
+function parseRef(ref) {
+    const trimmed = ref.trim();
+    if (trimmed.length === ANCHOR_LEN && ALPH_RE.test(trimmed)) {
+        return { hash: trimmed };
+    }
+    throw new Error(diagRef(ref));
+}
+export const parseHashRef = parseRef;
+function assertNoPrefixes(lines) {
+    for (const line of lines) {
+        if (!line.length)
+            continue;
+        if (HL_PREFIX_PLUS_RE.test(line) || DIFF_MINUS_RE.test(line)) {
+            throw new Error(`[E_INVALID_PATCH] "content_lines" must contain literal file content. Offending line looks like the diff preview's +HASH│ row: ${JSON.stringify(line)}. Use literal file content only — plain + or - lines are written literally.`);
+        }
+    }
+}
+export function parseText(edit) {
+    if (edit === null)
+        return [];
+    const lines = typeof edit === "string"
+        ? (edit.endsWith("\n") ? edit.slice(0, -1) : edit).replaceAll("\r", "").split("\n")
+        : edit;
+    assertNoPrefixes(lines);
+    return lines;
+}
+//# sourceMappingURL=parse.js.map

package/dist/core/tools/hashline/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../../src/core/tools/hashline/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAIlF,SAAS,OAAO,CAAC,GAAW,EAAU;IACrC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAE3B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,2EAA2E,CAAC;IACpF,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,OAAO,sGAAoG,CAAC;IAC7G,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,+BAA+B,OAAO,oGAAgG,CAAC;IAC/I,CAAC;IAED,OAAO,+BAA+B,OAAO,kDAAkD,CAAC;AAAA,CAChG;AAED,SAAS,QAAQ,CAAC,GAAW,EAAU;IACtC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAE3B,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAAA,CAC9B;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AAErC,SAAS,gBAAgB,CAAC,KAAe,EAAQ;IAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,SAAS;QAC3B,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CACd,mIAAiI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,+EAA6E,CAClO,CAAC;QACH,CAAC;IACF,CAAC;AAAA,CACD;AAED,MAAM,UAAU,SAAS,CAAC,IAA8B,EAAY;IACnE,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,KAAK,GACV,OAAO,IAAI,KAAK,QAAQ;QACvB,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACnF,CAAC,CAAC,IAAI,CAAC;IACT,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AAAA,CACb","sourcesContent":["import { ALPH_RE, ANCHOR_LEN, DIFF_MINUS_RE, HL_PREFIX_PLUS_RE } from \"./hash.ts\";\n\nexport type Anchor = { hash: string };\n\nfunction diagRef(ref: string): string {\n\tconst trimmed = ref.trim();\n\n\tif (!trimmed.length) {\n\t\treturn `[E_BAD_REF] Invalid anchor. Expected a 3-char base64 anchor (e.g. \"aB3\").`;\n\t}\n\n\tif (/^\\d+/.test(trimmed)) {\n\t\treturn `[E_BAD_REF] Invalid anchor. Use the hash alone (e.g. \"aB3\") — no line numbers or trailing content.`;\n\t}\n\n\tif (trimmed.includes(\"│\")) {\n\t\treturn `[E_BAD_REF] Invalid anchor \"${trimmed}\". hash_range_inclusive must contain the 3-char hash only — remove everything from \"│\" onward.`;\n\t}\n\n\treturn `[E_BAD_REF] Invalid anchor \"${trimmed}\". Expected a 3-char base64 anchor (e.g. \"aB3\").`;\n}\n\nfunction parseRef(ref: string): Anchor {\n\tconst trimmed = ref.trim();\n\n\tif (trimmed.length === ANCHOR_LEN && ALPH_RE.test(trimmed)) {\n\t\treturn { hash: trimmed };\n\t}\n\n\tthrow new Error(diagRef(ref));\n}\n\nexport const parseHashRef = parseRef;\n\nfunction assertNoPrefixes(lines: string[]): void {\n\tfor (const line of lines) {\n\t\tif (!line.length) continue;\n\t\tif (HL_PREFIX_PLUS_RE.test(line) || DIFF_MINUS_RE.test(line)) {\n\t\t\tthrow new Error(\n\t\t\t\t`[E_INVALID_PATCH] \"content_lines\" must contain literal file content. Offending line looks like the diff preview's +HASH│ row: ${JSON.stringify(line)}. Use literal file content only — plain + or - lines are written literally.`,\n\t\t\t);\n\t\t}\n\t}\n}\n\nexport function parseText(edit: string[] | string | null): string[] {\n\tif (edit === null) return [];\n\tconst lines =\n\t\ttypeof edit === \"string\"\n\t\t\t? (edit.endsWith(\"\\n\") ? edit.slice(0, -1) : edit).replaceAll(\"\\r\", \"\").split(\"\\n\")\n\t\t\t: edit;\n\tassertNoPrefixes(lines);\n\treturn lines;\n}\n"]}

package/dist/core/tools/hashline/resolve.d.ts

@@ -0,0 +1,51 @@
+import { type Anchor } from "./parse.ts";
+export type RAnchor = {
+    line: number;
+    hash: string;
+    hashMatched: boolean;
+};
+export type HEdit = {
+    hash_range_inclusive: [Anchor, Anchor];
+    content_lines: string[];
+};
+export type RHEdit = {
+    hash_range_inclusive: [RAnchor, RAnchor];
+    content_lines: string[];
+};
+type HashAnchorMismatchKind = "not_found" | "ambiguous";
+export type BoundaryDuplicateKind = "trailing" | "leading";
+interface HMismatch {
+    ref: Anchor;
+    kind: HashAnchorMismatchKind;
+    candidates?: number[];
+}
+export interface BDupWarn {
+    kind: BoundaryDuplicateKind;
+    survivingLineContent: string;
+    survivingLineIndex: number;
+    occurrence: number;
+    replacementLineContent: string;
+    editIndex: number;
+}
+interface EditValidationResult {
+    resolved: RHEdit[];
+    mismatches: HMismatch[];
+    boundaryWarnings: BDupWarn[];
+}
+export interface NEdit {
+    editIndex: number;
+    loc: string;
+    currentContent: string;
+}
+export type HTEdit = {
+    hash_range_inclusive: [string, string];
+    content_lines: string[];
+};
+export declare function fmtMismatch(mismatches: HMismatch[], fileLines: string[], fileHashes: string[], filePath?: string): string;
+export declare function resEdits(edits: HTEdit[]): HEdit[];
+declare function warnUnicodeEsc(edits: HEdit[], warnings: string[]): void;
+export declare function assertNoBarePrefix(edits: HEdit[], _fileLines: string[], fileHashes: string[]): void;
+export declare function descEdit(edit: RHEdit): string;
+export declare function valEdits(edits: HEdit[], fileLines: string[], fileHashes: string[], _warnings: string[], signal: AbortSignal | undefined): EditValidationResult;
+export { warnUnicodeEsc };
+//# sourceMappingURL=resolve.d.ts.map

package/dist/core/tools/hashline/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/hashline/resolve.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAA2B,MAAM,YAAY,CAAC;AAElE,MAAM,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAAE,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AACxF,MAAM,MAAM,MAAM,GAAG;IACpB,oBAAoB,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,KAAK,sBAAsB,GAAG,WAAW,GAAG,WAAW,CAAC;AACxD,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3D,UAAU,SAAS;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,sBAAsB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CAClB;AACD,UAAU,oBAAoB;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,gBAAgB,EAAE,QAAQ,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,KAAK;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,MAAM,GAAG;IACpB,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AA8DF,wBAAgB,WAAW,CAC1B,UAAU,EAAE,SAAS,EAAE,EACvB,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,CAAC,EAAE,MAAM,GACf,MAAM,CAQR;AAmCD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAYjD;AAED,iBAAS,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAQhE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CA2BnG;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AA2BD,wBAAgB,QAAQ,CACvB,KAAK,EAAE,KAAK,EAAE,EACd,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC7B,oBAAoB,CAkDtB;AAED,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import { rejectUnknownFields } from \"../hashline-utils.ts\";\nimport { abortIf } from \"../runtime.ts\";\nimport { HL_BARE_PREFIX_RE } from \"./hash.ts\";\nimport { type Anchor, parseHashRef, parseText } from \"./parse.ts\";\n\nexport type RAnchor = {\n\tline: number;\n\thash: string;\n\thashMatched: boolean;\n};\n\nexport type HEdit = { hash_range_inclusive: [Anchor, Anchor]; content_lines: string[] };\nexport type RHEdit = {\n\thash_range_inclusive: [RAnchor, RAnchor];\n\tcontent_lines: string[];\n};\n\ntype HashAnchorMismatchKind = \"not_found\" | \"ambiguous\";\nexport type BoundaryDuplicateKind = \"trailing\" | \"leading\";\n\ninterface HMismatch {\n\tref: Anchor;\n\tkind: HashAnchorMismatchKind;\n\tcandidates?: number[];\n}\n\nexport interface BDupWarn {\n\tkind: BoundaryDuplicateKind;\n\tsurvivingLineContent: string;\n\tsurvivingLineIndex: number;\n\toccurrence: number;\n\treplacementLineContent: string;\n\teditIndex: number;\n}\ninterface EditValidationResult {\n\tresolved: RHEdit[];\n\tmismatches: HMismatch[];\n\tboundaryWarnings: BDupWarn[];\n}\n\nexport interface NEdit {\n\teditIndex: number;\n\tloc: string;\n\tcurrentContent: string;\n}\n\nexport type HTEdit = {\n\thash_range_inclusive: [string, string];\n\tcontent_lines: string[];\n};\n\nfunction resAnchor(ref: Anchor, _fileLines: string[], fileHashes: string[]): RAnchor | HMismatch {\n\tconst hashMatches: number[] = [];\n\tfor (let i = 0; i < fileHashes.length; i++) {\n\t\tif (fileHashes[i] === ref.hash) hashMatches.push(i + 1);\n\t}\n\tif (hashMatches.length === 0) {\n\t\treturn { ref, kind: \"not_found\" };\n\t}\n\tif (hashMatches.length === 1) {\n\t\treturn {\n\t\t\tline: hashMatches[0]!,\n\t\t\thash: ref.hash,\n\t\t\thashMatched: true,\n\t\t};\n\t}\n\treturn { ref, kind: \"ambiguous\", candidates: hashMatches };\n}\n\nfunction assertAligned(fileLines: string[], fileHashes: string[], ctx: string): void {\n\tif (fileHashes.length !== fileLines.length) {\n\t\tthrow new Error(\n\t\t\t`${ctx}: fileHashes.length (${fileHashes.length}) must match fileLines.length (${fileLines.length}).`,\n\t\t);\n\t}\n}\n\nfunction formatNotFoundMismatches(mismatches: HMismatch[], filePath: string | undefined): string | undefined {\n\tconst notFound = mismatches.filter((mismatch) => mismatch.kind === \"not_found\");\n\tif (notFound.length === 0) return undefined;\n\tconst references = notFound.map((mismatch) => `\"${mismatch.ref.hash}\"`).join(\", \");\n\treturn `[E_STALE_ANCHOR] ${notFound.length} stale anchor${notFound.length > 1 ? \"s\" : \"\"}${filePath ? ` in ${filePath}` : \"\"}: ${references}. Call read() to get fresh anchors, then copy the 3-char HASH of the start and end of the range you are replacing into hash_range_inclusive of your next replace call.`;\n}\n\nfunction formatAmbiguousMismatchDetail(mismatch: HMismatch, fileLines: string[], fileHashes: string[]): string {\n\tconst sample = (mismatch.candidates ?? []).slice(0, 5);\n\tconst candidateCount = mismatch.candidates?.length ?? 0;\n\tconst more = candidateCount > sample.length ? `, ... (+${candidateCount - sample.length} more)` : \"\";\n\tconst lines = sample\n\t\t.map((line) => {\n\t\t\tconst content = fileLines[line - 1] ?? \"\";\n\t\t\treturn `    ${line}: ${fileHashes[line - 1]}│${content}`;\n\t\t})\n\t\t.join(\"\\n\");\n\treturn `  Hash \"${mismatch.ref.hash}\" matches lines ${sample.join(\", \")}${more}.\\n${lines}`;\n}\n\nfunction formatAmbiguousMismatches(\n\tmismatches: HMismatch[],\n\tfileLines: string[],\n\tfileHashes: string[],\n\tfilePath: string | undefined,\n): string | undefined {\n\tconst ambiguous = mismatches.filter((mismatch) => mismatch.kind === \"ambiguous\");\n\tif (ambiguous.length === 0) return undefined;\n\tconst header = `[E_AMBIGUOUS_ANCHOR] ${ambiguous.length} ambiguous anchor${ambiguous.length > 1 ? \"s\" : \"\"}${filePath ? ` in ${filePath}` : \"\"}. Call read() to get fresh anchors, then copy the 3-char HASH of the start and end of the range you are replacing into hash_range_inclusive of your next replace call.`;\n\treturn [header, ...ambiguous.map((mismatch) => formatAmbiguousMismatchDetail(mismatch, fileLines, fileHashes))].join(\n\t\t\"\\n\",\n\t);\n}\n\nexport function fmtMismatch(\n\tmismatches: HMismatch[],\n\tfileLines: string[],\n\tfileHashes: string[],\n\tfilePath?: string,\n): string {\n\tassertAligned(fileLines, fileHashes, \"fmtMismatch\");\n\treturn [\n\t\tformatNotFoundMismatches(mismatches, filePath),\n\t\tformatAmbiguousMismatches(mismatches, fileLines, fileHashes, filePath),\n\t]\n\t\t.filter((section): section is string => section !== undefined)\n\t\t.join(\"\\n\\n\");\n}\n\nconst ITEM_KS = new Set([\"hash_range_inclusive\", \"content_lines\"]);\n\nfunction isStrArr(value: unknown): value is string[] {\n\treturn Array.isArray(value) && value.every((item) => typeof item === \"string\");\n}\n\nfunction isStrPair(value: unknown): value is [string, string] {\n\treturn Array.isArray(value) && value.length === 2 && value.every((item) => typeof item === \"string\");\n}\n\nfunction assertItem(edit: Record<string, unknown>, index: number): void {\n\trejectUnknownFields(edit, ITEM_KS, `Edit ${index}`, \"Each edit takes only { hash_range_inclusive, content_lines }.\");\n\n\tif (\"hash_range_inclusive\" in edit && !isStrPair(edit.hash_range_inclusive)) {\n\t\tthrow new Error(\n\t\t\t`[E_BAD_SHAPE] Edit ${index} field \"hash_range_inclusive\" must be a pair of anchor strings [start, end].`,\n\t\t);\n\t}\n\tif (!(\"content_lines\" in edit)) {\n\t\tthrow new Error(\n\t\t\t`[E_BAD_SHAPE] Edit ${index} requires a \"content_lines\" field. Provide the replacement lines (use [] to delete).`,\n\t\t);\n\t}\n\tif (\"content_lines\" in edit && !isStrArr(edit.content_lines)) {\n\t\tthrow new Error(`[E_BAD_SHAPE] Edit ${index} field \"content_lines\" must be a string array.`);\n\t}\n\tif (!isStrPair(edit.hash_range_inclusive)) {\n\t\tthrow new Error(\n\t\t\t`[E_BAD_SHAPE] Edit ${index} requires an \"hash_range_inclusive\" pair of anchor strings [start, end].`,\n\t\t);\n\t}\n}\n\nexport function resEdits(edits: HTEdit[]): HEdit[] {\n\tconst result: HEdit[] = [];\n\tfor (const [index, edit] of edits.entries()) {\n\t\tassertItem(edit as Record<string, unknown>, index);\n\n\t\tconst replaceLines = parseText(edit.content_lines);\n\t\tresult.push({\n\t\t\thash_range_inclusive: [parseHashRef(edit.hash_range_inclusive[0]), parseHashRef(edit.hash_range_inclusive[1])],\n\t\t\tcontent_lines: replaceLines,\n\t\t});\n\t}\n\treturn result;\n}\n\nfunction warnUnicodeEsc(edits: HEdit[], warnings: string[]): void {\n\tfor (const edit of edits) {\n\t\tif (edit.content_lines.some((line) => /\\\\uDDDD/i.test(line))) {\n\t\t\twarnings.push(\n\t\t\t\t\"Detected literal \\\\uDDDD in edit content; no autocorrection applied. Verify whether this should be a real Unicode escape or plain text.\",\n\t\t\t);\n\t\t}\n\t}\n}\n\nexport function assertNoBarePrefix(edits: HEdit[], _fileLines: string[], fileHashes: string[]): void {\n\tconst suspects: { line: string; hash: string; editIndex: number; lineIndex: number }[] = [];\n\tfor (let editIndex = 0; editIndex < edits.length; editIndex++) {\n\t\tconst edit = edits[editIndex]!;\n\t\tfor (let lineIndex = 0; lineIndex < edit.content_lines.length; lineIndex++) {\n\t\t\tconst line = edit.content_lines[lineIndex]!;\n\t\t\tconst match = line.match(HL_BARE_PREFIX_RE);\n\t\t\tif (match) suspects.push({ line, hash: match[1]!, editIndex, lineIndex });\n\t\t}\n\t}\n\tif (suspects.length === 0) return;\n\tconst locations = suspects.map((s) => `edit ${s.editIndex}, content_lines[${s.lineIndex}]`).join(\"; \");\n\n\tconst fileHashSet = new Set(fileHashes);\n\tconst matched = suspects.filter((s) => fileHashSet.has(s.hash));\n\tconst matchedCount = matched.length;\n\n\tconst exampleLine = `${suspects[0]!.hash}│${suspects[0]!.line}`;\n\n\tconst linesHint =\n\t\tmatchedCount === 0\n\t\t\t? `None match file line hashes.`\n\t\t\t: `${matchedCount} match file line hashes — strong evidence the prefix was copied from read output.`;\n\n\tthrow new Error(\n\t\t`[E_BARE_HASH_PREFIX] ${suspects.length} edit line(s) start with a hash-like prefix (${locations}). Example: ${JSON.stringify(exampleLine)}. ${linesHint} Remove the \"HASH│\" prefix from each affected content_lines entry; keep only the literal line content that appears after \"│\" in read output. Remember: hash_range_inclusive uses hash anchors, content_lines uses file content only.`,\n\t);\n}\n\nexport function descEdit(edit: RHEdit): string {\n\treturn `replace ${edit.hash_range_inclusive[0].hash}-${edit.hash_range_inclusive[1].hash}`;\n}\n\nfunction checkBoundaryDup(\n\tadjacentLine: string | undefined,\n\treplacementEdge: string | undefined,\n\tkind: BoundaryDuplicateKind,\n\tsurvivingLineIndex: number,\n\tfileLines: string[],\n\teditIndex: number,\n): BDupWarn | null {\n\tif (\n\t\tadjacentLine === undefined ||\n\t\treplacementEdge === undefined ||\n\t\treplacementEdge.length === 0 ||\n\t\treplacementEdge !== adjacentLine\n\t)\n\t\treturn null;\n\treturn {\n\t\tkind,\n\t\tsurvivingLineContent: adjacentLine,\n\t\tsurvivingLineIndex,\n\t\toccurrence: fileLines.slice(0, survivingLineIndex).filter((l) => l === adjacentLine).length,\n\t\treplacementLineContent: replacementEdge,\n\t\teditIndex,\n\t};\n}\n\nexport function valEdits(\n\tedits: HEdit[],\n\tfileLines: string[],\n\tfileHashes: string[],\n\t_warnings: string[],\n\tsignal: AbortSignal | undefined,\n): EditValidationResult {\n\tassertAligned(fileLines, fileHashes, \"valEdits\");\n\tconst resolved: RHEdit[] = [];\n\tconst mismatches: HMismatch[] = [];\n\tconst boundaryWarnings: BDupWarn[] = [];\n\n\tconst tryResolve = (ref: Anchor): RAnchor | undefined => {\n\t\tconst result = resAnchor(ref, fileLines, fileHashes);\n\t\tif (\"kind\" in result) {\n\t\t\tmismatches.push(result);\n\t\t\treturn undefined;\n\t\t}\n\t\treturn result;\n\t};\n\n\tfor (const edit of edits) {\n\t\tabortIf(signal);\n\t\tconst startResolved = tryResolve(edit.hash_range_inclusive[0]);\n\t\tconst endResolved = tryResolve(edit.hash_range_inclusive[1]);\n\t\tif (!startResolved || !endResolved) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (startResolved.line > endResolved.line) {\n\t\t\tthrow new Error(\n\t\t\t\t`[E_BAD_OP] Range start line ${startResolved.line} must be <= end line ${endResolved.line} (anchors ${edit.hash_range_inclusive[0].hash} and ${edit.hash_range_inclusive[1].hash}).`,\n\t\t\t);\n\t\t}\n\t\tconst endLine = endResolved.line;\n\t\tconst nextLine = fileLines[endLine];\n\t\tconst replacementLastLine = edit.content_lines.at(-1);\n\t\tconst trailing = checkBoundaryDup(nextLine, replacementLastLine, \"trailing\", endLine, fileLines, resolved.length);\n\t\tif (trailing) boundaryWarnings.push(trailing);\n\t\tconst prevLine = fileLines[startResolved.line - 2];\n\t\tconst replacementFirstLine = edit.content_lines[0];\n\t\tconst leading = checkBoundaryDup(\n\t\t\tprevLine,\n\t\t\treplacementFirstLine,\n\t\t\t\"leading\",\n\t\t\tstartResolved.line - 2,\n\t\t\tfileLines,\n\t\t\tresolved.length,\n\t\t);\n\t\tif (leading) boundaryWarnings.push(leading);\n\t\tresolved.push({\n\t\t\thash_range_inclusive: [startResolved, endResolved],\n\t\t\tcontent_lines: edit.content_lines,\n\t\t});\n\t}\n\n\treturn { resolved, mismatches, boundaryWarnings };\n}\n\nexport { warnUnicodeEsc };\n"]}

package/dist/core/tools/hashline/resolve.js

@@ -0,0 +1,187 @@
+import { rejectUnknownFields } from "../hashline-utils.js";
+import { abortIf } from "../runtime.js";
+import { HL_BARE_PREFIX_RE } from "./hash.js";
+import { parseHashRef, parseText } from "./parse.js";
+function resAnchor(ref, _fileLines, fileHashes) {
+    const hashMatches = [];
+    for (let i = 0; i < fileHashes.length; i++) {
+        if (fileHashes[i] === ref.hash)
+            hashMatches.push(i + 1);
+    }
+    if (hashMatches.length === 0) {
+        return { ref, kind: "not_found" };
+    }
+    if (hashMatches.length === 1) {
+        return {
+            line: hashMatches[0],
+            hash: ref.hash,
+            hashMatched: true,
+        };
+    }
+    return { ref, kind: "ambiguous", candidates: hashMatches };
+}
+function assertAligned(fileLines, fileHashes, ctx) {
+    if (fileHashes.length !== fileLines.length) {
+        throw new Error(`${ctx}: fileHashes.length (${fileHashes.length}) must match fileLines.length (${fileLines.length}).`);
+    }
+}
+function formatNotFoundMismatches(mismatches, filePath) {
+    const notFound = mismatches.filter((mismatch) => mismatch.kind === "not_found");
+    if (notFound.length === 0)
+        return undefined;
+    const references = notFound.map((mismatch) => `"${mismatch.ref.hash}"`).join(", ");
+    return `[E_STALE_ANCHOR] ${notFound.length} stale anchor${notFound.length > 1 ? "s" : ""}${filePath ? ` in ${filePath}` : ""}: ${references}. Call read() to get fresh anchors, then copy the 3-char HASH of the start and end of the range you are replacing into hash_range_inclusive of your next replace call.`;
+}
+function formatAmbiguousMismatchDetail(mismatch, fileLines, fileHashes) {
+    const sample = (mismatch.candidates ?? []).slice(0, 5);
+    const candidateCount = mismatch.candidates?.length ?? 0;
+    const more = candidateCount > sample.length ? `, ... (+${candidateCount - sample.length} more)` : "";
+    const lines = sample
+        .map((line) => {
+        const content = fileLines[line - 1] ?? "";
+        return `    ${line}: ${fileHashes[line - 1]}│${content}`;
+    })
+        .join("\n");
+    return `  Hash "${mismatch.ref.hash}" matches lines ${sample.join(", ")}${more}.\n${lines}`;
+}
+function formatAmbiguousMismatches(mismatches, fileLines, fileHashes, filePath) {
+    const ambiguous = mismatches.filter((mismatch) => mismatch.kind === "ambiguous");
+    if (ambiguous.length === 0)
+        return undefined;
+    const header = `[E_AMBIGUOUS_ANCHOR] ${ambiguous.length} ambiguous anchor${ambiguous.length > 1 ? "s" : ""}${filePath ? ` in ${filePath}` : ""}. Call read() to get fresh anchors, then copy the 3-char HASH of the start and end of the range you are replacing into hash_range_inclusive of your next replace call.`;
+    return [header, ...ambiguous.map((mismatch) => formatAmbiguousMismatchDetail(mismatch, fileLines, fileHashes))].join("\n");
+}
+export function fmtMismatch(mismatches, fileLines, fileHashes, filePath) {
+    assertAligned(fileLines, fileHashes, "fmtMismatch");
+    return [
+        formatNotFoundMismatches(mismatches, filePath),
+        formatAmbiguousMismatches(mismatches, fileLines, fileHashes, filePath),
+    ]
+        .filter((section) => section !== undefined)
+        .join("\n\n");
+}
+const ITEM_KS = new Set(["hash_range_inclusive", "content_lines"]);
+function isStrArr(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function isStrPair(value) {
+    return Array.isArray(value) && value.length === 2 && value.every((item) => typeof item === "string");
+}
+function assertItem(edit, index) {
+    rejectUnknownFields(edit, ITEM_KS, `Edit ${index}`, "Each edit takes only { hash_range_inclusive, content_lines }.");
+    if ("hash_range_inclusive" in edit && !isStrPair(edit.hash_range_inclusive)) {
+        throw new Error(`[E_BAD_SHAPE] Edit ${index} field "hash_range_inclusive" must be a pair of anchor strings [start, end].`);
+    }
+    if (!("content_lines" in edit)) {
+        throw new Error(`[E_BAD_SHAPE] Edit ${index} requires a "content_lines" field. Provide the replacement lines (use [] to delete).`);
+    }
+    if ("content_lines" in edit && !isStrArr(edit.content_lines)) {
+        throw new Error(`[E_BAD_SHAPE] Edit ${index} field "content_lines" must be a string array.`);
+    }
+    if (!isStrPair(edit.hash_range_inclusive)) {
+        throw new Error(`[E_BAD_SHAPE] Edit ${index} requires an "hash_range_inclusive" pair of anchor strings [start, end].`);
+    }
+}
+export function resEdits(edits) {
+    const result = [];
+    for (const [index, edit] of edits.entries()) {
+        assertItem(edit, index);
+        const replaceLines = parseText(edit.content_lines);
+        result.push({
+            hash_range_inclusive: [parseHashRef(edit.hash_range_inclusive[0]), parseHashRef(edit.hash_range_inclusive[1])],
+            content_lines: replaceLines,
+        });
+    }
+    return result;
+}
+function warnUnicodeEsc(edits, warnings) {
+    for (const edit of edits) {
+        if (edit.content_lines.some((line) => /\\uDDDD/i.test(line))) {
+            warnings.push("Detected literal \\uDDDD in edit content; no autocorrection applied. Verify whether this should be a real Unicode escape or plain text.");
+        }
+    }
+}
+export function assertNoBarePrefix(edits, _fileLines, fileHashes) {
+    const suspects = [];
+    for (let editIndex = 0; editIndex < edits.length; editIndex++) {
+        const edit = edits[editIndex];
+        for (let lineIndex = 0; lineIndex < edit.content_lines.length; lineIndex++) {
+            const line = edit.content_lines[lineIndex];
+            const match = line.match(HL_BARE_PREFIX_RE);
+            if (match)
+                suspects.push({ line, hash: match[1], editIndex, lineIndex });
+        }
+    }
+    if (suspects.length === 0)
+        return;
+    const locations = suspects.map((s) => `edit ${s.editIndex}, content_lines[${s.lineIndex}]`).join("; ");
+    const fileHashSet = new Set(fileHashes);
+    const matched = suspects.filter((s) => fileHashSet.has(s.hash));
+    const matchedCount = matched.length;
+    const exampleLine = `${suspects[0].hash}│${suspects[0].line}`;
+    const linesHint = matchedCount === 0
+        ? `None match file line hashes.`
+        : `${matchedCount} match file line hashes — strong evidence the prefix was copied from read output.`;
+    throw new Error(`[E_BARE_HASH_PREFIX] ${suspects.length} edit line(s) start with a hash-like prefix (${locations}). Example: ${JSON.stringify(exampleLine)}. ${linesHint} Remove the "HASH│" prefix from each affected content_lines entry; keep only the literal line content that appears after "│" in read output. Remember: hash_range_inclusive uses hash anchors, content_lines uses file content only.`);
+}
+export function descEdit(edit) {
+    return `replace ${edit.hash_range_inclusive[0].hash}-${edit.hash_range_inclusive[1].hash}`;
+}
+function checkBoundaryDup(adjacentLine, replacementEdge, kind, survivingLineIndex, fileLines, editIndex) {
+    if (adjacentLine === undefined ||
+        replacementEdge === undefined ||
+        replacementEdge.length === 0 ||
+        replacementEdge !== adjacentLine)
+        return null;
+    return {
+        kind,
+        survivingLineContent: adjacentLine,
+        survivingLineIndex,
+        occurrence: fileLines.slice(0, survivingLineIndex).filter((l) => l === adjacentLine).length,
+        replacementLineContent: replacementEdge,
+        editIndex,
+    };
+}
+export function valEdits(edits, fileLines, fileHashes, _warnings, signal) {
+    assertAligned(fileLines, fileHashes, "valEdits");
+    const resolved = [];
+    const mismatches = [];
+    const boundaryWarnings = [];
+    const tryResolve = (ref) => {
+        const result = resAnchor(ref, fileLines, fileHashes);
+        if ("kind" in result) {
+            mismatches.push(result);
+            return undefined;
+        }
+        return result;
+    };
+    for (const edit of edits) {
+        abortIf(signal);
+        const startResolved = tryResolve(edit.hash_range_inclusive[0]);
+        const endResolved = tryResolve(edit.hash_range_inclusive[1]);
+        if (!startResolved || !endResolved) {
+            continue;
+        }
+        if (startResolved.line > endResolved.line) {
+            throw new Error(`[E_BAD_OP] Range start line ${startResolved.line} must be <= end line ${endResolved.line} (anchors ${edit.hash_range_inclusive[0].hash} and ${edit.hash_range_inclusive[1].hash}).`);
+        }
+        const endLine = endResolved.line;
+        const nextLine = fileLines[endLine];
+        const replacementLastLine = edit.content_lines.at(-1);
+        const trailing = checkBoundaryDup(nextLine, replacementLastLine, "trailing", endLine, fileLines, resolved.length);
+        if (trailing)
+            boundaryWarnings.push(trailing);
+        const prevLine = fileLines[startResolved.line - 2];
+        const replacementFirstLine = edit.content_lines[0];
+        const leading = checkBoundaryDup(prevLine, replacementFirstLine, "leading", startResolved.line - 2, fileLines, resolved.length);
+        if (leading)
+            boundaryWarnings.push(leading);
+        resolved.push({
+            hash_range_inclusive: [startResolved, endResolved],
+            content_lines: edit.content_lines,
+        });
+    }
+    return { resolved, mismatches, boundaryWarnings };
+}
+export { warnUnicodeEsc };
+//# sourceMappingURL=resolve.js.map

package/dist/core/tools/hashline/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../../src/core/tools/hashline/resolve.ts"],"names":[],"mappings":"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","sourcesContent":["import { rejectUnknownFields } from \"../hashline-utils.ts\";\nimport { abortIf } from \"../runtime.ts\";\nimport { HL_BARE_PREFIX_RE } from \"./hash.ts\";\nimport { type Anchor, parseHashRef, parseText } from \"./parse.ts\";\n\nexport type RAnchor = {\n\tline: number;\n\thash: string;\n\thashMatched: boolean;\n};\n\nexport type HEdit = { hash_range_inclusive: [Anchor, Anchor]; content_lines: string[] };\nexport type RHEdit = {\n\thash_range_inclusive: [RAnchor, RAnchor];\n\tcontent_lines: string[];\n};\n\ntype HashAnchorMismatchKind = \"not_found\" | \"ambiguous\";\nexport type BoundaryDuplicateKind = \"trailing\" | \"leading\";\n\ninterface HMismatch {\n\tref: Anchor;\n\tkind: HashAnchorMismatchKind;\n\tcandidates?: number[];\n}\n\nexport interface BDupWarn {\n\tkind: BoundaryDuplicateKind;\n\tsurvivingLineContent: string;\n\tsurvivingLineIndex: number;\n\toccurrence: number;\n\treplacementLineContent: string;\n\teditIndex: number;\n}\ninterface EditValidationResult {\n\tresolved: RHEdit[];\n\tmismatches: HMismatch[];\n\tboundaryWarnings: BDupWarn[];\n}\n\nexport interface NEdit {\n\teditIndex: number;\n\tloc: string;\n\tcurrentContent: string;\n}\n\nexport type HTEdit = {\n\thash_range_inclusive: [string, string];\n\tcontent_lines: string[];\n};\n\nfunction resAnchor(ref: Anchor, _fileLines: string[], fileHashes: string[]): RAnchor | HMismatch {\n\tconst hashMatches: number[] = [];\n\tfor (let i = 0; i < fileHashes.length; i++) {\n\t\tif (fileHashes[i] === ref.hash) hashMatches.push(i + 1);\n\t}\n\tif (hashMatches.length === 0) {\n\t\treturn { ref, kind: \"not_found\" };\n\t}\n\tif (hashMatches.length === 1) {\n\t\treturn {\n\t\t\tline: hashMatches[0]!,\n\t\t\thash: ref.hash,\n\t\t\thashMatched: true,\n\t\t};\n\t}\n\treturn { ref, kind: \"ambiguous\", candidates: hashMatches };\n}\n\nfunction assertAligned(fileLines: string[], fileHashes: string[], ctx: string): void {\n\tif (fileHashes.length !== fileLines.length) {\n\t\tthrow new Error(\n\t\t\t`${ctx}: fileHashes.length (${fileHashes.length}) must match fileLines.length (${fileLines.length}).`,\n\t\t);\n\t}\n}\n\nfunction formatNotFoundMismatches(mismatches: HMismatch[], filePath: string | undefined): string | undefined {\n\tconst notFound = mismatches.filter((mismatch) => mismatch.kind === \"not_found\");\n\tif (notFound.length === 0) return undefined;\n\tconst references = notFound.map((mismatch) => `\"${mismatch.ref.hash}\"`).join(\", \");\n\treturn `[E_STALE_ANCHOR] ${notFound.length} stale anchor${notFound.length > 1 ? \"s\" : \"\"}${filePath ? ` in ${filePath}` : \"\"}: ${references}. Call read() to get fresh anchors, then copy the 3-char HASH of the start and end of the range you are replacing into hash_range_inclusive of your next replace call.`;\n}\n\nfunction formatAmbiguousMismatchDetail(mismatch: HMismatch, fileLines: string[], fileHashes: string[]): string {\n\tconst sample = (mismatch.candidates ?? []).slice(0, 5);\n\tconst candidateCount = mismatch.candidates?.length ?? 0;\n\tconst more = candidateCount > sample.length ? `, ... (+${candidateCount - sample.length} more)` : \"\";\n\tconst lines = sample\n\t\t.map((line) => {\n\t\t\tconst content = fileLines[line - 1] ?? \"\";\n\t\t\treturn `    ${line}: ${fileHashes[line - 1]}│${content}`;\n\t\t})\n\t\t.join(\"\\n\");\n\treturn `  Hash \"${mismatch.ref.hash}\" matches lines ${sample.join(\", \")}${more}.\\n${lines}`;\n}\n\nfunction formatAmbiguousMismatches(\n\tmismatches: HMismatch[],\n\tfileLines: string[],\n\tfileHashes: string[],\n\tfilePath: string | undefined,\n): string | undefined {\n\tconst ambiguous = mismatches.filter((mismatch) => mismatch.kind === \"ambiguous\");\n\tif (ambiguous.length === 0) return undefined;\n\tconst header = `[E_AMBIGUOUS_ANCHOR] ${ambiguous.length} ambiguous anchor${ambiguous.length > 1 ? \"s\" : \"\"}${filePath ? ` in ${filePath}` : \"\"}. Call read() to get fresh anchors, then copy the 3-char HASH of the start and end of the range you are replacing into hash_range_inclusive of your next replace call.`;\n\treturn [header, ...ambiguous.map((mismatch) => formatAmbiguousMismatchDetail(mismatch, fileLines, fileHashes))].join(\n\t\t\"\\n\",\n\t);\n}\n\nexport function fmtMismatch(\n\tmismatches: HMismatch[],\n\tfileLines: string[],\n\tfileHashes: string[],\n\tfilePath?: string,\n): string {\n\tassertAligned(fileLines, fileHashes, \"fmtMismatch\");\n\treturn [\n\t\tformatNotFoundMismatches(mismatches, filePath),\n\t\tformatAmbiguousMismatches(mismatches, fileLines, fileHashes, filePath),\n\t]\n\t\t.filter((section): section is string => section !== undefined)\n\t\t.join(\"\\n\\n\");\n}\n\nconst ITEM_KS = new Set([\"hash_range_inclusive\", \"content_lines\"]);\n\nfunction isStrArr(value: unknown): value is string[] {\n\treturn Array.isArray(value) && value.every((item) => typeof item === \"string\");\n}\n\nfunction isStrPair(value: unknown): value is [string, string] {\n\treturn Array.isArray(value) && value.length === 2 && value.every((item) => typeof item === \"string\");\n}\n\nfunction assertItem(edit: Record<string, unknown>, index: number): void {\n\trejectUnknownFields(edit, ITEM_KS, `Edit ${index}`, \"Each edit takes only { hash_range_inclusive, content_lines }.\");\n\n\tif (\"hash_range_inclusive\" in edit && !isStrPair(edit.hash_range_inclusive)) {\n\t\tthrow new Error(\n\t\t\t`[E_BAD_SHAPE] Edit ${index} field \"hash_range_inclusive\" must be a pair of anchor strings [start, end].`,\n\t\t);\n\t}\n\tif (!(\"content_lines\" in edit)) {\n\t\tthrow new Error(\n\t\t\t`[E_BAD_SHAPE] Edit ${index} requires a \"content_lines\" field. Provide the replacement lines (use [] to delete).`,\n\t\t);\n\t}\n\tif (\"content_lines\" in edit && !isStrArr(edit.content_lines)) {\n\t\tthrow new Error(`[E_BAD_SHAPE] Edit ${index} field \"content_lines\" must be a string array.`);\n\t}\n\tif (!isStrPair(edit.hash_range_inclusive)) {\n\t\tthrow new Error(\n\t\t\t`[E_BAD_SHAPE] Edit ${index} requires an \"hash_range_inclusive\" pair of anchor strings [start, end].`,\n\t\t);\n\t}\n}\n\nexport function resEdits(edits: HTEdit[]): HEdit[] {\n\tconst result: HEdit[] = [];\n\tfor (const [index, edit] of edits.entries()) {\n\t\tassertItem(edit as Record<string, unknown>, index);\n\n\t\tconst replaceLines = parseText(edit.content_lines);\n\t\tresult.push({\n\t\t\thash_range_inclusive: [parseHashRef(edit.hash_range_inclusive[0]), parseHashRef(edit.hash_range_inclusive[1])],\n\t\t\tcontent_lines: replaceLines,\n\t\t});\n\t}\n\treturn result;\n}\n\nfunction warnUnicodeEsc(edits: HEdit[], warnings: string[]): void {\n\tfor (const edit of edits) {\n\t\tif (edit.content_lines.some((line) => /\\\\uDDDD/i.test(line))) {\n\t\t\twarnings.push(\n\t\t\t\t\"Detected literal \\\\uDDDD in edit content; no autocorrection applied. Verify whether this should be a real Unicode escape or plain text.\",\n\t\t\t);\n\t\t}\n\t}\n}\n\nexport function assertNoBarePrefix(edits: HEdit[], _fileLines: string[], fileHashes: string[]): void {\n\tconst suspects: { line: string; hash: string; editIndex: number; lineIndex: number }[] = [];\n\tfor (let editIndex = 0; editIndex < edits.length; editIndex++) {\n\t\tconst edit = edits[editIndex]!;\n\t\tfor (let lineIndex = 0; lineIndex < edit.content_lines.length; lineIndex++) {\n\t\t\tconst line = edit.content_lines[lineIndex]!;\n\t\t\tconst match = line.match(HL_BARE_PREFIX_RE);\n\t\t\tif (match) suspects.push({ line, hash: match[1]!, editIndex, lineIndex });\n\t\t}\n\t}\n\tif (suspects.length === 0) return;\n\tconst locations = suspects.map((s) => `edit ${s.editIndex}, content_lines[${s.lineIndex}]`).join(\"; \");\n\n\tconst fileHashSet = new Set(fileHashes);\n\tconst matched = suspects.filter((s) => fileHashSet.has(s.hash));\n\tconst matchedCount = matched.length;\n\n\tconst exampleLine = `${suspects[0]!.hash}│${suspects[0]!.line}`;\n\n\tconst linesHint =\n\t\tmatchedCount === 0\n\t\t\t? `None match file line hashes.`\n\t\t\t: `${matchedCount} match file line hashes — strong evidence the prefix was copied from read output.`;\n\n\tthrow new Error(\n\t\t`[E_BARE_HASH_PREFIX] ${suspects.length} edit line(s) start with a hash-like prefix (${locations}). Example: ${JSON.stringify(exampleLine)}. ${linesHint} Remove the \"HASH│\" prefix from each affected content_lines entry; keep only the literal line content that appears after \"│\" in read output. Remember: hash_range_inclusive uses hash anchors, content_lines uses file content only.`,\n\t);\n}\n\nexport function descEdit(edit: RHEdit): string {\n\treturn `replace ${edit.hash_range_inclusive[0].hash}-${edit.hash_range_inclusive[1].hash}`;\n}\n\nfunction checkBoundaryDup(\n\tadjacentLine: string | undefined,\n\treplacementEdge: string | undefined,\n\tkind: BoundaryDuplicateKind,\n\tsurvivingLineIndex: number,\n\tfileLines: string[],\n\teditIndex: number,\n): BDupWarn | null {\n\tif (\n\t\tadjacentLine === undefined ||\n\t\treplacementEdge === undefined ||\n\t\treplacementEdge.length === 0 ||\n\t\treplacementEdge !== adjacentLine\n\t)\n\t\treturn null;\n\treturn {\n\t\tkind,\n\t\tsurvivingLineContent: adjacentLine,\n\t\tsurvivingLineIndex,\n\t\toccurrence: fileLines.slice(0, survivingLineIndex).filter((l) => l === adjacentLine).length,\n\t\treplacementLineContent: replacementEdge,\n\t\teditIndex,\n\t};\n}\n\nexport function valEdits(\n\tedits: HEdit[],\n\tfileLines: string[],\n\tfileHashes: string[],\n\t_warnings: string[],\n\tsignal: AbortSignal | undefined,\n): EditValidationResult {\n\tassertAligned(fileLines, fileHashes, \"valEdits\");\n\tconst resolved: RHEdit[] = [];\n\tconst mismatches: HMismatch[] = [];\n\tconst boundaryWarnings: BDupWarn[] = [];\n\n\tconst tryResolve = (ref: Anchor): RAnchor | undefined => {\n\t\tconst result = resAnchor(ref, fileLines, fileHashes);\n\t\tif (\"kind\" in result) {\n\t\t\tmismatches.push(result);\n\t\t\treturn undefined;\n\t\t}\n\t\treturn result;\n\t};\n\n\tfor (const edit of edits) {\n\t\tabortIf(signal);\n\t\tconst startResolved = tryResolve(edit.hash_range_inclusive[0]);\n\t\tconst endResolved = tryResolve(edit.hash_range_inclusive[1]);\n\t\tif (!startResolved || !endResolved) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (startResolved.line > endResolved.line) {\n\t\t\tthrow new Error(\n\t\t\t\t`[E_BAD_OP] Range start line ${startResolved.line} must be <= end line ${endResolved.line} (anchors ${edit.hash_range_inclusive[0].hash} and ${edit.hash_range_inclusive[1].hash}).`,\n\t\t\t);\n\t\t}\n\t\tconst endLine = endResolved.line;\n\t\tconst nextLine = fileLines[endLine];\n\t\tconst replacementLastLine = edit.content_lines.at(-1);\n\t\tconst trailing = checkBoundaryDup(nextLine, replacementLastLine, \"trailing\", endLine, fileLines, resolved.length);\n\t\tif (trailing) boundaryWarnings.push(trailing);\n\t\tconst prevLine = fileLines[startResolved.line - 2];\n\t\tconst replacementFirstLine = edit.content_lines[0];\n\t\tconst leading = checkBoundaryDup(\n\t\t\tprevLine,\n\t\t\treplacementFirstLine,\n\t\t\t\"leading\",\n\t\t\tstartResolved.line - 2,\n\t\t\tfileLines,\n\t\t\tresolved.length,\n\t\t);\n\t\tif (leading) boundaryWarnings.push(leading);\n\t\tresolved.push({\n\t\t\thash_range_inclusive: [startResolved, endResolved],\n\t\t\tcontent_lines: edit.content_lines,\n\t\t});\n\t}\n\n\treturn { resolved, mismatches, boundaryWarnings };\n}\n\nexport { warnUnicodeEsc };\n"]}

package/dist/core/tools/hashline-utils.d.ts

@@ -0,0 +1,6 @@
+export declare function isRec(value: unknown): value is Record<string, unknown>;
+export declare function has(record: Record<string, unknown>, key: string): boolean;
+export declare function visLines(text: string): string[];
+export declare function cntLines(text: string): number;
+export declare function rejectUnknownFields(obj: Record<string, unknown>, allowed: Set<string>, label: string, hint?: string): void;
+//# sourceMappingURL=hashline-utils.d.ts.map

package/dist/core/tools/hashline-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashline-utils.d.ts","sourceRoot":"","sources":["../../../src/core/tools/hashline-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtE;AAED,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAI/C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACX,IAAI,CAMN","sourcesContent":["export function isRec(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function has(record: Record<string, unknown>, key: string): boolean {\n\treturn Object.hasOwn(record, key);\n}\n\nexport function visLines(text: string): string[] {\n\tif (text.length === 0) return [];\n\tconst lines = text.split(\"\\n\");\n\treturn text.endsWith(\"\\n\") ? lines.slice(0, -1) : lines;\n}\n\nexport function cntLines(text: string): number {\n\treturn visLines(text).length;\n}\n\nexport function rejectUnknownFields(\n\tobj: Record<string, unknown>,\n\tallowed: Set<string>,\n\tlabel: string,\n\thint?: string,\n): void {\n\tconst unknown = Object.keys(obj).filter((key) => !allowed.has(key));\n\tif (unknown.length > 0) {\n\t\tconst suffix = hint ? ` ${hint}` : \"\";\n\t\tthrow new Error(`[E_BAD_SHAPE] ${label} contains unknown or unsupported fields: ${unknown.join(\", \")}.${suffix}`);\n\t}\n}\n"]}

package/dist/core/tools/hashline-utils.js

@@ -0,0 +1,23 @@
+export function isRec(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function has(record, key) {
+    return Object.hasOwn(record, key);
+}
+export function visLines(text) {
+    if (text.length === 0)
+        return [];
+    const lines = text.split("\n");
+    return text.endsWith("\n") ? lines.slice(0, -1) : lines;
+}
+export function cntLines(text) {
+    return visLines(text).length;
+}
+export function rejectUnknownFields(obj, allowed, label, hint) {
+    const unknown = Object.keys(obj).filter((key) => !allowed.has(key));
+    if (unknown.length > 0) {
+        const suffix = hint ? ` ${hint}` : "";
+        throw new Error(`[E_BAD_SHAPE] ${label} contains unknown or unsupported fields: ${unknown.join(", ")}.${suffix}`);
+    }
+}
+//# sourceMappingURL=hashline-utils.js.map

package/dist/core/tools/hashline-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashline-utils.js","sourceRoot":"","sources":["../../../src/core/tools/hashline-utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAC,KAAc,EAAoC;IACvE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAAA,CAC5E;AAED,MAAM,UAAU,GAAG,CAAC,MAA+B,EAAE,GAAW,EAAW;IAC1E,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAAA,CAClC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAY;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAAA,CACxD;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAU;IAC9C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AAAA,CAC7B;AAED,MAAM,UAAU,mBAAmB,CAClC,GAA4B,EAC5B,OAAoB,EACpB,KAAa,EACb,IAAa,EACN;IACP,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,4CAA4C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IACnH,CAAC;AAAA,CACD","sourcesContent":["export function isRec(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function has(record: Record<string, unknown>, key: string): boolean {\n\treturn Object.hasOwn(record, key);\n}\n\nexport function visLines(text: string): string[] {\n\tif (text.length === 0) return [];\n\tconst lines = text.split(\"\\n\");\n\treturn text.endsWith(\"\\n\") ? lines.slice(0, -1) : lines;\n}\n\nexport function cntLines(text: string): number {\n\treturn visLines(text).length;\n}\n\nexport function rejectUnknownFields(\n\tobj: Record<string, unknown>,\n\tallowed: Set<string>,\n\tlabel: string,\n\thint?: string,\n): void {\n\tconst unknown = Object.keys(obj).filter((key) => !allowed.has(key));\n\tif (unknown.length > 0) {\n\t\tconst suffix = hint ? ` ${hint}` : \"\";\n\t\tthrow new Error(`[E_BAD_SHAPE] ${label} contains unknown or unsupported fields: ${unknown.join(\", \")}.${suffix}`);\n\t}\n}\n"]}

package/dist/core/tools/index.d.ts

@@ -0,0 +1,36 @@
+import type { AgentTool } from "@greppleai/grip-agent-core";
+import type { ToolDefinition } from "../extensions/types.ts";
+import { type BashToolOptions } from "./bash.ts";
+import { type EditToolOptions } from "./edit.ts";
+import { type FindToolOptions } from "./find.ts";
+import { type GrepToolOptions } from "./grep.ts";
+import { type LsToolOptions } from "./ls.ts";
+import type { ToolOperations } from "./operations.ts";
+import { type ReadToolOptions } from "./read.ts";
+import { type SubagentToolOptions } from "./subagent.ts";
+import { type WebsearchToolOptions } from "./websearch.ts";
+import { type WriteToolOptions } from "./write.ts";
+export type Tool = AgentTool<any>;
+export type ToolDef = ToolDefinition<any, any>;
+export type ToolName = "read" | "bash" | "edit" | "write" | "grep" | "find" | "ls" | "subagent" | "subagent_runs" | "create_subagent" | "websearch";
+export declare const allToolNames: Set<ToolName>;
+export interface ToolsOptions {
+    read?: ReadToolOptions;
+    bash?: BashToolOptions;
+    write?: WriteToolOptions;
+    edit?: EditToolOptions;
+    grep?: GrepToolOptions;
+    find?: FindToolOptions;
+    ls?: LsToolOptions;
+    subagent?: SubagentToolOptions;
+    websearch?: WebsearchToolOptions;
+}
+export declare function createToolDefinition(toolName: ToolName, operations: ToolOperations, options?: ToolsOptions): ToolDef;
+export declare function createTool(toolName: ToolName, operations: ToolOperations, options?: ToolsOptions): Tool;
+export declare function createCodingToolDefinitions(operations: ToolOperations, options?: ToolsOptions): ToolDef[];
+export declare function createReadOnlyToolDefinitions(operations: ToolOperations, options?: ToolsOptions): ToolDef[];
+export declare function createAllToolDefinitions(operations: ToolOperations, options?: ToolsOptions): Record<ToolName, ToolDef>;
+export declare function createCodingTools(operations: ToolOperations, options?: ToolsOptions): Tool[];
+export declare function createReadOnlyTools(operations: ToolOperations, options?: ToolsOptions): Tool[];
+export declare function createAllTools(operations: ToolOperations, options?: ToolsOptions): Record<ToolName, Tool>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,KAAK,eAAe,EAA4C,MAAM,WAAW,CAAC;AAC3F,OAAO,EAA4C,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EAA4C,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EAA4C,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAA4C,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EAON,KAAK,mBAAmB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAsD,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC/G,OAAO,EAA8C,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE/F,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;AAClC,MAAM,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC/C,MAAM,MAAM,QAAQ,GACjB,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,GACN,IAAI,GACJ,UAAU,GACV,eAAe,GACf,iBAAiB,GACjB,WAAW,CAAC;AACf,eAAO,MAAM,YAAY,EAAE,GAAG,CAAC,QAAQ,CAYrC,CAAC;AAEH,MAAM,WAAW,YAAY;IAC5B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,EAAE,CAAC,EAAE,aAAa,CAAC;IACnB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,SAAS,CAAC,EAAE,oBAAoB,CAAC;CACjC;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CA2BpH;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CA2BvG;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,EAAE,CAOzG;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,EAAE,CAO3G;AAED,wBAAgB,wBAAwB,CACvC,UAAU,EAAE,cAAc,EAC1B,OAAO,CAAC,EAAE,YAAY,GACpB,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAc3B;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,EAAE,CAO5F;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,EAAE,CAO9F;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAczG","sourcesContent":["import type { AgentTool } from \"@greppleai/grip-agent-core\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport { type BashToolOptions, createBashTool, createBashToolDefinition } from \"./bash.ts\";\nimport { createEditTool, createEditToolDefinition, type EditToolOptions } from \"./edit.ts\";\nimport { createFindTool, createFindToolDefinition, type FindToolOptions } from \"./find.ts\";\nimport { createGrepTool, createGrepToolDefinition, type GrepToolOptions } from \"./grep.ts\";\nimport { createLsTool, createLsToolDefinition, type LsToolOptions } from \"./ls.ts\";\nimport type { ToolOperations } from \"./operations.ts\";\nimport { createReadTool, createReadToolDefinition, type ReadToolOptions } from \"./read.ts\";\nimport {\n\tcreateCreateSubagentTool,\n\tcreateCreateSubagentToolDefinition,\n\tcreateSubagentRunsTool,\n\tcreateSubagentRunsToolDefinition,\n\tcreateSubagentTool,\n\tcreateSubagentToolDefinition,\n\ttype SubagentToolOptions,\n} from \"./subagent.ts\";\nimport { createWebsearchTool, createWebsearchToolDefinition, type WebsearchToolOptions } from \"./websearch.ts\";\nimport { createWriteTool, createWriteToolDefinition, type WriteToolOptions } from \"./write.ts\";\n\nexport type Tool = AgentTool<any>;\nexport type ToolDef = ToolDefinition<any, any>;\nexport type ToolName =\n\t| \"read\"\n\t| \"bash\"\n\t| \"edit\"\n\t| \"write\"\n\t| \"grep\"\n\t| \"find\"\n\t| \"ls\"\n\t| \"subagent\"\n\t| \"subagent_runs\"\n\t| \"create_subagent\"\n\t| \"websearch\";\nexport const allToolNames: Set<ToolName> = new Set([\n\t\"read\",\n\t\"bash\",\n\t\"edit\",\n\t\"write\",\n\t\"grep\",\n\t\"find\",\n\t\"ls\",\n\t\"subagent\",\n\t\"subagent_runs\",\n\t\"create_subagent\",\n\t\"websearch\",\n]);\n\nexport interface ToolsOptions {\n\tread?: ReadToolOptions;\n\tbash?: BashToolOptions;\n\twrite?: WriteToolOptions;\n\tedit?: EditToolOptions;\n\tgrep?: GrepToolOptions;\n\tfind?: FindToolOptions;\n\tls?: LsToolOptions;\n\tsubagent?: SubagentToolOptions;\n\twebsearch?: WebsearchToolOptions;\n}\n\nexport function createToolDefinition(toolName: ToolName, operations: ToolOperations, options?: ToolsOptions): ToolDef {\n\tswitch (toolName) {\n\t\tcase \"read\":\n\t\t\treturn createReadToolDefinition(operations, options?.read);\n\t\tcase \"bash\":\n\t\t\treturn createBashToolDefinition(operations, options?.bash);\n\t\tcase \"edit\":\n\t\t\treturn createEditToolDefinition(operations, options?.edit);\n\t\tcase \"write\":\n\t\t\treturn createWriteToolDefinition(operations, options?.write);\n\t\tcase \"grep\":\n\t\t\treturn createGrepToolDefinition(operations, options?.grep);\n\t\tcase \"find\":\n\t\t\treturn createFindToolDefinition(operations, options?.find);\n\t\tcase \"ls\":\n\t\t\treturn createLsToolDefinition(operations, options?.ls);\n\t\tcase \"subagent\":\n\t\t\treturn createSubagentToolDefinition(options?.subagent);\n\t\tcase \"subagent_runs\":\n\t\t\treturn createSubagentRunsToolDefinition(options?.subagent?.runRegistry);\n\t\tcase \"create_subagent\":\n\t\t\treturn createCreateSubagentToolDefinition(options?.subagent?.configRegistry);\n\t\tcase \"websearch\":\n\t\t\treturn createWebsearchToolDefinition(options?.websearch);\n\t\tdefault:\n\t\t\tthrow new Error(`Unknown tool name: ${toolName}`);\n\t}\n}\n\nexport function createTool(toolName: ToolName, operations: ToolOperations, options?: ToolsOptions): Tool {\n\tswitch (toolName) {\n\t\tcase \"read\":\n\t\t\treturn createReadTool(operations, options?.read);\n\t\tcase \"bash\":\n\t\t\treturn createBashTool(operations, options?.bash);\n\t\tcase \"edit\":\n\t\t\treturn createEditTool(operations, options?.edit);\n\t\tcase \"write\":\n\t\t\treturn createWriteTool(operations, options?.write);\n\t\tcase \"grep\":\n\t\t\treturn createGrepTool(operations, options?.grep);\n\t\tcase \"find\":\n\t\t\treturn createFindTool(operations, options?.find);\n\t\tcase \"ls\":\n\t\t\treturn createLsTool(operations, options?.ls);\n\t\tcase \"subagent\":\n\t\t\treturn createSubagentTool(options?.subagent);\n\t\tcase \"subagent_runs\":\n\t\t\treturn createSubagentRunsTool(options?.subagent?.runRegistry);\n\t\tcase \"create_subagent\":\n\t\t\treturn createCreateSubagentTool(options?.subagent?.configRegistry);\n\t\tcase \"websearch\":\n\t\t\treturn createWebsearchTool(options?.websearch);\n\t\tdefault:\n\t\t\tthrow new Error(`Unknown tool name: ${toolName}`);\n\t}\n}\n\nexport function createCodingToolDefinitions(operations: ToolOperations, options?: ToolsOptions): ToolDef[] {\n\treturn [\n\t\tcreateReadToolDefinition(operations, options?.read),\n\t\tcreateBashToolDefinition(operations, options?.bash),\n\t\tcreateEditToolDefinition(operations, options?.edit),\n\t\tcreateWriteToolDefinition(operations, options?.write),\n\t];\n}\n\nexport function createReadOnlyToolDefinitions(operations: ToolOperations, options?: ToolsOptions): ToolDef[] {\n\treturn [\n\t\tcreateReadToolDefinition(operations, options?.read),\n\t\tcreateGrepToolDefinition(operations, options?.grep),\n\t\tcreateFindToolDefinition(operations, options?.find),\n\t\tcreateLsToolDefinition(operations, options?.ls),\n\t];\n}\n\nexport function createAllToolDefinitions(\n\toperations: ToolOperations,\n\toptions?: ToolsOptions,\n): Record<ToolName, ToolDef> {\n\treturn {\n\t\tread: createReadToolDefinition(operations, options?.read),\n\t\tbash: createBashToolDefinition(operations, options?.bash),\n\t\tedit: createEditToolDefinition(operations, options?.edit),\n\t\twrite: createWriteToolDefinition(operations, options?.write),\n\t\tgrep: createGrepToolDefinition(operations, options?.grep),\n\t\tfind: createFindToolDefinition(operations, options?.find),\n\t\tls: createLsToolDefinition(operations, options?.ls),\n\t\tsubagent: createSubagentToolDefinition(options?.subagent),\n\t\tsubagent_runs: createSubagentRunsToolDefinition(options?.subagent?.runRegistry),\n\t\tcreate_subagent: createCreateSubagentToolDefinition(options?.subagent?.configRegistry),\n\t\twebsearch: createWebsearchToolDefinition(options?.websearch),\n\t};\n}\n\nexport function createCodingTools(operations: ToolOperations, options?: ToolsOptions): Tool[] {\n\treturn [\n\t\tcreateReadTool(operations, options?.read),\n\t\tcreateBashTool(operations, options?.bash),\n\t\tcreateEditTool(operations, options?.edit),\n\t\tcreateWriteTool(operations, options?.write),\n\t];\n}\n\nexport function createReadOnlyTools(operations: ToolOperations, options?: ToolsOptions): Tool[] {\n\treturn [\n\t\tcreateReadTool(operations, options?.read),\n\t\tcreateGrepTool(operations, options?.grep),\n\t\tcreateFindTool(operations, options?.find),\n\t\tcreateLsTool(operations, options?.ls),\n\t];\n}\n\nexport function createAllTools(operations: ToolOperations, options?: ToolsOptions): Record<ToolName, Tool> {\n\treturn {\n\t\tread: createReadTool(operations, options?.read),\n\t\tbash: createBashTool(operations, options?.bash),\n\t\tedit: createEditTool(operations, options?.edit),\n\t\twrite: createWriteTool(operations, options?.write),\n\t\tgrep: createGrepTool(operations, options?.grep),\n\t\tfind: createFindTool(operations, options?.find),\n\t\tls: createLsTool(operations, options?.ls),\n\t\tsubagent: createSubagentTool(options?.subagent),\n\t\tsubagent_runs: createSubagentRunsTool(options?.subagent?.runRegistry),\n\t\tcreate_subagent: createCreateSubagentTool(options?.subagent?.configRegistry),\n\t\twebsearch: createWebsearchTool(options?.websearch),\n\t};\n}\n"]}

package/dist/core/tools/index.js

@@ -0,0 +1,141 @@
+import { createBashTool, createBashToolDefinition } from "./bash.js";
+import { createEditTool, createEditToolDefinition } from "./edit.js";
+import { createFindTool, createFindToolDefinition } from "./find.js";
+import { createGrepTool, createGrepToolDefinition } from "./grep.js";
+import { createLsTool, createLsToolDefinition } from "./ls.js";
+import { createReadTool, createReadToolDefinition } from "./read.js";
+import { createCreateSubagentTool, createCreateSubagentToolDefinition, createSubagentRunsTool, createSubagentRunsToolDefinition, createSubagentTool, createSubagentToolDefinition, } from "./subagent.js";
+import { createWebsearchTool, createWebsearchToolDefinition } from "./websearch.js";
+import { createWriteTool, createWriteToolDefinition } from "./write.js";
+export const allToolNames = new Set([
+    "read",
+    "bash",
+    "edit",
+    "write",
+    "grep",
+    "find",
+    "ls",
+    "subagent",
+    "subagent_runs",
+    "create_subagent",
+    "websearch",
+]);
+export function createToolDefinition(toolName, operations, options) {
+    switch (toolName) {
+        case "read":
+            return createReadToolDefinition(operations, options?.read);
+        case "bash":
+            return createBashToolDefinition(operations, options?.bash);
+        case "edit":
+            return createEditToolDefinition(operations, options?.edit);
+        case "write":
+            return createWriteToolDefinition(operations, options?.write);
+        case "grep":
+            return createGrepToolDefinition(operations, options?.grep);
+        case "find":
+            return createFindToolDefinition(operations, options?.find);
+        case "ls":
+            return createLsToolDefinition(operations, options?.ls);
+        case "subagent":
+            return createSubagentToolDefinition(options?.subagent);
+        case "subagent_runs":
+            return createSubagentRunsToolDefinition(options?.subagent?.runRegistry);
+        case "create_subagent":
+            return createCreateSubagentToolDefinition(options?.subagent?.configRegistry);
+        case "websearch":
+            return createWebsearchToolDefinition(options?.websearch);
+        default:
+            throw new Error(`Unknown tool name: ${toolName}`);
+    }
+}
+export function createTool(toolName, operations, options) {
+    switch (toolName) {
+        case "read":
+            return createReadTool(operations, options?.read);
+        case "bash":
+            return createBashTool(operations, options?.bash);
+        case "edit":
+            return createEditTool(operations, options?.edit);
+        case "write":
+            return createWriteTool(operations, options?.write);
+        case "grep":
+            return createGrepTool(operations, options?.grep);
+        case "find":
+            return createFindTool(operations, options?.find);
+        case "ls":
+            return createLsTool(operations, options?.ls);
+        case "subagent":
+            return createSubagentTool(options?.subagent);
+        case "subagent_runs":
+            return createSubagentRunsTool(options?.subagent?.runRegistry);
+        case "create_subagent":
+            return createCreateSubagentTool(options?.subagent?.configRegistry);
+        case "websearch":
+            return createWebsearchTool(options?.websearch);
+        default:
+            throw new Error(`Unknown tool name: ${toolName}`);
+    }
+}
+export function createCodingToolDefinitions(operations, options) {
+    return [
+        createReadToolDefinition(operations, options?.read),
+        createBashToolDefinition(operations, options?.bash),
+        createEditToolDefinition(operations, options?.edit),
+        createWriteToolDefinition(operations, options?.write),
+    ];
+}
+export function createReadOnlyToolDefinitions(operations, options) {
+    return [
+        createReadToolDefinition(operations, options?.read),
+        createGrepToolDefinition(operations, options?.grep),
+        createFindToolDefinition(operations, options?.find),
+        createLsToolDefinition(operations, options?.ls),
+    ];
+}
+export function createAllToolDefinitions(operations, options) {
+    return {
+        read: createReadToolDefinition(operations, options?.read),
+        bash: createBashToolDefinition(operations, options?.bash),
+        edit: createEditToolDefinition(operations, options?.edit),
+        write: createWriteToolDefinition(operations, options?.write),
+        grep: createGrepToolDefinition(operations, options?.grep),
+        find: createFindToolDefinition(operations, options?.find),
+        ls: createLsToolDefinition(operations, options?.ls),
+        subagent: createSubagentToolDefinition(options?.subagent),
+        subagent_runs: createSubagentRunsToolDefinition(options?.subagent?.runRegistry),
+        create_subagent: createCreateSubagentToolDefinition(options?.subagent?.configRegistry),
+        websearch: createWebsearchToolDefinition(options?.websearch),
+    };
+}
+export function createCodingTools(operations, options) {
+    return [
+        createReadTool(operations, options?.read),
+        createBashTool(operations, options?.bash),
+        createEditTool(operations, options?.edit),
+        createWriteTool(operations, options?.write),
+    ];
+}
+export function createReadOnlyTools(operations, options) {
+    return [
+        createReadTool(operations, options?.read),
+        createGrepTool(operations, options?.grep),
+        createFindTool(operations, options?.find),
+        createLsTool(operations, options?.ls),
+    ];
+}
+export function createAllTools(operations, options) {
+    return {
+        read: createReadTool(operations, options?.read),
+        bash: createBashTool(operations, options?.bash),
+        edit: createEditTool(operations, options?.edit),
+        write: createWriteTool(operations, options?.write),
+        grep: createGrepTool(operations, options?.grep),
+        find: createFindTool(operations, options?.find),
+        ls: createLsTool(operations, options?.ls),
+        subagent: createSubagentTool(options?.subagent),
+        subagent_runs: createSubagentRunsTool(options?.subagent?.runRegistry),
+        create_subagent: createCreateSubagentTool(options?.subagent?.configRegistry),
+        websearch: createWebsearchTool(options?.websearch),
+    };
+}
+//# sourceMappingURL=index.js.map