isol8 0.10.3 → 0.11.1

package/README.md

@@ -78,6 +78,7 @@ isol8 setup --node lodash,axios
 | `--bun <pkgs>` | Comma-separated bun packages |
 | `--deno <pkgs>` | Comma-separated Deno module URLs to cache |
 | `--bash <pkgs>` | Comma-separated Alpine apk packages |
+| `--force` | Force rebuild even if images are up to date |
 
 ### `isol8 run`
 
@@ -124,12 +125,27 @@ isol8 run script.py --host http://server:3000 --key my-api-key
 | `--tmp-size <size>` | Tmp tmpfs size (e.g. `256m`, `512m`) | `256m` |
 | `--stdin <data>` | Data to pipe to stdin | — |
 | `--install <pkg>` | Install package for runtime (repeatable) | — |
+| `--url <url>` | Fetch code from URL (requires `remoteCode.enabled=true`) | — |
+| `--github <owner/repo/ref/path>` | GitHub shorthand for raw source | — |
+| `--gist <gistId/file.ext>` | Gist shorthand for raw source | — |
+| `--hash <sha256>` | Verify SHA-256 hash for fetched code | — |
+| `--allow-insecure-code-url` | Allow insecure `http://` code URLs for this request | `false` |
 | `--host <url>` | Remote server URL | — |
 | `--key <key>` | API key for remote server | `$ISOL8_API_KEY` |
 
+### Remote Code URLs
+
+```bash
+# URL source
+isol8 run --url https://raw.githubusercontent.com/user/repo/main/script.py --runtime python
+
+# GitHub shorthand with hash verification
+isol8 run --github user/repo/main/script.py --hash <sha256> --runtime python
+```
+
 ### `isol8 cleanup`
 
-Remove orphaned isol8 containers.
+Remove orphaned isol8 containers, and optionally isol8 images.
 
 ```bash
 # Interactive (prompts for confirmation)
@@ -137,6 +153,9 @@ isol8 cleanup
 
 # Force (skip confirmation)
 isol8 cleanup --force
+
+# Also remove isol8 images
+isol8 cleanup --images --force
 ```
 
 ### `isol8 serve`
@@ -186,6 +205,10 @@ console.log(result.exitCode); // 0
 console.log(result.durationMs); // ~120-140ms (warm pool)
 
 await isol8.stop();
+
+// Optional manual cleanup helpers
+await DockerIsol8.cleanup(); // remove isol8 containers
+await DockerIsol8.cleanupImages(); // remove isol8 images
 ```
 
 ### Pool Strategy
@@ -215,6 +238,8 @@ const secureEngine = new DockerIsol8({
 **Fast mode details:**
 - Maintains two pools: `clean` (ready to use) and `dirty` (need cleanup)
 - `acquire()` returns instantly from clean pool if available
+- Every clean-pool acquire triggers async replenishment to restore warm capacity
+- Simple no-artifact executions use inline runtime commands, skipping code-file injection overhead
 - If clean pool is empty but dirty has containers, tries immediate cleanup
 - Background cleanup runs every 5 seconds to process dirty containers
 - Best performance with minimal memory overhead