@aerol-ai/aerolvm-sdk 0.1.10 → 0.2.2

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, RegisterSnapshotOptions, ResizeOptions, SandboxSnapshot, Session, SessionAttachHandle, SessionAttachOptions } from "./types.js";
+import type { BuildImageOptions, BuildImageResult, CreateOptions, CreateSessionOptions, ExecStreamHandle, ExecStreamOptions, HealthStatus, Lifecycle, ListOptions, MountSpecRedacted, RegisterSnapshotOptions, ResizeOptions, SandboxSnapshot, Session, SessionAttachHandle, SessionAttachOptions } from "./types.js";
 type FetchLike = typeof fetch;
 export interface MicroVMConfig {
     patToken?: string;
@@ -21,7 +21,7 @@ export declare class MicroVM {
     private readonly client;
     constructor(config?: MicroVMConfig);
     create(options: CreateOptions): Promise<Sandbox>;
-    list(): Promise<Sandbox[]>;
+    list(options?: ListOptions): Promise<Sandbox[]>;
     get(id: string): Promise<Sandbox>;
     start(id: string): Promise<Sandbox>;
     stop(id: string): Promise<Sandbox>;

package/dist/MicroVM.js

@@ -25,8 +25,8 @@ export class MicroVM {
         const sandbox = await this.client.create(options);
         return this.wrap(sandbox.toJSON());
     }
-    async list() {
-        const sandboxes = await this.client.list();
+    async list(options) {
+        const sandboxes = await this.client.list(options);
         return sandboxes.map((sandbox) => this.wrap(sandbox.toJSON()));
     }
     async get(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, 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, 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
@@ -55,7 +55,7 @@ export declare class APIClient {
      */
     buildImage(image: Image, options?: BuildImageOptions): Promise<BuildImageResult>;
     private resolveImage;
-    list(): Promise<SandboxResource[]>;
+    list(options?: ListOptions): Promise<SandboxResource[]>;
     get(id: string): Promise<SandboxResource>;
     start(id: string): Promise<SandboxResource>;
     stop(id: string): Promise<SandboxResource>;
@@ -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

@@ -85,8 +85,9 @@ export class APIClient {
         const result = await this.buildImage(options.image);
         return { ...options, image: result.image };
     }
-    async list() {
-        const response = await this.doJSON("GET", this.versioned("/sandboxes"));
+    async list(options) {
+        const path = this.versioned("/sandboxes") + buildTagQuery(options?.tags);
+        const response = await this.doJSON("GET", path);
         return response.map((item) => this.wrap(item));
     }
     async get(id) {
@@ -387,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,
     };
 }
@@ -439,6 +441,11 @@ function toApiLifecycle(lifecycle) {
         destroy_at_age: lifecycle.destroyAtAge,
     };
 }
+function toApiFailover(failover) {
+    return {
+        policy: failover.policy,
+    };
+}
 function fromApiSandbox(sandbox) {
     return {
         id: sandbox.id,
@@ -462,6 +469,7 @@ function fromApiSandbox(sandbox) {
         lastError: sandbox.last_error,
         containerCommand: sandbox.container_command,
         lifecycle: fromApiLifecycle(sandbox.lifecycle),
+        failover: fromApiFailover(sandbox.failover),
         runtime: normalizeRuntime(sandbox.runtime),
     };
 }
@@ -608,6 +616,28 @@ function fromApiLifecycle(lifecycle) {
     }
     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
+// percent-encoded. An empty or absent map returns "" so the request URL is
+// byte-identical to the pre-filter call site (no trailing "?"), keeping
+// fixtures and middleware that match on path stable.
+function buildTagQuery(tags) {
+    if (!tags)
+        return "";
+    const entries = Object.entries(tags);
+    if (entries.length === 0)
+        return "";
+    const parts = entries.map(([key, value]) => `tag.${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
+    return "?" + parts.join("&");
+}
 function cloneSandbox(sandbox) {
     return {
         ...sandbox,
@@ -615,6 +645,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

@@ -75,6 +75,14 @@ export interface Lifecycle {
     destroyAtAge?: number;
 }
 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 +146,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
@@ -161,6 +170,15 @@ export interface ResizeOptions {
     memoryMB?: number;
     diskGB?: number;
 }
+export interface ListOptions {
+    /**
+     * Filter the result to only sandboxes whose `tags` map contains every
+     * key/value pair given here (AND semantics on the server). Wire format is
+     * `?tag.<key>=<value>`; the SDK URL-encodes keys and values for you. Omit
+     * or pass an empty map to list every sandbox visible to the PAT.
+     */
+    tags?: Record<string, string>;
+}
 export interface CreateSessionOptions {
     name?: string;
     argv?: string[];
@@ -259,6 +277,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.1.10",
+  "version": "0.2.2",
   "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"
   }
 }