@proteos/sdk 0.45.0 → 0.47.0

package/dist/{types-BTdBFq34.d.cts → types-oECz4xTQ.d.cts}

@@ -1428,6 +1428,8 @@ declare const LayoutElementType: {
     readonly Component: "component";
     readonly Divider: "divider";
     readonly Text: "text";
+    readonly RecordFilter: "record_filter";
+    readonly List: "list";
 };
 type LayoutElementType = (typeof LayoutElementType)[keyof typeof LayoutElementType];
 type RowElement = CommonProps & {
@@ -1548,6 +1550,70 @@ type ComponentElement = CommonProps & {
      *  to the host's 80px fallback when unset. */
     reserved_height?: number;
 };
+/**
+ * A filter builder placed directly on a page. It owns no data of its own: it
+ * publishes the filter (and the chosen subject entity) under its element id,
+ * and every `list` element naming that id in `filter_element_id` renders the
+ * filtered rows.
+ *
+ * `subject_entity` pins which entity the filter is authored against. When it is
+ * absent the element renders a subject picker over the entities its bound lists
+ * offer — one entry per bound list, since a list carries exactly one entity.
+ *
+ * The filter is in-memory: it resets on reload rather than persisting per user.
+ */
+type RecordFilterElement = CommonProps & {
+    type: 'record_filter';
+    subject_entity?: string;
+    /** `toolbar` (default) is the Filter button + active chips, matching every
+     *  list view. `panel` is the always-open AND/OR editor, for a page whose
+     *  point IS the filter. */
+    variant?: 'toolbar' | 'panel';
+    /** Nested AND/OR groups. Defaults to true — the records query carries the
+     *  whole tree, so there is no reason to hide the affordance. */
+    is_complex_enabled?: boolean;
+};
+/**
+ * Renders records of a configured List — the record-agnostic sibling of
+ * `related_list`, and the only way to show records on a page that has no
+ * record of its own.
+ *
+ * The List supplies everything about presentation and behaviour: columns,
+ * sorting, base filters, toolbar actions, selection mode, and which page a row
+ * opens. Naming more than one list makes the element switchable; the active one
+ * is chosen by the bound filter's subject picker, or by the element's own
+ * switcher when it is unbound.
+ *
+ * `filter_element_id` binds the element to a `record_filter` on the same page.
+ * The bound filter is ANDed with the list's own saved filters — it narrows the
+ * list, it never replaces what the list declared.
+ */
+type ListElement = CommonProps & {
+    type: 'list';
+    /** Slugs of the lists this element can render. At least one. */
+    list_slugs: string[];
+    /** Element id of the `record_filter` driving this list. Unbound renders the
+     *  list with its own filters only. */
+    filter_element_id?: string;
+    /**
+     * Record-page alternative to `filter_element_id`: the attribute on THIS
+     * page's record holding a saved filter (as written by the `record-filter`
+     * control). The list then renders what the record's own filter selects —
+     * a saved-segment record showing its matches.
+     *
+     * Mutually exclusive with `filter_element_id`: two filters driving one list
+     * has no defined precedence, so the layout validator rejects both at once.
+     * Record pages only — a standalone page has no record to read.
+     */
+    filter_attribute?: string;
+    /**
+     * Attribute on this page's record naming the subject entity slug. The
+     * element renders whichever of `list_slugs` targets that entity. Without
+     * it the first configured list wins. Pairs with `filter_attribute`.
+     */
+    subject_entity_attribute?: string;
+    page_size?: number;
+};
 type DividerElement = CommonProps & {
     type: 'divider';
 };
@@ -1557,7 +1623,7 @@ type TextElement = CommonProps & {
     variant: TextVariant;
     content: string;
 };
-type LayoutElement = RowElement | ColumnElement | SectionElement | CardElement | TabsElement | FieldElement | RelatedListElement | RelatedRecordElement | ComponentElement | DividerElement | TextElement;
+type LayoutElement = RowElement | ColumnElement | SectionElement | CardElement | TabsElement | FieldElement | RelatedListElement | RelatedRecordElement | ComponentElement | DividerElement | TextElement | RecordFilterElement | ListElement;
 declare const LayoutElementSchema: z.ZodType<LayoutElement>;
 
 /**
@@ -1779,7 +1845,36 @@ interface MetaListOptions extends ListOptions {
  * full set; format/structural variation lives on `Attribute.meta` (see
  * `AttributeMeta` below), not on the type discriminator.
  */
-type AttributeType = 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'datetime' | 'enum' | 'relation' | 'user' | 'currency' | 'knowledge-text' | 'file';
+type AttributeType = 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'datetime' | 'enum' | 'relation' | 'user' | 'principal' | 'currency' | 'knowledge-text' | 'file';
+/**
+ * Attribute-level permissions: restricting a FIELD rather than a record — a
+ * salary column readable only by the people team, a margin column writable only
+ * by finance. Mirror of the Go `metamodel.AttributeRestrictions`.
+ *
+ * Orthogonal to instance-level access: a caller who may see a record may still
+ * be blocked from one of its fields.
+ *
+ * Absent means unrestricted. Both arms FAIL CLOSED — an empty rule matches
+ * nobody rather than everybody, and an unknown role or team slug never matches,
+ * so a typo removes access rather than granting it.
+ */
+interface AttributeAccessRule {
+    /** Role slugs, matched against the caller's roles. */
+    roles?: string[];
+    /**
+     * Team slugs. Matched through the caller's team closure, so a member of a
+     * CHILD team is matched by a rule naming an ancestor.
+     */
+    teams?: string[];
+}
+/**
+ * Read and write are gated independently, so `write` alone yields a field
+ * everyone can see and only some can change.
+ */
+interface AttributeRestrictions {
+    read?: AttributeAccessRule;
+    write?: AttributeAccessRule;
+}
 /** JSON-Schema string formats carried by `string` attributes. */
 type StringFormat = 'email' | 'uri' | 'uuid' | 'hostname' | 'ipv4' | 'ipv6';
 interface StringAttributeMeta {
@@ -1815,6 +1910,10 @@ interface EnumValue {
     value: string;
     label?: string;
     description?: string;
+    /** Lucide icon name, canonical PascalCase (e.g. `CircleCheck`). Replaces the badge dot. */
+    icon?: string;
+    /** Tint as `#rrggbb`. Renderers derive dot/border/background from it; text stays ink. */
+    color?: string;
 }
 interface EnumAttributeMeta {
     values: EnumValue[];
@@ -1879,6 +1978,54 @@ declare const UserAttributeMetaSchema: z.ZodObject<{
 }, {
     description?: string | undefined;
 }>;
+/**
+ * The stored value of a `principal`-typed attribute: a {@link PrincipalRef}
+ * `{ type, id }` naming anything that can HOLD ACCESS — a user (person, agent
+ * or api client), a team, or the whole organization. Mirror of the Go
+ * `metamodel.PrincipalAttributeMeta`.
+ *
+ * Distinct from `user` on purpose. `user` means "a person did this" — it is
+ * authorship, and its value can never be a team. `principal` means "this party
+ * may be granted access", a different question with a strictly larger
+ * vocabulary. Widening `user` would have made every existing user attribute
+ * silently accept a team, including the created_by / updated_by audit columns.
+ */
+interface PrincipalAttributeMeta {
+    description?: string;
+    /**
+     * Turns the attribute into a GRANTING attribute: the verbs its value confers
+     * on the record. `deals.account_manager` with `["read","write"]` means setting
+     * it gives that principal access with no share call — the business field IS
+     * the ACL.
+     *
+     * `share` is the right to hand access on — share the record, set other
+     * granting attributes, revoke shares. `["read","write","delete","share"]` is
+     * full ownership: there is no separate owner field on the platform, the
+     * business field that grants `share` IS the owner. `share` must accompany
+     * at least one of read/write/delete, and an attribute granting it never
+     * accepts an `org` principal.
+     *
+     * Empty (the default) means an ordinary reference that confers nothing, so an
+     * existing principal attribute cannot start granting access by accident.
+     */
+    grants?: Array<'read' | 'write' | 'delete' | 'share'>;
+    /**
+     * Narrows which principal kinds this attribute accepts; empty means all
+     * (except that an attribute granting `share` refuses `org` regardless —
+     * an org-wide right to re-grant would hand record management to every
+     * member).
+     */
+    allowed_types?: PrincipalType[];
+}
+/** The kinds a principal reference may name. */
+type PrincipalType = 'person' | 'agent' | 'api' | 'team' | 'org';
+/**
+ * The stored value of a `principal`-typed attribute.
+ */
+interface PrincipalRef {
+    type: PrincipalType;
+    id: string;
+}
 /**
  * The stored value of a `currency`-typed attribute: an exact decimal `amount`
  * (a STRING, never a JS number — preserves financial-system precision and
@@ -1949,7 +2096,7 @@ declare const FileAttributeMetaSchema: z.ZodObject<{
  * appropriate shape based on `Attribute.type`; runtime consumers can
  * narrow via the `type` field.
  */
-type AttributeMeta = StringAttributeMeta | NumberAttributeMeta | DatetimeAttributeMeta | ArrayAttributeMeta | ObjectAttributeMeta | EnumAttributeMeta | RelationAttributeMeta | UserAttributeMeta | CurrencyAttributeMeta | KnowledgeTextAttributeMeta | FileAttributeMeta;
+type AttributeMeta = StringAttributeMeta | NumberAttributeMeta | DatetimeAttributeMeta | ArrayAttributeMeta | ObjectAttributeMeta | EnumAttributeMeta | RelationAttributeMeta | UserAttributeMeta | PrincipalAttributeMeta | CurrencyAttributeMeta | KnowledgeTextAttributeMeta | FileAttributeMeta;
 /**
  * Entity attribute definition. Mirrors `model.Attribute` in the Go SDK.
  */
@@ -1969,6 +2116,17 @@ interface Attribute {
      * Mirrors `IsPlatformManaged` in the Go `metamodel.Attribute`.
      */
     is_platform_managed?: boolean;
+    /**
+     * Attribute-level permissions. Absent means unrestricted (today's behaviour).
+     * Platform-managed attributes cannot carry restrictions.
+     */
+    restrictions?: AttributeRestrictions;
+    /**
+     * Literal default, or — on a `user` / `principal` attribute only — the
+     * current-user sentinel `{ type: 'current_user' }` (see
+     * `CURRENT_USER_DEFAULT`), which data-service resolves to the writer at
+     * record-write time.
+     */
     default_value?: unknown;
     /**
      * Type-specific metadata. The concrete shape is determined by `type`
@@ -2002,6 +2160,46 @@ declare const AttributeSchema: z.ZodObject<{
     is_nullable: z.ZodOptional<z.ZodBoolean>;
     is_unique: z.ZodBoolean;
     is_read_only: z.ZodOptional<z.ZodBoolean>;
+    restrictions: z.ZodOptional<z.ZodObject<{
+        read: z.ZodOptional<z.ZodObject<{
+            roles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            teams: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            roles?: string[] | undefined;
+            teams?: string[] | undefined;
+        }, {
+            roles?: string[] | undefined;
+            teams?: string[] | undefined;
+        }>>;
+        write: z.ZodOptional<z.ZodObject<{
+            roles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            teams: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            roles?: string[] | undefined;
+            teams?: string[] | undefined;
+        }, {
+            roles?: string[] | undefined;
+            teams?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        read?: {
+            roles?: string[] | undefined;
+            teams?: string[] | undefined;
+        } | undefined;
+        write?: {
+            roles?: string[] | undefined;
+            teams?: string[] | undefined;
+        } | undefined;
+    }, {
+        read?: {
+            roles?: string[] | undefined;
+            teams?: string[] | undefined;
+        } | undefined;
+        write?: {
+            roles?: string[] | undefined;
+            teams?: string[] | undefined;
+        } | undefined;
+    }>>;
     default_value: z.ZodOptional<z.ZodUnknown>;
     meta: z.ZodOptional<z.ZodUnknown>;
     options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -2016,6 +2214,16 @@ declare const AttributeSchema: z.ZodObject<{
     description?: string | undefined;
     is_read_only?: boolean | undefined;
     is_nullable?: boolean | undefined;
+    restrictions?: {
+        read?: {
+            roles?: string[] | undefined;
+            teams?: string[] | undefined;
+        } | undefined;
+        write?: {
+            roles?: string[] | undefined;
+            teams?: string[] | undefined;
+        } | undefined;
+    } | undefined;
     default_value?: unknown;
 }, {
     type: string;
@@ -2028,6 +2236,16 @@ declare const AttributeSchema: z.ZodObject<{
     description?: string | undefined;
     is_read_only?: boolean | undefined;
     is_nullable?: boolean | undefined;
+    restrictions?: {
+        read?: {
+            roles?: string[] | undefined;
+            teams?: string[] | undefined;
+        } | undefined;
+        write?: {
+            roles?: string[] | undefined;
+            teams?: string[] | undefined;
+        } | undefined;
+    } | undefined;
     default_value?: unknown;
 }>;
 /**
@@ -2043,6 +2261,12 @@ declare function parseRelationMeta(attr: Attribute): RelationAttributeMeta | nul
  * attribute with no meta still resolves to an empty `{}` rather than null.
  */
 declare function parseCurrencyMeta(attr: Attribute): CurrencyAttributeMeta | null;
+/**
+ * Returns the typed `PrincipalAttributeMeta` when `attr` is a principal
+ * attribute; null otherwise. Principal meta is optional, so an attribute with
+ * no meta resolves to an empty `{}` rather than null.
+ */
+declare function parsePrincipalMeta(attr: Attribute): PrincipalAttributeMeta | null;
 declare function parseUserMeta(attr: Attribute): UserAttributeMeta | null;
 /**
  * Returns the typed `FileAttributeMeta` when `attr` is a file attribute; null
@@ -2126,6 +2350,46 @@ declare const EntitySchema: z.ZodObject<{
         is_nullable: z.ZodOptional<z.ZodBoolean>;
         is_unique: z.ZodBoolean;
         is_read_only: z.ZodOptional<z.ZodBoolean>;
+        restrictions: z.ZodOptional<z.ZodObject<{
+            read: z.ZodOptional<z.ZodObject<{
+                roles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                teams: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            }, {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            }>>;
+            write: z.ZodOptional<z.ZodObject<{
+                roles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                teams: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            }, {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            read?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+            write?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+        }, {
+            read?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+            write?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+        }>>;
         default_value: z.ZodOptional<z.ZodUnknown>;
         meta: z.ZodOptional<z.ZodUnknown>;
         options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -2140,6 +2404,16 @@ declare const EntitySchema: z.ZodObject<{
         description?: string | undefined;
         is_read_only?: boolean | undefined;
         is_nullable?: boolean | undefined;
+        restrictions?: {
+            read?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+            write?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+        } | undefined;
         default_value?: unknown;
     }, {
         type: string;
@@ -2152,6 +2426,16 @@ declare const EntitySchema: z.ZodObject<{
         description?: string | undefined;
         is_read_only?: boolean | undefined;
         is_nullable?: boolean | undefined;
+        restrictions?: {
+            read?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+            write?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+        } | undefined;
         default_value?: unknown;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -2178,6 +2462,16 @@ declare const EntitySchema: z.ZodObject<{
         description?: string | undefined;
         is_read_only?: boolean | undefined;
         is_nullable?: boolean | undefined;
+        restrictions?: {
+            read?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+            write?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+        } | undefined;
         default_value?: unknown;
     }[];
     slug: string;
@@ -2209,6 +2503,16 @@ declare const EntitySchema: z.ZodObject<{
         description?: string | undefined;
         is_read_only?: boolean | undefined;
         is_nullable?: boolean | undefined;
+        restrictions?: {
+            read?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+            write?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+        } | undefined;
         default_value?: unknown;
     }[];
     slug: string;
@@ -2263,6 +2567,46 @@ declare const EntityWithSchemaSchema: z.ZodObject<{
         is_nullable: z.ZodOptional<z.ZodBoolean>;
         is_unique: z.ZodBoolean;
         is_read_only: z.ZodOptional<z.ZodBoolean>;
+        restrictions: z.ZodOptional<z.ZodObject<{
+            read: z.ZodOptional<z.ZodObject<{
+                roles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                teams: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            }, {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            }>>;
+            write: z.ZodOptional<z.ZodObject<{
+                roles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                teams: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            }, {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            read?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+            write?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+        }, {
+            read?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+            write?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+        }>>;
         default_value: z.ZodOptional<z.ZodUnknown>;
         meta: z.ZodOptional<z.ZodUnknown>;
         options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -2277,6 +2621,16 @@ declare const EntityWithSchemaSchema: z.ZodObject<{
         description?: string | undefined;
         is_read_only?: boolean | undefined;
         is_nullable?: boolean | undefined;
+        restrictions?: {
+            read?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+            write?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+        } | undefined;
         default_value?: unknown;
     }, {
         type: string;
@@ -2289,6 +2643,16 @@ declare const EntityWithSchemaSchema: z.ZodObject<{
         description?: string | undefined;
         is_read_only?: boolean | undefined;
         is_nullable?: boolean | undefined;
+        restrictions?: {
+            read?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+            write?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+        } | undefined;
         default_value?: unknown;
     }>, "many">;
 } & {
@@ -2317,6 +2681,16 @@ declare const EntityWithSchemaSchema: z.ZodObject<{
         description?: string | undefined;
         is_read_only?: boolean | undefined;
         is_nullable?: boolean | undefined;
+        restrictions?: {
+            read?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+            write?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+        } | undefined;
         default_value?: unknown;
     }[];
     slug: string;
@@ -2349,6 +2723,16 @@ declare const EntityWithSchemaSchema: z.ZodObject<{
         description?: string | undefined;
         is_read_only?: boolean | undefined;
         is_nullable?: boolean | undefined;
+        restrictions?: {
+            read?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+            write?: {
+                roles?: string[] | undefined;
+                teams?: string[] | undefined;
+            } | undefined;
+        } | undefined;
         default_value?: unknown;
     }[];
     slug: string;
@@ -2733,6 +3117,19 @@ interface UpdateComponentRequest {
 }
 /**
  * List column definition.
+ *
+ * `attribute` is an attribute name or a dot path, told apart by the type of
+ * the first segment:
+ *
+ *   - `name` — an attribute on the list's own entity.
+ *   - `address.city` — a leaf inside one of its `object` attributes.
+ *   - `company_id.name` — a field of the RELATED record, reached through a
+ *     relation attribute (the first segment is the FK).
+ *
+ * A bare `object` attribute is not a valid column — it carries no value of
+ * its own, only leaves. Sorting follows the same grammar minus the relation
+ * hop: an attribute or an object path can be ordered by, a related field
+ * cannot (it would need a join).
  */
 interface Column {
     attribute: string;
@@ -2744,13 +3141,77 @@ interface Column {
  */
 type SortDirection = 'asc' | 'desc';
 /**
- * Sort configuration.
+ * Sort configuration. `attribute` is an attribute name or an object path
+ * (`address.city`); relation paths are not sortable — ordering by a related
+ * field would need a join the records query doesn't do.
  */
 interface SortConfig {
     attribute: string;
     direction: SortDirection;
 }
 
+/**
+ * What a page toolbar button invokes. Absent normalizes to `action` (pages
+ * persisted before `kind` existed).
+ */
+type PageActionKind = 'action' | 'workflow';
+/**
+ * Page action definition — one toolbar button. `kind: action` invokes a
+ * function-service Action by slug (`action`) and may prefill its params;
+ * `kind: workflow` starts a manual run of a workflow by key (`workflow`) and
+ * may prefill its manual-trigger inputs. `params` / `inputs` map target field
+ * names to Liquid templates rendered against the page scope
+ * `{ record, entity, params, user }`; a resolved field is locked in the invoke
+ * dialog. `skip_confirmation` fires the target immediately when every required
+ * field resolved from the templates.
+ */
+interface PageAction {
+    label: string;
+    icon: string;
+    kind?: PageActionKind;
+    action?: string;
+    workflow?: string;
+    params?: Record<string, string>;
+    inputs?: Record<string, string>;
+    skip_confirmation?: boolean;
+}
+declare const PageActionSchema: z.ZodObject<{
+    label: z.ZodString;
+    icon: z.ZodString;
+    kind: z.ZodOptional<z.ZodEnum<["action", "workflow"]>>;
+    action: z.ZodOptional<z.ZodString>;
+    workflow: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    skip_confirmation: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    icon: string;
+    params?: Record<string, string> | undefined;
+    action?: string | undefined;
+    workflow?: string | undefined;
+    kind?: "action" | "workflow" | undefined;
+    inputs?: Record<string, string> | undefined;
+    skip_confirmation?: boolean | undefined;
+}, {
+    label: string;
+    icon: string;
+    params?: Record<string, string> | undefined;
+    action?: string | undefined;
+    workflow?: string | undefined;
+    kind?: "action" | "workflow" | undefined;
+    inputs?: Record<string, string> | undefined;
+    skip_confirmation?: boolean | undefined;
+}>;
+/**
+ * Whether a list's rows can be checked, and whether the checkboxes show from
+ * the start:
+ *
+ * - `on_demand` (default) — a Select toggle in the toolbar reveals them.
+ * - `always` — checkboxes are showing from the start.
+ * - `off` — rows can never be checked, even when the list carries actions.
+ */
+type SelectionMode = 'on_demand' | 'always' | 'off';
 /**
  * List configuration.
  * Note: List uses `slug` as its primary identifier, not `id`.
@@ -2762,6 +3223,15 @@ interface List extends AuditFields {
     name: string;
     entity_slug: string;
     columns: Column[];
+    /**
+     * Toolbar buttons on the list, same shape a page carries. They act on the
+     * rows SELECTED in the list, so an `action` button names an `entity_batch`
+     * action (invoked once with every selected record id) and prefill templates
+     * resolve against the list scope `{ selection, entity, user }`.
+     */
+    actions?: PageAction[];
+    /** Row-selection affordance; absent normalizes to `on_demand`. */
+    selection_mode?: SelectionMode;
     /** Record page to open from this list; empty/absent = org default for the entity. */
     default_page_slug?: string;
     sorting: SortConfig[];
@@ -2831,6 +3301,35 @@ declare const ListSchema: z.ZodObject<{
         label: string;
         attribute: string;
     }>, "many">;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        icon: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<["action", "workflow"]>>;
+        action: z.ZodOptional<z.ZodString>;
+        workflow: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        skip_confirmation: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        icon: string;
+        params?: Record<string, string> | undefined;
+        action?: string | undefined;
+        workflow?: string | undefined;
+        kind?: "action" | "workflow" | undefined;
+        inputs?: Record<string, string> | undefined;
+        skip_confirmation?: boolean | undefined;
+    }, {
+        label: string;
+        icon: string;
+        params?: Record<string, string> | undefined;
+        action?: string | undefined;
+        workflow?: string | undefined;
+        kind?: "action" | "workflow" | undefined;
+        inputs?: Record<string, string> | undefined;
+        skip_confirmation?: boolean | undefined;
+    }>, "many">>;
+    selection_mode: z.ZodOptional<z.ZodEnum<["on_demand", "always", "off"]>>;
     default_page_slug: z.ZodOptional<z.ZodString>;
     sorting: z.ZodArray<z.ZodObject<{
         attribute: z.ZodString;
@@ -2868,6 +3367,17 @@ declare const ListSchema: z.ZodObject<{
         direction: "asc" | "desc";
     }[];
     filters: FilterGroup[];
+    actions?: {
+        label: string;
+        icon: string;
+        params?: Record<string, string> | undefined;
+        action?: string | undefined;
+        workflow?: string | undefined;
+        kind?: "action" | "workflow" | undefined;
+        inputs?: Record<string, string> | undefined;
+        skip_confirmation?: boolean | undefined;
+    }[] | undefined;
+    selection_mode?: "on_demand" | "always" | "off" | undefined;
     default_page_slug?: string | undefined;
 }, {
     name: string;
@@ -2894,6 +3404,17 @@ declare const ListSchema: z.ZodObject<{
         direction: "asc" | "desc";
     }[];
     filters: FilterGroup[];
+    actions?: {
+        label: string;
+        icon: string;
+        params?: Record<string, string> | undefined;
+        action?: string | undefined;
+        workflow?: string | undefined;
+        kind?: "action" | "workflow" | undefined;
+        inputs?: Record<string, string> | undefined;
+        skip_confirmation?: boolean | undefined;
+    }[] | undefined;
+    selection_mode?: "on_demand" | "always" | "off" | undefined;
     default_page_slug?: string | undefined;
 }>;
 /**
@@ -2914,6 +3435,8 @@ interface CreateListRequest {
     entity_slug: string;
     name: string;
     columns: Column[];
+    actions?: PageAction[];
+    selection_mode?: SelectionMode;
     default_page_slug?: string;
     sorting: SortConfig[];
     filters: FilterGroup[];
@@ -2925,6 +3448,8 @@ interface UpdateListRequest {
     name?: string;
     module_slug?: string;
     columns?: Column[];
+    actions?: PageAction[];
+    selection_mode?: SelectionMode;
     /** Set to '' to clear back to the org default. */
     default_page_slug?: string;
     sorting?: SortConfig[];
@@ -3078,28 +3603,6 @@ interface UpdateListViewRequest {
     sorting?: SortConfig[];
     filters?: FilterGroup[];
 }
-/**
- * Page action definition. Page-level toolbar item; addressed by permissions
- * and shortcuts systems.
- */
-interface PageAction {
-    label: string;
-    icon: string;
-    action: string;
-}
-declare const PageActionSchema: z.ZodObject<{
-    label: z.ZodString;
-    icon: z.ZodString;
-    action: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    label: string;
-    icon: string;
-    action: string;
-}, {
-    label: string;
-    icon: string;
-    action: string;
-}>;
 /**
  * Page type — encodes what the page binds to and how it is served (chrome +
  * auth posture both follow from it):
@@ -3164,15 +3667,30 @@ declare const PageSchema: z.ZodObject<{
     actions: z.ZodArray<z.ZodObject<{
         label: z.ZodString;
         icon: z.ZodString;
-        action: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<["action", "workflow"]>>;
+        action: z.ZodOptional<z.ZodString>;
+        workflow: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        skip_confirmation: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         label: string;
         icon: string;
-        action: string;
+        params?: Record<string, string> | undefined;
+        action?: string | undefined;
+        workflow?: string | undefined;
+        kind?: "action" | "workflow" | undefined;
+        inputs?: Record<string, string> | undefined;
+        skip_confirmation?: boolean | undefined;
     }, {
         label: string;
         icon: string;
-        action: string;
+        params?: Record<string, string> | undefined;
+        action?: string | undefined;
+        workflow?: string | undefined;
+        kind?: "action" | "workflow" | undefined;
+        inputs?: Record<string, string> | undefined;
+        skip_confirmation?: boolean | undefined;
     }>, "many">;
     layout: z.ZodObject<{
         version: z.ZodLiteral<1>;
@@ -3253,7 +3771,12 @@ declare const PageSchema: z.ZodObject<{
     actions: {
         label: string;
         icon: string;
-        action: string;
+        params?: Record<string, string> | undefined;
+        action?: string | undefined;
+        workflow?: string | undefined;
+        kind?: "action" | "workflow" | undefined;
+        inputs?: Record<string, string> | undefined;
+        skip_confirmation?: boolean | undefined;
     }[];
     layout: {
         version: 1;
@@ -3289,7 +3812,12 @@ declare const PageSchema: z.ZodObject<{
     actions: {
         label: string;
         icon: string;
-        action: string;
+        params?: Record<string, string> | undefined;
+        action?: string | undefined;
+        workflow?: string | undefined;
+        kind?: "action" | "workflow" | undefined;
+        inputs?: Record<string, string> | undefined;
+        skip_confirmation?: boolean | undefined;
     }[];
     layout: {
         version: 1;
@@ -3708,5 +4236,23 @@ interface UpdateDesignReferenceRequest {
 interface DesignReferenceContent {
     content: string;
 }
+/**
+ * The one non-literal `default_value`: "whoever is writing the record".
+ * Meaningful only on `user` and `principal` attributes, where data-service
+ * resolves it to the caller's `{ type, id }` at write time — an owner field
+ * granting `share`, an `assignee`, a `requested_by` fill themselves without a
+ * hook. An object rather than a bare string because a bare string IS a valid
+ * user value (clients send bare ids). Mirrors `metamodel.CurrentUserDefault`.
+ */
+declare const CURRENT_USER_DEFAULT: {
+    readonly type: "current_user";
+};
+type CurrentUserDefault = {
+    type: 'current_user';
+};
+/** True when a `default_value` is the current-user sentinel (and nothing else). */
+declare function isCurrentUserDefault(value: unknown): value is CurrentUserDefault;
+/** Only the identity-valued attribute types can carry the sentinel. */
+declare function acceptsCurrentUserDefault(type: AttributeType): boolean;
 
-export { FileRefSchema as $, type AuditFields as A, type CurrencyAttributeMeta as B, type ClientOptions as C, CurrencyAttributeMetaSchema as D, type CurrencySymbolSide as E, type FileRef as F, type CurrencyValue as G, DEFAULT_OPTIONS as H, DEFAULT_PAGE_SIZE as I, DONE as J, type DeployModuleRequest as K, type ListOptions as L, type DesignReference as M, type DesignReferenceContent as N, DesignReferenceSchema as O, PageIterator as P, type DesignReferenceService as Q, type Done as R, type Entity as S, EntitySchema as T, type UserRef as U, type EntityService as V, type EntityWithSchema as W, EntityWithSchemaSchema as X, type EnumAttributeMeta as Y, type EnumValue as Z, type FileAttributeMeta as _, type Attribute as a, type UpdateListRequest as a$, type FilterElement as a0, FilterElementSchema as a1, type FilterGroup as a2, FilterGroupSchema as a3, type List as a4, type ListAppsOptions as a5, type ListComponentsOptions as a6, type ListDesignReferencesOptions as a7, type ListEntitiesOptions as a8, type ListFn as a9, PLATFORM_ATTRIBUTE_NAMES as aA, PLATFORM_USER_ID as aB, type Page as aC, type PageAction as aD, PageActionSchema as aE, type PageLayout as aF, PageLayoutSchema as aG, PageSchema as aH, type PageService as aI, type PageType as aJ, type PublicPageComponent as aK, type PublicPageResponse as aL, type RelationAttributeMeta as aM, RelationAttributeMetaSchema as aN, type RequestOptions as aO, type ResolvedClientOptions as aP, type ResponseMeta as aQ, ResponseMetaSchema as aR, type SortConfig as aS, SortConfigSchema as aT, type SortDirection as aU, type Timestamps as aV, type TokenProvider as aW, type UpdateAppRequest as aX, type UpdateComponentRequest as aY, type UpdateDesignReferenceRequest as aZ, type UpdateEntityRequest as a_, type ListListViewsOptions as aa, type ListListsOptions as ab, type ListMenuConfigurationsOptions as ac, type ListModulesOptions as ad, type ListPagesOptions as ae, ListSchema as af, type ListService as ag, type ListVariablesOptions as ah, type ListView as ai, ListViewSchema as aj, type ListViewService as ak, type LogicalOperator as al, type MenuConfiguration as am, MenuConfigurationSchema as an, type MenuConfigurationService as ao, type MenuItem as ap, MenuItemSchema as aq, MenuItemType as ar, MetaClient as as, type MetaListOptions as at, type Module as au, ModuleSchema as av, type ModuleService as aw, type ModuleStatus as ax, type OnDeleteAction as ay, OnDeleteActionSchema as az, type ListResult as b, type StringFormat as b$, type UpdateListViewRequest as b0, type UpdateMenuConfigurationRequest as b1, type UpdatePageRequest as b2, type UpdateVariableRequest as b3, UserRefSchema as b4, type UserType as b5, type Variable as b6, VariableSchema as b7, type VariableService as b8, allCurrencyCodes as b9, type DividerElement as bA, type FieldElement as bB, FileAttributeMetaSchema as bC, type LayoutAlign as bD, type LayoutElement as bE, LayoutElementSchema as bF, LayoutElementType as bG, type LayoutGap as bH, type LayoutJustify as bI, type LayoutTab as bJ, type NumberAttributeMeta as bK, type ObjectAttributeMeta as bL, PAGE_BACKGROUND_TOKENS as bM, type PageBackgroundToken as bN, type PageLayoutSidePanel as bO, PageLayoutSidePanelSchema as bP, type PageStyle as bQ, PageStyleSchema as bR, type RelatedListElement as bS, type RelatedRecordElement as bT, type ResponsiveSizing as bU, type RowElement as bV, type SectionElement as bW, type SizeValue as bX, SizeValueSchema as bY, type SizingProps as bZ, type StringAttributeMeta as b_, createIterator as ba, createListResultSchema as bb, currencyLabel as bc, currencySymbol as bd, currencySymbolSide as be, formatAmount as bf, formatMoney as bg, isPlatformAttributeName as bh, localeNumberSeparators as bi, parseAmount as bj, parseCurrencyMeta as bk, parseFileMeta as bl, parseRelationMeta as bm, platformAttributes as bn, resolveOptions as bo, type AttributeForLookup as bp, type AttributeMeta as bq, BUILT_IN_CONTROLS as br, type BuiltInControlSlug as bs, type CardElement as bt, type ColumnElement as bu, type CommonProps as bv, type ComponentElement as bw, type ControlBucket as bx, type DatetimeAttributeMeta as by, type DatetimeFormat as bz, ProteosClient as c, type TabsElement as c0, type TextElement as c1, type TextVariant as c2, type UserAttributeMeta as c3, UserAttributeMetaSchema as c4, isBuiltInControl as c5, lookupCompatibleControls as c6, lookupControls as c7, lookupPrimaryControl as c8, parseUserMeta as c9, type PublicAccessOperation as d, type App as e, AppSchema as f, type AppService as g, type ArrayAttributeMeta as h, AttributeSchema as i, type AttributeType as j, AuditFieldsSchema as k, type Column as l, ColumnSchema as m, type ComparisonOperator as n, type Component as o, ComponentSchema as p, type ComponentService as q, type CreateAppRequest as r, type CreateComponentRequest as s, type CreateDesignReferenceRequest as t, type CreateEntityRequest as u, type CreateListRequest as v, type CreateListViewRequest as w, type CreateMenuConfigurationRequest as x, type CreatePageRequest as y, type CreateVariableRequest as z };
+export { type EntityWithSchema as $, type AuditFields as A, type CreateListViewRequest as B, CURRENT_USER_DEFAULT as C, type CreateMenuConfigurationRequest as D, type CreatePageRequest as E, type FileRef as F, type CreateVariableRequest as G, type CurrencyAttributeMeta as H, CurrencyAttributeMetaSchema as I, type CurrencySymbolSide as J, type CurrencyValue as K, type ListOptions as L, type CurrentUserDefault as M, DEFAULT_OPTIONS as N, DEFAULT_PAGE_SIZE as O, PageIterator as P, DONE as Q, type DeployModuleRequest as R, type DesignReference as S, type DesignReferenceContent as T, type UserRef as U, DesignReferenceSchema as V, type DesignReferenceService as W, type Done as X, type Entity as Y, EntitySchema as Z, type EntityService as _, type Attribute as a, type Timestamps as a$, EntityWithSchemaSchema as a0, type EnumAttributeMeta as a1, type EnumValue as a2, type FileAttributeMeta as a3, FileRefSchema as a4, type FilterElement as a5, FilterElementSchema as a6, type FilterGroup as a7, FilterGroupSchema as a8, type List as a9, ModuleSchema as aA, type ModuleService as aB, type ModuleStatus as aC, type OnDeleteAction as aD, OnDeleteActionSchema as aE, PLATFORM_ATTRIBUTE_NAMES as aF, PLATFORM_USER_ID as aG, type Page as aH, type PageAction as aI, type PageActionKind as aJ, PageActionSchema as aK, type PageLayout as aL, PageLayoutSchema as aM, PageSchema as aN, type PageService as aO, type PageType as aP, type PublicPageComponent as aQ, type PublicPageResponse as aR, type RelationAttributeMeta as aS, RelationAttributeMetaSchema as aT, type RequestOptions as aU, type ResolvedClientOptions as aV, type ResponseMeta as aW, ResponseMetaSchema as aX, type SortConfig as aY, SortConfigSchema as aZ, type SortDirection as a_, type ListAppsOptions as aa, type ListComponentsOptions as ab, type ListDesignReferencesOptions as ac, type ListEntitiesOptions as ad, type ListFn as ae, type ListListViewsOptions as af, type ListListsOptions as ag, type ListMenuConfigurationsOptions as ah, type ListModulesOptions as ai, type ListPagesOptions as aj, ListSchema as ak, type ListService as al, type ListVariablesOptions as am, type ListView as an, ListViewSchema as ao, type ListViewService as ap, type LogicalOperator as aq, type MenuConfiguration as ar, MenuConfigurationSchema as as, type MenuConfigurationService as at, type MenuItem as au, MenuItemSchema as av, MenuItemType as aw, MetaClient as ax, type MetaListOptions as ay, type Module as az, type ListResult as b, type PrincipalAttributeMeta as b$, type TokenProvider as b0, type UpdateAppRequest as b1, type UpdateComponentRequest as b2, type UpdateDesignReferenceRequest as b3, type UpdateEntityRequest as b4, type UpdateListRequest as b5, type UpdateListViewRequest as b6, type UpdateMenuConfigurationRequest as b7, type UpdatePageRequest as b8, type UpdateVariableRequest as b9, type BuiltInControlSlug as bA, type CardElement as bB, type ColumnElement as bC, type CommonProps as bD, type ComponentElement as bE, type ControlBucket as bF, type DatetimeAttributeMeta as bG, type DatetimeFormat as bH, type DividerElement as bI, type FieldElement as bJ, FileAttributeMetaSchema as bK, type LayoutAlign as bL, type LayoutElement as bM, LayoutElementSchema as bN, LayoutElementType as bO, type LayoutGap as bP, type LayoutJustify as bQ, type LayoutTab as bR, type ListElement as bS, type NumberAttributeMeta as bT, type ObjectAttributeMeta as bU, PAGE_BACKGROUND_TOKENS as bV, type PageBackgroundToken as bW, type PageLayoutSidePanel as bX, PageLayoutSidePanelSchema as bY, type PageStyle as bZ, PageStyleSchema as b_, UserRefSchema as ba, type UserType as bb, type Variable as bc, VariableSchema as bd, type VariableService as be, acceptsCurrentUserDefault as bf, allCurrencyCodes as bg, createIterator as bh, createListResultSchema as bi, currencyLabel as bj, currencySymbol as bk, currencySymbolSide as bl, formatAmount as bm, formatMoney as bn, isCurrentUserDefault as bo, isPlatformAttributeName as bp, localeNumberSeparators as bq, parseAmount as br, parseCurrencyMeta as bs, parseFileMeta as bt, parseRelationMeta as bu, platformAttributes as bv, resolveOptions as bw, type AttributeForLookup as bx, type AttributeMeta as by, BUILT_IN_CONTROLS as bz, ProteosClient as c, type PrincipalType as c0, type RecordFilterElement as c1, type RelatedListElement as c2, type RelatedRecordElement as c3, type ResponsiveSizing as c4, type RowElement as c5, type SectionElement as c6, type SizeValue as c7, SizeValueSchema as c8, type SizingProps as c9, type StringAttributeMeta as ca, type StringFormat as cb, type TabsElement as cc, type TextElement as cd, type TextVariant as ce, type UserAttributeMeta as cf, UserAttributeMetaSchema as cg, isBuiltInControl as ch, lookupCompatibleControls as ci, lookupControls as cj, lookupPrimaryControl as ck, parsePrincipalMeta as cl, parseUserMeta as cm, type PrincipalRef as d, type PublicAccessOperation as e, type App as f, AppSchema as g, type AppService as h, type ArrayAttributeMeta as i, type AttributeAccessRule as j, type AttributeRestrictions as k, AttributeSchema as l, type AttributeType as m, AuditFieldsSchema as n, type ClientOptions as o, type Column as p, ColumnSchema as q, type ComparisonOperator as r, type Component as s, ComponentSchema as t, type ComponentService as u, type CreateAppRequest as v, type CreateComponentRequest as w, type CreateDesignReferenceRequest as x, type CreateEntityRequest as y, type CreateListRequest as z };