wizards 0.2.24 → 0.2.26

package/node_modules/@engenty-wizards/shared/dist/definition.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { type SurfaceComponent } from "./surface.js";
 /** The engenty avatars a wizard can wear. Same cast as engenty's ui-core. */
 export declare const ENGENTY_KINDS: readonly ["round", "drop", "dome", "flame", "oval", "bean", "pebble", "sprout", "tower", "wedge"];
 export type EngentyKind = (typeof ENGENTY_KINDS)[number];
@@ -70,6 +71,56 @@ export declare const itemColumnSchema: z.ZodObject<{
         money: "money";
     }>;
 }, z.core.$strip>;
+export declare const CONDITION_OPS: readonly ["equals", "notEquals", "in", "notEmpty", "empty", "gt", "lt", "contains"];
+export type ConditionOp = (typeof CONDITION_OPS)[number];
+/**
+ * One test on what the run knows: an answer by field id, an output of an agent step as
+ * "steps.<step>.<field>", or how many rows a stored list has as "lists.<list>.count".
+ */
+export declare const conditionSchema: z.ZodObject<{
+    field: z.ZodString;
+    op: z.ZodEnum<{
+        in: "in";
+        equals: "equals";
+        notEquals: "notEquals";
+        notEmpty: "notEmpty";
+        empty: "empty";
+        gt: "gt";
+        lt: "lt";
+        contains: "contains";
+    }>;
+    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strip>;
+export type Condition = z.infer<typeof conditionSchema>;
+/** One condition, or several that must all hold. */
+export declare const whenSchema: z.ZodUnion<readonly [z.ZodObject<{
+    field: z.ZodString;
+    op: z.ZodEnum<{
+        in: "in";
+        equals: "equals";
+        notEquals: "notEquals";
+        notEmpty: "notEmpty";
+        empty: "empty";
+        gt: "gt";
+        lt: "lt";
+        contains: "contains";
+    }>;
+    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strip>, z.ZodArray<z.ZodObject<{
+    field: z.ZodString;
+    op: z.ZodEnum<{
+        in: "in";
+        equals: "equals";
+        notEquals: "notEquals";
+        notEmpty: "notEmpty";
+        empty: "empty";
+        gt: "gt";
+        lt: "lt";
+        contains: "contains";
+    }>;
+    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strip>>]>;
+export type When = z.infer<typeof whenSchema>;
 export declare const fieldSchema: z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
@@ -122,10 +173,58 @@ export declare const fieldSchema: z.ZodObject<{
     connection: z.ZodOptional<z.ZodString>;
     list: z.ZodOptional<z.ZodString>;
     prefill: z.ZodOptional<z.ZodString>;
+    when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        field: z.ZodString;
+        op: z.ZodEnum<{
+            in: "in";
+            equals: "equals";
+            notEquals: "notEquals";
+            notEmpty: "notEmpty";
+            empty: "empty";
+            gt: "gt";
+            lt: "lt";
+            contains: "contains";
+        }>;
+        value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+    }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        op: z.ZodEnum<{
+            in: "in";
+            equals: "equals";
+            notEquals: "notEquals";
+            notEmpty: "notEmpty";
+            empty: "empty";
+            gt: "gt";
+            lt: "lt";
+            contains: "contains";
+        }>;
+        value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+    }, z.core.$strip>>]>>;
+    optionsFrom: z.ZodOptional<z.ZodString>;
+    ask: z.ZodOptional<z.ZodString>;
+    group: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type Field = z.infer<typeof fieldSchema>;
+export declare const fieldGroupSchema: z.ZodObject<{
+    id: z.ZodString;
+    instructions: z.ZodString;
+    optional: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
 export declare const nextRuleSchema: z.ZodObject<{
-    when: z.ZodObject<{
+    when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        field: z.ZodString;
+        op: z.ZodEnum<{
+            in: "in";
+            equals: "equals";
+            notEquals: "notEquals";
+            notEmpty: "notEmpty";
+            empty: "empty";
+            gt: "gt";
+            lt: "lt";
+            contains: "contains";
+        }>;
+        value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+    }, z.core.$strip>, z.ZodArray<z.ZodObject<{
         field: z.ZodString;
         op: z.ZodEnum<{
             in: "in";
@@ -133,21 +232,27 @@ export declare const nextRuleSchema: z.ZodObject<{
             notEquals: "notEquals";
             notEmpty: "notEmpty";
             empty: "empty";
+            gt: "gt";
+            lt: "lt";
+            contains: "contains";
         }>;
         value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-    }, z.core.$strip>;
+    }, z.core.$strip>>]>>;
+    ask: z.ZodOptional<z.ZodString>;
     goto: z.ZodString;
+    max: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type NextRule = z.infer<typeof nextRuleSchema>;
 export declare const outputFieldSchema: z.ZodObject<{
     id: z.ZodString;
     kind: z.ZodEnum<{
         number: "number";
+        choice: "choice";
+        score: "score";
         text: "text";
         list: "list";
         table: "table";
         yesno: "yesno";
-        choice: "choice";
     }>;
     description: z.ZodOptional<z.ZodString>;
     columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -207,13 +312,48 @@ export declare const pageStepSchema: z.ZodObject<{
         connection: z.ZodOptional<z.ZodString>;
         list: z.ZodOptional<z.ZodString>;
         prefill: z.ZodOptional<z.ZodString>;
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        optionsFrom: z.ZodOptional<z.ZodString>;
+        ask: z.ZodOptional<z.ZodString>;
+        group: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        instructions: z.ZodString;
+        optional: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
     cta: z.ZodOptional<z.ZodString>;
     id: z.ZodString;
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -221,10 +361,28 @@ export declare const pageStepSchema: z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const agentStepSchema: z.ZodObject<{
@@ -251,16 +409,18 @@ export declare const agentStepSchema: z.ZodObject<{
             id: z.ZodString;
             kind: z.ZodEnum<{
                 number: "number";
+                choice: "choice";
+                score: "score";
                 text: "text";
                 list: "list";
                 table: "table";
                 yesno: "yesno";
-                choice: "choice";
             }>;
             description: z.ZodOptional<z.ZodString>;
             columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
             options: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>>;
+        surface: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     model: z.ZodOptional<z.ZodEnum<{
         classifier: "classifier";
@@ -273,12 +433,13 @@ export declare const agentStepSchema: z.ZodObject<{
         high: "high";
         low: "low";
     }>>;
+    each: z.ZodOptional<z.ZodString>;
     working: z.ZodOptional<z.ZodString>;
     id: z.ZodString;
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -286,10 +447,28 @@ export declare const agentStepSchema: z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const generateStepSchema: z.ZodObject<{
@@ -344,7 +523,7 @@ export declare const generateStepSchema: z.ZodObject<{
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -352,10 +531,28 @@ export declare const generateStepSchema: z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const widgetStepSchema: z.ZodObject<{
@@ -373,7 +570,7 @@ export declare const widgetStepSchema: z.ZodObject<{
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -381,10 +578,28 @@ export declare const widgetStepSchema: z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 /** Formats a film step makes; the composition is drawn for this frame. */
@@ -427,7 +642,7 @@ export declare const filmStepSchema: z.ZodObject<{
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -435,12 +650,168 @@ export declare const filmStepSchema: z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
+/** A piece a decided surface may show: its components (the first has the piece's id) and what it shows. */
+export declare const surfaceCandidateSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    components: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        component: z.ZodEnum<{
+            Column: "Column";
+            Text: "Text";
+            List: "List";
+            Row: "Row";
+            DetailGrid: "DetailGrid";
+            Badge: "Badge";
+            Grid: "Grid";
+            Metric: "Metric";
+            Table: "Table";
+            Image: "Image";
+            BarChart: "BarChart";
+            LineChart: "LineChart";
+            DonutChart: "DonutChart";
+            Actions: "Actions";
+            Button: "Button";
+        }>;
+        children: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+            path: z.ZodString;
+            componentId: z.ZodString;
+        }, z.core.$strip>]>>;
+    }, z.core.$loose>>;
+    group: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const surfaceStepSchema: z.ZodObject<{
+    type: z.ZodLiteral<"surface">;
+    components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        component: z.ZodEnum<{
+            Column: "Column";
+            Text: "Text";
+            List: "List";
+            Row: "Row";
+            DetailGrid: "DetailGrid";
+            Badge: "Badge";
+            Grid: "Grid";
+            Metric: "Metric";
+            Table: "Table";
+            Image: "Image";
+            BarChart: "BarChart";
+            LineChart: "LineChart";
+            DonutChart: "DonutChart";
+            Actions: "Actions";
+            Button: "Button";
+        }>;
+        children: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+            path: z.ZodString;
+            componentId: z.ZodString;
+        }, z.core.$strip>]>>;
+    }, z.core.$loose>>>;
+    candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        components: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            component: z.ZodEnum<{
+                Column: "Column";
+                Text: "Text";
+                List: "List";
+                Row: "Row";
+                DetailGrid: "DetailGrid";
+                Badge: "Badge";
+                Grid: "Grid";
+                Metric: "Metric";
+                Table: "Table";
+                Image: "Image";
+                BarChart: "BarChart";
+                LineChart: "LineChart";
+                DonutChart: "DonutChart";
+                Actions: "Actions";
+                Button: "Button";
+            }>;
+            children: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+                path: z.ZodString;
+                componentId: z.ZodString;
+            }, z.core.$strip>]>>;
+        }, z.core.$loose>>;
+        group: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        instructions: z.ZodString;
+        optional: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    data: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    working: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    next: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
+        goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * The components of a decided surface for the pieces kept: one root column holding them in
+ * their order. Every piece kept is the same as all of them for the validator.
+ */
+export declare function assembleSurface(candidates: {
+    id: string;
+    components: SurfaceComponent[];
+}[], kept: Iterable<string>): SurfaceComponent[];
 export declare const reviewStepSchema: z.ZodObject<{
     type: z.ZodLiteral<"review">;
     show: z.ZodArray<z.ZodString>;
@@ -450,7 +821,7 @@ export declare const reviewStepSchema: z.ZodObject<{
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -458,10 +829,28 @@ export declare const reviewStepSchema: z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const deliverableSchema: z.ZodObject<{
@@ -507,7 +896,7 @@ export declare const resultStepSchema: z.ZodObject<{
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -515,10 +904,28 @@ export declare const resultStepSchema: z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -575,13 +982,48 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         connection: z.ZodOptional<z.ZodString>;
         list: z.ZodOptional<z.ZodString>;
         prefill: z.ZodOptional<z.ZodString>;
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        optionsFrom: z.ZodOptional<z.ZodString>;
+        ask: z.ZodOptional<z.ZodString>;
+        group: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        instructions: z.ZodString;
+        optional: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
     cta: z.ZodOptional<z.ZodString>;
     id: z.ZodString;
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -589,10 +1031,28 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"agent">;
@@ -618,16 +1078,18 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             id: z.ZodString;
             kind: z.ZodEnum<{
                 number: "number";
+                choice: "choice";
+                score: "score";
                 text: "text";
                 list: "list";
                 table: "table";
                 yesno: "yesno";
-                choice: "choice";
             }>;
             description: z.ZodOptional<z.ZodString>;
             columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
             options: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>>;
+        surface: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     model: z.ZodOptional<z.ZodEnum<{
         classifier: "classifier";
@@ -640,12 +1102,13 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         high: "high";
         low: "low";
     }>>;
+    each: z.ZodOptional<z.ZodString>;
     working: z.ZodOptional<z.ZodString>;
     id: z.ZodString;
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -653,10 +1116,28 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"generate">;
@@ -710,7 +1191,7 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -718,10 +1199,28 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"widget">;
@@ -738,7 +1237,7 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -746,10 +1245,126 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"surface">;
+    components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        component: z.ZodEnum<{
+            Column: "Column";
+            Text: "Text";
+            List: "List";
+            Row: "Row";
+            DetailGrid: "DetailGrid";
+            Badge: "Badge";
+            Grid: "Grid";
+            Metric: "Metric";
+            Table: "Table";
+            Image: "Image";
+            BarChart: "BarChart";
+            LineChart: "LineChart";
+            DonutChart: "DonutChart";
+            Actions: "Actions";
+            Button: "Button";
+        }>;
+        children: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+            path: z.ZodString;
+            componentId: z.ZodString;
+        }, z.core.$strip>]>>;
+    }, z.core.$loose>>>;
+    candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        components: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            component: z.ZodEnum<{
+                Column: "Column";
+                Text: "Text";
+                List: "List";
+                Row: "Row";
+                DetailGrid: "DetailGrid";
+                Badge: "Badge";
+                Grid: "Grid";
+                Metric: "Metric";
+                Table: "Table";
+                Image: "Image";
+                BarChart: "BarChart";
+                LineChart: "LineChart";
+                DonutChart: "DonutChart";
+                Actions: "Actions";
+                Button: "Button";
+            }>;
+            children: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+                path: z.ZodString;
+                componentId: z.ZodString;
+            }, z.core.$strip>]>>;
+        }, z.core.$loose>>;
+        group: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        instructions: z.ZodString;
+        optional: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    data: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    working: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    next: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
+        goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"film">;
@@ -779,7 +1394,7 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -787,10 +1402,28 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"review">;
@@ -801,7 +1434,7 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -809,10 +1442,28 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"result">;
@@ -839,7 +1490,7 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        when: z.ZodObject<{
+        when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             field: z.ZodString;
             op: z.ZodEnum<{
                 in: "in";
@@ -847,14 +1498,33 @@ export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 notEquals: "notEquals";
                 notEmpty: "notEmpty";
                 empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
             }>;
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                equals: "equals";
+                notEquals: "notEquals";
+                notEmpty: "notEmpty";
+                empty: "empty";
+                gt: "gt";
+                lt: "lt";
+                contains: "contains";
+            }>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>>]>>;
+        ask: z.ZodOptional<z.ZodString>;
         goto: z.ZodString;
+        max: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>], "type">;
 export type Step = z.infer<typeof stepSchema>;
 export type PageStep = z.infer<typeof pageStepSchema>;
+export type SurfaceStep = z.infer<typeof surfaceStepSchema>;
 export type AgentStep = z.infer<typeof agentStepSchema>;
 /**
  * A decision: a step on the classifier class that uses no tools and whose output is only
@@ -1233,13 +1903,48 @@ export declare const wizardSchema: z.ZodObject<{
             connection: z.ZodOptional<z.ZodString>;
             list: z.ZodOptional<z.ZodString>;
             prefill: z.ZodOptional<z.ZodString>;
+            when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notEmpty: "notEmpty";
+                    empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
+                }>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notEmpty: "notEmpty";
+                    empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
+                }>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>>]>>;
+            optionsFrom: z.ZodOptional<z.ZodString>;
+            ask: z.ZodOptional<z.ZodString>;
+            group: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            instructions: z.ZodString;
+            optional: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
         cta: z.ZodOptional<z.ZodString>;
         id: z.ZodString;
         title: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            when: z.ZodObject<{
+            when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
                 field: z.ZodString;
                 op: z.ZodEnum<{
                     in: "in";
@@ -1247,10 +1952,28 @@ export declare const wizardSchema: z.ZodObject<{
                     notEquals: "notEquals";
                     notEmpty: "notEmpty";
                     empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
                 }>;
                 value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-            }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notEmpty: "notEmpty";
+                    empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
+                }>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>>]>>;
+            ask: z.ZodOptional<z.ZodString>;
             goto: z.ZodString;
+            max: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"agent">;
@@ -1276,16 +1999,18 @@ export declare const wizardSchema: z.ZodObject<{
                 id: z.ZodString;
                 kind: z.ZodEnum<{
                     number: "number";
+                    choice: "choice";
+                    score: "score";
                     text: "text";
                     list: "list";
                     table: "table";
                     yesno: "yesno";
-                    choice: "choice";
                 }>;
                 description: z.ZodOptional<z.ZodString>;
                 columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 options: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>>;
+            surface: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
         model: z.ZodOptional<z.ZodEnum<{
             classifier: "classifier";
@@ -1298,12 +2023,13 @@ export declare const wizardSchema: z.ZodObject<{
             high: "high";
             low: "low";
         }>>;
+        each: z.ZodOptional<z.ZodString>;
         working: z.ZodOptional<z.ZodString>;
         id: z.ZodString;
         title: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            when: z.ZodObject<{
+            when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
                 field: z.ZodString;
                 op: z.ZodEnum<{
                     in: "in";
@@ -1311,10 +2037,28 @@ export declare const wizardSchema: z.ZodObject<{
                     notEquals: "notEquals";
                     notEmpty: "notEmpty";
                     empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
                 }>;
                 value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-            }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notEmpty: "notEmpty";
+                    empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
+                }>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>>]>>;
+            ask: z.ZodOptional<z.ZodString>;
             goto: z.ZodString;
+            max: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"generate">;
@@ -1368,7 +2112,7 @@ export declare const wizardSchema: z.ZodObject<{
         title: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            when: z.ZodObject<{
+            when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
                 field: z.ZodString;
                 op: z.ZodEnum<{
                     in: "in";
@@ -1376,10 +2120,28 @@ export declare const wizardSchema: z.ZodObject<{
                     notEquals: "notEquals";
                     notEmpty: "notEmpty";
                     empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
                 }>;
                 value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-            }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notEmpty: "notEmpty";
+                    empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
+                }>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>>]>>;
+            ask: z.ZodOptional<z.ZodString>;
             goto: z.ZodString;
+            max: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"widget">;
@@ -1396,7 +2158,7 @@ export declare const wizardSchema: z.ZodObject<{
         title: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            when: z.ZodObject<{
+            when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
                 field: z.ZodString;
                 op: z.ZodEnum<{
                     in: "in";
@@ -1404,10 +2166,126 @@ export declare const wizardSchema: z.ZodObject<{
                     notEquals: "notEquals";
                     notEmpty: "notEmpty";
                     empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
                 }>;
                 value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-            }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notEmpty: "notEmpty";
+                    empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
+                }>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>>]>>;
+            ask: z.ZodOptional<z.ZodString>;
+            goto: z.ZodString;
+            max: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"surface">;
+        components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            component: z.ZodEnum<{
+                Column: "Column";
+                Text: "Text";
+                List: "List";
+                Row: "Row";
+                DetailGrid: "DetailGrid";
+                Badge: "Badge";
+                Grid: "Grid";
+                Metric: "Metric";
+                Table: "Table";
+                Image: "Image";
+                BarChart: "BarChart";
+                LineChart: "LineChart";
+                DonutChart: "DonutChart";
+                Actions: "Actions";
+                Button: "Button";
+            }>;
+            children: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+                path: z.ZodString;
+                componentId: z.ZodString;
+            }, z.core.$strip>]>>;
+        }, z.core.$loose>>>;
+        candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            description: z.ZodString;
+            components: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                component: z.ZodEnum<{
+                    Column: "Column";
+                    Text: "Text";
+                    List: "List";
+                    Row: "Row";
+                    DetailGrid: "DetailGrid";
+                    Badge: "Badge";
+                    Grid: "Grid";
+                    Metric: "Metric";
+                    Table: "Table";
+                    Image: "Image";
+                    BarChart: "BarChart";
+                    LineChart: "LineChart";
+                    DonutChart: "DonutChart";
+                    Actions: "Actions";
+                    Button: "Button";
+                }>;
+                children: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+                    path: z.ZodString;
+                    componentId: z.ZodString;
+                }, z.core.$strip>]>>;
+            }, z.core.$loose>>;
+            group: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            instructions: z.ZodString;
+            optional: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        data: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        working: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notEmpty: "notEmpty";
+                    empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
+                }>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notEmpty: "notEmpty";
+                    empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
+                }>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>>]>>;
+            ask: z.ZodOptional<z.ZodString>;
             goto: z.ZodString;
+            max: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"film">;
@@ -1437,7 +2315,7 @@ export declare const wizardSchema: z.ZodObject<{
         title: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            when: z.ZodObject<{
+            when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
                 field: z.ZodString;
                 op: z.ZodEnum<{
                     in: "in";
@@ -1445,10 +2323,28 @@ export declare const wizardSchema: z.ZodObject<{
                     notEquals: "notEquals";
                     notEmpty: "notEmpty";
                     empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
                 }>;
                 value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-            }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notEmpty: "notEmpty";
+                    empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
+                }>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>>]>>;
+            ask: z.ZodOptional<z.ZodString>;
             goto: z.ZodString;
+            max: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"review">;
@@ -1459,7 +2355,7 @@ export declare const wizardSchema: z.ZodObject<{
         title: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            when: z.ZodObject<{
+            when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
                 field: z.ZodString;
                 op: z.ZodEnum<{
                     in: "in";
@@ -1467,10 +2363,28 @@ export declare const wizardSchema: z.ZodObject<{
                     notEquals: "notEquals";
                     notEmpty: "notEmpty";
                     empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
                 }>;
                 value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-            }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notEmpty: "notEmpty";
+                    empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
+                }>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>>]>>;
+            ask: z.ZodOptional<z.ZodString>;
             goto: z.ZodString;
+            max: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"result">;
@@ -1497,7 +2411,7 @@ export declare const wizardSchema: z.ZodObject<{
         title: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         next: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            when: z.ZodObject<{
+            when: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
                 field: z.ZodString;
                 op: z.ZodEnum<{
                     in: "in";
@@ -1505,10 +2419,28 @@ export declare const wizardSchema: z.ZodObject<{
                     notEquals: "notEquals";
                     notEmpty: "notEmpty";
                     empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
                 }>;
                 value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-            }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notEmpty: "notEmpty";
+                    empty: "empty";
+                    gt: "gt";
+                    lt: "lt";
+                    contains: "contains";
+                }>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>>]>>;
+            ask: z.ZodOptional<z.ZodString>;
             goto: z.ZodString;
+            max: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
     }, z.core.$strip>], "type">>;
 }, z.core.$strip>;
@@ -1561,10 +2493,76 @@ export declare function parseWizard(input: unknown, files?: string[]): {
  */
 export declare function branchValues(values: Record<string, unknown>, outputs: Record<string, {
     json?: unknown;
-}>): Record<string, unknown>;
-/** The step after `step`, honouring its branch rules. `null` = the end. */
+    decided?: Record<string, number>;
+}>, 
+/** Rows per stored list, read as `lists.<list>.count`. */
+listCounts?: Record<string, number>): Record<string, unknown>;
+/** A branch back to an earlier step without `max` is taken at most this often in one run. */
+export declare const DEFAULT_LOOP_MAX = 10;
+/** How a run counts the times it took a branch: "<step>→<goto>". */
+export declare function loopKey(stepId: string, goto: string): string;
+/** Whether a rule may still send the run on: one with `max`, or one back, stops after so many. */
+export declare function ruleOpen(def: WizardDefinition, stepId: string, rule: NextRule, loops?: Record<string, number>): boolean;
+/**
+ * Where a run goes after a step: the first open `when` rule that holds (`rule` is its index in
+ * `next`), else a decision over the open `ask` rules, else the next step in the list. `cursor`
+ * null = the end.
+ */
+export type RuleOutcome = {
+    kind: "go";
+    cursor: string | null;
+    rule: number | null;
+} | {
+    kind: "decide";
+    rules: number[];
+};
+export declare function followRules(def: WizardDefinition, stepId: string, values: Record<string, unknown>, loops?: Record<string, number>): RuleOutcome;
+/** A rule with neither a condition nor a statement: where the run goes when no other rule holds. */
+export declare function isOtherwise(rule: NextRule): boolean;
+/**
+ * Where a step goes when none of its rules holds: its "otherwise" rule (`rule` is its index in
+ * `next`), else the next step in the list. `cursor` null = the end.
+ */
+export declare function otherwiseOf(def: WizardDefinition, stepId: string, loops?: Record<string, number>): {
+    cursor: string | null;
+    rule: number | null;
+};
+/** The step after `step` by its `when` rules alone. `null` = the end. */
 export declare function nextStepId(def: WizardDefinition, stepId: string, values: Record<string, unknown>): string | null;
+/** The conditions of a rule or a field, as a list: one, several, or none. */
+export declare function conditionsOf(when: When | undefined): Condition[];
+export declare function conditionMatches(c: Condition, values: Record<string, unknown>): boolean;
+/** Whether every condition holds; no conditions hold trivially. */
+export declare function whenHolds(when: When | undefined, values: Record<string, unknown>): boolean;
+/** Whether a `when` rule holds. An `ask` rule never holds here: a decision takes it (see decide). */
 export declare function ruleMatches(rule: NextRule, values: Record<string, unknown>): boolean;
+/** A page with decided fields has at most this many; it shows at most MAX_SHOWN_FIELDS of them. */
+export declare const MAX_DECIDED_FIELDS = 12;
+export declare const MAX_SHOWN_FIELDS = 5;
+/** Whether a field is shown only when a decision keeps it. */
+export declare function isDecidedField(field: Field): boolean;
+/**
+ * The fields of a page that are shown: those whose `when` holds on what was known before the
+ * page (`known`) and what the page holds so far (`page`). A hidden field's value does not count
+ * for the fields after it.
+ */
+export declare function shownFields(fields: Field[], known: Record<string, unknown>, page: Record<string, unknown>): Field[];
+/** The references the `when` of a page's fields read outside the page: what the page must know. */
+export declare function pageNeeds(fields: Field[]): string[];
+/** At most this many choices come from data. */
+export declare const MAX_DATA_OPTIONS = 100;
+/**
+ * The choices an `optionsFrom` reference finds in a run: the entries of a list output, one
+ * column of a table output, or one column of a stored list — as text, without duplicates and
+ * empties. Empty when the data is not there (yet).
+ */
+export declare function optionsFromData(ref: string, outputs: Record<string, {
+    json?: unknown;
+}>, lists?: Record<string, {
+    rows: {
+        cells: Record<string, unknown>;
+    }[];
+}>): string[];
 export interface ItemsTotals {
     rows: Record<string, unknown>[];
     net: number;