@kuralle-agents/fs 0.11.0 → 0.12.0

package/dist/sql/types.js

@@ -0,0 +1 @@
+export {};

package/dist/virtual-shell.d.ts

@@ -0,0 +1,44 @@
+import type { CpOptions, FileSystem, MkdirOptions, RmOptions } from '@kuralle-agents/core';
+import type { Shell } from '@kuralle-agents/core';
+interface JustBashStat {
+    isFile: boolean;
+    isDirectory: boolean;
+    isSymbolicLink: boolean;
+    size: number;
+    mtime: Date;
+    mode?: number;
+}
+interface JustBashDirent {
+    name: string;
+    isFile: boolean;
+    isDirectory: boolean;
+    isSymbolicLink: boolean;
+}
+interface JustBashFsLike {
+    readFile(path: string): Promise<string>;
+    readFileBuffer(path: string): Promise<Uint8Array>;
+    writeFile(path: string, content: string | Uint8Array): Promise<void>;
+    appendFile(path: string, content: string | Uint8Array): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<JustBashStat>;
+    lstat(path: string): Promise<JustBashStat>;
+    mkdir(path: string, options?: MkdirOptions): Promise<void>;
+    readdir(path: string): Promise<string[]>;
+    readdirWithFileTypes?(path: string): Promise<JustBashDirent[]>;
+    rm(path: string, options?: RmOptions): Promise<void>;
+    cp(src: string, dest: string, options?: CpOptions): Promise<void>;
+    mv(src: string, dest: string): Promise<void>;
+    symlink(target: string, linkPath: string): Promise<void>;
+    readlink(path: string): Promise<string>;
+    realpath(path: string): Promise<string>;
+    resolvePath(base: string, path: string): string;
+    getAllPaths(): string[];
+}
+export declare function justBashFsToFileSystem(jbFs: JustBashFsLike): FileSystem;
+export declare function virtualShell(opts?: {
+    initialFiles?: Record<string, string>;
+}): {
+    fs: FileSystem;
+    shell: Shell;
+};
+export {};

package/dist/virtual-shell.js

@@ -0,0 +1,74 @@
+import { Bash, InMemoryFs as JustBashFs } from 'just-bash';
+import { bashShell } from './bash-shell.js';
+import { createGlobMatcher } from './path-utils.js';
+function entryType(stat) {
+    if (stat.isSymbolicLink)
+        return 'symlink';
+    if (stat.isDirectory)
+        return 'directory';
+    return 'file';
+}
+function mapStat(stat) {
+    return {
+        type: entryType(stat),
+        size: stat.size,
+        mtime: stat.mtime,
+        mode: stat.mode,
+    };
+}
+function mapDirent(entry) {
+    return {
+        name: entry.name,
+        type: entry.isSymbolicLink
+            ? 'symlink'
+            : entry.isDirectory
+                ? 'directory'
+                : 'file',
+    };
+}
+export function justBashFsToFileSystem(jbFs) {
+    return {
+        readFile: (path) => jbFs.readFile(path),
+        readFileBytes: (path) => jbFs.readFileBuffer(path),
+        writeFile: (path, content) => jbFs.writeFile(path, content),
+        writeFileBytes: (path, content) => jbFs.writeFile(path, content),
+        appendFile: (path, content) => jbFs.appendFile(path, content),
+        exists: (path) => jbFs.exists(path),
+        stat: async (path) => mapStat(await jbFs.stat(path)),
+        lstat: async (path) => mapStat(await jbFs.lstat(path)),
+        mkdir: (path, options) => jbFs.mkdir(path, options),
+        readdir: (path) => jbFs.readdir(path),
+        readdirWithFileTypes: async (path) => {
+            if (jbFs.readdirWithFileTypes) {
+                const entries = await jbFs.readdirWithFileTypes(path);
+                return entries.map(mapDirent);
+            }
+            const names = await jbFs.readdir(path);
+            const entries = [];
+            for (const name of names) {
+                const child = path === '/' ? `/${name}` : `${path}/${name}`;
+                const stat = await jbFs.stat(child);
+                entries.push({ name, type: entryType(stat) });
+            }
+            return entries;
+        },
+        rm: (path, options) => jbFs.rm(path, options),
+        cp: (src, dest, options) => jbFs.cp(src, dest, options),
+        mv: (src, dest) => jbFs.mv(src, dest),
+        symlink: (target, linkPath) => jbFs.symlink(target, linkPath),
+        readlink: (path) => jbFs.readlink(path),
+        realpath: (path) => jbFs.realpath(path),
+        resolvePath: (base, path) => jbFs.resolvePath(base, path),
+        glob: async (pattern) => {
+            const matcher = createGlobMatcher(pattern);
+            return jbFs.getAllPaths().filter((p) => matcher.test(p));
+        },
+    };
+}
+export function virtualShell(opts) {
+    const jbFs = new JustBashFs(opts?.initialFiles);
+    const fs = justBashFsToFileSystem(jbFs);
+    const bash = new Bash({ fs: jbFs });
+    const shell = bashShell(bash);
+    return { fs, shell };
+}

package/package.json

@@ -6,26 +6,40 @@
     "url": "git+https://github.com/kuralle/kuralle-agents.git",
     "directory": "packages/kuralle-fs"
   },
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Portable filesystem primitive for Kuralle agents",
   "type": "module",
+  "sideEffects": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./shell": {
+      "types": "./dist/shell.d.ts",
+      "default": "./dist/shell.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "default": "./dist/node/index.js"
+    },
+    "./cloudflare": {
+      "types": "./dist/cloudflare/cf-shell.d.ts",
+      "default": "./dist/cloudflare/cf-shell.js"
     }
   },
   "dependencies": {
-    "@kuralle-agents/core": "0.11.0"
+    "just-bash": "^3.1.0",
+    "@kuralle-agents/core": "0.12.0"
   },
   "peerDependencies": {
     "zod": "^4.0.0"
   },
   "devDependencies": {
     "@cloudflare/vitest-pool-workers": "^0.12.7",
-    "@types/node": "^20.11.0",
+    "@types/node": "^22.5.0",
     "bun-types": "^1.3.0",
     "typescript": "^5.3.0",
     "vitest": "^3.2.4",
@@ -42,7 +56,7 @@
     "prebuild": "rm -rf dist",
     "build": "tsc -p tsconfig.json",
     "clean": "rm -rf dist",
-    "test": "bun test test/in-memory-fs.test.ts test/fs-tool.test.ts test/composite-fs.test.ts && vitest run --config vitest.config.ts",
+    "test": "bun test ./test && vitest run --config vitest.config.ts",
     "test:inmemoryfs": "bun test test/in-memory-fs.test.ts",
     "test:fs-tool": "bun test test/fs-tool.test.ts",
     "test:fs-workers": "vitest run --config vitest.config.ts"