@spacefast/common 0.2.1 → 0.4.1

package/dist/contracts/{content-program.d.ts → content-model.d.ts}

@@ -1,8 +1,16 @@
 import { z } from "zod";
-export declare const CONTENT_PROGRAM_FORMAT: "spacefast.zero-wordpress";
-export declare const CONTENT_PROGRAM_VERSION: 1;
-export declare const contentProgramSha256Schema: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
-export type ContentProgramSha256 = z.infer<typeof contentProgramSha256Schema>;
+export declare const CONTENT_MODEL_FORMAT: "spacefast.zero-wordpress";
+export declare const CONTENT_MODEL_VERSION: 1;
+export declare const contentModelSha256Schema: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+export type ContentModelSha256 = z.infer<typeof contentModelSha256Schema>;
+/**
+ * The one spelling of a content model identifier.
+ *
+ * Exported because every "author → content model" compiler needs to normalize
+ * someone else's identifiers against it, and a hand-copied regex that drifts
+ * from this one produces ids the release then refuses.
+ */
+export declare const contentStableIdSchema: z.ZodString;
 export declare const contentResourceIdSchema: z.core.$ZodBranded<z.ZodString, "ContentResourceId", "out">;
 export declare const contentFieldIdSchema: z.core.$ZodBranded<z.ZodString, "ContentFieldId", "out">;
 export declare const contentTableIdSchema: z.core.$ZodBranded<z.ZodString, "ContentTableId", "out">;
@@ -17,26 +25,54 @@ export type ContentAbilityId = z.infer<typeof contentAbilityIdSchema>;
 export type ContentSchemaId = z.infer<typeof contentSchemaIdSchema>;
 export type ContentComponentId = z.infer<typeof contentComponentIdSchema>;
 export type ContentSyncBindingId = z.infer<typeof contentSyncBindingIdSchema>;
+/**
+ * The name WordPress publishes an Ability under, derived from its content model id.
+ *
+ * Content model ids stay the vocabulary everywhere Spacefast addresses an Ability —
+ * routes, SDK descriptors, executables, decisions, receipts, invalidations.
+ * WordPress is the exception: its Abilities registry admits
+ * `^[a-z0-9-]+/[a-z0-9-]+$`, one namespace and one slug, so a dotted id
+ * flattens onto a single Zero-branded slug and `content.projects.list` is
+ * published as `zero/content-projects-list`.
+ *
+ * `spacefast_content_model_ability_name` in runtime/engine/wordpress/content-model-kernel.php
+ * is the same derivation in PHP and the two must change together. Because
+ * flattening is many-to-one (`a.b` and `a_b` collide),
+ * `contentModelReleaseV1Schema` rejects a content model whose abilities would share
+ * a name.
+ */
+export declare function contentAbilityWordPressName(id: string): string;
+/**
+ * The TypeScript identifier the generated content model SDK gives an Ability.
+ *
+ * This flattening is coarser than `contentAbilityWordPressName`: it drops every
+ * `.`/`_`/`-` separator and PascalCases the parts, so two ids that keep distinct
+ * WordPress names can still land on the same identifier (`posts.v2` and
+ * `posts.v.2` both become `PostsV2`, because a digit-led part has no letter to
+ * capitalize). `contentModelReleaseV1Schema` rejects that collision so the
+ * generated module never emits a duplicate `export type`.
+ */
+export declare function contentAbilityTypeName(id: string): string;
 export declare const contentSyncSourcePathSchema: z.ZodString;
 export type ContentSyncSourcePath = z.infer<typeof contentSyncSourcePathSchema>;
-export type ContentProgramJsonValue = string | number | boolean | null | ContentProgramJsonValue[] | {
-    [key: string]: ContentProgramJsonValue;
+export type ContentModelJsonValue = string | number | boolean | null | ContentModelJsonValue[] | {
+    [key: string]: ContentModelJsonValue;
 };
-export declare const contentProgramJsonValueSchema: z.ZodType<ContentProgramJsonValue>;
+export declare const contentModelJsonValueSchema: z.ZodType<ContentModelJsonValue>;
 export declare const contentResourceRefSchema: z.core.$ZodBranded<z.ZodString, "ContentResourceRef", "out">;
 export type ContentResourceRef = z.infer<typeof contentResourceRefSchema>;
 export declare const contentSchemaRefSchema: z.ZodObject<{
     id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-    sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
 }, z.core.$strict>;
 export type ContentSchemaRef = z.infer<typeof contentSchemaRefSchema>;
 export declare const contentSchemaDefinitionSchema: z.ZodObject<{
     id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-    sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
-    schema: z.ZodType<ContentProgramJsonValue, unknown, z.core.$ZodTypeInternals<ContentProgramJsonValue, unknown>>;
+    sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    schema: z.ZodType<ContentModelJsonValue, unknown, z.core.$ZodTypeInternals<ContentModelJsonValue, unknown>>;
 }, z.core.$strict>;
 export type ContentSchemaDefinition = z.infer<typeof contentSchemaDefinitionSchema>;
-export declare const contentProgramFieldSchema: z.ZodObject<{
+export declare const contentModelFieldSchema: z.ZodObject<{
     id: z.core.$ZodBranded<z.ZodString, "ContentFieldId", "out">;
     name: z.ZodString;
     label: z.ZodString;
@@ -67,16 +103,16 @@ export declare const contentProgramFieldSchema: z.ZodObject<{
         multiple: z.ZodBoolean;
     }, z.core.$strict>], "kind">;
 }, z.core.$strict>;
-export type ContentProgramField = z.infer<typeof contentProgramFieldSchema>;
+export type ContentModelField = z.infer<typeof contentModelFieldSchema>;
 export declare const wordpressContentResourceSchema: z.ZodObject<{
     id: z.core.$ZodBranded<z.ZodString, "ContentResourceId", "out">;
     name: z.ZodString;
     label: z.ZodString;
     kind: z.ZodEnum<{
         media: "media";
+        collection: "collection";
         posts: "posts";
         pages: "pages";
-        collection: "collection";
     }>;
     fields: z.ZodArray<z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentFieldId", "out">;
@@ -112,8 +148,8 @@ export declare const wordpressContentResourceSchema: z.ZodObject<{
     publicRead: z.ZodBoolean;
 }, z.core.$strict>;
 export type WordPressContentResource = z.infer<typeof wordpressContentResourceSchema>;
-export declare const wordpressProgramIrV1Schema: z.ZodObject<{
-    format: z.ZodLiteral<"spacefast.wordpress-program">;
+export declare const wordpressContentModelIrV1Schema: z.ZodObject<{
+    format: z.ZodLiteral<"spacefast.wordpress-content-model">;
     version: z.ZodLiteral<1>;
     resources: z.ZodArray<z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentResourceId", "out">;
@@ -121,9 +157,9 @@ export declare const wordpressProgramIrV1Schema: z.ZodObject<{
         label: z.ZodString;
         kind: z.ZodEnum<{
             media: "media";
+            collection: "collection";
             posts: "posts";
             pages: "pages";
-            collection: "collection";
         }>;
         fields: z.ZodArray<z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentFieldId", "out">;
@@ -159,7 +195,7 @@ export declare const wordpressProgramIrV1Schema: z.ZodObject<{
         publicRead: z.ZodBoolean;
     }, z.core.$strict>>;
 }, z.core.$strict>;
-export type WordPressProgramIrV1 = z.infer<typeof wordpressProgramIrV1Schema>;
+export type WordPressContentModelIrV1 = z.infer<typeof wordpressContentModelIrV1Schema>;
 export declare const contentTableColumnSchema: z.ZodObject<{
     id: z.core.$ZodBranded<z.ZodString, "ContentFieldId", "out">;
     name: z.ZodString;
@@ -220,7 +256,7 @@ export declare const contentAbilityRouteAdmissionV1Schema: z.ZodEnum<{
     authenticated: "authenticated";
 }>;
 export type ContentAbilityRouteAdmissionV1 = z.infer<typeof contentAbilityRouteAdmissionV1Schema>;
-export declare const contentProgramRouteSchema: z.ZodObject<{
+export declare const contentModelRouteSchema: z.ZodObject<{
     id: z.ZodString;
     method: z.ZodEnum<{
         POST: "POST";
@@ -237,18 +273,18 @@ export declare const contentProgramRouteSchema: z.ZodObject<{
         authenticated: "authenticated";
     }>;
 }, z.core.$strict>;
-export type ContentProgramRoute = z.infer<typeof contentProgramRouteSchema>;
+export type ContentModelRoute = z.infer<typeof contentModelRouteSchema>;
 export declare const contentAbilityDescriptorV1Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"query">;
     mode: z.ZodLiteral<"read">;
     id: z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">;
     input: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>;
     output: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>;
     permits: z.ZodArray<z.ZodEnum<{
         "page.view": "page.view";
@@ -299,11 +335,11 @@ export declare const contentAbilityDescriptorV1Schema: z.ZodDiscriminatedUnion<[
     id: z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">;
     input: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>;
     output: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>;
     permits: z.ZodArray<z.ZodEnum<{
         "page.view": "page.view";
@@ -357,11 +393,11 @@ export declare const contentAbilityDescriptorV1Schema: z.ZodDiscriminatedUnion<[
     id: z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">;
     input: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>;
     output: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>;
     permits: z.ZodArray<z.ZodEnum<{
         "page.view": "page.view";
@@ -467,7 +503,7 @@ export declare const contentAbilityReceiptV1Schema: z.ZodDiscriminatedUnion<[z.Z
     abilityId: z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">;
     callId: z.ZodString;
     status: z.ZodLiteral<"succeeded">;
-    output: z.ZodType<ContentProgramJsonValue, unknown, z.core.$ZodTypeInternals<ContentProgramJsonValue, unknown>>;
+    output: z.ZodType<ContentModelJsonValue, unknown, z.core.$ZodTypeInternals<ContentModelJsonValue, unknown>>;
     invalidates: z.ZodArray<z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">>;
 }, z.core.$strict>, z.ZodObject<{
     format: z.ZodLiteral<"spacefast.ability-receipt">;
@@ -505,7 +541,7 @@ export declare const contentClientPageIrV1Schema: z.ZodObject<{
     componentId: z.core.$ZodBranded<z.ZodString, "ContentComponentId", "out">;
     props: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>;
 }, z.core.$strict>;
 export type ContentClientPageIrV1 = z.infer<typeof contentClientPageIrV1Schema>;
@@ -515,29 +551,115 @@ export declare const contentExecutableRefV1Schema: z.ZodObject<{
         php: "php";
         quickjs: "quickjs";
     }>;
-    artifact: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    artifact: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     export: z.ZodString;
 }, z.core.$strict>;
 export type ContentExecutableRefV1 = z.infer<typeof contentExecutableRefV1Schema>;
-export declare const contentSyncBindingV1Schema: z.ZodObject<{
+/**
+ * Which serializer stands between a source file and the blocks WordPress holds.
+ *
+ * The format is a property of the binding rather than of the request, because
+ * the file's extension decides it once at compile time and every later
+ * reconciliation has to agree. A caller cannot ask for the other serializer on
+ * a file this ContentModelRelease bound to one.
+ */
+export declare const CONTENT_SYNC_FORMATS: readonly ["md", "html", "tsx"];
+export declare const contentSyncFormatSchema: z.ZodEnum<{
+    md: "md";
+    html: "html";
+    tsx: "tsx";
+}>;
+export type ContentSyncFormat = z.infer<typeof contentSyncFormatSchema>;
+/**
+ * Formats that compile one way. No serializer reads them back out of blocks, so
+ * their bindings carry the digest of the markup they produced and drift is
+ * settled by recompiling and comparing rather than by merging.
+ */
+export declare const CONTENT_SYNC_COMPILE_FORMATS: ReadonlySet<ContentSyncFormat>;
+export declare function contentSyncFormatIsCompiled(format: ContentSyncFormat): boolean;
+/** The source extension each serializer owns. */
+export declare const CONTENT_SYNC_FORMAT_EXTENSIONS: Map<string, "md" | "html" | "tsx">;
+/** The binding format a source path implies, or `null` when no serializer claims it. */
+export declare function contentSyncFormatForSource(source: string): ContentSyncFormat | null;
+export declare const contentSyncBindingV1Schema: z.ZodPipe<z.ZodObject<{
     id: z.core.$ZodBranded<z.ZodString, "ContentSyncBindingId", "out">;
     resourceId: z.core.$ZodBranded<z.ZodString, "ContentResourceId", "out">;
     fieldId: z.core.$ZodBranded<z.ZodString, "ContentFieldId", "out">;
     source: z.ZodString;
+    publicPath: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<{
+        md: "md";
+        html: "html";
+        tsx: "tsx";
+    }>>;
+    compiled: z.ZodOptional<z.ZodObject<{
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    }, z.core.$strict>>;
+    documentSeed: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    }, z.core.$strict>>;
     slug: z.ZodString;
-}, z.core.$strict>;
+}, z.core.$strict>, z.ZodTransform<{
+    format: "md" | "html" | "tsx";
+    id: string & z.core.$brand<"ContentSyncBindingId">;
+    resourceId: string & z.core.$brand<"ContentResourceId">;
+    fieldId: string & z.core.$brand<"ContentFieldId">;
+    source: string;
+    slug: string;
+    publicPath?: string | undefined;
+    compiled?: {
+        sha256: string & z.core.$brand<"ContentModelSha256">;
+    } | undefined;
+    documentSeed?: {
+        text: string;
+        sha256: string & z.core.$brand<"ContentModelSha256">;
+    } | undefined;
+}, {
+    id: string & z.core.$brand<"ContentSyncBindingId">;
+    resourceId: string & z.core.$brand<"ContentResourceId">;
+    fieldId: string & z.core.$brand<"ContentFieldId">;
+    source: string;
+    slug: string;
+    publicPath?: string | undefined;
+    format?: "md" | "html" | "tsx" | undefined;
+    compiled?: {
+        sha256: string & z.core.$brand<"ContentModelSha256">;
+    } | undefined;
+    documentSeed?: {
+        text: string;
+        sha256: string & z.core.$brand<"ContentModelSha256">;
+    } | undefined;
+}>>;
 export type ContentSyncBindingV1 = z.infer<typeof contentSyncBindingV1Schema>;
-export declare const contentProgramReleaseV1Schema: z.ZodObject<{
+/**
+ * Where a collection puts a document that WordPress created and no file backs
+ * yet. Deterministic — it restates the glob the capsule declared — so it may
+ * live in a content-addressed release.
+ */
+export declare const contentSyncMaterializationV1Schema: z.ZodObject<{
+    resourceId: z.core.$ZodBranded<z.ZodString, "ContentResourceId", "out">;
+    fieldId: z.core.$ZodBranded<z.ZodString, "ContentFieldId", "out">;
+    directory: z.ZodString;
+    suffix: z.ZodString;
+    format: z.ZodEnum<{
+        md: "md";
+        html: "html";
+        tsx: "tsx";
+    }>;
+}, z.core.$strict>;
+export type ContentSyncMaterializationV1 = z.infer<typeof contentSyncMaterializationV1Schema>;
+export declare const contentModelReleaseV1Schema: z.ZodObject<{
     format: z.ZodLiteral<"spacefast.zero-wordpress">;
     version: z.ZodLiteral<1>;
-    revision: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    revision: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     schemas: z.ZodArray<z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
-        schema: z.ZodType<ContentProgramJsonValue, unknown, z.core.$ZodTypeInternals<ContentProgramJsonValue, unknown>>;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+        schema: z.ZodType<ContentModelJsonValue, unknown, z.core.$ZodTypeInternals<ContentModelJsonValue, unknown>>;
     }, z.core.$strict>>;
     wordpress: z.ZodObject<{
-        format: z.ZodLiteral<"spacefast.wordpress-program">;
+        format: z.ZodLiteral<"spacefast.wordpress-content-model">;
         version: z.ZodLiteral<1>;
         resources: z.ZodArray<z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentResourceId", "out">;
@@ -545,9 +667,9 @@ export declare const contentProgramReleaseV1Schema: z.ZodObject<{
             label: z.ZodString;
             kind: z.ZodEnum<{
                 media: "media";
+                collection: "collection";
                 posts: "posts";
                 pages: "pages";
-                collection: "collection";
             }>;
             fields: z.ZodArray<z.ZodObject<{
                 id: z.core.$ZodBranded<z.ZodString, "ContentFieldId", "out">;
@@ -615,11 +737,11 @@ export declare const contentProgramReleaseV1Schema: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">;
         input: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
         output: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
         permits: z.ZodArray<z.ZodEnum<{
             "page.view": "page.view";
@@ -670,11 +792,11 @@ export declare const contentProgramReleaseV1Schema: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">;
         input: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
         output: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
         permits: z.ZodArray<z.ZodEnum<{
             "page.view": "page.view";
@@ -728,11 +850,11 @@ export declare const contentProgramReleaseV1Schema: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">;
         input: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
         output: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
         permits: z.ZodArray<z.ZodEnum<{
             "page.view": "page.view";
@@ -787,7 +909,7 @@ export declare const contentProgramReleaseV1Schema: z.ZodObject<{
         componentId: z.core.$ZodBranded<z.ZodString, "ContentComponentId", "out">;
         props: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
     }, z.core.$strict>>;
     hooks: z.ZodArray<z.ZodObject<{
@@ -796,116 +918,249 @@ export declare const contentProgramReleaseV1Schema: z.ZodObject<{
             php: "php";
             quickjs: "quickjs";
         }>;
-        artifact: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        artifact: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         export: z.ZodString;
     }, z.core.$strict>>;
-    syncBindings: z.ZodArray<z.ZodObject<{
+    syncBindings: z.ZodArray<z.ZodPipe<z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentSyncBindingId", "out">;
         resourceId: z.core.$ZodBranded<z.ZodString, "ContentResourceId", "out">;
         fieldId: z.core.$ZodBranded<z.ZodString, "ContentFieldId", "out">;
         source: z.ZodString;
+        publicPath: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodEnum<{
+            md: "md";
+            html: "html";
+            tsx: "tsx";
+        }>>;
+        compiled: z.ZodOptional<z.ZodObject<{
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+        }, z.core.$strict>>;
+        documentSeed: z.ZodOptional<z.ZodObject<{
+            text: z.ZodString;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+        }, z.core.$strict>>;
         slug: z.ZodString;
-    }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodTransform<{
+        format: "md" | "html" | "tsx";
+        id: string & z.core.$brand<"ContentSyncBindingId">;
+        resourceId: string & z.core.$brand<"ContentResourceId">;
+        fieldId: string & z.core.$brand<"ContentFieldId">;
+        source: string;
+        slug: string;
+        publicPath?: string | undefined;
+        compiled?: {
+            sha256: string & z.core.$brand<"ContentModelSha256">;
+        } | undefined;
+        documentSeed?: {
+            text: string;
+            sha256: string & z.core.$brand<"ContentModelSha256">;
+        } | undefined;
+    }, {
+        id: string & z.core.$brand<"ContentSyncBindingId">;
+        resourceId: string & z.core.$brand<"ContentResourceId">;
+        fieldId: string & z.core.$brand<"ContentFieldId">;
+        source: string;
+        slug: string;
+        publicPath?: string | undefined;
+        format?: "md" | "html" | "tsx" | undefined;
+        compiled?: {
+            sha256: string & z.core.$brand<"ContentModelSha256">;
+        } | undefined;
+        documentSeed?: {
+            text: string;
+            sha256: string & z.core.$brand<"ContentModelSha256">;
+        } | undefined;
+    }>>>;
+    materializations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        resourceId: z.core.$ZodBranded<z.ZodString, "ContentResourceId", "out">;
+        fieldId: z.core.$ZodBranded<z.ZodString, "ContentFieldId", "out">;
+        directory: z.ZodString;
+        suffix: z.ZodString;
+        format: z.ZodEnum<{
+            md: "md";
+            html: "html";
+            tsx: "tsx";
+        }>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ContentModelReleaseV1 = z.infer<typeof contentModelReleaseV1Schema>;
+export declare const contentModelStageReceiptV1Schema: z.ZodObject<{
+    revision: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    artifactDigest: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    staged: z.ZodBoolean;
+}, z.core.$strict>;
+export type ContentModelStageReceiptV1 = z.infer<typeof contentModelStageReceiptV1Schema>;
+export declare const contentModelActivationReceiptV1Schema: z.ZodObject<{
+    revision: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">>;
+    tables: z.ZodNumber;
+    pages: z.ZodNumber;
 }, z.core.$strict>;
-export type ContentProgramReleaseV1 = z.infer<typeof contentProgramReleaseV1Schema>;
-export declare const CONTENT_PROGRAM_ARTIFACT_FORMATS: {
-    readonly program: "spacefast.zero-wordpress";
+export type ContentModelActivationReceiptV1 = z.infer<typeof contentModelActivationReceiptV1Schema>;
+export declare const CONTENT_MODEL_ARTIFACT_FORMATS: {
+    readonly model: "spacefast.zero-wordpress";
     readonly executables: "spacefast.zero-executables";
     readonly sdk: "spacefast.sdk-descriptors";
     readonly routes: "spacefast.route-contributions";
-    readonly requirements: "spacefast.program-requirements";
+    readonly requirements: "spacefast.content-model-requirements";
 };
-export type ContentProgramArtifactFormat = (typeof CONTENT_PROGRAM_ARTIFACT_FORMATS)[keyof typeof CONTENT_PROGRAM_ARTIFACT_FORMATS];
-export type ContentProgramArtifactRef<Format extends ContentProgramArtifactFormat, Version extends number> = Readonly<{
+export type ContentModelArtifactFormat = (typeof CONTENT_MODEL_ARTIFACT_FORMATS)[keyof typeof CONTENT_MODEL_ARTIFACT_FORMATS];
+export type ContentModelArtifactRef<Format extends ContentModelArtifactFormat, Version extends number> = Readonly<{
     format: Format;
     version: Version;
-    inputDigest: ContentProgramSha256;
-    sha256: ContentProgramSha256;
+    inputDigest: ContentModelSha256;
+    sha256: ContentModelSha256;
     bytes: number;
     mediaType: "application/json";
 }>;
-export declare function contentProgramArtifactRefSchema<Format extends ContentProgramArtifactFormat>(format: Format): z.ZodObject<{
+export declare function contentModelArtifactRefSchema<Format extends ContentModelArtifactFormat>(format: Format): z.ZodObject<{
     format: z.ZodLiteral<Format>;
     version: z.ZodLiteral<1>;
-    inputDigest: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
-    sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    inputDigest: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     bytes: z.ZodNumber;
     mediaType: z.ZodLiteral<"application/json">;
 }, z.core.$strict>;
-export declare const compiledContentProgramV1Schema: z.ZodObject<{
-    format: z.ZodLiteral<"spacefast.compiled-program">;
+export declare const compiledContentModelV1Schema: z.ZodObject<{
+    format: z.ZodLiteral<"spacefast.compiled-content-model">;
     version: z.ZodLiteral<1>;
-    program: z.ZodObject<{
+    model: z.ZodObject<{
         format: z.ZodLiteral<"spacefast.zero-wordpress">;
         version: z.ZodLiteral<1>;
-        inputDigest: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        inputDigest: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         bytes: z.ZodNumber;
         mediaType: z.ZodLiteral<"application/json">;
     }, z.core.$strict>;
     executables: z.ZodObject<{
         format: z.ZodLiteral<"spacefast.zero-executables">;
         version: z.ZodLiteral<1>;
-        inputDigest: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        inputDigest: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         bytes: z.ZodNumber;
         mediaType: z.ZodLiteral<"application/json">;
     }, z.core.$strict>;
     sdk: z.ZodObject<{
         format: z.ZodLiteral<"spacefast.sdk-descriptors">;
         version: z.ZodLiteral<1>;
-        inputDigest: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        inputDigest: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         bytes: z.ZodNumber;
         mediaType: z.ZodLiteral<"application/json">;
     }, z.core.$strict>;
     routes: z.ZodObject<{
         format: z.ZodLiteral<"spacefast.route-contributions">;
         version: z.ZodLiteral<1>;
-        inputDigest: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        inputDigest: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         bytes: z.ZodNumber;
         mediaType: z.ZodLiteral<"application/json">;
     }, z.core.$strict>;
     requirements: z.ZodObject<{
-        format: z.ZodLiteral<"spacefast.program-requirements">;
+        format: z.ZodLiteral<"spacefast.content-model-requirements">;
         version: z.ZodLiteral<1>;
-        inputDigest: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
-        sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        inputDigest: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         bytes: z.ZodNumber;
         mediaType: z.ZodLiteral<"application/json">;
     }, z.core.$strict>;
 }, z.core.$strict>;
-export type CompiledContentProgramV1 = z.infer<typeof compiledContentProgramV1Schema>;
+export type CompiledContentModelV1 = z.infer<typeof compiledContentModelV1Schema>;
 export declare const contentExecutableSetV1Schema: z.ZodObject<{
     format: z.ZodLiteral<"spacefast.zero-executables">;
     version: z.ZodLiteral<1>;
-    inputDigest: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    inputDigest: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     executables: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         runtime: z.ZodEnum<{
             php: "php";
             quickjs: "quickjs";
         }>;
-        artifact: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        artifact: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         export: z.ZodString;
     }, z.core.$strict>>;
 }, z.core.$strict>;
+export declare const contentSdkOperationDescriptorV1Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">;
+    kind: z.ZodLiteral<"query">;
+    mode: z.ZodLiteral<"read">;
+    input: z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    }, z.core.$strict>;
+    output: z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    }, z.core.$strict>;
+    cache: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"private">;
+        maxAgeSeconds: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"public">;
+        maxAgeSeconds: z.ZodNumber;
+        staleWhileRevalidateSeconds: z.ZodNumber;
+    }, z.core.$strict>], "kind">;
+    invalidates: z.ZodArray<z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">>;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">;
+    kind: z.ZodLiteral<"mutation">;
+    mode: z.ZodLiteral<"write">;
+    input: z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    }, z.core.$strict>;
+    output: z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    }, z.core.$strict>;
+    cache: z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>;
+    invalidates: z.ZodArray<z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">>;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">;
+    kind: z.ZodLiteral<"endpoint">;
+    mode: z.ZodEnum<{
+        read: "read";
+        write: "write";
+    }>;
+    input: z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    }, z.core.$strict>;
+    output: z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
+        sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    }, z.core.$strict>;
+    cache: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"private">;
+        maxAgeSeconds: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"public">;
+        maxAgeSeconds: z.ZodNumber;
+        staleWhileRevalidateSeconds: z.ZodNumber;
+    }, z.core.$strict>], "kind">;
+    invalidates: z.ZodArray<z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">>;
+}, z.core.$strict>], "kind">;
+export type ContentSdkOperationDescriptorV1 = z.infer<typeof contentSdkOperationDescriptorV1Schema>;
 export declare const contentSdkDescriptorSetV1Schema: z.ZodObject<{
     format: z.ZodLiteral<"spacefast.sdk-descriptors">;
     version: z.ZodLiteral<1>;
-    inputDigest: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    inputDigest: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">;
         kind: z.ZodLiteral<"query">;
         mode: z.ZodLiteral<"read">;
         input: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
         output: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
         cache: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"none">;
@@ -924,11 +1179,11 @@ export declare const contentSdkDescriptorSetV1Schema: z.ZodObject<{
         mode: z.ZodLiteral<"write">;
         input: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
         output: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
         cache: z.ZodObject<{
             kind: z.ZodLiteral<"none">;
@@ -943,11 +1198,11 @@ export declare const contentSdkDescriptorSetV1Schema: z.ZodObject<{
         }>;
         input: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
         output: z.ZodObject<{
             id: z.core.$ZodBranded<z.ZodString, "ContentSchemaId", "out">;
-            sha256: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+            sha256: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
         }, z.core.$strict>;
         cache: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"none">;
@@ -967,10 +1222,11 @@ export declare const contentSdkDescriptorSetV1Schema: z.ZodObject<{
         source: z.ZodString;
     }, z.core.$strict>>;
 }, z.core.$strict>;
+export type ContentSdkDescriptorSetV1 = z.infer<typeof contentSdkDescriptorSetV1Schema>;
 export declare const contentRouteContributionSetV1Schema: z.ZodObject<{
     format: z.ZodLiteral<"spacefast.route-contributions">;
     version: z.ZodLiteral<1>;
-    inputDigest: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    inputDigest: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     routes: z.ZodArray<z.ZodObject<{
         abilityId: z.core.$ZodBranded<z.ZodString, "ContentAbilityId", "out">;
         route: z.ZodObject<{