disk 0.8.8 → 0.8.10

package/dist/cli.js

@@ -99,6 +99,7 @@ var Disk = class {
   metrics;
   connectedClients;
   authorizedUsers;
+  allowedIps;
   /** @internal */
   _client;
   /** @internal */
@@ -120,6 +121,7 @@ var Disk = class {
     this.metrics = data.metrics;
     this.connectedClients = data.connectedClients;
     this.authorizedUsers = data.authorizedUsers;
+    this.allowedIps = data.allowedIps;
     this._client = client;
     this._archilRegion = archilRegion;
   }
@@ -139,7 +141,8 @@ var Disk = class {
       mounts: this.mounts,
       metrics: this.metrics,
       connectedClients: this.connectedClients,
-      authorizedUsers: this.authorizedUsers
+      authorizedUsers: this.authorizedUsers,
+      allowedIps: this.allowedIps
     };
   }
   async addUser(user) {
@@ -175,6 +178,32 @@ var Disk = class {
   async removeTokenUser(identifier) {
     await this.removeUser("token", identifier);
   }
+  async getAllowedIPs() {
+    const data = await unwrap(
+      this._client.GET("/api/disks/{id}/allowed-ips", {
+        params: { path: { id: this.id } }
+      })
+    );
+    return data.allowedIps;
+  }
+  async setAllowedIPs(allowedIps) {
+    const data = await unwrap(
+      this._client.PUT("/api/disks/{id}/allowed-ips", {
+        params: { path: { id: this.id } },
+        body: { allowedIps }
+      })
+    );
+    return data.allowedIps;
+  }
+  async addAllowedIP(ip) {
+    const current = await this.getAllowedIPs();
+    if (current.includes(ip)) return current;
+    return this.setAllowedIPs([...current, ip]);
+  }
+  async removeAllowedIP(ip) {
+    const current = await this.getAllowedIPs();
+    return this.setAllowedIPs(current.filter((i) => i !== ip));
+  }
   async delete() {
     await unwrapEmpty(
       this._client.DELETE("/api/disks/{id}", {
@@ -236,7 +265,7 @@ var Disks = class {
   async list(opts) {
     const data = await unwrap(
       this._client.GET("/api/disks", {
-        params: { query: { limit: opts?.limit, cursor: opts?.cursor } }
+        params: { query: { limit: opts?.limit, cursor: opts?.cursor, name: opts?.name } }
       })
     );
     return data.map(
@@ -312,6 +341,8 @@ var Tokens = class {
 var Archil = class {
   disks;
   tokens;
+  /** @internal */
+  _client;
   constructor(opts = {}) {
     const apiKey = opts.apiKey ?? process.env.ARCHIL_API_KEY;
     const region = opts.region ?? process.env.ARCHIL_REGION;
@@ -326,9 +357,26 @@ var Archil = class {
       region,
       baseUrl: opts.baseUrl
     });
+    this._client = client;
     this.disks = new Disks(client, region);
     this.tokens = new Tokens(client);
   }
+  /**
+   * Run a command in a container with multiple disks mounted simultaneously,
+   * each at its own relative path under `/mnt/archil`. Blocks until the
+   * command completes and returns its stdout, stderr, exit code, and timing.
+   */
+  async exec(opts) {
+    const disks = {};
+    for (const [relPath, mount] of Object.entries(opts.disks)) {
+      disks[relPath] = typeof mount === "string" ? mount : mount.id;
+    }
+    return unwrap(
+      this._client.POST("/api/exec", {
+        body: { disks, command: opts.command }
+      })
+    );
+  }
 };
 
 // src/index.ts
@@ -382,6 +430,25 @@ function fail(err) {
   }
   process.exit(1);
 }
+function isDiskId(s) {
+  return /^(dsk-|fs-)[0-9a-fA-F]+$/.test(s);
+}
+async function resolveDisk(idOrName) {
+  if (isDiskId(idOrName)) {
+    return getDisk(idOrName);
+  }
+  const matches = await listDisks({ name: idOrName });
+  if (matches.length === 0) {
+    throw new ArchilApiError(`No disk found with name '${idOrName}'`, 404);
+  }
+  if (matches.length > 1) {
+    throw new ArchilApiError(
+      `Multiple disks match name '${idOrName}' \u2014 pass a disk id (dsk-...) instead`,
+      400
+    );
+  }
+  return matches[0];
+}
 function formatBytes(n) {
   if (n === void 0 || n === null) return void 0;
   if (n < 1024) return `${n} B`;
@@ -475,9 +542,9 @@ program.command("list").description("List disks in the current region").option("
     fail(err);
   }
 });
-program.command("get <id>").description("Show details for a disk").option("-o, --output <format>", "Output format: table | json", "table").action(async (id, opts) => {
+program.command("get <id|name>").description("Show details for a disk (accepts a disk id or name)").option("-o, --output <format>", "Output format: table | json", "table").action(async (idOrName, opts) => {
   try {
-    const d = await getDisk(id);
+    const d = await resolveDisk(idOrName);
     if (opts.output === "json") {
       console.log(JSON.stringify(d, null, 2));
     } else {
@@ -505,18 +572,18 @@ program.command("create <name>").description("Create a new disk").action(async (
     fail(err);
   }
 });
-program.command("delete <id>").description("Delete a disk").action(async (id) => {
+program.command("delete <id|name>").description("Delete a disk (accepts a disk id or name)").action(async (idOrName) => {
   try {
-    const d = await getDisk(id);
+    const d = await resolveDisk(idOrName);
     await d.delete();
     console.log(`Deleted ${d.organization}/${d.name} (${d.id})`);
   } catch (err) {
     fail(err);
   }
 });
-program.command("exec <id> <command...>").description("Run a command in a container with the disk mounted, return stdout/stderr/exit code").action(async (id, cmd) => {
+program.command("exec <id|name> <command...>").description("Run a command in a container with the disk mounted, return stdout/stderr/exit code (accepts a disk id or name)").action(async (idOrName, cmd) => {
   try {
-    const d = await getDisk(id);
+    const d = await resolveDisk(idOrName);
     const result = await d.exec(cmd.join(" "));
     if (result.stdout) process.stdout.write(result.stdout);
     if (result.stderr) process.stderr.write(result.stderr);

package/dist/index.cjs

@@ -39,6 +39,7 @@ __export(index_exports, {
   createApiKey: () => createApiKey,
   createDisk: () => createDisk,
   deleteApiKey: () => deleteApiKey,
+  exec: () => exec,
   getDisk: () => getDisk,
   listApiKeys: () => listApiKeys,
   listDisks: () => listDisks
@@ -141,6 +142,7 @@ var Disk = class {
   metrics;
   connectedClients;
   authorizedUsers;
+  allowedIps;
   /** @internal */
   _client;
   /** @internal */
@@ -162,6 +164,7 @@ var Disk = class {
     this.metrics = data.metrics;
     this.connectedClients = data.connectedClients;
     this.authorizedUsers = data.authorizedUsers;
+    this.allowedIps = data.allowedIps;
     this._client = client;
     this._archilRegion = archilRegion;
   }
@@ -181,7 +184,8 @@ var Disk = class {
       mounts: this.mounts,
       metrics: this.metrics,
       connectedClients: this.connectedClients,
-      authorizedUsers: this.authorizedUsers
+      authorizedUsers: this.authorizedUsers,
+      allowedIps: this.allowedIps
     };
   }
   async addUser(user) {
@@ -217,6 +221,32 @@ var Disk = class {
   async removeTokenUser(identifier) {
     await this.removeUser("token", identifier);
   }
+  async getAllowedIPs() {
+    const data = await unwrap(
+      this._client.GET("/api/disks/{id}/allowed-ips", {
+        params: { path: { id: this.id } }
+      })
+    );
+    return data.allowedIps;
+  }
+  async setAllowedIPs(allowedIps) {
+    const data = await unwrap(
+      this._client.PUT("/api/disks/{id}/allowed-ips", {
+        params: { path: { id: this.id } },
+        body: { allowedIps }
+      })
+    );
+    return data.allowedIps;
+  }
+  async addAllowedIP(ip) {
+    const current = await this.getAllowedIPs();
+    if (current.includes(ip)) return current;
+    return this.setAllowedIPs([...current, ip]);
+  }
+  async removeAllowedIP(ip) {
+    const current = await this.getAllowedIPs();
+    return this.setAllowedIPs(current.filter((i) => i !== ip));
+  }
   async delete() {
     await unwrapEmpty(
       this._client.DELETE("/api/disks/{id}", {
@@ -278,7 +308,7 @@ var Disks = class {
   async list(opts) {
     const data = await unwrap(
       this._client.GET("/api/disks", {
-        params: { query: { limit: opts?.limit, cursor: opts?.cursor } }
+        params: { query: { limit: opts?.limit, cursor: opts?.cursor, name: opts?.name } }
       })
     );
     return data.map(
@@ -354,6 +384,8 @@ var Tokens = class {
 var Archil = class {
   disks;
   tokens;
+  /** @internal */
+  _client;
   constructor(opts = {}) {
     const apiKey = opts.apiKey ?? process.env.ARCHIL_API_KEY;
     const region = opts.region ?? process.env.ARCHIL_REGION;
@@ -368,9 +400,26 @@ var Archil = class {
       region,
       baseUrl: opts.baseUrl
     });
+    this._client = client;
     this.disks = new Disks(client, region);
     this.tokens = new Tokens(client);
   }
+  /**
+   * Run a command in a container with multiple disks mounted simultaneously,
+   * each at its own relative path under `/mnt/archil`. Blocks until the
+   * command completes and returns its stdout, stderr, exit code, and timing.
+   */
+  async exec(opts) {
+    const disks = {};
+    for (const [relPath, mount] of Object.entries(opts.disks)) {
+      disks[relPath] = typeof mount === "string" ? mount : mount.id;
+    }
+    return unwrap(
+      this._client.POST("/api/exec", {
+        body: { disks, command: opts.command }
+      })
+    );
+  }
 };
 
 // src/index.ts
@@ -404,6 +453,9 @@ function createApiKey(req) {
 function deleteApiKey(id) {
   return archil().tokens.delete(id);
 }
+function exec(opts) {
+  return archil().exec(opts);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Archil,
@@ -415,6 +467,7 @@ function deleteApiKey(id) {
   createApiKey,
   createDisk,
   deleteApiKey,
+  exec,
   getDisk,
   listApiKeys,
   listDisks

package/dist/index.d.cts

@@ -102,6 +102,30 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/disks/{id}/allowed-ips": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get IP allowlist
+         * @description Returns the current IP allowlist for a disk.
+         */
+        get: operations["getAllowedIPs"];
+        /**
+         * Set IP allowlist
+         * @description Replaces the IP allowlist for a disk. When non-empty, only clients connecting from listed IPs or CIDR ranges can mount the disk. Pass an empty array to remove all restrictions.
+         */
+        put: operations["setAllowedIPs"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/disks/{id}/exec": {
         parameters: {
             query?: never;
@@ -124,6 +148,33 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/exec": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Execute a command with multiple disks mounted
+         * @description Launches a container with the supplied set of disks each mounted at its
+         *     own relative path under `/mnt/archil`, runs the command to completion,
+         *     and shuts down the container. Activation is atomic: every disk mounts
+         *     or none of them do.
+         *
+         *     Relative paths must be non-empty, non-absolute, and contain no `.` /
+         *     `..` segments. Mounting two disks at the same relative path is an
+         *     error.
+         */
+        post: operations["exec"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/tokens": {
         parameters: {
             query?: never;
@@ -197,6 +248,14 @@ interface components {
             name: string;
             /** @description Storage mount to attach. Omit for archil-managed storage. */
             mounts?: components["schemas"]["MountConfig"][];
+            /**
+             * @description IP allowlist for mount access. When non-empty, only clients connecting from these IPs or CIDR ranges can mount the disk. An empty list (default) allows all IPs.
+             * @example [
+             *       "203.0.113.0/24",
+             *       "198.51.100.42"
+             *     ]
+             */
+            allowedIps?: string[];
             /**
              * @deprecated
              * @description Deprecated. Use AddDiskUser after creation instead. When provided, suppresses the default auto-generated token user.
@@ -438,6 +497,24 @@ interface components {
             metrics?: components["schemas"]["DiskMetrics"];
             connectedClients?: components["schemas"]["ConnectedClient"][];
             authorizedUsers?: components["schemas"]["AuthorizedUser"][];
+            /**
+             * @description IP allowlist for mount access. Empty means all IPs are allowed.
+             * @example [
+             *       "203.0.113.0/24"
+             *     ]
+             */
+            allowedIps?: string[];
+            /**
+             * @description Capabilities supported by this disk. Determined at creation
+             *     time and immutable thereafter. Defined values:
+             *
+             *     * `checkpoints` — checkpoints can be created on this disk. Not
+             *       available for disks with bring-your-own buckets.
+             * @example [
+             *       "checkpoints"
+             *     ]
+             */
+            capabilities?: "checkpoints"[];
         };
         MountResponse: {
             /** @description Mount identifier */
@@ -538,6 +615,19 @@ interface components {
             success: boolean;
             data: components["schemas"]["AuthorizedUser"];
         };
+        ApiResponse_AllowedIPs: {
+            /** @example true */
+            success: boolean;
+            data: {
+                /**
+                 * @example [
+                 *       "203.0.113.0/24",
+                 *       "198.51.100.42"
+                 *     ]
+                 */
+                allowedIps: string[];
+            };
+        };
         CreateApiTokenRequest: {
             /** @description Token name */
             name: string;
@@ -616,6 +706,30 @@ interface components {
             success: boolean;
             data: components["schemas"]["ExecDiskResult"];
         };
+        ExecRequest: {
+            /**
+             * @description Map of relative path under `/mnt/archil` to the disk to mount
+             *     there. At least one entry is required. Relative paths must be
+             *     non-empty, non-absolute, and contain no `.` or `..` segments.
+             * @example {
+             *       "data": "dsk-abc123",
+             *       "logs": "dsk-def456"
+             *     }
+             */
+            disks: {
+                [key: string]: string;
+            };
+            /**
+             * @description Shell command to execute inside the container
+             * @example ls -la /mnt/archil/data /mnt/archil/logs
+             */
+            command: string;
+        };
+        ApiResponse_Exec: {
+            /** @example true */
+            success: boolean;
+            data: components["schemas"]["ExecDiskResult"];
+        };
     };
     responses: {
         /** @description Invalid or missing authentication credentials */
@@ -871,6 +985,72 @@ interface operations {
             500: components["responses"]["InternalError"];
         };
     };
+    getAllowedIPs: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Disk ID (format `dsk-{16 hex chars}`) */
+                id: components["parameters"]["DiskId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current IP allowlist */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_AllowedIPs"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
+    setAllowedIPs: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Disk ID (format `dsk-{16 hex chars}`) */
+                id: components["parameters"]["DiskId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description List of IPs or CIDR ranges. Empty array removes restrictions.
+                     * @example [
+                     *       "203.0.113.0/24",
+                     *       "198.51.100.42"
+                     *     ]
+                     */
+                    allowedIps: string[];
+                };
+            };
+        };
+        responses: {
+            /** @description Allowlist updated */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_AllowedIPs"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
     execDisk: {
         parameters: {
             query?: never;
@@ -911,6 +1091,43 @@ interface operations {
             };
         };
     };
+    exec: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ExecRequest"];
+            };
+        };
+        responses: {
+            /** @description Command completed */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_Exec"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+            /** @description Command timed out */
+            504: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     listApiTokens: {
         parameters: {
             query?: {
@@ -1014,6 +1231,7 @@ type AwsStsUser = components["schemas"]["AwsStsUser"];
 type CreateApiTokenRequest = components["schemas"]["CreateApiTokenRequest"];
 type ApiTokenResponse = components["schemas"]["ApiTokenResponse"];
 type ExecDiskResult = components["schemas"]["ExecDiskResult"];
+type ExecRequest = components["schemas"]["ExecRequest"];
 type DiskStatus = DiskResponse["status"];
 
 interface MountOptions {
@@ -1039,6 +1257,7 @@ declare class Disk {
     readonly metrics?: DiskMetrics;
     readonly connectedClients?: ConnectedClient[];
     readonly authorizedUsers?: AuthorizedUser[];
+    readonly allowedIps?: string[];
     /** @internal */
     private readonly _client;
     /** @internal */
@@ -1053,6 +1272,10 @@ declare class Disk {
         identifier: string;
     }>;
     removeTokenUser(identifier: string): Promise<void>;
+    getAllowedIPs(): Promise<string[]>;
+    setAllowedIPs(allowedIps: string[]): Promise<string[]>;
+    addAllowedIP(ip: string): Promise<string[]>;
+    removeAllowedIP(ip: string): Promise<string[]>;
     delete(): Promise<void>;
     /**
      * Execute a command in a container with this disk mounted.
@@ -1070,6 +1293,7 @@ declare class Disk {
 interface ListDisksOptions {
     limit?: number;
     cursor?: string;
+    name?: string;
 }
 interface CreateDiskResult {
     disk: Disk;
@@ -1119,10 +1343,34 @@ interface ArchilOptions {
     /** Override the control plane base URL (useful for testing). */
     baseUrl?: string;
 }
+/**
+ * One disk to mount, identified by a Disk instance or a raw disk id string.
+ * Used by Archil#exec — the map key is the relative path under /mnt/archil
+ * at which to mount the disk.
+ */
+type ExecMount = Disk | string;
+interface ExecOptions {
+    /**
+     * Disks to mount, keyed by the relative path under `/mnt/archil` at which
+     * to mount each one. At least one entry is required. Paths must be
+     * non-empty, non-absolute, and contain no `.` or `..` segments.
+     */
+    disks: Record<string, ExecMount>;
+    /** Shell command to run inside the container. */
+    command: string;
+}
 declare class Archil {
     readonly disks: Disks;
     readonly tokens: Tokens;
+    /** @internal */
+    private readonly _client;
     constructor(opts?: ArchilOptions);
+    /**
+     * Run a command in a container with multiple disks mounted simultaneously,
+     * each at its own relative path under `/mnt/archil`. Blocks until the
+     * command completes and returns its stdout, stderr, exit code, and timing.
+     */
+    exec(opts: ExecOptions): Promise<ExecDiskResult>;
 }
 
 declare class ArchilApiError extends Error {
@@ -1140,5 +1388,11 @@ declare function createApiKey(req: CreateApiTokenRequest): Promise<ApiTokenRespo
     token?: string;
 }>;
 declare function deleteApiKey(id: string): Promise<void>;
+/**
+ * Run a command in a container with multiple disks mounted simultaneously,
+ * each at its own relative path under `/mnt/archil`. Blocks until the
+ * command completes and returns its stdout, stderr, exit code, and timing.
+ */
+declare function exec(opts: ExecOptions): Promise<ExecDiskResult>;
 
-export { type ApiTokenResponse, Archil, ArchilApiError, type ArchilOptions, type AuthorizedUser, type AwsStsUser, type AzureBlobMount, type ConnectedClient, type CreateApiTokenRequest, type CreateDiskRequest, type CreateDiskResult, Disk, type DiskMetrics, type DiskResponse, type DiskStatus, type DiskUser, Disks, type ExecResult, type GCSMount, type ListDisksOptions, type ListTokensOptions, type MountConfig, type MountConfigResponse, type MountOptions, type MountResponse, type R2Mount, type S3CompatibleMount, type S3Mount, type TokenUser, Tokens, configure, createApiKey, createDisk, deleteApiKey, getDisk, listApiKeys, listDisks };
+export { type ApiTokenResponse, Archil, ArchilApiError, type ArchilOptions, type AuthorizedUser, type AwsStsUser, type AzureBlobMount, type ConnectedClient, type CreateApiTokenRequest, type CreateDiskRequest, type CreateDiskResult, Disk, type DiskMetrics, type DiskResponse, type DiskStatus, type DiskUser, Disks, type ExecMount, type ExecOptions, type ExecRequest, type ExecResult, type GCSMount, type ListDisksOptions, type ListTokensOptions, type MountConfig, type MountConfigResponse, type MountOptions, type MountResponse, type R2Mount, type S3CompatibleMount, type S3Mount, type TokenUser, Tokens, configure, createApiKey, createDisk, deleteApiKey, exec, getDisk, listApiKeys, listDisks };

package/dist/index.d.ts

@@ -102,6 +102,30 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/disks/{id}/allowed-ips": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get IP allowlist
+         * @description Returns the current IP allowlist for a disk.
+         */
+        get: operations["getAllowedIPs"];
+        /**
+         * Set IP allowlist
+         * @description Replaces the IP allowlist for a disk. When non-empty, only clients connecting from listed IPs or CIDR ranges can mount the disk. Pass an empty array to remove all restrictions.
+         */
+        put: operations["setAllowedIPs"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/disks/{id}/exec": {
         parameters: {
             query?: never;
@@ -124,6 +148,33 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/exec": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Execute a command with multiple disks mounted
+         * @description Launches a container with the supplied set of disks each mounted at its
+         *     own relative path under `/mnt/archil`, runs the command to completion,
+         *     and shuts down the container. Activation is atomic: every disk mounts
+         *     or none of them do.
+         *
+         *     Relative paths must be non-empty, non-absolute, and contain no `.` /
+         *     `..` segments. Mounting two disks at the same relative path is an
+         *     error.
+         */
+        post: operations["exec"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/tokens": {
         parameters: {
             query?: never;
@@ -197,6 +248,14 @@ interface components {
             name: string;
             /** @description Storage mount to attach. Omit for archil-managed storage. */
             mounts?: components["schemas"]["MountConfig"][];
+            /**
+             * @description IP allowlist for mount access. When non-empty, only clients connecting from these IPs or CIDR ranges can mount the disk. An empty list (default) allows all IPs.
+             * @example [
+             *       "203.0.113.0/24",
+             *       "198.51.100.42"
+             *     ]
+             */
+            allowedIps?: string[];
             /**
              * @deprecated
              * @description Deprecated. Use AddDiskUser after creation instead. When provided, suppresses the default auto-generated token user.
@@ -438,6 +497,24 @@ interface components {
             metrics?: components["schemas"]["DiskMetrics"];
             connectedClients?: components["schemas"]["ConnectedClient"][];
             authorizedUsers?: components["schemas"]["AuthorizedUser"][];
+            /**
+             * @description IP allowlist for mount access. Empty means all IPs are allowed.
+             * @example [
+             *       "203.0.113.0/24"
+             *     ]
+             */
+            allowedIps?: string[];
+            /**
+             * @description Capabilities supported by this disk. Determined at creation
+             *     time and immutable thereafter. Defined values:
+             *
+             *     * `checkpoints` — checkpoints can be created on this disk. Not
+             *       available for disks with bring-your-own buckets.
+             * @example [
+             *       "checkpoints"
+             *     ]
+             */
+            capabilities?: "checkpoints"[];
         };
         MountResponse: {
             /** @description Mount identifier */
@@ -538,6 +615,19 @@ interface components {
             success: boolean;
             data: components["schemas"]["AuthorizedUser"];
         };
+        ApiResponse_AllowedIPs: {
+            /** @example true */
+            success: boolean;
+            data: {
+                /**
+                 * @example [
+                 *       "203.0.113.0/24",
+                 *       "198.51.100.42"
+                 *     ]
+                 */
+                allowedIps: string[];
+            };
+        };
         CreateApiTokenRequest: {
             /** @description Token name */
             name: string;
@@ -616,6 +706,30 @@ interface components {
             success: boolean;
             data: components["schemas"]["ExecDiskResult"];
         };
+        ExecRequest: {
+            /**
+             * @description Map of relative path under `/mnt/archil` to the disk to mount
+             *     there. At least one entry is required. Relative paths must be
+             *     non-empty, non-absolute, and contain no `.` or `..` segments.
+             * @example {
+             *       "data": "dsk-abc123",
+             *       "logs": "dsk-def456"
+             *     }
+             */
+            disks: {
+                [key: string]: string;
+            };
+            /**
+             * @description Shell command to execute inside the container
+             * @example ls -la /mnt/archil/data /mnt/archil/logs
+             */
+            command: string;
+        };
+        ApiResponse_Exec: {
+            /** @example true */
+            success: boolean;
+            data: components["schemas"]["ExecDiskResult"];
+        };
     };
     responses: {
         /** @description Invalid or missing authentication credentials */
@@ -871,6 +985,72 @@ interface operations {
             500: components["responses"]["InternalError"];
         };
     };
+    getAllowedIPs: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Disk ID (format `dsk-{16 hex chars}`) */
+                id: components["parameters"]["DiskId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current IP allowlist */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_AllowedIPs"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
+    setAllowedIPs: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Disk ID (format `dsk-{16 hex chars}`) */
+                id: components["parameters"]["DiskId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description List of IPs or CIDR ranges. Empty array removes restrictions.
+                     * @example [
+                     *       "203.0.113.0/24",
+                     *       "198.51.100.42"
+                     *     ]
+                     */
+                    allowedIps: string[];
+                };
+            };
+        };
+        responses: {
+            /** @description Allowlist updated */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_AllowedIPs"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
     execDisk: {
         parameters: {
             query?: never;
@@ -911,6 +1091,43 @@ interface operations {
             };
         };
     };
+    exec: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ExecRequest"];
+            };
+        };
+        responses: {
+            /** @description Command completed */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_Exec"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+            /** @description Command timed out */
+            504: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     listApiTokens: {
         parameters: {
             query?: {
@@ -1014,6 +1231,7 @@ type AwsStsUser = components["schemas"]["AwsStsUser"];
 type CreateApiTokenRequest = components["schemas"]["CreateApiTokenRequest"];
 type ApiTokenResponse = components["schemas"]["ApiTokenResponse"];
 type ExecDiskResult = components["schemas"]["ExecDiskResult"];
+type ExecRequest = components["schemas"]["ExecRequest"];
 type DiskStatus = DiskResponse["status"];
 
 interface MountOptions {
@@ -1039,6 +1257,7 @@ declare class Disk {
     readonly metrics?: DiskMetrics;
     readonly connectedClients?: ConnectedClient[];
     readonly authorizedUsers?: AuthorizedUser[];
+    readonly allowedIps?: string[];
     /** @internal */
     private readonly _client;
     /** @internal */
@@ -1053,6 +1272,10 @@ declare class Disk {
         identifier: string;
     }>;
     removeTokenUser(identifier: string): Promise<void>;
+    getAllowedIPs(): Promise<string[]>;
+    setAllowedIPs(allowedIps: string[]): Promise<string[]>;
+    addAllowedIP(ip: string): Promise<string[]>;
+    removeAllowedIP(ip: string): Promise<string[]>;
     delete(): Promise<void>;
     /**
      * Execute a command in a container with this disk mounted.
@@ -1070,6 +1293,7 @@ declare class Disk {
 interface ListDisksOptions {
     limit?: number;
     cursor?: string;
+    name?: string;
 }
 interface CreateDiskResult {
     disk: Disk;
@@ -1119,10 +1343,34 @@ interface ArchilOptions {
     /** Override the control plane base URL (useful for testing). */
     baseUrl?: string;
 }
+/**
+ * One disk to mount, identified by a Disk instance or a raw disk id string.
+ * Used by Archil#exec — the map key is the relative path under /mnt/archil
+ * at which to mount the disk.
+ */
+type ExecMount = Disk | string;
+interface ExecOptions {
+    /**
+     * Disks to mount, keyed by the relative path under `/mnt/archil` at which
+     * to mount each one. At least one entry is required. Paths must be
+     * non-empty, non-absolute, and contain no `.` or `..` segments.
+     */
+    disks: Record<string, ExecMount>;
+    /** Shell command to run inside the container. */
+    command: string;
+}
 declare class Archil {
     readonly disks: Disks;
     readonly tokens: Tokens;
+    /** @internal */
+    private readonly _client;
     constructor(opts?: ArchilOptions);
+    /**
+     * Run a command in a container with multiple disks mounted simultaneously,
+     * each at its own relative path under `/mnt/archil`. Blocks until the
+     * command completes and returns its stdout, stderr, exit code, and timing.
+     */
+    exec(opts: ExecOptions): Promise<ExecDiskResult>;
 }
 
 declare class ArchilApiError extends Error {
@@ -1140,5 +1388,11 @@ declare function createApiKey(req: CreateApiTokenRequest): Promise<ApiTokenRespo
     token?: string;
 }>;
 declare function deleteApiKey(id: string): Promise<void>;
+/**
+ * Run a command in a container with multiple disks mounted simultaneously,
+ * each at its own relative path under `/mnt/archil`. Blocks until the
+ * command completes and returns its stdout, stderr, exit code, and timing.
+ */
+declare function exec(opts: ExecOptions): Promise<ExecDiskResult>;
 
-export { type ApiTokenResponse, Archil, ArchilApiError, type ArchilOptions, type AuthorizedUser, type AwsStsUser, type AzureBlobMount, type ConnectedClient, type CreateApiTokenRequest, type CreateDiskRequest, type CreateDiskResult, Disk, type DiskMetrics, type DiskResponse, type DiskStatus, type DiskUser, Disks, type ExecResult, type GCSMount, type ListDisksOptions, type ListTokensOptions, type MountConfig, type MountConfigResponse, type MountOptions, type MountResponse, type R2Mount, type S3CompatibleMount, type S3Mount, type TokenUser, Tokens, configure, createApiKey, createDisk, deleteApiKey, getDisk, listApiKeys, listDisks };
+export { type ApiTokenResponse, Archil, ArchilApiError, type ArchilOptions, type AuthorizedUser, type AwsStsUser, type AzureBlobMount, type ConnectedClient, type CreateApiTokenRequest, type CreateDiskRequest, type CreateDiskResult, Disk, type DiskMetrics, type DiskResponse, type DiskStatus, type DiskUser, Disks, type ExecMount, type ExecOptions, type ExecRequest, type ExecResult, type GCSMount, type ListDisksOptions, type ListTokensOptions, type MountConfig, type MountConfigResponse, type MountOptions, type MountResponse, type R2Mount, type S3CompatibleMount, type S3Mount, type TokenUser, Tokens, configure, createApiKey, createDisk, deleteApiKey, exec, getDisk, listApiKeys, listDisks };

package/dist/index.js

@@ -93,6 +93,7 @@ var Disk = class {
   metrics;
   connectedClients;
   authorizedUsers;
+  allowedIps;
   /** @internal */
   _client;
   /** @internal */
@@ -114,6 +115,7 @@ var Disk = class {
     this.metrics = data.metrics;
     this.connectedClients = data.connectedClients;
     this.authorizedUsers = data.authorizedUsers;
+    this.allowedIps = data.allowedIps;
     this._client = client;
     this._archilRegion = archilRegion;
   }
@@ -133,7 +135,8 @@ var Disk = class {
       mounts: this.mounts,
       metrics: this.metrics,
       connectedClients: this.connectedClients,
-      authorizedUsers: this.authorizedUsers
+      authorizedUsers: this.authorizedUsers,
+      allowedIps: this.allowedIps
     };
   }
   async addUser(user) {
@@ -169,6 +172,32 @@ var Disk = class {
   async removeTokenUser(identifier) {
     await this.removeUser("token", identifier);
   }
+  async getAllowedIPs() {
+    const data = await unwrap(
+      this._client.GET("/api/disks/{id}/allowed-ips", {
+        params: { path: { id: this.id } }
+      })
+    );
+    return data.allowedIps;
+  }
+  async setAllowedIPs(allowedIps) {
+    const data = await unwrap(
+      this._client.PUT("/api/disks/{id}/allowed-ips", {
+        params: { path: { id: this.id } },
+        body: { allowedIps }
+      })
+    );
+    return data.allowedIps;
+  }
+  async addAllowedIP(ip) {
+    const current = await this.getAllowedIPs();
+    if (current.includes(ip)) return current;
+    return this.setAllowedIPs([...current, ip]);
+  }
+  async removeAllowedIP(ip) {
+    const current = await this.getAllowedIPs();
+    return this.setAllowedIPs(current.filter((i) => i !== ip));
+  }
   async delete() {
     await unwrapEmpty(
       this._client.DELETE("/api/disks/{id}", {
@@ -230,7 +259,7 @@ var Disks = class {
   async list(opts) {
     const data = await unwrap(
       this._client.GET("/api/disks", {
-        params: { query: { limit: opts?.limit, cursor: opts?.cursor } }
+        params: { query: { limit: opts?.limit, cursor: opts?.cursor, name: opts?.name } }
       })
     );
     return data.map(
@@ -306,6 +335,8 @@ var Tokens = class {
 var Archil = class {
   disks;
   tokens;
+  /** @internal */
+  _client;
   constructor(opts = {}) {
     const apiKey = opts.apiKey ?? process.env.ARCHIL_API_KEY;
     const region = opts.region ?? process.env.ARCHIL_REGION;
@@ -320,9 +351,26 @@ var Archil = class {
       region,
       baseUrl: opts.baseUrl
     });
+    this._client = client;
     this.disks = new Disks(client, region);
     this.tokens = new Tokens(client);
   }
+  /**
+   * Run a command in a container with multiple disks mounted simultaneously,
+   * each at its own relative path under `/mnt/archil`. Blocks until the
+   * command completes and returns its stdout, stderr, exit code, and timing.
+   */
+  async exec(opts) {
+    const disks = {};
+    for (const [relPath, mount] of Object.entries(opts.disks)) {
+      disks[relPath] = typeof mount === "string" ? mount : mount.id;
+    }
+    return unwrap(
+      this._client.POST("/api/exec", {
+        body: { disks, command: opts.command }
+      })
+    );
+  }
 };
 
 // src/index.ts
@@ -356,6 +404,9 @@ function createApiKey(req) {
 function deleteApiKey(id) {
   return archil().tokens.delete(id);
 }
+function exec(opts) {
+  return archil().exec(opts);
+}
 export {
   Archil,
   ArchilApiError,
@@ -366,6 +417,7 @@ export {
   createApiKey,
   createDisk,
   deleteApiKey,
+  exec,
   getDisk,
   listApiKeys,
   listDisks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "disk",
-  "version": "0.8.8",
+  "version": "0.8.10",
   "description": "Pure-JS client and CLI for Archil disks",
   "type": "module",
   "main": "dist/index.cjs",