@imdigitalashish/zpi 0.1.1

package/dist/core/tools/edit-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-diff.js","sourceRoot":"","sources":["../../../src/core/tools/edit-diff.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAiB;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,OAAO,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAAA,CACvC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAU;IACnD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAAA,CACxD;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,MAAqB,EAAU;IAC/E,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAAA,CAC9D;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAU;IAC5D,OAAO,CACN,IAAI;QACH,qCAAqC;SACpC,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;SAC7B,IAAI,CAAC,IAAI,CAAC;QACX,4BAA0B;SACzB,OAAO,CAAC,6BAA6B,EAAE,GAAG,CAAC;QAC5C,4BAA0B;SACzB,OAAO,CAAC,6BAA6B,EAAE,GAAG,CAAC;QAC5C,+BAA6B;QAC7B,iEAAiE;QACjE,sEAAsE;SACrE,OAAO,CAAC,+CAA+C,EAAE,GAAG,CAAC;QAC9D,mCAAiC;QACjC,iEAAiE;QACjE,qDAAqD;SACpD,OAAO,CAAC,0CAA0C,EAAE,GAAG,CAAC,CAC1D,CAAC;AAAA,CACF;AAkBD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,OAAe,EAAoB;IACjF,wBAAwB;IACxB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,OAAO;YACN,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,OAAO,CAAC,MAAM;YAC3B,cAAc,EAAE,KAAK;YACrB,qBAAqB,EAAE,OAAO;SAC9B,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEtD,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,OAAO;YACN,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,CAAC,CAAC;YACT,WAAW,EAAE,CAAC;YACd,cAAc,EAAE,KAAK;YACrB,qBAAqB,EAAE,OAAO;SAC9B,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,uEAAuE;IACvE,8EAA8E;IAC9E,OAAO;QACN,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,YAAY,CAAC,MAAM;QAChC,cAAc,EAAE,IAAI;QACpB,qBAAqB,EAAE,YAAY;KACnC,CAAC;AAAA,CACF;AAED,uFAAuF;AACvF,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAiC;IACxE,OAAO,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAAA,CAC7G;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CACjC,UAAkB,EAClB,UAAkB,EAClB,YAAY,GAAG,CAAC,EACyC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;IAE/C,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,gBAAoC,CAAC;IAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YAChC,GAAG,CAAC,GAAG,EAAE,CAAC;QACX,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,mDAAmD;YACnD,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACpC,gBAAgB,GAAG,UAAU,CAAC;YAC/B,CAAC;YAED,kBAAkB;YAClB,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;gBACxB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBAChB,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;oBAC/D,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;oBACnC,UAAU,EAAE,CAAC;gBACd,CAAC;qBAAM,CAAC;oBACP,UAAU;oBACV,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;oBAC/D,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;oBACnC,UAAU,EAAE,CAAC;gBACd,CAAC;YACF,CAAC;YACD,aAAa,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,CAAC;YACP,uDAAuD;YACvD,MAAM,gBAAgB,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAE9F,IAAI,aAAa,IAAI,gBAAgB,EAAE,CAAC;gBACvC,eAAe;gBACf,IAAI,WAAW,GAAG,GAAG,CAAC;gBACtB,IAAI,SAAS,GAAG,CAAC,CAAC;gBAClB,IAAI,OAAO,GAAG,CAAC,CAAC;gBAEhB,IAAI,CAAC,aAAa,EAAE,CAAC;oBACpB,4CAA4C;oBAC5C,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC;oBACnD,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACpC,CAAC;gBAED,IAAI,CAAC,gBAAgB,IAAI,WAAW,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;oBAC5D,8CAA8C;oBAC9C,OAAO,GAAG,WAAW,CAAC,MAAM,GAAG,YAAY,CAAC;oBAC5C,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;gBAClD,CAAC;gBAED,4CAA4C;gBAC5C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;oBACnB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;oBACtD,sDAAsD;oBACtD,UAAU,IAAI,SAAS,CAAC;oBACxB,UAAU,IAAI,SAAS,CAAC;gBACzB,CAAC;gBAED,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;oBAChC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;oBAC/D,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;oBACnC,UAAU,EAAE,CAAC;oBACb,UAAU,EAAE,CAAC;gBACd,CAAC;gBAED,0CAA0C;gBAC1C,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;oBACtD,uDAAuD;oBACvD,UAAU,IAAI,OAAO,CAAC;oBACtB,UAAU,IAAI,OAAO,CAAC;gBACvB,CAAC;YACF,CAAC;iBAAM,CAAC;gBACP,oCAAoC;gBACpC,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC;gBACzB,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC;YAC1B,CAAC;YAED,aAAa,GAAG,KAAK,CAAC;QACvB,CAAC;IACF,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC;AAAA,CACrD;AAWD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,IAAY,EACZ,OAAe,EACf,OAAe,EACf,GAAW,EAC+B;IAC1C,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE7C,IAAI,CAAC;QACJ,uCAAuC;QACvC,IAAI,CAAC;YACJ,MAAM,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,KAAK,EAAE,mBAAmB,IAAI,EAAE,EAAE,CAAC;QAC7C,CAAC;QAED,gBAAgB;QAChB,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAEzD,yEAAyE;QACzE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QAE/C,MAAM,iBAAiB,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,iBAAiB,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,iBAAiB,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAEjD,+EAA+E;QAC/E,MAAM,WAAW,GAAG,aAAa,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;QAExE,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO;gBACN,KAAK,EAAE,oCAAoC,IAAI,0EAA0E;aACzH,CAAC;QACH,CAAC;QAED,mEAAmE;QACnE,MAAM,YAAY,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;QAC/D,MAAM,YAAY,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;QAC/D,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAEhE,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO;gBACN,KAAK,EAAE,SAAS,WAAW,+BAA+B,IAAI,2EAA2E;aACzI,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,gFAAgF;QAChF,MAAM,WAAW,GAAG,WAAW,CAAC,qBAAqB,CAAC;QACtD,MAAM,UAAU,GACf,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC;YAC3C,iBAAiB;YACjB,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;QAEpE,6CAA6C;QAC7C,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO;gBACN,KAAK,EAAE,+BAA+B,IAAI,+CAA+C;aACzF,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,OAAO,kBAAkB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACpE,CAAC;AAAA,CACD","sourcesContent":["/**\r\n * Shared diff computation utilities for the edit tool.\r\n * Used by both edit.ts (for execution) and tool-execution.ts (for preview rendering).\r\n */\r\n\r\nimport * as Diff from \"diff\";\r\nimport { constants } from \"fs\";\r\nimport { access, readFile } from \"fs/promises\";\r\nimport { resolveToCwd } from \"./path-utils.js\";\r\n\r\nexport function detectLineEnding(content: string): \"\\r\\n\" | \"\\n\" {\r\n\tconst crlfIdx = content.indexOf(\"\\r\\n\");\r\n\tconst lfIdx = content.indexOf(\"\\n\");\r\n\tif (lfIdx === -1) return \"\\n\";\r\n\tif (crlfIdx === -1) return \"\\n\";\r\n\treturn crlfIdx < lfIdx ? \"\\r\\n\" : \"\\n\";\r\n}\r\n\r\nexport function normalizeToLF(text: string): string {\r\n\treturn text.replace(/\\r\\n/g, \"\\n\").replace(/\\r/g, \"\\n\");\r\n}\r\n\r\nexport function restoreLineEndings(text: string, ending: \"\\r\\n\" | \"\\n\"): string {\r\n\treturn ending === \"\\r\\n\" ? text.replace(/\\n/g, \"\\r\\n\") : text;\r\n}\r\n\r\n/**\r\n * Normalize text for fuzzy matching. Applies progressive transformations:\r\n * - Strip trailing whitespace from each line\r\n * - Normalize smart quotes to ASCII equivalents\r\n * - Normalize Unicode dashes/hyphens to ASCII hyphen\r\n * - Normalize special Unicode spaces to regular space\r\n */\r\nexport function normalizeForFuzzyMatch(text: string): string {\r\n\treturn (\r\n\t\ttext\r\n\t\t\t// Strip trailing whitespace per line\r\n\t\t\t.split(\"\\n\")\r\n\t\t\t.map((line) => line.trimEnd())\r\n\t\t\t.join(\"\\n\")\r\n\t\t\t// Smart single quotes → '\r\n\t\t\t.replace(/[\\u2018\\u2019\\u201A\\u201B]/g, \"'\")\r\n\t\t\t// Smart double quotes → \"\r\n\t\t\t.replace(/[\\u201C\\u201D\\u201E\\u201F]/g, '\"')\r\n\t\t\t// Various dashes/hyphens → -\r\n\t\t\t// U+2010 hyphen, U+2011 non-breaking hyphen, U+2012 figure dash,\r\n\t\t\t// U+2013 en-dash, U+2014 em-dash, U+2015 horizontal bar, U+2212 minus\r\n\t\t\t.replace(/[\\u2010\\u2011\\u2012\\u2013\\u2014\\u2015\\u2212]/g, \"-\")\r\n\t\t\t// Special spaces → regular space\r\n\t\t\t// U+00A0 NBSP, U+2002-U+200A various spaces, U+202F narrow NBSP,\r\n\t\t\t// U+205F medium math space, U+3000 ideographic space\r\n\t\t\t.replace(/[\\u00A0\\u2002-\\u200A\\u202F\\u205F\\u3000]/g, \" \")\r\n\t);\r\n}\r\n\r\nexport interface FuzzyMatchResult {\r\n\t/** Whether a match was found */\r\n\tfound: boolean;\r\n\t/** The index where the match starts (in the content that should be used for replacement) */\r\n\tindex: number;\r\n\t/** Length of the matched text */\r\n\tmatchLength: number;\r\n\t/** Whether fuzzy matching was used (false = exact match) */\r\n\tusedFuzzyMatch: boolean;\r\n\t/**\r\n\t * The content to use for replacement operations.\r\n\t * When exact match: original content. When fuzzy match: normalized content.\r\n\t */\r\n\tcontentForReplacement: string;\r\n}\r\n\r\n/**\r\n * Find oldText in content, trying exact match first, then fuzzy match.\r\n * When fuzzy matching is used, the returned contentForReplacement is the\r\n * fuzzy-normalized version of the content (trailing whitespace stripped,\r\n * Unicode quotes/dashes normalized to ASCII).\r\n */\r\nexport function fuzzyFindText(content: string, oldText: string): FuzzyMatchResult {\r\n\t// Try exact match first\r\n\tconst exactIndex = content.indexOf(oldText);\r\n\tif (exactIndex !== -1) {\r\n\t\treturn {\r\n\t\t\tfound: true,\r\n\t\t\tindex: exactIndex,\r\n\t\t\tmatchLength: oldText.length,\r\n\t\t\tusedFuzzyMatch: false,\r\n\t\t\tcontentForReplacement: content,\r\n\t\t};\r\n\t}\r\n\r\n\t// Try fuzzy match - work entirely in normalized space\r\n\tconst fuzzyContent = normalizeForFuzzyMatch(content);\r\n\tconst fuzzyOldText = normalizeForFuzzyMatch(oldText);\r\n\tconst fuzzyIndex = fuzzyContent.indexOf(fuzzyOldText);\r\n\r\n\tif (fuzzyIndex === -1) {\r\n\t\treturn {\r\n\t\t\tfound: false,\r\n\t\t\tindex: -1,\r\n\t\t\tmatchLength: 0,\r\n\t\t\tusedFuzzyMatch: false,\r\n\t\t\tcontentForReplacement: content,\r\n\t\t};\r\n\t}\r\n\r\n\t// When fuzzy matching, we work in the normalized space for replacement.\r\n\t// This means the output will have normalized whitespace/quotes/dashes,\r\n\t// which is acceptable since we're fixing minor formatting differences anyway.\r\n\treturn {\r\n\t\tfound: true,\r\n\t\tindex: fuzzyIndex,\r\n\t\tmatchLength: fuzzyOldText.length,\r\n\t\tusedFuzzyMatch: true,\r\n\t\tcontentForReplacement: fuzzyContent,\r\n\t};\r\n}\r\n\r\n/** Strip UTF-8 BOM if present, return both the BOM (if any) and the text without it */\r\nexport function stripBom(content: string): { bom: string; text: string } {\r\n\treturn content.startsWith(\"\\uFEFF\") ? { bom: \"\\uFEFF\", text: content.slice(1) } : { bom: \"\", text: content };\r\n}\r\n\r\n/**\r\n * Generate a unified diff string with line numbers and context.\r\n * Returns both the diff string and the first changed line number (in the new file).\r\n */\r\nexport function generateDiffString(\r\n\toldContent: string,\r\n\tnewContent: string,\r\n\tcontextLines = 4,\r\n): { diff: string; firstChangedLine: number | undefined } {\r\n\tconst parts = Diff.diffLines(oldContent, newContent);\r\n\tconst output: string[] = [];\r\n\r\n\tconst oldLines = oldContent.split(\"\\n\");\r\n\tconst newLines = newContent.split(\"\\n\");\r\n\tconst maxLineNum = Math.max(oldLines.length, newLines.length);\r\n\tconst lineNumWidth = String(maxLineNum).length;\r\n\r\n\tlet oldLineNum = 1;\r\n\tlet newLineNum = 1;\r\n\tlet lastWasChange = false;\r\n\tlet firstChangedLine: number | undefined;\r\n\r\n\tfor (let i = 0; i < parts.length; i++) {\r\n\t\tconst part = parts[i];\r\n\t\tconst raw = part.value.split(\"\\n\");\r\n\t\tif (raw[raw.length - 1] === \"\") {\r\n\t\t\traw.pop();\r\n\t\t}\r\n\r\n\t\tif (part.added || part.removed) {\r\n\t\t\t// Capture the first changed line (in the new file)\r\n\t\t\tif (firstChangedLine === undefined) {\r\n\t\t\t\tfirstChangedLine = newLineNum;\r\n\t\t\t}\r\n\r\n\t\t\t// Show the change\r\n\t\t\tfor (const line of raw) {\r\n\t\t\t\tif (part.added) {\r\n\t\t\t\t\tconst lineNum = String(newLineNum).padStart(lineNumWidth, \" \");\r\n\t\t\t\t\toutput.push(`+${lineNum} ${line}`);\r\n\t\t\t\t\tnewLineNum++;\r\n\t\t\t\t} else {\r\n\t\t\t\t\t// removed\r\n\t\t\t\t\tconst lineNum = String(oldLineNum).padStart(lineNumWidth, \" \");\r\n\t\t\t\t\toutput.push(`-${lineNum} ${line}`);\r\n\t\t\t\t\toldLineNum++;\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\tlastWasChange = true;\r\n\t\t} else {\r\n\t\t\t// Context lines - only show a few before/after changes\r\n\t\t\tconst nextPartIsChange = i < parts.length - 1 && (parts[i + 1].added || parts[i + 1].removed);\r\n\r\n\t\t\tif (lastWasChange || nextPartIsChange) {\r\n\t\t\t\t// Show context\r\n\t\t\t\tlet linesToShow = raw;\r\n\t\t\t\tlet skipStart = 0;\r\n\t\t\t\tlet skipEnd = 0;\r\n\r\n\t\t\t\tif (!lastWasChange) {\r\n\t\t\t\t\t// Show only last N lines as leading context\r\n\t\t\t\t\tskipStart = Math.max(0, raw.length - contextLines);\r\n\t\t\t\t\tlinesToShow = raw.slice(skipStart);\r\n\t\t\t\t}\r\n\r\n\t\t\t\tif (!nextPartIsChange && linesToShow.length > contextLines) {\r\n\t\t\t\t\t// Show only first N lines as trailing context\r\n\t\t\t\t\tskipEnd = linesToShow.length - contextLines;\r\n\t\t\t\t\tlinesToShow = linesToShow.slice(0, contextLines);\r\n\t\t\t\t}\r\n\r\n\t\t\t\t// Add ellipsis if we skipped lines at start\r\n\t\t\t\tif (skipStart > 0) {\r\n\t\t\t\t\toutput.push(` ${\"\".padStart(lineNumWidth, \" \")} ...`);\r\n\t\t\t\t\t// Update line numbers for the skipped leading context\r\n\t\t\t\t\toldLineNum += skipStart;\r\n\t\t\t\t\tnewLineNum += skipStart;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tfor (const line of linesToShow) {\r\n\t\t\t\t\tconst lineNum = String(oldLineNum).padStart(lineNumWidth, \" \");\r\n\t\t\t\t\toutput.push(` ${lineNum} ${line}`);\r\n\t\t\t\t\toldLineNum++;\r\n\t\t\t\t\tnewLineNum++;\r\n\t\t\t\t}\r\n\r\n\t\t\t\t// Add ellipsis if we skipped lines at end\r\n\t\t\t\tif (skipEnd > 0) {\r\n\t\t\t\t\toutput.push(` ${\"\".padStart(lineNumWidth, \" \")} ...`);\r\n\t\t\t\t\t// Update line numbers for the skipped trailing context\r\n\t\t\t\t\toldLineNum += skipEnd;\r\n\t\t\t\t\tnewLineNum += skipEnd;\r\n\t\t\t\t}\r\n\t\t\t} else {\r\n\t\t\t\t// Skip these context lines entirely\r\n\t\t\t\toldLineNum += raw.length;\r\n\t\t\t\tnewLineNum += raw.length;\r\n\t\t\t}\r\n\r\n\t\t\tlastWasChange = false;\r\n\t\t}\r\n\t}\r\n\r\n\treturn { diff: output.join(\"\\n\"), firstChangedLine };\r\n}\r\n\r\nexport interface EditDiffResult {\r\n\tdiff: string;\r\n\tfirstChangedLine: number | undefined;\r\n}\r\n\r\nexport interface EditDiffError {\r\n\terror: string;\r\n}\r\n\r\n/**\r\n * Compute the diff for an edit operation without applying it.\r\n * Used for preview rendering in the TUI before the tool executes.\r\n */\r\nexport async function computeEditDiff(\r\n\tpath: string,\r\n\toldText: string,\r\n\tnewText: string,\r\n\tcwd: string,\r\n): Promise<EditDiffResult | EditDiffError> {\r\n\tconst absolutePath = resolveToCwd(path, cwd);\r\n\r\n\ttry {\r\n\t\t// Check if file exists and is readable\r\n\t\ttry {\r\n\t\t\tawait access(absolutePath, constants.R_OK);\r\n\t\t} catch {\r\n\t\t\treturn { error: `File not found: ${path}` };\r\n\t\t}\r\n\r\n\t\t// Read the file\r\n\t\tconst rawContent = await readFile(absolutePath, \"utf-8\");\r\n\r\n\t\t// Strip BOM before matching (LLM won't include invisible BOM in oldText)\r\n\t\tconst { text: content } = stripBom(rawContent);\r\n\r\n\t\tconst normalizedContent = normalizeToLF(content);\r\n\t\tconst normalizedOldText = normalizeToLF(oldText);\r\n\t\tconst normalizedNewText = normalizeToLF(newText);\r\n\r\n\t\t// Find the old text using fuzzy matching (tries exact match first, then fuzzy)\r\n\t\tconst matchResult = fuzzyFindText(normalizedContent, normalizedOldText);\r\n\r\n\t\tif (!matchResult.found) {\r\n\t\t\treturn {\r\n\t\t\t\terror: `Could not find the exact text in ${path}. The old text must match exactly including all whitespace and newlines.`,\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\t// Count occurrences using fuzzy-normalized content for consistency\r\n\t\tconst fuzzyContent = normalizeForFuzzyMatch(normalizedContent);\r\n\t\tconst fuzzyOldText = normalizeForFuzzyMatch(normalizedOldText);\r\n\t\tconst occurrences = fuzzyContent.split(fuzzyOldText).length - 1;\r\n\r\n\t\tif (occurrences > 1) {\r\n\t\t\treturn {\r\n\t\t\t\terror: `Found ${occurrences} occurrences of the text in ${path}. The text must be unique. Please provide more context to make it unique.`,\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\t// Compute the new content using the matched position\r\n\t\t// When fuzzy matching was used, contentForReplacement is the normalized version\r\n\t\tconst baseContent = matchResult.contentForReplacement;\r\n\t\tconst newContent =\r\n\t\t\tbaseContent.substring(0, matchResult.index) +\r\n\t\t\tnormalizedNewText +\r\n\t\t\tbaseContent.substring(matchResult.index + matchResult.matchLength);\r\n\r\n\t\t// Check if it would actually change anything\r\n\t\tif (baseContent === newContent) {\r\n\t\t\treturn {\r\n\t\t\t\terror: `No changes would be made to ${path}. The replacement produces identical content.`,\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\t// Generate the diff\r\n\t\treturn generateDiffString(baseContent, newContent);\r\n\t} catch (err) {\r\n\t\treturn { error: err instanceof Error ? err.message : String(err) };\r\n\t}\r\n}\r\n"]}

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

@@ -0,0 +1,39 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { type Static } from "@sinclair/typebox";
+declare const editSchema: import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    oldText: import("@sinclair/typebox").TString;
+    newText: import("@sinclair/typebox").TString;
+}>;
+export type EditToolInput = Static<typeof editSchema>;
+export interface EditToolDetails {
+    /** Unified diff of the changes made */
+    diff: string;
+    /** Line number of the first change in the new file (for editor navigation) */
+    firstChangedLine?: number;
+}
+/**
+ * Pluggable operations for the edit tool.
+ * Override these to delegate file editing to remote systems (e.g., SSH).
+ */
+export interface EditOperations {
+    /** Read file contents as a Buffer */
+    readFile: (absolutePath: string) => Promise<Buffer>;
+    /** Write content to a file */
+    writeFile: (absolutePath: string, content: string) => Promise<void>;
+    /** Check if file is readable and writable (throw if not) */
+    access: (absolutePath: string) => Promise<void>;
+}
+export interface EditToolOptions {
+    /** Custom operations for file editing. Default: local filesystem */
+    operations?: EditOperations;
+}
+export declare function createEditTool(cwd: string, options?: EditToolOptions): AgentTool<typeof editSchema>;
+/** Default edit tool using process.cwd() - for backwards compatibility */
+export declare const editTool: AgentTool<import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    oldText: import("@sinclair/typebox").TString;
+    newText: import("@sinclair/typebox").TString;
+}>, any>;
+export {};
+//# sourceMappingURL=edit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../src/core/tools/edit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AActD,QAAA,MAAM,UAAU;;;;EAId,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC/B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,qCAAqC;IACrC,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,8BAA8B;IAC9B,SAAS,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,4DAA4D;IAC5D,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAQD,MAAM,WAAW,eAAe;IAC/B,oEAAoE;IACpE,UAAU,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CAyKnG;AAED,0EAA0E;AAC1E,eAAO,MAAM,QAAQ;;;;QAAgC,CAAC","sourcesContent":["import type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport { constants } from \"fs\";\r\nimport { access as fsAccess, readFile as fsReadFile, writeFile as fsWriteFile } from \"fs/promises\";\r\nimport {\r\n\tdetectLineEnding,\r\n\tfuzzyFindText,\r\n\tgenerateDiffString,\r\n\tnormalizeForFuzzyMatch,\r\n\tnormalizeToLF,\r\n\trestoreLineEndings,\r\n\tstripBom,\r\n} from \"./edit-diff.js\";\r\nimport { resolveToCwd } from \"./path-utils.js\";\r\n\r\nconst editSchema = Type.Object({\r\n\tpath: Type.String({ description: \"Path to the file to edit (relative or absolute)\" }),\r\n\toldText: Type.String({ description: \"Exact text to find and replace (must match exactly)\" }),\r\n\tnewText: Type.String({ description: \"New text to replace the old text with\" }),\r\n});\r\n\r\nexport type EditToolInput = Static<typeof editSchema>;\r\n\r\nexport interface EditToolDetails {\r\n\t/** Unified diff of the changes made */\r\n\tdiff: string;\r\n\t/** Line number of the first change in the new file (for editor navigation) */\r\n\tfirstChangedLine?: number;\r\n}\r\n\r\n/**\r\n * Pluggable operations for the edit tool.\r\n * Override these to delegate file editing to remote systems (e.g., SSH).\r\n */\r\nexport interface EditOperations {\r\n\t/** Read file contents as a Buffer */\r\n\treadFile: (absolutePath: string) => Promise<Buffer>;\r\n\t/** Write content to a file */\r\n\twriteFile: (absolutePath: string, content: string) => Promise<void>;\r\n\t/** Check if file is readable and writable (throw if not) */\r\n\taccess: (absolutePath: string) => Promise<void>;\r\n}\r\n\r\nconst defaultEditOperations: EditOperations = {\r\n\treadFile: (path) => fsReadFile(path),\r\n\twriteFile: (path, content) => fsWriteFile(path, content, \"utf-8\"),\r\n\taccess: (path) => fsAccess(path, constants.R_OK | constants.W_OK),\r\n};\r\n\r\nexport interface EditToolOptions {\r\n\t/** Custom operations for file editing. Default: local filesystem */\r\n\toperations?: EditOperations;\r\n}\r\n\r\nexport function createEditTool(cwd: string, options?: EditToolOptions): AgentTool<typeof editSchema> {\r\n\tconst ops = options?.operations ?? defaultEditOperations;\r\n\r\n\treturn {\r\n\t\tname: \"edit\",\r\n\t\tlabel: \"edit\",\r\n\t\tdescription:\r\n\t\t\t\"Edit a file by replacing exact text. The oldText must match exactly (including whitespace). Use this for precise, surgical edits.\",\r\n\t\tparameters: editSchema,\r\n\t\texecute: async (\r\n\t\t\t_toolCallId: string,\r\n\t\t\t{ path, oldText, newText }: { path: string; oldText: string; newText: string },\r\n\t\t\tsignal?: AbortSignal,\r\n\t\t) => {\r\n\t\t\tconst absolutePath = resolveToCwd(path, cwd);\r\n\r\n\t\t\treturn new Promise<{\r\n\t\t\t\tcontent: Array<{ type: \"text\"; text: string }>;\r\n\t\t\t\tdetails: EditToolDetails | undefined;\r\n\t\t\t}>((resolve, reject) => {\r\n\t\t\t\t// Check if already aborted\r\n\t\t\t\tif (signal?.aborted) {\r\n\t\t\t\t\treject(new Error(\"Operation aborted\"));\r\n\t\t\t\t\treturn;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tlet aborted = false;\r\n\r\n\t\t\t\t// Set up abort handler\r\n\t\t\t\tconst onAbort = () => {\r\n\t\t\t\t\taborted = true;\r\n\t\t\t\t\treject(new Error(\"Operation aborted\"));\r\n\t\t\t\t};\r\n\r\n\t\t\t\tif (signal) {\r\n\t\t\t\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\r\n\t\t\t\t}\r\n\r\n\t\t\t\t// Perform the edit operation\r\n\t\t\t\t(async () => {\r\n\t\t\t\t\ttry {\r\n\t\t\t\t\t\t// Check if file exists\r\n\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\tawait ops.access(absolutePath);\r\n\t\t\t\t\t\t} catch {\r\n\t\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\treject(new Error(`File not found: ${path}`));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Check if aborted before reading\r\n\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Read the file\r\n\t\t\t\t\t\tconst buffer = await ops.readFile(absolutePath);\r\n\t\t\t\t\t\tconst rawContent = buffer.toString(\"utf-8\");\r\n\r\n\t\t\t\t\t\t// Check if aborted after reading\r\n\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Strip BOM before matching (LLM won't include invisible BOM in oldText)\r\n\t\t\t\t\t\tconst { bom, text: content } = stripBom(rawContent);\r\n\r\n\t\t\t\t\t\tconst originalEnding = detectLineEnding(content);\r\n\t\t\t\t\t\tconst normalizedContent = normalizeToLF(content);\r\n\t\t\t\t\t\tconst normalizedOldText = normalizeToLF(oldText);\r\n\t\t\t\t\t\tconst normalizedNewText = normalizeToLF(newText);\r\n\r\n\t\t\t\t\t\t// Find the old text using fuzzy matching (tries exact match first, then fuzzy)\r\n\t\t\t\t\t\tconst matchResult = fuzzyFindText(normalizedContent, normalizedOldText);\r\n\r\n\t\t\t\t\t\tif (!matchResult.found) {\r\n\t\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\treject(\r\n\t\t\t\t\t\t\t\tnew Error(\r\n\t\t\t\t\t\t\t\t\t`Could not find the exact text in ${path}. The old text must match exactly including all whitespace and newlines.`,\r\n\t\t\t\t\t\t\t\t),\r\n\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Count occurrences using fuzzy-normalized content for consistency\r\n\t\t\t\t\t\tconst fuzzyContent = normalizeForFuzzyMatch(normalizedContent);\r\n\t\t\t\t\t\tconst fuzzyOldText = normalizeForFuzzyMatch(normalizedOldText);\r\n\t\t\t\t\t\tconst occurrences = fuzzyContent.split(fuzzyOldText).length - 1;\r\n\r\n\t\t\t\t\t\tif (occurrences > 1) {\r\n\t\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\treject(\r\n\t\t\t\t\t\t\t\tnew Error(\r\n\t\t\t\t\t\t\t\t\t`Found ${occurrences} occurrences of the text in ${path}. The text must be unique. Please provide more context to make it unique.`,\r\n\t\t\t\t\t\t\t\t),\r\n\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Check if aborted before writing\r\n\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Perform replacement using the matched text position\r\n\t\t\t\t\t\t// When fuzzy matching was used, contentForReplacement is the normalized version\r\n\t\t\t\t\t\tconst baseContent = matchResult.contentForReplacement;\r\n\t\t\t\t\t\tconst newContent =\r\n\t\t\t\t\t\t\tbaseContent.substring(0, matchResult.index) +\r\n\t\t\t\t\t\t\tnormalizedNewText +\r\n\t\t\t\t\t\t\tbaseContent.substring(matchResult.index + matchResult.matchLength);\r\n\r\n\t\t\t\t\t\t// Verify the replacement actually changed something\r\n\t\t\t\t\t\tif (baseContent === newContent) {\r\n\t\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\treject(\r\n\t\t\t\t\t\t\t\tnew Error(\r\n\t\t\t\t\t\t\t\t\t`No changes made to ${path}. The replacement produced identical content. This might indicate an issue with special characters or the text not existing as expected.`,\r\n\t\t\t\t\t\t\t\t),\r\n\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tconst finalContent = bom + restoreLineEndings(newContent, originalEnding);\r\n\t\t\t\t\t\tawait ops.writeFile(absolutePath, finalContent);\r\n\r\n\t\t\t\t\t\t// Check if aborted after writing\r\n\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Clean up abort handler\r\n\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tconst diffResult = generateDiffString(baseContent, newContent);\r\n\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\tcontent: [\r\n\t\t\t\t\t\t\t\t{\r\n\t\t\t\t\t\t\t\t\ttype: \"text\",\r\n\t\t\t\t\t\t\t\t\ttext: `Successfully replaced text in ${path}.`,\r\n\t\t\t\t\t\t\t\t},\r\n\t\t\t\t\t\t\t],\r\n\t\t\t\t\t\t\tdetails: { diff: diffResult.diff, firstChangedLine: diffResult.firstChangedLine },\r\n\t\t\t\t\t\t});\r\n\t\t\t\t\t} catch (error: any) {\r\n\t\t\t\t\t\t// Clean up abort handler\r\n\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (!aborted) {\r\n\t\t\t\t\t\t\treject(error);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t}\r\n\t\t\t\t})();\r\n\t\t\t});\r\n\t\t},\r\n\t};\r\n}\r\n\r\n/** Default edit tool using process.cwd() - for backwards compatibility */\r\nexport const editTool = createEditTool(process.cwd());\r\n"]}

package/dist/core/tools/edit.js

@@ -0,0 +1,146 @@
+import { Type } from "@sinclair/typebox";
+import { constants } from "fs";
+import { access as fsAccess, readFile as fsReadFile, writeFile as fsWriteFile } from "fs/promises";
+import { detectLineEnding, fuzzyFindText, generateDiffString, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings, stripBom, } from "./edit-diff.js";
+import { resolveToCwd } from "./path-utils.js";
+const editSchema = Type.Object({
+    path: Type.String({ description: "Path to the file to edit (relative or absolute)" }),
+    oldText: Type.String({ description: "Exact text to find and replace (must match exactly)" }),
+    newText: Type.String({ description: "New text to replace the old text with" }),
+});
+const defaultEditOperations = {
+    readFile: (path) => fsReadFile(path),
+    writeFile: (path, content) => fsWriteFile(path, content, "utf-8"),
+    access: (path) => fsAccess(path, constants.R_OK | constants.W_OK),
+};
+export function createEditTool(cwd, options) {
+    const ops = options?.operations ?? defaultEditOperations;
+    return {
+        name: "edit",
+        label: "edit",
+        description: "Edit a file by replacing exact text. The oldText must match exactly (including whitespace). Use this for precise, surgical edits.",
+        parameters: editSchema,
+        execute: async (_toolCallId, { path, oldText, newText }, signal) => {
+            const absolutePath = resolveToCwd(path, cwd);
+            return new Promise((resolve, reject) => {
+                // Check if already aborted
+                if (signal?.aborted) {
+                    reject(new Error("Operation aborted"));
+                    return;
+                }
+                let aborted = false;
+                // Set up abort handler
+                const onAbort = () => {
+                    aborted = true;
+                    reject(new Error("Operation aborted"));
+                };
+                if (signal) {
+                    signal.addEventListener("abort", onAbort, { once: true });
+                }
+                // Perform the edit operation
+                (async () => {
+                    try {
+                        // Check if file exists
+                        try {
+                            await ops.access(absolutePath);
+                        }
+                        catch {
+                            if (signal) {
+                                signal.removeEventListener("abort", onAbort);
+                            }
+                            reject(new Error(`File not found: ${path}`));
+                            return;
+                        }
+                        // Check if aborted before reading
+                        if (aborted) {
+                            return;
+                        }
+                        // Read the file
+                        const buffer = await ops.readFile(absolutePath);
+                        const rawContent = buffer.toString("utf-8");
+                        // Check if aborted after reading
+                        if (aborted) {
+                            return;
+                        }
+                        // Strip BOM before matching (LLM won't include invisible BOM in oldText)
+                        const { bom, text: content } = stripBom(rawContent);
+                        const originalEnding = detectLineEnding(content);
+                        const normalizedContent = normalizeToLF(content);
+                        const normalizedOldText = normalizeToLF(oldText);
+                        const normalizedNewText = normalizeToLF(newText);
+                        // Find the old text using fuzzy matching (tries exact match first, then fuzzy)
+                        const matchResult = fuzzyFindText(normalizedContent, normalizedOldText);
+                        if (!matchResult.found) {
+                            if (signal) {
+                                signal.removeEventListener("abort", onAbort);
+                            }
+                            reject(new Error(`Could not find the exact text in ${path}. The old text must match exactly including all whitespace and newlines.`));
+                            return;
+                        }
+                        // Count occurrences using fuzzy-normalized content for consistency
+                        const fuzzyContent = normalizeForFuzzyMatch(normalizedContent);
+                        const fuzzyOldText = normalizeForFuzzyMatch(normalizedOldText);
+                        const occurrences = fuzzyContent.split(fuzzyOldText).length - 1;
+                        if (occurrences > 1) {
+                            if (signal) {
+                                signal.removeEventListener("abort", onAbort);
+                            }
+                            reject(new Error(`Found ${occurrences} occurrences of the text in ${path}. The text must be unique. Please provide more context to make it unique.`));
+                            return;
+                        }
+                        // Check if aborted before writing
+                        if (aborted) {
+                            return;
+                        }
+                        // Perform replacement using the matched text position
+                        // When fuzzy matching was used, contentForReplacement is the normalized version
+                        const baseContent = matchResult.contentForReplacement;
+                        const newContent = baseContent.substring(0, matchResult.index) +
+                            normalizedNewText +
+                            baseContent.substring(matchResult.index + matchResult.matchLength);
+                        // Verify the replacement actually changed something
+                        if (baseContent === newContent) {
+                            if (signal) {
+                                signal.removeEventListener("abort", onAbort);
+                            }
+                            reject(new Error(`No changes made to ${path}. The replacement produced identical content. This might indicate an issue with special characters or the text not existing as expected.`));
+                            return;
+                        }
+                        const finalContent = bom + restoreLineEndings(newContent, originalEnding);
+                        await ops.writeFile(absolutePath, finalContent);
+                        // Check if aborted after writing
+                        if (aborted) {
+                            return;
+                        }
+                        // Clean up abort handler
+                        if (signal) {
+                            signal.removeEventListener("abort", onAbort);
+                        }
+                        const diffResult = generateDiffString(baseContent, newContent);
+                        resolve({
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `Successfully replaced text in ${path}.`,
+                                },
+                            ],
+                            details: { diff: diffResult.diff, firstChangedLine: diffResult.firstChangedLine },
+                        });
+                    }
+                    catch (error) {
+                        // Clean up abort handler
+                        if (signal) {
+                            signal.removeEventListener("abort", onAbort);
+                        }
+                        if (!aborted) {
+                            reject(error);
+                        }
+                    }
+                })();
+            });
+        },
+    };
+}
+/** Default edit tool using process.cwd() - for backwards compatibility */
+export const editTool = createEditTool(process.cwd());
+//# sourceMappingURL=edit.js.map

package/dist/core/tools/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../../src/core/tools/edit.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport { constants } from \"fs\";\r\nimport { access as fsAccess, readFile as fsReadFile, writeFile as fsWriteFile } from \"fs/promises\";\r\nimport {\r\n\tdetectLineEnding,\r\n\tfuzzyFindText,\r\n\tgenerateDiffString,\r\n\tnormalizeForFuzzyMatch,\r\n\tnormalizeToLF,\r\n\trestoreLineEndings,\r\n\tstripBom,\r\n} from \"./edit-diff.js\";\r\nimport { resolveToCwd } from \"./path-utils.js\";\r\n\r\nconst editSchema = Type.Object({\r\n\tpath: Type.String({ description: \"Path to the file to edit (relative or absolute)\" }),\r\n\toldText: Type.String({ description: \"Exact text to find and replace (must match exactly)\" }),\r\n\tnewText: Type.String({ description: \"New text to replace the old text with\" }),\r\n});\r\n\r\nexport type EditToolInput = Static<typeof editSchema>;\r\n\r\nexport interface EditToolDetails {\r\n\t/** Unified diff of the changes made */\r\n\tdiff: string;\r\n\t/** Line number of the first change in the new file (for editor navigation) */\r\n\tfirstChangedLine?: number;\r\n}\r\n\r\n/**\r\n * Pluggable operations for the edit tool.\r\n * Override these to delegate file editing to remote systems (e.g., SSH).\r\n */\r\nexport interface EditOperations {\r\n\t/** Read file contents as a Buffer */\r\n\treadFile: (absolutePath: string) => Promise<Buffer>;\r\n\t/** Write content to a file */\r\n\twriteFile: (absolutePath: string, content: string) => Promise<void>;\r\n\t/** Check if file is readable and writable (throw if not) */\r\n\taccess: (absolutePath: string) => Promise<void>;\r\n}\r\n\r\nconst defaultEditOperations: EditOperations = {\r\n\treadFile: (path) => fsReadFile(path),\r\n\twriteFile: (path, content) => fsWriteFile(path, content, \"utf-8\"),\r\n\taccess: (path) => fsAccess(path, constants.R_OK | constants.W_OK),\r\n};\r\n\r\nexport interface EditToolOptions {\r\n\t/** Custom operations for file editing. Default: local filesystem */\r\n\toperations?: EditOperations;\r\n}\r\n\r\nexport function createEditTool(cwd: string, options?: EditToolOptions): AgentTool<typeof editSchema> {\r\n\tconst ops = options?.operations ?? defaultEditOperations;\r\n\r\n\treturn {\r\n\t\tname: \"edit\",\r\n\t\tlabel: \"edit\",\r\n\t\tdescription:\r\n\t\t\t\"Edit a file by replacing exact text. The oldText must match exactly (including whitespace). Use this for precise, surgical edits.\",\r\n\t\tparameters: editSchema,\r\n\t\texecute: async (\r\n\t\t\t_toolCallId: string,\r\n\t\t\t{ path, oldText, newText }: { path: string; oldText: string; newText: string },\r\n\t\t\tsignal?: AbortSignal,\r\n\t\t) => {\r\n\t\t\tconst absolutePath = resolveToCwd(path, cwd);\r\n\r\n\t\t\treturn new Promise<{\r\n\t\t\t\tcontent: Array<{ type: \"text\"; text: string }>;\r\n\t\t\t\tdetails: EditToolDetails | undefined;\r\n\t\t\t}>((resolve, reject) => {\r\n\t\t\t\t// Check if already aborted\r\n\t\t\t\tif (signal?.aborted) {\r\n\t\t\t\t\treject(new Error(\"Operation aborted\"));\r\n\t\t\t\t\treturn;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tlet aborted = false;\r\n\r\n\t\t\t\t// Set up abort handler\r\n\t\t\t\tconst onAbort = () => {\r\n\t\t\t\t\taborted = true;\r\n\t\t\t\t\treject(new Error(\"Operation aborted\"));\r\n\t\t\t\t};\r\n\r\n\t\t\t\tif (signal) {\r\n\t\t\t\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\r\n\t\t\t\t}\r\n\r\n\t\t\t\t// Perform the edit operation\r\n\t\t\t\t(async () => {\r\n\t\t\t\t\ttry {\r\n\t\t\t\t\t\t// Check if file exists\r\n\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\tawait ops.access(absolutePath);\r\n\t\t\t\t\t\t} catch {\r\n\t\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\treject(new Error(`File not found: ${path}`));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Check if aborted before reading\r\n\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Read the file\r\n\t\t\t\t\t\tconst buffer = await ops.readFile(absolutePath);\r\n\t\t\t\t\t\tconst rawContent = buffer.toString(\"utf-8\");\r\n\r\n\t\t\t\t\t\t// Check if aborted after reading\r\n\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Strip BOM before matching (LLM won't include invisible BOM in oldText)\r\n\t\t\t\t\t\tconst { bom, text: content } = stripBom(rawContent);\r\n\r\n\t\t\t\t\t\tconst originalEnding = detectLineEnding(content);\r\n\t\t\t\t\t\tconst normalizedContent = normalizeToLF(content);\r\n\t\t\t\t\t\tconst normalizedOldText = normalizeToLF(oldText);\r\n\t\t\t\t\t\tconst normalizedNewText = normalizeToLF(newText);\r\n\r\n\t\t\t\t\t\t// Find the old text using fuzzy matching (tries exact match first, then fuzzy)\r\n\t\t\t\t\t\tconst matchResult = fuzzyFindText(normalizedContent, normalizedOldText);\r\n\r\n\t\t\t\t\t\tif (!matchResult.found) {\r\n\t\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\treject(\r\n\t\t\t\t\t\t\t\tnew Error(\r\n\t\t\t\t\t\t\t\t\t`Could not find the exact text in ${path}. The old text must match exactly including all whitespace and newlines.`,\r\n\t\t\t\t\t\t\t\t),\r\n\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Count occurrences using fuzzy-normalized content for consistency\r\n\t\t\t\t\t\tconst fuzzyContent = normalizeForFuzzyMatch(normalizedContent);\r\n\t\t\t\t\t\tconst fuzzyOldText = normalizeForFuzzyMatch(normalizedOldText);\r\n\t\t\t\t\t\tconst occurrences = fuzzyContent.split(fuzzyOldText).length - 1;\r\n\r\n\t\t\t\t\t\tif (occurrences > 1) {\r\n\t\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\treject(\r\n\t\t\t\t\t\t\t\tnew Error(\r\n\t\t\t\t\t\t\t\t\t`Found ${occurrences} occurrences of the text in ${path}. The text must be unique. Please provide more context to make it unique.`,\r\n\t\t\t\t\t\t\t\t),\r\n\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Check if aborted before writing\r\n\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Perform replacement using the matched text position\r\n\t\t\t\t\t\t// When fuzzy matching was used, contentForReplacement is the normalized version\r\n\t\t\t\t\t\tconst baseContent = matchResult.contentForReplacement;\r\n\t\t\t\t\t\tconst newContent =\r\n\t\t\t\t\t\t\tbaseContent.substring(0, matchResult.index) +\r\n\t\t\t\t\t\t\tnormalizedNewText +\r\n\t\t\t\t\t\t\tbaseContent.substring(matchResult.index + matchResult.matchLength);\r\n\r\n\t\t\t\t\t\t// Verify the replacement actually changed something\r\n\t\t\t\t\t\tif (baseContent === newContent) {\r\n\t\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\treject(\r\n\t\t\t\t\t\t\t\tnew Error(\r\n\t\t\t\t\t\t\t\t\t`No changes made to ${path}. The replacement produced identical content. This might indicate an issue with special characters or the text not existing as expected.`,\r\n\t\t\t\t\t\t\t\t),\r\n\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tconst finalContent = bom + restoreLineEndings(newContent, originalEnding);\r\n\t\t\t\t\t\tawait ops.writeFile(absolutePath, finalContent);\r\n\r\n\t\t\t\t\t\t// Check if aborted after writing\r\n\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Clean up abort handler\r\n\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tconst diffResult = generateDiffString(baseContent, newContent);\r\n\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\tcontent: [\r\n\t\t\t\t\t\t\t\t{\r\n\t\t\t\t\t\t\t\t\ttype: \"text\",\r\n\t\t\t\t\t\t\t\t\ttext: `Successfully replaced text in ${path}.`,\r\n\t\t\t\t\t\t\t\t},\r\n\t\t\t\t\t\t\t],\r\n\t\t\t\t\t\t\tdetails: { diff: diffResult.diff, firstChangedLine: diffResult.firstChangedLine },\r\n\t\t\t\t\t\t});\r\n\t\t\t\t\t} catch (error: any) {\r\n\t\t\t\t\t\t// Clean up abort handler\r\n\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (!aborted) {\r\n\t\t\t\t\t\t\treject(error);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t}\r\n\t\t\t\t})();\r\n\t\t\t});\r\n\t\t},\r\n\t};\r\n}\r\n\r\n/** Default edit tool using process.cwd() - for backwards compatibility */\r\nexport const editTool = createEditTool(process.cwd());\r\n"]}

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

@@ -0,0 +1,39 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { type Static } from "@sinclair/typebox";
+import { type TruncationResult } from "./truncate.js";
+declare const findSchema: import("@sinclair/typebox").TObject<{
+    pattern: import("@sinclair/typebox").TString;
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type FindToolInput = Static<typeof findSchema>;
+export interface FindToolDetails {
+    truncation?: TruncationResult;
+    resultLimitReached?: number;
+}
+/**
+ * Pluggable operations for the find tool.
+ * Override these to delegate file search to remote systems (e.g., SSH).
+ */
+export interface FindOperations {
+    /** Check if path exists */
+    exists: (absolutePath: string) => Promise<boolean> | boolean;
+    /** Find files matching glob pattern. Returns relative paths. */
+    glob: (pattern: string, cwd: string, options: {
+        ignore: string[];
+        limit: number;
+    }) => Promise<string[]> | string[];
+}
+export interface FindToolOptions {
+    /** Custom operations for find. Default: local filesystem + fd */
+    operations?: FindOperations;
+}
+export declare function createFindTool(cwd: string, options?: FindToolOptions): AgentTool<typeof findSchema>;
+/** Default find tool using process.cwd() - for backwards compatibility */
+export declare const findTool: AgentTool<import("@sinclair/typebox").TObject<{
+    pattern: import("@sinclair/typebox").TString;
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, any>;
+export {};
+//# sourceMappingURL=find.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/core/tools/find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAOtD,OAAO,EAAiC,KAAK,gBAAgB,EAAgB,MAAM,eAAe,CAAC;AAEnG,QAAA,MAAM,UAAU;;;;EAMd,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAItD,MAAM,WAAW,eAAe;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,2BAA2B;IAC3B,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC7D,gEAAgE;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC;CACnH;AAUD,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,UAAU,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CA0NnG;AAED,0EAA0E;AAC1E,eAAO,MAAM,QAAQ;;;;QAAgC,CAAC","sourcesContent":["import type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport { spawnSync } from \"child_process\";\r\nimport { existsSync } from \"fs\";\r\nimport { globSync } from \"glob\";\r\nimport path from \"path\";\r\nimport { ensureTool } from \"../../utils/tools-manager.js\";\r\nimport { resolveToCwd } from \"./path-utils.js\";\r\nimport { DEFAULT_MAX_BYTES, formatSize, type TruncationResult, truncateHead } from \"./truncate.js\";\r\n\r\nconst findSchema = Type.Object({\r\n\tpattern: Type.String({\r\n\t\tdescription: \"Glob pattern to match files, e.g. '*.ts', '**/*.json', or 'src/**/*.spec.ts'\",\r\n\t}),\r\n\tpath: Type.Optional(Type.String({ description: \"Directory to search in (default: current directory)\" })),\r\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of results (default: 1000)\" })),\r\n});\r\n\r\nexport type FindToolInput = Static<typeof findSchema>;\r\n\r\nconst DEFAULT_LIMIT = 1000;\r\n\r\nexport interface FindToolDetails {\r\n\ttruncation?: TruncationResult;\r\n\tresultLimitReached?: number;\r\n}\r\n\r\n/**\r\n * Pluggable operations for the find tool.\r\n * Override these to delegate file search to remote systems (e.g., SSH).\r\n */\r\nexport interface FindOperations {\r\n\t/** Check if path exists */\r\n\texists: (absolutePath: string) => Promise<boolean> | boolean;\r\n\t/** Find files matching glob pattern. Returns relative paths. */\r\n\tglob: (pattern: string, cwd: string, options: { ignore: string[]; limit: number }) => Promise<string[]> | string[];\r\n}\r\n\r\nconst defaultFindOperations: FindOperations = {\r\n\texists: existsSync,\r\n\tglob: (_pattern, _searchCwd, _options) => {\r\n\t\t// This is a placeholder - actual fd execution happens in execute\r\n\t\treturn [];\r\n\t},\r\n};\r\n\r\nexport interface FindToolOptions {\r\n\t/** Custom operations for find. Default: local filesystem + fd */\r\n\toperations?: FindOperations;\r\n}\r\n\r\nexport function createFindTool(cwd: string, options?: FindToolOptions): AgentTool<typeof findSchema> {\r\n\tconst customOps = options?.operations;\r\n\r\n\treturn {\r\n\t\tname: \"find\",\r\n\t\tlabel: \"find\",\r\n\t\tdescription: `Search for files by glob pattern. Returns matching file paths relative to the search directory. Respects .gitignore. Output is truncated to ${DEFAULT_LIMIT} results or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first).`,\r\n\t\tparameters: findSchema,\r\n\t\texecute: async (\r\n\t\t\t_toolCallId: string,\r\n\t\t\t{ pattern, path: searchDir, limit }: { pattern: string; path?: string; limit?: number },\r\n\t\t\tsignal?: AbortSignal,\r\n\t\t) => {\r\n\t\t\treturn new Promise((resolve, reject) => {\r\n\t\t\t\tif (signal?.aborted) {\r\n\t\t\t\t\treject(new Error(\"Operation aborted\"));\r\n\t\t\t\t\treturn;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tconst onAbort = () => reject(new Error(\"Operation aborted\"));\r\n\t\t\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\r\n\r\n\t\t\t\t(async () => {\r\n\t\t\t\t\ttry {\r\n\t\t\t\t\t\tconst searchPath = resolveToCwd(searchDir || \".\", cwd);\r\n\t\t\t\t\t\tconst effectiveLimit = limit ?? DEFAULT_LIMIT;\r\n\t\t\t\t\t\tconst ops = customOps ?? defaultFindOperations;\r\n\r\n\t\t\t\t\t\t// If custom operations provided with glob, use that\r\n\t\t\t\t\t\tif (customOps?.glob) {\r\n\t\t\t\t\t\t\tif (!(await ops.exists(searchPath))) {\r\n\t\t\t\t\t\t\t\treject(new Error(`Path not found: ${searchPath}`));\r\n\t\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tconst results = await ops.glob(pattern, searchPath, {\r\n\t\t\t\t\t\t\t\tignore: [\"**/node_modules/**\", \"**/.git/**\"],\r\n\t\t\t\t\t\t\t\tlimit: effectiveLimit,\r\n\t\t\t\t\t\t\t});\r\n\r\n\t\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\r\n\r\n\t\t\t\t\t\t\tif (results.length === 0) {\r\n\t\t\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"No files found matching pattern\" }],\r\n\t\t\t\t\t\t\t\t\tdetails: undefined,\r\n\t\t\t\t\t\t\t\t});\r\n\t\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t// Relativize paths\r\n\t\t\t\t\t\t\tconst relativized = results.map((p) => {\r\n\t\t\t\t\t\t\t\tif (p.startsWith(searchPath)) {\r\n\t\t\t\t\t\t\t\t\treturn p.slice(searchPath.length + 1);\r\n\t\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\t\treturn path.relative(searchPath, p);\r\n\t\t\t\t\t\t\t});\r\n\r\n\t\t\t\t\t\t\tconst resultLimitReached = relativized.length >= effectiveLimit;\r\n\t\t\t\t\t\t\tconst rawOutput = relativized.join(\"\\n\");\r\n\t\t\t\t\t\t\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\r\n\r\n\t\t\t\t\t\t\tlet resultOutput = truncation.content;\r\n\t\t\t\t\t\t\tconst details: FindToolDetails = {};\r\n\t\t\t\t\t\t\tconst notices: string[] = [];\r\n\r\n\t\t\t\t\t\t\tif (resultLimitReached) {\r\n\t\t\t\t\t\t\t\tnotices.push(`${effectiveLimit} results limit reached`);\r\n\t\t\t\t\t\t\t\tdetails.resultLimitReached = effectiveLimit;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tif (truncation.truncated) {\r\n\t\t\t\t\t\t\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\r\n\t\t\t\t\t\t\t\tdetails.truncation = truncation;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tif (notices.length > 0) {\r\n\t\t\t\t\t\t\t\tresultOutput += `\\n\\n[${notices.join(\". \")}]`;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: resultOutput }],\r\n\t\t\t\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\r\n\t\t\t\t\t\t\t});\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Default: use fd\r\n\t\t\t\t\t\tconst fdPath = await ensureTool(\"fd\", true);\r\n\t\t\t\t\t\tif (!fdPath) {\r\n\t\t\t\t\t\t\treject(new Error(\"fd is not available and could not be downloaded\"));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Build fd arguments\r\n\t\t\t\t\t\tconst args: string[] = [\r\n\t\t\t\t\t\t\t\"--glob\",\r\n\t\t\t\t\t\t\t\"--color=never\",\r\n\t\t\t\t\t\t\t\"--hidden\",\r\n\t\t\t\t\t\t\t\"--max-results\",\r\n\t\t\t\t\t\t\tString(effectiveLimit),\r\n\t\t\t\t\t\t];\r\n\r\n\t\t\t\t\t\t// Include .gitignore files\r\n\t\t\t\t\t\tconst gitignoreFiles = new Set<string>();\r\n\t\t\t\t\t\tconst rootGitignore = path.join(searchPath, \".gitignore\");\r\n\t\t\t\t\t\tif (existsSync(rootGitignore)) {\r\n\t\t\t\t\t\t\tgitignoreFiles.add(rootGitignore);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\tconst nestedGitignores = globSync(\"**/.gitignore\", {\r\n\t\t\t\t\t\t\t\tcwd: searchPath,\r\n\t\t\t\t\t\t\t\tdot: true,\r\n\t\t\t\t\t\t\t\tabsolute: true,\r\n\t\t\t\t\t\t\t\tignore: [\"**/node_modules/**\", \"**/.git/**\"],\r\n\t\t\t\t\t\t\t});\r\n\t\t\t\t\t\t\tfor (const file of nestedGitignores) {\r\n\t\t\t\t\t\t\t\tgitignoreFiles.add(file);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t} catch {\r\n\t\t\t\t\t\t\t// Ignore glob errors\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tfor (const gitignorePath of gitignoreFiles) {\r\n\t\t\t\t\t\t\targs.push(\"--ignore-file\", gitignorePath);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\targs.push(pattern, searchPath);\r\n\r\n\t\t\t\t\t\tconst result = spawnSync(fdPath, args, {\r\n\t\t\t\t\t\t\tencoding: \"utf-8\",\r\n\t\t\t\t\t\t\tmaxBuffer: 10 * 1024 * 1024,\r\n\t\t\t\t\t\t});\r\n\r\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\r\n\r\n\t\t\t\t\t\tif (result.error) {\r\n\t\t\t\t\t\t\treject(new Error(`Failed to run fd: ${result.error.message}`));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tconst output = result.stdout?.trim() || \"\";\r\n\r\n\t\t\t\t\t\tif (result.status !== 0) {\r\n\t\t\t\t\t\t\tconst errorMsg = result.stderr?.trim() || `fd exited with code ${result.status}`;\r\n\t\t\t\t\t\t\tif (!output) {\r\n\t\t\t\t\t\t\t\treject(new Error(errorMsg));\r\n\t\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (!output) {\r\n\t\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"No files found matching pattern\" }],\r\n\t\t\t\t\t\t\t\tdetails: undefined,\r\n\t\t\t\t\t\t\t});\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tconst lines = output.split(\"\\n\");\r\n\t\t\t\t\t\tconst relativized: string[] = [];\r\n\r\n\t\t\t\t\t\tfor (const rawLine of lines) {\r\n\t\t\t\t\t\t\tconst line = rawLine.replace(/\\r$/, \"\").trim();\r\n\t\t\t\t\t\t\tif (!line) continue;\r\n\r\n\t\t\t\t\t\t\tconst hadTrailingSlash = line.endsWith(\"/\") || line.endsWith(\"\\\\\");\r\n\t\t\t\t\t\t\tlet relativePath = line;\r\n\t\t\t\t\t\t\tif (line.startsWith(searchPath)) {\r\n\t\t\t\t\t\t\t\trelativePath = line.slice(searchPath.length + 1);\r\n\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\trelativePath = path.relative(searchPath, line);\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tif (hadTrailingSlash && !relativePath.endsWith(\"/\")) {\r\n\t\t\t\t\t\t\t\trelativePath += \"/\";\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\trelativized.push(relativePath);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tconst resultLimitReached = relativized.length >= effectiveLimit;\r\n\t\t\t\t\t\tconst rawOutput = relativized.join(\"\\n\");\r\n\t\t\t\t\t\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\r\n\r\n\t\t\t\t\t\tlet resultOutput = truncation.content;\r\n\t\t\t\t\t\tconst details: FindToolDetails = {};\r\n\t\t\t\t\t\tconst notices: string[] = [];\r\n\r\n\t\t\t\t\t\tif (resultLimitReached) {\r\n\t\t\t\t\t\t\tnotices.push(\r\n\t\t\t\t\t\t\t\t`${effectiveLimit} results limit reached. Use limit=${effectiveLimit * 2} for more, or refine pattern`,\r\n\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\tdetails.resultLimitReached = effectiveLimit;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (truncation.truncated) {\r\n\t\t\t\t\t\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\r\n\t\t\t\t\t\t\tdetails.truncation = truncation;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (notices.length > 0) {\r\n\t\t\t\t\t\t\tresultOutput += `\\n\\n[${notices.join(\". \")}]`;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: resultOutput }],\r\n\t\t\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\r\n\t\t\t\t\t\t});\r\n\t\t\t\t\t} catch (e: any) {\r\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\treject(e);\r\n\t\t\t\t\t}\r\n\t\t\t\t})();\r\n\t\t\t});\r\n\t\t},\r\n\t};\r\n}\r\n\r\n/** Default find tool using process.cwd() - for backwards compatibility */\r\nexport const findTool = createFindTool(process.cwd());\r\n"]}

package/dist/core/tools/find.js

@@ -0,0 +1,206 @@
+import { Type } from "@sinclair/typebox";
+import { spawnSync } from "child_process";
+import { existsSync } from "fs";
+import { globSync } from "glob";
+import path from "path";
+import { ensureTool } from "../../utils/tools-manager.js";
+import { resolveToCwd } from "./path-utils.js";
+import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
+const findSchema = Type.Object({
+    pattern: Type.String({
+        description: "Glob pattern to match files, e.g. '*.ts', '**/*.json', or 'src/**/*.spec.ts'",
+    }),
+    path: Type.Optional(Type.String({ description: "Directory to search in (default: current directory)" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum number of results (default: 1000)" })),
+});
+const DEFAULT_LIMIT = 1000;
+const defaultFindOperations = {
+    exists: existsSync,
+    glob: (_pattern, _searchCwd, _options) => {
+        // This is a placeholder - actual fd execution happens in execute
+        return [];
+    },
+};
+export function createFindTool(cwd, options) {
+    const customOps = options?.operations;
+    return {
+        name: "find",
+        label: "find",
+        description: `Search for files by glob pattern. Returns matching file paths relative to the search directory. Respects .gitignore. Output is truncated to ${DEFAULT_LIMIT} results or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first).`,
+        parameters: findSchema,
+        execute: async (_toolCallId, { pattern, path: searchDir, limit }, signal) => {
+            return new Promise((resolve, reject) => {
+                if (signal?.aborted) {
+                    reject(new Error("Operation aborted"));
+                    return;
+                }
+                const onAbort = () => reject(new Error("Operation aborted"));
+                signal?.addEventListener("abort", onAbort, { once: true });
+                (async () => {
+                    try {
+                        const searchPath = resolveToCwd(searchDir || ".", cwd);
+                        const effectiveLimit = limit ?? DEFAULT_LIMIT;
+                        const ops = customOps ?? defaultFindOperations;
+                        // If custom operations provided with glob, use that
+                        if (customOps?.glob) {
+                            if (!(await ops.exists(searchPath))) {
+                                reject(new Error(`Path not found: ${searchPath}`));
+                                return;
+                            }
+                            const results = await ops.glob(pattern, searchPath, {
+                                ignore: ["**/node_modules/**", "**/.git/**"],
+                                limit: effectiveLimit,
+                            });
+                            signal?.removeEventListener("abort", onAbort);
+                            if (results.length === 0) {
+                                resolve({
+                                    content: [{ type: "text", text: "No files found matching pattern" }],
+                                    details: undefined,
+                                });
+                                return;
+                            }
+                            // Relativize paths
+                            const relativized = results.map((p) => {
+                                if (p.startsWith(searchPath)) {
+                                    return p.slice(searchPath.length + 1);
+                                }
+                                return path.relative(searchPath, p);
+                            });
+                            const resultLimitReached = relativized.length >= effectiveLimit;
+                            const rawOutput = relativized.join("\n");
+                            const truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });
+                            let resultOutput = truncation.content;
+                            const details = {};
+                            const notices = [];
+                            if (resultLimitReached) {
+                                notices.push(`${effectiveLimit} results limit reached`);
+                                details.resultLimitReached = effectiveLimit;
+                            }
+                            if (truncation.truncated) {
+                                notices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);
+                                details.truncation = truncation;
+                            }
+                            if (notices.length > 0) {
+                                resultOutput += `\n\n[${notices.join(". ")}]`;
+                            }
+                            resolve({
+                                content: [{ type: "text", text: resultOutput }],
+                                details: Object.keys(details).length > 0 ? details : undefined,
+                            });
+                            return;
+                        }
+                        // Default: use fd
+                        const fdPath = await ensureTool("fd", true);
+                        if (!fdPath) {
+                            reject(new Error("fd is not available and could not be downloaded"));
+                            return;
+                        }
+                        // Build fd arguments
+                        const args = [
+                            "--glob",
+                            "--color=never",
+                            "--hidden",
+                            "--max-results",
+                            String(effectiveLimit),
+                        ];
+                        // Include .gitignore files
+                        const gitignoreFiles = new Set();
+                        const rootGitignore = path.join(searchPath, ".gitignore");
+                        if (existsSync(rootGitignore)) {
+                            gitignoreFiles.add(rootGitignore);
+                        }
+                        try {
+                            const nestedGitignores = globSync("**/.gitignore", {
+                                cwd: searchPath,
+                                dot: true,
+                                absolute: true,
+                                ignore: ["**/node_modules/**", "**/.git/**"],
+                            });
+                            for (const file of nestedGitignores) {
+                                gitignoreFiles.add(file);
+                            }
+                        }
+                        catch {
+                            // Ignore glob errors
+                        }
+                        for (const gitignorePath of gitignoreFiles) {
+                            args.push("--ignore-file", gitignorePath);
+                        }
+                        args.push(pattern, searchPath);
+                        const result = spawnSync(fdPath, args, {
+                            encoding: "utf-8",
+                            maxBuffer: 10 * 1024 * 1024,
+                        });
+                        signal?.removeEventListener("abort", onAbort);
+                        if (result.error) {
+                            reject(new Error(`Failed to run fd: ${result.error.message}`));
+                            return;
+                        }
+                        const output = result.stdout?.trim() || "";
+                        if (result.status !== 0) {
+                            const errorMsg = result.stderr?.trim() || `fd exited with code ${result.status}`;
+                            if (!output) {
+                                reject(new Error(errorMsg));
+                                return;
+                            }
+                        }
+                        if (!output) {
+                            resolve({
+                                content: [{ type: "text", text: "No files found matching pattern" }],
+                                details: undefined,
+                            });
+                            return;
+                        }
+                        const lines = output.split("\n");
+                        const relativized = [];
+                        for (const rawLine of lines) {
+                            const line = rawLine.replace(/\r$/, "").trim();
+                            if (!line)
+                                continue;
+                            const hadTrailingSlash = line.endsWith("/") || line.endsWith("\\");
+                            let relativePath = line;
+                            if (line.startsWith(searchPath)) {
+                                relativePath = line.slice(searchPath.length + 1);
+                            }
+                            else {
+                                relativePath = path.relative(searchPath, line);
+                            }
+                            if (hadTrailingSlash && !relativePath.endsWith("/")) {
+                                relativePath += "/";
+                            }
+                            relativized.push(relativePath);
+                        }
+                        const resultLimitReached = relativized.length >= effectiveLimit;
+                        const rawOutput = relativized.join("\n");
+                        const truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });
+                        let resultOutput = truncation.content;
+                        const details = {};
+                        const notices = [];
+                        if (resultLimitReached) {
+                            notices.push(`${effectiveLimit} results limit reached. Use limit=${effectiveLimit * 2} for more, or refine pattern`);
+                            details.resultLimitReached = effectiveLimit;
+                        }
+                        if (truncation.truncated) {
+                            notices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);
+                            details.truncation = truncation;
+                        }
+                        if (notices.length > 0) {
+                            resultOutput += `\n\n[${notices.join(". ")}]`;
+                        }
+                        resolve({
+                            content: [{ type: "text", text: resultOutput }],
+                            details: Object.keys(details).length > 0 ? details : undefined,
+                        });
+                    }
+                    catch (e) {
+                        signal?.removeEventListener("abort", onAbort);
+                        reject(e);
+                    }
+                })();
+            });
+        },
+    };
+}
+/** Default find tool using process.cwd() - for backwards compatibility */
+export const findTool = createFindTool(process.cwd());
+//# sourceMappingURL=find.js.map

package/dist/core/tools/find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../src/core/tools/find.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport { spawnSync } from \"child_process\";\r\nimport { existsSync } from \"fs\";\r\nimport { globSync } from \"glob\";\r\nimport path from \"path\";\r\nimport { ensureTool } from \"../../utils/tools-manager.js\";\r\nimport { resolveToCwd } from \"./path-utils.js\";\r\nimport { DEFAULT_MAX_BYTES, formatSize, type TruncationResult, truncateHead } from \"./truncate.js\";\r\n\r\nconst findSchema = Type.Object({\r\n\tpattern: Type.String({\r\n\t\tdescription: \"Glob pattern to match files, e.g. '*.ts', '**/*.json', or 'src/**/*.spec.ts'\",\r\n\t}),\r\n\tpath: Type.Optional(Type.String({ description: \"Directory to search in (default: current directory)\" })),\r\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of results (default: 1000)\" })),\r\n});\r\n\r\nexport type FindToolInput = Static<typeof findSchema>;\r\n\r\nconst DEFAULT_LIMIT = 1000;\r\n\r\nexport interface FindToolDetails {\r\n\ttruncation?: TruncationResult;\r\n\tresultLimitReached?: number;\r\n}\r\n\r\n/**\r\n * Pluggable operations for the find tool.\r\n * Override these to delegate file search to remote systems (e.g., SSH).\r\n */\r\nexport interface FindOperations {\r\n\t/** Check if path exists */\r\n\texists: (absolutePath: string) => Promise<boolean> | boolean;\r\n\t/** Find files matching glob pattern. Returns relative paths. */\r\n\tglob: (pattern: string, cwd: string, options: { ignore: string[]; limit: number }) => Promise<string[]> | string[];\r\n}\r\n\r\nconst defaultFindOperations: FindOperations = {\r\n\texists: existsSync,\r\n\tglob: (_pattern, _searchCwd, _options) => {\r\n\t\t// This is a placeholder - actual fd execution happens in execute\r\n\t\treturn [];\r\n\t},\r\n};\r\n\r\nexport interface FindToolOptions {\r\n\t/** Custom operations for find. Default: local filesystem + fd */\r\n\toperations?: FindOperations;\r\n}\r\n\r\nexport function createFindTool(cwd: string, options?: FindToolOptions): AgentTool<typeof findSchema> {\r\n\tconst customOps = options?.operations;\r\n\r\n\treturn {\r\n\t\tname: \"find\",\r\n\t\tlabel: \"find\",\r\n\t\tdescription: `Search for files by glob pattern. Returns matching file paths relative to the search directory. Respects .gitignore. Output is truncated to ${DEFAULT_LIMIT} results or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first).`,\r\n\t\tparameters: findSchema,\r\n\t\texecute: async (\r\n\t\t\t_toolCallId: string,\r\n\t\t\t{ pattern, path: searchDir, limit }: { pattern: string; path?: string; limit?: number },\r\n\t\t\tsignal?: AbortSignal,\r\n\t\t) => {\r\n\t\t\treturn new Promise((resolve, reject) => {\r\n\t\t\t\tif (signal?.aborted) {\r\n\t\t\t\t\treject(new Error(\"Operation aborted\"));\r\n\t\t\t\t\treturn;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tconst onAbort = () => reject(new Error(\"Operation aborted\"));\r\n\t\t\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\r\n\r\n\t\t\t\t(async () => {\r\n\t\t\t\t\ttry {\r\n\t\t\t\t\t\tconst searchPath = resolveToCwd(searchDir || \".\", cwd);\r\n\t\t\t\t\t\tconst effectiveLimit = limit ?? DEFAULT_LIMIT;\r\n\t\t\t\t\t\tconst ops = customOps ?? defaultFindOperations;\r\n\r\n\t\t\t\t\t\t// If custom operations provided with glob, use that\r\n\t\t\t\t\t\tif (customOps?.glob) {\r\n\t\t\t\t\t\t\tif (!(await ops.exists(searchPath))) {\r\n\t\t\t\t\t\t\t\treject(new Error(`Path not found: ${searchPath}`));\r\n\t\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tconst results = await ops.glob(pattern, searchPath, {\r\n\t\t\t\t\t\t\t\tignore: [\"**/node_modules/**\", \"**/.git/**\"],\r\n\t\t\t\t\t\t\t\tlimit: effectiveLimit,\r\n\t\t\t\t\t\t\t});\r\n\r\n\t\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\r\n\r\n\t\t\t\t\t\t\tif (results.length === 0) {\r\n\t\t\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"No files found matching pattern\" }],\r\n\t\t\t\t\t\t\t\t\tdetails: undefined,\r\n\t\t\t\t\t\t\t\t});\r\n\t\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t// Relativize paths\r\n\t\t\t\t\t\t\tconst relativized = results.map((p) => {\r\n\t\t\t\t\t\t\t\tif (p.startsWith(searchPath)) {\r\n\t\t\t\t\t\t\t\t\treturn p.slice(searchPath.length + 1);\r\n\t\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\t\treturn path.relative(searchPath, p);\r\n\t\t\t\t\t\t\t});\r\n\r\n\t\t\t\t\t\t\tconst resultLimitReached = relativized.length >= effectiveLimit;\r\n\t\t\t\t\t\t\tconst rawOutput = relativized.join(\"\\n\");\r\n\t\t\t\t\t\t\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\r\n\r\n\t\t\t\t\t\t\tlet resultOutput = truncation.content;\r\n\t\t\t\t\t\t\tconst details: FindToolDetails = {};\r\n\t\t\t\t\t\t\tconst notices: string[] = [];\r\n\r\n\t\t\t\t\t\t\tif (resultLimitReached) {\r\n\t\t\t\t\t\t\t\tnotices.push(`${effectiveLimit} results limit reached`);\r\n\t\t\t\t\t\t\t\tdetails.resultLimitReached = effectiveLimit;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tif (truncation.truncated) {\r\n\t\t\t\t\t\t\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\r\n\t\t\t\t\t\t\t\tdetails.truncation = truncation;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tif (notices.length > 0) {\r\n\t\t\t\t\t\t\t\tresultOutput += `\\n\\n[${notices.join(\". \")}]`;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: resultOutput }],\r\n\t\t\t\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\r\n\t\t\t\t\t\t\t});\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Default: use fd\r\n\t\t\t\t\t\tconst fdPath = await ensureTool(\"fd\", true);\r\n\t\t\t\t\t\tif (!fdPath) {\r\n\t\t\t\t\t\t\treject(new Error(\"fd is not available and could not be downloaded\"));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Build fd arguments\r\n\t\t\t\t\t\tconst args: string[] = [\r\n\t\t\t\t\t\t\t\"--glob\",\r\n\t\t\t\t\t\t\t\"--color=never\",\r\n\t\t\t\t\t\t\t\"--hidden\",\r\n\t\t\t\t\t\t\t\"--max-results\",\r\n\t\t\t\t\t\t\tString(effectiveLimit),\r\n\t\t\t\t\t\t];\r\n\r\n\t\t\t\t\t\t// Include .gitignore files\r\n\t\t\t\t\t\tconst gitignoreFiles = new Set<string>();\r\n\t\t\t\t\t\tconst rootGitignore = path.join(searchPath, \".gitignore\");\r\n\t\t\t\t\t\tif (existsSync(rootGitignore)) {\r\n\t\t\t\t\t\t\tgitignoreFiles.add(rootGitignore);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\tconst nestedGitignores = globSync(\"**/.gitignore\", {\r\n\t\t\t\t\t\t\t\tcwd: searchPath,\r\n\t\t\t\t\t\t\t\tdot: true,\r\n\t\t\t\t\t\t\t\tabsolute: true,\r\n\t\t\t\t\t\t\t\tignore: [\"**/node_modules/**\", \"**/.git/**\"],\r\n\t\t\t\t\t\t\t});\r\n\t\t\t\t\t\t\tfor (const file of nestedGitignores) {\r\n\t\t\t\t\t\t\t\tgitignoreFiles.add(file);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t} catch {\r\n\t\t\t\t\t\t\t// Ignore glob errors\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tfor (const gitignorePath of gitignoreFiles) {\r\n\t\t\t\t\t\t\targs.push(\"--ignore-file\", gitignorePath);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\targs.push(pattern, searchPath);\r\n\r\n\t\t\t\t\t\tconst result = spawnSync(fdPath, args, {\r\n\t\t\t\t\t\t\tencoding: \"utf-8\",\r\n\t\t\t\t\t\t\tmaxBuffer: 10 * 1024 * 1024,\r\n\t\t\t\t\t\t});\r\n\r\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\r\n\r\n\t\t\t\t\t\tif (result.error) {\r\n\t\t\t\t\t\t\treject(new Error(`Failed to run fd: ${result.error.message}`));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tconst output = result.stdout?.trim() || \"\";\r\n\r\n\t\t\t\t\t\tif (result.status !== 0) {\r\n\t\t\t\t\t\t\tconst errorMsg = result.stderr?.trim() || `fd exited with code ${result.status}`;\r\n\t\t\t\t\t\t\tif (!output) {\r\n\t\t\t\t\t\t\t\treject(new Error(errorMsg));\r\n\t\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (!output) {\r\n\t\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"No files found matching pattern\" }],\r\n\t\t\t\t\t\t\t\tdetails: undefined,\r\n\t\t\t\t\t\t\t});\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tconst lines = output.split(\"\\n\");\r\n\t\t\t\t\t\tconst relativized: string[] = [];\r\n\r\n\t\t\t\t\t\tfor (const rawLine of lines) {\r\n\t\t\t\t\t\t\tconst line = rawLine.replace(/\\r$/, \"\").trim();\r\n\t\t\t\t\t\t\tif (!line) continue;\r\n\r\n\t\t\t\t\t\t\tconst hadTrailingSlash = line.endsWith(\"/\") || line.endsWith(\"\\\\\");\r\n\t\t\t\t\t\t\tlet relativePath = line;\r\n\t\t\t\t\t\t\tif (line.startsWith(searchPath)) {\r\n\t\t\t\t\t\t\t\trelativePath = line.slice(searchPath.length + 1);\r\n\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\trelativePath = path.relative(searchPath, line);\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tif (hadTrailingSlash && !relativePath.endsWith(\"/\")) {\r\n\t\t\t\t\t\t\t\trelativePath += \"/\";\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\trelativized.push(relativePath);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tconst resultLimitReached = relativized.length >= effectiveLimit;\r\n\t\t\t\t\t\tconst rawOutput = relativized.join(\"\\n\");\r\n\t\t\t\t\t\tconst truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });\r\n\r\n\t\t\t\t\t\tlet resultOutput = truncation.content;\r\n\t\t\t\t\t\tconst details: FindToolDetails = {};\r\n\t\t\t\t\t\tconst notices: string[] = [];\r\n\r\n\t\t\t\t\t\tif (resultLimitReached) {\r\n\t\t\t\t\t\t\tnotices.push(\r\n\t\t\t\t\t\t\t\t`${effectiveLimit} results limit reached. Use limit=${effectiveLimit * 2} for more, or refine pattern`,\r\n\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\tdetails.resultLimitReached = effectiveLimit;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (truncation.truncated) {\r\n\t\t\t\t\t\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);\r\n\t\t\t\t\t\t\tdetails.truncation = truncation;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (notices.length > 0) {\r\n\t\t\t\t\t\t\tresultOutput += `\\n\\n[${notices.join(\". \")}]`;\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: resultOutput }],\r\n\t\t\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\r\n\t\t\t\t\t\t});\r\n\t\t\t\t\t} catch (e: any) {\r\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\treject(e);\r\n\t\t\t\t\t}\r\n\t\t\t\t})();\r\n\t\t\t});\r\n\t\t},\r\n\t};\r\n}\r\n\r\n/** Default find tool using process.cwd() - for backwards compatibility */\r\nexport const findTool = createFindTool(process.cwd());\r\n"]}