@aerol-ai/aerolvm-sdk 0.1.10 → 0.2.1

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/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, 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>;

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) {
@@ -608,6 +609,21 @@ function fromApiLifecycle(lifecycle) {
     }
     return result;
 }
+// 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,

package/dist/types.d.ts

@@ -161,6 +161,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[];

package/package.json

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