@archildata/api-types 0.0.4 → 0.0.6

package/index.d.ts

@@ -335,10 +335,11 @@ export interface paths {
         put?: never;
         /**
          * Create a sandbox
-         * @description Provisions a sandbox VM with the requested shape and Archil disks
-         *     mounted. By default the response reports `pending` after the runtime
-         *     accepts the start. Set `wait=true` to hold for `running`; if the wait
-         *     budget expires, the response remains `pending` and startup continues.
+         * @description Provisions a sandbox VM with the requested shape and a dedicated,
+         *     persistent Archil disk. By default the response reports `pending` after
+         *     the runtime accepts the start. Set `wait=true` to hold for `running`; if
+         *     the wait budget expires, the response remains `pending` and startup
+         *     continues.
          */
         post: operations["createSandbox"];
         delete?: never;
@@ -482,6 +483,8 @@ export interface components {
             success: boolean;
             /** @example Invalid request parameters */
             error: string;
+            /** @description Stable machine-readable error code. */
+            code?: string;
         };
         ActivityEvent: {
             accountId: string;
@@ -582,24 +585,15 @@ export interface components {
             /** Format: date-time */
             finished_at?: string;
         };
-        SandboxMount: {
-            disk_id: string;
-            /** @description Mount point relative to the sandbox's archil root. May be omitted when the sandbox mounts a single disk. */
-            relative_path?: string;
-            /** @description Expose this subdirectory of the disk instead of its root */
-            subdirectory?: string;
-            /** @description Writes against the mountpoint fail with EROFS */
-            read_only?: boolean;
-            /** @description Mount in shared mode, allowing concurrent writers on other clients. Defaults to true. */
-            shared?: boolean;
-            region?: string;
-        };
         CreateSandboxRequest: {
             vcpu_count?: number;
             mem_size_mib?: number;
             kernel?: string;
-            base_image?: string;
-            archil_mounts?: components["schemas"]["SandboxMount"][];
+            /**
+             * @description Base image for the sandbox root. Currently only `ubuntu:26.04` is supported.
+             * @default ubuntu:26.04
+             */
+            base_image: string;
             port_mappings?: components["schemas"]["SandboxPortMapping"][];
             /** @description Environment variables applied to every exec */
             env?: {
@@ -1558,7 +1552,13 @@ export interface operations {
             };
             400: components["responses"]["ValidationError"];
             401: components["responses"]["Unauthorized"];
-            /** @description Access denied (e.g., preview region not enabled) */
+            /**
+             * @description Access denied. `code` is `disk_limit_reached` (free personal
+             *     accounts have a per-region disk limit) or
+             *     `organization_plan_required` (free organizations cannot create
+             *     disks until upgraded to Team or Enterprise). Preview-region
+             *     denials carry no `code`.
+             */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -1577,6 +1577,15 @@ export interface operations {
                 };
             };
             500: components["responses"]["InternalError"];
+            /** @description Temporarily unavailable; safe to retry. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
         };
     };
     getDisk: {

package/package.json

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