@nivaro/sdk 0.1.25 → 0.1.27

package/README.md

@@ -1889,6 +1889,81 @@ When SLA rules, scheduled flows, or other time-tracking systems are active:
 
 ---
 
+## SDK — Layout Editor
+
+The layout editor saves through a bundle + ops model: read the layout as `{ layout, groups, placements, rev }`, send a batch of small ops with the `rev` you read, and get the new bundle back. A batch applies all or nothing. Every call below except the picker and scheduled-change tools is admin only.
+
+```typescript
+import {
+  readLayoutBundle, submitLayoutOps,
+  readLayoutOverview, explainLayout,
+  createCollectionLayout, cloneLayout, readActiveLayout
+} from '@nivaro/sdk'
+
+const bundle = await nivaro.request(readLayoutBundle(42))
+
+try {
+  const next = await nivaro.request(
+    submitLayoutOps(42, {
+      base_rev: bundle.rev,
+      note: 'Move Status into the header',
+      ops: [
+        { op: 'move', from: { field: 'status', group_key: 'details' }, to_group_key: null, index: 0 },
+        { op: 'update_placement', at: { field: 'owner', group_key: null }, patch: { col_span: 6 } },
+        { op: 'layout_update', patch: { disable_clone: true } }
+      ]
+    })
+  )
+} catch (err) {
+  // 409 { error: 'stale', bundle }: the layout changed since base_rev. Re-apply on err.response.bundle.
+  // 400 { error, op_index }: the op at op_index was refused; nothing was saved.
+}
+```
+
+The op union (`LayoutOp`), `LayoutBundle`, `PlacementPatch`, `GroupPatch` and `LayoutPatch` are exported as types, with `PLACEMENT_PATCH_KEYS`, `GROUP_PATCH_KEYS` and `LAYOUT_PATCH_KEYS` as runtime lists. A batch holds at most 500 ops.
+
+#### Commands
+
+| Command | Route | Notes |
+| --- | --- | --- |
+| readLayoutBundle(id) | GET /collection-layouts/:id/bundle | Returns the bundle itself (no `data` wrapper). |
+| submitLayoutOps(id, { ops, base_rev, note? }) | POST /collection-layouts/:id/ops | Returns the new bundle; 409 stale carries the current bundle, 400 carries `op_index`. |
+| readLayoutOverview(collection) | GET /collection-layouts/overview | Every layout, sectioned the way the active-layout resolution checks them, with references and warnings. |
+| explainLayout({ collection, item?, role_id?, slug? }) | GET /collection-layouts/explain | Which layout a record opens with, why, and each candidate's check. |
+| createCollectionLayout(collection, name, { slug?, layout_type?, seed_fields? }) | POST /collection-layouts | `seed_fields` starts the layout with one Main section holding every visible field. |
+| cloneLayout(id, name, { slug?, layout_type? }) | POST /collection-layouts/:id/clone | The copy starts hidden from the New menu (`create_hidden`); an admin opts it in. |
+| readActiveLayout(collection, { slug?, item? }) | GET /collection-layouts/active | Placements carry `col_span`; the result includes `ungrouped_sort`. |
+| updateCollectionLayout(id, patch) | PATCH /collection-layouts/:id | Any `LayoutPatch` setting. |
+| readLayoutVersion / diffLayoutVersion / restoreLayoutVersion | /collection-layouts/:id/versions/... | A restore snapshots the current state first, so it is reversible. |
+| projectFieldConfig(collection, placements) | POST /field-config/:collection/project | The field-config rows a draft would produce. A read; writes nothing. |
+| listInternalWidgetPlacements(widgetId) | GET /widgets-internal/:id/placements | The layouts that place a widget. |
+
+#### Layout-gated record tools
+
+Disabling a record in pickers and scheduling a change accept `layout`, the `?layout=` slug of the form the record was opened with. A non-admin may use them only when that form grants it (`allow_disable_pickers`, `allow_schedule`) and they may update the record. Scheduled changes for non-admins are limited to real, writable columns they may update; a read-only, computed or alias field is refused with 400.
+
+```typescript
+import { excludeFromPickers, includeInPickers, createScheduledChange } from '@nivaro/sdk'
+
+await nivaro.request(excludeFromPickers({ collection: 'vendors', item_id: 17, layout: 'intake' }))
+await nivaro.request(includeInPickers({ collection: 'vendors', item_id: 17, layout: 'intake' }))
+
+await nivaro.request(
+  createScheduledChange({
+    collection: 'vendors',
+    item_id: '17',
+    change_type: 'field_update',
+    changes: { status: 'inactive' },
+    scheduled_at: '2026-12-01T09:00:00Z',
+    layout: 'intake'
+  })
+)
+```
+
+> **Note:** Retired layout settings are no longer writable: `summary_show_all`, `allow_clone` (use `disable_clone`), `addendum_lock_fields` and `hide_actions_when_collapsed`. They stay optional and deprecated on the `CollectionLayout` read type.
+
+---
+
 ## SDK — Schema Snapshots
 
 Capture point-in-time snapshots of your entire metadata registry (collections, fields, relations). Useful for version control, environment promotion, and disaster recovery.

package/dist/index.d.ts

@@ -3149,6 +3149,12 @@ declare function createScheduledChange(body: {
     changes: Record<string, unknown>;
     /** ISO date string. */
     scheduled_at: string;
+    /**
+     * The ?layout= slug of the form the record was opened with. A non-admin may
+     * schedule only when that form grants it (allow_schedule) and only fields
+     * they may update that are real, writable columns.
+     */
+    layout?: string | null;
 }): Command<{
     data: ScheduledChange;
 }>;
@@ -3198,8 +3204,12 @@ interface FieldConfig {
     repeater_schema: unknown | null;
     is_translatable: boolean;
 }
-declare function readFieldConfig(collection: string): Command<{
+/** Field config overlaid with a layout's placements (`layout_id`, else the active layout). */
+declare function readFieldConfig(collection: string, opts?: {
+    layout_id?: number;
+}): Command<{
     data: FieldConfig[];
+    ungrouped_sort?: number | null;
 }>;
 /** Update one field's behavioral config (admin). */
 declare function updateFieldConfig(collection: string, field: string, body: Partial<Omit<FieldConfig, 'field'>>): Command<{
@@ -3667,6 +3677,376 @@ declare function readDistinctValues(collection: string, field: string, options?:
     data: unknown[];
 }>;
 
+/**
+ * Layout editor commands: the bundle + atomic ops save model, the overview and
+ * "which form opens" explain reads, the editor's read-only canvas projection,
+ * and the layout-gated record tools (picker toggle, scheduled changes).
+ *
+ * The block between the BEGIN/END markers mirrors
+ * packages/shared/src/lib/layout-ops.ts (types and patch-key lists) so the SDK
+ * needs no runtime dependency on @nivaro/shared. It must stay byte-identical:
+ * packages/shared/src/lib/layout-ops-sdk.test.ts fails when the two drift.
+ */
+
+type PlacementKey = {
+    field: string;
+    group_key: string | null;
+};
+interface PlacementPatch {
+    label_override?: string | null;
+    is_visible?: boolean;
+    default_expanded?: boolean;
+    col_span?: number | null;
+    overrides?: unknown;
+    show_row_revisions?: boolean;
+    allow_revision_restore?: boolean | null;
+    lock_conditions?: string | null;
+    input_bindings?: unknown;
+    widget_id?: number | null;
+    show_approval_chain?: boolean;
+}
+interface PlacementRow {
+    id?: number;
+    field: string;
+    group_key: string | null;
+    sort: number;
+    label_override: string | null;
+    is_visible: boolean;
+    default_expanded: boolean;
+    col_span: number | null;
+    overrides: unknown;
+    show_row_revisions: boolean;
+    allow_revision_restore: boolean | null;
+    lock_conditions: string | null;
+    input_bindings: unknown;
+    widget_id: number | null;
+    show_approval_chain: boolean;
+}
+/** Group JSON settings (summary_fields, swap_config, …) travel as their stored JSON text. */
+interface GroupPatch {
+    label?: string;
+    type?: string;
+    icon?: string | null;
+    is_collapsed?: boolean;
+    tab_mode?: string | null;
+    hide_when_empty?: boolean;
+    visibility_mode?: string | null;
+    summary_fields?: string | null;
+    summary_hide_empty?: boolean;
+    swap_config?: string | null;
+    skip_if_filled?: string | null;
+    content?: string | null;
+    content_tone?: string | null;
+    visible_when?: string | null;
+    hidden_for_roles?: string | null;
+    locked_for_roles?: string | null;
+    read_width?: string | null;
+    /** #2608: an editor-only note, JSON {text, by, by_name, at}. Never sent to record pages. */
+    editor_note?: string | null;
+    /** Label translations per locale, JSON `{ "es": { "label": "…" } }` (#2665). */
+    i18n?: string | null;
+}
+interface GroupRow {
+    id?: number;
+    key: string;
+    parent_key: string | null;
+    sort: number;
+    label: string;
+    type: string;
+    icon: string | null;
+    is_collapsed: boolean;
+    tab_mode: string | null;
+    hide_when_empty: boolean;
+    visibility_mode: string | null;
+    summary_fields: string | null;
+    summary_hide_empty: boolean;
+    swap_config: string | null;
+    skip_if_filled: string | null;
+    content: string | null;
+    content_tone: string | null;
+    visible_when: string | null;
+    hidden_for_roles: string | null;
+    locked_for_roles: string | null;
+    read_width: string | null;
+    /** #2608 — absent on databases without the column (migration 460). */
+    editor_note?: string | null;
+    /** Label translations per locale (#2665); absent before migration 465. */
+    i18n?: string | null;
+}
+/** The layout settings PATCH /collection-layouts/:id accepts. */
+type LayoutPatch = Partial<{
+    name: string;
+    slug: string | null;
+    create_label: string | null;
+    create_hidden: boolean;
+    sort: number;
+    is_active: boolean;
+    disable_comments: boolean;
+    disable_tasks: boolean;
+    tab_mode: string;
+    validate_before_next: boolean;
+    summary_enabled: boolean;
+    summary_hide_empty: boolean;
+    ai_enabled: boolean;
+    accordion_mode: boolean;
+    disable_revisions: boolean;
+    disable_clone: boolean;
+    disable_delete: boolean;
+    row_order_field: string | null;
+    pdf_theme: string | null;
+    pdf_template_id: number | null;
+    pdf_cover_enabled: boolean;
+    pdf_cover_title_field: string | null;
+    pdf_cover_subtitle: string | null;
+    pdf_show_logo: boolean;
+    pdf_page_size: string;
+    pdf_orientation: string;
+    pdf_button_label: string | null;
+    conditions: {
+        role_ids?: string[];
+    } | null;
+    allow_schedule: boolean;
+    allow_disable_pickers: boolean;
+    layout_type: string;
+    addendum_layout_id: number | null;
+    workflow_template_id: string | null;
+    single_active_addendum: boolean;
+    addendum_default_view: boolean;
+    record_conditions: Array<{
+        field: string;
+        op: string;
+        value?: unknown;
+    }> | null;
+    default_values: Record<string, unknown> | null;
+    display_mode: string | null;
+    parent_layout_id: number | null;
+    hide_integrity_banner: boolean;
+    hide_sla_banner: boolean;
+    changes_tray: boolean;
+    dossier_enabled: boolean;
+    dossier_label: string | null;
+    quick_picker: string[] | null;
+    sheet_width: number | null;
+    header_fields: string[] | null;
+    hide_empty: boolean;
+    /** Required change note (#2654): null = off, 'note' = a reason, 'note_ticket' = reason + ticket. */
+    change_note: 'note' | 'note_ticket' | null;
+}>;
+type LayoutRow = Record<string, unknown> & {
+    id: number;
+    collection: string;
+};
+type LayoutOp = {
+    op: 'place';
+    field: string;
+    group_key: string | null;
+    index: number;
+    patch?: PlacementPatch;
+} | {
+    op: 'move';
+    from: PlacementKey;
+    to_group_key: string | null;
+    index: number;
+} | {
+    op: 'update_placement';
+    at: PlacementKey;
+    patch: PlacementPatch;
+} | {
+    op: 'remove';
+    at: PlacementKey;
+} | {
+    op: 'group_create';
+    key: string;
+    label: string;
+    group_type: string;
+    parent_key: string | null;
+    index: number;
+    patch?: GroupPatch;
+} | {
+    op: 'group_update';
+    key: string;
+    patch: GroupPatch;
+} | {
+    op: 'group_move';
+    key: string;
+    parent_key: string | null;
+    index: number;
+} | {
+    op: 'group_remove';
+    key: string;
+    placements: 'ungroup' | 'delete';
+} | {
+    op: 'layout_update';
+    patch: LayoutPatch;
+};
+interface LayoutBundle {
+    layout: LayoutRow;
+    groups: GroupRow[];
+    placements: PlacementRow[];
+    rev: string;
+}
+declare const PLACEMENT_PATCH_KEYS: readonly ["label_override", "is_visible", "default_expanded", "col_span", "overrides", "show_row_revisions", "allow_revision_restore", "lock_conditions", "input_bindings", "widget_id", "show_approval_chain"];
+/** #2608: the longest stored editor note (the JSON around its text included). */
+declare const EDITOR_NOTE_MAX = 4000;
+declare const GROUP_PATCH_KEYS: readonly ["label", "type", "icon", "is_collapsed", "tab_mode", "hide_when_empty", "visibility_mode", "summary_fields", "summary_hide_empty", "swap_config", "skip_if_filled", "content", "content_tone", "visible_when", "hidden_for_roles", "locked_for_roles", "read_width", "editor_note", "i18n"];
+declare const LAYOUT_PATCH_KEYS: readonly ["name", "slug", "create_label", "create_hidden", "sort", "is_active", "disable_comments", "disable_tasks", "tab_mode", "validate_before_next", "summary_enabled", "summary_hide_empty", "ai_enabled", "accordion_mode", "disable_revisions", "disable_clone", "disable_delete", "row_order_field", "pdf_theme", "pdf_template_id", "pdf_cover_enabled", "pdf_cover_title_field", "pdf_cover_subtitle", "pdf_show_logo", "pdf_page_size", "pdf_orientation", "pdf_button_label", "conditions", "allow_schedule", "allow_disable_pickers", "layout_type", "addendum_layout_id", "workflow_template_id", "single_active_addendum", "addendum_default_view", "record_conditions", "default_values", "display_mode", "parent_layout_id", "hide_integrity_banner", "hide_sla_banner", "changes_tray", "dossier_enabled", "dossier_label", "quick_picker", "sheet_width", "header_fields", "hide_empty", "change_note"];
+/** Why a layout won resolution. */
+interface LayoutPickReason {
+    kind: 'record_rule' | 'role' | 'default' | 'fallback' | 'slug' | 'type_use';
+    rules?: Array<{
+        field: string;
+        op: string;
+        value?: unknown;
+    }>;
+    role_ids?: string[];
+    role_names?: string[];
+    type_use?: string;
+}
+interface LayoutOverviewRow {
+    layout_id: number;
+    name: string;
+    layout_type: string;
+    slug: string | null;
+    section: 'forms' | 'link_only' | 'other_views' | 'unused';
+    reason: LayoutPickReason;
+    is_default: boolean;
+    new_menu: {
+        label: string;
+        hidden: boolean;
+    } | null;
+    shape: {
+        groups: number;
+        steps_or_tabs: number;
+        fields: number;
+        container_mode: 'tabs' | 'steps' | null;
+    };
+    references: Array<{
+        kind: string;
+        id: string | number;
+        label: string;
+    }>;
+    warnings: string[];
+}
+/**
+ * "Which form does each kind of record get?" Every layout of a collection,
+ * sectioned and ordered as the active-layout resolution checks them. Admin only.
+ */
+declare function readLayoutOverview(collection: string): Command<{
+    data: {
+        rows: LayoutOverviewRow[];
+        warning: string | null;
+    };
+}>;
+/**
+ * Which layout a saved record opens with, and why: the resolution itself, with
+ * each candidate's check. `role_id` tests as that role (none = as an admin);
+ * `slug` pins a layout by its link name. Admin only.
+ */
+declare function explainLayout(query: {
+    collection: string;
+    item?: string | number;
+    role_id?: string;
+    slug?: string;
+}): Command<{
+    data: {
+        layout_id: number | null;
+        reason: LayoutPickReason | null;
+        checked: Array<{
+            layout_id: number;
+            matched: boolean;
+            why: string;
+        }>;
+    };
+}>;
+/**
+ * The layout, its groups and placements as the editor edits them, with the
+ * `rev` the next ops batch must name. Not wrapped in `data`. Admin only.
+ */
+declare function readLayoutBundle(layoutId: number): Command<LayoutBundle>;
+/**
+ * Apply a batch of ops (at most 500) all or nothing and get the new bundle.
+ * Rejections arrive as thrown errors carrying `status` and `response`:
+ * 409 `{ error: 'stale', bundle }` when the layout changed since `base_rev`
+ * (re-apply on `response.bundle`), 400 `{ error, op_index }` when an op is
+ * refused, 400 `{ error, code: 'CHANGE_NOTE_REQUIRED' }` when the layout's
+ * `change_note` asks for a `reason` (and `ticket`) the batch lacks. Admin only.
+ */
+declare function submitLayoutOps(layoutId: number, body: {
+    ops: LayoutOp[];
+    base_rev: string;
+    note?: string | null;
+    reason?: string | null;
+    ticket?: string | null;
+}): Command<LayoutBundle>;
+/** One saved version of a layout (the snapshot itself). Admin only. */
+declare function readLayoutVersion(layoutId: number, versionId: number): Command<{
+    data: Record<string, unknown>;
+}>;
+/**
+ * What changed between a version and now (`against` omitted or 'current') or
+ * another version id. `versionId` 'newest' answers "what did the last save change".
+ */
+declare function diffLayoutVersion(layoutId: number, versionId: number | 'newest', against?: number | 'current'): Command<{
+    data: Record<string, unknown>;
+}>;
+/** Layouts whose last save shows a data-losing shape. Admin only. */
+declare function readLayoutDrift(): Command<{
+    data: unknown[];
+}>;
+/** A placement as the projection route takes it: `field` plus any placement columns. */
+type ProjectedPlacement = {
+    field: string;
+} & Partial<Omit<PlacementRow, 'field' | 'id'>>;
+/**
+ * The field-config rows the saved layout would answer if these placements
+ * were it (at most 2000): the editor's canvas renders its unsaved draft
+ * through this. A read; writes nothing. Admin only.
+ */
+declare function projectFieldConfig(collection: string, assignments: ProjectedPlacement[]): Command<{
+    data: Array<Record<string, unknown>>;
+    ungrouped_sort: number | null;
+}>;
+/** The layouts that place an internal widget: a config change reaches every one. Admin only. */
+declare function listInternalWidgetPlacements(widgetId: number): Command<{
+    data: Array<{
+        layout_id: number;
+        name: string;
+        collection: string;
+    }>;
+}>;
+/** Is a record excluded from relation pickers? */
+declare function readPickerExclusion(collection: string, itemId: string | number): Command<{
+    data: {
+        excluded: boolean;
+    };
+}>;
+/** Which of these ids are excluded from pickers? */
+declare function readPickerExclusions(collection: string, ids: Array<string | number>): Command<{
+    data: {
+        excluded: string[];
+    };
+}>;
+/** Exclude a record from relation pickers. */
+declare function excludeFromPickers(body: {
+    collection: string;
+    item_id: string | number;
+    layout?: string | null;
+}): Command<{
+    data: {
+        excluded: true;
+    };
+}>;
+/** Put a record back into relation pickers. */
+declare function includeInPickers(body: {
+    collection: string;
+    item_id: string | number;
+    layout?: string | null;
+}): Command<{
+    data: {
+        excluded: false;
+    };
+}>;
+
 /**
  * Developer-experience commands: dev-tools exports, webhook deliveries,
  * persisted GraphQL queries, saved views, global search, API keys,
@@ -4000,20 +4380,34 @@ declare function retryDeadLetter(runId: string): Command<{
         retried: string;
     };
 }>;
+type CollectionLayoutType = 'grouped' | 'summary' | 'detail' | 'file' | 'addendum' | 'table';
 interface CollectionLayout {
     id: number;
     collection: string;
     name: string;
+    slug?: string | null;
+    layout_type?: CollectionLayoutType | (string & {});
     is_active: boolean | number;
     sort: number;
     created_at: string;
+    /** Show in the New-item menu; clones start hidden until an admin opts in. */
+    create_hidden?: boolean | number;
+    create_label?: string | null;
     tab_mode?: 'tabs' | 'steps';
     validate_before_next?: boolean | number;
     summary_enabled?: boolean | number;
+    /** @deprecated Retired: no longer writable; the API may still return it. */
     summary_show_all?: boolean | number;
     ai_enabled?: boolean | number;
     disable_comments?: boolean | number;
     disable_tasks?: boolean | number;
+    disable_clone?: boolean | number;
+    /** @deprecated Retired: replaced by `disable_clone`; no longer writable. */
+    allow_clone?: boolean | number;
+    /** @deprecated Retired: no longer writable. */
+    addendum_lock_fields?: unknown;
+    /** @deprecated Retired: no longer writable. */
+    hide_actions_when_collapsed?: boolean | number;
     conditions?: {
         role_ids?: string[];
     } | null;
@@ -4025,6 +4419,15 @@ interface LayoutAssignment {
     label_override?: string | null;
     is_visible?: boolean | number;
     default_expanded?: boolean | number;
+    /** Column span on the record page (slot cards size by it). */
+    col_span?: number | null;
+    lock_conditions?: string | null;
+    overrides?: unknown;
+    show_row_revisions?: boolean | number;
+    show_approval_chain?: boolean | number;
+    allow_revision_restore?: boolean | number | null;
+    widget_id?: number | null;
+    input_bindings?: unknown;
 }
 interface LayoutGroup {
     id: number;
@@ -4047,11 +4450,17 @@ declare function readCollectionLayouts(collection: string): Command<{
     data: CollectionLayout[];
 }>;
 /** Read the active layout for a collection with groups + assignments. */
-declare function readActiveLayout(collection: string): Command<{
+declare function readActiveLayout(collection: string, 
+/** `slug` pins a layout by link name; `item` resolves record-conditional layouts. */
+opts?: {
+    slug?: string;
+    item?: string | number;
+}): Command<{
     data: {
         layout: CollectionLayout;
         groups: LayoutGroup[];
         assignments: LayoutAssignment[];
+        ungrouped_sort: number | null;
     };
 }>;
 /** Read groups for a specific layout by collection + layout id. */
@@ -4066,28 +4475,41 @@ declare function readLayoutAssignments(layoutId: number): Command<{
 declare function activateLayout(layoutId: number): Command<{
     data: CollectionLayout;
 }>;
-/** Clone a layout under a new name. */
-declare function cloneLayout(layoutId: number, name: string): Command<{
+/**
+ * Clone a layout under a new name. The copy lands hidden from the New menu
+ * (`create_hidden`) until an admin opts in; `layout_type` may differ from the source.
+ */
+declare function cloneLayout(layoutId: number, name: string, opts?: {
+    slug?: string | null;
+    layout_type?: CollectionLayoutType;
+}): Command<{
     data: CollectionLayout;
 }>;
-/** Create a new layout for a collection. */
-declare function createCollectionLayout(collection: string, name: string): Command<{
+/**
+ * Create a new layout for a collection. `seed_fields` starts it with one
+ * "Main" section holding every visible field.
+ */
+declare function createCollectionLayout(collection: string, name: string, opts?: {
+    slug?: string | null;
+    layout_type?: CollectionLayoutType;
+    seed_fields?: boolean;
+}): Command<{
     data: CollectionLayout;
 }>;
-/** Update layout behaviour/metadata. */
-declare function updateCollectionLayout(layoutId: number, patch: Partial<Pick<CollectionLayout, 'name' | 'sort' | 'tab_mode' | 'validate_before_next' | 'summary_enabled' | 'summary_show_all' | 'ai_enabled' | 'disable_comments' | 'disable_tasks' | 'conditions'>>): Command<{
+/** Update layout behaviour/metadata (any of the settings in `LayoutPatch`). */
+declare function updateCollectionLayout(layoutId: number, patch: LayoutPatch): Command<{
     data: CollectionLayout;
 }>;
 declare function deleteCollectionLayout(layoutId: number): Command<void>;
-/** Bulk-replace a layout's field→group assignments (and slot sentinels). */
+/**
+ * Bulk-replace a layout's field→group assignments (and slot sentinels).
+ * The layout editor saves through `submitLayoutOps` instead.
+ */
 declare function updateLayoutAssignments(layoutId: number, assignments: Array<{
     field: string;
     group_key: string | null;
     sort: number;
-    label_override?: string | null;
-    is_visible?: boolean;
-    default_expanded?: boolean;
-}>): Command<{
+} & PlacementPatch>): Command<{
     data: LayoutAssignment[];
 }>;
 interface InternalWidget {
@@ -5453,6 +5875,146 @@ declare function listRetentionRuns(policyId: number): Command<{
     data: RetentionRun[];
 }>;
 
+/**
+ * Layout AI helpers (#2694 #2695 #2676 #2693) under /ai-design/layouts. Admin
+ * only. The reads describe forms in plain terms; a proposal stores layout ops
+ * for an administrator to review in the layout editor and never changes a
+ * layout by itself.
+ */
+
+/** A form as an admin reads it: who gets it, settings that are on, sections and fields. */
+interface LayoutDescription {
+    id: number;
+    name: string;
+    collection: string;
+    kind: string;
+    slug: string | null;
+    default: boolean;
+    who: string;
+    record_rule: string | null;
+    parent_layout_id: number | null;
+    settings_on: string[];
+    groups: Array<{
+        key: string;
+        label: string;
+        type: string;
+        parent: string | null;
+        collapsed?: true;
+        shows_when?: string;
+        hidden_for?: string[];
+        read_only_for?: string[];
+        fields: Array<{
+            field: string;
+            label: string;
+            width?: string;
+            required?: true;
+            readonly?: true;
+            hidden?: true;
+            inherited?: true;
+        }>;
+    }>;
+    field_count: number;
+    not_on_layout: Array<{
+        field: string;
+        label: string;
+    }>;
+    draft: boolean;
+    truncated?: true;
+}
+interface WhichLayoutForm {
+    as: string;
+    record: string | null;
+    layout: {
+        id: number;
+        name: string;
+    } | null;
+    why: string;
+    checked: Array<{
+        layout: string;
+        matched: boolean;
+        why: string;
+    }>;
+}
+interface LayoutFieldExplanation {
+    field: string;
+    label: string;
+    as: string;
+    record: string | null;
+    layout: {
+        id: number;
+        name: string;
+    } | null;
+    verdict: 'shown' | 'shown read-only' | 'hidden' | 'not on the form' | 'cannot open the record';
+    reasons: string[];
+    draft: boolean;
+}
+interface LayoutProposal {
+    id: string;
+    layout_id: number;
+    note: string | null;
+    status: 'proposed' | 'applied' | 'rejected' | 'expired';
+    created_at: string;
+    proposer: {
+        name: string;
+        via: string;
+    };
+    ops: LayoutOp[];
+    sentences: string[];
+    dropped: string[];
+    /** Why it would not apply to the layout as it is now, or null. */
+    conflict: string | null;
+}
+/** A layout described for a reader (or an assistant). Admin only. */
+declare function describeLayoutForm(layoutId: number): Command<{
+    data: LayoutDescription;
+}>;
+/** Which form a record opens with for a role, and why. Admin only. */
+declare function whichLayoutForm(query: {
+    collection: string;
+    item?: string | number;
+    role?: string;
+}): Command<{
+    data: WhichLayoutForm;
+}>;
+/** Why a field shows, hides or is read-only for a role on a record. Admin only. */
+declare function explainLayoutField(query: {
+    collection: string;
+    field: string;
+    role?: string;
+    item?: string | number;
+    layout_id?: number;
+}): Command<{
+    data: LayoutFieldExplanation;
+}>;
+/**
+ * Propose layout ops for an administrator to review in the layout editor.
+ * Nothing changes until they apply it. Unknown fields and settings are left
+ * out (`dropped`); ops that would not apply are refused with 400.
+ */
+declare function proposeLayoutOps(layoutId: number, body: {
+    ops: LayoutOp[] | unknown[];
+    note?: string;
+}): Command<{
+    data: {
+        id: string;
+        status: 'proposed';
+        changes: string[];
+        dropped: string[];
+        note: string;
+    };
+}>;
+/** Open proposals for a layout (`status: 'all'` adds applied, rejected and expired). */
+declare function readLayoutProposals(layoutId: number, status?: 'all'): Command<{
+    data: LayoutProposal[];
+}>;
+/** Mark a proposal applied (after the editor applied it to its draft) or rejected. */
+declare function resolveLayoutProposal(layoutId: number, proposalId: string, outcome: 'applied' | 'rejected'): Command<{
+    data: {
+        id: string;
+        status: string;
+    };
+}>;
+
 /**
  * Operations reads (admin): readiness, detailed health, this process's runtime
  * stats, the instance roster, the DB connection pool, expensive SQL, the
@@ -6962,12 +7524,15 @@ interface PickerExclusionStatus {
 }
 /**
  * Check whether a specific item is excluded from relation pickers.
+ * @deprecated Use `readPickerExclusion` (commands/layout-editor).
  */
 declare function getPickerExclusionStatus(collection: string, itemId: string): Command<{
     data: PickerExclusionStatus;
 }>;
 /**
  * Exclude an item from appearing in relation pickers across the admin UI.
+ * @deprecated Use `excludeFromPickers`, which can pass the record's `layout` so a
+ * non-admin whose form grants it may call it.
  */
 declare function excludeFromPicker(collection: string, itemId: string): Command<{
     data: {
@@ -6976,6 +7541,7 @@ declare function excludeFromPicker(collection: string, itemId: string): Command<
 }>;
 /**
  * Remove a picker exclusion — the item will appear in relation pickers again.
+ * @deprecated Use `includeInPickers`, which can pass the record's `layout`.
  */
 declare function includeInPicker(collection: string, itemId: string): Command<{
     data: {
@@ -6985,6 +7551,7 @@ declare function includeInPicker(collection: string, itemId: string): Command<{
 /**
  * Check exclusion status for multiple items in one call.
  * Returns the list of ids that ARE excluded.
+ * @deprecated Use `readPickerExclusions` (commands/layout-editor).
  */
 declare function batchPickerExclusionStatus(collection: string, ids: string[]): Command<{
     data: {
@@ -7940,4 +8507,4 @@ declare function submitFormItem(collection: string, values: Record<string, unkno
     data: Record<string, unknown>;
 }>;
 
-export { type AccessAudit, type AccessAuditFinding, type AccessAuditRun, type AccessAuditSubject, type AccessReason, type ActivityEntry, type ActivityQuery, type ActivityReportQuery, type ActivityReportRow, type ActivityReportSummary, type Addendum, type AddendumStatus, type AggregateQuery, type AggregateRow, type AiChatTraceEntry, type AiCollectionSettings, type AiColumnMapping, type AiDuplicateMatch, type AiQueryFilter, type AiQueryResult, type AiReviewFinding, type AiViolation, type AlertDefinition, type AlertLogEntry, type AlertSubscription, type AnomalyDefinition, type AnomalyRule, type ApiAnalyticsBucket, type ApiAnalyticsCollection, type ApiAnalyticsPath, type ApiAnalyticsSummary, type ApiErrorLog, type ApiKey, type ApiKeyScope, type ApprovalBrief, type ApprovalChain, type ApprovalChainStep, type ApprovalDecision, type ApprovalInstance, type ApprovalInstanceDetail, type ApprovalStatus, type ApprovalStepInput, type AtRiskCondition, type AtRiskOp, type AtRiskResult, type AtRiskRule, type AtRiskSummaryEntry, type AttributeDefinition, type AttributeValue, type BatchRead, type BatchReadResult, type BlackoutDate, type BoolFilterOps, type CMSCollection, type CascadeFilterRule, type ChangeOrder, type ChatChannel, type ChatChannelMember, type ChatDirectoryChannel, type ChatMessage, type ChatPin, type ChatReaction, type ChatRoomKind, type ChatRoomSummary, type ChatRoomType, type ChatSearchHit, type CollectionLayout, type CollectionPresetSummary, type Command, type Comment, type CommentVersion, type ConfigSnapshot, type ConfigTableClassification, type ContentBundle, type ContentExportFormat, type ContentExportOptions, type CoverageGapItem, type CoverageGapOwner, type CoverageGapReport, type CpuProfileSummary, type CronJob, type CustomQuery, type CustomQueryCatalogEntry, type DataQualityRule, type DataQualityRuleResult, type DataQualityRuleType, type DataQualityRun, type DataQualitySeverity, type DeadLetter, type DmvResult, type DraftPublishConfig, type DraftStatus, type DryRunReport, type ErpSubmission, type ErpSubmissionStatus, type ExpensiveStatement, type ExtensionManifest, type ExternalApi, type ExternalApiEndpoint, type ExternalApiSchema, type ExternalApiSlotContext, type ExternalApiSpecImportResult, type ExternalApiTestResult, type FieldChangeEntry, type FieldCondition, type FieldConfig, type FieldDependencyConfig, type FieldFilter, type FieldGroup, type FieldTranslations, type FieldVisibilityRules, type FieldWatch, type FileRecord, type FileUploadResult, type FileUsageEntry, type Filter, type FlowReplayResult, type FlowRun, type FlowTestStep, type FormFieldDescriptor, type FormFieldRelation, type FormGroupDescriptor, type FormLockCondition, type FormSchema, type FormValidationRule, type FormVisibilityRule, type GlobalSearchRecord, type GlobalSearchResults, type GraphQLResponse, type HealthDetailed, type HelpVideo, type HelpVideoClick, type HelpVideoContext, type HelpVideoDownloadUrls, type HelpVideoFinalizedUpload, type HelpVideoProgress, type HelpVideoUploadSession, type HelpVideoVersion, type HelpVideoVisibility, type HelpVideoWalkStep, type HelpVideoWhatsNew, type HierarchyConfigDef, type HierarchyFlatNode, type HierarchyLevelDef, type HierarchyNestedNode, type IDFilterOps, type ISODate, type ImportDefinition, type ImportJob, type ImportParseResponse, type ImportPreview, type ImportPreviewDiff, type ImportTemplateSummary, type InstanceOwner, type IntegrationApiHealth, type InternalWidget, type Issue, type IssueSeverity, type IssueStatus, type IssueSummary, type ItemLock, type JobRegistryCron, type JobRun, type LastTouch, type LayoutAssignment, type LayoutGroup, type LayoutVersion, type ListResponse, type ManagedUser, type MetricAlertRule, type MetricAlertSubscription, type MetricDefinition, type MyTask, type MyWorkOwnedEntry, type MyWorkSla, type MyWorkSummary, type NivaroClient, type NivaroClientOptions, type NivaroExtensionPlugin, type NivaroRealtime, type NivaroRuntime, type NotificationItem, type NotificationPage, type NotificationSubscription, type NumberFilterOps, type OmniSearchHit, type OnlinePresenceConfig, type OnlinePresenceUser, type Page, type PageLayout, type PageSlotKey, type PageWidget, type PdfTemplate, type PermissionSimulation, type PersistedQuery, type PickerExclusionStatus, type PipelineFlowEdge, type PipelineFlowState, type PipelineImpactResult, type PipelineOwnerGroup, type PipelineOwnerGroupUser, type PipelineSimulation, type PipelineState, type PipelineVersionEntry, type PluginSlots, type Policy, type PoolStats, type PreflightCheck, type PreflightReport, type PreflightSeverity, type PresenceClient, type PresenceOptions, type PresenceSession, type PresenceSessionInfo, type PresenceViewer, type PromotionApplyResult, type PromotionPreview, type Query, type Queue, type QueueColumnPrefs, type QueueCondition, type QueueDetail, type QueueDisplayConfig, type QueueItem, type QueueItemsResult, type QueueOwner, type QueueRowClickMode, type QueueScope, type QueueSource, type QueueSourceType, type QueueStats, type QueueTrendPoint, type QueueView, type QueueViewKind, type QueueWorkloadRow, READ_MANY_MAX, type ReadyReport, type RealtimeEvent, type RecordGraphEdge, type RecordGraphNode, type RecordLink, type RecordLinkType, type RecordTemplate, type RecordViewRecap, type RegisteredAction, type RelatedCommentEntry, type RelationFilter, type RelationOption, type ReportAlert, type ReportAlertCondition, type ReportAlertLogEntry, type ReportAnnotation, type ReportColumnFormat, type ReportDateRange, type ReportDef, type ReportEntityFilter, type ReportFilterPreset, type ReportQueryColumn, type ReportQueryWidgetConfig, type ReportSnapshotEntry, type ReportSubscription, type ReportTemplateEntry, type ReportVersionEntry, type ReportWidget, type ReportWidgetConfig, type ReportWidgetData, type ReportWidgetPreset, type ReportWidgetType, type RequestTrace, type ResolvedOwner, type RetentionPolicy, type RetentionRun, type RetentionRunResult, type Revision, type Role, type Rule, type RuntimeStats, type SavedView, type ScheduledChange, type ScheduledReport, type ScopeDimension, type ScopeDimensionInfo, type SemanticSearchMatch, type SessionRecording, type SessionReplayMasking, type ShareLink, type SlaBatchStatus, type SlaRule, type SlaStatus, type StagedImportRun, type StagedImportStats, type StringFilterOps, type SubRow, type SubRowTemplate, type SyncJob, type Task, type TaskDoneWhenRule, type TaskPriority, type TaskStatus, type TimelineEvent, type TraceSpan, type TrafficSnapshot, type TrafficSnapshotEntity, type TreeFlatNode, type TreeNestedNode, type TreeNodeConfig, type TreePermission, type TreePermissionAction, type UUID, type UserActivityEntry, type UserActivitySummary, type UserScopesInfo, type ViewSubscription, type VirtualCollection, type Webhook, type WebhookDelivery, type WidgetFeed, type WorkflowBinding, type WorkflowHistoryEntry, type WorkflowInstance, type WorkflowInstanceData, type WorkflowState, type WorkflowTransition, type Workspace, type WorkspaceQuotas, type WorkspaceTemplate, type WorkspaceUsage, _and, _contains, _ends_with, _eq, _gt, _gte, _in, _lt, _lte, _ncontains, _neq, _nin, _nnull, _none, _null, _or, _some, _starts_with, abandonHelpVideoUpload, acquireItemLock, activateLayout, addChatChannelMember, addInstanceOwner, addSubRow, aggregateItems, aiBrief, aiBuildReport, aiChat, aiCheckDuplicates, aiGenerate, aiMapColumns, aiQuery, aiReportFilters, aiReview, aiSummarize, aiValidate, appendSessionRecordingEvents, applyContentBundle, applyHelpVideoPackageImport, applyRecordTemplate, applySubRowTemplate, approveAddendum, approveAiProposal, archiveHelpVideo, asc, backupExportPath, batchPickerExclusionStatus, bulkPickerExclusion, callExternalApi, callExternalApiEndpoint, cancelScheduledChange, cancelStagedImport, captureCpuProfile, cascadeFieldDependencies, checkBlackoutDate, claimQueueItem, claimTask, clearTraces, cloneItem, cloneLayout, cloneReport, compareConfigSnapshot, completeTask, copyReportWidget, createAccessAudit, createAddendum, createAlertDefinition, createAlertSubscription, createAnomalyRule, createApiKey, createApprovalChain, createAtRiskRule, createAttributeDefinition, createBlackoutDate, createChatChannel, createChatRoomType, createCollectionLayout, createComment, createDataQualityRule, createExternalApi, createExternalApiEndpoint, createFieldGroup, createFieldWatch, createGroupDm, createHelpVideo, createHierarchyConfig, createImportDefinition, createImportJob, createImportJobFromUrl, createInternalWidget, createIssue, createItem, createMetricAlertRule, createNivaro, createNotification, createNotificationSubscription, createPage, createPdfTemplate, createPersistedQuery, createPresence, createQueue, createQueueView, createRealtime, createRecordLink, createRecordTemplate, createReport, createReportAlert, createReportAnnotation, createReportFromTemplate, createReportSnapshot, createReportWidgetPreset, createRetentionPolicy, createRole, createRolePolicy, createRule, createSavedView, createScheduledChange, createScheduledReport, createShareLink, createSlaRule, createSubRowTemplate, createSyncJob, createTask, createTreePermission, createUser, createViewSubscription, createVirtualCollection, createWebhook, createWidgetFeed, createWorkspace, createWorkspaceTemplate, decideApproval, deleteAccessAudit, deleteAddendum, deleteAlertDefinition, deleteAlertSubscription, deleteAnomalyRule, deleteApiKey, deleteApprovalChain, deleteAtRiskRule, deleteAttributeDefinition, deleteBlackoutDate, deleteChatMessage, deleteCollectionLayout, deleteComment, deleteDataQualityRule, deleteExternalApi, deleteExternalApiEndpoint, deleteExternalApiSchema, deleteFieldGroup, deleteFieldTranslations, deleteFieldWatch, deleteFile, deleteHierarchyConfig, deleteImportJob, deleteInternalWidget, deleteIssue, deleteItem, deleteMetricAlertRule, deleteNotification, deleteNotificationSubscription, deletePage, deletePdfTemplate, deletePersistedQuery, deleteQueue, deleteQueueView, deleteRecordLink, deleteRecordTemplate, deleteReport, deleteReportAlert, deleteReportAnnotation, deleteReportFilterPreset, deleteReportSnapshot, deleteReportTemplate, deleteReportWidgetPreset, deleteRetentionPolicy, deleteRole, deleteRolePolicy, deleteRule, deleteSavedView, deleteScheduledReport, deleteSessionRecording, deleteSlaRule, deleteSubRow, deleteSubRowTemplate, deleteSyncJob, deleteTask, deleteTreePermission, deleteUser, deleteViewSubscription, deleteVirtualCollection, deleteWebhook, deleteWidgetFeed, deleteWorkspace, deleteWorkspaceTemplate, deployImportProcedure, desc, disableTwoFactor, discardHelpVideoPackageImport, drillReportRow, editChatMessage, endSessionRecording, evaluateAlerts, evaluateAtRisk, evaluateFieldDefaults, evaluateFieldLock, evaluateFieldRules, evaluateFieldVisibility, excludeFromPicker, executeBulkAction, executeCustomQuery, executeImportTemplate, executeItemAction, executeScheduledChange, explainRecordAccess, explainReportTrend, exportBlueprint, exportConfigSnapshot, exportContent, exportContentBundle, exportHelpVideoPackage, exportSchemaSnapshot, fetchFormSchema, fileDownloadPath, fileTransformPath, finalizeHelpVideoUpload, generateToken, generateUserToken, getAlertDefinition, getAttributeValues, getBrunoCollection, getCommentHistory, getExternalApi, getExternalApiEndpoint, getFieldTranslations, getFlowRun, getLocales, getOpenApi, getPickerExclusionStatus, getPostmanCollection, getPresence, getRetentionPolicy, getSlaRule, getSlaStatus, getTranslations, getTypes, getWebhook, globalSearch, heartbeatItemLock, helpVideosFor, importExternalApiSpec, importSchemaSnapshot, includeInPicker, installBlueprint, installCollectionPreset, invokeInternalWidgetAction, isPageSlot, joinChatRoom, leaveChatRoom, listAccessAuditRuns, listAccessAudits, listActiveAtRiskRules, listActivePresence, listAddendums, listAlertDefinitions, listAlertSubscriptions, listAllNotificationSubscriptions, listAnomalyDefinitions, listAnomalyRules, listApiKeys, listApprovalChains, listApprovalInstances, listAtRiskRules, listAttributeDefinitions, listBlackoutDates, listBulkActions, listChangeOrders, listChatChannelMembers, listChatMessages, listChatPins, listChatRoles, listChatRoomTypes, listChatRooms, listCollectionPresets, listCollectionRecordTemplates, listComments, listCronJobs, listCustomQueries, listCustomQueryCatalog, listDataQualityRules, listDataQualityRuns, listDeadLetters, listExternalApiEndpoints, listExternalApiSchemas, listExternalApis, listFieldGroups, listFieldWatches, listFiles, listFlowRuns, listHelpVideoPages, listHelpVideoVersions, listHelpVideos, listHierarchyConfigs, listImportDefinitionVersions, listImportDefinitions, listImportJobs, listImportTemplates, listInternalWidgets, listIssues, listItemActions, listItemScheduledChanges, listJobRuns, listLayoutVersions, listMetricAlertRules, listMetricAlertSubscriptions, listMetricDefinitions, listMyHelpVideoUploads, listMyTasks, listNotificationSubscriptions, listNotifications, listOrphanFiles, listPages, listPdfTemplates, listPersistedQueries, listPinnedItems, listPipelineVersions, listQueueViews, listQueues, listRecordLinks, listRecordTemplates, listRegisteredExtensions, listRegisteredFlowOperations, listRegisteredFlowTriggers, listRelatedComments, listReportAlerts, listReportAnnotations, listReportFilterPresets, listReportSnapshots, listReportTemplates, listReportVersions, listReportWidgetPresets, listReports, listRequestedTasks, listRetentionPolicies, listRetentionRuns, listRolePolicies, listRoleUsers, listRoles, listRules, listSavedViews, listScheduledChanges, listScheduledReports, listScopeDimensions, listSessionRecordings, listShareLinks, listSlaRules, listStagedImports, listSubRowTemplates, listSubRows, listSyncJobs, listTasks, listTeamTasks, listThroughputCollections, listTraces, listTreePermissions, listViewSubscriptions, listVirtualCollections, listWebhookDeliveries, listWebhooks, listWidgetFeeds, listWorkspaceTemplates, listWorkspaces, markAllNotificationsRead, markChatRoomRead, markNotificationRead, markNotificationsRead, moveTreeNode, nudgeTask, omniSearch, openHelpVideoPackageImport, openHelpVideoUpload, presignFileUpload, previewContentBundle, previewHelpVideoPackageImport, previewImportJob, previewReportWidget, publishHelpVideo, publishItem, queryVirtualCollection, readAccessAuditFindings, readActiveLayout, readActivity, readActivityReportSummary, readAddendum, readAiSettings, readAlertLog, readAllStateOwners, readAnomalyLog, readApiAnalyticsErrors, readApiAnalyticsSummary, readApiAnalyticsTimeseries, readApiAnalyticsTopCollections, readApiAnalyticsTopPaths, readApiKey, readApprovalBrief, readApprovalChain, readAtRiskSummary, readBackupManifest, readChatConfig, readChatDirectory, readChatPeerRead, readCollection, readCollectionLayout, readCollectionLayouts, readCollections, readConfigInventory, readCoverageGaps, readDataQualityRun, readDbPool, readDetailLayout, readDistinctValues, readDraftPublishConfig, readErpSubmissionHistory, readExpensiveSql, readFieldChangeHistory, readFieldConfig, readFieldImpact, readFieldWatch, readFileMeta, readFileUsage, readFilesByIds, readHealthDetailed, readHelpVideo, readHelpVideoAnalytics, readHelpVideoDownloadLink, readHelpVideoDraft, readHelpVideoWalk, readHierarchyConfig, readHierarchyNodeAncestors, readHierarchyNodeChildren, readHierarchyNodes, readHierarchyTree, readImportJob, readImportProcedure, readInstanceOwners, readInstanceRoster, readIntegrationHealth, readInternalWidget, readIssue, readIssueSummary, readItem, readItemLock, readItemLockConfig, readItems, readJobRegistry, readLastTouch, readLayoutAssignments, readLayoutGroups, readMany, readMe, readMetricAlertLog, readMyScopes, readMyWork, readNotificationCount, readNotificationSubscriptionStats, readOnlinePresence, readOwnerGroups, readPage, readPageWidgetData, readPdfTemplate, readPersistedQuery, readPipelineFlowMap, readPipelineReplay, readPipelineTemplate, readPipelineTemplates, readPipelineVersion, readPreflight, readQueue, readQueueCollectionStates, readQueueColumnPrefs, readQueueItems, readQueueTrends, readQueueWorkload, readReadiness, readRecordGraph, readRelationOptions, readReport, readReportAlertLog, readReportAlertsLog, readReportFilterOptions, readReportFiring, readReportSnapshot, readReportSubscription, readReportUsage, readReportWidgetData, readRequiredHelpVideos, readRevision, readRevisions, readRole, readRuntimeStats, readScopeDimensionCoverage, readSessionRecordingEvents, readSettings, readSingleton, readSlaStatusBatch, readStagedImport, readStagedImportStats, readStateOwnerGroups, readStateOwners, readStateOwnersBatch, readSyncJob, readTask, readTaskCounts, readTaskHistory, readThroughputReport, readTimeline, readTrace, readTrafficSnapshot, readTreeAncestors, readTreeChildren, readTreeConfig, readTreeDescendants, readTreeNested, readTreeNodes, readTwoFactorStatus, readUnreadNotificationCount, readUser, readUserActivity, readUserActivitySummary, readUserCard, readUserScopes, readUsers, readWorkflowBindings, readWorkflowInstance, readWorkflowInstances, readWorkspace, readWorkspaceUsage, rebuildTreePaths, recordHelpVideoProgress, registerHelpVideoPage, rehearseCreateItem, reindexSemanticSearch, rejectAddendum, rejectAiProposal, releaseItemLock, releaseQueueItem, rematerializeQueue, removeChatChannelMember, removeInstanceOwner, renderInternalWidget, renderPdfTemplate, reorderFieldGroups, reorderSubRows, reorderTreeSiblings, replaceSubRows, replayActivityEvent, replayFlow, reportClientError, requestRecordAccess, requeueStagedImport, rerecordHelpVideo, rerenderHelpVideo, resetReportCache, resolveReportAlert, restoreHelpVideoVersion, restoreImportDefinitionVersion, restoreLayoutVersion, restorePipelineVersion, restoreReportVersion, retryDeadLetter, retryErpSubmission, retryWebhookDelivery, revokeApiKey, revokeShareLink, revokeToken, revokeUserToken, rollbackRevision, rotateWidgetFeedToken, runAccessAudit, runActivityReport, runActivityReportCsv, runCronJob, runDataQuality, runRetentionPolicy, runScheduledReport, runSyncJob, saveHelpVideoDraft, saveMyScopeDefaults, saveReportFilterPreset, saveReportTemplate, saveReportWidgets, saveUserScope, searchChatMessages, semanticSearch, sendBulkNotification, sendChatMessage, sendTestMail, sessionRecordingEnabled, setHelpVideoContexts, setHelpVideoRequirements, setMyDelegate, setQueueDefaultView, setReportSubscription, setTranslations, setupTwoFactor, simulatePermissions, simulatePipeline, simulatePipelineImpact, startApproval, startMasquerade, startSessionRecording, startWorkflow, stopMasquerade, submitAddendum, submitFormItem, submitItemForReview, submitToErp, subscribeFieldWatch, subscribeMetricAlert, suggestImportValidation, suggestQueueLabels, switchWorkspace, testExternalApi, testFlow, testWebhook, toggleChatPin, toggleChatReaction, togglePinnedItem, toggleReportAlert, touchRecordView, transitionWorkflow, unpublishItem, unsubscribeFieldWatch, unsubscribeMetricAlert, updateAccessAudit, updateAddendum, updateAiSettings, updateAlertDefinition, updateAnomalyLogEntry, updateAnomalyRule, updateApiKey, updateApprovalChain, updateAtRiskRule, updateAttributeDefinition, updateAttributeValues, updateChatChannel, updateChatRoom, updateChatRoomType, updateCollectionLayout, updateComment, updateDataQualityRule, updateDraftPublishConfig, updateErpSubmissionStatus, updateExternalApi, updateExternalApiEndpoint, updateFieldConfig, updateFieldGroup, updateFieldWatch, updateFileMeta, updateHelpVideo, updateHierarchyConfig, updateImportDefinition, updateInternalWidget, updateIssue, updateItem, updateItemLockConfig, updateLayoutAssignments, updateLayoutUngroupedSort, updateMe, updateMetricAlertRule, updateMetricAlertSubscription, updateNotificationSubscription, updatePage, updatePdfTemplate, updatePersistedQuery, updateQueue, updateQueueSources, updateQueueView, updateRecordTemplate, updateReport, updateReportAlert, updateReportWidgetPreset, updateRetentionPolicy, updateRole, updateRolePolicy, updateRoleUiPermissions, updateRule, updateSavedView, updateScheduledReport, updateSettings, updateSingleton, updateSlaRule, updateSyncJob, updateTask, updateTreePermission, updateUser, updateVirtualCollection, updateWebhook, updateWidgetFeed, updateWorkflowBinding, updateWorkspace, validateVirtualCollectionSql, verifyTwoFactor };
+export { type AccessAudit, type AccessAuditFinding, type AccessAuditRun, type AccessAuditSubject, type AccessReason, type ActivityEntry, type ActivityQuery, type ActivityReportQuery, type ActivityReportRow, type ActivityReportSummary, type Addendum, type AddendumStatus, type AggregateQuery, type AggregateRow, type AiChatTraceEntry, type AiCollectionSettings, type AiColumnMapping, type AiDuplicateMatch, type AiQueryFilter, type AiQueryResult, type AiReviewFinding, type AiViolation, type AlertDefinition, type AlertLogEntry, type AlertSubscription, type AnomalyDefinition, type AnomalyRule, type ApiAnalyticsBucket, type ApiAnalyticsCollection, type ApiAnalyticsPath, type ApiAnalyticsSummary, type ApiErrorLog, type ApiKey, type ApiKeyScope, type ApprovalBrief, type ApprovalChain, type ApprovalChainStep, type ApprovalDecision, type ApprovalInstance, type ApprovalInstanceDetail, type ApprovalStatus, type ApprovalStepInput, type AtRiskCondition, type AtRiskOp, type AtRiskResult, type AtRiskRule, type AtRiskSummaryEntry, type AttributeDefinition, type AttributeValue, type BatchRead, type BatchReadResult, type BlackoutDate, type BoolFilterOps, type CMSCollection, type CascadeFilterRule, type ChangeOrder, type ChatChannel, type ChatChannelMember, type ChatDirectoryChannel, type ChatMessage, type ChatPin, type ChatReaction, type ChatRoomKind, type ChatRoomSummary, type ChatRoomType, type ChatSearchHit, type CollectionLayout, type CollectionLayoutType, type CollectionPresetSummary, type Command, type Comment, type CommentVersion, type ConfigSnapshot, type ConfigTableClassification, type ContentBundle, type ContentExportFormat, type ContentExportOptions, type CoverageGapItem, type CoverageGapOwner, type CoverageGapReport, type CpuProfileSummary, type CronJob, type CustomQuery, type CustomQueryCatalogEntry, type DataQualityRule, type DataQualityRuleResult, type DataQualityRuleType, type DataQualityRun, type DataQualitySeverity, type DeadLetter, type DmvResult, type DraftPublishConfig, type DraftStatus, type DryRunReport, EDITOR_NOTE_MAX, type ErpSubmission, type ErpSubmissionStatus, type ExpensiveStatement, type ExtensionManifest, type ExternalApi, type ExternalApiEndpoint, type ExternalApiSchema, type ExternalApiSlotContext, type ExternalApiSpecImportResult, type ExternalApiTestResult, type FieldChangeEntry, type FieldCondition, type FieldConfig, type FieldDependencyConfig, type FieldFilter, type FieldGroup, type FieldTranslations, type FieldVisibilityRules, type FieldWatch, type FileRecord, type FileUploadResult, type FileUsageEntry, type Filter, type FlowReplayResult, type FlowRun, type FlowTestStep, type FormFieldDescriptor, type FormFieldRelation, type FormGroupDescriptor, type FormLockCondition, type FormSchema, type FormValidationRule, type FormVisibilityRule, GROUP_PATCH_KEYS, type GlobalSearchRecord, type GlobalSearchResults, type GraphQLResponse, type GroupPatch, type GroupRow, type HealthDetailed, type HelpVideo, type HelpVideoClick, type HelpVideoContext, type HelpVideoDownloadUrls, type HelpVideoFinalizedUpload, type HelpVideoProgress, type HelpVideoUploadSession, type HelpVideoVersion, type HelpVideoVisibility, type HelpVideoWalkStep, type HelpVideoWhatsNew, type HierarchyConfigDef, type HierarchyFlatNode, type HierarchyLevelDef, type HierarchyNestedNode, type IDFilterOps, type ISODate, type ImportDefinition, type ImportJob, type ImportParseResponse, type ImportPreview, type ImportPreviewDiff, type ImportTemplateSummary, type InstanceOwner, type IntegrationApiHealth, type InternalWidget, type Issue, type IssueSeverity, type IssueStatus, type IssueSummary, type ItemLock, type JobRegistryCron, type JobRun, LAYOUT_PATCH_KEYS, type LastTouch, type LayoutAssignment, type LayoutBundle, type LayoutDescription, type LayoutFieldExplanation, type LayoutGroup, type LayoutOp, type LayoutOverviewRow, type LayoutPatch, type LayoutPickReason, type LayoutProposal, type LayoutRow, type LayoutVersion, type ListResponse, type ManagedUser, type MetricAlertRule, type MetricAlertSubscription, type MetricDefinition, type MyTask, type MyWorkOwnedEntry, type MyWorkSla, type MyWorkSummary, type NivaroClient, type NivaroClientOptions, type NivaroExtensionPlugin, type NivaroRealtime, type NivaroRuntime, type NotificationItem, type NotificationPage, type NotificationSubscription, type NumberFilterOps, type OmniSearchHit, type OnlinePresenceConfig, type OnlinePresenceUser, PLACEMENT_PATCH_KEYS, type Page, type PageLayout, type PageSlotKey, type PageWidget, type PdfTemplate, type PermissionSimulation, type PersistedQuery, type PickerExclusionStatus, type PipelineFlowEdge, type PipelineFlowState, type PipelineImpactResult, type PipelineOwnerGroup, type PipelineOwnerGroupUser, type PipelineSimulation, type PipelineState, type PipelineVersionEntry, type PlacementKey, type PlacementPatch, type PlacementRow, type PluginSlots, type Policy, type PoolStats, type PreflightCheck, type PreflightReport, type PreflightSeverity, type PresenceClient, type PresenceOptions, type PresenceSession, type PresenceSessionInfo, type PresenceViewer, type ProjectedPlacement, type PromotionApplyResult, type PromotionPreview, type Query, type Queue, type QueueColumnPrefs, type QueueCondition, type QueueDetail, type QueueDisplayConfig, type QueueItem, type QueueItemsResult, type QueueOwner, type QueueRowClickMode, type QueueScope, type QueueSource, type QueueSourceType, type QueueStats, type QueueTrendPoint, type QueueView, type QueueViewKind, type QueueWorkloadRow, READ_MANY_MAX, type ReadyReport, type RealtimeEvent, type RecordGraphEdge, type RecordGraphNode, type RecordLink, type RecordLinkType, type RecordTemplate, type RecordViewRecap, type RegisteredAction, type RelatedCommentEntry, type RelationFilter, type RelationOption, type ReportAlert, type ReportAlertCondition, type ReportAlertLogEntry, type ReportAnnotation, type ReportColumnFormat, type ReportDateRange, type ReportDef, type ReportEntityFilter, type ReportFilterPreset, type ReportQueryColumn, type ReportQueryWidgetConfig, type ReportSnapshotEntry, type ReportSubscription, type ReportTemplateEntry, type ReportVersionEntry, type ReportWidget, type ReportWidgetConfig, type ReportWidgetData, type ReportWidgetPreset, type ReportWidgetType, type RequestTrace, type ResolvedOwner, type RetentionPolicy, type RetentionRun, type RetentionRunResult, type Revision, type Role, type Rule, type RuntimeStats, type SavedView, type ScheduledChange, type ScheduledReport, type ScopeDimension, type ScopeDimensionInfo, type SemanticSearchMatch, type SessionRecording, type SessionReplayMasking, type ShareLink, type SlaBatchStatus, type SlaRule, type SlaStatus, type StagedImportRun, type StagedImportStats, type StringFilterOps, type SubRow, type SubRowTemplate, type SyncJob, type Task, type TaskDoneWhenRule, type TaskPriority, type TaskStatus, type TimelineEvent, type TraceSpan, type TrafficSnapshot, type TrafficSnapshotEntity, type TreeFlatNode, type TreeNestedNode, type TreeNodeConfig, type TreePermission, type TreePermissionAction, type UUID, type UserActivityEntry, type UserActivitySummary, type UserScopesInfo, type ViewSubscription, type VirtualCollection, type Webhook, type WebhookDelivery, type WhichLayoutForm, type WidgetFeed, type WorkflowBinding, type WorkflowHistoryEntry, type WorkflowInstance, type WorkflowInstanceData, type WorkflowState, type WorkflowTransition, type Workspace, type WorkspaceQuotas, type WorkspaceTemplate, type WorkspaceUsage, _and, _contains, _ends_with, _eq, _gt, _gte, _in, _lt, _lte, _ncontains, _neq, _nin, _nnull, _none, _null, _or, _some, _starts_with, abandonHelpVideoUpload, acquireItemLock, activateLayout, addChatChannelMember, addInstanceOwner, addSubRow, aggregateItems, aiBrief, aiBuildReport, aiChat, aiCheckDuplicates, aiGenerate, aiMapColumns, aiQuery, aiReportFilters, aiReview, aiSummarize, aiValidate, appendSessionRecordingEvents, applyContentBundle, applyHelpVideoPackageImport, applyRecordTemplate, applySubRowTemplate, approveAddendum, approveAiProposal, archiveHelpVideo, asc, backupExportPath, batchPickerExclusionStatus, bulkPickerExclusion, callExternalApi, callExternalApiEndpoint, cancelScheduledChange, cancelStagedImport, captureCpuProfile, cascadeFieldDependencies, checkBlackoutDate, claimQueueItem, claimTask, clearTraces, cloneItem, cloneLayout, cloneReport, compareConfigSnapshot, completeTask, copyReportWidget, createAccessAudit, createAddendum, createAlertDefinition, createAlertSubscription, createAnomalyRule, createApiKey, createApprovalChain, createAtRiskRule, createAttributeDefinition, createBlackoutDate, createChatChannel, createChatRoomType, createCollectionLayout, createComment, createDataQualityRule, createExternalApi, createExternalApiEndpoint, createFieldGroup, createFieldWatch, createGroupDm, createHelpVideo, createHierarchyConfig, createImportDefinition, createImportJob, createImportJobFromUrl, createInternalWidget, createIssue, createItem, createMetricAlertRule, createNivaro, createNotification, createNotificationSubscription, createPage, createPdfTemplate, createPersistedQuery, createPresence, createQueue, createQueueView, createRealtime, createRecordLink, createRecordTemplate, createReport, createReportAlert, createReportAnnotation, createReportFromTemplate, createReportSnapshot, createReportWidgetPreset, createRetentionPolicy, createRole, createRolePolicy, createRule, createSavedView, createScheduledChange, createScheduledReport, createShareLink, createSlaRule, createSubRowTemplate, createSyncJob, createTask, createTreePermission, createUser, createViewSubscription, createVirtualCollection, createWebhook, createWidgetFeed, createWorkspace, createWorkspaceTemplate, decideApproval, deleteAccessAudit, deleteAddendum, deleteAlertDefinition, deleteAlertSubscription, deleteAnomalyRule, deleteApiKey, deleteApprovalChain, deleteAtRiskRule, deleteAttributeDefinition, deleteBlackoutDate, deleteChatMessage, deleteCollectionLayout, deleteComment, deleteDataQualityRule, deleteExternalApi, deleteExternalApiEndpoint, deleteExternalApiSchema, deleteFieldGroup, deleteFieldTranslations, deleteFieldWatch, deleteFile, deleteHierarchyConfig, deleteImportJob, deleteInternalWidget, deleteIssue, deleteItem, deleteMetricAlertRule, deleteNotification, deleteNotificationSubscription, deletePage, deletePdfTemplate, deletePersistedQuery, deleteQueue, deleteQueueView, deleteRecordLink, deleteRecordTemplate, deleteReport, deleteReportAlert, deleteReportAnnotation, deleteReportFilterPreset, deleteReportSnapshot, deleteReportTemplate, deleteReportWidgetPreset, deleteRetentionPolicy, deleteRole, deleteRolePolicy, deleteRule, deleteSavedView, deleteScheduledReport, deleteSessionRecording, deleteSlaRule, deleteSubRow, deleteSubRowTemplate, deleteSyncJob, deleteTask, deleteTreePermission, deleteUser, deleteViewSubscription, deleteVirtualCollection, deleteWebhook, deleteWidgetFeed, deleteWorkspace, deleteWorkspaceTemplate, deployImportProcedure, desc, describeLayoutForm, diffLayoutVersion, disableTwoFactor, discardHelpVideoPackageImport, drillReportRow, editChatMessage, endSessionRecording, evaluateAlerts, evaluateAtRisk, evaluateFieldDefaults, evaluateFieldLock, evaluateFieldRules, evaluateFieldVisibility, excludeFromPicker, excludeFromPickers, executeBulkAction, executeCustomQuery, executeImportTemplate, executeItemAction, executeScheduledChange, explainLayout, explainLayoutField, explainRecordAccess, explainReportTrend, exportBlueprint, exportConfigSnapshot, exportContent, exportContentBundle, exportHelpVideoPackage, exportSchemaSnapshot, fetchFormSchema, fileDownloadPath, fileTransformPath, finalizeHelpVideoUpload, generateToken, generateUserToken, getAlertDefinition, getAttributeValues, getBrunoCollection, getCommentHistory, getExternalApi, getExternalApiEndpoint, getFieldTranslations, getFlowRun, getLocales, getOpenApi, getPickerExclusionStatus, getPostmanCollection, getPresence, getRetentionPolicy, getSlaRule, getSlaStatus, getTranslations, getTypes, getWebhook, globalSearch, heartbeatItemLock, helpVideosFor, importExternalApiSpec, importSchemaSnapshot, includeInPicker, includeInPickers, installBlueprint, installCollectionPreset, invokeInternalWidgetAction, isPageSlot, joinChatRoom, leaveChatRoom, listAccessAuditRuns, listAccessAudits, listActiveAtRiskRules, listActivePresence, listAddendums, listAlertDefinitions, listAlertSubscriptions, listAllNotificationSubscriptions, listAnomalyDefinitions, listAnomalyRules, listApiKeys, listApprovalChains, listApprovalInstances, listAtRiskRules, listAttributeDefinitions, listBlackoutDates, listBulkActions, listChangeOrders, listChatChannelMembers, listChatMessages, listChatPins, listChatRoles, listChatRoomTypes, listChatRooms, listCollectionPresets, listCollectionRecordTemplates, listComments, listCronJobs, listCustomQueries, listCustomQueryCatalog, listDataQualityRules, listDataQualityRuns, listDeadLetters, listExternalApiEndpoints, listExternalApiSchemas, listExternalApis, listFieldGroups, listFieldWatches, listFiles, listFlowRuns, listHelpVideoPages, listHelpVideoVersions, listHelpVideos, listHierarchyConfigs, listImportDefinitionVersions, listImportDefinitions, listImportJobs, listImportTemplates, listInternalWidgetPlacements, listInternalWidgets, listIssues, listItemActions, listItemScheduledChanges, listJobRuns, listLayoutVersions, listMetricAlertRules, listMetricAlertSubscriptions, listMetricDefinitions, listMyHelpVideoUploads, listMyTasks, listNotificationSubscriptions, listNotifications, listOrphanFiles, listPages, listPdfTemplates, listPersistedQueries, listPinnedItems, listPipelineVersions, listQueueViews, listQueues, listRecordLinks, listRecordTemplates, listRegisteredExtensions, listRegisteredFlowOperations, listRegisteredFlowTriggers, listRelatedComments, listReportAlerts, listReportAnnotations, listReportFilterPresets, listReportSnapshots, listReportTemplates, listReportVersions, listReportWidgetPresets, listReports, listRequestedTasks, listRetentionPolicies, listRetentionRuns, listRolePolicies, listRoleUsers, listRoles, listRules, listSavedViews, listScheduledChanges, listScheduledReports, listScopeDimensions, listSessionRecordings, listShareLinks, listSlaRules, listStagedImports, listSubRowTemplates, listSubRows, listSyncJobs, listTasks, listTeamTasks, listThroughputCollections, listTraces, listTreePermissions, listViewSubscriptions, listVirtualCollections, listWebhookDeliveries, listWebhooks, listWidgetFeeds, listWorkspaceTemplates, listWorkspaces, markAllNotificationsRead, markChatRoomRead, markNotificationRead, markNotificationsRead, moveTreeNode, nudgeTask, omniSearch, openHelpVideoPackageImport, openHelpVideoUpload, presignFileUpload, previewContentBundle, previewHelpVideoPackageImport, previewImportJob, previewReportWidget, projectFieldConfig, proposeLayoutOps, publishHelpVideo, publishItem, queryVirtualCollection, readAccessAuditFindings, readActiveLayout, readActivity, readActivityReportSummary, readAddendum, readAiSettings, readAlertLog, readAllStateOwners, readAnomalyLog, readApiAnalyticsErrors, readApiAnalyticsSummary, readApiAnalyticsTimeseries, readApiAnalyticsTopCollections, readApiAnalyticsTopPaths, readApiKey, readApprovalBrief, readApprovalChain, readAtRiskSummary, readBackupManifest, readChatConfig, readChatDirectory, readChatPeerRead, readCollection, readCollectionLayout, readCollectionLayouts, readCollections, readConfigInventory, readCoverageGaps, readDataQualityRun, readDbPool, readDetailLayout, readDistinctValues, readDraftPublishConfig, readErpSubmissionHistory, readExpensiveSql, readFieldChangeHistory, readFieldConfig, readFieldImpact, readFieldWatch, readFileMeta, readFileUsage, readFilesByIds, readHealthDetailed, readHelpVideo, readHelpVideoAnalytics, readHelpVideoDownloadLink, readHelpVideoDraft, readHelpVideoWalk, readHierarchyConfig, readHierarchyNodeAncestors, readHierarchyNodeChildren, readHierarchyNodes, readHierarchyTree, readImportJob, readImportProcedure, readInstanceOwners, readInstanceRoster, readIntegrationHealth, readInternalWidget, readIssue, readIssueSummary, readItem, readItemLock, readItemLockConfig, readItems, readJobRegistry, readLastTouch, readLayoutAssignments, readLayoutBundle, readLayoutDrift, readLayoutGroups, readLayoutOverview, readLayoutProposals, readLayoutVersion, readMany, readMe, readMetricAlertLog, readMyScopes, readMyWork, readNotificationCount, readNotificationSubscriptionStats, readOnlinePresence, readOwnerGroups, readPage, readPageWidgetData, readPdfTemplate, readPersistedQuery, readPickerExclusion, readPickerExclusions, readPipelineFlowMap, readPipelineReplay, readPipelineTemplate, readPipelineTemplates, readPipelineVersion, readPreflight, readQueue, readQueueCollectionStates, readQueueColumnPrefs, readQueueItems, readQueueTrends, readQueueWorkload, readReadiness, readRecordGraph, readRelationOptions, readReport, readReportAlertLog, readReportAlertsLog, readReportFilterOptions, readReportFiring, readReportSnapshot, readReportSubscription, readReportUsage, readReportWidgetData, readRequiredHelpVideos, readRevision, readRevisions, readRole, readRuntimeStats, readScopeDimensionCoverage, readSessionRecordingEvents, readSettings, readSingleton, readSlaStatusBatch, readStagedImport, readStagedImportStats, readStateOwnerGroups, readStateOwners, readStateOwnersBatch, readSyncJob, readTask, readTaskCounts, readTaskHistory, readThroughputReport, readTimeline, readTrace, readTrafficSnapshot, readTreeAncestors, readTreeChildren, readTreeConfig, readTreeDescendants, readTreeNested, readTreeNodes, readTwoFactorStatus, readUnreadNotificationCount, readUser, readUserActivity, readUserActivitySummary, readUserCard, readUserScopes, readUsers, readWorkflowBindings, readWorkflowInstance, readWorkflowInstances, readWorkspace, readWorkspaceUsage, rebuildTreePaths, recordHelpVideoProgress, registerHelpVideoPage, rehearseCreateItem, reindexSemanticSearch, rejectAddendum, rejectAiProposal, releaseItemLock, releaseQueueItem, rematerializeQueue, removeChatChannelMember, removeInstanceOwner, renderInternalWidget, renderPdfTemplate, reorderFieldGroups, reorderSubRows, reorderTreeSiblings, replaceSubRows, replayActivityEvent, replayFlow, reportClientError, requestRecordAccess, requeueStagedImport, rerecordHelpVideo, rerenderHelpVideo, resetReportCache, resolveLayoutProposal, resolveReportAlert, restoreHelpVideoVersion, restoreImportDefinitionVersion, restoreLayoutVersion, restorePipelineVersion, restoreReportVersion, retryDeadLetter, retryErpSubmission, retryWebhookDelivery, revokeApiKey, revokeShareLink, revokeToken, revokeUserToken, rollbackRevision, rotateWidgetFeedToken, runAccessAudit, runActivityReport, runActivityReportCsv, runCronJob, runDataQuality, runRetentionPolicy, runScheduledReport, runSyncJob, saveHelpVideoDraft, saveMyScopeDefaults, saveReportFilterPreset, saveReportTemplate, saveReportWidgets, saveUserScope, searchChatMessages, semanticSearch, sendBulkNotification, sendChatMessage, sendTestMail, sessionRecordingEnabled, setHelpVideoContexts, setHelpVideoRequirements, setMyDelegate, setQueueDefaultView, setReportSubscription, setTranslations, setupTwoFactor, simulatePermissions, simulatePipeline, simulatePipelineImpact, startApproval, startMasquerade, startSessionRecording, startWorkflow, stopMasquerade, submitAddendum, submitFormItem, submitItemForReview, submitLayoutOps, submitToErp, subscribeFieldWatch, subscribeMetricAlert, suggestImportValidation, suggestQueueLabels, switchWorkspace, testExternalApi, testFlow, testWebhook, toggleChatPin, toggleChatReaction, togglePinnedItem, toggleReportAlert, touchRecordView, transitionWorkflow, unpublishItem, unsubscribeFieldWatch, unsubscribeMetricAlert, updateAccessAudit, updateAddendum, updateAiSettings, updateAlertDefinition, updateAnomalyLogEntry, updateAnomalyRule, updateApiKey, updateApprovalChain, updateAtRiskRule, updateAttributeDefinition, updateAttributeValues, updateChatChannel, updateChatRoom, updateChatRoomType, updateCollectionLayout, updateComment, updateDataQualityRule, updateDraftPublishConfig, updateErpSubmissionStatus, updateExternalApi, updateExternalApiEndpoint, updateFieldConfig, updateFieldGroup, updateFieldWatch, updateFileMeta, updateHelpVideo, updateHierarchyConfig, updateImportDefinition, updateInternalWidget, updateIssue, updateItem, updateItemLockConfig, updateLayoutAssignments, updateLayoutUngroupedSort, updateMe, updateMetricAlertRule, updateMetricAlertSubscription, updateNotificationSubscription, updatePage, updatePdfTemplate, updatePersistedQuery, updateQueue, updateQueueSources, updateQueueView, updateRecordTemplate, updateReport, updateReportAlert, updateReportWidgetPreset, updateRetentionPolicy, updateRole, updateRolePolicy, updateRoleUiPermissions, updateRule, updateSavedView, updateScheduledReport, updateSettings, updateSingleton, updateSlaRule, updateSyncJob, updateTask, updateTreePermission, updateUser, updateVirtualCollection, updateWebhook, updateWidgetFeed, updateWorkflowBinding, updateWorkspace, validateVirtualCollectionSql, verifyTwoFactor, whichLayoutForm };

package/dist/index.js

@@ -907,8 +907,8 @@ function cancelScheduledChange(id) {
 function executeScheduledChange(id) {
   return cmd("POST", `/scheduled-changes/${id}/execute`);
 }
-function readFieldConfig(collection) {
-  return cmd("GET", `/field-config/${collection}`);
+function readFieldConfig(collection, opts) {
+  return cmd("GET", `/field-config/${collection}`, opts);
 }
 function updateFieldConfig(collection, field, body) {
   return cmd("PATCH", `/field-config/${collection}/${field}`, void 0, body);
@@ -1216,8 +1216,8 @@ function isPageSlot(assignment) {
 function readCollectionLayouts(collection) {
   return cmd("GET", "/collection-layouts", { collection });
 }
-function readActiveLayout(collection) {
-  return cmd("GET", "/collection-layouts/active", { collection });
+function readActiveLayout(collection, opts) {
+  return cmd("GET", "/collection-layouts/active", { collection, ...opts });
 }
 function readLayoutGroups(collection, layoutId) {
   return cmd("GET", `/field-groups/${collection}`, { layout_id: layoutId });
@@ -1228,11 +1228,11 @@ function readLayoutAssignments(layoutId) {
 function activateLayout(layoutId) {
   return cmd("POST", `/collection-layouts/${layoutId}/activate`);
 }
-function cloneLayout(layoutId, name) {
-  return cmd("POST", `/collection-layouts/${layoutId}/clone`, void 0, { name });
+function cloneLayout(layoutId, name, opts) {
+  return cmd("POST", `/collection-layouts/${layoutId}/clone`, void 0, { name, ...opts });
 }
-function createCollectionLayout(collection, name) {
-  return cmd("POST", "/collection-layouts", void 0, { collection, name });
+function createCollectionLayout(collection, name, opts) {
+  return cmd("POST", "/collection-layouts", void 0, { collection, name, ...opts });
 }
 function updateCollectionLayout(layoutId, patch) {
   return cmd("PATCH", `/collection-layouts/${layoutId}`, void 0, patch);
@@ -1640,6 +1640,159 @@ function listRetentionRuns(policyId) {
   return cmd("GET", `/retention/${policyId}/runs`);
 }
 
+// src/commands/layout-ai.ts
+function describeLayoutForm(layoutId) {
+  return cmd("GET", `/ai-design/layouts/${layoutId}/describe`);
+}
+function whichLayoutForm(query) {
+  return cmd("GET", "/ai-design/layouts/which-form", query);
+}
+function explainLayoutField(query) {
+  return cmd("GET", "/ai-design/layouts/explain-field", query);
+}
+function proposeLayoutOps(layoutId, body) {
+  return cmd("POST", `/ai-design/layouts/${layoutId}/proposals`, void 0, body);
+}
+function readLayoutProposals(layoutId, status) {
+  return cmd("GET", `/ai-design/layouts/${layoutId}/proposals`, status ? { status } : void 0);
+}
+function resolveLayoutProposal(layoutId, proposalId, outcome) {
+  return cmd("POST", `/ai-design/layouts/${layoutId}/proposals/${proposalId}/resolve`, void 0, {
+    outcome
+  });
+}
+
+// src/commands/layout-editor.ts
+var PLACEMENT_PATCH_KEYS = [
+  "label_override",
+  "is_visible",
+  "default_expanded",
+  "col_span",
+  "overrides",
+  "show_row_revisions",
+  "allow_revision_restore",
+  "lock_conditions",
+  "input_bindings",
+  "widget_id",
+  "show_approval_chain"
+];
+var EDITOR_NOTE_MAX = 4e3;
+var GROUP_PATCH_KEYS = [
+  "label",
+  "type",
+  "icon",
+  "is_collapsed",
+  "tab_mode",
+  "hide_when_empty",
+  "visibility_mode",
+  "summary_fields",
+  "summary_hide_empty",
+  "swap_config",
+  "skip_if_filled",
+  "content",
+  "content_tone",
+  "visible_when",
+  "hidden_for_roles",
+  "locked_for_roles",
+  "read_width",
+  "editor_note",
+  "i18n"
+];
+var LAYOUT_PATCH_KEYS = [
+  "name",
+  "slug",
+  "create_label",
+  "create_hidden",
+  "sort",
+  "is_active",
+  "disable_comments",
+  "disable_tasks",
+  "tab_mode",
+  "validate_before_next",
+  "summary_enabled",
+  "summary_hide_empty",
+  "ai_enabled",
+  "accordion_mode",
+  "disable_revisions",
+  "disable_clone",
+  "disable_delete",
+  "row_order_field",
+  "pdf_theme",
+  "pdf_template_id",
+  "pdf_cover_enabled",
+  "pdf_cover_title_field",
+  "pdf_cover_subtitle",
+  "pdf_show_logo",
+  "pdf_page_size",
+  "pdf_orientation",
+  "pdf_button_label",
+  "conditions",
+  "allow_schedule",
+  "allow_disable_pickers",
+  "layout_type",
+  "addendum_layout_id",
+  "workflow_template_id",
+  "single_active_addendum",
+  "addendum_default_view",
+  "record_conditions",
+  "default_values",
+  "display_mode",
+  "parent_layout_id",
+  "hide_integrity_banner",
+  "hide_sla_banner",
+  "changes_tray",
+  "dossier_enabled",
+  "dossier_label",
+  "quick_picker",
+  "sheet_width",
+  "header_fields",
+  "hide_empty",
+  "change_note"
+];
+function readLayoutOverview(collection) {
+  return cmd("GET", "/collection-layouts/overview", { collection });
+}
+function explainLayout(query) {
+  return cmd("GET", "/collection-layouts/explain", query);
+}
+function readLayoutBundle(layoutId) {
+  return cmd("GET", `/collection-layouts/${layoutId}/bundle`);
+}
+function submitLayoutOps(layoutId, body) {
+  return cmd("POST", `/collection-layouts/${layoutId}/ops`, void 0, body);
+}
+function readLayoutVersion(layoutId, versionId) {
+  return cmd("GET", `/collection-layouts/${layoutId}/versions/${versionId}`);
+}
+function diffLayoutVersion(layoutId, versionId, against) {
+  return cmd(
+    "GET",
+    `/collection-layouts/${layoutId}/versions/${versionId}/diff`,
+    against !== void 0 ? { against } : void 0
+  );
+}
+function readLayoutDrift() {
+  return cmd("GET", "/collection-layouts/drift");
+}
+function projectFieldConfig(collection, assignments) {
+  return cmd("POST", `/field-config/${collection}/project`, void 0, { assignments });
+}
+function listInternalWidgetPlacements(widgetId) {
+  return cmd("GET", `/widgets-internal/${widgetId}/placements`);
+}
+function readPickerExclusion(collection, itemId) {
+  return cmd("GET", `/picker-exclusions/status/${collection}/${itemId}`);
+}
+function readPickerExclusions(collection, ids) {
+  return cmd("POST", "/picker-exclusions/batch-status", void 0, { collection, ids });
+}
+function excludeFromPickers(body) {
+  return cmd("POST", "/picker-exclusions", void 0, body);
+}
+function includeInPickers(body) {
+  return cmd("DELETE", "/picker-exclusions", void 0, body);
+}
+
 // src/commands/ops.ts
 function readReadiness() {
   return cmd("GET", "/ready");
@@ -1954,7 +2107,16 @@ function aggregateItems(collection, query) {
   if (query.filter) params.filter = JSON.stringify(query.filter);
   if (query.search) params.search = query.search;
   if (query.countAll) params.countAll = 1;
-  for (const key of ["groupBy", "count", "countDistinct", "sum", "avg", "min", "max", "sort"]) {
+  for (const key of [
+    "groupBy",
+    "count",
+    "countDistinct",
+    "sum",
+    "avg",
+    "min",
+    "max",
+    "sort"
+  ]) {
     const list = query[key];
     if (list?.length) params[key] = list.join(",");
   }
@@ -2705,6 +2867,10 @@ function submitFormItem(collection, values, options) {
   return cmd("POST", `/items/${collection}`, void 0, values);
 }
 export {
+  EDITOR_NOTE_MAX,
+  GROUP_PATCH_KEYS,
+  LAYOUT_PATCH_KEYS,
+  PLACEMENT_PATCH_KEYS,
   READ_MANY_MAX,
   _and,
   _contains,
@@ -2903,6 +3069,8 @@ export {
   deleteWorkspaceTemplate,
   deployImportProcedure,
   desc,
+  describeLayoutForm,
+  diffLayoutVersion,
   disableTwoFactor,
   discardHelpVideoPackageImport,
   drillReportRow,
@@ -2915,11 +3083,14 @@ export {
   evaluateFieldRules,
   evaluateFieldVisibility,
   excludeFromPicker,
+  excludeFromPickers,
   executeBulkAction,
   executeCustomQuery,
   executeImportTemplate,
   executeItemAction,
   executeScheduledChange,
+  explainLayout,
+  explainLayoutField,
   explainRecordAccess,
   explainReportTrend,
   exportBlueprint,
@@ -2959,6 +3130,7 @@ export {
   importExternalApiSpec,
   importSchemaSnapshot,
   includeInPicker,
+  includeInPickers,
   installBlueprint,
   installCollectionPreset,
   invokeInternalWidgetAction,
@@ -3013,6 +3185,7 @@ export {
   listImportDefinitions,
   listImportJobs,
   listImportTemplates,
+  listInternalWidgetPlacements,
   listInternalWidgets,
   listIssues,
   listItemActions,
@@ -3092,6 +3265,8 @@ export {
   previewHelpVideoPackageImport,
   previewImportJob,
   previewReportWidget,
+  projectFieldConfig,
+  proposeLayoutOps,
   publishHelpVideo,
   publishItem,
   queryVirtualCollection,
@@ -3163,7 +3338,12 @@ export {
   readJobRegistry,
   readLastTouch,
   readLayoutAssignments,
+  readLayoutBundle,
+  readLayoutDrift,
   readLayoutGroups,
+  readLayoutOverview,
+  readLayoutProposals,
+  readLayoutVersion,
   readMany,
   readMe,
   readMetricAlertLog,
@@ -3177,6 +3357,8 @@ export {
   readPageWidgetData,
   readPdfTemplate,
   readPersistedQuery,
+  readPickerExclusion,
+  readPickerExclusions,
   readPipelineFlowMap,
   readPipelineReplay,
   readPipelineTemplate,
@@ -3269,6 +3451,7 @@ export {
   rerecordHelpVideo,
   rerenderHelpVideo,
   resetReportCache,
+  resolveLayoutProposal,
   resolveReportAlert,
   restoreHelpVideoVersion,
   restoreImportDefinitionVersion,
@@ -3322,6 +3505,7 @@ export {
   submitAddendum,
   submitFormItem,
   submitItemForReview,
+  submitLayoutOps,
   submitToErp,
   subscribeFieldWatch,
   subscribeMetricAlert,
@@ -3408,5 +3592,6 @@ export {
   updateWorkflowBinding,
   updateWorkspace,
   validateVirtualCollectionSql,
-  verifyTwoFactor
+  verifyTwoFactor,
+  whichLayoutForm
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nivaro/sdk",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "TypeScript SDK for Nivaro CMS — typed REST client, GraphQL, realtime subscriptions, and presence.",
   "type": "module",
   "main": "./dist/index.js",