@archildata/api-types 0.0.33 → 0.0.35

package/index.d.ts

@@ -412,6 +412,50 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/sandboxes/{sid}/ports": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List exposed sandbox ports
+         * @description Lists the explicitly exposed public ports for the sandbox.
+         */
+        get: operations["listSandboxPorts"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/sandboxes/{sid}/ports/{port}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Expose a sandbox port
+         * @description Creates or returns public access to a TCP port in the sandbox.
+         */
+        put: operations["exposeSandboxPort"];
+        post?: never;
+        /**
+         * Stop exposing a sandbox port
+         * @description Removes an explicitly exposed public port. An enabled sandbox service publishing the same TCP port remains publicly reachable.
+         */
+        delete: operations["deleteSandboxPort"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/sandboxes/{sid}/pause": {
         parameters: {
             query?: never;
@@ -526,13 +570,15 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Set a sandbox's timeout
-         * @description Replaces the sandbox's lifetime budget and, while it is running, resets
-         *     its expiration deadline to the requested number of seconds from now.
-         *     The new budget is retained across later stops and starts. For an
-         *     inactive sandbox, it applies to the next powered-on session. Sandboxes
-         *     that are starting or shutting down, or whose timeout changes
-         *     concurrently, return 409.
+         * Set a sandbox's timeouts
+         * @description Replaces one or both sandbox timeout settings. Updating `timeout` while
+         *     the sandbox is running resets its hard expiration deadline to that many
+         *     seconds from now. Updating `idle_ttl_seconds` resets the idle
+         *     countdown when no direct process connection is active; zero disables
+         *     idle expiry. Omitted settings remain unchanged. Updates are retained
+         *     across later stops and starts. For an inactive sandbox, they apply to
+         *     the next powered-on session. Sandboxes that are starting or shutting
+         *     down, or whose timeout changes concurrently, return 409.
          */
         post: operations["setSandboxTimeout"];
         delete?: never;
@@ -681,7 +727,9 @@ export interface components {
         };
         SandboxTimeoutRequest: {
             /** @description Seconds from now until a running sandbox expires, and the lifetime budget for its next powered-on session. */
-            timeout: number;
+            timeout?: number;
+            /** @description Seconds without a direct process connection before the sandbox pauses. Zero disables idle expiry. */
+            idle_ttl_seconds?: number;
         };
         Sandbox: {
             /** Format: uuid */
@@ -693,6 +741,8 @@ export interface components {
             mem_size_mib: number;
             /** @description Lifetime budget applied independently to each powered-on session. Expiry pauses the sandbox, preserving memory and processes for resume. Defaults to 24 hours and can be reset with the timeout endpoint. */
             max_ttl_seconds: number;
+            /** @description Seconds without a direct process connection before the sandbox pauses, preserving memory and processes for resume. Zero disables idle expiry. */
+            idle_ttl_seconds: number;
             /** @description Maximum number of concurrently attached process sessions. Detached processes and one-shot process controls do not count. */
             max_concurrent_execs: number;
             /** @description OCI reference requested when the sandbox was created. */
@@ -702,6 +752,7 @@ export interface components {
              * @enum {string}
              */
             platform?: "arm64" | "amd64";
+            /** @description Public hostnames published by enabled sandbox services. */
             endpoints?: components["schemas"]["SandboxEndpoint"][];
             /** Format: date-time */
             created_at: string;
@@ -711,17 +762,29 @@ export interface components {
             finished_at?: string;
             /** Format: date-time */
             last_active_at: string;
-            /**
-             * Format: date-time
-             * @description Current powered-on session deadline; absent while inactive.
-             */
-            expires_at?: string;
             exit_reason?: string;
         };
         SandboxEndpoint: {
             port: number;
             hostname: string;
         };
+        SandboxPort: {
+            port: number;
+            hostname: string;
+        };
+        SandboxPortList: {
+            ports: components["schemas"]["SandboxPort"][];
+        };
+        ApiResponse_SandboxPort: {
+            /** @example true */
+            success: boolean;
+            data: components["schemas"]["SandboxPort"];
+        };
+        ApiResponse_SandboxPortList: {
+            /** @example true */
+            success: boolean;
+            data: components["schemas"]["SandboxPortList"];
+        };
         SandboxConnection: {
             /** Format: uri */
             url: string;
@@ -733,11 +796,6 @@ export interface components {
             success: boolean;
             data: components["schemas"]["SandboxConnection"];
         };
-        SandboxPortMapping: {
-            container_port: number;
-            /** @enum {string} */
-            protocol: "tcp" | "udp";
-        };
         ApiResponse_Sandbox: {
             /** @example true */
             success: boolean;
@@ -760,7 +818,8 @@ export interface components {
              * @default ubuntu:26.04
              */
             base_image: string;
-            port_mappings?: components["schemas"]["SandboxPortMapping"][];
+            /** @description TCP ports to expose publicly when the sandbox is created. */
+            ports?: number[];
             /** @description Environment variables applied to every process */
             env?: {
                 [key: string]: string;
@@ -771,6 +830,8 @@ export interface components {
              * @default 86400
              */
             max_ttl_seconds: number;
+            /** @description Pause after this many seconds without a direct process connection, preserving memory and processes for resume. Omit or set to zero to disable idle expiry. */
+            idle_ttl_seconds?: number;
             /** @description Maximum number of concurrently attached process sessions. Detached processes and one-shot process controls do not count. */
             max_concurrent_execs?: number;
         };
@@ -2426,6 +2487,95 @@ export interface operations {
             500: components["responses"]["InternalError"];
         };
     };
+    listSandboxPorts: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Sandbox UUID */
+                sid: components["parameters"]["SandboxId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Exposed sandbox ports */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_SandboxPortList"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
+    exposeSandboxPort: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Sandbox UUID */
+                sid: components["parameters"]["SandboxId"];
+                port: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Existing exposed port */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_SandboxPort"];
+                };
+            };
+            /** @description Port was exposed */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_SandboxPort"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
+    deleteSandboxPort: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Sandbox UUID */
+                sid: components["parameters"]["SandboxId"];
+                port: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Sandbox port is no longer explicitly exposed */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
     pauseSandbox: {
         parameters: {
             query?: never;
@@ -2658,7 +2808,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description The sandbox timeout was set */
+            /** @description The sandbox timeouts were set */
             200: {
                 headers: {
                     [name: string]: unknown;

package/package.json

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