@archildata/api-types 0.0.28 → 0.0.29

package/index.d.ts

@@ -514,6 +514,31 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/sandboxes/{sid}/timeout": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        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.
+         */
+        post: operations["setSandboxTimeout"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/sandboxes/{sid}/start": {
         parameters: {
             query?: never;
@@ -643,6 +668,10 @@ export interface components {
         SandboxNetwork: {
             egress?: components["schemas"]["SandboxEgressPolicy"];
         };
+        SandboxTimeoutRequest: {
+            /** @description Seconds from now until a running sandbox expires, and the lifetime budget for its next powered-on session. */
+            timeout: number;
+        };
         Sandbox: {
             /** Format: uuid */
             sandbox_id: string;
@@ -651,7 +680,7 @@ export interface components {
             status: components["schemas"]["SandboxState"];
             vcpu_count: number;
             mem_size_mib: number;
-            /** @description Full lifetime budget applied independently to each powered-on session. */
+            /** @description Full lifetime budget applied independently to each powered-on session. Defaults to 24 hours and can be reset with the timeout endpoint. */
             max_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;
@@ -726,8 +755,11 @@ export interface components {
                 [key: string]: string;
             };
             network?: components["schemas"]["SandboxNetwork"];
-            /** @description Lifetime budget applied independently to each powered-on session */
-            max_ttl_seconds?: number;
+            /**
+             * @description Lifetime budget applied independently to each powered-on session
+             * @default 86400
+             */
+            max_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;
         };
@@ -2588,6 +2620,47 @@ export interface operations {
             503: components["responses"]["RetryableUnavailable"];
         };
     };
+    setSandboxTimeout: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Sandbox UUID */
+                sid: components["parameters"]["SandboxId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SandboxTimeoutRequest"];
+            };
+        };
+        responses: {
+            /** @description The sandbox timeout was set */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_Sandbox"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            /** @description The sandbox is transitioning or its timeout changed concurrently */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            500: components["responses"]["InternalError"];
+            503: components["responses"]["RetryableUnavailable"];
+        };
+    };
     startSandbox: {
         parameters: {
             query?: {

package/package.json

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