@archildata/api-types 0.0.34 → 0.0.35

package/index.d.ts

@@ -570,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;
@@ -725,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 */
@@ -737,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. */
@@ -756,11 +762,6 @@ 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: {
@@ -829,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;
         };
@@ -2805,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.34",
+  "version": "0.0.35",
   "description": "API types for the Archil control plane",
   "type": "module",
   "types": "index.d.ts",