@imdigitalashish/zpi 0.1.1

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

@@ -0,0 +1,45 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { type Static } from "@sinclair/typebox";
+import { type TruncationResult } from "./truncate.js";
+declare const grepSchema: import("@sinclair/typebox").TObject<{
+    pattern: import("@sinclair/typebox").TString;
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    glob: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    ignoreCase: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    literal: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type GrepToolInput = Static<typeof grepSchema>;
+export interface GrepToolDetails {
+    truncation?: TruncationResult;
+    matchLimitReached?: number;
+    linesTruncated?: boolean;
+}
+/**
+ * Pluggable operations for the grep tool.
+ * Override these to delegate search to remote systems (e.g., SSH).
+ */
+export interface GrepOperations {
+    /** Check if path is a directory. Throws if path doesn't exist. */
+    isDirectory: (absolutePath: string) => Promise<boolean> | boolean;
+    /** Read file contents for context lines */
+    readFile: (absolutePath: string) => Promise<string> | string;
+}
+export interface GrepToolOptions {
+    /** Custom operations for grep. Default: local filesystem + ripgrep */
+    operations?: GrepOperations;
+}
+export declare function createGrepTool(cwd: string, options?: GrepToolOptions): AgentTool<typeof grepSchema>;
+/** Default grep tool using process.cwd() - for backwards compatibility */
+export declare const grepTool: AgentTool<import("@sinclair/typebox").TObject<{
+    pattern: import("@sinclair/typebox").TString;
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    glob: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    ignoreCase: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    literal: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, any>;
+export {};
+//# sourceMappingURL=grep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../../src/core/tools/grep.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAMtD,OAAO,EAIN,KAAK,gBAAgB,EAGrB,MAAM,eAAe,CAAC;AAEvB,QAAA,MAAM,UAAU;;;;;;;;EAYd,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAItD,MAAM,WAAW,eAAe;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,kEAAkE;IAClE,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAClE,2CAA2C;IAC3C,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAC7D;AAOD,MAAM,WAAW,eAAe;IAC/B,sEAAsE;IACtE,UAAU,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CAwRnG;AAED,0EAA0E;AAC1E,eAAO,MAAM,QAAQ;;;;;;;;QAAgC,CAAC","sourcesContent":["import { createInterface } from \"node:readline\";\r\nimport type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport { spawn } from \"child_process\";\r\nimport { readFileSync, statSync } from \"fs\";\r\nimport path from \"path\";\r\nimport { ensureTool } from \"../../utils/tools-manager.js\";\r\nimport { resolveToCwd } from \"./path-utils.js\";\r\nimport {\r\n\tDEFAULT_MAX_BYTES,\r\n\tformatSize,\r\n\tGREP_MAX_LINE_LENGTH,\r\n\ttype TruncationResult,\r\n\ttruncateHead,\r\n\ttruncateLine,\r\n} from \"./truncate.js\";\r\n\r\nconst grepSchema = Type.Object({\r\n\tpattern: Type.String({ description: \"Search pattern (regex or literal string)\" }),\r\n\tpath: Type.Optional(Type.String({ description: \"Directory or file to search (default: current directory)\" })),\r\n\tglob: Type.Optional(Type.String({ description: \"Filter files by glob pattern, e.g. '*.ts' or '**/*.spec.ts'\" })),\r\n\tignoreCase: Type.Optional(Type.Boolean({ description: \"Case-insensitive search (default: false)\" })),\r\n\tliteral: Type.Optional(\r\n\t\tType.Boolean({ description: \"Treat pattern as literal string instead of regex (default: false)\" }),\r\n\t),\r\n\tcontext: Type.Optional(\r\n\t\tType.Number({ description: \"Number of lines to show before and after each match (default: 0)\" }),\r\n\t),\r\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of matches to return (default: 100)\" })),\r\n});\r\n\r\nexport type GrepToolInput = Static<typeof grepSchema>;\r\n\r\nconst DEFAULT_LIMIT = 100;\r\n\r\nexport interface GrepToolDetails {\r\n\ttruncation?: TruncationResult;\r\n\tmatchLimitReached?: number;\r\n\tlinesTruncated?: boolean;\r\n}\r\n\r\n/**\r\n * Pluggable operations for the grep tool.\r\n * Override these to delegate search to remote systems (e.g., SSH).\r\n */\r\nexport interface GrepOperations {\r\n\t/** Check if path is a directory. Throws if path doesn't exist. */\r\n\tisDirectory: (absolutePath: string) => Promise<boolean> | boolean;\r\n\t/** Read file contents for context lines */\r\n\treadFile: (absolutePath: string) => Promise<string> | string;\r\n}\r\n\r\nconst defaultGrepOperations: GrepOperations = {\r\n\tisDirectory: (p) => statSync(p).isDirectory(),\r\n\treadFile: (p) => readFileSync(p, \"utf-8\"),\r\n};\r\n\r\nexport interface GrepToolOptions {\r\n\t/** Custom operations for grep. Default: local filesystem + ripgrep */\r\n\toperations?: GrepOperations;\r\n}\r\n\r\nexport function createGrepTool(cwd: string, options?: GrepToolOptions): AgentTool<typeof grepSchema> {\r\n\tconst customOps = options?.operations;\r\n\r\n\treturn {\r\n\t\tname: \"grep\",\r\n\t\tlabel: \"grep\",\r\n\t\tdescription: `Search file contents for a pattern. Returns matching lines with file paths and line numbers. Respects .gitignore. Output is truncated to ${DEFAULT_LIMIT} matches or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Long lines are truncated to ${GREP_MAX_LINE_LENGTH} chars.`,\r\n\t\tparameters: grepSchema,\r\n\t\texecute: async (\r\n\t\t\t_toolCallId: string,\r\n\t\t\t{\r\n\t\t\t\tpattern,\r\n\t\t\t\tpath: searchDir,\r\n\t\t\t\tglob,\r\n\t\t\t\tignoreCase,\r\n\t\t\t\tliteral,\r\n\t\t\t\tcontext,\r\n\t\t\t\tlimit,\r\n\t\t\t}: {\r\n\t\t\t\tpattern: string;\r\n\t\t\t\tpath?: string;\r\n\t\t\t\tglob?: string;\r\n\t\t\t\tignoreCase?: boolean;\r\n\t\t\t\tliteral?: boolean;\r\n\t\t\t\tcontext?: number;\r\n\t\t\t\tlimit?: number;\r\n\t\t\t},\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\tlet settled = false;\r\n\t\t\t\tconst settle = (fn: () => void) => {\r\n\t\t\t\t\tif (!settled) {\r\n\t\t\t\t\t\tsettled = true;\r\n\t\t\t\t\t\tfn();\r\n\t\t\t\t\t}\r\n\t\t\t\t};\r\n\r\n\t\t\t\t(async () => {\r\n\t\t\t\t\ttry {\r\n\t\t\t\t\t\tconst rgPath = await ensureTool(\"rg\", true);\r\n\t\t\t\t\t\tif (!rgPath) {\r\n\t\t\t\t\t\t\tsettle(() => reject(new Error(\"ripgrep (rg) 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\tconst searchPath = resolveToCwd(searchDir || \".\", cwd);\r\n\t\t\t\t\t\tconst ops = customOps ?? defaultGrepOperations;\r\n\r\n\t\t\t\t\t\tlet isDirectory: boolean;\r\n\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\tisDirectory = await ops.isDirectory(searchPath);\r\n\t\t\t\t\t\t} catch (_err) {\r\n\t\t\t\t\t\t\tsettle(() => reject(new Error(`Path not found: ${searchPath}`)));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t\tconst contextValue = context && context > 0 ? context : 0;\r\n\t\t\t\t\t\tconst effectiveLimit = Math.max(1, limit ?? DEFAULT_LIMIT);\r\n\r\n\t\t\t\t\t\tconst formatPath = (filePath: string): string => {\r\n\t\t\t\t\t\t\tif (isDirectory) {\r\n\t\t\t\t\t\t\t\tconst relative = path.relative(searchPath, filePath);\r\n\t\t\t\t\t\t\t\tif (relative && !relative.startsWith(\"..\")) {\r\n\t\t\t\t\t\t\t\t\treturn relative.replace(/\\\\/g, \"/\");\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 path.basename(filePath);\r\n\t\t\t\t\t\t};\r\n\r\n\t\t\t\t\t\tconst fileCache = new Map<string, string[]>();\r\n\t\t\t\t\t\tconst getFileLines = async (filePath: string): Promise<string[]> => {\r\n\t\t\t\t\t\t\tlet lines = fileCache.get(filePath);\r\n\t\t\t\t\t\t\tif (!lines) {\r\n\t\t\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\t\t\tconst content = await ops.readFile(filePath);\r\n\t\t\t\t\t\t\t\t\tlines = content.replace(/\\r\\n/g, \"\\n\").replace(/\\r/g, \"\\n\").split(\"\\n\");\r\n\t\t\t\t\t\t\t\t} catch {\r\n\t\t\t\t\t\t\t\t\tlines = [];\r\n\t\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\t\tfileCache.set(filePath, lines);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\treturn lines;\r\n\t\t\t\t\t\t};\r\n\r\n\t\t\t\t\t\tconst args: string[] = [\"--json\", \"--line-number\", \"--color=never\", \"--hidden\"];\r\n\r\n\t\t\t\t\t\tif (ignoreCase) {\r\n\t\t\t\t\t\t\targs.push(\"--ignore-case\");\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (literal) {\r\n\t\t\t\t\t\t\targs.push(\"--fixed-strings\");\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (glob) {\r\n\t\t\t\t\t\t\targs.push(\"--glob\", glob);\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 child = spawn(rgPath, args, { stdio: [\"ignore\", \"pipe\", \"pipe\"] });\r\n\t\t\t\t\t\tconst rl = createInterface({ input: child.stdout });\r\n\t\t\t\t\t\tlet stderr = \"\";\r\n\t\t\t\t\t\tlet matchCount = 0;\r\n\t\t\t\t\t\tlet matchLimitReached = false;\r\n\t\t\t\t\t\tlet linesTruncated = false;\r\n\t\t\t\t\t\tlet aborted = false;\r\n\t\t\t\t\t\tlet killedDueToLimit = false;\r\n\t\t\t\t\t\tconst outputLines: string[] = [];\r\n\r\n\t\t\t\t\t\tconst cleanup = () => {\r\n\t\t\t\t\t\t\trl.close();\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 stopChild = (dueToLimit: boolean = false) => {\r\n\t\t\t\t\t\t\tif (!child.killed) {\r\n\t\t\t\t\t\t\t\tkilledDueToLimit = dueToLimit;\r\n\t\t\t\t\t\t\t\tchild.kill();\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\tconst onAbort = () => {\r\n\t\t\t\t\t\t\taborted = true;\r\n\t\t\t\t\t\t\tstopChild();\r\n\t\t\t\t\t\t};\r\n\r\n\t\t\t\t\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\r\n\r\n\t\t\t\t\t\tchild.stderr?.on(\"data\", (chunk) => {\r\n\t\t\t\t\t\t\tstderr += chunk.toString();\r\n\t\t\t\t\t\t});\r\n\r\n\t\t\t\t\t\tconst formatBlock = async (filePath: string, lineNumber: number): Promise<string[]> => {\r\n\t\t\t\t\t\t\tconst relativePath = formatPath(filePath);\r\n\t\t\t\t\t\t\tconst lines = await getFileLines(filePath);\r\n\t\t\t\t\t\t\tif (!lines.length) {\r\n\t\t\t\t\t\t\t\treturn [`${relativePath}:${lineNumber}: (unable to read file)`];\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tconst block: string[] = [];\r\n\t\t\t\t\t\t\tconst start = contextValue > 0 ? Math.max(1, lineNumber - contextValue) : lineNumber;\r\n\t\t\t\t\t\t\tconst end = contextValue > 0 ? Math.min(lines.length, lineNumber + contextValue) : lineNumber;\r\n\r\n\t\t\t\t\t\t\tfor (let current = start; current <= end; current++) {\r\n\t\t\t\t\t\t\t\tconst lineText = lines[current - 1] ?? \"\";\r\n\t\t\t\t\t\t\t\tconst sanitized = lineText.replace(/\\r/g, \"\");\r\n\t\t\t\t\t\t\t\tconst isMatchLine = current === lineNumber;\r\n\r\n\t\t\t\t\t\t\t\t// Truncate long lines\r\n\t\t\t\t\t\t\t\tconst { text: truncatedText, wasTruncated } = truncateLine(sanitized);\r\n\t\t\t\t\t\t\t\tif (wasTruncated) {\r\n\t\t\t\t\t\t\t\t\tlinesTruncated = true;\r\n\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\tif (isMatchLine) {\r\n\t\t\t\t\t\t\t\t\tblock.push(`${relativePath}:${current}: ${truncatedText}`);\r\n\t\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\t\tblock.push(`${relativePath}-${current}- ${truncatedText}`);\r\n\t\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\treturn block;\r\n\t\t\t\t\t\t};\r\n\r\n\t\t\t\t\t\t// Collect matches during streaming, format after\r\n\t\t\t\t\t\tconst matches: Array<{ filePath: string; lineNumber: number }> = [];\r\n\r\n\t\t\t\t\t\trl.on(\"line\", (line) => {\r\n\t\t\t\t\t\t\tif (!line.trim() || matchCount >= effectiveLimit) {\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\tlet event: any;\r\n\t\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\t\tevent = JSON.parse(line);\r\n\t\t\t\t\t\t\t} catch {\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\tif (event.type === \"match\") {\r\n\t\t\t\t\t\t\t\tmatchCount++;\r\n\t\t\t\t\t\t\t\tconst filePath = event.data?.path?.text;\r\n\t\t\t\t\t\t\t\tconst lineNumber = event.data?.line_number;\r\n\r\n\t\t\t\t\t\t\t\tif (filePath && typeof lineNumber === \"number\") {\r\n\t\t\t\t\t\t\t\t\tmatches.push({ filePath, lineNumber });\r\n\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\tif (matchCount >= effectiveLimit) {\r\n\t\t\t\t\t\t\t\t\tmatchLimitReached = true;\r\n\t\t\t\t\t\t\t\t\tstopChild(true);\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});\r\n\r\n\t\t\t\t\t\tchild.on(\"error\", (error) => {\r\n\t\t\t\t\t\t\tcleanup();\r\n\t\t\t\t\t\t\tsettle(() => reject(new Error(`Failed to run ripgrep: ${error.message}`)));\r\n\t\t\t\t\t\t});\r\n\r\n\t\t\t\t\t\tchild.on(\"close\", async (code) => {\r\n\t\t\t\t\t\t\tcleanup();\r\n\r\n\t\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\t\tsettle(() => reject(new Error(\"Operation aborted\")));\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\tif (!killedDueToLimit && code !== 0 && code !== 1) {\r\n\t\t\t\t\t\t\t\tconst errorMsg = stderr.trim() || `ripgrep exited with code ${code}`;\r\n\t\t\t\t\t\t\t\tsettle(() => reject(new Error(errorMsg)));\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\tif (matchCount === 0) {\r\n\t\t\t\t\t\t\t\tsettle(() =>\r\n\t\t\t\t\t\t\t\t\tresolve({ content: [{ type: \"text\", text: \"No matches found\" }], details: 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// Format matches (async to support remote file reading)\r\n\t\t\t\t\t\t\tfor (const match of matches) {\r\n\t\t\t\t\t\t\t\tconst block = await formatBlock(match.filePath, match.lineNumber);\r\n\t\t\t\t\t\t\t\toutputLines.push(...block);\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t// Apply byte truncation (no line limit since we already have match limit)\r\n\t\t\t\t\t\t\tconst rawOutput = outputLines.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 output = truncation.content;\r\n\t\t\t\t\t\t\tconst details: GrepToolDetails = {};\r\n\r\n\t\t\t\t\t\t\t// Build notices\r\n\t\t\t\t\t\t\tconst notices: string[] = [];\r\n\r\n\t\t\t\t\t\t\tif (matchLimitReached) {\r\n\t\t\t\t\t\t\t\tnotices.push(\r\n\t\t\t\t\t\t\t\t\t`${effectiveLimit} matches limit reached. Use limit=${effectiveLimit * 2} for more, or refine pattern`,\r\n\t\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\t\tdetails.matchLimitReached = 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 (linesTruncated) {\r\n\t\t\t\t\t\t\t\tnotices.push(\r\n\t\t\t\t\t\t\t\t\t`Some lines truncated to ${GREP_MAX_LINE_LENGTH} chars. Use read tool to see full lines`,\r\n\t\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\t\tdetails.linesTruncated = true;\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\toutput += `\\n\\n[${notices.join(\". \")}]`;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tsettle(() =>\r\n\t\t\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: output }],\r\n\t\t\t\t\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\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});\r\n\t\t\t\t\t} catch (err) {\r\n\t\t\t\t\t\tsettle(() => reject(err as Error));\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 grep tool using process.cwd() - for backwards compatibility */\r\nexport const grepTool = createGrepTool(process.cwd());\r\n"]}

package/dist/core/tools/grep.js

@@ -0,0 +1,239 @@
+import { createInterface } from "node:readline";
+import { Type } from "@sinclair/typebox";
+import { spawn } from "child_process";
+import { readFileSync, statSync } from "fs";
+import path from "path";
+import { ensureTool } from "../../utils/tools-manager.js";
+import { resolveToCwd } from "./path-utils.js";
+import { DEFAULT_MAX_BYTES, formatSize, GREP_MAX_LINE_LENGTH, truncateHead, truncateLine, } from "./truncate.js";
+const grepSchema = Type.Object({
+    pattern: Type.String({ description: "Search pattern (regex or literal string)" }),
+    path: Type.Optional(Type.String({ description: "Directory or file to search (default: current directory)" })),
+    glob: Type.Optional(Type.String({ description: "Filter files by glob pattern, e.g. '*.ts' or '**/*.spec.ts'" })),
+    ignoreCase: Type.Optional(Type.Boolean({ description: "Case-insensitive search (default: false)" })),
+    literal: Type.Optional(Type.Boolean({ description: "Treat pattern as literal string instead of regex (default: false)" })),
+    context: Type.Optional(Type.Number({ description: "Number of lines to show before and after each match (default: 0)" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum number of matches to return (default: 100)" })),
+});
+const DEFAULT_LIMIT = 100;
+const defaultGrepOperations = {
+    isDirectory: (p) => statSync(p).isDirectory(),
+    readFile: (p) => readFileSync(p, "utf-8"),
+};
+export function createGrepTool(cwd, options) {
+    const customOps = options?.operations;
+    return {
+        name: "grep",
+        label: "grep",
+        description: `Search file contents for a pattern. Returns matching lines with file paths and line numbers. Respects .gitignore. Output is truncated to ${DEFAULT_LIMIT} matches or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Long lines are truncated to ${GREP_MAX_LINE_LENGTH} chars.`,
+        parameters: grepSchema,
+        execute: async (_toolCallId, { pattern, path: searchDir, glob, ignoreCase, literal, context, limit, }, signal) => {
+            return new Promise((resolve, reject) => {
+                if (signal?.aborted) {
+                    reject(new Error("Operation aborted"));
+                    return;
+                }
+                let settled = false;
+                const settle = (fn) => {
+                    if (!settled) {
+                        settled = true;
+                        fn();
+                    }
+                };
+                (async () => {
+                    try {
+                        const rgPath = await ensureTool("rg", true);
+                        if (!rgPath) {
+                            settle(() => reject(new Error("ripgrep (rg) is not available and could not be downloaded")));
+                            return;
+                        }
+                        const searchPath = resolveToCwd(searchDir || ".", cwd);
+                        const ops = customOps ?? defaultGrepOperations;
+                        let isDirectory;
+                        try {
+                            isDirectory = await ops.isDirectory(searchPath);
+                        }
+                        catch (_err) {
+                            settle(() => reject(new Error(`Path not found: ${searchPath}`)));
+                            return;
+                        }
+                        const contextValue = context && context > 0 ? context : 0;
+                        const effectiveLimit = Math.max(1, limit ?? DEFAULT_LIMIT);
+                        const formatPath = (filePath) => {
+                            if (isDirectory) {
+                                const relative = path.relative(searchPath, filePath);
+                                if (relative && !relative.startsWith("..")) {
+                                    return relative.replace(/\\/g, "/");
+                                }
+                            }
+                            return path.basename(filePath);
+                        };
+                        const fileCache = new Map();
+                        const getFileLines = async (filePath) => {
+                            let lines = fileCache.get(filePath);
+                            if (!lines) {
+                                try {
+                                    const content = await ops.readFile(filePath);
+                                    lines = content.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+                                }
+                                catch {
+                                    lines = [];
+                                }
+                                fileCache.set(filePath, lines);
+                            }
+                            return lines;
+                        };
+                        const args = ["--json", "--line-number", "--color=never", "--hidden"];
+                        if (ignoreCase) {
+                            args.push("--ignore-case");
+                        }
+                        if (literal) {
+                            args.push("--fixed-strings");
+                        }
+                        if (glob) {
+                            args.push("--glob", glob);
+                        }
+                        args.push(pattern, searchPath);
+                        const child = spawn(rgPath, args, { stdio: ["ignore", "pipe", "pipe"] });
+                        const rl = createInterface({ input: child.stdout });
+                        let stderr = "";
+                        let matchCount = 0;
+                        let matchLimitReached = false;
+                        let linesTruncated = false;
+                        let aborted = false;
+                        let killedDueToLimit = false;
+                        const outputLines = [];
+                        const cleanup = () => {
+                            rl.close();
+                            signal?.removeEventListener("abort", onAbort);
+                        };
+                        const stopChild = (dueToLimit = false) => {
+                            if (!child.killed) {
+                                killedDueToLimit = dueToLimit;
+                                child.kill();
+                            }
+                        };
+                        const onAbort = () => {
+                            aborted = true;
+                            stopChild();
+                        };
+                        signal?.addEventListener("abort", onAbort, { once: true });
+                        child.stderr?.on("data", (chunk) => {
+                            stderr += chunk.toString();
+                        });
+                        const formatBlock = async (filePath, lineNumber) => {
+                            const relativePath = formatPath(filePath);
+                            const lines = await getFileLines(filePath);
+                            if (!lines.length) {
+                                return [`${relativePath}:${lineNumber}: (unable to read file)`];
+                            }
+                            const block = [];
+                            const start = contextValue > 0 ? Math.max(1, lineNumber - contextValue) : lineNumber;
+                            const end = contextValue > 0 ? Math.min(lines.length, lineNumber + contextValue) : lineNumber;
+                            for (let current = start; current <= end; current++) {
+                                const lineText = lines[current - 1] ?? "";
+                                const sanitized = lineText.replace(/\r/g, "");
+                                const isMatchLine = current === lineNumber;
+                                // Truncate long lines
+                                const { text: truncatedText, wasTruncated } = truncateLine(sanitized);
+                                if (wasTruncated) {
+                                    linesTruncated = true;
+                                }
+                                if (isMatchLine) {
+                                    block.push(`${relativePath}:${current}: ${truncatedText}`);
+                                }
+                                else {
+                                    block.push(`${relativePath}-${current}- ${truncatedText}`);
+                                }
+                            }
+                            return block;
+                        };
+                        // Collect matches during streaming, format after
+                        const matches = [];
+                        rl.on("line", (line) => {
+                            if (!line.trim() || matchCount >= effectiveLimit) {
+                                return;
+                            }
+                            let event;
+                            try {
+                                event = JSON.parse(line);
+                            }
+                            catch {
+                                return;
+                            }
+                            if (event.type === "match") {
+                                matchCount++;
+                                const filePath = event.data?.path?.text;
+                                const lineNumber = event.data?.line_number;
+                                if (filePath && typeof lineNumber === "number") {
+                                    matches.push({ filePath, lineNumber });
+                                }
+                                if (matchCount >= effectiveLimit) {
+                                    matchLimitReached = true;
+                                    stopChild(true);
+                                }
+                            }
+                        });
+                        child.on("error", (error) => {
+                            cleanup();
+                            settle(() => reject(new Error(`Failed to run ripgrep: ${error.message}`)));
+                        });
+                        child.on("close", async (code) => {
+                            cleanup();
+                            if (aborted) {
+                                settle(() => reject(new Error("Operation aborted")));
+                                return;
+                            }
+                            if (!killedDueToLimit && code !== 0 && code !== 1) {
+                                const errorMsg = stderr.trim() || `ripgrep exited with code ${code}`;
+                                settle(() => reject(new Error(errorMsg)));
+                                return;
+                            }
+                            if (matchCount === 0) {
+                                settle(() => resolve({ content: [{ type: "text", text: "No matches found" }], details: undefined }));
+                                return;
+                            }
+                            // Format matches (async to support remote file reading)
+                            for (const match of matches) {
+                                const block = await formatBlock(match.filePath, match.lineNumber);
+                                outputLines.push(...block);
+                            }
+                            // Apply byte truncation (no line limit since we already have match limit)
+                            const rawOutput = outputLines.join("\n");
+                            const truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });
+                            let output = truncation.content;
+                            const details = {};
+                            // Build notices
+                            const notices = [];
+                            if (matchLimitReached) {
+                                notices.push(`${effectiveLimit} matches limit reached. Use limit=${effectiveLimit * 2} for more, or refine pattern`);
+                                details.matchLimitReached = effectiveLimit;
+                            }
+                            if (truncation.truncated) {
+                                notices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);
+                                details.truncation = truncation;
+                            }
+                            if (linesTruncated) {
+                                notices.push(`Some lines truncated to ${GREP_MAX_LINE_LENGTH} chars. Use read tool to see full lines`);
+                                details.linesTruncated = true;
+                            }
+                            if (notices.length > 0) {
+                                output += `\n\n[${notices.join(". ")}]`;
+                            }
+                            settle(() => resolve({
+                                content: [{ type: "text", text: output }],
+                                details: Object.keys(details).length > 0 ? details : undefined,
+                            }));
+                        });
+                    }
+                    catch (err) {
+                        settle(() => reject(err));
+                    }
+                })();
+            });
+        },
+    };
+}
+/** Default grep tool using process.cwd() - for backwards compatibility */
+export const grepTool = createGrepTool(process.cwd());
+//# sourceMappingURL=grep.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grep.js","sourceRoot":"","sources":["../../../src/core/tools/grep.ts"],"names":[],"mappings":"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","sourcesContent":["import { createInterface } from \"node:readline\";\r\nimport type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport { spawn } from \"child_process\";\r\nimport { readFileSync, statSync } from \"fs\";\r\nimport path from \"path\";\r\nimport { ensureTool } from \"../../utils/tools-manager.js\";\r\nimport { resolveToCwd } from \"./path-utils.js\";\r\nimport {\r\n\tDEFAULT_MAX_BYTES,\r\n\tformatSize,\r\n\tGREP_MAX_LINE_LENGTH,\r\n\ttype TruncationResult,\r\n\ttruncateHead,\r\n\ttruncateLine,\r\n} from \"./truncate.js\";\r\n\r\nconst grepSchema = Type.Object({\r\n\tpattern: Type.String({ description: \"Search pattern (regex or literal string)\" }),\r\n\tpath: Type.Optional(Type.String({ description: \"Directory or file to search (default: current directory)\" })),\r\n\tglob: Type.Optional(Type.String({ description: \"Filter files by glob pattern, e.g. '*.ts' or '**/*.spec.ts'\" })),\r\n\tignoreCase: Type.Optional(Type.Boolean({ description: \"Case-insensitive search (default: false)\" })),\r\n\tliteral: Type.Optional(\r\n\t\tType.Boolean({ description: \"Treat pattern as literal string instead of regex (default: false)\" }),\r\n\t),\r\n\tcontext: Type.Optional(\r\n\t\tType.Number({ description: \"Number of lines to show before and after each match (default: 0)\" }),\r\n\t),\r\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of matches to return (default: 100)\" })),\r\n});\r\n\r\nexport type GrepToolInput = Static<typeof grepSchema>;\r\n\r\nconst DEFAULT_LIMIT = 100;\r\n\r\nexport interface GrepToolDetails {\r\n\ttruncation?: TruncationResult;\r\n\tmatchLimitReached?: number;\r\n\tlinesTruncated?: boolean;\r\n}\r\n\r\n/**\r\n * Pluggable operations for the grep tool.\r\n * Override these to delegate search to remote systems (e.g., SSH).\r\n */\r\nexport interface GrepOperations {\r\n\t/** Check if path is a directory. Throws if path doesn't exist. */\r\n\tisDirectory: (absolutePath: string) => Promise<boolean> | boolean;\r\n\t/** Read file contents for context lines */\r\n\treadFile: (absolutePath: string) => Promise<string> | string;\r\n}\r\n\r\nconst defaultGrepOperations: GrepOperations = {\r\n\tisDirectory: (p) => statSync(p).isDirectory(),\r\n\treadFile: (p) => readFileSync(p, \"utf-8\"),\r\n};\r\n\r\nexport interface GrepToolOptions {\r\n\t/** Custom operations for grep. Default: local filesystem + ripgrep */\r\n\toperations?: GrepOperations;\r\n}\r\n\r\nexport function createGrepTool(cwd: string, options?: GrepToolOptions): AgentTool<typeof grepSchema> {\r\n\tconst customOps = options?.operations;\r\n\r\n\treturn {\r\n\t\tname: \"grep\",\r\n\t\tlabel: \"grep\",\r\n\t\tdescription: `Search file contents for a pattern. Returns matching lines with file paths and line numbers. Respects .gitignore. Output is truncated to ${DEFAULT_LIMIT} matches or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Long lines are truncated to ${GREP_MAX_LINE_LENGTH} chars.`,\r\n\t\tparameters: grepSchema,\r\n\t\texecute: async (\r\n\t\t\t_toolCallId: string,\r\n\t\t\t{\r\n\t\t\t\tpattern,\r\n\t\t\t\tpath: searchDir,\r\n\t\t\t\tglob,\r\n\t\t\t\tignoreCase,\r\n\t\t\t\tliteral,\r\n\t\t\t\tcontext,\r\n\t\t\t\tlimit,\r\n\t\t\t}: {\r\n\t\t\t\tpattern: string;\r\n\t\t\t\tpath?: string;\r\n\t\t\t\tglob?: string;\r\n\t\t\t\tignoreCase?: boolean;\r\n\t\t\t\tliteral?: boolean;\r\n\t\t\t\tcontext?: number;\r\n\t\t\t\tlimit?: number;\r\n\t\t\t},\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\tlet settled = false;\r\n\t\t\t\tconst settle = (fn: () => void) => {\r\n\t\t\t\t\tif (!settled) {\r\n\t\t\t\t\t\tsettled = true;\r\n\t\t\t\t\t\tfn();\r\n\t\t\t\t\t}\r\n\t\t\t\t};\r\n\r\n\t\t\t\t(async () => {\r\n\t\t\t\t\ttry {\r\n\t\t\t\t\t\tconst rgPath = await ensureTool(\"rg\", true);\r\n\t\t\t\t\t\tif (!rgPath) {\r\n\t\t\t\t\t\t\tsettle(() => reject(new Error(\"ripgrep (rg) 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\tconst searchPath = resolveToCwd(searchDir || \".\", cwd);\r\n\t\t\t\t\t\tconst ops = customOps ?? defaultGrepOperations;\r\n\r\n\t\t\t\t\t\tlet isDirectory: boolean;\r\n\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\tisDirectory = await ops.isDirectory(searchPath);\r\n\t\t\t\t\t\t} catch (_err) {\r\n\t\t\t\t\t\t\tsettle(() => reject(new Error(`Path not found: ${searchPath}`)));\r\n\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t\tconst contextValue = context && context > 0 ? context : 0;\r\n\t\t\t\t\t\tconst effectiveLimit = Math.max(1, limit ?? DEFAULT_LIMIT);\r\n\r\n\t\t\t\t\t\tconst formatPath = (filePath: string): string => {\r\n\t\t\t\t\t\t\tif (isDirectory) {\r\n\t\t\t\t\t\t\t\tconst relative = path.relative(searchPath, filePath);\r\n\t\t\t\t\t\t\t\tif (relative && !relative.startsWith(\"..\")) {\r\n\t\t\t\t\t\t\t\t\treturn relative.replace(/\\\\/g, \"/\");\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 path.basename(filePath);\r\n\t\t\t\t\t\t};\r\n\r\n\t\t\t\t\t\tconst fileCache = new Map<string, string[]>();\r\n\t\t\t\t\t\tconst getFileLines = async (filePath: string): Promise<string[]> => {\r\n\t\t\t\t\t\t\tlet lines = fileCache.get(filePath);\r\n\t\t\t\t\t\t\tif (!lines) {\r\n\t\t\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\t\t\tconst content = await ops.readFile(filePath);\r\n\t\t\t\t\t\t\t\t\tlines = content.replace(/\\r\\n/g, \"\\n\").replace(/\\r/g, \"\\n\").split(\"\\n\");\r\n\t\t\t\t\t\t\t\t} catch {\r\n\t\t\t\t\t\t\t\t\tlines = [];\r\n\t\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\t\tfileCache.set(filePath, lines);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\treturn lines;\r\n\t\t\t\t\t\t};\r\n\r\n\t\t\t\t\t\tconst args: string[] = [\"--json\", \"--line-number\", \"--color=never\", \"--hidden\"];\r\n\r\n\t\t\t\t\t\tif (ignoreCase) {\r\n\t\t\t\t\t\t\targs.push(\"--ignore-case\");\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (literal) {\r\n\t\t\t\t\t\t\targs.push(\"--fixed-strings\");\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (glob) {\r\n\t\t\t\t\t\t\targs.push(\"--glob\", glob);\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 child = spawn(rgPath, args, { stdio: [\"ignore\", \"pipe\", \"pipe\"] });\r\n\t\t\t\t\t\tconst rl = createInterface({ input: child.stdout });\r\n\t\t\t\t\t\tlet stderr = \"\";\r\n\t\t\t\t\t\tlet matchCount = 0;\r\n\t\t\t\t\t\tlet matchLimitReached = false;\r\n\t\t\t\t\t\tlet linesTruncated = false;\r\n\t\t\t\t\t\tlet aborted = false;\r\n\t\t\t\t\t\tlet killedDueToLimit = false;\r\n\t\t\t\t\t\tconst outputLines: string[] = [];\r\n\r\n\t\t\t\t\t\tconst cleanup = () => {\r\n\t\t\t\t\t\t\trl.close();\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 stopChild = (dueToLimit: boolean = false) => {\r\n\t\t\t\t\t\t\tif (!child.killed) {\r\n\t\t\t\t\t\t\t\tkilledDueToLimit = dueToLimit;\r\n\t\t\t\t\t\t\t\tchild.kill();\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\tconst onAbort = () => {\r\n\t\t\t\t\t\t\taborted = true;\r\n\t\t\t\t\t\t\tstopChild();\r\n\t\t\t\t\t\t};\r\n\r\n\t\t\t\t\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\r\n\r\n\t\t\t\t\t\tchild.stderr?.on(\"data\", (chunk) => {\r\n\t\t\t\t\t\t\tstderr += chunk.toString();\r\n\t\t\t\t\t\t});\r\n\r\n\t\t\t\t\t\tconst formatBlock = async (filePath: string, lineNumber: number): Promise<string[]> => {\r\n\t\t\t\t\t\t\tconst relativePath = formatPath(filePath);\r\n\t\t\t\t\t\t\tconst lines = await getFileLines(filePath);\r\n\t\t\t\t\t\t\tif (!lines.length) {\r\n\t\t\t\t\t\t\t\treturn [`${relativePath}:${lineNumber}: (unable to read file)`];\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tconst block: string[] = [];\r\n\t\t\t\t\t\t\tconst start = contextValue > 0 ? Math.max(1, lineNumber - contextValue) : lineNumber;\r\n\t\t\t\t\t\t\tconst end = contextValue > 0 ? Math.min(lines.length, lineNumber + contextValue) : lineNumber;\r\n\r\n\t\t\t\t\t\t\tfor (let current = start; current <= end; current++) {\r\n\t\t\t\t\t\t\t\tconst lineText = lines[current - 1] ?? \"\";\r\n\t\t\t\t\t\t\t\tconst sanitized = lineText.replace(/\\r/g, \"\");\r\n\t\t\t\t\t\t\t\tconst isMatchLine = current === lineNumber;\r\n\r\n\t\t\t\t\t\t\t\t// Truncate long lines\r\n\t\t\t\t\t\t\t\tconst { text: truncatedText, wasTruncated } = truncateLine(sanitized);\r\n\t\t\t\t\t\t\t\tif (wasTruncated) {\r\n\t\t\t\t\t\t\t\t\tlinesTruncated = true;\r\n\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\tif (isMatchLine) {\r\n\t\t\t\t\t\t\t\t\tblock.push(`${relativePath}:${current}: ${truncatedText}`);\r\n\t\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\t\tblock.push(`${relativePath}-${current}- ${truncatedText}`);\r\n\t\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\treturn block;\r\n\t\t\t\t\t\t};\r\n\r\n\t\t\t\t\t\t// Collect matches during streaming, format after\r\n\t\t\t\t\t\tconst matches: Array<{ filePath: string; lineNumber: number }> = [];\r\n\r\n\t\t\t\t\t\trl.on(\"line\", (line) => {\r\n\t\t\t\t\t\t\tif (!line.trim() || matchCount >= effectiveLimit) {\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\tlet event: any;\r\n\t\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\t\tevent = JSON.parse(line);\r\n\t\t\t\t\t\t\t} catch {\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\tif (event.type === \"match\") {\r\n\t\t\t\t\t\t\t\tmatchCount++;\r\n\t\t\t\t\t\t\t\tconst filePath = event.data?.path?.text;\r\n\t\t\t\t\t\t\t\tconst lineNumber = event.data?.line_number;\r\n\r\n\t\t\t\t\t\t\t\tif (filePath && typeof lineNumber === \"number\") {\r\n\t\t\t\t\t\t\t\t\tmatches.push({ filePath, lineNumber });\r\n\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\tif (matchCount >= effectiveLimit) {\r\n\t\t\t\t\t\t\t\t\tmatchLimitReached = true;\r\n\t\t\t\t\t\t\t\t\tstopChild(true);\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});\r\n\r\n\t\t\t\t\t\tchild.on(\"error\", (error) => {\r\n\t\t\t\t\t\t\tcleanup();\r\n\t\t\t\t\t\t\tsettle(() => reject(new Error(`Failed to run ripgrep: ${error.message}`)));\r\n\t\t\t\t\t\t});\r\n\r\n\t\t\t\t\t\tchild.on(\"close\", async (code) => {\r\n\t\t\t\t\t\t\tcleanup();\r\n\r\n\t\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\t\tsettle(() => reject(new Error(\"Operation aborted\")));\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\tif (!killedDueToLimit && code !== 0 && code !== 1) {\r\n\t\t\t\t\t\t\t\tconst errorMsg = stderr.trim() || `ripgrep exited with code ${code}`;\r\n\t\t\t\t\t\t\t\tsettle(() => reject(new Error(errorMsg)));\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\tif (matchCount === 0) {\r\n\t\t\t\t\t\t\t\tsettle(() =>\r\n\t\t\t\t\t\t\t\t\tresolve({ content: [{ type: \"text\", text: \"No matches found\" }], details: 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// Format matches (async to support remote file reading)\r\n\t\t\t\t\t\t\tfor (const match of matches) {\r\n\t\t\t\t\t\t\t\tconst block = await formatBlock(match.filePath, match.lineNumber);\r\n\t\t\t\t\t\t\t\toutputLines.push(...block);\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t// Apply byte truncation (no line limit since we already have match limit)\r\n\t\t\t\t\t\t\tconst rawOutput = outputLines.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 output = truncation.content;\r\n\t\t\t\t\t\t\tconst details: GrepToolDetails = {};\r\n\r\n\t\t\t\t\t\t\t// Build notices\r\n\t\t\t\t\t\t\tconst notices: string[] = [];\r\n\r\n\t\t\t\t\t\t\tif (matchLimitReached) {\r\n\t\t\t\t\t\t\t\tnotices.push(\r\n\t\t\t\t\t\t\t\t\t`${effectiveLimit} matches limit reached. Use limit=${effectiveLimit * 2} for more, or refine pattern`,\r\n\t\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\t\tdetails.matchLimitReached = 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 (linesTruncated) {\r\n\t\t\t\t\t\t\t\tnotices.push(\r\n\t\t\t\t\t\t\t\t\t`Some lines truncated to ${GREP_MAX_LINE_LENGTH} chars. Use read tool to see full lines`,\r\n\t\t\t\t\t\t\t\t);\r\n\t\t\t\t\t\t\t\tdetails.linesTruncated = true;\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\toutput += `\\n\\n[${notices.join(\". \")}]`;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tsettle(() =>\r\n\t\t\t\t\t\t\t\tresolve({\r\n\t\t\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: output }],\r\n\t\t\t\t\t\t\t\t\tdetails: Object.keys(details).length > 0 ? details : undefined,\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});\r\n\t\t\t\t\t} catch (err) {\r\n\t\t\t\t\t\tsettle(() => reject(err as Error));\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 grep tool using process.cwd() - for backwards compatibility */\r\nexport const grepTool = createGrepTool(process.cwd());\r\n"]}

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

@@ -0,0 +1,102 @@
+export { type BashOperations, type BashSpawnContext, type BashSpawnHook, type BashToolDetails, type BashToolInput, type BashToolOptions, bashTool, createBashTool, } from "./bash.js";
+export { createEditTool, type EditOperations, type EditToolDetails, type EditToolInput, type EditToolOptions, editTool, } from "./edit.js";
+export { createFindTool, type FindOperations, type FindToolDetails, type FindToolInput, type FindToolOptions, findTool, } from "./find.js";
+export { createGrepTool, type GrepOperations, type GrepToolDetails, type GrepToolInput, type GrepToolOptions, grepTool, } from "./grep.js";
+export { createLsTool, type LsOperations, type LsToolDetails, type LsToolInput, type LsToolOptions, lsTool, } from "./ls.js";
+export { type MemoryToolContext, memoryDeleteTool, memoryReadTool, memoryTools, memoryUpdateTool, memoryWriteTool, setMemoryToolContext, } from "./memory.js";
+export { createReadTool, type ReadOperations, type ReadToolDetails, type ReadToolInput, type ReadToolOptions, readTool, } from "./read.js";
+export { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, type TruncationOptions, type TruncationResult, truncateHead, truncateLine, truncateTail, } from "./truncate.js";
+export { createWriteTool, type WriteOperations, type WriteToolInput, type WriteToolOptions, writeTool, } from "./write.js";
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { type BashToolOptions } from "./bash.js";
+import { type ReadToolOptions } from "./read.js";
+/** Tool type (AgentTool from pi-ai) */
+export type Tool = AgentTool<any>;
+export declare const codingTools: Tool[];
+export declare const readOnlyTools: Tool[];
+export declare const allTools: {
+    read: AgentTool<import("@sinclair/typebox").TObject<{
+        path: import("@sinclair/typebox").TString;
+        offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    }>, any>;
+    bash: AgentTool<import("@sinclair/typebox").TObject<{
+        command: import("@sinclair/typebox").TString;
+        timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    }>, any>;
+    edit: AgentTool<import("@sinclair/typebox").TObject<{
+        path: import("@sinclair/typebox").TString;
+        oldText: import("@sinclair/typebox").TString;
+        newText: import("@sinclair/typebox").TString;
+    }>, any>;
+    write: AgentTool<import("@sinclair/typebox").TObject<{
+        path: import("@sinclair/typebox").TString;
+        content: import("@sinclair/typebox").TString;
+    }>, any>;
+    grep: AgentTool<import("@sinclair/typebox").TObject<{
+        pattern: import("@sinclair/typebox").TString;
+        path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        glob: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        ignoreCase: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        literal: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    }>, any>;
+    find: 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>;
+    ls: AgentTool<import("@sinclair/typebox").TObject<{
+        path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    }>, any>;
+    memory_write: AgentTool<import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TUnsafe<"episodic" | "procedural" | "semantic">;
+        name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        trigger: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        steps: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        details: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        category: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnsafe<"architecture" | "convention" | "fact" | "preference">>;
+        text: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        tags: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        reflection_mistakes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        reflection_lessons: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    }>, any>;
+    memory_read: AgentTool<import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnsafe<"all" | "episodic" | "procedural" | "semantic">>;
+        id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        query: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>, any>;
+    memory_update: AgentTool<import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TString;
+        text: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        steps: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        trigger: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        tags: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    }>, any>;
+    memory_delete: AgentTool<import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TString;
+    }>, any>;
+};
+export type ToolName = keyof typeof allTools;
+export interface ToolsOptions {
+    /** Options for the read tool */
+    read?: ReadToolOptions;
+    /** Options for the bash tool */
+    bash?: BashToolOptions;
+}
+/**
+ * Create coding tools configured for a specific working directory.
+ */
+export declare function createCodingTools(cwd: string, options?: ToolsOptions): Tool[];
+/**
+ * Create read-only tools configured for a specific working directory.
+ */
+export declare function createReadOnlyTools(cwd: string, options?: ToolsOptions): Tool[];
+/**
+ * Create all tools configured for a specific working directory.
+ */
+export declare function createAllTools(cwd: string, 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,EACN,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,QAAQ,EACR,cAAc,GACd,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,QAAQ,GACR,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,QAAQ,GACR,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,QAAQ,GACR,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,MAAM,GACN,MAAM,SAAS,CAAC;AACjB,OAAO,EACN,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,oBAAoB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,QAAQ,GACR,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,YAAY,EACZ,YAAY,EACZ,YAAY,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,SAAS,GACT,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,KAAK,eAAe,EAA4B,MAAM,WAAW,CAAC;AAM3E,OAAO,EAAkB,KAAK,eAAe,EAAY,MAAM,WAAW,CAAC;AAG3E,uCAAuC;AACvC,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;AAGlC,eAAO,MAAM,WAAW,EAAE,IAAI,EAA8C,CAAC;AAG7E,eAAO,MAAM,aAAa,EAAE,IAAI,EAA2C,CAAC;AAG5E,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYpB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,QAAQ,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC5B,gCAAgC;IAChC,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,gCAAgC;IAChC,IAAI,CAAC,EAAE,eAAe,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,EAAE,CAO7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,EAAE,CAE/E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAc1F","sourcesContent":["export {\r\n\ttype BashOperations,\r\n\ttype BashSpawnContext,\r\n\ttype BashSpawnHook,\r\n\ttype BashToolDetails,\r\n\ttype BashToolInput,\r\n\ttype BashToolOptions,\r\n\tbashTool,\r\n\tcreateBashTool,\r\n} from \"./bash.js\";\r\nexport {\r\n\tcreateEditTool,\r\n\ttype EditOperations,\r\n\ttype EditToolDetails,\r\n\ttype EditToolInput,\r\n\ttype EditToolOptions,\r\n\teditTool,\r\n} from \"./edit.js\";\r\nexport {\r\n\tcreateFindTool,\r\n\ttype FindOperations,\r\n\ttype FindToolDetails,\r\n\ttype FindToolInput,\r\n\ttype FindToolOptions,\r\n\tfindTool,\r\n} from \"./find.js\";\r\nexport {\r\n\tcreateGrepTool,\r\n\ttype GrepOperations,\r\n\ttype GrepToolDetails,\r\n\ttype GrepToolInput,\r\n\ttype GrepToolOptions,\r\n\tgrepTool,\r\n} from \"./grep.js\";\r\nexport {\r\n\tcreateLsTool,\r\n\ttype LsOperations,\r\n\ttype LsToolDetails,\r\n\ttype LsToolInput,\r\n\ttype LsToolOptions,\r\n\tlsTool,\r\n} from \"./ls.js\";\r\nexport {\r\n\ttype MemoryToolContext,\r\n\tmemoryDeleteTool,\r\n\tmemoryReadTool,\r\n\tmemoryTools,\r\n\tmemoryUpdateTool,\r\n\tmemoryWriteTool,\r\n\tsetMemoryToolContext,\r\n} from \"./memory.js\";\r\nexport {\r\n\tcreateReadTool,\r\n\ttype ReadOperations,\r\n\ttype ReadToolDetails,\r\n\ttype ReadToolInput,\r\n\ttype ReadToolOptions,\r\n\treadTool,\r\n} from \"./read.js\";\r\nexport {\r\n\tDEFAULT_MAX_BYTES,\r\n\tDEFAULT_MAX_LINES,\r\n\tformatSize,\r\n\ttype TruncationOptions,\r\n\ttype TruncationResult,\r\n\ttruncateHead,\r\n\ttruncateLine,\r\n\ttruncateTail,\r\n} from \"./truncate.js\";\r\nexport {\r\n\tcreateWriteTool,\r\n\ttype WriteOperations,\r\n\ttype WriteToolInput,\r\n\ttype WriteToolOptions,\r\n\twriteTool,\r\n} from \"./write.js\";\r\n\r\nimport type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { type BashToolOptions, bashTool, createBashTool } from \"./bash.js\";\r\nimport { createEditTool, editTool } from \"./edit.js\";\r\nimport { createFindTool, findTool } from \"./find.js\";\r\nimport { createGrepTool, grepTool } from \"./grep.js\";\r\nimport { createLsTool, lsTool } from \"./ls.js\";\r\nimport { memoryDeleteTool, memoryReadTool, memoryUpdateTool, memoryWriteTool } from \"./memory.js\";\r\nimport { createReadTool, type ReadToolOptions, readTool } from \"./read.js\";\r\nimport { createWriteTool, writeTool } from \"./write.js\";\r\n\r\n/** Tool type (AgentTool from pi-ai) */\r\nexport type Tool = AgentTool<any>;\r\n\r\n// Default tools for full access mode (using process.cwd())\r\nexport const codingTools: Tool[] = [readTool, bashTool, editTool, writeTool];\r\n\r\n// Read-only tools for exploration without modification (using process.cwd())\r\nexport const readOnlyTools: Tool[] = [readTool, grepTool, findTool, lsTool];\r\n\r\n// All available tools (using process.cwd())\r\nexport const allTools = {\r\n\tread: readTool,\r\n\tbash: bashTool,\r\n\tedit: editTool,\r\n\twrite: writeTool,\r\n\tgrep: grepTool,\r\n\tfind: findTool,\r\n\tls: lsTool,\r\n\tmemory_write: memoryWriteTool,\r\n\tmemory_read: memoryReadTool,\r\n\tmemory_update: memoryUpdateTool,\r\n\tmemory_delete: memoryDeleteTool,\r\n};\r\n\r\nexport type ToolName = keyof typeof allTools;\r\n\r\nexport interface ToolsOptions {\r\n\t/** Options for the read tool */\r\n\tread?: ReadToolOptions;\r\n\t/** Options for the bash tool */\r\n\tbash?: BashToolOptions;\r\n}\r\n\r\n/**\r\n * Create coding tools configured for a specific working directory.\r\n */\r\nexport function createCodingTools(cwd: string, options?: ToolsOptions): Tool[] {\r\n\treturn [\r\n\t\tcreateReadTool(cwd, options?.read),\r\n\t\tcreateBashTool(cwd, options?.bash),\r\n\t\tcreateEditTool(cwd),\r\n\t\tcreateWriteTool(cwd),\r\n\t];\r\n}\r\n\r\n/**\r\n * Create read-only tools configured for a specific working directory.\r\n */\r\nexport function createReadOnlyTools(cwd: string, options?: ToolsOptions): Tool[] {\r\n\treturn [createReadTool(cwd, options?.read), createGrepTool(cwd), createFindTool(cwd), createLsTool(cwd)];\r\n}\r\n\r\n/**\r\n * Create all tools configured for a specific working directory.\r\n */\r\nexport function createAllTools(cwd: string, options?: ToolsOptions): Record<ToolName, Tool> {\r\n\treturn {\r\n\t\tread: createReadTool(cwd, options?.read),\r\n\t\tbash: createBashTool(cwd, options?.bash),\r\n\t\tedit: createEditTool(cwd),\r\n\t\twrite: createWriteTool(cwd),\r\n\t\tgrep: createGrepTool(cwd),\r\n\t\tfind: createFindTool(cwd),\r\n\t\tls: createLsTool(cwd),\r\n\t\tmemory_write: memoryWriteTool,\r\n\t\tmemory_read: memoryReadTool,\r\n\t\tmemory_update: memoryUpdateTool,\r\n\t\tmemory_delete: memoryDeleteTool,\r\n\t};\r\n}\r\n"]}

package/dist/core/tools/index.js

@@ -0,0 +1,71 @@
+export { bashTool, createBashTool, } from "./bash.js";
+export { createEditTool, editTool, } from "./edit.js";
+export { createFindTool, findTool, } from "./find.js";
+export { createGrepTool, grepTool, } from "./grep.js";
+export { createLsTool, lsTool, } from "./ls.js";
+export { memoryDeleteTool, memoryReadTool, memoryTools, memoryUpdateTool, memoryWriteTool, setMemoryToolContext, } from "./memory.js";
+export { createReadTool, readTool, } from "./read.js";
+export { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, truncateHead, truncateLine, truncateTail, } from "./truncate.js";
+export { createWriteTool, writeTool, } from "./write.js";
+import { bashTool, createBashTool } from "./bash.js";
+import { createEditTool, editTool } from "./edit.js";
+import { createFindTool, findTool } from "./find.js";
+import { createGrepTool, grepTool } from "./grep.js";
+import { createLsTool, lsTool } from "./ls.js";
+import { memoryDeleteTool, memoryReadTool, memoryUpdateTool, memoryWriteTool } from "./memory.js";
+import { createReadTool, readTool } from "./read.js";
+import { createWriteTool, writeTool } from "./write.js";
+// Default tools for full access mode (using process.cwd())
+export const codingTools = [readTool, bashTool, editTool, writeTool];
+// Read-only tools for exploration without modification (using process.cwd())
+export const readOnlyTools = [readTool, grepTool, findTool, lsTool];
+// All available tools (using process.cwd())
+export const allTools = {
+    read: readTool,
+    bash: bashTool,
+    edit: editTool,
+    write: writeTool,
+    grep: grepTool,
+    find: findTool,
+    ls: lsTool,
+    memory_write: memoryWriteTool,
+    memory_read: memoryReadTool,
+    memory_update: memoryUpdateTool,
+    memory_delete: memoryDeleteTool,
+};
+/**
+ * Create coding tools configured for a specific working directory.
+ */
+export function createCodingTools(cwd, options) {
+    return [
+        createReadTool(cwd, options?.read),
+        createBashTool(cwd, options?.bash),
+        createEditTool(cwd),
+        createWriteTool(cwd),
+    ];
+}
+/**
+ * Create read-only tools configured for a specific working directory.
+ */
+export function createReadOnlyTools(cwd, options) {
+    return [createReadTool(cwd, options?.read), createGrepTool(cwd), createFindTool(cwd), createLsTool(cwd)];
+}
+/**
+ * Create all tools configured for a specific working directory.
+ */
+export function createAllTools(cwd, options) {
+    return {
+        read: createReadTool(cwd, options?.read),
+        bash: createBashTool(cwd, options?.bash),
+        edit: createEditTool(cwd),
+        write: createWriteTool(cwd),
+        grep: createGrepTool(cwd),
+        find: createFindTool(cwd),
+        ls: createLsTool(cwd),
+        memory_write: memoryWriteTool,
+        memory_read: memoryReadTool,
+        memory_update: memoryUpdateTool,
+        memory_delete: memoryDeleteTool,
+    };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/tools/index.ts"],"names":[],"mappings":"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","sourcesContent":["export {\r\n\ttype BashOperations,\r\n\ttype BashSpawnContext,\r\n\ttype BashSpawnHook,\r\n\ttype BashToolDetails,\r\n\ttype BashToolInput,\r\n\ttype BashToolOptions,\r\n\tbashTool,\r\n\tcreateBashTool,\r\n} from \"./bash.js\";\r\nexport {\r\n\tcreateEditTool,\r\n\ttype EditOperations,\r\n\ttype EditToolDetails,\r\n\ttype EditToolInput,\r\n\ttype EditToolOptions,\r\n\teditTool,\r\n} from \"./edit.js\";\r\nexport {\r\n\tcreateFindTool,\r\n\ttype FindOperations,\r\n\ttype FindToolDetails,\r\n\ttype FindToolInput,\r\n\ttype FindToolOptions,\r\n\tfindTool,\r\n} from \"./find.js\";\r\nexport {\r\n\tcreateGrepTool,\r\n\ttype GrepOperations,\r\n\ttype GrepToolDetails,\r\n\ttype GrepToolInput,\r\n\ttype GrepToolOptions,\r\n\tgrepTool,\r\n} from \"./grep.js\";\r\nexport {\r\n\tcreateLsTool,\r\n\ttype LsOperations,\r\n\ttype LsToolDetails,\r\n\ttype LsToolInput,\r\n\ttype LsToolOptions,\r\n\tlsTool,\r\n} from \"./ls.js\";\r\nexport {\r\n\ttype MemoryToolContext,\r\n\tmemoryDeleteTool,\r\n\tmemoryReadTool,\r\n\tmemoryTools,\r\n\tmemoryUpdateTool,\r\n\tmemoryWriteTool,\r\n\tsetMemoryToolContext,\r\n} from \"./memory.js\";\r\nexport {\r\n\tcreateReadTool,\r\n\ttype ReadOperations,\r\n\ttype ReadToolDetails,\r\n\ttype ReadToolInput,\r\n\ttype ReadToolOptions,\r\n\treadTool,\r\n} from \"./read.js\";\r\nexport {\r\n\tDEFAULT_MAX_BYTES,\r\n\tDEFAULT_MAX_LINES,\r\n\tformatSize,\r\n\ttype TruncationOptions,\r\n\ttype TruncationResult,\r\n\ttruncateHead,\r\n\ttruncateLine,\r\n\ttruncateTail,\r\n} from \"./truncate.js\";\r\nexport {\r\n\tcreateWriteTool,\r\n\ttype WriteOperations,\r\n\ttype WriteToolInput,\r\n\ttype WriteToolOptions,\r\n\twriteTool,\r\n} from \"./write.js\";\r\n\r\nimport type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { type BashToolOptions, bashTool, createBashTool } from \"./bash.js\";\r\nimport { createEditTool, editTool } from \"./edit.js\";\r\nimport { createFindTool, findTool } from \"./find.js\";\r\nimport { createGrepTool, grepTool } from \"./grep.js\";\r\nimport { createLsTool, lsTool } from \"./ls.js\";\r\nimport { memoryDeleteTool, memoryReadTool, memoryUpdateTool, memoryWriteTool } from \"./memory.js\";\r\nimport { createReadTool, type ReadToolOptions, readTool } from \"./read.js\";\r\nimport { createWriteTool, writeTool } from \"./write.js\";\r\n\r\n/** Tool type (AgentTool from pi-ai) */\r\nexport type Tool = AgentTool<any>;\r\n\r\n// Default tools for full access mode (using process.cwd())\r\nexport const codingTools: Tool[] = [readTool, bashTool, editTool, writeTool];\r\n\r\n// Read-only tools for exploration without modification (using process.cwd())\r\nexport const readOnlyTools: Tool[] = [readTool, grepTool, findTool, lsTool];\r\n\r\n// All available tools (using process.cwd())\r\nexport const allTools = {\r\n\tread: readTool,\r\n\tbash: bashTool,\r\n\tedit: editTool,\r\n\twrite: writeTool,\r\n\tgrep: grepTool,\r\n\tfind: findTool,\r\n\tls: lsTool,\r\n\tmemory_write: memoryWriteTool,\r\n\tmemory_read: memoryReadTool,\r\n\tmemory_update: memoryUpdateTool,\r\n\tmemory_delete: memoryDeleteTool,\r\n};\r\n\r\nexport type ToolName = keyof typeof allTools;\r\n\r\nexport interface ToolsOptions {\r\n\t/** Options for the read tool */\r\n\tread?: ReadToolOptions;\r\n\t/** Options for the bash tool */\r\n\tbash?: BashToolOptions;\r\n}\r\n\r\n/**\r\n * Create coding tools configured for a specific working directory.\r\n */\r\nexport function createCodingTools(cwd: string, options?: ToolsOptions): Tool[] {\r\n\treturn [\r\n\t\tcreateReadTool(cwd, options?.read),\r\n\t\tcreateBashTool(cwd, options?.bash),\r\n\t\tcreateEditTool(cwd),\r\n\t\tcreateWriteTool(cwd),\r\n\t];\r\n}\r\n\r\n/**\r\n * Create read-only tools configured for a specific working directory.\r\n */\r\nexport function createReadOnlyTools(cwd: string, options?: ToolsOptions): Tool[] {\r\n\treturn [createReadTool(cwd, options?.read), createGrepTool(cwd), createFindTool(cwd), createLsTool(cwd)];\r\n}\r\n\r\n/**\r\n * Create all tools configured for a specific working directory.\r\n */\r\nexport function createAllTools(cwd: string, options?: ToolsOptions): Record<ToolName, Tool> {\r\n\treturn {\r\n\t\tread: createReadTool(cwd, options?.read),\r\n\t\tbash: createBashTool(cwd, options?.bash),\r\n\t\tedit: createEditTool(cwd),\r\n\t\twrite: createWriteTool(cwd),\r\n\t\tgrep: createGrepTool(cwd),\r\n\t\tfind: createFindTool(cwd),\r\n\t\tls: createLsTool(cwd),\r\n\t\tmemory_write: memoryWriteTool,\r\n\t\tmemory_read: memoryReadTool,\r\n\t\tmemory_update: memoryUpdateTool,\r\n\t\tmemory_delete: memoryDeleteTool,\r\n\t};\r\n}\r\n"]}

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

@@ -0,0 +1,40 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { type Static } from "@sinclair/typebox";
+import { type TruncationResult } from "./truncate.js";
+declare const lsSchema: import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type LsToolInput = Static<typeof lsSchema>;
+export interface LsToolDetails {
+    truncation?: TruncationResult;
+    entryLimitReached?: number;
+}
+/**
+ * Pluggable operations for the ls tool.
+ * Override these to delegate directory listing to remote systems (e.g., SSH).
+ */
+export interface LsOperations {
+    /** Check if path exists */
+    exists: (absolutePath: string) => Promise<boolean> | boolean;
+    /** Get file/directory stats. Throws if not found. */
+    stat: (absolutePath: string) => Promise<{
+        isDirectory: () => boolean;
+    }> | {
+        isDirectory: () => boolean;
+    };
+    /** Read directory entries */
+    readdir: (absolutePath: string) => Promise<string[]> | string[];
+}
+export interface LsToolOptions {
+    /** Custom operations for directory listing. Default: local filesystem */
+    operations?: LsOperations;
+}
+export declare function createLsTool(cwd: string, options?: LsToolOptions): AgentTool<typeof lsSchema>;
+/** Default ls tool using process.cwd() - for backwards compatibility */
+export declare const lsTool: AgentTool<import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, any>;
+export {};
+//# sourceMappingURL=ls.d.ts.map