Add versioned filesystem storage

.changeset/versioned-filesystem-storage.md

@@ -0,0 +1,15 @@
+---
+"@cloudflare/shell": minor
+---
+
+Add a new versioned durable filesystem for `@cloudflare/shell`.
+
+New exports:
+
+- `FileSystemStorage`
+- `VersionedFileSystem`
+- `FileSystemStorageOptions`
+- `VersionedFileSystemChangeEvent`
+- `VersionedFileSystemChangeType`
+
+`FileSystemStorage` manages named filesystem versions backed by SQLite plus optional R2 spillover. Each `VersionedFileSystem` instance is bound to one existing version, supports the standard `FileSystem` interface directly, and stores deduplicated content blobs by SHA-256 across the whole database.

packages/shell/src/filesystem.ts

@@ -368,7 +368,7 @@ export class Workspace {
     const resolved = r.target.startsWith("/")
       ? normalizePath(r.target)
       : normalizePath(getParent(path) + "/" + r.target);
-    return this.resolveSymlink(resolved, depth + 1);
+    return await this.resolveSymlink(resolved, depth + 1);
   }
 
   // ── Symlink API ───────────────────────────────────────────────

packages/shell/src/index.ts

@@ -25,6 +25,13 @@ export {
   type FileSystemStateBackendOptions
 } from "./memory";
 export { createWorkspaceStateBackend, WorkspaceFileSystem } from "./workspace";
+export {
+  FileSystemStorage,
+  VersionedFileSystem,
+  type FileSystemStorageOptions,
+  type VersionedFileSystemChangeEvent,
+  type VersionedFileSystemChangeType
+} from "./versioned-filesystem";
 
 // ── LLM prompt helpers ────────────────────────────────────────────────
 export { STATE_TYPES, STATE_SYSTEM_PROMPT } from "./prompt";