@spacefast/common 0.0.26 → 0.2.1

package/dist/contracts/spaces.d.ts

@@ -4,20 +4,6 @@ export declare const SpaceCapacitySchema: z.ZodObject<{
     storageBytes: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type SpaceCapacity = z.infer<typeof SpaceCapacitySchema>;
-export declare const SpacePressureSchema: z.ZodObject<{
-    ewmaLimitedPct: z.ZodOptional<z.ZodNumber>;
-    ewma429: z.ZodOptional<z.ZodNumber>;
-    ewma429PerMin: z.ZodOptional<z.ZodNumber>;
-    ewmaWorkersMax: z.ZodOptional<z.ZodNumber>;
-    ewmaCpuPct: z.ZodOptional<z.ZodNumber>;
-    lastSampleAt: z.ZodOptional<z.ZodString>;
-    consecutivePressured: z.ZodOptional<z.ZodNumber>;
-    consecutiveClean: z.ZodOptional<z.ZodNumber>;
-    placementHoldRevision: z.ZodOptional<z.ZodNumber>;
-    pressureHoldUntil: z.ZodOptional<z.ZodString>;
-    lastBulkLaneActivityAt: z.ZodOptional<z.ZodString>;
-}, z.core.$loose>;
-export type SpacePressure = z.infer<typeof SpacePressureSchema>;
 export declare const spaceClaimReceiptSchema: z.ZodObject<{
     key: z.ZodString;
     url: z.ZodString;
@@ -27,28 +13,42 @@ export declare const spaceClaimReceiptSchema: z.ZodObject<{
 export declare const SpaceCreateResponseSchema: z.ZodObject<{
     space: z.ZodObject<{
         id: z.ZodString;
-        tenantId: z.ZodString;
-        providerRef: z.ZodNullable<z.ZodString>;
-        providerClientId: z.ZodNullable<z.ZodString>;
+        tenantId: z.ZodOptional<z.ZodString>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            live: "live";
+            test: "test";
+        }>>;
+        providerRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        providerClientId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         teamId: z.ZodNullable<z.ZodString>;
         teamSlug: z.ZodNullable<z.ZodString>;
-        principal: z.ZodNullable<z.ZodObject<{
+        principal: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             tenantId: z.ZodString;
             principalType: z.ZodEnum<{
                 team: "team";
                 external: "external";
             }>;
             principalId: z.ZodString;
+        }, z.core.$strip>>>;
+        infrastructure: z.ZodOptional<z.ZodObject<{
+            region: z.ZodNullable<z.ZodString>;
+            runtimeInstanceId: z.ZodNullable<z.ZodString>;
+            providerMainHostname: z.ZodNullable<z.ZodString>;
+            provisioningState: z.ZodEnum<{
+                provisioning: "provisioning";
+                degraded: "degraded";
+                converged: "converged";
+            }>;
         }, z.core.$strip>>;
         anonymous: z.ZodBoolean;
         slug: z.ZodString;
         title: z.ZodString;
         status: z.ZodEnum<{
             active: "active";
+            failed: "failed";
             provisioning: "provisioning";
             updating: "updating";
             deleting: "deleting";
-            failed: "failed";
         }>;
         disabled: z.ZodNullable<z.ZodObject<{
             at: z.ZodNullable<z.ZodString>;
@@ -175,6 +175,16 @@ export declare const SpaceCreateResponseSchema: z.ZodObject<{
         }, z.core.$strip>>;
         settingsDigest: z.ZodString;
         noindex: z.ZodBoolean;
+        pinnedAt: z.ZodNullable<z.ZodString>;
+        git: z.ZodNullable<z.ZodObject<{
+            managedBy: z.ZodEnum<{
+                spacefast: "spacefast";
+                github: "github";
+            }>;
+            remoteUrl: z.ZodNullable<z.ZodString>;
+            repository: z.ZodNullable<z.ZodString>;
+            defaultBranch: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
         operation: z.ZodNullable<z.ZodObject<{
             id: z.ZodString;
             kind: z.ZodString;
@@ -198,8 +208,8 @@ export declare const SpaceCreateResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    error: "error";
                     warning: "warning";
+                    error: "error";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -235,8 +245,8 @@ export declare const spaceDiagnosticSchema: z.ZodObject<{
     code: z.ZodString;
     severity: z.ZodEnum<{
         info: "info";
-        error: "error";
         warning: "warning";
+        error: "error";
     }>;
     message: z.ZodString;
     path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -259,8 +269,8 @@ export declare const spaceDiagnosticListResponseSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            error: "error";
             warning: "warning";
+            error: "error";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -277,10 +287,6 @@ export declare const spaceDiagnosticListResponseSchema: z.ZodObject<{
         versionId: z.ZodString;
         createdAt: z.ZodString;
     }, z.core.$strip>>;
-    pagination: z.ZodObject<{
-        nextCursor: z.ZodNullable<z.ZodString>;
-        hasMore: z.ZodBoolean;
-    }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const principalRefInputSchema: z.ZodObject<{
     type: z.ZodEnum<{
@@ -474,6 +480,7 @@ export declare const spacePatchSchema: z.ZodObject<{
         burstable: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     noindex: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export declare const anonymousClaimSchema: z.ZodObject<{
     key: z.ZodOptional<z.ZodString>;
@@ -502,9 +509,10 @@ export declare const anonymousClaimSharingSummarySchema: z.ZodObject<{
         grants: z.ZodArray<z.ZodObject<{
             scope: z.ZodString;
             role: z.ZodEnum<{
+                editor: "editor";
                 viewer: "viewer";
                 commenter: "commenter";
-                editor: "editor";
+                manager: "manager";
             }>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
@@ -563,9 +571,10 @@ export declare const anonymousClaimResponseSchema: z.ZodObject<{
             grants: z.ZodArray<z.ZodObject<{
                 scope: z.ZodString;
                 role: z.ZodEnum<{
+                    editor: "editor";
                     viewer: "viewer";
                     commenter: "commenter";
-                    editor: "editor";
+                    manager: "manager";
                 }>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
@@ -668,9 +677,9 @@ export declare const spaceVersionCreateSchema: z.ZodObject<{
             agent: "agent";
             api: "api";
             dashboard: "dashboard";
-            direct_upload: "direct_upload";
             cli: "cli";
             git: "git";
+            direct_upload: "direct_upload";
             import: "import";
             variable_update: "variable_update";
             config_update: "config_update";
@@ -722,9 +731,9 @@ export declare const spaceVersionListSchema: z.ZodObject<{
                 agent: "agent";
                 api: "api";
                 dashboard: "dashboard";
-                direct_upload: "direct_upload";
                 cli: "cli";
                 git: "git";
+                direct_upload: "direct_upload";
                 import: "import";
                 variable_update: "variable_update";
                 config_update: "config_update";
@@ -747,6 +756,22 @@ export declare const spaceVersionListSchema: z.ZodObject<{
                 pullRequestNumber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             }, z.core.$catchall<z.ZodUnknown>>>;
         }, z.core.$strip>>;
+        publisher: z.ZodNullable<z.ZodObject<{
+            type: z.ZodEnum<{
+                system: "system";
+                user: "user";
+                api_key: "api_key";
+                partner_token: "partner_token";
+                oauth_client: "oauth_client";
+                anonymous_claim: "anonymous_claim";
+            }>;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodNullable<z.ZodString>;
+            authorizedBy: z.ZodNullable<z.ZodObject<{
+                displayName: z.ZodString;
+                avatarUrl: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         status: z.ZodEnum<{
             failed: "failed";
             canceled: "canceled";
@@ -773,15 +798,15 @@ export declare const spaceVersionListSchema: z.ZodObject<{
         filesRemovedCount: z.ZodNumber;
         pendingUploads: z.ZodArray<z.ZodObject<{
             path: z.ZodString;
-            size: z.ZodNumber;
-            sha256: z.ZodOptional<z.ZodString>;
             sourceUrl: z.ZodOptional<z.ZodString>;
+            sha256: z.ZodOptional<z.ZodString>;
+            size: z.ZodNumber;
         }, z.core.$strip>>;
         skippedPaths: z.ZodArray<z.ZodString>;
         immutableUrl: z.ZodNullable<z.ZodString>;
         immutableUrlStatus: z.ZodNullable<z.ZodEnum<{
             ready: "ready";
-            converging: "converging";
+            pending: "pending";
         }>>;
         isCurrentProduction: z.ZodBoolean;
         siteTitle: z.ZodString;
@@ -889,8 +914,8 @@ export declare const spaceVersionListSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    error: "error";
                     warning: "warning";
+                    error: "error";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -916,8 +941,8 @@ export declare const spaceVersionListSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                error: "error";
                 warning: "warning";
+                error: "error";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -946,28 +971,42 @@ export declare const spaceVersionListSchema: z.ZodObject<{
 export declare const spaceListSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        tenantId: z.ZodString;
-        providerRef: z.ZodNullable<z.ZodString>;
-        providerClientId: z.ZodNullable<z.ZodString>;
+        tenantId: z.ZodOptional<z.ZodString>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            live: "live";
+            test: "test";
+        }>>;
+        providerRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        providerClientId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         teamId: z.ZodNullable<z.ZodString>;
         teamSlug: z.ZodNullable<z.ZodString>;
-        principal: z.ZodNullable<z.ZodObject<{
+        principal: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             tenantId: z.ZodString;
             principalType: z.ZodEnum<{
                 team: "team";
                 external: "external";
             }>;
             principalId: z.ZodString;
+        }, z.core.$strip>>>;
+        infrastructure: z.ZodOptional<z.ZodObject<{
+            region: z.ZodNullable<z.ZodString>;
+            runtimeInstanceId: z.ZodNullable<z.ZodString>;
+            providerMainHostname: z.ZodNullable<z.ZodString>;
+            provisioningState: z.ZodEnum<{
+                provisioning: "provisioning";
+                degraded: "degraded";
+                converged: "converged";
+            }>;
         }, z.core.$strip>>;
         anonymous: z.ZodBoolean;
         slug: z.ZodString;
         title: z.ZodString;
         status: z.ZodEnum<{
             active: "active";
+            failed: "failed";
             provisioning: "provisioning";
             updating: "updating";
             deleting: "deleting";
-            failed: "failed";
         }>;
         disabled: z.ZodNullable<z.ZodObject<{
             at: z.ZodNullable<z.ZodString>;
@@ -1094,6 +1133,16 @@ export declare const spaceListSchema: z.ZodObject<{
         }, z.core.$strip>>;
         settingsDigest: z.ZodString;
         noindex: z.ZodBoolean;
+        pinnedAt: z.ZodNullable<z.ZodString>;
+        git: z.ZodNullable<z.ZodObject<{
+            managedBy: z.ZodEnum<{
+                spacefast: "spacefast";
+                github: "github";
+            }>;
+            remoteUrl: z.ZodNullable<z.ZodString>;
+            repository: z.ZodNullable<z.ZodString>;
+            defaultBranch: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
         operation: z.ZodNullable<z.ZodObject<{
             id: z.ZodString;
             kind: z.ZodString;
@@ -1117,8 +1166,8 @@ export declare const spaceListSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    error: "error";
                     warning: "warning";
+                    error: "error";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1166,10 +1215,6 @@ export declare const versionLogListResponseSchema: z.ZodObject<{
         code: z.ZodString;
         message: z.ZodString;
     }, z.core.$strip>>;
-    pagination: z.ZodObject<{
-        nextCursor: z.ZodNullable<z.ZodString>;
-        hasMore: z.ZodBoolean;
-    }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const spaceVersionGeneratedPreviewSchema: z.ZodObject<{
     kind: z.ZodLiteral<"image">;
@@ -1628,9 +1673,9 @@ export declare const spaceVersionFileViewSchema: z.ZodEnum<{
 }>;
 export declare const VERSION_FILE_LINKS_MAX_PATHS = 200;
 /**
- * Repeated `path` query parameters — `?path=index.html&path=about.html`. One
- * path arrives as a bare string, so it is lifted into the batch shape before
- * the per-path rules run.
+ * Repeated `path` query parameters, for example
+ * `?path=index.html&path=about.html`. One path arrives as a bare string, so it
+ * is lifted into the batch shape before the per-path rules run.
  */
 export declare const spaceVersionFileLinksQuerySchema: z.ZodObject<{
     path: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodArray<z.ZodString>>;
@@ -1644,7 +1689,7 @@ export declare const spaceVersionFileLinkSchema: z.ZodObject<{
     expiresAt: z.ZodString;
 }, z.core.$strip>;
 /**
- * Minting is blind to path validity — the control plane authorizes the version,
+ * Minting is blind to path validity. The control plane authorizes the version,
  * not the path. A path that is not in the selected catalog view answers
  * `version_file_not_found` when the link is followed.
  */
@@ -1668,11 +1713,11 @@ export declare const spaceVersionConventionArtifactPathSchema: z.ZodEnum<{
     _headers: "_headers";
 }>;
 export declare const spaceVersionConventionArtifactSourceSchema: z.ZodEnum<{
-    uploaded: "uploaded";
     override: "override";
+    uploaded: "uploaded";
+    missing: "missing";
     inherited: "inherited";
     generated: "generated";
-    missing: "missing";
 }>;
 export declare const spaceVersionConventionArtifactMetadataSchema: z.ZodObject<{
     kind: z.ZodEnum<{
@@ -1684,11 +1729,11 @@ export declare const spaceVersionConventionArtifactMetadataSchema: z.ZodObject<{
         _headers: "_headers";
     }>;
     source: z.ZodEnum<{
-        uploaded: "uploaded";
         override: "override";
+        uploaded: "uploaded";
+        missing: "missing";
         inherited: "inherited";
         generated: "generated";
-        missing: "missing";
     }>;
     present: z.ZodBoolean;
     size: z.ZodNullable<z.ZodNumber>;
@@ -1710,11 +1755,11 @@ export declare const spaceVersionConventionArtifactsResponseSchema: z.ZodObject<
             _headers: "_headers";
         }>;
         source: z.ZodEnum<{
-            uploaded: "uploaded";
             override: "override";
+            uploaded: "uploaded";
+            missing: "missing";
             inherited: "inherited";
             generated: "generated";
-            missing: "missing";
         }>;
         present: z.ZodBoolean;
         size: z.ZodNullable<z.ZodNumber>;
@@ -1745,11 +1790,11 @@ export declare const spaceVersionConventionArtifactContentResponseSchema: z.ZodO
         _headers: "_headers";
     }>;
     source: z.ZodEnum<{
-        uploaded: "uploaded";
         override: "override";
+        uploaded: "uploaded";
+        missing: "missing";
         inherited: "inherited";
         generated: "generated";
-        missing: "missing";
     }>;
     present: z.ZodBoolean;
     size: z.ZodNullable<z.ZodNumber>;
@@ -1766,11 +1811,10 @@ export declare const spaceVersionConventionArtifactContentResponseSchema: z.ZodO
     truncated: z.ZodBoolean;
 }, z.core.$strip>;
 /**
- * Where a routing diagnostic came from — a committed path in the version the
- * publisher can open. Wider than the convention artifacts: the Spacefast config
- * file states routing rules too, and they compile through the same compiler and
- * report the same codes. Every accepted config filename is listed because
- * finalize reads whichever one the version ships, and naming the canonical
+ * Where a routing diagnostic came from: a committed path in the version the
+ * publisher can open. Wider than the convention artifacts, because the config
+ * file states routing rules too. Every accepted config filename is listed
+ * because finalize reads whichever one the version ships, and naming
  * `sf.jsonc` at a version that committed `spacefast.jsonc` sends the publisher
  * to a file that is not there.
  */
@@ -1799,12 +1843,42 @@ export declare const spaceVersionRoutingDiagnosticSchema: z.ZodObject<{
     }>;
     line: z.ZodNumber;
     severity: z.ZodEnum<{
-        error: "error";
         warning: "warning";
+        error: "error";
     }>;
     code: z.ZodString;
     message: z.ZodString;
     source: z.ZodString;
+    deferredUntilSubstitution: z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strip>;
+export declare const spaceRoutingComputeSchema: z.ZodObject<{
+    latestVersionId: z.ZodNullable<z.ZodString>;
+    redirects: z.ZodNullable<z.ZodString>;
+    headers: z.ZodNullable<z.ZodString>;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        file: z.ZodEnum<{
+            "sf.jsonc": "sf.jsonc";
+            "spacefast.jsonc": "spacefast.jsonc";
+            "spacefast.json": "spacefast.json";
+            "sf.json": "sf.json";
+            ".sf/sf.json": ".sf/sf.json";
+            ".sf/config.jsonc": ".sf/config.jsonc";
+            ".sf/config.json": ".sf/config.json";
+            _redirects: "_redirects";
+            _headers: "_headers";
+        }>;
+        line: z.ZodNumber;
+        severity: z.ZodEnum<{
+            warning: "warning";
+            error: "error";
+        }>;
+        code: z.ZodString;
+        message: z.ZodString;
+        source: z.ZodString;
+        deferredUntilSubstitution: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>>;
+    variableDependencies: z.ZodArray<z.ZodString>;
+    systemVariableDependencies: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
 export declare const spaceVersionComputedRoutingSummarySchema: z.ZodObject<{
     versionId: z.ZodString;
@@ -1819,11 +1893,11 @@ export declare const spaceVersionComputedRoutingSummarySchema: z.ZodObject<{
                 _headers: "_headers";
             }>;
             source: z.ZodEnum<{
-                uploaded: "uploaded";
                 override: "override";
+                uploaded: "uploaded";
+                missing: "missing";
                 inherited: "inherited";
                 generated: "generated";
-                missing: "missing";
             }>;
             present: z.ZodBoolean;
             size: z.ZodNullable<z.ZodNumber>;
@@ -1853,12 +1927,13 @@ export declare const spaceVersionComputedRoutingSummarySchema: z.ZodObject<{
         }>;
         line: z.ZodNumber;
         severity: z.ZodEnum<{
-            error: "error";
             warning: "warning";
+            error: "error";
         }>;
         code: z.ZodString;
         message: z.ZodString;
         source: z.ZodString;
+        deferredUntilSubstitution: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const spaceVersionIntentResponseSchema: z.ZodObject<{
@@ -1893,7 +1968,8 @@ export declare const spaceVersionIntentResponseSchema: z.ZodObject<{
             contentType: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         links: z.ZodObject<{
-            resume: z.ZodString;
+            refresh: z.ZodString;
+            resume: z.ZodOptional<z.ZodString>;
             finalize: z.ZodString;
         }, z.core.$strip>;
         details: z.ZodOptional<z.ZodObject<{
@@ -1909,8 +1985,8 @@ export declare const spaceVersionIntentResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    error: "error";
                     warning: "warning";
+                    error: "error";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1935,9 +2011,9 @@ export declare const publishRequestSchema: z.ZodObject<{
             agent: "agent";
             api: "api";
             dashboard: "dashboard";
-            direct_upload: "direct_upload";
             cli: "cli";
             git: "git";
+            direct_upload: "direct_upload";
             import: "import";
             variable_update: "variable_update";
             config_update: "config_update";
@@ -2105,7 +2181,8 @@ export declare const publishUploadReceiptSchema: z.ZodObject<{
         contentType: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     links: z.ZodObject<{
-        resume: z.ZodString;
+        refresh: z.ZodString;
+        resume: z.ZodOptional<z.ZodString>;
         finalize: z.ZodString;
     }, z.core.$strip>;
     details: z.ZodOptional<z.ZodObject<{
@@ -2121,8 +2198,8 @@ export declare const publishUploadReceiptSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                error: "error";
                 warning: "warning";
+                error: "error";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2143,9 +2220,25 @@ export declare const publishReceiptSpaceSchema: z.ZodObject<{
     slug: z.ZodString;
     title: z.ZodString;
     publicName: z.ZodString;
-    defaultHostname: z.ZodString;
+    defaultHostname: z.ZodOptional<z.ZodString>;
     liveUrl: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * The claim block as it rides on a publish receipt. Same members as the
+ * server's {@link spaceClaimReceiptSchema}, with the URL formats relaxed to
+ * plain strings so a client-rendered receipt can mask the three key-bearing
+ * members (`key`, `url`, `claimUrl`) with {@link REDACTED_RECEIPT_SECRET} while
+ * keeping the block's shape stable. `expiresAt` is never masked: it is what
+ * tells an agent the space is temporary and by when it has to be claimed.
+ */
+export declare const publishReceiptClaimSchema: z.ZodObject<{
+    expiresAt: z.ZodString;
+    key: z.ZodString;
+    url: z.ZodString;
+    claimUrl: z.ZodString;
+}, z.core.$strip>;
+/** The stand-in a surface writes where a secret would otherwise be printed. */
+export declare const REDACTED_RECEIPT_SECRET = "[REDACTED]";
 export declare const publishReceiptVersionSchema: z.ZodObject<{
     id: z.ZodString;
     status: z.ZodEnum<{
@@ -2160,7 +2253,7 @@ export declare const publishReceiptVersionSchema: z.ZodObject<{
         finalizing: "finalizing";
         ready: "ready";
     }>;
-    immutableUrl: z.ZodString;
+    immutableUrl: z.ZodNullable<z.ZodString>;
     ref: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     number: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     manifestHash: z.ZodNullable<z.ZodString>;
@@ -2196,7 +2289,7 @@ export declare const publishReceiptSchema: z.ZodObject<{
         slug: z.ZodString;
         title: z.ZodString;
         publicName: z.ZodString;
-        defaultHostname: z.ZodString;
+        defaultHostname: z.ZodOptional<z.ZodString>;
         liveUrl: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
     access: z.ZodOptional<z.ZodObject<{
@@ -2218,7 +2311,7 @@ export declare const publishReceiptSchema: z.ZodObject<{
             finalizing: "finalizing";
             ready: "ready";
         }>;
-        immutableUrl: z.ZodString;
+        immutableUrl: z.ZodNullable<z.ZodString>;
         ref: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         number: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         manifestHash: z.ZodNullable<z.ZodString>;
@@ -2246,6 +2339,23 @@ export declare const publishReceiptSchema: z.ZodObject<{
         retryAfter: z.ZodOptional<z.ZodNumber>;
         hint: z.ZodString;
     }, z.core.$strip>;
+    git: z.ZodOptional<z.ZodObject<{
+        managedBy: z.ZodEnum<{
+            spacefast: "spacefast";
+            github: "github";
+        }>;
+        remoteUrl: z.ZodNullable<z.ZodString>;
+        repository: z.ZodNullable<z.ZodString>;
+        defaultBranch: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    authMode: z.ZodOptional<z.ZodEnum<{
+        anonymous: "anonymous";
+        authenticated: "authenticated";
+    }>>;
+    persistence: z.ZodOptional<z.ZodEnum<{
+        managed: "managed";
+        temporary: "temporary";
+    }>>;
     operation: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodString;
@@ -2269,8 +2379,8 @@ export declare const publishReceiptSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                error: "error";
                 warning: "warning";
+                error: "error";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2317,7 +2427,8 @@ export declare const publishReceiptSchema: z.ZodObject<{
             contentType: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         links: z.ZodObject<{
-            resume: z.ZodString;
+            refresh: z.ZodString;
+            resume: z.ZodOptional<z.ZodString>;
             finalize: z.ZodString;
         }, z.core.$strip>;
         details: z.ZodOptional<z.ZodObject<{
@@ -2333,8 +2444,8 @@ export declare const publishReceiptSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    error: "error";
                     warning: "warning";
+                    error: "error";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2351,17 +2462,17 @@ export declare const publishReceiptSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     claim: z.ZodOptional<z.ZodObject<{
+        expiresAt: z.ZodString;
         key: z.ZodString;
         url: z.ZodString;
         claimUrl: z.ZodString;
-        expiresAt: z.ZodString;
     }, z.core.$strip>>;
     diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            error: "error";
             warning: "warning";
+            error: "error";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2376,6 +2487,7 @@ export declare const publishReceiptSchema: z.ZodObject<{
         retryable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     }, z.core.$strip>>>;
     links: z.ZodOptional<z.ZodObject<{
+        refresh: z.ZodOptional<z.ZodString>;
         resume: z.ZodOptional<z.ZodString>;
         finalize: z.ZodOptional<z.ZodString>;
         promote: z.ZodOptional<z.ZodString>;
@@ -2386,7 +2498,7 @@ export declare const publishReceiptSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PublishReceipt = z.infer<typeof publishReceiptSchema>;
-export declare const spaceVersionResumeResponseSchema: z.ZodObject<{
+export declare const spaceVersionRefreshResponseSchema: z.ZodObject<{
     versionId: z.ZodString;
     upload: z.ZodNullable<z.ZodObject<{
         id: z.ZodString;
@@ -2418,7 +2530,8 @@ export declare const spaceVersionResumeResponseSchema: z.ZodObject<{
             contentType: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         links: z.ZodObject<{
-            resume: z.ZodString;
+            refresh: z.ZodString;
+            resume: z.ZodOptional<z.ZodString>;
             finalize: z.ZodString;
         }, z.core.$strip>;
         details: z.ZodOptional<z.ZodObject<{
@@ -2434,8 +2547,8 @@ export declare const spaceVersionResumeResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    error: "error";
                     warning: "warning";
+                    error: "error";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2456,6 +2569,28 @@ export declare const spaceVersionResumeResponseSchema: z.ZodObject<{
 export declare const versionPromoteSchema: z.ZodDefault<z.ZodOptional<z.ZodObject<{
     channel: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>>;
+/**
+ * `?async=1` on a route that otherwise waits for the work to settle: the route
+ * answers with the operation handle to poll instead. Every such route builds its
+ * query schema here so the accepted spellings stay one definition; the caller
+ * passes the description because that is the only per-route part.
+ *
+ * Plain enum (no zod transform): transforms cannot be represented in the
+ * generated OpenAPI spec, and this parameter must reach SDK consumers.
+ */
+export declare function asyncQuerySchema(description: string): z.ZodObject<{
+    async: z.ZodOptional<z.ZodEnum<{
+        0: "0";
+        1: "1";
+        true: "true";
+        false: "false";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Reads an {@link asyncQuerySchema} value. The factory owns which spellings the
+ * parameter accepts; this owns what they mean, so neither can drift alone.
+ */
+export declare function isAsyncRequested(value: string | null | undefined): value is "true" | "1";
 export declare const spaceFinalizeSchema: z.ZodDefault<z.ZodOptional<z.ZodObject<{
     channel: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         live: "live";
@@ -2467,10 +2602,10 @@ export declare const spaceRuntimeStatusSchema: z.ZodObject<{
     liveUrl: z.ZodNullable<z.ZodString>;
     runtimeState: z.ZodEnum<{
         active: "active";
+        failed: "failed";
         provisioning: "provisioning";
         updating: "updating";
         deleting: "deleting";
-        failed: "failed";
     }>;
     liveVersionStatus: z.ZodNullable<z.ZodEnum<{
         failed: "failed";
@@ -2519,8 +2654,8 @@ export declare const spaceRuntimeStatusSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                error: "error";
                 warning: "warning";
+                error: "error";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2593,6 +2728,8 @@ export declare const spaceRuntimeStatusSchema: z.ZodObject<{
                 path: z.ZodString;
             }, z.core.$strict>>>;
             sockets: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            serverBundleSize: z.ZodNullable<z.ZodNumber>;
+            clientBundleSize: z.ZodNullable<z.ZodNumber>;
             migrationCount: z.ZodNumber;
             schemaHash: z.ZodNullable<z.ZodString>;
             variables: z.ZodObject<{
@@ -2647,6 +2784,134 @@ export declare const spaceRuntimeStatusSchema: z.ZodObject<{
                 gravatar: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
                 spam: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
                 email: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                content: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            }, z.core.$strip>>;
+            executionState: z.ZodEnum<{
+                ready: "ready";
+                absent: "absent";
+                serving: "serving";
+            }>;
+            bundleSize: z.ZodNumber;
+            bundleSha256: z.ZodString;
+            variables: z.ZodObject<{
+                source: z.ZodLiteral<"spacefast-variables">;
+                names: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    pendingApp: z.ZodNullable<z.ZodObject<{
+        capsule: z.ZodNullable<z.ZodObject<{
+            artifactId: z.ZodString;
+            appName: z.ZodString;
+            serverRuntime: z.ZodLiteral<"quickjs-rust">;
+            inspect: z.ZodObject<{
+                policy: z.ZodEnum<{
+                    private: "private";
+                    public: "public";
+                }>;
+            }, z.core.$strict>;
+            install: z.ZodObject<{
+                runtimeKind: z.ZodLiteral<"zero">;
+                engine: z.ZodLiteral<"quickjs-rust">;
+                storageRoot: z.ZodLiteral<"__spacefast/zero">;
+                artifactPath: z.ZodLiteral<"__spacefast/zero/artifact.json">;
+                configPath: z.ZodLiteral<"__spacefast/zero/config.json">;
+                binary: z.ZodObject<{
+                    path: z.ZodLiteral<"__spacefast/zero/bin/stattic-runtime">;
+                    compatibilityTarget: z.ZodObject<{
+                        profile: z.ZodLiteral<"linux-x86_64-gnu-v1">;
+                        os: z.ZodLiteral<"linux">;
+                        cpu: z.ZodLiteral<"x86_64">;
+                        libc: z.ZodLiteral<"glibc">;
+                        linking: z.ZodLiteral<"dynamic">;
+                        requireExecutableBit: z.ZodLiteral<true>;
+                    }, z.core.$strict>;
+                    sha256: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                    required: z.ZodLiteral<true>;
+                }, z.core.$strict>;
+                mysql: z.ZodObject<{
+                    migrateAtFinalize: z.ZodLiteral<true>;
+                    blockIncompatibleRollback: z.ZodLiteral<true>;
+                }, z.core.$strict>;
+                realtime: z.ZodObject<{
+                    production: z.ZodLiteral<"central">;
+                    local: z.ZodLiteral<"foreground-cli-ws">;
+                }, z.core.$strict>;
+            }, z.core.$strict>;
+            tables: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            queries: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            mutations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            actions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            endpoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                method: z.ZodEnum<{
+                    POST: "POST";
+                    PUT: "PUT";
+                    GET: "GET";
+                    HEAD: "HEAD";
+                    PATCH: "PATCH";
+                    DELETE: "DELETE";
+                    OPTIONS: "OPTIONS";
+                }>;
+                path: z.ZodString;
+            }, z.core.$strict>>>;
+            sockets: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            serverBundleSize: z.ZodNullable<z.ZodNumber>;
+            clientBundleSize: z.ZodNullable<z.ZodNumber>;
+            migrationCount: z.ZodNumber;
+            schemaHash: z.ZodNullable<z.ZodString>;
+            variables: z.ZodObject<{
+                source: z.ZodLiteral<"stattic-variables">;
+                names: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>;
+            realtime: z.ZodObject<{
+                mode: z.ZodEnum<{
+                    local: "local";
+                    cast: "cast";
+                    central: "central";
+                }>;
+                centralUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                path: z.ZodOptional<z.ZodString>;
+                replayPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                replayUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                runPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                runUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                resourceKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                ticketPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                socketPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                spaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                versionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        worker: z.ZodNullable<z.ZodObject<{
+            artifactId: z.ZodString;
+            appName: z.ZodString;
+            entry: z.ZodString;
+            compatibilityDate: z.ZodString;
+            compatibilityFlags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            routes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                method: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                    POST: "POST";
+                    PUT: "PUT";
+                    GET: "GET";
+                    HEAD: "HEAD";
+                    PATCH: "PATCH";
+                    DELETE: "DELETE";
+                    OPTIONS: "OPTIONS";
+                }>>>;
+                path: z.ZodString;
+                subtree: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            capabilities: z.ZodDefault<z.ZodObject<{
+                db: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                fetch: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                auth: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                env: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                realtime: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                logging: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                gravatar: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                spam: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                email: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                content: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             }, z.core.$strip>>;
             executionState: z.ZodEnum<{
                 ready: "ready";
@@ -2662,39 +2927,16 @@ export declare const spaceRuntimeStatusSchema: z.ZodObject<{
         }, z.core.$strict>>;
     }, z.core.$strict>>;
 }, z.core.$strip>;
-export declare const spaceApplyChangeBaseSchema: z.ZodObject<{
-    kind: z.ZodEnum<{
-        access: "access";
-        routing: "routing";
-        variable: "variable";
-        settings: "settings";
-    }>;
-    name: z.ZodString;
-    label: z.ZodString;
-}, z.core.$strip>;
-export declare const spaceApplyModeSchema: z.ZodEnum<{
-    stage: "stage";
-    apply: "apply";
-}>;
-export declare const spaceApplyChangeSchema: z.ZodObject<{
-    kind: z.ZodEnum<{
-        access: "access";
-        routing: "routing";
-        variable: "variable";
-        settings: "settings";
-    }>;
-    name: z.ZodString;
-    label: z.ZodString;
-    id: z.ZodString;
-    sourceSurface: z.ZodString;
-    applyMode: z.ZodEnum<{
-        stage: "stage";
-        apply: "apply";
-    }>;
-    before: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    after: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
+/**
+ * Where a space's runtime stands against its desired state. `POST
+ * /v1/spaces/{spaceId}/apply` returns this in the platform mutation envelope,
+ * whose `operation` handle polls at `GET /v1/operations/{operationId}`; `GET
+ * /v1/spaces/{spaceId}/apply-state` returns the same shape as a plain read.
+ *
+ * None of these fields live on an operation record: the operation says whether
+ * the last apply ran, this says what the space is serving, what it wants to
+ * serve, and whether you may ask for it now.
+ */
 export declare const spaceApplyStateSchema: z.ZodObject<{
     status: z.ZodEnum<{
         live: "live";
@@ -2704,143 +2946,6 @@ export declare const spaceApplyStateSchema: z.ZodObject<{
     }>;
     desiredRevision: z.ZodNullable<z.ZodString>;
     appliedRevision: z.ZodNullable<z.ZodString>;
-    pendingChangeCount: z.ZodNumber;
-    changes: z.ZodArray<z.ZodObject<{
-        kind: z.ZodEnum<{
-            access: "access";
-            routing: "routing";
-            variable: "variable";
-            settings: "settings";
-        }>;
-        name: z.ZodString;
-        label: z.ZodString;
-        id: z.ZodString;
-        sourceSurface: z.ZodString;
-        applyMode: z.ZodEnum<{
-            stage: "stage";
-            apply: "apply";
-        }>;
-        before: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-        after: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strip>>;
-    operation: z.ZodNullable<z.ZodObject<{
-        id: z.ZodString;
-        kind: z.ZodString;
-        status: z.ZodEnum<{
-            failed: "failed";
-            canceled: "canceled";
-            queued: "queued";
-            running: "running";
-            succeeded: "succeeded";
-        }>;
-        resources: z.ZodArray<z.ZodObject<{
-            type: z.ZodString;
-            id: z.ZodString;
-        }, z.core.$strip>>;
-        progress: z.ZodOptional<z.ZodObject<{
-            total: z.ZodNumber;
-            completed: z.ZodNumber;
-            failed: z.ZodNumber;
-        }, z.core.$strip>>;
-        diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            code: z.ZodString;
-            severity: z.ZodEnum<{
-                info: "info";
-                error: "error";
-                warning: "warning";
-            }>;
-            message: z.ZodString;
-            path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                registrar: "registrar";
-                infra: "infra";
-                dns: "dns";
-                runtime: "runtime";
-            }>>>;
-            details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-            fix: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            retryable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-        }, z.core.$strip>>>;
-        createdAt: z.ZodString;
-        finishedAt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
     lastError: z.ZodNullable<z.ZodString>;
     canApplyNow: z.ZodBoolean;
 }, z.core.$strip>;
-export declare const spaceApplyResponseSchema: z.ZodObject<{
-    applied: z.ZodBoolean;
-    applyState: z.ZodObject<{
-        status: z.ZodEnum<{
-            live: "live";
-            failed: "failed";
-            pending: "pending";
-            applying: "applying";
-        }>;
-        desiredRevision: z.ZodNullable<z.ZodString>;
-        appliedRevision: z.ZodNullable<z.ZodString>;
-        pendingChangeCount: z.ZodNumber;
-        changes: z.ZodArray<z.ZodObject<{
-            kind: z.ZodEnum<{
-                access: "access";
-                routing: "routing";
-                variable: "variable";
-                settings: "settings";
-            }>;
-            name: z.ZodString;
-            label: z.ZodString;
-            id: z.ZodString;
-            sourceSurface: z.ZodString;
-            applyMode: z.ZodEnum<{
-                stage: "stage";
-                apply: "apply";
-            }>;
-            before: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-            after: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>>;
-        operation: z.ZodNullable<z.ZodObject<{
-            id: z.ZodString;
-            kind: z.ZodString;
-            status: z.ZodEnum<{
-                failed: "failed";
-                canceled: "canceled";
-                queued: "queued";
-                running: "running";
-                succeeded: "succeeded";
-            }>;
-            resources: z.ZodArray<z.ZodObject<{
-                type: z.ZodString;
-                id: z.ZodString;
-            }, z.core.$strip>>;
-            progress: z.ZodOptional<z.ZodObject<{
-                total: z.ZodNumber;
-                completed: z.ZodNumber;
-                failed: z.ZodNumber;
-            }, z.core.$strip>>;
-            diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                code: z.ZodString;
-                severity: z.ZodEnum<{
-                    info: "info";
-                    error: "error";
-                    warning: "warning";
-                }>;
-                message: z.ZodString;
-                path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    registrar: "registrar";
-                    infra: "infra";
-                    dns: "dns";
-                    runtime: "runtime";
-                }>>>;
-                details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-                fix: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                retryable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-            }, z.core.$strip>>>;
-            createdAt: z.ZodString;
-            finishedAt: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-        lastError: z.ZodNullable<z.ZodString>;
-        canApplyNow: z.ZodBoolean;
-    }, z.core.$strip>;
-}, z.core.$strip>;