@openharness/core 0.5.1 → 0.5.3

package/dist/providers/node.js

@@ -0,0 +1,130 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { execFile } from "node:child_process";
+// ── NodeFsProvider ──────────────────────────────────────────────────
+const DEFAULT_MAX_FILE_SIZE = 10 * 1024 * 1024; // 10 MB
+export class NodeFsProvider {
+    cwd;
+    maxFileSize;
+    constructor(options) {
+        this.cwd = options?.cwd ?? process.cwd();
+        this.maxFileSize = options?.maxFileSize ?? DEFAULT_MAX_FILE_SIZE;
+    }
+    resolvePath(filePath) {
+        return path.resolve(this.cwd, filePath);
+    }
+    async readFile(filePath) {
+        const resolved = this.resolvePath(filePath);
+        const stat = await fs.stat(resolved);
+        if (stat.size > this.maxFileSize) {
+            throw new FileTooLargeError(resolved, stat.size, this.maxFileSize);
+        }
+        return fs.readFile(resolved, "utf-8");
+    }
+    async writeFile(filePath, content) {
+        const resolved = this.resolvePath(filePath);
+        await fs.mkdir(path.dirname(resolved), { recursive: true });
+        await fs.writeFile(resolved, content, "utf-8");
+    }
+    async exists(filePath) {
+        try {
+            await fs.access(this.resolvePath(filePath));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async stat(filePath) {
+        const stat = await fs.stat(this.resolvePath(filePath));
+        return {
+            isFile: stat.isFile(),
+            isDirectory: stat.isDirectory(),
+            size: stat.size,
+        };
+    }
+    async readdir(dirPath) {
+        const entries = await fs.readdir(this.resolvePath(dirPath), { withFileTypes: true });
+        return entries.map((e) => ({
+            name: e.name,
+            isFile: e.isFile(),
+            isDirectory: e.isDirectory(),
+        }));
+    }
+    async mkdir(dirPath, options) {
+        await fs.mkdir(this.resolvePath(dirPath), { recursive: options?.recursive });
+    }
+    async remove(filePath, options) {
+        const resolved = this.resolvePath(filePath);
+        const stat = await fs.stat(resolved);
+        if (stat.isDirectory()) {
+            if (!options?.recursive) {
+                throw new Error(`Path is a directory. Set recursive to true to delete it: ${resolved}`);
+            }
+            await fs.rm(resolved, { recursive: true });
+        }
+        else {
+            await fs.unlink(resolved);
+        }
+    }
+    async rename(oldPath, newPath) {
+        await fs.rename(this.resolvePath(oldPath), this.resolvePath(newPath));
+    }
+}
+// ── NodeShellProvider ───────────────────────────────────────────────
+const MAX_STDOUT = 50_000;
+const MAX_STDERR = 10_000;
+export class NodeShellProvider {
+    cwd;
+    maxStdout;
+    maxStderr;
+    constructor(options) {
+        this.cwd = options?.cwd ?? process.cwd();
+        this.maxStdout = options?.maxStdout ?? MAX_STDOUT;
+        this.maxStderr = options?.maxStderr ?? MAX_STDERR;
+    }
+    exec(command, options) {
+        return new Promise((resolve) => {
+            const child = execFile("bash", ["-c", command], {
+                timeout: options?.timeout ?? 30_000,
+                maxBuffer: 1024 * 1024,
+                cwd: options?.cwd ?? this.cwd,
+                env: options?.env ? { ...process.env, ...options.env } : undefined,
+            }, (error, stdout, stderr) => {
+                resolve({
+                    stdout: truncateOutput(stdout, this.maxStdout),
+                    stderr: truncateOutput(stderr, this.maxStderr),
+                    exitCode: child.exitCode ?? (error ? 1 : 0),
+                });
+            });
+        });
+    }
+}
+// ── Errors ──────────────────────────────────────────────────────────
+export class FileTooLargeError extends Error {
+    filePath;
+    fileSize;
+    maxSize;
+    constructor(filePath, fileSize, maxSize) {
+        super(`File too large: ${filePath} is ${formatBytes(fileSize)} (limit: ${formatBytes(maxSize)}). ` +
+            `Use offset and limit parameters to read a portion of the file, or use grep to search it.`);
+        this.filePath = filePath;
+        this.fileSize = fileSize;
+        this.maxSize = maxSize;
+        this.name = "FileTooLargeError";
+    }
+}
+// ── Helpers ─────────────────────────────────────────────────────────
+function truncateOutput(text, max) {
+    if (text.length <= max)
+        return text;
+    return text.slice(0, max) + `\n... (truncated, ${text.length - max} chars omitted)`;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=node.js.map

package/dist/providers/node.js.map

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

package/dist/providers/types.d.ts

@@ -0,0 +1,52 @@
+export interface FileStat {
+    isFile: boolean;
+    isDirectory: boolean;
+    size: number;
+}
+export interface DirEntry {
+    name: string;
+    isFile: boolean;
+    isDirectory: boolean;
+}
+export interface FsProvider {
+    /** Read a file's full text content. Should throw if the file exceeds a reasonable size limit. */
+    readFile(path: string): Promise<string>;
+    /** Write text content to a file, creating parent directories as needed. */
+    writeFile(path: string, content: string): Promise<void>;
+    /** Check whether a path exists. */
+    exists(path: string): Promise<boolean>;
+    /** Get file/directory metadata. */
+    stat(path: string): Promise<FileStat>;
+    /** List entries in a single directory (non-recursive). */
+    readdir(path: string): Promise<DirEntry[]>;
+    /** Create a directory. When recursive is true, create parent directories as needed. */
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    /** Remove a file or directory. When recursive is true, remove directory contents. */
+    remove(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    /** Rename or move a file/directory. */
+    rename(oldPath: string, newPath: string): Promise<void>;
+    /** Resolve a relative path to an absolute path within this provider's context. */
+    resolvePath(path: string): string;
+}
+export interface ShellResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface ShellProvider {
+    /** Execute a shell command and return its output. */
+    exec(command: string, options?: {
+        timeout?: number;
+        cwd?: string;
+        env?: Record<string, string>;
+    }): Promise<ShellResult>;
+}
+export interface Environment {
+    fs: FsProvider;
+    shell: ShellProvider;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,iGAAiG;IACjG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExC,2EAA2E;IAC3E,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,mCAAmC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC,mCAAmC;IACnC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEtC,0DAA0D;IAC1D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE3C,uFAAuF;IACvF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE,qFAAqF;IACrF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvE,uCAAuC;IACvC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,kFAAkF;IAClF,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC;AAID,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,IAAI,CACF,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC9B,GACA,OAAO,CAAC,WAAW,CAAC,CAAC;CACzB;AAID,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;CACtB"}

package/dist/providers/types.js

@@ -0,0 +1,8 @@
+// ── Provider Interfaces ─────────────────────────────────────────────
+//
+// These interfaces define the contract for environment providers.
+// Providers supply filesystem and shell access that tools consume.
+// Implementations exist for Node.js (built-in), and can be created
+// for VFS, E2B, Cloudflare Sandboxes, Daytona, etc.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,mEAAmE;AACnE,oDAAoD"}

package/dist/tools/create-bash-tool.d.ts

@@ -0,0 +1,8 @@
+import type { ShellProvider } from "../providers/types.js";
+export declare function createBashTool(shell: ShellProvider): {
+    bash: import("ai").Tool<{
+        command: string;
+        timeout: number;
+    }, import("../providers/types.js").ShellResult>;
+};
+//# sourceMappingURL=create-bash-tool.d.ts.map

package/dist/tools/create-bash-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-bash-tool.d.ts","sourceRoot":"","sources":["../../src/tools/create-bash-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa;;;;;EAyBlD"}

package/dist/tools/create-bash-tool.js

@@ -0,0 +1,27 @@
+import { tool } from "ai";
+import { z } from "zod";
+export function createBashTool(shell) {
+    const bash = tool({
+        description: "Run a bash command and return its output. " +
+            "Use this for git operations, running tests, installing packages, " +
+            "building projects, and any other shell tasks. " +
+            "Commands run in the project's working directory. " +
+            "Prefer dedicated file tools (readFile, writeFile, etc.) over shell equivalents (cat, echo >).",
+        inputSchema: z.object({
+            command: z.string().describe("The bash command to execute"),
+            timeout: z
+                .number()
+                .int()
+                .min(1000)
+                .max(300000)
+                .optional()
+                .default(30000)
+                .describe("Timeout in milliseconds (default 30s, max 5min)"),
+        }),
+        execute: async ({ command, timeout }) => {
+            return shell.exec(command, { timeout });
+        },
+    });
+    return { bash };
+}
+//# sourceMappingURL=create-bash-tool.js.map

package/dist/tools/create-bash-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-bash-tool.js","sourceRoot":"","sources":["../../src/tools/create-bash-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC;QAChB,WAAW,EACT,4CAA4C;YAC5C,mEAAmE;YACnE,gDAAgD;YAChD,mDAAmD;YACnD,+FAA+F;QACjG,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,GAAG,EAAE;iBACL,GAAG,CAAC,IAAI,CAAC;iBACT,GAAG,CAAC,MAAM,CAAC;iBACX,QAAQ,EAAE;iBACV,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,iDAAiD,CAAC;SAC/D,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;YACtC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,100 @@
+import type { FsProvider } from "../providers/types.js";
+export interface CreateFsToolsOptions {
+    /** Maximum output size in bytes. Defaults to 50 KB. */
+    maxOutputBytes?: number;
+    /** Maximum number of lines returned by readFile. Defaults to 2000. */
+    maxLines?: number;
+    /** Maximum characters per line before truncation. Defaults to 2000. */
+    maxLineLength?: number;
+}
+export declare function createFsTools(fs: FsProvider, options?: CreateFsToolsOptions): {
+    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-fs-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-fs-tools.d.ts","sourceRoot":"","sources":["../../src/tools/create-fs-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,uBAAuB,CAAC;AA+DlE,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA8KnD,MAAM;kBAAQ,MAAM,GAAG,WAAW;;;;;;;;;;;;;kBA+C9B,MAAM;kBAAQ,MAAM;qBAAW,MAAM;;;;;;;;;;;;;;;EAuDjE"}