@lizard-build/sdk 0.1.36 → 0.1.37

package/README.md

@@ -82,7 +82,7 @@ sandbox.kill()
 
 ## Persisting Work Across Sandboxes
 
-Sandboxes are **ephemeral**: killing one, or letting it hit its timeout, discards everything written inside it. State that has to outlive a sandbox goes on a **volume** — a separate disk mounted at `/data` that a later sandbox re-attaches.
+Sandboxes are **ephemeral**: killing one, or letting it hit its timeout, discards everything written inside it. State that has to outlive a sandbox goes on a **volume** — a separate disk mounted at `/workspace` that a later sandbox re-attaches.
 
 A volume is node-local, so it fixes the region too. You don't thread a region through both calls: the sandbox is placed wherever its volume already lives.
 
@@ -90,25 +90,25 @@ A volume is node-local, so it fixes the region too. You don't thread a region th
 const vol = await lizard.volumes.getOrCreate('agent-scratch', { sizeGb: 10 })
 
 const first = await lizard.create('codex', { volumeName: 'agent-scratch' })
-await first.process.exec('pip install numpy pandas && echo "notes" > /data/notes.txt')
-await first.kill()          // sandbox gone, /data survives
+await first.process.exec('pip install numpy pandas && echo "notes" > /workspace/notes.txt')
+await first.kill()          // sandbox gone, /workspace survives
 
 const second = await lizard.create('codex', { volumeName: 'agent-scratch' })
-console.log(await second.fs.read('/data/notes.txt'))   // "notes"
+console.log(await second.fs.read('/workspace/notes.txt'))   // "notes"
 ```
 
 ```python
 vol = lizard.volumes.get_or_create("agent-scratch", size_gb=10)
 
 first = lizard.create("codex", volume_name="agent-scratch")
-first.process.exec_('echo "notes" > /data/notes.txt')
-first.kill()                # sandbox gone, /data survives
+first.process.exec_('echo "notes" > /workspace/notes.txt')
+first.kill()                # sandbox gone, /workspace survives
 
 second = lizard.create("codex", volume_name="agent-scratch")
-print(second.fs.read("/data/notes.txt"))   # "notes"
+print(second.fs.read("/workspace/notes.txt"))   # "notes"
 ```
 
-Note that only `/data` survives — installed packages and in-memory state do not. Bake tooling into a template instead of reinstalling it per sandbox.
+Note that only `/workspace` survives — installed packages and in-memory state do not. Bake tooling into a template instead of reinstalling it per sandbox.
 
 > `pause()` / `resume()` exist on the client but are **not implemented** for the current runtime and always fail with HTTP 501. Use a volume.
 

package/dist/index.d.mts

@@ -303,10 +303,10 @@ interface SandboxOpts extends ConnectionOpts {
      * Defaults to the platform's default sandbox region.
      */
     region?: string;
-    /** Attach a persistent volume by id, mounted at `/data`. */
+    /** Attach a persistent volume by id, mounted at `/workspace`. */
     volumeId?: string;
     /**
-     * Attach a persistent volume by name, mounted at `/data`. A volume's name is its
+     * Attach a persistent volume by name, mounted at `/workspace`. A volume's name is its
      * key inside a project, so this is usually what you want — see {@link Volume}.
      * Requires the sandbox's project to be given as an exact `projectId`.
      */
@@ -361,7 +361,7 @@ declare class SandboxClient {
  *
  * Sandboxes are **ephemeral**: killing one, or letting it hit its timeout, discards
  * everything written inside it. State that has to outlive a sandbox belongs on a
- * {@link Volume}, which is a separate disk you mount at `/data` and re-attach to a
+ * {@link Volume}, which is a separate disk you mount at `/workspace` and re-attach to a
  * later sandbox.
  *
  * @example Basic usage:
@@ -380,13 +380,13 @@ declare class SandboxClient {
  * const vol = await Volume.getOrCreate(projectId, 'agent-scratch', { sizeGb: 10 })
  *
  * const first = await Sandbox.create('codex', { projectId, volumeName: 'agent-scratch' })
- * await first.process.exec('echo "notes" > /data/notes.txt')
+ * await first.process.exec('echo "notes" > /workspace/notes.txt')
  * await first.kill()
  *
  * // A different sandbox, the same disk. No region to thread through: the sandbox
  * // is placed wherever the volume already lives.
  * const second = await Sandbox.create('codex', { projectId, volumeName: 'agent-scratch' })
- * console.log(await second.fs.read('/data/notes.txt')) // "notes"
+ * console.log(await second.fs.read('/workspace/notes.txt')) // "notes"
  * ```
  */
 declare class Sandbox extends SandboxClient {

package/dist/index.d.ts

@@ -303,10 +303,10 @@ interface SandboxOpts extends ConnectionOpts {
      * Defaults to the platform's default sandbox region.
      */
     region?: string;
-    /** Attach a persistent volume by id, mounted at `/data`. */
+    /** Attach a persistent volume by id, mounted at `/workspace`. */
     volumeId?: string;
     /**
-     * Attach a persistent volume by name, mounted at `/data`. A volume's name is its
+     * Attach a persistent volume by name, mounted at `/workspace`. A volume's name is its
      * key inside a project, so this is usually what you want — see {@link Volume}.
      * Requires the sandbox's project to be given as an exact `projectId`.
      */
@@ -361,7 +361,7 @@ declare class SandboxClient {
  *
  * Sandboxes are **ephemeral**: killing one, or letting it hit its timeout, discards
  * everything written inside it. State that has to outlive a sandbox belongs on a
- * {@link Volume}, which is a separate disk you mount at `/data` and re-attach to a
+ * {@link Volume}, which is a separate disk you mount at `/workspace` and re-attach to a
  * later sandbox.
  *
  * @example Basic usage:
@@ -380,13 +380,13 @@ declare class SandboxClient {
  * const vol = await Volume.getOrCreate(projectId, 'agent-scratch', { sizeGb: 10 })
  *
  * const first = await Sandbox.create('codex', { projectId, volumeName: 'agent-scratch' })
- * await first.process.exec('echo "notes" > /data/notes.txt')
+ * await first.process.exec('echo "notes" > /workspace/notes.txt')
  * await first.kill()
  *
  * // A different sandbox, the same disk. No region to thread through: the sandbox
  * // is placed wherever the volume already lives.
  * const second = await Sandbox.create('codex', { projectId, volumeName: 'agent-scratch' })
- * console.log(await second.fs.read('/data/notes.txt')) // "notes"
+ * console.log(await second.fs.read('/workspace/notes.txt')) // "notes"
  * ```
  */
 declare class Sandbox extends SandboxClient {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lizard-build/sdk",
-  "version": "0.1.36",
+  "version": "0.1.37",
   "description": "Firecracker microVM sandboxes for AI agents — boot Linux in milliseconds, run code, write files, expose ports over HTTPS, then pause a session with memory intact and resume it later. TypeScript SDK for Lizard Sandboxes (lizard.build).",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",