@archildata/api-types 0.0.35 → 0.0.37

package/index.d.ts

@@ -321,7 +321,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/tokens/{id}": {
+    "/api/tokens/{tokenId}": {
         parameters: {
             query?: never;
             header?: never;
@@ -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;
@@ -763,6 +769,13 @@ export interface components {
             /** Format: date-time */
             last_active_at: string;
             exit_reason?: string;
+            /**
+             * @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.
+             */
+            checkpoint?: string;
         };
         SandboxEndpoint: {
             port: number;
@@ -838,6 +851,14 @@ export interface components {
         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 */
@@ -2299,7 +2320,7 @@ export interface operations {
             header?: never;
             path: {
                 /** @description The token ID (hash) */
-                id: string;
+                tokenId: string;
             };
             cookie?: never;
         };

package/package.json

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