@openharness/core 0.4.4 → 0.5.0

package/dist/tools/create-fs-tools.js

@@ -0,0 +1,361 @@
+import { tool } from "ai";
+import { z } from "zod";
+// ── Defaults ────────────────────────────────────────────────────────
+const DEFAULT_MAX_OUTPUT_BYTES = 50 * 1024; // 50 KB
+const DEFAULT_MAX_LINES = 2000;
+const DEFAULT_MAX_LINE_LENGTH = 2000;
+// Binary file extensions that should never be read as text
+const BINARY_EXTENSIONS = new Set([
+    ".zip",
+    ".tar",
+    ".gz",
+    ".bz2",
+    ".xz",
+    ".7z",
+    ".rar",
+    ".exe",
+    ".dll",
+    ".so",
+    ".dylib",
+    ".bin",
+    ".obj",
+    ".o",
+    ".a",
+    ".lib",
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".bmp",
+    ".ico",
+    ".webp",
+    ".tiff",
+    ".tif",
+    ".mp3",
+    ".mp4",
+    ".avi",
+    ".mov",
+    ".wav",
+    ".flac",
+    ".ogg",
+    ".webm",
+    ".mkv",
+    ".pdf",
+    ".wasm",
+    ".class",
+    ".jar",
+    ".pyc",
+    ".pyd",
+    ".pyo",
+    ".whl",
+    ".egg",
+    ".ttf",
+    ".otf",
+    ".woff",
+    ".woff2",
+    ".eot",
+    ".sqlite",
+    ".db",
+    ".DS_Store",
+]);
+export function createFsTools(fs, options) {
+    const maxOutputBytes = options?.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES;
+    const maxLines = options?.maxLines ?? DEFAULT_MAX_LINES;
+    const maxLineLength = options?.maxLineLength ?? DEFAULT_MAX_LINE_LENGTH;
+    // ── readFile ────────────────────────────────────────────────────
+    const readFile = tool({
+        description: "Read the contents of a file. Returns the text content with line numbers. " +
+            "For large files, use offset and limit to read specific line ranges.",
+        inputSchema: z.object({
+            filePath: z.string().describe("Absolute or relative path to the file"),
+            offset: z
+                .number()
+                .int()
+                .min(1)
+                .optional()
+                .describe("1-based line number to start reading from"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .optional()
+                .describe(`Maximum number of lines to return (default ${DEFAULT_MAX_LINES})`),
+        }),
+        execute: async ({ filePath, offset, limit }) => {
+            const resolved = fs.resolvePath(filePath);
+            // Binary check by extension
+            if (isBinaryPath(resolved)) {
+                return { error: `Cannot read binary file: ${resolved}` };
+            }
+            let content;
+            try {
+                content = await fs.readFile(resolved);
+            }
+            catch (error) {
+                if (error && typeof error === "object" && "name" in error && error.name === "FileTooLargeError") {
+                    return { error: error.message };
+                }
+                throw error;
+            }
+            const allLines = content.split("\n");
+            const totalLines = allLines.length;
+            const lineLimit = limit ?? maxLines;
+            const start = (offset ?? 1) - 1; // convert 1-based to 0-based
+            if (start > 0 && start >= totalLines) {
+                return {
+                    error: `Offset ${offset} is out of range (file has ${totalLines} lines)`,
+                    filePath: resolved,
+                };
+            }
+            const end = Math.min(start + lineLimit, totalLines);
+            const slice = allLines.slice(start, end);
+            // Truncate long lines and cap total bytes
+            let totalBytes = 0;
+            let truncatedByBytes = false;
+            const outputLines = [];
+            for (let i = 0; i < slice.length; i++) {
+                let line = slice[i];
+                if (line.length > maxLineLength) {
+                    line = line.slice(0, maxLineLength) + `... (line truncated at ${maxLineLength} chars)`;
+                }
+                const lineBytes = Buffer.byteLength(line, "utf-8");
+                if (totalBytes + lineBytes > maxOutputBytes) {
+                    truncatedByBytes = true;
+                    break;
+                }
+                totalBytes += lineBytes;
+                outputLines.push(`${start + i + 1}: ${line}`);
+            }
+            const lastLine = start + outputLines.length;
+            const hasMore = lastLine < totalLines;
+            let status;
+            if (truncatedByBytes) {
+                status =
+                    `Output capped at ${Math.round(maxOutputBytes / 1024)} KB. ` +
+                        `Showing lines ${start + 1}-${lastLine} of ${totalLines}. ` +
+                        `Use offset=${lastLine + 1} to continue.`;
+            }
+            else if (hasMore) {
+                status =
+                    `Showing lines ${start + 1}-${lastLine} of ${totalLines}. ` +
+                        `Use offset=${lastLine + 1} to continue.`;
+            }
+            else {
+                status = `End of file — ${totalLines} lines total.`;
+            }
+            return {
+                filePath: resolved,
+                totalLines,
+                fromLine: start + 1,
+                toLine: lastLine,
+                status,
+                content: outputLines.join("\n"),
+            };
+        },
+    });
+    // ── writeFile ───────────────────────────────────────────────────
+    const writeFile = tool({
+        description: "Write content to a file. Creates the file (and parent directories) " +
+            "if they don't exist, or overwrites the existing file.",
+        inputSchema: z.object({
+            filePath: z.string().describe("Absolute or relative path to the file"),
+            content: z.string().describe("The full content to write"),
+        }),
+        execute: async ({ filePath, content }) => {
+            const resolved = fs.resolvePath(filePath);
+            await fs.mkdir(dirname(resolved), { recursive: true });
+            await fs.writeFile(resolved, content);
+            return { filePath: resolved, bytesWritten: Buffer.byteLength(content) };
+        },
+    });
+    // ── editFile ────────────────────────────────────────────────────
+    const editFile = tool({
+        description: "Edit a file by replacing exact string matches. The oldString must " +
+            "appear in the file. Set replaceAll to true to replace every occurrence.",
+        inputSchema: z.object({
+            filePath: z.string().describe("Absolute or relative path to the file"),
+            oldString: z.string().describe("The exact text to find"),
+            newString: z.string().describe("The replacement text"),
+            replaceAll: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Replace all occurrences instead of just the first"),
+        }),
+        execute: async ({ filePath, oldString, newString, replaceAll }) => {
+            const resolved = fs.resolvePath(filePath);
+            const content = await fs.readFile(resolved);
+            if (!content.includes(oldString)) {
+                return { error: "oldString not found in file", filePath: resolved };
+            }
+            const updated = replaceAll ? content.replaceAll(oldString, newString) : content.replace(oldString, newString);
+            await fs.writeFile(resolved, updated);
+            const occurrences = content.split(oldString).length - 1;
+            const replacements = replaceAll ? occurrences : 1;
+            return { filePath: resolved, replacements };
+        },
+    });
+    // ── listFiles ───────────────────────────────────────────────────
+    const listFiles = tool({
+        description: "List files and directories at the given path. " + "Set recursive to true to walk subdirectories.",
+        inputSchema: z.object({
+            dirPath: z
+                .string()
+                .optional()
+                .default(".")
+                .describe("Directory path to list (defaults to cwd)"),
+            recursive: z.boolean().optional().default(false).describe("Recursively list all entries"),
+        }),
+        execute: async ({ dirPath, recursive }) => {
+            const resolved = fs.resolvePath(dirPath);
+            let items;
+            if (recursive) {
+                const walked = await walkDir(fs, resolved, resolved);
+                items = walked.map((entry) => ({
+                    name: entry.relativePath,
+                    type: entry.isDirectory ? "directory" : "file",
+                }));
+            }
+            else {
+                const entries = await fs.readdir(resolved);
+                items = entries.map((e) => ({
+                    name: e.name,
+                    type: e.isDirectory ? "directory" : "file",
+                }));
+            }
+            return { dirPath: resolved, count: items.length, entries: items };
+        },
+    });
+    // ── grep ────────────────────────────────────────────────────────
+    const grep = tool({
+        description: "Search file contents with a regex pattern. Searches recursively " +
+            "from the given directory, skipping node_modules and .git. " +
+            "Returns matching lines with file paths and line numbers.",
+        inputSchema: z.object({
+            pattern: z.string().describe("Regex pattern to search for"),
+            dirPath: z
+                .string()
+                .optional()
+                .default(".")
+                .describe("Root directory to search from (defaults to cwd)"),
+            glob: z
+                .string()
+                .optional()
+                .describe("Only search files matching this glob suffix (e.g. '.ts')"),
+            ignoreCase: z.boolean().optional().default(false).describe("Case-insensitive matching"),
+        }),
+        execute: async ({ pattern, dirPath, glob: fileSuffix, ignoreCase }) => {
+            const resolved = fs.resolvePath(dirPath);
+            const regex = new RegExp(pattern, ignoreCase ? "i" : undefined);
+            const allFiles = await walkFiles(fs, resolved);
+            const files = fileSuffix ? allFiles.filter((f) => f.endsWith(fileSuffix)) : allFiles;
+            const matches = [];
+            for (const file of files) {
+                let content;
+                try {
+                    content = await fs.readFile(file);
+                }
+                catch {
+                    continue; // skip binary / unreadable / too-large files
+                }
+                const lines = content.split("\n");
+                for (let i = 0; i < lines.length; i++) {
+                    if (regex.test(lines[i])) {
+                        matches.push({
+                            file: relativePath(resolved, file),
+                            line: i + 1,
+                            content: lines[i],
+                        });
+                    }
+                }
+            }
+            return { dirPath: resolved, pattern, matchCount: matches.length, matches };
+        },
+    });
+    // ── deleteFile ──────────────────────────────────────────────────
+    const deleteFile = tool({
+        description: "Delete a file or directory. For directories, set recursive to true.",
+        inputSchema: z.object({
+            filePath: z.string().describe("Path to the file or directory to delete"),
+            recursive: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Recursively delete directory contents"),
+        }),
+        execute: async ({ filePath, recursive }) => {
+            const resolved = fs.resolvePath(filePath);
+            const stat = await fs.stat(resolved);
+            if (stat.isDirectory && !recursive) {
+                return {
+                    error: "Path is a directory. Set recursive to true to delete it.",
+                    filePath: resolved,
+                };
+            }
+            await fs.remove(resolved, { recursive });
+            return { deleted: resolved };
+        },
+    });
+    return { readFile, writeFile, editFile, listFiles, grep, deleteFile };
+}
+// ── Helpers ─────────────────────────────────────────────────────────
+const SKIP_DIRS = new Set(["node_modules", ".git"]);
+/** Recursively walk a directory, returning all entries with relative paths. */
+async function walkDir(fs, root, dir) {
+    const entries = await fs.readdir(dir);
+    const results = [];
+    for (const entry of entries) {
+        const absPath = joinPath(dir, entry.name);
+        const relPath = relativePath(root, absPath);
+        results.push({ relativePath: relPath, absolutePath: absPath, isDirectory: entry.isDirectory });
+        if (entry.isDirectory && !SKIP_DIRS.has(entry.name)) {
+            results.push(...(await walkDir(fs, root, absPath)));
+        }
+    }
+    return results;
+}
+/** Recursively walk a directory, returning absolute paths of files only. Skips node_modules and .git. */
+async function walkFiles(fs, dir) {
+    const entries = await fs.readdir(dir);
+    const files = [];
+    for (const entry of entries) {
+        const full = joinPath(dir, entry.name);
+        if (entry.isDirectory) {
+            if (!SKIP_DIRS.has(entry.name)) {
+                files.push(...(await walkFiles(fs, full)));
+            }
+        }
+        else {
+            files.push(full);
+        }
+    }
+    return files;
+}
+function isBinaryPath(filePath) {
+    const lastDot = filePath.lastIndexOf(".");
+    if (lastDot === -1)
+        return false;
+    return BINARY_EXTENSIONS.has(filePath.slice(lastDot).toLowerCase());
+}
+/** Simple path join that works with forward slashes. */
+function joinPath(base, name) {
+    if (base.endsWith("/"))
+        return base + name;
+    return base + "/" + name;
+}
+/** Compute a relative path from root to target. */
+function relativePath(root, target) {
+    const normalizedRoot = root.endsWith("/") ? root : root + "/";
+    if (target.startsWith(normalizedRoot)) {
+        return target.slice(normalizedRoot.length);
+    }
+    return target;
+}
+/** Extract directory portion of a path. */
+function dirname(filePath) {
+    const lastSlash = filePath.lastIndexOf("/");
+    if (lastSlash === -1)
+        return ".";
+    return filePath.slice(0, lastSlash);
+}
+//# sourceMappingURL=create-fs-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-fs-tools.js","sourceRoot":"","sources":["../../src/tools/create-fs-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,uEAAuE;AAEvE,MAAM,wBAAwB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,QAAQ;AACpD,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC,2DAA2D;AAC3D,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,QAAQ;IACR,MAAM;IACN,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,MAAM;IACN,SAAS;IACT,KAAK;IACL,WAAW;CACZ,CAAC,CAAC;AAWH,MAAM,UAAU,aAAa,CAAC,EAAc,EAAE,OAA8B;IAC1E,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,wBAAwB,CAAC;IAC3E,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,iBAAiB,CAAC;IACxD,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,uBAAuB,CAAC;IAExE,mEAAmE;IAEnE,MAAM,QAAQ,GAAG,IAAI,CAAC;QACpB,WAAW,EACT,2EAA2E;YAC3E,qEAAqE;QACvE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACtE,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,2CAA2C,CAAC;YACxD,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,8CAA8C,iBAAiB,GAAG,CAAC;SAChF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;YAC7C,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAE1C,4BAA4B;YAC5B,IAAI,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,OAAO,EAAE,KAAK,EAAE,4BAA4B,QAAQ,EAAE,EAAE,CAAC;YAC3D,CAAC;YAED,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;oBAChG,OAAO,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;gBAC7C,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;YACnC,MAAM,SAAS,GAAG,KAAK,IAAI,QAAQ,CAAC;YACpC,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,6BAA6B;YAE9D,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;gBACrC,OAAO;oBACL,KAAK,EAAE,UAAU,MAAM,8BAA8B,UAAU,SAAS;oBACxE,QAAQ,EAAE,QAAQ;iBACnB,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,SAAS,EAAE,UAAU,CAAC,CAAC;YACpD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAEzC,0CAA0C;YAC1C,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,gBAAgB,GAAG,KAAK,CAAC;YAC7B,MAAM,WAAW,GAAa,EAAE,CAAC;YAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACpB,IAAI,IAAI,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;oBAChC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,0BAA0B,aAAa,SAAS,CAAC;gBACzF,CAAC;gBAED,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACnD,IAAI,UAAU,GAAG,SAAS,GAAG,cAAc,EAAE,CAAC;oBAC5C,gBAAgB,GAAG,IAAI,CAAC;oBACxB,MAAM;gBACR,CAAC;gBAED,UAAU,IAAI,SAAS,CAAC;gBACxB,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAChD,CAAC;YAED,MAAM,QAAQ,GAAG,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;YAC5C,MAAM,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;YAEtC,IAAI,MAAc,CAAC;YACnB,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM;oBACJ,oBAAoB,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,OAAO;wBAC5D,iBAAiB,KAAK,GAAG,CAAC,IAAI,QAAQ,OAAO,UAAU,IAAI;wBAC3D,cAAc,QAAQ,GAAG,CAAC,eAAe,CAAC;YAC9C,CAAC;iBAAM,IAAI,OAAO,EAAE,CAAC;gBACnB,MAAM;oBACJ,iBAAiB,KAAK,GAAG,CAAC,IAAI,QAAQ,OAAO,UAAU,IAAI;wBAC3D,cAAc,QAAQ,GAAG,CAAC,eAAe,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,iBAAiB,UAAU,eAAe,CAAC;YACtD,CAAC;YAED,OAAO;gBACL,QAAQ,EAAE,QAAQ;gBAClB,UAAU;gBACV,QAAQ,EAAE,KAAK,GAAG,CAAC;gBACnB,MAAM,EAAE,QAAQ;gBAChB,MAAM;gBACN,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;aAChC,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,mEAAmE;IAEnE,MAAM,SAAS,GAAG,IAAI,CAAC;QACrB,WAAW,EACT,qEAAqE;YACrE,uDAAuD;QACzD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACtE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;SAC1D,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;YACvC,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1E,CAAC;KACF,CAAC,CAAC;IAEH,mEAAmE;IAEnE,MAAM,QAAQ,GAAG,IAAI,CAAC;QACpB,WAAW,EACT,oEAAoE;YACpE,yEAAyE;QAC3E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACtE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YACxD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACtD,UAAU,EAAE,CAAC;iBACV,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,mDAAmD,CAAC;SACjE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE;YAChE,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAE5C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACjC,OAAO,EAAE,KAAK,EAAE,6BAA6B,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;YACtE,CAAC;YAED,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC9G,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAEtC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YACxD,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YAElD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;QAC9C,CAAC;KACF,CAAC,CAAC;IAEH,mEAAmE;IAEnE,MAAM,SAAS,GAAG,IAAI,CAAC;QACrB,WAAW,EAAE,gDAAgD,GAAG,+CAA+C;QAC/G,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,GAAG,CAAC;iBACZ,QAAQ,CAAC,0CAA0C,CAAC;YACvD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;SAC1F,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;YACxC,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,KAAqD,CAAC;YAE1D,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACrD,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBAC7B,IAAI,EAAE,KAAK,CAAC,YAAY;oBACxB,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAE,WAAqB,CAAC,CAAC,CAAE,MAAgB;iBACrE,CAAC,CAAC,CAAC;YACN,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC3C,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAE,WAAqB,CAAC,CAAC,CAAE,MAAgB;iBACjE,CAAC,CAAC,CAAC;YACN,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACpE,CAAC;KACF,CAAC,CAAC;IAEH,mEAAmE;IAEnE,MAAM,IAAI,GAAG,IAAI,CAAC;QAChB,WAAW,EACT,kEAAkE;YAClE,4DAA4D;YAC5D,0DAA0D;QAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YAC3D,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,GAAG,CAAC;iBACZ,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,0DAA0D,CAAC;YACvE,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;SACxF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE;YACpE,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAChE,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAE/C,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAErF,MAAM,OAAO,GAAsD,EAAE,CAAC;YAEtE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,OAAe,CAAC;gBACpB,IAAI,CAAC;oBACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACpC,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS,CAAC,6CAA6C;gBACzD,CAAC;gBAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACtC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;wBACzB,OAAO,CAAC,IAAI,CAAC;4BACX,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC;4BAClC,IAAI,EAAE,CAAC,GAAG,CAAC;4BACX,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;yBAClB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC7E,CAAC;KACF,CAAC,CAAC;IAEH,mEAAmE;IAEnE,MAAM,UAAU,GAAG,IAAI,CAAC;QACtB,WAAW,EAAE,qEAAqE;QAClF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YACxE,SAAS,EAAE,CAAC;iBACT,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,uCAAuC,CAAC;SACrD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE;YACzC,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAErC,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnC,OAAO;oBACL,KAAK,EAAE,0DAA0D;oBACjE,QAAQ,EAAE,QAAQ;iBACnB,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AACxE,CAAC;AAED,uEAAuE;AAEvE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAQpD,+EAA+E;AAC/E,KAAK,UAAU,OAAO,CAAC,EAAc,EAAE,IAAY,EAAE,GAAW;IAC9D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,OAAO,GAAgB,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/F,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,yGAAyG;AACzG,KAAK,UAAU,SAAS,CAAC,EAAc,EAAE,GAAW;IAClD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,OAAO,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,wDAAwD;AACxD,SAAS,QAAQ,CAAC,IAAY,EAAE,IAAY;IAC1C,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,GAAG,IAAI,CAAC;IAC3C,OAAO,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED,mDAAmD;AACnD,SAAS,YAAY,CAAC,IAAY,EAAE,MAAc;IAChD,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC;IAC9D,IAAI,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2CAA2C;AAC3C,SAAS,OAAO,CAAC,QAAgB;IAC/B,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,SAAS,KAAK,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IACjC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AACtC,CAAC"}

package/dist/tools/create-local-tools.d.ts

@@ -0,0 +1,97 @@
+import type { Environment } from "../providers/types.js";
+import { type CreateFsToolsOptions } from "./create-fs-tools.js";
+export declare function createLocalTools(env: Environment, options?: CreateFsToolsOptions): {
+    bash: import("ai").Tool<{
+        command: string;
+        timeout: number;
+    }, import("../providers/types.js").ShellResult>;
+    readFile: import("ai").Tool<{
+        filePath: string;
+        offset?: number | undefined;
+        limit?: number | undefined;
+    }, {
+        error: string;
+        filePath?: undefined;
+        totalLines?: undefined;
+        fromLine?: undefined;
+        toLine?: undefined;
+        status?: undefined;
+        content?: undefined;
+    } | {
+        error: string;
+        filePath: string;
+        totalLines?: undefined;
+        fromLine?: undefined;
+        toLine?: undefined;
+        status?: undefined;
+        content?: undefined;
+    } | {
+        filePath: string;
+        totalLines: number;
+        fromLine: number;
+        toLine: number;
+        status: string;
+        content: string;
+        error?: undefined;
+    }>;
+    writeFile: import("ai").Tool<{
+        filePath: string;
+        content: string;
+    }, {
+        filePath: string;
+        bytesWritten: number;
+    }>;
+    editFile: import("ai").Tool<{
+        filePath: string;
+        oldString: string;
+        newString: string;
+        replaceAll: boolean;
+    }, {
+        error: string;
+        filePath: string;
+        replacements?: undefined;
+    } | {
+        filePath: string;
+        replacements: number;
+        error?: undefined;
+    }>;
+    listFiles: import("ai").Tool<{
+        dirPath: string;
+        recursive: boolean;
+    }, {
+        dirPath: string;
+        count: number;
+        entries: {
+            name: string;
+            type: "file" | "directory";
+        }[];
+    }>;
+    grep: import("ai").Tool<{
+        pattern: string;
+        dirPath: string;
+        ignoreCase: boolean;
+        glob?: string | undefined;
+    }, {
+        dirPath: string;
+        pattern: string;
+        matchCount: number;
+        matches: {
+            file: string;
+            line: number;
+            content: string;
+        }[];
+    }>;
+    deleteFile: import("ai").Tool<{
+        filePath: string;
+        recursive: boolean;
+    }, {
+        error: string;
+        filePath: string;
+        deleted?: undefined;
+    } | {
+        deleted: string;
+        error?: undefined;
+        filePath?: undefined;
+    }>;
+};
+//# sourceMappingURL=create-local-tools.d.ts.map

package/dist/tools/create-local-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-local-tools.d.ts","sourceRoot":"","sources":["../../src/tools/create-local-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGhF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKhF"}

package/dist/tools/create-local-tools.js

@@ -0,0 +1,9 @@
+import { createFsTools } from "./create-fs-tools.js";
+import { createBashTool } from "./create-bash-tool.js";
+export function createLocalTools(env, options) {
+    return {
+        ...createFsTools(env.fs, options),
+        ...createBashTool(env.shell),
+    };
+}
+//# sourceMappingURL=create-local-tools.js.map

package/dist/tools/create-local-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-local-tools.js","sourceRoot":"","sources":["../../src/tools/create-local-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAA6B,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,UAAU,gBAAgB,CAAC,GAAgB,EAAE,OAA8B;IAC/E,OAAO;QACL,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC;QACjC,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC;KAC7B,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openharness/core",
-  "version": "0.4.4",
+  "version": "0.5.0",
   "type": "module",
   "description": "Building blocks for capable, general-purpose agents",
   "exports": {
@@ -8,13 +8,9 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./tools/fs": {
-      "types": "./dist/tools/fs.d.ts",
-      "import": "./dist/tools/fs.js"
-    },
-    "./tools/bash": {
-      "types": "./dist/tools/bash.d.ts",
-      "import": "./dist/tools/bash.js"
+    "./providers": {
+      "types": "./dist/providers/index.d.ts",
+      "import": "./dist/providers/index.js"
     }
   },
   "files": [