@fuzdev/fuz_app 0.102.0 → 0.104.0

package/dist/auth/cell_action_specs.d.ts

@@ -58,12 +58,42 @@ export declare const ERROR_CELL_VISIBILITY_MANAGE_ONLY: "cell_visibility_manage_
 /** Error reason — input shape for `cell_get` lacked both `id` and `path`. */
 export declare const ERROR_CELL_GET_REQUIRES_ID_OR_PATH: "cell_get_requires_id_or_path";
 /**
- * Error reason — `cell_clone` `with_data_patch` would change `data.kind`.
- * Per-kind shape validation can pass coincidentally (e.g., one kind's
- * schema accepts most of another's fields), so we reject the cross-kind
- * patch explicitly to prevent incoherent clones.
+ * Error reason — a `kind` key was supplied inside `data`. `kind` is a
+ * top-level column (`cell.kind`), not content metadata; accepting it inside
+ * `data` would create two sources of truth. Rejected fail-loud at the
+ * create / update / clone-patch boundary so the column stays canonical.
  */
-export declare const ERROR_CELL_CLONE_KIND_MISMATCH: "cell_clone_kind_mismatch";
+export declare const ERROR_CELL_KIND_IN_DATA: "cell_kind_in_data";
+/**
+ * Error reason — `cell_create` was given an empty-string `kind`. `kind` is a
+ * non-empty capability tag or absent (`null` = typeless cell); `""` (a tag
+ * that tags nothing) is rejected fail-loud so `kind` stays a clean
+ * `null | non-empty-string` (twin of the Rust `ERROR_CELL_KIND_EMPTY`).
+ */
+export declare const ERROR_CELL_KIND_EMPTY: "cell_kind_empty";
+/**
+ * Error reason — the parent-aware `CellCreateAuthorize` denied the create for a
+ * **viewable** parent (or a root creation): "you see it, you can't contribute
+ * here." A **403** `forbidden`, distinct from the create-path **404** mask used
+ * when the parent itself isn't viewable (twin of the Rust
+ * `ERROR_CELL_CREATE_FORBIDDEN`).
+ */
+export declare const ERROR_CELL_CREATE_FORBIDDEN: "cell_create_forbidden";
+/**
+ * Error reason — `cell_moderate` caller can view the contribution but lacks
+ * moderation authority over its governing root (not admin / not the root's
+ * manager). A **403** `forbidden`. The author can view their own pending
+ * contribution, so they reach this gate — and are denied here, which is the
+ * anti-self-approval guard (twin of the Rust `ERROR_CELL_MODERATE_FORBIDDEN`).
+ */
+export declare const ERROR_CELL_MODERATE_FORBIDDEN: "cell_moderate_forbidden";
+/**
+ * Error reason — `cell_moderate` target has no governing root (`root_id` is
+ * null): it's a root or an unparented cell, not a gated contribution, so there
+ * is nothing to moderate. A **400** `invalid_params` (twin of the Rust
+ * `ERROR_CELL_NOT_A_CONTRIBUTION`).
+ */
+export declare const ERROR_CELL_NOT_A_CONTRIBUTION: "cell_not_a_contribution";
 /**
  * Error reason — null-auth `cell_list` caller passed a `created_by`
  * filter. The filter is a soft account-id enumeration vector ("does
@@ -130,15 +160,18 @@ export declare const CellJson: z.ZodObject<{
     id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
     path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
     data: z.ZodObject<{
-        kind: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
         summary: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>;
+    kind: z.ZodNullable<z.ZodString>;
     visibility: z.ZodEnum<{
         private: "private";
         public: "public";
     }>;
     refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+    parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+    root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+    moderation: z.ZodNullable<z.ZodString>;
     created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
     updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
     created_at: z.ZodString;
@@ -154,15 +187,16 @@ export type CellJson = z.infer<typeof CellJson>;
  */
 export declare const CellCreateInput: z.ZodObject<{
     data: z.ZodObject<{
-        kind: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
         summary: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     visibility: z.ZodOptional<z.ZodEnum<{
         private: "private";
         public: "public";
     }>>;
     path: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>>;
+    parent_id: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>>;
     acting: z.ZodOptional<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
 }, z.core.$strict>;
 export type CellCreateInput = z.infer<typeof CellCreateInput>;
@@ -171,15 +205,18 @@ export declare const CellCreateOutput: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
         path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
         data: z.ZodObject<{
-            kind: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             summary: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>;
+        kind: z.ZodNullable<z.ZodString>;
         visibility: z.ZodEnum<{
             private: "private";
             public: "public";
         }>;
         refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+        parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        moderation: z.ZodNullable<z.ZodString>;
         created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
         updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
         created_at: z.ZodString;
@@ -215,15 +252,18 @@ export declare const CellGetOutput: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
         path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
         data: z.ZodObject<{
-            kind: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             summary: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>;
+        kind: z.ZodNullable<z.ZodString>;
         visibility: z.ZodEnum<{
             private: "private";
             public: "public";
         }>;
         refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+        parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        moderation: z.ZodNullable<z.ZodString>;
         created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
         updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
         created_at: z.ZodString;
@@ -260,7 +300,6 @@ export type CellGetOutput = z.infer<typeof CellGetOutput>;
 export declare const CellUpdateInput: z.ZodObject<{
     cell_id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
     data: z.ZodOptional<z.ZodObject<{
-        kind: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
         summary: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
@@ -277,15 +316,18 @@ export declare const CellUpdateOutput: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
         path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
         data: z.ZodObject<{
-            kind: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             summary: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>;
+        kind: z.ZodNullable<z.ZodString>;
         visibility: z.ZodEnum<{
             private: "private";
             public: "public";
         }>;
         refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+        parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        moderation: z.ZodNullable<z.ZodString>;
         created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
         updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
         created_at: z.ZodString;
@@ -319,7 +361,7 @@ export type CellDeleteOutput = z.infer<typeof CellDeleteOutput>;
  * `shared_with: 'me'` narrows to cells that admit the caller via a
  * `cell_grant` row (actor-shaped or role-shaped principal) AND that
  * the caller does not own. Authenticated only; combine with
- * `data_kind` / `path_prefix` etc. to scope further. Combining with
+ * `kind` / `path_prefix` etc. to scope further. Combining with
  * `created_by: <my-actor-id>` produces an empty result by definition
  * (owner is implicit, never appears as a grant principal); we don't
  * reject the combination at the schema layer because SQL emptiness is
@@ -327,7 +369,7 @@ export type CellDeleteOutput = z.infer<typeof CellDeleteOutput>;
  */
 export declare const CellListInput: z.ZodDefault<z.ZodObject<{
     ids: z.ZodOptional<z.ZodArray<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>>;
-    data_kind: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodString>;
     visibility: z.ZodOptional<z.ZodEnum<{
         private: "private";
         public: "public";
@@ -335,6 +377,8 @@ export declare const CellListInput: z.ZodDefault<z.ZodObject<{
     ref: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>;
     created_by: z.ZodOptional<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
     path_prefix: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
+    root_id: z.ZodOptional<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+    moderation: z.ZodOptional<z.ZodString>;
     shared_with: z.ZodOptional<z.ZodLiteral<"me">>;
     order_by: z.ZodOptional<z.ZodEnum<{
         created_at: "created_at";
@@ -354,15 +398,18 @@ export declare const CellListOutput: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
         path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
         data: z.ZodObject<{
-            kind: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             summary: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>;
+        kind: z.ZodNullable<z.ZodString>;
         visibility: z.ZodEnum<{
             private: "private";
             public: "public";
         }>;
         refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+        parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        moderation: z.ZodNullable<z.ZodString>;
         created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
         updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
         created_at: z.ZodString;
@@ -396,7 +443,6 @@ export declare const CellCloneInput: z.ZodObject<{
     source_id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
     deep: z.ZodOptional<z.ZodBoolean>;
     with_data_patch: z.ZodOptional<z.ZodObject<{
-        kind: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
         summary: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
@@ -408,15 +454,18 @@ export declare const CellCloneOutput: z.ZodObject<{
         id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
         path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
         data: z.ZodObject<{
-            kind: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             summary: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>;
+        kind: z.ZodNullable<z.ZodString>;
         visibility: z.ZodEnum<{
             private: "private";
             public: "public";
         }>;
         refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+        parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        moderation: z.ZodNullable<z.ZodString>;
         created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
         updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
         created_at: z.ZodString;
@@ -426,6 +475,60 @@ export declare const CellCloneOutput: z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strict>;
 export type CellCloneOutput = z.infer<typeof CellCloneOutput>;
+/**
+ * The terminal transition a `cell_moderate` call applies to a gated
+ * contribution's `moderation` lifecycle. The born state (`'pending'`) is set
+ * by the create authorizer, never on the wire; the verb only moves it to a
+ * terminal state. `'approved'` publishes (also flips `visibility → 'public'`);
+ * `'rejected'` leaves it private.
+ */
+export declare const CellModerationDecision: z.ZodEnum<{
+    rejected: "rejected";
+    approved: "approved";
+}>;
+export type CellModerationDecision = z.infer<typeof CellModerationDecision>;
+/**
+ * Input for `cell_moderate` — the `pending → approved | rejected` transition,
+ * gated on moderation authority over the **governing root** (admin / root
+ * owner in v1), not the contribution (which the author manages, and could
+ * otherwise self-approve). 404 when the target isn't viewable; 403 when it is
+ * but the caller isn't a root manager (the author lands here).
+ */
+export declare const CellModerateInput: z.ZodObject<{
+    cell_id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
+    moderation: z.ZodEnum<{
+        rejected: "rejected";
+        approved: "approved";
+    }>;
+    acting: z.ZodOptional<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+}, z.core.$strict>;
+export type CellModerateInput = z.infer<typeof CellModerateInput>;
+export declare const CellModerateOutput: z.ZodObject<{
+    cell: z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
+        path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
+        data: z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        kind: z.ZodNullable<z.ZodString>;
+        visibility: z.ZodEnum<{
+            private: "private";
+            public: "public";
+        }>;
+        refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+        parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        moderation: z.ZodNullable<z.ZodString>;
+        created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        created_at: z.ZodString;
+        updated_at: z.ZodNullable<z.ZodString>;
+        deleted_at: z.ZodNullable<z.ZodString>;
+        grant_count: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type CellModerateOutput = z.infer<typeof CellModerateOutput>;
 export declare const cell_create_action_spec: {
     method: string;
     kind: "request_response";
@@ -437,15 +540,16 @@ export declare const cell_create_action_spec: {
     side_effects: true;
     input: z.ZodObject<{
         data: z.ZodObject<{
-            kind: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             summary: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         visibility: z.ZodOptional<z.ZodEnum<{
             private: "private";
             public: "public";
         }>>;
         path: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>>;
+        parent_id: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>>;
         acting: z.ZodOptional<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
     }, z.core.$strict>;
     output: z.ZodObject<{
@@ -453,15 +557,18 @@ export declare const cell_create_action_spec: {
             id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
             path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
             data: z.ZodObject<{
-                kind: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
                 summary: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>;
+            kind: z.ZodNullable<z.ZodString>;
             visibility: z.ZodEnum<{
                 private: "private";
                 public: "public";
             }>;
             refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+            parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            moderation: z.ZodNullable<z.ZodString>;
             created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             created_at: z.ZodString;
@@ -493,15 +600,18 @@ export declare const cell_get_action_spec: {
             id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
             path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
             data: z.ZodObject<{
-                kind: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
                 summary: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>;
+            kind: z.ZodNullable<z.ZodString>;
             visibility: z.ZodEnum<{
                 private: "private";
                 public: "public";
             }>;
             refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+            parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            moderation: z.ZodNullable<z.ZodString>;
             created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             created_at: z.ZodString;
@@ -542,7 +652,6 @@ export declare const cell_update_action_spec: {
     input: z.ZodObject<{
         cell_id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
         data: z.ZodOptional<z.ZodObject<{
-            kind: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             summary: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
@@ -558,15 +667,18 @@ export declare const cell_update_action_spec: {
             id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
             path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
             data: z.ZodObject<{
-                kind: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
                 summary: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>;
+            kind: z.ZodNullable<z.ZodString>;
             visibility: z.ZodEnum<{
                 private: "private";
                 public: "public";
             }>;
             refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+            parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            moderation: z.ZodNullable<z.ZodString>;
             created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             created_at: z.ZodString;
@@ -609,7 +721,7 @@ export declare const cell_list_action_spec: {
     side_effects: false;
     input: z.ZodDefault<z.ZodObject<{
         ids: z.ZodOptional<z.ZodArray<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>>;
-        data_kind: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodString>;
         visibility: z.ZodOptional<z.ZodEnum<{
             private: "private";
             public: "public";
@@ -617,6 +729,8 @@ export declare const cell_list_action_spec: {
         ref: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>;
         created_by: z.ZodOptional<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
         path_prefix: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
+        root_id: z.ZodOptional<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        moderation: z.ZodOptional<z.ZodString>;
         shared_with: z.ZodOptional<z.ZodLiteral<"me">>;
         order_by: z.ZodOptional<z.ZodEnum<{
             created_at: "created_at";
@@ -635,15 +749,18 @@ export declare const cell_list_action_spec: {
             id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
             path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
             data: z.ZodObject<{
-                kind: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
                 summary: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>;
+            kind: z.ZodNullable<z.ZodString>;
             visibility: z.ZodEnum<{
                 private: "private";
                 public: "public";
             }>;
             refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+            parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            moderation: z.ZodNullable<z.ZodString>;
             created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             created_at: z.ZodString;
@@ -682,7 +799,6 @@ export declare const cell_clone_action_spec: {
         source_id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
         deep: z.ZodOptional<z.ZodBoolean>;
         with_data_patch: z.ZodOptional<z.ZodObject<{
-            kind: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             summary: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
@@ -693,15 +809,64 @@ export declare const cell_clone_action_spec: {
             id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
             path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
             data: z.ZodObject<{
-                kind: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
                 summary: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>;
+            kind: z.ZodNullable<z.ZodString>;
             visibility: z.ZodEnum<{
                 private: "private";
                 public: "public";
             }>;
             refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+            parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            moderation: z.ZodNullable<z.ZodString>;
+            created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            created_at: z.ZodString;
+            updated_at: z.ZodNullable<z.ZodString>;
+            deleted_at: z.ZodNullable<z.ZodString>;
+            grant_count: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    async: true;
+    rate_limit: "account";
+    description: string;
+};
+export declare const cell_moderate_action_spec: {
+    method: string;
+    kind: "request_response";
+    initiator: "frontend";
+    auth: {
+        account: "required";
+        actor: "required";
+    };
+    side_effects: true;
+    input: z.ZodObject<{
+        cell_id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
+        moderation: z.ZodEnum<{
+            rejected: "rejected";
+            approved: "approved";
+        }>;
+        acting: z.ZodOptional<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+    }, z.core.$strict>;
+    output: z.ZodObject<{
+        cell: z.ZodObject<{
+            id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
+            path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
+            data: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                summary: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+            kind: z.ZodNullable<z.ZodString>;
+            visibility: z.ZodEnum<{
+                private: "private";
+                public: "public";
+            }>;
+            refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+            parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            moderation: z.ZodNullable<z.ZodString>;
             created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             created_at: z.ZodString;
@@ -716,7 +881,7 @@ export declare const cell_clone_action_spec: {
 };
 /**
  * All cell-layer action specs — composed by app registries. Bundles the
- * six generic verbs (this module), the three `cell_grant_*` specs, the
+ * seven generic verbs (this module), the three `cell_grant_*` specs, the
  * three `cell_field_*` specs, the four `cell_item_*` specs, and the
  * `cell_audit_list` spec so codegen + UI clients see a single cell
  * namespace.
@@ -732,15 +897,16 @@ export declare const all_cell_action_specs: readonly [{
     side_effects: true;
     input: z.ZodObject<{
         data: z.ZodObject<{
-            kind: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             summary: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         visibility: z.ZodOptional<z.ZodEnum<{
             private: "private";
             public: "public";
         }>>;
         path: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>>;
+        parent_id: z.ZodOptional<z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>>;
         acting: z.ZodOptional<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
     }, z.core.$strict>;
     output: z.ZodObject<{
@@ -748,15 +914,18 @@ export declare const all_cell_action_specs: readonly [{
             id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
             path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
             data: z.ZodObject<{
-                kind: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
                 summary: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>;
+            kind: z.ZodNullable<z.ZodString>;
             visibility: z.ZodEnum<{
                 private: "private";
                 public: "public";
             }>;
             refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+            parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            moderation: z.ZodNullable<z.ZodString>;
             created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             created_at: z.ZodString;
@@ -787,15 +956,18 @@ export declare const all_cell_action_specs: readonly [{
             id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
             path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
             data: z.ZodObject<{
-                kind: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
                 summary: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>;
+            kind: z.ZodNullable<z.ZodString>;
             visibility: z.ZodEnum<{
                 private: "private";
                 public: "public";
             }>;
             refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+            parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            moderation: z.ZodNullable<z.ZodString>;
             created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             created_at: z.ZodString;
@@ -835,7 +1007,6 @@ export declare const all_cell_action_specs: readonly [{
     input: z.ZodObject<{
         cell_id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
         data: z.ZodOptional<z.ZodObject<{
-            kind: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             summary: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
@@ -851,15 +1022,18 @@ export declare const all_cell_action_specs: readonly [{
             id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
             path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
             data: z.ZodObject<{
-                kind: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
                 summary: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>;
+            kind: z.ZodNullable<z.ZodString>;
             visibility: z.ZodEnum<{
                 private: "private";
                 public: "public";
             }>;
             refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+            parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            moderation: z.ZodNullable<z.ZodString>;
             created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             created_at: z.ZodString;
@@ -900,7 +1074,7 @@ export declare const all_cell_action_specs: readonly [{
     side_effects: false;
     input: z.ZodDefault<z.ZodObject<{
         ids: z.ZodOptional<z.ZodArray<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>>;
-        data_kind: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodString>;
         visibility: z.ZodOptional<z.ZodEnum<{
             private: "private";
             public: "public";
@@ -908,6 +1082,8 @@ export declare const all_cell_action_specs: readonly [{
         ref: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>;
         created_by: z.ZodOptional<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
         path_prefix: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
+        root_id: z.ZodOptional<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+        moderation: z.ZodOptional<z.ZodString>;
         shared_with: z.ZodOptional<z.ZodLiteral<"me">>;
         order_by: z.ZodOptional<z.ZodEnum<{
             created_at: "created_at";
@@ -926,15 +1102,18 @@ export declare const all_cell_action_specs: readonly [{
             id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
             path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
             data: z.ZodObject<{
-                kind: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
                 summary: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>;
+            kind: z.ZodNullable<z.ZodString>;
             visibility: z.ZodEnum<{
                 private: "private";
                 public: "public";
             }>;
             refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+            parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            moderation: z.ZodNullable<z.ZodString>;
             created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             created_at: z.ZodString;
@@ -972,7 +1151,6 @@ export declare const all_cell_action_specs: readonly [{
         source_id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
         deep: z.ZodOptional<z.ZodBoolean>;
         with_data_patch: z.ZodOptional<z.ZodObject<{
-            kind: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             summary: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
@@ -983,15 +1161,63 @@ export declare const all_cell_action_specs: readonly [{
             id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
             path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
             data: z.ZodObject<{
-                kind: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
                 summary: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>;
+            kind: z.ZodNullable<z.ZodString>;
+            visibility: z.ZodEnum<{
+                private: "private";
+                public: "public";
+            }>;
+            refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+            parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            moderation: z.ZodNullable<z.ZodString>;
+            created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            created_at: z.ZodString;
+            updated_at: z.ZodNullable<z.ZodString>;
+            deleted_at: z.ZodNullable<z.ZodString>;
+            grant_count: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    async: true;
+    rate_limit: "account";
+    description: string;
+}, {
+    method: string;
+    kind: "request_response";
+    initiator: "frontend";
+    auth: {
+        account: "required";
+        actor: "required";
+    };
+    side_effects: true;
+    input: z.ZodObject<{
+        cell_id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
+        moderation: z.ZodEnum<{
+            rejected: "rejected";
+            approved: "approved";
+        }>;
+        acting: z.ZodOptional<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+    }, z.core.$strict>;
+    output: z.ZodObject<{
+        cell: z.ZodObject<{
+            id: z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">;
+            path: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "CellPath", "out">>;
+            data: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                summary: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+            kind: z.ZodNullable<z.ZodString>;
             visibility: z.ZodEnum<{
                 private: "private";
                 public: "public";
             }>;
             refs: z.ZodNullable<z.ZodArray<z.core.$ZodBranded<z.ZodString, "FactHash", "out">>>;
+            parent_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            root_id: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
+            moderation: z.ZodNullable<z.ZodString>;
             created_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             updated_by: z.ZodNullable<z.core.$ZodBranded<z.ZodUUID, "Uuid", "out">>;
             created_at: z.ZodString;