@aerol-ai/aerolvm-sdk 0.1.9 → 0.1.10

package/dist/MicroVM.d.ts

@@ -1,7 +1,7 @@
 import { type APIVersion } from "./internal/client.js";
 import { Sandbox } from "./Sandbox.js";
 import { Image } from "./Image.js";
-import type { BuildImageOptions, BuildImageResult, CreateOptions, CreateSessionOptions, ExecStreamHandle, ExecStreamOptions, HealthStatus, Lifecycle, MountSpecRedacted, ResizeOptions, SandboxSnapshot, Session, SessionAttachHandle, SessionAttachOptions } from "./types.js";
+import type { BuildImageOptions, BuildImageResult, CreateOptions, CreateSessionOptions, ExecStreamHandle, ExecStreamOptions, HealthStatus, Lifecycle, MountSpecRedacted, RegisterSnapshotOptions, ResizeOptions, SandboxSnapshot, Session, SessionAttachHandle, SessionAttachOptions } from "./types.js";
 type FetchLike = typeof fetch;
 export interface MicroVMConfig {
     patToken?: string;
@@ -26,6 +26,8 @@ export declare class MicroVM {
     start(id: string): Promise<Sandbox>;
     stop(id: string): Promise<Sandbox>;
     createSnapshot(id: string, name: string): Promise<SandboxSnapshot>;
+    registerSnapshot(options: RegisterSnapshotOptions): Promise<SandboxSnapshot>;
+    registerSnapshotFromImage(name: string, image: Image, options?: Omit<RegisterSnapshotOptions, "name" | "image" | "dockerfileContent">): Promise<SandboxSnapshot>;
     destroy(id: string): Promise<void>;
     resize(id: string, options: ResizeOptions): Promise<Sandbox>;
     updateLifecycle(id: string, lifecycle: Lifecycle): Promise<Sandbox>;

package/dist/MicroVM.js

@@ -44,6 +44,12 @@ export class MicroVM {
     async createSnapshot(id, name) {
         return this.client.createSnapshot(id, name);
     }
+    async registerSnapshot(options) {
+        return this.client.registerSnapshot(options);
+    }
+    async registerSnapshotFromImage(name, image, options = {}) {
+        return this.client.registerSnapshotFromImage(name, image, options);
+    }
     async destroy(id) {
         await this.client.destroy(id);
     }

package/dist/index.d.ts

@@ -2,4 +2,4 @@ export { MicroVM } from "./MicroVM.js";
 export { Sandbox } from "./Sandbox.js";
 export { Image } from "./Image.js";
 export type { MicroVMConfig } from "./MicroVM.js";
-export type { BinaryLike, BuildImageOptions, BuildImagePushOptions, BuildImageResult, CreateOptions, CreateSessionOptions, ExecRequest, ExecResult, ExecExitInfo, ExposedPort, ExposePortOptions, ExposeProtocol, ExposeResult, HealthStatus, Lifecycle, MountSpec, MountSpecRedacted, MountType, RegistryAuth, ResizeOptions, Sandbox as SandboxData, SandboxSnapshot, SandboxStatus, Session, SessionAttachHandle, SessionAttachOptions, SessionStatus, UpdateLifecycleOptions, } from "./types.js";
+export type { BinaryLike, BuildImageOptions, BuildImagePushOptions, BuildImageResult, CreateOptions, CreateSessionOptions, ExecRequest, ExecResult, ExecExitInfo, ExposedPort, ExposePortOptions, ExposeProtocol, ExposeResult, HealthStatus, Lifecycle, MountSpec, MountSpecRedacted, MountType, RegisterSnapshotOptions, RegistryAuth, ResizeOptions, Sandbox as SandboxData, SandboxSnapshot, SandboxStatus, Session, SessionAttachHandle, SessionAttachOptions, SessionStatus, UpdateLifecycleOptions, } from "./types.js";

package/dist/internal/client.d.ts

@@ -1,5 +1,5 @@
 import { Image } from "../Image.js";
-import type { BinaryLike, BuildImageOptions, BuildImageResult, CreateOptions, CreateSessionOptions, ExecRequest, ExecResult, ExecStreamHandle, ExecStreamOptions, ExposedPort, ExposePortOptions, ExposeResult, HealthStatus, Lifecycle, MountSpecRedacted, NetworkUsage, SetNetworkLimitsOptions, ResizeOptions, Sandbox, SandboxSnapshot, Session, SessionAttachHandle, SessionAttachOptions } from "../types.js";
+import type { BinaryLike, BuildImageOptions, BuildImageResult, CreateOptions, CreateSessionOptions, ExecRequest, ExecResult, ExecStreamHandle, ExecStreamOptions, ExposedPort, ExposePortOptions, ExposeResult, HealthStatus, Lifecycle, MountSpecRedacted, NetworkUsage, RegisterSnapshotOptions, SetNetworkLimitsOptions, ResizeOptions, Sandbox, SandboxSnapshot, Session, SessionAttachHandle, SessionAttachOptions } from "../types.js";
 type FetchLike = typeof fetch;
 /**
  * Wire version of the v1-style sandbox endpoints (`/v1/sandboxes`, etc.) this
@@ -60,6 +60,8 @@ export declare class APIClient {
     start(id: string): Promise<SandboxResource>;
     stop(id: string): Promise<SandboxResource>;
     createSnapshot(id: string, name: string): Promise<SandboxSnapshot>;
+    registerSnapshot(options: RegisterSnapshotOptions): Promise<SandboxSnapshot>;
+    registerSnapshotFromImage(name: string, image: Image, options?: Omit<RegisterSnapshotOptions, "name" | "image" | "dockerfileContent">): Promise<SandboxSnapshot>;
     destroy(id: string): Promise<void>;
     resize(id: string, options: ResizeOptions): Promise<SandboxResource>;
     updateLifecycle(id: string, lifecycle: Lifecycle): Promise<SandboxResource>;

package/dist/internal/client.js

@@ -105,6 +105,35 @@ export class APIClient {
         const response = await this.doJSON("POST", `${this.versionPrefix}/sandboxes/${id}/snapshot`, { name });
         return fromApiSandboxSnapshot(response);
     }
+    async registerSnapshot(options) {
+        const name = options.name.trim();
+        if (name === "") {
+            throw new Error("name is required");
+        }
+        const image = options.image?.trim() ?? "";
+        const dockerfileContent = options.dockerfileContent?.trim() ?? "";
+        if (image === "" && dockerfileContent === "") {
+            throw new Error("image or dockerfile_content is required");
+        }
+        if (image !== "" && dockerfileContent !== "") {
+            throw new Error("image and dockerfile_content are mutually exclusive");
+        }
+        const response = await this.doJSON("POST", this.versioned("/snapshots"), toApiRegisterSnapshotOptions({
+            ...options,
+            name,
+            image: image || undefined,
+            dockerfileContent: dockerfileContent || undefined,
+            regionID: options.regionID?.trim() || undefined,
+        }));
+        return fromApiSandboxSnapshot(response);
+    }
+    async registerSnapshotFromImage(name, image, options = {}) {
+        return this.registerSnapshot({
+            ...options,
+            name,
+            dockerfileContent: image.dockerfile,
+        });
+    }
     async destroy(id) {
         await this.doJSON("DELETE", `${this.versionPrefix}/sandboxes/${id}`);
     }
@@ -361,6 +390,20 @@ function toApiCreateOptions(options) {
         runtime: options.runtime,
     };
 }
+function toApiRegisterSnapshotOptions(options) {
+    return {
+        name: options.name,
+        image: options.image,
+        dockerfile_content: options.dockerfileContent,
+        context_hashes: options.contextHashes,
+        entrypoint: options.entrypoint,
+        region_id: options.regionID,
+        cpu: options.cpu,
+        gpu: options.gpu,
+        memory_mb: options.memoryMB,
+        disk_gb: options.diskGB,
+    };
+}
 function toApiResizeOptions(options) {
     return {
         cpu: options.cpu,
@@ -444,6 +487,12 @@ function fromApiSandboxSnapshot(snapshot) {
         imageID: snapshot.image_id,
         sourceSandboxID: snapshot.source_sandbox_id,
         createdAt: snapshot.created_at,
+        entrypoint: snapshot.entrypoint,
+        regionID: snapshot.region_id,
+        cpu: snapshot.cpu,
+        gpu: snapshot.gpu,
+        memoryMB: snapshot.memory_mb,
+        diskGB: snapshot.disk_gb,
     };
 }
 function fromApiSession(session) {

package/dist/types.d.ts

@@ -28,6 +28,25 @@ export interface BuildImageResult {
     /** Pushed reference, e.g. "ghcr.io/my-org/my-image:v1.2.3". */
     pushed?: string;
 }
+export interface RegisterSnapshotOptions {
+    /** Human-readable identifier other callers use in `CreateOptions.snapshot`. */
+    name: string;
+    /** Pre-built registry reference. Mutually exclusive with `dockerfileContent`. */
+    image?: string;
+    /** Literal Dockerfile the daemon will build. Mutually exclusive with `image`. */
+    dockerfileContent?: string;
+    /** Uploaded build-context hashes for future COPY/ADD resolution. */
+    contextHashes?: string[];
+    /** Optional command override persisted on the snapshot row. */
+    entrypoint?: string[];
+    /** Region hint persisted for read-back. */
+    regionID?: string;
+    /** Resource hints surfaced back on the snapshot row. */
+    cpu?: number;
+    gpu?: number;
+    memoryMB?: number;
+    diskGB?: number;
+}
 export type MountType = "s3" | "nfs" | "sshfs" | "rclone";
 export interface MountSpec {
     type: MountType;
@@ -192,6 +211,12 @@ export interface SandboxSnapshot {
     imageID?: string;
     sourceSandboxID: string;
     createdAt: string;
+    entrypoint?: string[];
+    regionID?: string;
+    cpu?: number;
+    gpu?: number;
+    memoryMB?: number;
+    diskGB?: number;
 }
 /**
  * Discriminated result from `exposePort`. Branch on `protocol` to access the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aerol-ai/aerolvm-sdk",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",