@openharness/provider-vfs 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Max Gfeller
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/vfs-provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vfs-provider.test.d.ts.map

package/dist/__tests__/vfs-provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs-provider.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/vfs-provider.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/vfs-provider.test.js

@@ -0,0 +1,168 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { VfsFsProvider, FileTooLargeError } from "../vfs-provider.js";
+import { MemoryProvider, create } from "@platformatic/vfs";
+// ── Helpers ─────────────────────────────────────────────────────────
+let provider;
+beforeEach(() => {
+    const vfs = create(new MemoryProvider(), { moduleHooks: false, virtualCwd: true });
+    vfs.mount("/workspace");
+    provider = new VfsFsProvider({ vfs, mountPoint: "/workspace" });
+});
+// ── Basic read/write ────────────────────────────────────────────────
+describe("readFile / writeFile", () => {
+    it("writes and reads a file", async () => {
+        await provider.writeFile("/workspace/hello.txt", "hello world");
+        const content = await provider.readFile("/workspace/hello.txt");
+        expect(content).toBe("hello world");
+    });
+    it("creates parent directories on write", async () => {
+        await provider.writeFile("/workspace/a/b/c.txt", "nested");
+        const content = await provider.readFile("/workspace/a/b/c.txt");
+        expect(content).toBe("nested");
+    });
+    it("overwrites existing files", async () => {
+        await provider.writeFile("/workspace/file.txt", "first");
+        await provider.writeFile("/workspace/file.txt", "second");
+        const content = await provider.readFile("/workspace/file.txt");
+        expect(content).toBe("second");
+    });
+});
+// ── Size guard ──────────────────────────────────────────────────────
+describe("maxFileSize", () => {
+    it("throws FileTooLargeError for oversized files", async () => {
+        const vfs = create(new MemoryProvider(), { moduleHooks: false, virtualCwd: true });
+        vfs.mount("/workspace");
+        const small = new VfsFsProvider({ vfs, maxFileSize: 10 });
+        await small.writeFile("/workspace/big.txt", "a".repeat(100));
+        await expect(small.readFile("/workspace/big.txt")).rejects.toThrow(FileTooLargeError);
+    });
+});
+// ── exists ──────────────────────────────────────────────────────────
+describe("exists", () => {
+    it("returns false for non-existent paths", async () => {
+        expect(await provider.exists("/workspace/nope.txt")).toBe(false);
+    });
+    it("returns true for existing files", async () => {
+        await provider.writeFile("/workspace/yep.txt", "hi");
+        expect(await provider.exists("/workspace/yep.txt")).toBe(true);
+    });
+    it("returns true for existing directories", async () => {
+        await provider.mkdir("/workspace/dir");
+        expect(await provider.exists("/workspace/dir")).toBe(true);
+    });
+});
+// ── stat ────────────────────────────────────────────────────────────
+describe("stat", () => {
+    it("returns file stat", async () => {
+        await provider.writeFile("/workspace/file.txt", "content");
+        const stat = await provider.stat("/workspace/file.txt");
+        expect(stat.isFile).toBe(true);
+        expect(stat.isDirectory).toBe(false);
+        expect(stat.size).toBe(7);
+    });
+    it("returns directory stat", async () => {
+        await provider.mkdir("/workspace/dir");
+        const stat = await provider.stat("/workspace/dir");
+        expect(stat.isFile).toBe(false);
+        expect(stat.isDirectory).toBe(true);
+    });
+});
+// ── readdir ─────────────────────────────────────────────────────────
+describe("readdir", () => {
+    it("lists directory entries", async () => {
+        await provider.writeFile("/workspace/a.txt", "a");
+        await provider.writeFile("/workspace/b.txt", "b");
+        await provider.mkdir("/workspace/subdir");
+        const entries = await provider.readdir("/workspace");
+        const names = entries.map((e) => e.name).sort();
+        expect(names).toContain("a.txt");
+        expect(names).toContain("b.txt");
+        expect(names).toContain("subdir");
+        const subdir = entries.find((e) => e.name === "subdir");
+        expect(subdir.isDirectory).toBe(true);
+        expect(subdir.isFile).toBe(false);
+        const file = entries.find((e) => e.name === "a.txt");
+        expect(file.isFile).toBe(true);
+        expect(file.isDirectory).toBe(false);
+    });
+});
+// ── mkdir ───────────────────────────────────────────────────────────
+describe("mkdir", () => {
+    it("creates a directory", async () => {
+        await provider.mkdir("/workspace/newdir");
+        const stat = await provider.stat("/workspace/newdir");
+        expect(stat.isDirectory).toBe(true);
+    });
+    it("creates nested directories with recursive", async () => {
+        await provider.mkdir("/workspace/a/b/c", { recursive: true });
+        const stat = await provider.stat("/workspace/a/b/c");
+        expect(stat.isDirectory).toBe(true);
+    });
+});
+// ── remove ──────────────────────────────────────────────────────────
+describe("remove", () => {
+    it("removes a file", async () => {
+        await provider.writeFile("/workspace/bye.txt", "gone");
+        await provider.remove("/workspace/bye.txt");
+        expect(await provider.exists("/workspace/bye.txt")).toBe(false);
+    });
+    it("throws when removing directory without recursive", async () => {
+        await provider.mkdir("/workspace/dir");
+        await expect(provider.remove("/workspace/dir")).rejects.toThrow(/directory/i);
+    });
+    it("removes directory recursively", async () => {
+        await provider.writeFile("/workspace/dir/a.txt", "a");
+        await provider.writeFile("/workspace/dir/sub/b.txt", "b");
+        await provider.remove("/workspace/dir", { recursive: true });
+        expect(await provider.exists("/workspace/dir")).toBe(false);
+    });
+});
+// ── rename ──────────────────────────────────────────────────────────
+describe("rename", () => {
+    it("renames a file", async () => {
+        await provider.writeFile("/workspace/old.txt", "content");
+        await provider.rename("/workspace/old.txt", "/workspace/new.txt");
+        expect(await provider.exists("/workspace/old.txt")).toBe(false);
+        const content = await provider.readFile("/workspace/new.txt");
+        expect(content).toBe("content");
+    });
+});
+// ── resolvePath ─────────────────────────────────────────────────────
+describe("resolvePath", () => {
+    it("returns absolute paths unchanged", () => {
+        const resolved = provider.resolvePath("/workspace/file.txt");
+        expect(resolved).toBe("/workspace/file.txt");
+    });
+});
+// ── Integration with createFsTools ──────────────────────────────────
+describe("integration with createFsTools", () => {
+    it("tools work with VFS provider", async () => {
+        // Dynamic import to avoid circular dependency issues at load time
+        const { createFsTools } = await import("@openharness/core");
+        const tools = createFsTools(provider);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const exec = async (tool, input) => tool.execute(input, { toolCallId: "test", messages: [] });
+        // Write via tool
+        await exec(tools.writeFile, { filePath: "/workspace/test.txt", content: "hello from tools" });
+        // Read via tool
+        const result = await exec(tools.readFile, { filePath: "/workspace/test.txt" });
+        expect(result.content).toContain("hello from tools");
+        expect(result.totalLines).toBe(1);
+        // Edit via tool
+        await exec(tools.editFile, {
+            filePath: "/workspace/test.txt",
+            oldString: "hello",
+            newString: "goodbye",
+            replaceAll: false,
+        });
+        const edited = await exec(tools.readFile, { filePath: "/workspace/test.txt" });
+        expect(edited.content).toContain("goodbye from tools");
+        // List via tool
+        const listed = await exec(tools.listFiles, { dirPath: "/workspace", recursive: false });
+        expect(listed.entries.some((e) => e.name === "test.txt")).toBe(true);
+        // Delete via tool
+        await exec(tools.deleteFile, { filePath: "/workspace/test.txt", recursive: false });
+        expect(await provider.exists("/workspace/test.txt")).toBe(false);
+    });
+});
+//# sourceMappingURL=vfs-provider.test.js.map

package/dist/__tests__/vfs-provider.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { VfsFsProvider, FileTooLargeError, getVfsModule } from "./vfs-provider.js";
+export type { VfsFsProviderOptions } from "./vfs-provider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnF,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { VfsFsProvider, FileTooLargeError, getVfsModule } from "./vfs-provider.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/vfs-provider.d.ts

@@ -0,0 +1,97 @@
+import type { FsProvider, FileStat, DirEntry } from "@openharness/core/providers";
+interface VfsStats {
+    isFile(): boolean;
+    isDirectory(): boolean;
+    size: number;
+}
+interface VfsDirent {
+    name: string;
+    isFile(): boolean;
+    isDirectory(): boolean;
+}
+interface VfsPromisesApi {
+    readFile(path: string, options?: {
+        encoding?: string;
+    } | string): Promise<string | Buffer>;
+    writeFile(path: string, data: string | Buffer, options?: {
+        encoding?: string;
+    } | string): Promise<void>;
+    stat(path: string): Promise<VfsStats>;
+    readdir(path: string, options?: {
+        withFileTypes?: boolean;
+    }): Promise<string[] | VfsDirent[]>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<string | undefined>;
+    rmdir(path: string): Promise<void>;
+    unlink(path: string): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    access(path: string, mode?: number): Promise<void>;
+}
+interface VirtualFileSystem {
+    promises: VfsPromisesApi;
+    existsSync(path: string): boolean;
+    resolvePath(path: string): string;
+    mount(prefix: string): VirtualFileSystem;
+    unmount(): void;
+    readonly mounted: boolean;
+}
+interface VfsModule {
+    create(provider?: unknown, options?: VfsCreateOptions): VirtualFileSystem;
+    create(options?: VfsCreateOptions): VirtualFileSystem;
+    MemoryProvider: new () => unknown;
+    SqliteProvider: new (path?: string) => unknown;
+    RealFSProvider: new (rootPath: string) => unknown;
+}
+interface VfsCreateOptions {
+    moduleHooks?: boolean;
+    overlay?: boolean;
+    virtualCwd?: boolean;
+}
+declare function getVfsModule(): Promise<VfsModule>;
+export interface VfsFsProviderOptions {
+    /** A pre-created VirtualFileSystem instance. If provided, provider/vfsOptions/mountPoint are ignored. */
+    vfs?: VirtualFileSystem;
+    /** VFS provider instance (MemoryProvider, SqliteProvider, RealFSProvider). Defaults to MemoryProvider. */
+    provider?: unknown;
+    /** Options passed to vfs create(). Defaults to { moduleHooks: false, virtualCwd: true }. */
+    vfsOptions?: VfsCreateOptions;
+    /** Mount point for the VFS. Defaults to "/workspace". */
+    mountPoint?: string;
+    /** Maximum file size in bytes that readFile will load. Defaults to 10 MB. */
+    maxFileSize?: number;
+}
+export declare class VfsFsProvider implements FsProvider {
+    private vfs;
+    private initPromise;
+    private options;
+    private maxFileSize;
+    constructor(options?: VfsFsProviderOptions);
+    private ensureInitialized;
+    private initialize;
+    /** Get the underlying VirtualFileSystem instance (initializes lazily if needed). */
+    getVfs(): Promise<VirtualFileSystem>;
+    resolvePath(filePath: string): string;
+    readFile(filePath: string): Promise<string>;
+    writeFile(filePath: string, content: string): Promise<void>;
+    exists(filePath: string): Promise<boolean>;
+    stat(filePath: string): Promise<FileStat>;
+    readdir(dirPath: string): Promise<DirEntry[]>;
+    mkdir(dirPath: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    remove(filePath: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    /** Recursively remove a directory since VFS lacks `rm`. */
+    private removeRecursive;
+}
+export declare class FileTooLargeError extends Error {
+    readonly filePath: string;
+    readonly fileSize: number;
+    readonly maxSize: number;
+    constructor(filePath: string, fileSize: number, maxSize: number);
+}
+export { getVfsModule };
+//# sourceMappingURL=vfs-provider.d.ts.map

package/dist/vfs-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vfs-provider.d.ts","sourceRoot":"","sources":["../src/vfs-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAMlF,UAAU,QAAQ;IAChB,MAAM,IAAI,OAAO,CAAC;IAClB,WAAW,IAAI,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,IAAI,OAAO,CAAC;IAClB,WAAW,IAAI,OAAO,CAAC;CACxB;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3F,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;IAC9F,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED,UAAU,iBAAiB;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACzC,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,UAAU,SAAS;IACjB,MAAM,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;IAC1E,MAAM,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;IACtD,cAAc,EAAE,UAAU,OAAO,CAAC;IAClC,cAAc,EAAE,KAAK,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;CACnD;AAED,UAAU,gBAAgB;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAMD,iBAAe,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC,CAoBhD;AAMD,MAAM,WAAW,oBAAoB;IACnC,yGAAyG;IACzG,GAAG,CAAC,EAAE,iBAAiB,CAAC;IAExB,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,aAAc,YAAW,UAAU;IAC9C,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,CAAC,EAAE,oBAAoB;YAS5B,iBAAiB;YAUjB,UAAU;IAsBxB,oFAAoF;IAC9E,MAAM,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAI1C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAW/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc3C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW1C,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWzC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAW7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1E,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D,2DAA2D;YAC7C,eAAe;CAc9B;AAID,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,MAAM;aAChB,OAAO,EAAE,MAAM;gBAFf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM;CAQlC;AAkBD,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/vfs-provider.js

@@ -0,0 +1,199 @@
+// ── Runtime module resolution ───────────────────────────────────────
+let cachedModule;
+async function getVfsModule() {
+    if (cachedModule)
+        return cachedModule;
+    try {
+        // Try native node:vfs first (future Node.js versions)
+        // @ts-expect-error -- node:vfs does not exist yet; will resolve once Node ships it
+        cachedModule = (await import("node:vfs"));
+    }
+    catch {
+        try {
+            // Fall back to userland @platformatic/vfs
+            cachedModule = (await import("@platformatic/vfs"));
+        }
+        catch {
+            throw new Error("No VFS module available. Install @platformatic/vfs (requires Node >= 22) " +
+                "or use a Node.js version with built-in node:vfs support.");
+        }
+    }
+    return cachedModule;
+}
+// ── VfsFsProvider ───────────────────────────────────────────────────
+const DEFAULT_MAX_FILE_SIZE = 10 * 1024 * 1024; // 10 MB
+export class VfsFsProvider {
+    vfs;
+    initPromise;
+    options;
+    maxFileSize;
+    constructor(options) {
+        this.options = options ?? {};
+        this.maxFileSize = options?.maxFileSize ?? DEFAULT_MAX_FILE_SIZE;
+        if (options?.vfs) {
+            this.vfs = options.vfs;
+        }
+    }
+    async ensureInitialized() {
+        if (this.vfs)
+            return this.vfs;
+        if (!this.initPromise) {
+            this.initPromise = this.initialize();
+        }
+        await this.initPromise;
+        return this.vfs;
+    }
+    async initialize() {
+        const mod = await getVfsModule();
+        const provider = this.options.provider ?? new mod.MemoryProvider();
+        const vfsOptions = this.options.vfsOptions ?? {
+            moduleHooks: false,
+            virtualCwd: true,
+        };
+        this.vfs = mod.create(provider, vfsOptions);
+        const mountPoint = this.options.mountPoint ?? "/workspace";
+        if (!this.vfs.mounted) {
+            this.vfs.mount(mountPoint);
+        }
+        // Initialize virtual CWD to the mount point
+        if (vfsOptions.virtualCwd !== false) {
+            this.vfs.resolvePath(mountPoint);
+        }
+    }
+    /** Get the underlying VirtualFileSystem instance (initializes lazily if needed). */
+    async getVfs() {
+        return this.ensureInitialized();
+    }
+    resolvePath(filePath) {
+        if (!this.vfs) {
+            // Before initialization, return the path as-is — the caller should
+            // await an operation (which triggers init) before using resolvePath.
+            const mountPoint = this.options.mountPoint ?? "/workspace";
+            if (filePath.startsWith("/"))
+                return filePath;
+            return mountPoint + (mountPoint.endsWith("/") ? "" : "/") + filePath;
+        }
+        return this.vfs.resolvePath(filePath);
+    }
+    async readFile(filePath) {
+        const vfs = await this.ensureInitialized();
+        const resolved = vfs.resolvePath(filePath);
+        // Size guard
+        const stat = await vfs.promises.stat(resolved);
+        if (stat.size > this.maxFileSize) {
+            throw new FileTooLargeError(resolved, stat.size, this.maxFileSize);
+        }
+        const content = await vfs.promises.readFile(resolved, "utf-8");
+        return typeof content === "string" ? content : content.toString("utf-8");
+    }
+    async writeFile(filePath, content) {
+        const vfs = await this.ensureInitialized();
+        const resolved = vfs.resolvePath(filePath);
+        // Create parent directories
+        const parentDir = dirname(resolved);
+        if (parentDir !== resolved) {
+            await vfs.promises.mkdir(parentDir, { recursive: true });
+        }
+        await vfs.promises.writeFile(resolved, content, "utf-8");
+    }
+    async exists(filePath) {
+        const vfs = await this.ensureInitialized();
+        const resolved = vfs.resolvePath(filePath);
+        try {
+            await vfs.promises.access(resolved);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async stat(filePath) {
+        const vfs = await this.ensureInitialized();
+        const resolved = vfs.resolvePath(filePath);
+        const stat = await vfs.promises.stat(resolved);
+        return {
+            isFile: stat.isFile(),
+            isDirectory: stat.isDirectory(),
+            size: stat.size,
+        };
+    }
+    async readdir(dirPath) {
+        const vfs = await this.ensureInitialized();
+        const resolved = vfs.resolvePath(dirPath);
+        const entries = (await vfs.promises.readdir(resolved, { withFileTypes: true }));
+        return entries.map((e) => ({
+            name: e.name,
+            isFile: e.isFile(),
+            isDirectory: e.isDirectory(),
+        }));
+    }
+    async mkdir(dirPath, options) {
+        const vfs = await this.ensureInitialized();
+        const resolved = vfs.resolvePath(dirPath);
+        await vfs.promises.mkdir(resolved, { recursive: options?.recursive });
+    }
+    async remove(filePath, options) {
+        const vfs = await this.ensureInitialized();
+        const resolved = vfs.resolvePath(filePath);
+        const stat = await vfs.promises.stat(resolved);
+        if (stat.isDirectory()) {
+            if (!options?.recursive) {
+                throw new Error(`Path is a directory. Set recursive to true to delete it: ${resolved}`);
+            }
+            await this.removeRecursive(vfs, resolved);
+        }
+        else {
+            await vfs.promises.unlink(resolved);
+        }
+    }
+    async rename(oldPath, newPath) {
+        const vfs = await this.ensureInitialized();
+        await vfs.promises.rename(vfs.resolvePath(oldPath), vfs.resolvePath(newPath));
+    }
+    // ── Private helpers ─────────────────────────────────────────────
+    /** Recursively remove a directory since VFS lacks `rm`. */
+    async removeRecursive(vfs, dirPath) {
+        const entries = (await vfs.promises.readdir(dirPath, { withFileTypes: true }));
+        for (const entry of entries) {
+            const fullPath = dirPath + "/" + entry.name;
+            if (entry.isDirectory()) {
+                await this.removeRecursive(vfs, fullPath);
+            }
+            else {
+                await vfs.promises.unlink(fullPath);
+            }
+        }
+        await vfs.promises.rmdir(dirPath);
+    }
+}
+// ── 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";
+    }
+}
+// ── Utilities ───────────────────────────────────────────────────────
+function dirname(filePath) {
+    const lastSlash = filePath.lastIndexOf("/");
+    if (lastSlash <= 0)
+        return "/";
+    return filePath.slice(0, lastSlash);
+}
+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`;
+}
+// ── Convenience: re-export getVfsModule for advanced usage ──────────
+export { getVfsModule };
+//# sourceMappingURL=vfs-provider.js.map

package/dist/vfs-provider.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openharness/provider-vfs",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "Virtual filesystem provider for @openharness/core — sandboxed, in-memory, or SQLite-backed file access for AI agents",
   "exports": {
@@ -13,6 +13,9 @@
     "dist",
     "README.md"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "keywords": [
     "agent",
     "ai",
@@ -21,9 +24,9 @@
     "sandbox",
     "openharness"
   ],
-  "license": "ISC",
+  "license": "MIT",
   "dependencies": {
-    "@openharness/core": "0.4.5"
+    "@openharness/core": "^0.5.3"
   },
   "peerDependencies": {
     "@platformatic/vfs": ">=0.3.0"