@archildata/api-types 0.0.42 → 0.0.43

package/index.d.ts

@@ -664,7 +664,8 @@ export interface paths {
          *     was paused, its memory snapshot is consumed and discarded before the
          *     new VM runs; disk state remains. Starting a running sandbox or a pending
          *     cold start is idempotent. A sandbox that is stopping, pausing, or
-         *     pending a resume returns 409.
+         *     pending a resume returns 409. An optional body replaces the sandbox's
+         *     disk mounts for this and later sessions.
          */
         post: operations["startSandbox"];
         delete?: never;
@@ -823,6 +824,7 @@ export interface components {
              * @default false
              */
             enable_service_ingress: boolean;
+            mounts?: components["schemas"]["SandboxMount"][];
             /** Format: date-time */
             created_at: string;
             /** Format: date-time */
@@ -840,6 +842,22 @@ export interface components {
              */
             checkpoint?: string;
         };
+        SandboxMount: {
+            disk_id: string;
+            /** @description Absolute guest directory to mount at. Required when more than one disk is mounted; a sole mount defaults to /mnt/archil. Guest system directories (/usr, /etc, /var, /opt, ...) are reserved, and a disk can be mounted once per sandbox. */
+            path?: string;
+            /** @description Relative subdirectory of the disk to expose instead of its root. */
+            subdirectory?: string;
+            /** @default false */
+            read_only: boolean;
+            /**
+             * @description Send mutating operations directly to the server without a delegation checkout, allowing concurrent writers.
+             * @default false
+             */
+            conditional: boolean;
+            /** @description Milliseconds to wait for the disk's exclusive root delegation before the mount fails. Not allowed with read_only or conditional. */
+            queue_ms?: number;
+        };
         SandboxEndpoint: {
             port: number;
             hostname: string;
@@ -953,6 +971,8 @@ export interface components {
                 [key: string]: string;
             };
             network?: components["schemas"]["SandboxNetwork"];
+            /** @description Archil disks mounted inside the guest for the first session; `start` can replace them for later sessions. Inherited by forks. A sandbox with mounts must be stopped before it can be forked. */
+            mounts?: components["schemas"]["SandboxMount"][];
             /**
              * @description Lifetime budget applied independently to each powered-on session. Expiry pauses the sandbox, preserving memory and processes for resume.
              * @default 86400
@@ -963,6 +983,10 @@ export interface components {
             /** @description Maximum number of concurrently attached process sessions. Detached processes and one-shot process controls do not count. */
             max_concurrent_execs?: number;
         };
+        StartSandboxRequest: {
+            /** @description Replace the sandbox's disk mounts for this and later sessions. Omit to keep the current ones. Not accepted by resume, and 409 while the sandbox is running or pending. */
+            mounts?: components["schemas"]["SandboxMount"][];
+        };
         ForkSandboxRequest: {
             /** @description Name for the fork. A random word-list name is generated when omitted. */
             name?: string;
@@ -2515,6 +2539,7 @@ export interface operations {
             };
             400: components["responses"]["ValidationError"];
             401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
             /** @description The requested sandbox name already exists in the account */
             409: {
                 headers: {
@@ -3104,7 +3129,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["StartSandboxRequest"];
+            };
+        };
         responses: {
             /** @description The sandbox was already running */
             200: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archildata/api-types",
-  "version": "0.0.42",
+  "version": "0.0.43",
   "description": "API types for the Archil control plane",
   "type": "module",
   "types": "index.d.ts",