@archildata/api-types 0.0.34 → 0.0.36

package/index.d.ts

@@ -498,6 +498,12 @@ export interface paths {
          *     cold-boot from the saved disk checkpoint. A running source is
          *     resumed after its checkpoint; paused and stopped sources remain
          *     inactive. Forked sandboxes may themselves be forked.
+         *
+         *     Passing `checkpoint` forks that saved state without touching the
+         *     source, so clients can pause once, wait for the checkpoint, and fork
+         *     it from any number of places. Without `checkpoint` the server pauses a
+         *     running source inside the request and resumes it afterwards; that path
+         *     is kept for older clients and is bounded by the request timeout.
          */
         post: operations["forkSandbox"];
         delete?: never;
@@ -570,13 +576,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 +733,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 +747,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,12 +768,14 @@ export interface components {
             finished_at?: string;
             /** Format: date-time */
             last_active_at: string;
+            exit_reason?: string;
             /**
-             * Format: date-time
-             * @description Current powered-on session deadline; absent while inactive.
+             * @description Disk checkpoint the current session leaves behind. Present while
+             *     pausing, paused, stopping, or stopped, and committed once the
+             *     sandbox is paused or stopped. Pass it to the fork endpoint to fork
+             *     exactly this state.
              */
-            expires_at?: string;
-            exit_reason?: string;
+            checkpoint?: string;
         };
         SandboxEndpoint: {
             port: number;
@@ -829,12 +843,22 @@ 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;
         };
         ForkSandboxRequest: {
             /** @description Name for the fork. A random word-list name is generated when omitted. */
             name?: string;
+            /**
+             * @description Fork this checkpoint of the source, as returned by pause, stop, or
+             *     describe, instead of the source's live state. The source is neither
+             *     paused nor resumed. Only the current session's checkpoint and the
+             *     one before it are accepted; an uncommitted or superseded checkpoint
+             *     is rejected with 409.
+             */
+            checkpoint?: string;
         };
         ApiResponse_SandboxList: {
             /** @example true */
@@ -2805,7 +2829,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.36",
   "description": "API types for the Archil control plane",
   "type": "module",
   "types": "index.d.ts",