@spacefast/common 0.0.24 → 0.0.26

package/dist/contracts/spaces.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+export declare const VERSION_BUILD_LOG_MAX_LENGTH: number;
 export declare const SpaceCapacitySchema: z.ZodObject<{
     storageBytes: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -197,14 +198,14 @@ export declare const SpaceCreateResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -234,14 +235,14 @@ export declare const spaceDiagnosticSchema: z.ZodObject<{
     code: z.ZodString;
     severity: z.ZodEnum<{
         info: "info";
-        warning: "warning";
         error: "error";
+        warning: "warning";
     }>;
     message: z.ZodString;
     path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         registrar: "registrar";
-        wpcloud: "wpcloud";
+        infra: "infra";
         dns: "dns";
         runtime: "runtime";
     }>>>;
@@ -258,14 +259,14 @@ export declare const spaceDiagnosticListResponseSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             registrar: "registrar";
-            wpcloud: "wpcloud";
+            infra: "infra";
             dns: "dns";
             runtime: "runtime";
         }>>>;
@@ -698,27 +699,16 @@ export declare const spaceVersionCreateSchema: z.ZodObject<{
     }>>;
     sourceMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     buildLog: z.ZodOptional<z.ZodString>;
-    conventionFiles: z.ZodOptional<z.ZodObject<{
-        redirects: z.ZodOptional<z.ZodString>;
-        headers: z.ZodOptional<z.ZodString>;
-        routes: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
     finalize: z.ZodOptional<z.ZodObject<{
         channel: z.ZodOptional<z.ZodNullable<z.ZodLiteral<"live">>>;
     }, z.core.$strip>>;
-    files: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-        size: z.ZodNumber;
-        contentType: z.ZodOptional<z.ZodString>;
-        sourceUrl: z.ZodOptional<z.ZodString>;
-        sha256: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         size: z.ZodNumber;
         sha256: z.ZodOptional<z.ZodString>;
         contentType: z.ZodOptional<z.ZodString>;
-        sourceUrl: z.ZodString;
-    }, z.core.$strip>]>>;
+        sourceUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const spaceVersionListSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
@@ -899,14 +889,14 @@ export declare const spaceVersionListSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -926,14 +916,14 @@ export declare const spaceVersionListSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -1127,14 +1117,14 @@ export declare const spaceListSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -1169,7 +1159,6 @@ export declare const versionLogEntrySchema: z.ZodObject<{
     message: z.ZodString;
 }, z.core.$strip>;
 export type VersionLogEntry = z.infer<typeof versionLogEntrySchema>;
-export declare const VERSION_BUILD_LOG_MAX_LENGTH: number;
 export declare const versionLogListResponseSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         timestamp: z.ZodString;
@@ -1671,8 +1660,8 @@ export declare const spaceVersionFileLinksResponseSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const spaceVersionConventionArtifactKindSchema: z.ZodEnum<{
-    redirects: "redirects";
     headers: "headers";
+    redirects: "redirects";
 }>;
 export declare const spaceVersionConventionArtifactPathSchema: z.ZodEnum<{
     _redirects: "_redirects";
@@ -1687,8 +1676,8 @@ export declare const spaceVersionConventionArtifactSourceSchema: z.ZodEnum<{
 }>;
 export declare const spaceVersionConventionArtifactMetadataSchema: z.ZodObject<{
     kind: z.ZodEnum<{
-        redirects: "redirects";
         headers: "headers";
+        redirects: "redirects";
     }>;
     path: z.ZodEnum<{
         _redirects: "_redirects";
@@ -1713,8 +1702,8 @@ export declare const spaceVersionConventionArtifactsResponseSchema: z.ZodObject<
     versionId: z.ZodString;
     artifacts: z.ZodArray<z.ZodObject<{
         kind: z.ZodEnum<{
-            redirects: "redirects";
             headers: "headers";
+            redirects: "redirects";
         }>;
         path: z.ZodEnum<{
             _redirects: "_redirects";
@@ -1738,8 +1727,8 @@ export declare const spaceVersionConventionArtifactsResponseSchema: z.ZodObject<
 }, z.core.$strip>;
 export declare const spaceVersionConventionArtifactQuerySchema: z.ZodObject<{
     kind: z.ZodOptional<z.ZodEnum<{
-        redirects: "redirects";
         headers: "headers";
+        redirects: "redirects";
     }>>;
     path: z.ZodOptional<z.ZodEnum<{
         _redirects: "_redirects";
@@ -1748,8 +1737,8 @@ export declare const spaceVersionConventionArtifactQuerySchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const spaceVersionConventionArtifactContentResponseSchema: z.ZodObject<{
     kind: z.ZodEnum<{
-        redirects: "redirects";
         headers: "headers";
+        redirects: "redirects";
     }>;
     path: z.ZodEnum<{
         _redirects: "_redirects";
@@ -1770,8 +1759,8 @@ export declare const spaceVersionConventionArtifactContentResponseSchema: z.ZodO
     warningCount: z.ZodNumber;
     errorCount: z.ZodNumber;
     encoding: z.ZodEnum<{
-        utf8: "utf8";
         base64: "base64";
+        utf8: "utf8";
     }>;
     content: z.ZodString;
     truncated: z.ZodBoolean;
@@ -1810,8 +1799,8 @@ export declare const spaceVersionRoutingDiagnosticSchema: z.ZodObject<{
     }>;
     line: z.ZodNumber;
     severity: z.ZodEnum<{
-        warning: "warning";
         error: "error";
+        warning: "warning";
     }>;
     code: z.ZodString;
     message: z.ZodString;
@@ -1822,8 +1811,8 @@ export declare const spaceVersionComputedRoutingSummarySchema: z.ZodObject<{
     source: z.ZodObject<{
         artifacts: z.ZodArray<z.ZodObject<{
             kind: z.ZodEnum<{
-                redirects: "redirects";
                 headers: "headers";
+                redirects: "redirects";
             }>;
             path: z.ZodEnum<{
                 _redirects: "_redirects";
@@ -1864,8 +1853,8 @@ export declare const spaceVersionComputedRoutingSummarySchema: z.ZodObject<{
         }>;
         line: z.ZodNumber;
         severity: z.ZodEnum<{
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         code: z.ZodString;
         message: z.ZodString;
@@ -1920,14 +1909,14 @@ export declare const spaceVersionIntentResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -2078,19 +2067,13 @@ export declare const publishRequestSchema: z.ZodObject<{
         }>;
         id: z.ZodString;
     }, z.core.$strip>>;
-    files: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-        size: z.ZodNumber;
-        contentType: z.ZodOptional<z.ZodString>;
-        sourceUrl: z.ZodOptional<z.ZodString>;
-        sha256: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         size: z.ZodNumber;
         sha256: z.ZodOptional<z.ZodString>;
         contentType: z.ZodOptional<z.ZodString>;
-        sourceUrl: z.ZodString;
-    }, z.core.$strip>]>>;
+        sourceUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const publishUploadReceiptSchema: z.ZodObject<{
     id: z.ZodString;
@@ -2138,14 +2121,14 @@ export declare const publishUploadReceiptSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -2158,6 +2141,7 @@ export declare const publishUploadReceiptSchema: z.ZodObject<{
 export declare const publishReceiptSpaceSchema: z.ZodObject<{
     id: z.ZodString;
     slug: z.ZodString;
+    title: z.ZodString;
     publicName: z.ZodString;
     defaultHostname: z.ZodString;
     liveUrl: z.ZodNullable<z.ZodString>;
@@ -2210,6 +2194,7 @@ export declare const publishReceiptSchema: z.ZodObject<{
     space: z.ZodObject<{
         id: z.ZodString;
         slug: z.ZodString;
+        title: z.ZodString;
         publicName: z.ZodString;
         defaultHostname: z.ZodString;
         liveUrl: z.ZodNullable<z.ZodString>;
@@ -2284,14 +2269,14 @@ export declare const publishReceiptSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -2348,14 +2333,14 @@ export declare const publishReceiptSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -2375,14 +2360,14 @@ export declare const publishReceiptSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             registrar: "registrar";
-            wpcloud: "wpcloud";
+            infra: "infra";
             dns: "dns";
             runtime: "runtime";
         }>>>;
@@ -2400,6 +2385,7 @@ export declare const publishReceiptSchema: z.ZodObject<{
         status: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+export type PublishReceipt = z.infer<typeof publishReceiptSchema>;
 export declare const spaceVersionResumeResponseSchema: z.ZodObject<{
     versionId: z.ZodString;
     upload: z.ZodNullable<z.ZodObject<{
@@ -2448,14 +2434,14 @@ export declare const spaceVersionResumeResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -2471,11 +2457,6 @@ export declare const versionPromoteSchema: z.ZodDefault<z.ZodOptional<z.ZodObjec
     channel: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>>;
 export declare const spaceFinalizeSchema: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-    conventionFiles: z.ZodOptional<z.ZodObject<{
-        redirects: z.ZodOptional<z.ZodString>;
-        headers: z.ZodOptional<z.ZodString>;
-        routes: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
     channel: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         live: "live";
     }>>>;
@@ -2538,14 +2519,14 @@ export declare const spaceRuntimeStatusSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -2563,8 +2544,8 @@ export declare const spaceRuntimeStatusSchema: z.ZodObject<{
             serverRuntime: z.ZodLiteral<"quickjs-rust">;
             inspect: z.ZodObject<{
                 policy: z.ZodEnum<{
-                    public: "public";
                     private: "private";
+                    public: "public";
                 }>;
             }, z.core.$strict>;
             install: z.ZodObject<{
@@ -2576,7 +2557,7 @@ export declare const spaceRuntimeStatusSchema: z.ZodObject<{
                 binary: z.ZodObject<{
                     path: z.ZodLiteral<"__spacefast/zero/bin/stattic-runtime">;
                     compatibilityTarget: z.ZodObject<{
-                        profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
+                        profile: z.ZodLiteral<"linux-x86_64-gnu-v1">;
                         os: z.ZodLiteral<"linux">;
                         cpu: z.ZodLiteral<"x86_64">;
                         libc: z.ZodLiteral<"glibc">;
@@ -2683,8 +2664,8 @@ export declare const spaceRuntimeStatusSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const spaceApplyChangeBaseSchema: z.ZodObject<{
     kind: z.ZodEnum<{
-        routing: "routing";
         access: "access";
+        routing: "routing";
         variable: "variable";
         settings: "settings";
     }>;
@@ -2697,8 +2678,8 @@ export declare const spaceApplyModeSchema: z.ZodEnum<{
 }>;
 export declare const spaceApplyChangeSchema: z.ZodObject<{
     kind: z.ZodEnum<{
-        routing: "routing";
         access: "access";
+        routing: "routing";
         variable: "variable";
         settings: "settings";
     }>;
@@ -2726,8 +2707,8 @@ export declare const spaceApplyStateSchema: z.ZodObject<{
     pendingChangeCount: z.ZodNumber;
     changes: z.ZodArray<z.ZodObject<{
         kind: z.ZodEnum<{
-            routing: "routing";
             access: "access";
+            routing: "routing";
             variable: "variable";
             settings: "settings";
         }>;
@@ -2766,14 +2747,14 @@ export declare const spaceApplyStateSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -2801,8 +2782,8 @@ export declare const spaceApplyResponseSchema: z.ZodObject<{
         pendingChangeCount: z.ZodNumber;
         changes: z.ZodArray<z.ZodObject<{
             kind: z.ZodEnum<{
-                routing: "routing";
                 access: "access";
+                routing: "routing";
                 variable: "variable";
                 settings: "settings";
             }>;
@@ -2841,14 +2822,14 @@ export declare const spaceApplyResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;

package/dist/contracts/spaces.js

@@ -4,11 +4,12 @@ import { normalizeVersionPath } from "../utils/version-path.js";
 import { publishedAccessSchema } from "./access.js";
 import { AsyncOperationSchema, baseDiagnosticSchema, CursorPaginationSchema, cursorListQuerySchema, } from "./common.js";
 import { versionStatus, spaceStatus } from "./enums.js";
-import { conventionFilesSchema, uploadInstructionsSchema, manifestFileSchema, uploadManifestFileSchema, } from "./internal.js";
+import { uploadInstructionsSchema, manifestFileSchema } from "./internal.js";
 import { VersionSchema, PublishSourceSchema, SpaceSchema, spaceSettingsDigestSchema, } from "./resources.js";
 import { runtimeAppSchema } from "./runtime-app.js";
 import { SPACE_CONFIG_ACCEPTED_FILES, spaceConfigSchema, spacePlacementConfigSchema, } from "./space-config.js";
 import { principalIdSchema } from "./transfers.js";
+export const VERSION_BUILD_LOG_MAX_LENGTH = 512 * 1024;
 // Capacity accounting for the provider site a space runs on. A space IS a
 // site, so occupancy is not a question — storage is. Warm-pool inventory rows
 // carry the same shape before a space adopts them.
@@ -319,19 +320,16 @@ export const spaceVersionCreateSchema = z
         .describe("Additional control-plane-only provenance for build and deploy read models."),
     buildLog: z
         .string()
-        .max(64_000)
+        .max(VERSION_BUILD_LOG_MAX_LENGTH)
         .optional()
         .describe("Build transcript truncated to a bounded size for deploys that ran a local build before publishing."),
-    conventionFiles: conventionFilesSchema
-        .optional()
-        .describe("Routing convention contents used when deciding whether this publish is unchanged. The same values are supplied again when the version is finalized."),
     finalize: z
         .object({ channel: z.literal("live").nullable().optional() })
         .optional()
         .describe("Finalize intent for a declared upload. When every declared file lands, the version finalizes itself; the explicit finalize call remains available for recovery and replay."),
     files: z
-        .array(uploadManifestFileSchema)
-        .describe("The complete desired file manifest. Local-byte entries require `sha256` and are uploaded to a content-addressed target. A `sourceUrl` entry may omit `sha256` because the runtime computes it while fetching. Hashes also let updates skip unchanged files."),
+        .array(manifestFileSchema)
+        .describe("The complete desired file manifest. `sha256` is optional: omit it to upload by path and let the runtime hash the bytes, or include it to upload by content address, with the digest verified as the bytes land. A `sourceUrl` entry is fetched and hashed by the runtime."),
     ...manifestMutationFieldsSchema,
 })
     .superRefine(refineManifestMutationRules);
@@ -358,7 +356,6 @@ export const versionLogEntrySchema = z.object({
     code: z.string().describe("Stable version.{status} code for the line."),
     message: z.string().describe("Human-readable log line."),
 });
-export const VERSION_BUILD_LOG_MAX_LENGTH = 512 * 1024;
 export const versionLogListResponseSchema = z.object({
     data: z.array(versionLogEntrySchema),
     pagination: CursorPaginationSchema,
@@ -540,7 +537,7 @@ export const spaceVersionComputedRoutingSummarySchema = z.object({
     }),
     diagnostics: z.array(spaceVersionRoutingDiagnosticSchema),
 });
-// Upload state is inferable (internal-docs/platform.md L2216): `upload` present means bytes are
+// Upload state is inferable (the platform spec): `upload` present means bytes are
 // still needed (then finalize); `versionId` null means the manifest matched and nothing changed.
 // No redundant booleans ride along.
 export const spaceVersionIntentResponseSchema = z.object({
@@ -562,8 +559,8 @@ export const publishRequestSchema = z
     teamId: z.string().nullable().optional(),
     principal: principalRefInputSchema.optional(),
     files: z
-        .array(uploadManifestFileSchema)
-        .describe("Desired file manifest for a declared publish session. Local-byte entries require `sha256`; sourceUrl entries may omit it. Clients upload returned targets, then finalize."),
+        .array(manifestFileSchema)
+        .describe("Desired file manifest for a declared publish session. `sha256` is optional: omitted local bytes receive path-addressed upload targets and are hashed by the runtime; declared hashes receive content-addressed targets and can reuse existing bytes. Clients upload returned targets, then finalize."),
     ...manifestMutationFieldsSchema,
     source: PublishSourceSchema.optional().describe('Publish provenance recorded on the version; defaults to {kind: "direct_upload"}.'),
     // Same fields, same bounds as spaceVersionCreateSchema: a publish that ran
@@ -575,7 +572,7 @@ export const publishRequestSchema = z
         .describe("Additional control-plane-only provenance for build/deploy read models."),
     buildLog: z
         .string()
-        .max(64_000)
+        .max(VERSION_BUILD_LOG_MAX_LENGTH)
         .optional()
         .describe("Bounded build transcript for deploys that ran a local build before publishing."),
     publishMode: z
@@ -618,6 +615,7 @@ export const publishUploadReceiptSchema = z.object({
 export const publishReceiptSpaceSchema = z.object({
     id: z.string(),
     slug: z.string(),
+    title: z.string(),
     publicName: z.string(),
     defaultHostname: z.string(),
     liveUrl: z.string().nullable(),
@@ -730,7 +728,6 @@ export const versionPromoteSchema = z
     .default({});
 export const spaceFinalizeSchema = z
     .object({
-    conventionFiles: conventionFilesSchema.optional(),
     channel: z
         .enum(["live"])
         .nullable()
@@ -758,7 +755,7 @@ export const spaceRuntimeStatusSchema = z.object({
     operation: AsyncOperationSchema.nullable(),
     app: runtimeAppSchema
         .nullable()
-        .describe("What the live version runs: its Zero capsule and its Functions worker, each null when the published tree carries none of that product (both null for a static space). The whole object is null for callers whose credential does not carry `versions:read`, because app details read version contents, not serving state."),
+        .describe("What the live version runs: its Zero capsule and its Functions worker, each null when the published tree carries none of that product (both null for a space without a runtime). The whole object is null for callers whose credential does not carry `versions:read`, because app details read version contents, not serving state."),
 });
 export const spaceApplyChangeBaseSchema = z.object({
     kind: z.enum(["variable", "routing", "access", "settings"]),

package/dist/contracts/superadmin-spaces.d.ts

@@ -27,8 +27,8 @@ export declare const SuperadminSpaceVersionZeroSchema: z.ZodObject<{
     appName: z.ZodString;
     serverRuntime: z.ZodString;
     inspectPolicy: z.ZodEnum<{
-        public: "public";
         private: "private";
+        public: "public";
     }>;
     tableCount: z.ZodNumber;
     queryCount: z.ZodNumber;
@@ -72,8 +72,8 @@ export declare const SuperadminSpaceVersionSchema: z.ZodObject<{
         appName: z.ZodString;
         serverRuntime: z.ZodString;
         inspectPolicy: z.ZodEnum<{
-            public: "public";
             private: "private";
+            public: "public";
         }>;
         tableCount: z.ZodNumber;
         queryCount: z.ZodNumber;
@@ -270,14 +270,14 @@ export declare const SuperadminSpaceDetailSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -343,8 +343,8 @@ export declare const SuperadminSpaceDetailSchema: z.ZodObject<{
             appName: z.ZodString;
             serverRuntime: z.ZodString;
             inspectPolicy: z.ZodEnum<{
-                public: "public";
                 private: "private";
+                public: "public";
             }>;
             tableCount: z.ZodNumber;
             queryCount: z.ZodNumber;
@@ -550,14 +550,14 @@ export declare const SuperadminSpaceListSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -901,14 +901,14 @@ export declare const SuperadminSpaceAssignResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;