@engenty/wizards-runtime 0.0.0-stage → 0.7.5

package/node_modules/@engenty-wizards/shared/dist/engenty/data-tables/columns.d.ts

@@ -0,0 +1,532 @@
+/**
+ * Space-table column definitions.
+ *
+ * A table is a small database, not a CSV dump: every column has a type and a
+ * display format. Agents create the definition; row writes are validated
+ * against it.
+ */
+import { z } from "zod";
+export declare const numberStyleSchema: z.ZodEnum<{
+    currency: "currency";
+    decimal: "decimal";
+    integer: "integer";
+    percent: "percent";
+}>;
+export type NumberStyle = z.infer<typeof numberStyleSchema>;
+export declare const numberFormatSchema: z.ZodObject<{
+    currency: z.ZodOptional<z.ZodString>;
+    fractionDigits: z.ZodOptional<z.ZodNumber>;
+    grouping: z.ZodOptional<z.ZodBoolean>;
+    style: z.ZodEnum<{
+        currency: "currency";
+        decimal: "decimal";
+        integer: "integer";
+        percent: "percent";
+    }>;
+}, z.core.$strip>;
+export type NumberFormat = z.infer<typeof numberFormatSchema>;
+export declare const dateKindSchema: z.ZodEnum<{
+    date: "date";
+    datetime: "datetime";
+    time: "time";
+}>;
+export type DateKind = z.infer<typeof dateKindSchema>;
+export declare const dateStyleSchema: z.ZodEnum<{
+    iso: "iso";
+    long: "long";
+    medium: "medium";
+    short: "short";
+}>;
+export type DateStyle = z.infer<typeof dateStyleSchema>;
+/** `hours` is clock time with no minutes — `14` or `14:30` both store as `14:00`. */
+export declare const timePrecisionSchema: z.ZodEnum<{
+    hours: "hours";
+    minutes: "minutes";
+    seconds: "seconds";
+}>;
+export type TimePrecision = z.infer<typeof timePrecisionSchema>;
+export declare const dateFormatSchema: z.ZodObject<{
+    dateStyle: z.ZodOptional<z.ZodEnum<{
+        iso: "iso";
+        long: "long";
+        medium: "medium";
+        short: "short";
+    }>>;
+    kind: z.ZodEnum<{
+        date: "date";
+        datetime: "datetime";
+        time: "time";
+    }>;
+    timePrecision: z.ZodOptional<z.ZodEnum<{
+        hours: "hours";
+        minutes: "minutes";
+        seconds: "seconds";
+    }>>;
+}, z.core.$strip>;
+export type DateFormat = z.infer<typeof dateFormatSchema>;
+export declare const durationUnitSchema: z.ZodEnum<{
+    days: "days";
+    hours: "hours";
+    milliseconds: "milliseconds";
+    minutes: "minutes";
+    seconds: "seconds";
+}>;
+export type DurationUnit = z.infer<typeof durationUnitSchema>;
+export declare const durationDisplaySchema: z.ZodEnum<{
+    "decimal-hours": "decimal-hours";
+    hms: "hms";
+    hours: "hours";
+    iso: "iso";
+    minutes: "minutes";
+}>;
+export type DurationDisplay = z.infer<typeof durationDisplaySchema>;
+export declare const durationFormatSchema: z.ZodObject<{
+    display: z.ZodEnum<{
+        "decimal-hours": "decimal-hours";
+        hms: "hms";
+        hours: "hours";
+        iso: "iso";
+        minutes: "minutes";
+    }>;
+    inputUnit: z.ZodEnum<{
+        days: "days";
+        hours: "hours";
+        milliseconds: "milliseconds";
+        minutes: "minutes";
+        seconds: "seconds";
+    }>;
+}, z.core.$strip>;
+export type DurationFormat = z.infer<typeof durationFormatSchema>;
+export declare const selectOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+}, z.core.$strip>;
+export type SelectOption = z.infer<typeof selectOptionSchema>;
+export declare const selectFormatSchema: z.ZodObject<{
+    allowCustom: z.ZodBoolean;
+    multiple: z.ZodOptional<z.ZodBoolean>;
+    options: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SelectFormat = z.infer<typeof selectFormatSchema>;
+export declare const textStyleSchema: z.ZodEnum<{
+    markdown: "markdown";
+    multiline: "multiline";
+    single: "single";
+}>;
+export type TextStyle = z.infer<typeof textStyleSchema>;
+export declare const textFormatSchema: z.ZodObject<{
+    style: z.ZodDefault<z.ZodEnum<{
+        markdown: "markdown";
+        multiline: "multiline";
+        single: "single";
+    }>>;
+}, z.core.$strip>;
+export type TextFormat = z.infer<typeof textFormatSchema>;
+export declare const tableColumnSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodOptional<z.ZodObject<{
+        style: z.ZodDefault<z.ZodEnum<{
+            markdown: "markdown";
+            multiline: "multiline";
+            single: "single";
+        }>>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"text">;
+}, z.core.$strip>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodObject<{
+        currency: z.ZodOptional<z.ZodString>;
+        fractionDigits: z.ZodOptional<z.ZodNumber>;
+        grouping: z.ZodOptional<z.ZodBoolean>;
+        style: z.ZodEnum<{
+            currency: "currency";
+            decimal: "decimal";
+            integer: "integer";
+            percent: "percent";
+        }>;
+    }, z.core.$strip>;
+    type: z.ZodLiteral<"number">;
+}, z.core.$strip>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodObject<{
+        dateStyle: z.ZodOptional<z.ZodEnum<{
+            iso: "iso";
+            long: "long";
+            medium: "medium";
+            short: "short";
+        }>>;
+        kind: z.ZodEnum<{
+            date: "date";
+            datetime: "datetime";
+            time: "time";
+        }>;
+        timePrecision: z.ZodOptional<z.ZodEnum<{
+            hours: "hours";
+            minutes: "minutes";
+            seconds: "seconds";
+        }>>;
+    }, z.core.$strip>;
+    type: z.ZodLiteral<"date">;
+}, z.core.$strip>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodObject<{
+        display: z.ZodEnum<{
+            "decimal-hours": "decimal-hours";
+            hms: "hms";
+            hours: "hours";
+            iso: "iso";
+            minutes: "minutes";
+        }>;
+        inputUnit: z.ZodEnum<{
+            days: "days";
+            hours: "hours";
+            milliseconds: "milliseconds";
+            minutes: "minutes";
+            seconds: "seconds";
+        }>;
+    }, z.core.$strip>;
+    type: z.ZodLiteral<"duration">;
+}, z.core.$strip>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodObject<{
+        allowCustom: z.ZodBoolean;
+        multiple: z.ZodOptional<z.ZodBoolean>;
+        options: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    type: z.ZodLiteral<"select">;
+}, z.core.$strip>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"boolean">;
+}, z.core.$strip>], "type">;
+export type TableColumn = z.infer<typeof tableColumnSchema>;
+export type ColumnEdit = NonNullable<TableColumn["edit"]>;
+export declare function textColumnStyle(column: TableColumn): TextStyle;
+/** Where this cell is edited. Explicit `edit` wins; otherwise type defaults. */
+export declare function columnEdit(column: TableColumn): ColumnEdit;
+export declare const tableColumnsSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodOptional<z.ZodObject<{
+        style: z.ZodDefault<z.ZodEnum<{
+            markdown: "markdown";
+            multiline: "multiline";
+            single: "single";
+        }>>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"text">;
+}, z.core.$strip>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodObject<{
+        currency: z.ZodOptional<z.ZodString>;
+        fractionDigits: z.ZodOptional<z.ZodNumber>;
+        grouping: z.ZodOptional<z.ZodBoolean>;
+        style: z.ZodEnum<{
+            currency: "currency";
+            decimal: "decimal";
+            integer: "integer";
+            percent: "percent";
+        }>;
+    }, z.core.$strip>;
+    type: z.ZodLiteral<"number">;
+}, z.core.$strip>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodObject<{
+        dateStyle: z.ZodOptional<z.ZodEnum<{
+            iso: "iso";
+            long: "long";
+            medium: "medium";
+            short: "short";
+        }>>;
+        kind: z.ZodEnum<{
+            date: "date";
+            datetime: "datetime";
+            time: "time";
+        }>;
+        timePrecision: z.ZodOptional<z.ZodEnum<{
+            hours: "hours";
+            minutes: "minutes";
+            seconds: "seconds";
+        }>>;
+    }, z.core.$strip>;
+    type: z.ZodLiteral<"date">;
+}, z.core.$strip>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodObject<{
+        display: z.ZodEnum<{
+            "decimal-hours": "decimal-hours";
+            hms: "hms";
+            hours: "hours";
+            iso: "iso";
+            minutes: "minutes";
+        }>;
+        inputUnit: z.ZodEnum<{
+            days: "days";
+            hours: "hours";
+            milliseconds: "milliseconds";
+            minutes: "minutes";
+            seconds: "seconds";
+        }>;
+    }, z.core.$strip>;
+    type: z.ZodLiteral<"duration">;
+}, z.core.$strip>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodObject<{
+        allowCustom: z.ZodBoolean;
+        multiple: z.ZodOptional<z.ZodBoolean>;
+        options: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    type: z.ZodLiteral<"select">;
+}, z.core.$strip>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"boolean">;
+}, z.core.$strip>], "type">>;
+/**
+ * The shape a MODEL is shown for `columns`, as opposed to the one we validate.
+ *
+ * `tableColumnsSchema` is a six-branch discriminated union that repeats the
+ * whole column base per branch. As a tool's JSON Schema that came to 14.7 KB —
+ * on its own 5% of a copilot prompt, resent on every model call of every run,
+ * whether or not a table is in play. The union earns that as a *contract*; it
+ * does not earn it as a *hint*.
+ *
+ * So the wire shape is one flat object with every format key optional, and the
+ * tool re-parses the result with `tableColumnsSchema` before doing anything.
+ * Validation is unchanged and the error the model gets back is the strict
+ * schema's own; only the advertisement shrinks. Per-type rules live in the
+ * tool description, which the model reads anyway.
+ */
+export declare const tableColumnWireSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        allowCustom: z.ZodOptional<z.ZodBoolean>;
+        currency: z.ZodOptional<z.ZodString>;
+        dateStyle: z.ZodOptional<z.ZodEnum<{
+            iso: "iso";
+            long: "long";
+            medium: "medium";
+            short: "short";
+        }>>;
+        display: z.ZodOptional<z.ZodEnum<{
+            "decimal-hours": "decimal-hours";
+            hms: "hms";
+            hours: "hours";
+            iso: "iso";
+            minutes: "minutes";
+        }>>;
+        fractionDigits: z.ZodOptional<z.ZodNumber>;
+        grouping: z.ZodOptional<z.ZodBoolean>;
+        inputUnit: z.ZodOptional<z.ZodEnum<{
+            days: "days";
+            hours: "hours";
+            milliseconds: "milliseconds";
+            minutes: "minutes";
+            seconds: "seconds";
+        }>>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            date: "date";
+            datetime: "datetime";
+            time: "time";
+        }>>;
+        multiple: z.ZodOptional<z.ZodBoolean>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            currency: "currency";
+            decimal: "decimal";
+            integer: "integer";
+            markdown: "markdown";
+            multiline: "multiline";
+            percent: "percent";
+            single: "single";
+        }>>;
+        timePrecision: z.ZodOptional<z.ZodEnum<{
+            hours: "hours";
+            minutes: "minutes";
+            seconds: "seconds";
+        }>>;
+    }, z.core.$strip>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodEnum<{
+        boolean: "boolean";
+        date: "date";
+        duration: "duration";
+        number: "number";
+        select: "select";
+        text: "text";
+    }>;
+}, z.core.$strip>;
+export declare const tableColumnsWireSchema: z.ZodArray<z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    edit: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        popout: "popout";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        allowCustom: z.ZodOptional<z.ZodBoolean>;
+        currency: z.ZodOptional<z.ZodString>;
+        dateStyle: z.ZodOptional<z.ZodEnum<{
+            iso: "iso";
+            long: "long";
+            medium: "medium";
+            short: "short";
+        }>>;
+        display: z.ZodOptional<z.ZodEnum<{
+            "decimal-hours": "decimal-hours";
+            hms: "hms";
+            hours: "hours";
+            iso: "iso";
+            minutes: "minutes";
+        }>>;
+        fractionDigits: z.ZodOptional<z.ZodNumber>;
+        grouping: z.ZodOptional<z.ZodBoolean>;
+        inputUnit: z.ZodOptional<z.ZodEnum<{
+            days: "days";
+            hours: "hours";
+            milliseconds: "milliseconds";
+            minutes: "minutes";
+            seconds: "seconds";
+        }>>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            date: "date";
+            datetime: "datetime";
+            time: "time";
+        }>>;
+        multiple: z.ZodOptional<z.ZodBoolean>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            currency: "currency";
+            decimal: "decimal";
+            integer: "integer";
+            markdown: "markdown";
+            multiline: "multiline";
+            percent: "percent";
+            single: "single";
+        }>>;
+        timePrecision: z.ZodOptional<z.ZodEnum<{
+            hours: "hours";
+            minutes: "minutes";
+            seconds: "seconds";
+        }>>;
+    }, z.core.$strip>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodEnum<{
+        boolean: "boolean";
+        date: "date";
+        duration: "duration";
+        number: "number";
+        select: "select";
+        text: "text";
+    }>;
+}, z.core.$strip>>;
+export type TableColumnWire = z.infer<typeof tableColumnWireSchema>;
+export declare const DATA_TABLE_ARTIFACT_TYPE: "database";
+export declare const DATA_TABLE_MIME_TYPE = "application/vnd.engenty.database+json";
+export declare const dataTableHandleSchema: z.ZodObject<{
+    table_id: z.ZodString;
+}, z.core.$strip>;
+export type DataTableHandle = z.infer<typeof dataTableHandleSchema>;