@sandbank.dev/boxlite 0.3.3 → 0.3.4

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,YAAY,EAGZ,UAAU,EACV,cAAc,EACd,WAAW,EAIZ,MAAM,oBAAoB,CAAA;AAI3B,OAAO,KAAK,EAAE,oBAAoB,EAA6B,MAAM,YAAY,CAAA;AAoKjF,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,IAAI,aAAY;IACzB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC,CAAA;IAE9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;gBAEtD,MAAM,EAAE,oBAAoB;IAalC,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAgD5D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAW/C,aAAa,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA0B1D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C,8EAA8E;IACxE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,YAAY,EAGZ,UAAU,EACV,cAAc,EACd,WAAW,EAIZ,MAAM,oBAAoB,CAAA;AAI3B,OAAO,KAAK,EAAE,oBAAoB,EAA6B,MAAM,YAAY,CAAA;AAoKjF,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,IAAI,aAAY;IACzB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC,CAAA;IAE9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;gBAEtD,MAAM,EAAE,oBAAoB;IASlC,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAiD5D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAW/C,aAAa,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA0B1D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C,8EAA8E;IACxE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/adapter.js

@@ -153,19 +153,16 @@ export class BoxLiteAdapter {
         this.config = config;
         this.host = resolveHost(config);
         this.client = createClient(config);
-        // Local mode: snapshots not supported yet
-        const caps = ['exec.stream', 'terminal', 'sleep', 'port.expose'];
-        if (config.mode !== 'local') {
-            caps.push('snapshot');
-        }
+        const caps = ['exec.stream', 'terminal', 'sleep', 'port.expose', 'snapshot'];
         this.capabilities = new Set(caps);
     }
     async createSandbox(config) {
         try {
             // If image looks like an absolute path, treat it as a local OCI rootfs
-            const isLocalPath = config.image.startsWith('/');
+            const image = config.image ?? 'ubuntu:24.04';
+            const isLocalPath = image.startsWith('/');
             const box = await this.client.createBox({
-                ...(isLocalPath ? { rootfs_path: config.image } : { image: config.image }),
+                ...(isLocalPath ? { rootfs_path: image } : { image }),
                 cpu: config.resources?.cpu,
                 memory_mb: config.resources?.memory,
                 disk_size_gb: config.resources?.disk,

package/dist/local-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-client.d.ts","sourceRoot":"","sources":["../src/local-client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,aAAa,EAGb,kBAAkB,EAEnB,MAAM,YAAY,CAAA;AA6XnB;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,CAsRlF"}
+{"version":3,"file":"local-client.d.ts","sourceRoot":"","sources":["../src/local-client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,aAAa,EAGb,kBAAkB,EAEnB,MAAM,YAAY,CAAA;AAmfnB;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,CAsRlF"}

package/dist/local-client.js

@@ -86,6 +86,9 @@ class Bridge:
             if ports is not None:
                 sb_kwargs["ports"] = ports
 
+            # Disable auto_remove so runtime.get() works after stop (needed for snapshot restore)
+            sb_kwargs["auto_remove"] = params.get("auto_remove", False)
+
             # Pass the Boxlite runtime to SimpleBox so it uses the correct home_dir
             if getattr(self, "_boxlite_rt", None) is not None:
                 sb_kwargs["runtime"] = self._boxlite_rt
@@ -298,6 +301,111 @@ class Bridge:
         if box and hasattr(box, "start"):
             await box.start()
 
+    def _get_box(self, box_id):
+        box = self._boxes.get(box_id)
+        if box is None:
+            raise ValueError(f"Box not found: {box_id}")
+        # SimpleBox wraps the real Box — unwrap to get snapshot handle
+        inner = getattr(box, "_box", box)
+        return inner
+
+    async def create_snapshot(self, box_id, name):
+        # boxlite snapshot uses fork_qcow2 (rename + COW child). If QEMU is
+        # running, its FD still points to the renamed inode, so post-snapshot
+        # writes corrupt the snapshot file. Must stop → snapshot → restart.
+        inner = self._get_box(box_id)
+        await inner.stop()
+
+        rt = getattr(self, "_boxlite_rt", None)
+        if rt is None:
+            raise RuntimeError("Cannot create snapshot: no Boxlite runtime")
+        fresh = await rt.get(box_id)
+        if fresh is None:
+            raise RuntimeError(f"Cannot get fresh handle for box {box_id}")
+        snap_handle = getattr(fresh, "snapshot", None)
+        if snap_handle is None:
+            raise RuntimeError("Fresh handle has no snapshot support")
+
+        info = await snap_handle.create(name=name)
+        snap_name = str(getattr(info, "name", name))
+
+        # Restart the VM with the new COW child disk
+        await fresh.__aenter__()
+        # Update SimpleBox/Box internal references
+        old_sb = self._simple_boxes.get(box_id)
+        old_box = self._boxes.get(box_id)
+        if old_sb and hasattr(old_sb, "_box"):
+            old_sb._box = fresh
+            old_sb._started = True
+        if old_box and hasattr(old_box, "_box"):
+            old_box._box = fresh
+        else:
+            self._boxes[box_id] = fresh
+
+        return {
+            "id": str(getattr(info, "id", snap_name)),
+            "box_id": box_id,
+            "name": snap_name,
+            "created_at": int(getattr(info, "created_at", 0)),
+            "size_bytes": int(getattr(info, "size_bytes", 0)),
+            "guest_disk_bytes": int(getattr(info, "guest_disk_bytes", 0) or 0),
+            "container_disk_bytes": int(getattr(info, "container_disk_bytes", 0) or 0),
+        }
+
+    async def restore_snapshot(self, box_id, name):
+        # Same stop → fresh handle pattern as create_snapshot.
+        # stop() also invalidates the LiteBox handle (cancels shutdown_token).
+        inner = self._get_box(box_id)
+        await inner.stop()
+
+        rt = getattr(self, "_boxlite_rt", None)
+        if rt is None:
+            raise RuntimeError("Cannot restore snapshot: no Boxlite runtime")
+        fresh = await rt.get(box_id)
+        if fresh is None:
+            raise RuntimeError(f"Cannot get fresh handle for box {box_id}")
+        fresh_snap = getattr(fresh, "snapshot", None)
+        if fresh_snap is None:
+            raise RuntimeError("Fresh handle has no snapshot support")
+
+        await fresh_snap.restore(name)
+
+        # Restart with the restored disk
+        await fresh.__aenter__()
+        # Update SimpleBox/Box internal references
+        old_sb = self._simple_boxes.get(box_id)
+        old_box = self._boxes.get(box_id)
+        if old_sb and hasattr(old_sb, "_box"):
+            old_sb._box = fresh
+            old_sb._started = True
+        if old_box and hasattr(old_box, "_box"):
+            old_box._box = fresh
+        else:
+            self._boxes[box_id] = fresh
+
+    async def list_snapshots(self, box_id):
+        inner = self._get_box(box_id)
+        snap_handle = getattr(inner, "snapshot", None)
+        if snap_handle is None:
+            raise RuntimeError("Box does not support snapshots")
+        snapshots = await snap_handle.list()
+        return [{
+            "id": str(getattr(s, "id", "")),
+            "box_id": box_id,
+            "name": str(getattr(s, "name", "")),
+            "created_at": int(getattr(s, "created_at", 0)),
+            "size_bytes": int(getattr(s, "size_bytes", 0)),
+            "guest_disk_bytes": int(getattr(s, "guest_disk_bytes", 0) or 0),
+            "container_disk_bytes": int(getattr(s, "container_disk_bytes", 0) or 0),
+        } for s in snapshots]
+
+    async def delete_snapshot(self, box_id, name):
+        inner = self._get_box(box_id)
+        snap_handle = getattr(inner, "snapshot", None)
+        if snap_handle is None:
+            raise RuntimeError("Box does not support snapshots")
+        await snap_handle.remove(name)
+
     async def cleanup(self):
         for box_id in list(self._boxes.keys()):
             try:
@@ -349,6 +457,16 @@ async def main():
             elif action == "stop":
                 await bridge.stop(cmd["box_id"])
                 result = {}
+            elif action == "create_snapshot":
+                result = await bridge.create_snapshot(cmd["box_id"], cmd["name"])
+            elif action == "restore_snapshot":
+                await bridge.restore_snapshot(cmd["box_id"], cmd["name"])
+                result = {}
+            elif action == "list_snapshots":
+                result = await bridge.list_snapshots(cmd["box_id"])
+            elif action == "delete_snapshot":
+                await bridge.delete_snapshot(cmd["box_id"], cmd["name"])
+                result = {}
             elif action == "ping":
                 result = {"pong": True}
             else:
@@ -580,16 +698,16 @@ export function createBoxLiteLocalClient(config) {
             });
         },
         async createSnapshot(boxId, name) {
-            throw new Error('Snapshots are not yet supported in local mode');
+            return send({ action: 'create_snapshot', box_id: boxId, name });
         },
         async restoreSnapshot(boxId, name) {
-            throw new Error('Snapshots are not yet supported in local mode');
+            await send({ action: 'restore_snapshot', box_id: boxId, name });
         },
         async listSnapshots(boxId) {
-            throw new Error('Snapshots are not yet supported in local mode');
+            return send({ action: 'list_snapshots', box_id: boxId });
         },
         async deleteSnapshot(boxId, name) {
-            throw new Error('Snapshots are not yet supported in local mode');
+            await send({ action: 'delete_snapshot', box_id: boxId, name });
         },
         async dispose() {
             if (process?.stdin?.writable) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sandbank.dev/boxlite",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "BoxLite bare-metal sandbox adapter for Sandbank",
   "license": "MIT",
   "type": "module",
@@ -32,7 +32,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@sandbank.dev/core": "^0.3.0"
+    "@sandbank.dev/core": "^0.3.4"
   },
   "devDependencies": {
     "@types/node": "^25.3.0",