@aerol-ai/aerolvm-sdk 0.2.1 → 0.2.3

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, RegisterSnapshotOptions, 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, Failover, FailoverPolicy, 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, ListOptions, MountSpecRedacted, NetworkUsage, RegisterSnapshotOptions, SetNetworkLimitsOptions, ResizeOptions, Sandbox, SandboxSnapshot, Session, SessionAttachHandle, SessionAttachOptions } from "../types.js";
+import type { BinaryLike, BuildImageOptions, BuildImageResult, CreateOptions, CreateSessionOptions, ExecRequest, ExecResult, ExecStreamHandle, ExecStreamOptions, ExposedPort, ExposePortOptions, ExposeResult, Failover, HealthStatus, Lifecycle, ListOptions, 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
@@ -126,6 +126,7 @@ export declare class SandboxResource implements Sandbox {
     lastError?: string;
     containerCommand?: string[];
     lifecycle: Lifecycle;
+    failover?: Failover;
     runtime: Sandbox["runtime"];
     protected readonly client: APIClient;
     constructor(client: APIClient, sandbox: Sandbox);

package/dist/internal/client.js

@@ -388,6 +388,7 @@ function toApiCreateOptions(options) {
         container_command: options.containerCommand,
         mounts: options.mounts?.map(toApiMountSpec),
         lifecycle: options.lifecycle ? toApiLifecycle(options.lifecycle) : undefined,
+        failover: options.failover ? toApiFailover(options.failover) : undefined,
         runtime: options.runtime,
     };
 }
@@ -438,6 +439,12 @@ function toApiLifecycle(lifecycle) {
         destroy_if_idle_for: lifecycle.destroyIfIdleFor,
         stop_at_age: lifecycle.stopAtAge,
         destroy_at_age: lifecycle.destroyAtAge,
+        serverless: lifecycle.serverless,
+    };
+}
+function toApiFailover(failover) {
+    return {
+        policy: failover.policy,
     };
 }
 function fromApiSandbox(sandbox) {
@@ -463,6 +470,7 @@ function fromApiSandbox(sandbox) {
         lastError: sandbox.last_error,
         containerCommand: sandbox.container_command,
         lifecycle: fromApiLifecycle(sandbox.lifecycle),
+        failover: fromApiFailover(sandbox.failover),
         runtime: normalizeRuntime(sandbox.runtime),
     };
 }
@@ -607,8 +615,18 @@ function fromApiLifecycle(lifecycle) {
     if (lifecycle?.destroy_at_age !== undefined) {
         result.destroyAtAge = lifecycle.destroy_at_age;
     }
+    if (lifecycle?.serverless) {
+        result.serverless = true;
+    }
     return result;
 }
+function fromApiFailover(failover) {
+    const policy = failover?.policy;
+    if (policy !== "recreate" && policy !== "none") {
+        return undefined;
+    }
+    return { policy };
+}
 // buildTagQuery renders ListOptions.tags as the server's wire format. The
 // `tag.` prefix is literal — the server's parseTagFilter does a prefix check
 // on the *decoded* query key, so only the user-supplied key and value get
@@ -631,6 +649,7 @@ function cloneSandbox(sandbox) {
         exposedPorts: sandbox.exposedPorts?.map((port) => ({ ...port })),
         containerCommand: sandbox.containerCommand ? [...sandbox.containerCommand] : undefined,
         lifecycle: { ...sandbox.lifecycle },
+        failover: sandbox.failover ? { ...sandbox.failover } : undefined,
     };
 }
 function toBlob(data) {

package/dist/types.d.ts

@@ -73,8 +73,23 @@ export interface Lifecycle {
     stopAtAge?: number;
     /** Duration in integer nanoseconds. */
     destroyAtAge?: number;
+    /**
+     * Opt the sandbox into HTTP wake-on-request: auto-stop when idle,
+     * resume on the next inbound HTTP request. Requires `stopIfIdleFor`
+     * to be set explicitly — the server rejects `serverless: true`
+     * without an idle window. TCP and TLS exposures stay always-on.
+     */
+    serverless?: boolean;
 }
 export type UpdateLifecycleOptions = Lifecycle;
+export type FailoverPolicy = "none" | "recreate";
+export interface Failover {
+    /**
+     * "none" (default) returns 410 Gone after owner-node death. "recreate"
+     * opts into best-effort cluster recreation from the replicated create spec.
+     */
+    policy: FailoverPolicy;
+}
 export type GPUVendor = "nvidia" | "amd" | "apple";
 export interface GPUOptions {
     /**
@@ -138,6 +153,7 @@ export interface CreateOptions {
     containerCommand?: string[];
     mounts?: MountSpec[];
     lifecycle?: Lifecycle;
+    failover?: Failover;
     /**
      * Container runtime to use for this sandbox. Omit to inherit the host
      * default (`SB_CONTAINER_RUNTIME`). Use `"gvisor"` for runsc-backed
@@ -268,6 +284,7 @@ export interface Sandbox {
     lastError?: string;
     containerCommand?: string[];
     lifecycle: Lifecycle;
+    failover?: Failover;
     /**
      * Container runtime this sandbox is running under. Empty string indicates
      * a pre-migration row that resolves to the host default at start time.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aerol-ai/aerolvm-sdk",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -21,8 +21,8 @@
     "test": "tsc -p tsconfig.test.json --outDir dist-test && node --test dist-test/*.test.js dist-test/internal/*.test.js"
   },
   "devDependencies": {
-    "@types/node": "^25.6.2",
+    "@types/node": "^25.8.0",
     "typescript": "^6.0.3",
-    "tsx": "^4.21.0"
+    "tsx": "^4.22.3"
   }
 }