@kuralle-agents/fs 0.6.0

package/dist/path-utils.js

@@ -0,0 +1,114 @@
+export const MAX_SYMLINK_DEPTH = 40;
+export const DEFAULT_DIR_MODE = 0o755;
+export const DEFAULT_FILE_MODE = 0o644;
+export const SYMLINK_MODE = 0o777;
+export function normalizePath(path) {
+    if (!path || path === '/')
+        return '/';
+    let normalized = path.endsWith('/') && path !== '/' ? path.slice(0, -1) : path;
+    if (!normalized.startsWith('/')) {
+        normalized = `/${normalized}`;
+    }
+    const parts = normalized.split('/').filter((p) => p && p !== '.');
+    const resolved = [];
+    for (const part of parts) {
+        if (part === '..') {
+            resolved.pop();
+        }
+        else {
+            resolved.push(part);
+        }
+    }
+    return `/${resolved.join('/')}`;
+}
+export function validatePath(path, operation) {
+    if (path.includes('\0')) {
+        throw new Error(`ENOENT: path contains null byte, ${operation} '${path}'`);
+    }
+}
+export function dirname(path) {
+    const normalized = normalizePath(path);
+    if (normalized === '/')
+        return '/';
+    const lastSlash = normalized.lastIndexOf('/');
+    return lastSlash === 0 ? '/' : normalized.slice(0, lastSlash);
+}
+export function resolvePath(base, path) {
+    if (path.startsWith('/')) {
+        return normalizePath(path);
+    }
+    const combined = base === '/' ? `/${path}` : `${base}/${path}`;
+    return normalizePath(combined);
+}
+export function joinPath(parent, child) {
+    return parent === '/' ? `/${child}` : `${parent}/${child}`;
+}
+export function resolveSymlinkTarget(symlinkPath, target) {
+    if (target.startsWith('/')) {
+        return normalizePath(target);
+    }
+    const dir = dirname(symlinkPath);
+    return normalizePath(joinPath(dir, target));
+}
+export function createGlobMatcher(pattern) {
+    let i = 0;
+    let re = '^';
+    while (i < pattern.length) {
+        const ch = pattern[i];
+        if (ch === '*') {
+            if (pattern[i + 1] === '*') {
+                i += 2;
+                if (pattern[i] === '/') {
+                    re += '(?:.+/)?';
+                    i++;
+                }
+                else {
+                    re += '.*';
+                }
+            }
+            else {
+                re += '[^/]*';
+                i++;
+            }
+        }
+        else if (ch === '?') {
+            re += '[^/]';
+            i++;
+        }
+        else if (ch === '[') {
+            const close = pattern.indexOf(']', i + 1);
+            if (close === -1) {
+                re += '\\[';
+                i++;
+            }
+            else {
+                re += pattern.slice(i, close + 1);
+                i = close + 1;
+            }
+        }
+        else if (ch === '{') {
+            const close = pattern.indexOf('}', i + 1);
+            if (close === -1) {
+                re += '\\{';
+                i++;
+            }
+            else {
+                const inner = pattern
+                    .slice(i + 1, close)
+                    .split(',')
+                    .join('|');
+                re += `(?:${inner})`;
+                i = close + 1;
+            }
+        }
+        else {
+            re += ch.replace(/[.+^$|\\()]/g, '\\$&');
+            i++;
+        }
+    }
+    re += '$';
+    return new RegExp(re);
+}
+export function sortPaths(paths) {
+    return [...paths].sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
+}

package/dist/tool.d.ts

@@ -0,0 +1,2 @@
+export { createFsTool } from '@kuralle-agents/core';
+export type { CreateFsToolOptions, GrepHit } from '@kuralle-agents/core';

package/dist/tool.js

@@ -0,0 +1,5 @@
+// `createFsTool` lives in `@kuralle-agents/core` (it needs only `defineTool` + the
+// `FileSystem` interface, both core-owned), so the runtime can auto-register it with a
+// static import and no core->fs dependency cycle (RFC-02 §5.2). Re-exported here for the
+// `@kuralle-agents/fs` public API.
+export { createFsTool } from '@kuralle-agents/core';

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@kuralle-agents/fs",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kuralle/kuralle-agents.git",
+    "directory": "packages/kuralle-fs"
+  },
+  "version": "0.6.0",
+  "description": "Portable filesystem primitive for Kuralle agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@kuralle-agents/core": "0.6.0"
+  },
+  "peerDependencies": {
+    "zod": "^3.0.0"
+  },
+  "devDependencies": {
+    "@cloudflare/vitest-pool-workers": "^0.12.7",
+    "@types/node": "^20.11.0",
+    "bun-types": "^1.3.0",
+    "typescript": "^5.3.0",
+    "vitest": "^3.2.4",
+    "zod": "^3.23.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "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: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"
+  }
+}