tensorlake 0.5.2 → 0.5.4

package/dist/{sandbox-image-B0WMhyoM.d.cts → sandbox-image-BmhjX2bC.d.cts}

@@ -12,16 +12,25 @@ declare enum SnapshotStatus {
     FAILED = "failed"
 }
 /**
- * Content mode for snapshot creation.
+ * Snapshot type for sandbox snapshot creation.
  *
- * - `"full"`: Full VM snapshot (memory + filesystem state). Sandboxes
- *   restored from this snapshot warm-restore VM memory.
- * - `"filesystem_only"`: Filesystem-only snapshot. Sandboxes restored from
+ * - `"memory"`: Capture VM memory + filesystem state. Sandboxes restored
+ *   from this snapshot warm-restore VM memory.
+ * - `"filesystem"`: Capture filesystem state only. Sandboxes restored from
  *   this snapshot cold-boot from the snapshot tarball instead of warm-
  *   restoring VM state. Use this for sandbox image builds so that the
  *   restored sandbox bypasses Firecracker's overlay-path constraints.
  */
-type SnapshotContentMode = "full" | "filesystem_only";
+type SnapshotType = "memory" | "filesystem";
+/**
+ * Checkpoint type for {@link Sandbox.checkpoint}.
+ *
+ * - `"memory"`: Capture VM memory + filesystem state. Sandboxes restored
+ *   from this checkpoint warm-restore VM memory and running processes.
+ * - `"filesystem"`: Capture filesystem state only. Sandboxes restored from
+ *   this checkpoint cold-boot from the snapshot tarball.
+ */
+type CheckpointType = "memory" | "filesystem";
 declare enum ProcessStatus {
     RUNNING = "running",
     EXITED = "exited",
@@ -120,6 +129,7 @@ interface SnapshotInfo {
     sandboxId: string;
     baseImage: string;
     status: SnapshotStatus;
+    snapshotType?: SnapshotType;
     error?: string;
     snapshotUri?: string;
     sizeBytes?: number;
@@ -128,11 +138,11 @@ interface SnapshotInfo {
 }
 interface SnapshotOptions {
     /**
-     * Optional content mode for the snapshot. When omitted the server picks
-     * its default. Use `"filesystem_only"` for snapshots intended for sandbox
-     * image builds so that restored sandboxes cold-boot.
+     * Optional snapshot type. When omitted the server picks its default. Use
+     * `"filesystem"` for snapshots intended for sandbox image builds so that
+     * restored sandboxes cold-boot.
      */
-    contentMode?: SnapshotContentMode;
+    snapshotType?: SnapshotType;
 }
 interface SnapshotAndWaitOptions extends SnapshotOptions {
     timeout?: number;
@@ -292,7 +302,7 @@ interface SuspendResumeOptions {
     pollInterval?: number;
 }
 interface CheckpointOptions extends SuspendResumeOptions {
-    contentMode?: SnapshotContentMode;
+    checkpointType?: CheckpointType;
 }
 interface ConnectOptions {
     sandboxId: string;
@@ -413,7 +423,7 @@ interface BuildClient {
     snapshotAndWait(sandboxId: string, options?: {
         timeout?: number;
         pollInterval?: number;
-        contentMode?: SnapshotContentMode;
+        snapshotType?: SnapshotType;
     }): Promise<SnapshotInfo>;
     close(): void;
 }
@@ -433,4 +443,4 @@ declare function loadImagePlan(image: Image, options?: Pick<CreateSandboxImageOp
 declare function createSandboxImage(source: SandboxImageSource, options?: CreateSandboxImageOptions, deps?: CreateSandboxImageDeps): Promise<Record<string, unknown>>;
 declare function runCreateSandboxImageCli(argv?: string[]): Promise<void>;
 
-export { loadDockerfilePlan as $, type DirectoryEntry as A, type DockerfileBuildPlan as B, type CreatePtySessionOptions as C, type DaemonInfo as D, type DockerfileInstruction as E, type ImageBuildOperation as F, ImageBuildOperationType as G, type HealthResponse as H, Image as I, type ImageOptions as J, OutputMode as K, type ListDirectoryResponse as L, type PoolContainerInfo as M, type NetworkConfig as N, type OutputResponse as O, type ProcessInfo as P, ProcessStatus as Q, type RunOptions as R, type SandboxOptions as S, type SandboxImageSource as T, type UpdateSandboxOptions as U, type SnapshotContentMode as V, SnapshotStatus as W, StdinMode as X, createSandboxImage as Y, dockerfileContent as Z, defaultRegisteredName as _, type CreateAndConnectOptions as a, loadImagePlan as a0, logicalDockerfileLines as a1, runCreateSandboxImageCli as a2, type SandboxClientOptions as b, type ConnectOptions as c, type SnapshotInfo as d, SandboxStatus as e, type SandboxInfo as f, type SuspendResumeOptions as g, type CheckpointOptions as h, type CommandResult as i, type StartProcessOptions as j, type SendSignalResponse as k, type OutputEvent as l, type PtySessionInfo as m, type CreateSandboxOptions as n, type CreateSandboxResponse as o, type SandboxPortAccess as p, type SnapshotOptions as q, type CreateSnapshotResponse as r, type SnapshotAndWaitOptions as s, type CreatePoolOptions as t, type CreateSandboxPoolResponse as u, type SandboxPoolInfo as v, type UpdatePoolOptions as w, type ContainerResourcesInfo as x, ContainerState as y, type CreateSandboxImageOptions as z };
+export { defaultRegisteredName as $, type CreateSandboxImageOptions as A, type DirectoryEntry as B, type CreatePtySessionOptions as C, type DaemonInfo as D, type DockerfileBuildPlan as E, type DockerfileInstruction as F, type ImageBuildOperation as G, type HealthResponse as H, Image as I, ImageBuildOperationType as J, type ImageOptions as K, type ListDirectoryResponse as L, OutputMode as M, type NetworkConfig as N, type OutputResponse as O, type ProcessInfo as P, type PoolContainerInfo as Q, type RunOptions as R, type SandboxOptions as S, ProcessStatus as T, type UpdateSandboxOptions as U, type SandboxImageSource as V, SnapshotStatus as W, type SnapshotType as X, StdinMode as Y, createSandboxImage as Z, dockerfileContent as _, type CreateAndConnectOptions as a, loadDockerfilePlan as a0, loadImagePlan as a1, logicalDockerfileLines as a2, runCreateSandboxImageCli as a3, type SandboxClientOptions as b, type ConnectOptions as c, type SnapshotInfo as d, SandboxStatus as e, type SandboxInfo as f, type SuspendResumeOptions as g, type CheckpointOptions as h, type CommandResult as i, type StartProcessOptions as j, type SendSignalResponse as k, type OutputEvent as l, type PtySessionInfo as m, type CreateSandboxOptions as n, type CreateSandboxResponse as o, type SandboxPortAccess as p, type SnapshotOptions as q, type CreateSnapshotResponse as r, type SnapshotAndWaitOptions as s, type CreatePoolOptions as t, type CreateSandboxPoolResponse as u, type SandboxPoolInfo as v, type UpdatePoolOptions as w, type CheckpointType as x, type ContainerResourcesInfo as y, ContainerState as z };

package/dist/{sandbox-image-B0WMhyoM.d.ts → sandbox-image-BmhjX2bC.d.ts}

@@ -12,16 +12,25 @@ declare enum SnapshotStatus {
     FAILED = "failed"
 }
 /**
- * Content mode for snapshot creation.
+ * Snapshot type for sandbox snapshot creation.
  *
- * - `"full"`: Full VM snapshot (memory + filesystem state). Sandboxes
- *   restored from this snapshot warm-restore VM memory.
- * - `"filesystem_only"`: Filesystem-only snapshot. Sandboxes restored from
+ * - `"memory"`: Capture VM memory + filesystem state. Sandboxes restored
+ *   from this snapshot warm-restore VM memory.
+ * - `"filesystem"`: Capture filesystem state only. Sandboxes restored from
  *   this snapshot cold-boot from the snapshot tarball instead of warm-
  *   restoring VM state. Use this for sandbox image builds so that the
  *   restored sandbox bypasses Firecracker's overlay-path constraints.
  */
-type SnapshotContentMode = "full" | "filesystem_only";
+type SnapshotType = "memory" | "filesystem";
+/**
+ * Checkpoint type for {@link Sandbox.checkpoint}.
+ *
+ * - `"memory"`: Capture VM memory + filesystem state. Sandboxes restored
+ *   from this checkpoint warm-restore VM memory and running processes.
+ * - `"filesystem"`: Capture filesystem state only. Sandboxes restored from
+ *   this checkpoint cold-boot from the snapshot tarball.
+ */
+type CheckpointType = "memory" | "filesystem";
 declare enum ProcessStatus {
     RUNNING = "running",
     EXITED = "exited",
@@ -120,6 +129,7 @@ interface SnapshotInfo {
     sandboxId: string;
     baseImage: string;
     status: SnapshotStatus;
+    snapshotType?: SnapshotType;
     error?: string;
     snapshotUri?: string;
     sizeBytes?: number;
@@ -128,11 +138,11 @@ interface SnapshotInfo {
 }
 interface SnapshotOptions {
     /**
-     * Optional content mode for the snapshot. When omitted the server picks
-     * its default. Use `"filesystem_only"` for snapshots intended for sandbox
-     * image builds so that restored sandboxes cold-boot.
+     * Optional snapshot type. When omitted the server picks its default. Use
+     * `"filesystem"` for snapshots intended for sandbox image builds so that
+     * restored sandboxes cold-boot.
      */
-    contentMode?: SnapshotContentMode;
+    snapshotType?: SnapshotType;
 }
 interface SnapshotAndWaitOptions extends SnapshotOptions {
     timeout?: number;
@@ -292,7 +302,7 @@ interface SuspendResumeOptions {
     pollInterval?: number;
 }
 interface CheckpointOptions extends SuspendResumeOptions {
-    contentMode?: SnapshotContentMode;
+    checkpointType?: CheckpointType;
 }
 interface ConnectOptions {
     sandboxId: string;
@@ -413,7 +423,7 @@ interface BuildClient {
     snapshotAndWait(sandboxId: string, options?: {
         timeout?: number;
         pollInterval?: number;
-        contentMode?: SnapshotContentMode;
+        snapshotType?: SnapshotType;
     }): Promise<SnapshotInfo>;
     close(): void;
 }
@@ -433,4 +443,4 @@ declare function loadImagePlan(image: Image, options?: Pick<CreateSandboxImageOp
 declare function createSandboxImage(source: SandboxImageSource, options?: CreateSandboxImageOptions, deps?: CreateSandboxImageDeps): Promise<Record<string, unknown>>;
 declare function runCreateSandboxImageCli(argv?: string[]): Promise<void>;
 
-export { loadDockerfilePlan as $, type DirectoryEntry as A, type DockerfileBuildPlan as B, type CreatePtySessionOptions as C, type DaemonInfo as D, type DockerfileInstruction as E, type ImageBuildOperation as F, ImageBuildOperationType as G, type HealthResponse as H, Image as I, type ImageOptions as J, OutputMode as K, type ListDirectoryResponse as L, type PoolContainerInfo as M, type NetworkConfig as N, type OutputResponse as O, type ProcessInfo as P, ProcessStatus as Q, type RunOptions as R, type SandboxOptions as S, type SandboxImageSource as T, type UpdateSandboxOptions as U, type SnapshotContentMode as V, SnapshotStatus as W, StdinMode as X, createSandboxImage as Y, dockerfileContent as Z, defaultRegisteredName as _, type CreateAndConnectOptions as a, loadImagePlan as a0, logicalDockerfileLines as a1, runCreateSandboxImageCli as a2, type SandboxClientOptions as b, type ConnectOptions as c, type SnapshotInfo as d, SandboxStatus as e, type SandboxInfo as f, type SuspendResumeOptions as g, type CheckpointOptions as h, type CommandResult as i, type StartProcessOptions as j, type SendSignalResponse as k, type OutputEvent as l, type PtySessionInfo as m, type CreateSandboxOptions as n, type CreateSandboxResponse as o, type SandboxPortAccess as p, type SnapshotOptions as q, type CreateSnapshotResponse as r, type SnapshotAndWaitOptions as s, type CreatePoolOptions as t, type CreateSandboxPoolResponse as u, type SandboxPoolInfo as v, type UpdatePoolOptions as w, type ContainerResourcesInfo as x, ContainerState as y, type CreateSandboxImageOptions as z };
+export { defaultRegisteredName as $, type CreateSandboxImageOptions as A, type DirectoryEntry as B, type CreatePtySessionOptions as C, type DaemonInfo as D, type DockerfileBuildPlan as E, type DockerfileInstruction as F, type ImageBuildOperation as G, type HealthResponse as H, Image as I, ImageBuildOperationType as J, type ImageOptions as K, type ListDirectoryResponse as L, OutputMode as M, type NetworkConfig as N, type OutputResponse as O, type ProcessInfo as P, type PoolContainerInfo as Q, type RunOptions as R, type SandboxOptions as S, ProcessStatus as T, type UpdateSandboxOptions as U, type SandboxImageSource as V, SnapshotStatus as W, type SnapshotType as X, StdinMode as Y, createSandboxImage as Z, dockerfileContent as _, type CreateAndConnectOptions as a, loadDockerfilePlan as a0, loadImagePlan as a1, logicalDockerfileLines as a2, runCreateSandboxImageCli as a3, type SandboxClientOptions as b, type ConnectOptions as c, type SnapshotInfo as d, SandboxStatus as e, type SandboxInfo as f, type SuspendResumeOptions as g, type CheckpointOptions as h, type CommandResult as i, type StartProcessOptions as j, type SendSignalResponse as k, type OutputEvent as l, type PtySessionInfo as m, type CreateSandboxOptions as n, type CreateSandboxResponse as o, type SandboxPortAccess as p, type SnapshotOptions as q, type CreateSnapshotResponse as r, type SnapshotAndWaitOptions as s, type CreatePoolOptions as t, type CreateSandboxPoolResponse as u, type SandboxPoolInfo as v, type UpdatePoolOptions as w, type CheckpointType as x, type ContainerResourcesInfo as y, ContainerState as z };

package/dist/sandbox-image.cjs

@@ -3297,13 +3297,13 @@ var init_sandbox = __esm({
       async checkpoint(options) {
         const client = this.requireLifecycleClient("checkpoint");
         if (options?.wait === false) {
-          await client.snapshot(this.lifecycleIdentifier, { contentMode: options.contentMode });
+          await client.snapshot(this.lifecycleIdentifier, { snapshotType: options.checkpointType });
           return void 0;
         }
         return client.snapshotAndWait(this.lifecycleIdentifier, {
           timeout: options?.timeout,
           pollInterval: options?.pollInterval,
-          contentMode: options?.contentMode
+          snapshotType: options?.checkpointType
         });
       }
       /**
@@ -3962,11 +3962,11 @@ var init_client = __esm({
        * status — the snapshot is created asynchronously. Poll `getSnapshot()` until
        * `completed` or `failed`, or use `snapshotAndWait()` to block automatically.
        *
-       * @param options.contentMode - `"filesystem_only"` for cold-boot snapshots (e.g. image builds).
-       *   Omit to use the server default (full VM snapshot).
+       * @param options.snapshotType - `"filesystem"` for cold-boot snapshots (e.g. image builds).
+       *   Omit to use the server default (`filesystem`).
        */
       async snapshot(sandboxId, options) {
-        const requestOptions = options?.contentMode != null ? { body: { snapshot_content_mode: options.contentMode } } : void 0;
+        const requestOptions = options?.snapshotType != null ? { body: { snapshot_type: options.snapshotType } } : void 0;
         const raw = await this.http.requestJson(
           "POST",
           this.path(`sandboxes/${sandboxId}/snapshot`),
@@ -4010,14 +4010,14 @@ var init_client = __esm({
        * @param sandboxId - ID of the running sandbox to snapshot.
        * @param options.timeout - Max seconds to wait (default 300).
        * @param options.pollInterval - Seconds between status polls (default 1).
-       * @param options.contentMode - Content mode passed through to `snapshot()`.
+       * @param options.snapshotType - Snapshot type passed through to `snapshot()`.
        * @throws {SandboxError} If the snapshot fails or `timeout` elapses.
        */
       async snapshotAndWait(sandboxId, options) {
         const timeout = options?.timeout ?? 300;
         const pollInterval = options?.pollInterval ?? 1;
         const result = await this.snapshot(sandboxId, {
-          contentMode: options?.contentMode
+          snapshotType: options?.snapshotType
         });
         const deadline = Date.now() + timeout * 1e3;
         while (Date.now() < deadline) {
@@ -4916,7 +4916,7 @@ async function createSandboxImage(source, options = {}, deps = {}) {
     await executeDockerfilePlan(sandbox, plan, emit, sleep3);
     emit({ type: "status", message: "Creating snapshot..." });
     const snapshot = await client.snapshotAndWait(sandbox.sandboxId, {
-      contentMode: "filesystem_only"
+      snapshotType: "filesystem"
     });
     emit({
       type: "snapshot_created",
@@ -4977,25 +4977,25 @@ async function runCreateSandboxImageCli(argv = process.argv.slice(2)) {
       name: { type: "string", short: "n" },
       cpus: { type: "string" },
       memory: { type: "string" },
-      disk: { type: "string" },
+      disk_mb: { type: "string" },
       public: { type: "boolean", default: false }
     }
   });
   const dockerfilePath = parsed.positionals[0];
   if (!dockerfilePath) {
-    throw new Error("Usage: tensorlake-create-sandbox-image <dockerfile_path> [--name NAME] [--cpus N] [--memory MB] [--disk GB] [--public]");
+    throw new Error("Usage: tensorlake-create-sandbox-image <dockerfile_path> [--name NAME] [--cpus N] [--memory MB] [--disk_mb MB] [--public]");
   }
   const cpus = parsed.values.cpus != null ? Number(parsed.values.cpus) : void 0;
   const memoryMb = parsed.values.memory != null ? Number(parsed.values.memory) : void 0;
-  const diskGb = parsed.values.disk != null ? Number(parsed.values.disk) : void 0;
+  const diskMb = parsed.values.disk_mb != null ? Number(parsed.values.disk_mb) : void 0;
   if (cpus != null && !Number.isFinite(cpus)) {
     throw new Error(`Invalid --cpus value: ${parsed.values.cpus}`);
   }
   if (memoryMb != null && !Number.isInteger(memoryMb)) {
     throw new Error(`Invalid --memory value: ${parsed.values.memory}`);
   }
-  if (diskGb != null && !Number.isInteger(diskGb)) {
-    throw new Error(`Invalid --disk value: ${parsed.values.disk}`);
+  if (diskMb != null && !Number.isInteger(diskMb)) {
+    throw new Error(`Invalid --disk_mb value: ${parsed.values.disk_mb}`);
   }
   await createSandboxImage(
     dockerfilePath,
@@ -5003,7 +5003,7 @@ async function runCreateSandboxImageCli(argv = process.argv.slice(2)) {
       registeredName: parsed.values.name,
       cpus,
       memoryMb,
-      diskMb: diskGb != null ? diskGb * 1024 : void 0,
+      diskMb,
       isPublic: parsed.values.public
     },
     { emit: ndjsonStdoutEmit }