@objectstack/plugin-approvals 9.2.0 → 9.4.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _objectstack_spec_data from '@objectstack/spec/data';
 import { ApprovalNodeConfig } from '@objectstack/spec/automation';
-import { IApprovalService, SharingExecutionContext, ApprovalRequestRow, ApprovalDecisionInput, ApprovalDecisionResult, ApprovalRecallInput, ApprovalRecallResult, ApprovalStatus, ApprovalActionRow } from '@objectstack/spec/contracts';
+import { IApprovalService, SharingExecutionContext, ApprovalRequestRow, ApprovalDecisionInput, ApprovalDecisionResult, ApprovalRecallInput, ApprovalRecallResult, ApprovalSendBackInput, ApprovalSendBackResult, ApprovalResubmitInput, ApprovalResubmitResult, ApprovalStatus, ApprovalActionRow } from '@objectstack/spec/contracts';
 export { ApprovalActionRow, ApprovalDecisionInput, ApprovalDecisionResult, ApprovalRequestRow, ApprovalStatus, IApprovalService } from '@objectstack/spec/contracts';
 import { Plugin, PluginContext } from '@objectstack/core';
 
@@ -454,6 +454,37 @@ declare const SysApprovalRequest: Omit<{
         }[] | undefined;
         searchableFields?: string[] | undefined;
         filterableFields?: string[] | undefined;
+        userFilters?: {
+            element: "toggle" | "tabs" | "dropdown";
+            fields?: {
+                field: string;
+                label?: string | undefined;
+                type?: "boolean" | "text" | "select" | "multi-select" | "date-range" | undefined;
+                options?: {
+                    value: string | number | boolean;
+                    label: string;
+                    color?: string | undefined;
+                }[] | undefined;
+                showCount?: boolean | undefined;
+                defaultValues?: (string | number | boolean)[] | undefined;
+            }[] | undefined;
+            tabs?: {
+                name: string;
+                pinned: boolean;
+                isDefault: boolean;
+                visible: boolean;
+                label?: string | undefined;
+                icon?: string | undefined;
+                view?: string | undefined;
+                filter?: {
+                    field: string;
+                    operator: string;
+                    value?: string | number | boolean | (string | number)[] | null | undefined;
+                }[] | undefined;
+                order?: number | undefined;
+            }[] | undefined;
+            showAllRecords?: boolean | undefined;
+        } | undefined;
         resizable?: boolean | undefined;
         striped?: boolean | undefined;
         bordered?: boolean | undefined;
@@ -566,7 +597,7 @@ declare const SysApprovalRequest: Omit<{
         } | undefined;
         appearance?: {
             showDescription: boolean;
-            allowedVisualizations?: ("grid" | "kanban" | "calendar" | "gantt" | "gallery" | "timeline" | "map")[] | undefined;
+            allowedVisualizations?: ("grid" | "kanban" | "calendar" | "gantt" | "gallery" | "timeline" | "chart" | "map")[] | undefined;
         } | undefined;
         tabs?: {
             name: string;
@@ -760,6 +791,8 @@ declare const SysApprovalRequest: Omit<{
         method?: "POST" | "PATCH" | "PUT" | "DELETE" | undefined;
         bodyExtra?: Record<string, unknown> | undefined;
         mode?: "custom" | "delete" | "edit" | "create" | undefined;
+        opensInNewTab?: boolean | undefined;
+        newTabUrl?: string | undefined;
         timeout?: number | undefined;
         aria?: {
             ariaLabel?: string | undefined;
@@ -5110,6 +5143,37 @@ declare const SysApprovalAction: Omit<{
         }[] | undefined;
         searchableFields?: string[] | undefined;
         filterableFields?: string[] | undefined;
+        userFilters?: {
+            element: "toggle" | "tabs" | "dropdown";
+            fields?: {
+                field: string;
+                label?: string | undefined;
+                type?: "boolean" | "text" | "select" | "multi-select" | "date-range" | undefined;
+                options?: {
+                    value: string | number | boolean;
+                    label: string;
+                    color?: string | undefined;
+                }[] | undefined;
+                showCount?: boolean | undefined;
+                defaultValues?: (string | number | boolean)[] | undefined;
+            }[] | undefined;
+            tabs?: {
+                name: string;
+                pinned: boolean;
+                isDefault: boolean;
+                visible: boolean;
+                label?: string | undefined;
+                icon?: string | undefined;
+                view?: string | undefined;
+                filter?: {
+                    field: string;
+                    operator: string;
+                    value?: string | number | boolean | (string | number)[] | null | undefined;
+                }[] | undefined;
+                order?: number | undefined;
+            }[] | undefined;
+            showAllRecords?: boolean | undefined;
+        } | undefined;
         resizable?: boolean | undefined;
         striped?: boolean | undefined;
         bordered?: boolean | undefined;
@@ -5222,7 +5286,7 @@ declare const SysApprovalAction: Omit<{
         } | undefined;
         appearance?: {
             showDescription: boolean;
-            allowedVisualizations?: ("grid" | "kanban" | "calendar" | "gantt" | "gallery" | "timeline" | "map")[] | undefined;
+            allowedVisualizations?: ("grid" | "kanban" | "calendar" | "gantt" | "gallery" | "timeline" | "chart" | "map")[] | undefined;
         } | undefined;
         tabs?: {
             name: string;
@@ -5416,6 +5480,8 @@ declare const SysApprovalAction: Omit<{
         method?: "POST" | "PATCH" | "PUT" | "DELETE" | undefined;
         bodyExtra?: Record<string, unknown> | undefined;
         mode?: "custom" | "delete" | "edit" | "create" | undefined;
+        opensInNewTab?: boolean | undefined;
+        newTabUrl?: string | undefined;
         timeout?: number | undefined;
         aria?: {
             ariaLabel?: string | undefined;
@@ -7406,181 +7472,2280 @@ declare const SysApprovalAction: Omit<{
 }, "fields">;
 
 /**
- * Node-era approval runtime (ADR-0019).
+ * sys_approval_approver — Pending-approver index (issue #1745).
  *
- * Approval is no longer a standalone engine — it is a **flow node**. A flow's
- * Approval node opens a request via {@link ApprovalService.openNodeRequest} and
- * the run suspends; a human decision via {@link ApprovalService.decide}
- * finalises the request and resumes the owning run down the matching
- * `approve` / `reject` edge.
+ * One row per (request, approver identity) while the request is **pending**.
+ * `sys_approval_request.pending_approvers` stays the human-readable source of
+ * truth (a CSV column), but CSV substring matching can neither be indexed nor
+ * pushed into an engine query — which made "my pending" a post-filter in
+ * memory and broke pagination beyond the scan window.
  *
- * This service owns the durable approval *state* — `sys_approval_request` /
- * `sys_approval_action`, approver resolution (team / department / role /
- * manager graph), and the optional status-field mirror — plus the decision
- * API. It does not author processes, submit, or walk multi-step machinery
- * anymore; that orchestration lives on the one automation engine.
- */
-interface ApprovalEngine {
-    find(object: string, options?: any): Promise<any[]>;
-    insert(object: string, data: any, options?: any): Promise<any>;
-    update(object: string, idOrData: any, dataOrOptions?: any, options?: any): Promise<any>;
-    delete(object: string, options?: any): Promise<any>;
-}
-interface ApprovalClock {
-    now(): Date;
-}
-/**
- * Minimal automation surface the service uses to resume a suspended flow run
- * once a decision finalises a node-driven request. Optional — attached by the
- * plugin when an automation engine is present (see `approval-node.ts`).
+ * This table is that CSV, normalized: the service mirrors every change to
+ * `pending_approvers` here (open / decide / recall / send-back / reassign /
+ * escalate), and clears the rows when the request leaves `pending`. So the
+ * table only ever holds the live work queue — its size tracks the number of
+ * open approvals, not the append-only request history.
+ *
+ * `approver` holds one identity literal exactly as it appears in the CSV:
+ * a user id, an email, or a `role:<name>` / `team:<name>` style literal.
+ * Equality (or `$in`) on this column is the indexed replacement for the old
+ * per-row substring match.
+ *
+ * @namespace sys
  */
-interface ApprovalResumeSurface {
-    resume?(runId: string, signal?: {
-        output?: Record<string, unknown>;
-        branchLabel?: string;
-    }): Promise<unknown>;
-}
-interface ApprovalServiceOptions {
-    engine: ApprovalEngine;
-    clock?: ApprovalClock;
-    logger?: {
-        info?: (msg: any, ...rest: any[]) => void;
-        warn?: (msg: any, ...rest: any[]) => void;
-        error?: (msg: any, ...rest: any[]) => void;
-        debug?: (msg: any, ...rest: any[]) => void;
-    };
-    /**
-     * Optional automation surface used to resume a suspended flow run when a
-     * decision finalises a request. Usually attached after construction via
-     * {@link ApprovalService.attachAutomation} once the automation engine is
-     * available.
-     */
-    automation?: ApprovalResumeSurface;
-}
-declare class ApprovalService implements IApprovalService {
-    private readonly engine;
-    private readonly clock;
-    private readonly logger?;
-    private automation?;
-    constructor(opts: ApprovalServiceOptions);
-    /** Attach (or replace) the automation surface used to resume flow runs. */
-    attachAutomation(automation: ApprovalResumeSurface): void;
-    /**
-     * Expand the approvers on an Approval node into user IDs by querying the
-     * graph tables for `team:` / `department:` / `role:` / `manager:` approver
-     * types. Falls back to a prefixed literal (`type:value`) when graph lookups
-     * produce nothing — so existing fixtures and flows that rely on substring
-     * matching keep working.
-     *
-     * **Graph semantics:**
-     *   - `team`       → flat members of `sys_team` (better-auth; no BFS)
-     *   - `department` → recursive BFS of `sys_department.parent_department_id`
-     *                    → members of every descendant via `sys_department_member`
-     *   - `role`       → users with `sys_member.role = value` in tenant
-     *   - `manager`    → `sys_user.manager_id` of `record[value] ?? record.owner_id`
-     *   - `field`      → literal user id stored in `record[value]`
-     *   - `user`       → literal value
-     */
-    private expandApprovers;
-    /** Flat team — `sys_team` is better-auth's collaboration grouping (no hierarchy). */
-    private expandTeamUsers;
-    /** Recursive department — walks `sys_department.parent_department_id`. */
-    private expandDepartmentUsers;
-    private expandRoleUsers;
-    private lookupManager;
-    /** Mirror a request status onto a business-object field, if configured. */
-    private mirrorStatusField;
-    /**
-     * Open a pending approval request on behalf of a flow's Approval node. The
-     * node config (approvers / behavior / status field) is snapshotted on the row
-     * so a decision can be made without any process to resolve against.
-     */
-    openNodeRequest(input: {
-        object: string;
-        recordId: string;
-        runId: string;
-        nodeId: string;
-        config: ApprovalNodeConfig;
-        flowName?: string;
-        /** Authored flow label, snapshotted for inbox display. */
-        flowLabel?: string;
-        /** Authored node label, snapshotted for inbox display. */
-        nodeLabel?: string;
-        submitterId?: string | null;
-        record?: any;
-        organizationId?: string | null;
-    }, context: SharingExecutionContext): Promise<ApprovalRequestRow>;
-    /**
-     * Record a decision on a node-driven request. Honours the node's `unanimous`
-     * behavior (holds until every approver has approved). When the request
-     * finalizes, returns the suspended run id + node id so the caller (or
-     * {@link ApprovalService.decide}) can resume the flow down the matching
-     * branch.
-     */
-    decideNode(requestId: string, input: {
-        decision: 'approve' | 'reject';
-        actorId: string;
-        comment?: string;
-    }, context: SharingExecutionContext): Promise<{
-        request: ApprovalRequestRow;
-        runId: string | null;
-        nodeId: string | null;
-        finalized: boolean;
-        decision: 'approve' | 'reject';
-    }>;
-    /**
-     * Public contract entrypoint (ADR-0019). Records a decision on a node-driven
-     * request via {@link ApprovalService.decideNode} and, when it finalizes,
-     * resumes the owning flow run down the matching `approve` / `reject` edge.
-     */
-    decide(requestId: string, input: ApprovalDecisionInput, context: SharingExecutionContext): Promise<ApprovalDecisionResult>;
-    /**
-     * Withdraw a pending request (submitter only). Finalises the row as
-     * `recalled`, releases the record lock (keyed on pending status), mirrors
-     * the status field when configured, and resumes the owning flow run down
-     * the `reject` branch with `output.decision = 'recall'` — the engine has no
-     * run-cancel primitive, and leaving the run suspended forever would leak it.
-     */
-    recall(requestId: string, input: ApprovalRecallInput, context: SharingExecutionContext): Promise<ApprovalRecallResult>;
-    /**
-     * Resolve the schema-declared display field for an object, when the engine
-     * exposes schema metadata (`getSchema`). Falls back to common title-ish
-     * field names so plain `ApprovalEngine` fakes still enrich sensibly.
-     */
-    private resolveDisplayField;
-    private static pickTitle;
-    /**
-     * Batch-resolve `sys_user` display names for identifiers that may be user
-     * ids or emails. Best-effort — failures leave entries unresolved.
-     */
-    private resolveUserNames;
-    /** Lookup-typed fields (key + referenced object) of an object's schema. */
-    private resolveLookupFields;
-    /**
-     * Attach inbox display fields to rows so clients never render a raw
-     * identifier: `record_title`, `submitter_name`, `object_label`,
-     * `pending_approver_names` (user-id approvers), and `payload_display`
-     * (lookup foreign keys in the snapshot → referenced record titles).
-     * Batched: one query per distinct object (target + referenced) plus one
-     * `sys_user` lookup. Best-effort — a deleted record falls back to the
-     * payload snapshot, and any failure leaves the field unset rather than
-     * failing the list.
-     */
-    private enrichRows;
-    listRequests(filter: {
-        object?: string;
-        recordId?: string;
-        status?: ApprovalStatus | ApprovalStatus[];
-        approverId?: string | string[];
-        submitterId?: string;
-    } | undefined, context: SharingExecutionContext): Promise<ApprovalRequestRow[]>;
-    getRequest(requestId: string, context: SharingExecutionContext): Promise<ApprovalRequestRow | null>;
-    listActions(requestId: string, context: SharingExecutionContext): Promise<ApprovalActionRow[]>;
-}
-
-interface ApprovalsPluginOptions {
-    /** Disable runtime registration (schemas still register). */
-    disableService?: boolean;
+declare const SysApprovalApprover: Omit<{
+    name: string;
+    active: boolean;
+    isSystem: boolean;
+    abstract: boolean;
+    datasource: string;
+    fields: Record<string, {
+        type: "number" | "boolean" | "tags" | "date" | "record" | "file" | "code" | "datetime" | "signature" | "progress" | "url" | "lookup" | "master_detail" | "currency" | "percent" | "password" | "secret" | "email" | "time" | "text" | "textarea" | "phone" | "markdown" | "html" | "richtext" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "tree" | "image" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "composite" | "repeater" | "location" | "address" | "json" | "color" | "rating" | "slider" | "qrcode" | "vector";
+        required: boolean;
+        searchable: boolean;
+        multiple: boolean;
+        unique: boolean;
+        deleteBehavior: "set_null" | "cascade" | "restrict";
+        auditTrail: boolean;
+        hidden: boolean;
+        readonly: boolean;
+        sortable: boolean;
+        index: boolean;
+        externalId: boolean;
+        name?: string | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
+        format?: string | undefined;
+        columnName?: string | undefined;
+        defaultValue?: unknown;
+        maxLength?: number | undefined;
+        minLength?: number | undefined;
+        precision?: number | undefined;
+        scale?: number | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        options?: {
+            label: string;
+            value: string;
+            color?: string | undefined;
+            default?: boolean | undefined;
+        }[] | undefined;
+        reference?: string | undefined;
+        referenceFilters?: string[] | undefined;
+        writeRequiresMasterRead?: boolean | undefined;
+        inlineEdit?: boolean | "grid" | "form" | undefined;
+        inlineTitle?: string | undefined;
+        inlineColumns?: any[] | undefined;
+        inlineAmountField?: string | undefined;
+        relatedList?: boolean | undefined;
+        relatedListTitle?: string | undefined;
+        relatedListColumns?: any[] | undefined;
+        expression?: {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | undefined;
+        summaryOperations?: {
+            object: string;
+            field: string;
+            function: "min" | "max" | "count" | "sum" | "avg";
+            relationshipField?: string | undefined;
+        } | undefined;
+        language?: string | undefined;
+        theme?: string | undefined;
+        lineNumbers?: boolean | undefined;
+        maxRating?: number | undefined;
+        allowHalf?: boolean | undefined;
+        displayMap?: boolean | undefined;
+        allowGeocoding?: boolean | undefined;
+        addressFormat?: "us" | "uk" | "international" | undefined;
+        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+        allowAlpha?: boolean | undefined;
+        presetColors?: string[] | undefined;
+        step?: number | undefined;
+        showValue?: boolean | undefined;
+        marks?: Record<string, string> | undefined;
+        barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+        qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+        displayValue?: boolean | undefined;
+        allowScanning?: boolean | undefined;
+        currencyConfig?: {
+            precision: number;
+            currencyMode: "fixed" | "dynamic";
+            defaultCurrency: string;
+        } | undefined;
+        vectorConfig?: {
+            dimensions: number;
+            distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+            normalized: boolean;
+            indexed: boolean;
+            indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+        } | undefined;
+        fileAttachmentConfig?: {
+            virusScan: boolean;
+            virusScanOnUpload: boolean;
+            quarantineOnThreat: boolean;
+            allowMultiple: boolean;
+            allowReplace: boolean;
+            allowDelete: boolean;
+            requireUpload: boolean;
+            extractMetadata: boolean;
+            extractText: boolean;
+            versioningEnabled: boolean;
+            publicRead: boolean;
+            presignedUrlExpiry: number;
+            minSize?: number | undefined;
+            maxSize?: number | undefined;
+            allowedTypes?: string[] | undefined;
+            blockedTypes?: string[] | undefined;
+            allowedMimeTypes?: string[] | undefined;
+            blockedMimeTypes?: string[] | undefined;
+            virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+            storageProvider?: string | undefined;
+            storageBucket?: string | undefined;
+            storagePrefix?: string | undefined;
+            imageValidation?: {
+                generateThumbnails: boolean;
+                preserveMetadata: boolean;
+                autoRotate: boolean;
+                minWidth?: number | undefined;
+                maxWidth?: number | undefined;
+                minHeight?: number | undefined;
+                maxHeight?: number | undefined;
+                aspectRatio?: string | undefined;
+                thumbnailSizes?: {
+                    name: string;
+                    width: number;
+                    height: number;
+                    crop: boolean;
+                }[] | undefined;
+            } | undefined;
+            maxVersions?: number | undefined;
+        } | undefined;
+        encryptionConfig?: {
+            enabled: boolean;
+            algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+            keyManagement: {
+                provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                keyId?: string | undefined;
+                rotationPolicy?: {
+                    enabled: boolean;
+                    frequencyDays: number;
+                    retainOldVersions: number;
+                    autoRotate: boolean;
+                } | undefined;
+            };
+            scope: "record" | "field" | "table" | "database";
+            deterministicEncryption: boolean;
+            searchableEncryption: boolean;
+        } | undefined;
+        maskingRule?: {
+            field: string;
+            strategy: "partial" | "hash" | "redact" | "tokenize" | "randomize" | "nullify" | "substitute";
+            preserveFormat: boolean;
+            preserveLength: boolean;
+            pattern?: string | undefined;
+            roles?: string[] | undefined;
+            exemptRoles?: string[] | undefined;
+        } | undefined;
+        dependencies?: string[] | undefined;
+        cached?: {
+            enabled: boolean;
+            ttl: number;
+            invalidateOn: string[];
+        } | undefined;
+        dataQuality?: {
+            uniqueness: boolean;
+            completeness: number;
+            accuracy?: {
+                source: string;
+                threshold: number;
+            } | undefined;
+        } | undefined;
+        group?: string | undefined;
+        visibleWhen?: {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | undefined;
+        readonlyWhen?: {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | undefined;
+        requiredWhen?: {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | undefined;
+        conditionalRequired?: {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | undefined;
+        system?: boolean | undefined;
+        inlineHelpText?: string | undefined;
+        trackFeedHistory?: boolean | undefined;
+        caseSensitive?: boolean | undefined;
+        autonumberFormat?: string | undefined;
+    }>;
+    _lock?: "full" | "none" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
+    label?: string | undefined;
+    pluralLabel?: string | undefined;
+    description?: string | undefined;
+    icon?: string | undefined;
+    tags?: string[] | undefined;
+    managedBy?: "platform" | "system" | "config" | "append-only" | "better-auth" | undefined;
+    userActions?: {
+        create?: boolean | undefined;
+        import?: boolean | undefined;
+        edit?: boolean | undefined;
+        delete?: boolean | undefined;
+        exportCsv?: boolean | undefined;
+    } | undefined;
+    systemFields?: false | {
+        tenant?: boolean | undefined;
+        owner?: boolean | undefined;
+        audit?: boolean | undefined;
+    } | undefined;
+    external?: {
+        writable: boolean;
+        remoteName?: string | undefined;
+        remoteSchema?: string | undefined;
+        columnMap?: Record<string, string> | undefined;
+        introspectedAt?: string | undefined;
+        ignoreColumns?: string[] | undefined;
+    } | undefined;
+    indexes?: {
+        fields: string[];
+        type: "hash" | "btree" | "gin" | "gist" | "fulltext";
+        unique: boolean;
+        name?: string | undefined;
+        partial?: string | undefined;
+    }[] | undefined;
+    fieldGroups?: {
+        key: string;
+        label: string;
+        defaultExpanded: boolean;
+        icon?: string | undefined;
+        description?: string | undefined;
+        visibleOn?: {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | undefined;
+    }[] | undefined;
+    tenancy?: {
+        enabled: boolean;
+        strategy: "hybrid" | "shared" | "isolated";
+        tenantField: string;
+        crossTenantAccess: boolean;
+    } | undefined;
+    softDelete?: {
+        enabled: boolean;
+        field: string;
+        cascadeDelete: boolean;
+    } | undefined;
+    versioning?: {
+        enabled: boolean;
+        strategy: "snapshot" | "delta" | "event-sourcing";
+        versionField: string;
+        retentionDays?: number | undefined;
+    } | undefined;
+    partitioning?: {
+        enabled: boolean;
+        strategy: "hash" | "list" | "range";
+        key: string;
+        interval?: string | undefined;
+    } | undefined;
+    cdc?: {
+        enabled: boolean;
+        events: ("delete" | "update" | "insert")[];
+        destination: string;
+    } | undefined;
+    validations?: _objectstack_spec_data.BaseValidationRuleShape[] | undefined;
+    displayNameField?: string | undefined;
+    recordName?: {
+        type: "text" | "autonumber";
+        displayFormat?: string | undefined;
+        startNumber?: number | undefined;
+    } | undefined;
+    titleFormat?: {
+        dialect: "cel" | "js" | "cron" | "template";
+        source?: string | undefined;
+        ast?: unknown;
+        meta?: {
+            rationale?: string | undefined;
+            generatedBy?: string | undefined;
+        } | undefined;
+    } | {
+        dialect: "cel" | "js" | "cron" | "template";
+        source?: string | undefined;
+        ast?: unknown;
+        meta?: {
+            rationale?: string | undefined;
+            generatedBy?: string | undefined;
+        } | undefined;
+    } | undefined;
+    compactLayout?: string[] | undefined;
+    listViews?: Record<string, {
+        type: "grid" | "kanban" | "calendar" | "gantt" | "gallery" | "timeline" | "chart" | "map";
+        columns: string[] | {
+            field: string;
+            label?: string | undefined;
+            width?: number | undefined;
+            align?: "left" | "center" | "right" | undefined;
+            hidden?: boolean | undefined;
+            sortable?: boolean | undefined;
+            resizable?: boolean | undefined;
+            wrap?: boolean | undefined;
+            type?: string | undefined;
+            pinned?: "left" | "right" | undefined;
+            summary?: "none" | "min" | "max" | "count" | "sum" | "avg" | "count_empty" | "count_filled" | "count_unique" | "percent_empty" | "percent_filled" | undefined;
+            link?: boolean | undefined;
+            action?: string | undefined;
+        }[];
+        name?: string | undefined;
+        label?: string | undefined;
+        data?: {
+            provider: "object";
+            object: string;
+        } | {
+            provider: "api";
+            read?: {
+                url: string;
+                method: "POST" | "PATCH" | "PUT" | "DELETE" | "GET";
+                headers?: Record<string, string> | undefined;
+                params?: Record<string, unknown> | undefined;
+                body?: unknown;
+            } | undefined;
+            write?: {
+                url: string;
+                method: "POST" | "PATCH" | "PUT" | "DELETE" | "GET";
+                headers?: Record<string, string> | undefined;
+                params?: Record<string, unknown> | undefined;
+                body?: unknown;
+            } | undefined;
+        } | {
+            provider: "value";
+            items: unknown[];
+        } | {
+            provider: "schema";
+            schemaId: string;
+            schema?: Record<string, unknown> | undefined;
+        } | undefined;
+        filter?: {
+            field: string;
+            operator: string;
+            value?: string | number | boolean | (string | number)[] | null | undefined;
+        }[] | undefined;
+        sort?: string | {
+            field: string;
+            order: "asc" | "desc";
+        }[] | undefined;
+        searchableFields?: string[] | undefined;
+        filterableFields?: string[] | undefined;
+        userFilters?: {
+            element: "toggle" | "tabs" | "dropdown";
+            fields?: {
+                field: string;
+                label?: string | undefined;
+                type?: "boolean" | "text" | "select" | "multi-select" | "date-range" | undefined;
+                options?: {
+                    value: string | number | boolean;
+                    label: string;
+                    color?: string | undefined;
+                }[] | undefined;
+                showCount?: boolean | undefined;
+                defaultValues?: (string | number | boolean)[] | undefined;
+            }[] | undefined;
+            tabs?: {
+                name: string;
+                pinned: boolean;
+                isDefault: boolean;
+                visible: boolean;
+                label?: string | undefined;
+                icon?: string | undefined;
+                view?: string | undefined;
+                filter?: {
+                    field: string;
+                    operator: string;
+                    value?: string | number | boolean | (string | number)[] | null | undefined;
+                }[] | undefined;
+                order?: number | undefined;
+            }[] | undefined;
+            showAllRecords?: boolean | undefined;
+        } | undefined;
+        resizable?: boolean | undefined;
+        striped?: boolean | undefined;
+        bordered?: boolean | undefined;
+        compactToolbar?: boolean | undefined;
+        selection?: {
+            type: "none" | "multiple" | "single";
+        } | undefined;
+        navigation?: {
+            mode: "none" | "split" | "page" | "drawer" | "modal" | "popover" | "new_window";
+            preventNavigation: boolean;
+            openNewTab: boolean;
+            view?: string | undefined;
+            width?: string | number | undefined;
+        } | undefined;
+        pagination?: {
+            pageSize: number;
+            pageSizeOptions?: number[] | undefined;
+        } | undefined;
+        kanban?: {
+            groupByField: string;
+            columns: string[];
+            summarizeField?: string | undefined;
+        } | undefined;
+        calendar?: {
+            startDateField: string;
+            titleField: string;
+            endDateField?: string | undefined;
+            colorField?: string | undefined;
+        } | undefined;
+        gantt?: {
+            startDateField: string;
+            endDateField: string;
+            titleField: string;
+            progressField?: string | undefined;
+            dependenciesField?: string | undefined;
+        } | undefined;
+        gallery?: {
+            coverFit: "cover" | "contain";
+            cardSize: "small" | "medium" | "large";
+            coverField?: string | undefined;
+            titleField?: string | undefined;
+            visibleFields?: string[] | undefined;
+        } | undefined;
+        timeline?: {
+            startDateField: string;
+            titleField: string;
+            scale: "hour" | "day" | "week" | "month" | "quarter" | "year";
+            endDateField?: string | undefined;
+            groupByField?: string | undefined;
+            colorField?: string | undefined;
+        } | undefined;
+        chart?: {
+            chartType: "bar" | "line" | "pie" | "area" | "scatter";
+            dataset: string;
+            values: string[];
+            dimensions?: string[] | undefined;
+        } | undefined;
+        description?: string | undefined;
+        sharing?: {
+            type: "personal" | "collaborative";
+            lockedBy?: string | undefined;
+        } | undefined;
+        rowHeight?: "medium" | "short" | "compact" | "tall" | "extra_tall" | undefined;
+        grouping?: {
+            fields: {
+                field: string;
+                order: "asc" | "desc";
+                collapsed: boolean;
+            }[];
+        } | undefined;
+        rowColor?: {
+            field: string;
+            colors?: Record<string, string> | undefined;
+        } | undefined;
+        hiddenFields?: string[] | undefined;
+        fieldOrder?: string[] | undefined;
+        rowActions?: string[] | undefined;
+        bulkActions?: string[] | undefined;
+        bulkActionDefs?: Record<string, any>[] | undefined;
+        virtualScroll?: boolean | undefined;
+        conditionalFormatting?: {
+            condition: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            };
+            style: Record<string, string>;
+        }[] | undefined;
+        inlineEdit?: boolean | undefined;
+        exportOptions?: ("json" | "csv" | "xlsx" | "pdf")[] | undefined;
+        userActions?: {
+            sort: boolean;
+            search: boolean;
+            filter: boolean;
+            rowHeight: boolean;
+            addRecordForm: boolean;
+            buttons?: string[] | undefined;
+        } | undefined;
+        appearance?: {
+            showDescription: boolean;
+            allowedVisualizations?: ("grid" | "kanban" | "calendar" | "gantt" | "gallery" | "timeline" | "chart" | "map")[] | undefined;
+        } | undefined;
+        tabs?: {
+            name: string;
+            pinned: boolean;
+            isDefault: boolean;
+            visible: boolean;
+            label?: string | undefined;
+            icon?: string | undefined;
+            view?: string | undefined;
+            filter?: {
+                field: string;
+                operator: string;
+                value?: string | number | boolean | (string | number)[] | null | undefined;
+            }[] | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+        addRecord?: {
+            enabled: boolean;
+            position: "top" | "bottom" | "both";
+            mode: "form" | "modal" | "inline";
+            formView?: string | undefined;
+        } | undefined;
+        showRecordCount?: boolean | undefined;
+        allowPrinting?: boolean | undefined;
+        emptyState?: {
+            title?: string | undefined;
+            message?: string | undefined;
+            icon?: string | undefined;
+        } | undefined;
+        aria?: {
+            ariaLabel?: string | undefined;
+            ariaDescribedBy?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+        responsive?: {
+            breakpoint?: "md" | "xs" | "sm" | "lg" | "xl" | "2xl" | undefined;
+            hiddenOn?: ("md" | "xs" | "sm" | "lg" | "xl" | "2xl")[] | undefined;
+            columns?: {
+                xs?: number | undefined;
+                sm?: number | undefined;
+                md?: number | undefined;
+                lg?: number | undefined;
+                xl?: number | undefined;
+                '2xl'?: number | undefined;
+            } | undefined;
+            order?: {
+                xs?: number | undefined;
+                sm?: number | undefined;
+                md?: number | undefined;
+                lg?: number | undefined;
+                xl?: number | undefined;
+                '2xl'?: number | undefined;
+            } | undefined;
+        } | undefined;
+        performance?: {
+            lazyLoad?: boolean | undefined;
+            virtualScroll?: {
+                enabled: boolean;
+                itemHeight?: number | undefined;
+                overscan?: number | undefined;
+            } | undefined;
+            cacheStrategy?: "none" | "cache-first" | "network-first" | "stale-while-revalidate" | undefined;
+            prefetch?: boolean | undefined;
+            pageSize?: number | undefined;
+            debounceMs?: number | undefined;
+        } | undefined;
+    }> | undefined;
+    defaultDetailForm?: string | undefined;
+    search?: {
+        fields: string[];
+        displayFields?: string[] | undefined;
+        filters?: string[] | undefined;
+    } | undefined;
+    enable?: {
+        trackHistory: boolean;
+        searchable: boolean;
+        apiEnabled: boolean;
+        files: boolean;
+        feeds: boolean;
+        activities: boolean;
+        trash: boolean;
+        mru: boolean;
+        clone: boolean;
+        apiMethods?: ("search" | "create" | "import" | "delete" | "list" | "get" | "update" | "upsert" | "bulk" | "aggregate" | "history" | "restore" | "purge" | "export")[] | undefined;
+    } | undefined;
+    recordTypes?: string[] | undefined;
+    sharingModel?: "full" | "read" | "private" | "read_write" | undefined;
+    publicSharing?: {
+        enabled: boolean;
+        allowedAudiences?: ("email" | "public" | "link_only" | "signed_in")[] | undefined;
+        allowedPermissions?: ("edit" | "view" | "comment")[] | undefined;
+        maxExpiryDays?: number | undefined;
+        redactFields?: string[] | undefined;
+        eligibility?: string | undefined;
+    } | undefined;
+    keyPrefix?: string | undefined;
+    detail?: {
+        [x: string]: unknown;
+        renderViaSchema?: boolean | undefined;
+        hideReferenceRail?: boolean | undefined;
+        hideRelatedTab?: boolean | undefined;
+    } | undefined;
+    actions?: {
+        name: string;
+        label: string;
+        type: "url" | "form" | "flow" | "api" | "script" | "modal";
+        refreshAfter: boolean;
+        objectName?: string | undefined;
+        icon?: string | undefined;
+        locations?: ("list_toolbar" | "list_item" | "record_header" | "record_more" | "record_related" | "record_section" | "global_nav")[] | undefined;
+        component?: "action:button" | "action:icon" | "action:menu" | "action:group" | undefined;
+        target?: string | undefined;
+        body?: {
+            language: "expression";
+            source: string;
+        } | {
+            language: "js";
+            source: string;
+            capabilities: ("api.read" | "api.write" | "crypto.uuid" | "crypto.hash" | "log")[];
+            timeoutMs?: number | undefined;
+            memoryMb?: number | undefined;
+        } | undefined;
+        execute?: string | undefined;
+        params?: {
+            required: boolean;
+            name?: string | undefined;
+            field?: string | undefined;
+            objectOverride?: string | undefined;
+            label?: string | undefined;
+            type?: "number" | "boolean" | "date" | "record" | "file" | "code" | "datetime" | "signature" | "progress" | "url" | "lookup" | "master_detail" | "currency" | "percent" | "password" | "secret" | "email" | "time" | "text" | "textarea" | "phone" | "markdown" | "html" | "richtext" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "tree" | "image" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "composite" | "repeater" | "location" | "address" | "json" | "color" | "rating" | "slider" | "qrcode" | "tags" | "vector" | undefined;
+            options?: {
+                label: string;
+                value: string;
+            }[] | undefined;
+            placeholder?: string | undefined;
+            helpText?: string | undefined;
+            defaultValue?: unknown;
+            defaultFromRow?: boolean | undefined;
+        }[] | undefined;
+        variant?: "link" | "primary" | "secondary" | "danger" | "ghost" | undefined;
+        confirmText?: string | undefined;
+        successMessage?: string | undefined;
+        resultDialog?: {
+            title?: string | undefined;
+            description?: string | undefined;
+            acknowledge?: string | undefined;
+            format?: "secret" | "text" | "json" | "qrcode" | "code-list" | undefined;
+            fields?: {
+                path: string;
+                label?: string | undefined;
+                format?: "secret" | "text" | "json" | "qrcode" | "code-list" | undefined;
+            }[] | undefined;
+        } | undefined;
+        visible?: {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | undefined;
+        disabled?: boolean | {
+            dialect: "cel" | "js" | "cron" | "template";
+            source?: string | undefined;
+            ast?: unknown;
+            meta?: {
+                rationale?: string | undefined;
+                generatedBy?: string | undefined;
+            } | undefined;
+        } | undefined;
+        shortcut?: string | undefined;
+        bulkEnabled?: boolean | undefined;
+        ai?: {
+            exposed: boolean;
+            description?: string | undefined;
+            category?: "action" | "data" | "flow" | "integration" | "vector_search" | "analytics" | "utility" | undefined;
+            paramHints?: Record<string, {
+                description?: string | undefined;
+                enum?: (string | number)[] | undefined;
+                examples?: unknown[] | undefined;
+            }> | undefined;
+            outputSchema?: Record<string, unknown> | undefined;
+            requiresConfirmation?: boolean | undefined;
+        } | undefined;
+        recordIdParam?: string | undefined;
+        recordIdField?: string | undefined;
+        bodyShape?: "flat" | {
+            wrap: string;
+        } | undefined;
+        method?: "POST" | "PATCH" | "PUT" | "DELETE" | undefined;
+        bodyExtra?: Record<string, unknown> | undefined;
+        mode?: "custom" | "delete" | "edit" | "create" | undefined;
+        opensInNewTab?: boolean | undefined;
+        newTabUrl?: string | undefined;
+        timeout?: number | undefined;
+        aria?: {
+            ariaLabel?: string | undefined;
+            ariaDescribedBy?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+    protection?: {
+        lock: "full" | "none" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
+}, "fields"> & Pick<{
+    readonly name: "sys_approval_approver";
+    readonly label: "Approval Approver";
+    readonly pluralLabel: "Approval Approvers";
+    readonly icon: "users";
+    readonly isSystem: true;
+    readonly managedBy: "system";
+    readonly description: "Normalized pending-approver rows for indexed inbox queries";
+    readonly displayNameField: "id";
+    readonly titleFormat: "{approver} · {request_id}";
+    readonly compactLayout: ["request_id", "approver", "created_at"];
+    readonly fields: {
+        readonly id: {
+            readonly readonly?: boolean | undefined;
+            readonly format?: string | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly description?: string | undefined;
+            readonly label?: string | undefined;
+            readonly name?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly required?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly theme?: string | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly group?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly system?: boolean | undefined;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "record" | "field" | "table" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly columnName?: string | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly inlineEdit?: boolean | "grid" | "form" | undefined;
+            readonly inlineTitle?: string | undefined;
+            readonly inlineColumns?: any[] | undefined;
+            readonly inlineAmountField?: string | undefined;
+            readonly relatedList?: boolean | undefined;
+            readonly relatedListTitle?: string | undefined;
+            readonly relatedListColumns?: any[] | undefined;
+            readonly expression?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "min" | "max" | "count" | "sum" | "avg";
+                relationshipField?: string | undefined;
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "fixed" | "dynamic";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "partial" | "hash" | "redact" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly visibleWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly readonlyWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly requiredWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly conditionalRequired?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly type: "text";
+        };
+        readonly organization_id: {
+            readonly readonly?: boolean | undefined;
+            readonly format?: string | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly description?: string | undefined;
+            readonly label?: string | undefined;
+            readonly name?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly required?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly theme?: string | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly group?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly system?: boolean | undefined;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "record" | "field" | "table" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly columnName?: string | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            reference: string;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly inlineEdit?: boolean | "grid" | "form" | undefined;
+            readonly inlineTitle?: string | undefined;
+            readonly inlineColumns?: any[] | undefined;
+            readonly inlineAmountField?: string | undefined;
+            readonly relatedList?: boolean | undefined;
+            readonly relatedListTitle?: string | undefined;
+            readonly relatedListColumns?: any[] | undefined;
+            readonly expression?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "min" | "max" | "count" | "sum" | "avg";
+                relationshipField?: string | undefined;
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "fixed" | "dynamic";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "partial" | "hash" | "redact" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly visibleWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly readonlyWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly requiredWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly conditionalRequired?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly type: "lookup";
+        };
+        readonly request_id: {
+            readonly readonly?: boolean | undefined;
+            readonly format?: string | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly description?: string | undefined;
+            readonly label?: string | undefined;
+            readonly name?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly required?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly theme?: string | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly group?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly system?: boolean | undefined;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "record" | "field" | "table" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly columnName?: string | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            reference: string;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly inlineEdit?: boolean | "grid" | "form" | undefined;
+            readonly inlineTitle?: string | undefined;
+            readonly inlineColumns?: any[] | undefined;
+            readonly inlineAmountField?: string | undefined;
+            readonly relatedList?: boolean | undefined;
+            readonly relatedListTitle?: string | undefined;
+            readonly relatedListColumns?: any[] | undefined;
+            readonly expression?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "min" | "max" | "count" | "sum" | "avg";
+                relationshipField?: string | undefined;
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "fixed" | "dynamic";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "partial" | "hash" | "redact" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly visibleWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly readonlyWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly requiredWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly conditionalRequired?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly type: "lookup";
+        };
+        readonly approver: {
+            readonly readonly?: boolean | undefined;
+            readonly format?: string | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly description?: string | undefined;
+            readonly label?: string | undefined;
+            readonly name?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly required?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly theme?: string | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly group?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly system?: boolean | undefined;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "record" | "field" | "table" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly columnName?: string | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly inlineEdit?: boolean | "grid" | "form" | undefined;
+            readonly inlineTitle?: string | undefined;
+            readonly inlineColumns?: any[] | undefined;
+            readonly inlineAmountField?: string | undefined;
+            readonly relatedList?: boolean | undefined;
+            readonly relatedListTitle?: string | undefined;
+            readonly relatedListColumns?: any[] | undefined;
+            readonly expression?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "min" | "max" | "count" | "sum" | "avg";
+                relationshipField?: string | undefined;
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "fixed" | "dynamic";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "partial" | "hash" | "redact" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly visibleWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly readonlyWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly requiredWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly conditionalRequired?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly type: "text";
+        };
+        readonly created_at: {
+            readonly readonly?: boolean | undefined;
+            readonly format?: string | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly description?: string | undefined;
+            readonly label?: string | undefined;
+            readonly name?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly required?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly theme?: string | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly group?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly system?: boolean | undefined;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "record" | "field" | "table" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly columnName?: string | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly inlineEdit?: boolean | "grid" | "form" | undefined;
+            readonly inlineTitle?: string | undefined;
+            readonly inlineColumns?: any[] | undefined;
+            readonly inlineAmountField?: string | undefined;
+            readonly relatedList?: boolean | undefined;
+            readonly relatedListTitle?: string | undefined;
+            readonly relatedListColumns?: any[] | undefined;
+            readonly expression?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "min" | "max" | "count" | "sum" | "avg";
+                relationshipField?: string | undefined;
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "fixed" | "dynamic";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "partial" | "hash" | "redact" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly visibleWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly readonlyWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly requiredWhen?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly conditionalRequired?: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly type: "datetime";
+        };
+    };
+    readonly indexes: [{
+        readonly fields: ["approver", "organization_id"];
+    }, {
+        readonly fields: ["request_id"];
+    }];
+}, "fields">;
+
+/**
+ * Node-era approval runtime (ADR-0019).
+ *
+ * Approval is no longer a standalone engine — it is a **flow node**. A flow's
+ * Approval node opens a request via {@link ApprovalService.openNodeRequest} and
+ * the run suspends; a human decision via {@link ApprovalService.decide}
+ * finalises the request and resumes the owning run down the matching
+ * `approve` / `reject` edge.
+ *
+ * This service owns the durable approval *state* — `sys_approval_request` /
+ * `sys_approval_action`, approver resolution (team / department / role /
+ * manager graph), and the optional status-field mirror — plus the decision
+ * API. It does not author processes, submit, or walk multi-step machinery
+ * anymore; that orchestration lives on the one automation engine.
+ */
+interface ApprovalEngine {
+    find(object: string, options?: any): Promise<any[]>;
+    insert(object: string, data: any, options?: any): Promise<any>;
+    update(object: string, idOrData: any, dataOrOptions?: any, options?: any): Promise<any>;
+    delete(object: string, options?: any): Promise<any>;
+}
+interface ApprovalClock {
+    now(): Date;
+}
+/**
+ * Minimal automation surface the service uses to resume a suspended flow run
+ * once a decision finalises a node-driven request. Optional — attached by the
+ * plugin when an automation engine is present (see `approval-node.ts`).
+ */
+interface ApprovalResumeSurface {
+    resume?(runId: string, signal?: {
+        output?: Record<string, unknown>;
+        branchLabel?: string;
+    }): Promise<unknown>;
+    /** Flow definition lookup, used to derive step-progress display data. */
+    getFlow?(name: string): Promise<any | null>;
+    /**
+     * Terminally cancel a suspended run (ADR-0044). Used when a recall lands
+     * during a revision window — the run is paused at the revise wait node,
+     * which has no reject edge to resume down.
+     */
+    cancelRun?(runId: string, reason?: string): Promise<unknown>;
+}
+/**
+ * Optional messaging surface (ADR-0012 `messaging` service). When attached,
+ * thread interactions (reassign / remind / request-info / comment) notify the
+ * affected users; without it they degrade to audit-only.
+ */
+interface ApprovalMessagingSurface {
+    emit(input: {
+        topic: string;
+        audience: string[];
+        payload?: Record<string, unknown>;
+        severity?: string;
+        dedupKey?: string;
+        source?: {
+            object: string;
+            id: string;
+        };
+        actorId?: string;
+    }): Promise<unknown>;
+}
+/** Outcome of redeeming (or peeking) an actionable-link token. */
+type ActionTokenOutcome = {
+    ok: true;
+    action: 'approve' | 'reject';
+    request: ApprovalRequestRow;
+    approverId: string;
+} | {
+    ok: false;
+    reason: 'invalid' | 'expired' | 'consumed' | 'not_pending' | 'not_approver';
+    request?: ApprovalRequestRow;
+};
+interface ApprovalServiceOptions {
+    engine: ApprovalEngine;
+    clock?: ApprovalClock;
+    logger?: {
+        info?: (msg: any, ...rest: any[]) => void;
+        warn?: (msg: any, ...rest: any[]) => void;
+        error?: (msg: any, ...rest: any[]) => void;
+        debug?: (msg: any, ...rest: any[]) => void;
+    };
+    /**
+     * Optional automation surface used to resume a suspended flow run when a
+     * decision finalises a request. Usually attached after construction via
+     * {@link ApprovalService.attachAutomation} once the automation engine is
+     * available.
+     */
+    automation?: ApprovalResumeSurface;
+    /** Optional messaging service for thread notifications. */
+    messaging?: ApprovalMessagingSurface;
+    /**
+     * Absolute origin prefixed onto actionable links (ADR-0043), e.g.
+     * `https://app.example.com`. Defaults to relative URLs, which work inside
+     * the Console and IM webviews; outbound email needs the absolute form.
+     */
+    publicBaseUrl?: string;
+}
+declare class ApprovalService implements IApprovalService {
+    private readonly engine;
+    private readonly clock;
+    private readonly logger?;
+    private automation?;
+    private messaging?;
+    private publicBaseUrl;
+    constructor(opts: ApprovalServiceOptions);
+    /** Attach (or replace) the automation surface used to resume flow runs. */
+    attachAutomation(automation: ApprovalResumeSurface): void;
+    /** Attach (or replace) the messaging surface used for thread notifications. */
+    attachMessaging(messaging: ApprovalMessagingSurface): void;
+    /** Best-effort notification fan-out — failures only log. */
+    private notify;
+    /** Load a request row and assert it is still pending. */
+    private loadPendingRow;
+    /**
+     * Expand the approvers on an Approval node into user IDs by querying the
+     * graph tables for `team:` / `department:` / `role:` / `manager:` approver
+     * types. Falls back to a prefixed literal (`type:value`) when graph lookups
+     * produce nothing — so existing fixtures and flows that rely on substring
+     * matching keep working.
+     *
+     * **Graph semantics:**
+     *   - `team`       → flat members of `sys_team` (better-auth; no BFS)
+     *   - `department` → recursive BFS of `sys_department.parent_department_id`
+     *                    → members of every descendant via `sys_department_member`
+     *   - `role`       → users with `sys_member.role = value` in tenant
+     *   - `manager`    → `sys_user.manager_id` of `record[value] ?? record.owner_id`
+     *   - `field`      → literal user id stored in `record[value]`
+     *   - `user`       → literal value
+     */
+    private expandApprovers;
+    /** Flat team — `sys_team` is better-auth's collaboration grouping (no hierarchy). */
+    private expandTeamUsers;
+    /** Recursive department — walks `sys_department.parent_department_id`. */
+    private expandDepartmentUsers;
+    private expandRoleUsers;
+    private lookupManager;
+    /** Mirror a request status onto a business-object field, if configured. */
+    private mirrorStatusField;
+    /**
+     * Open a pending approval request on behalf of a flow's Approval node. The
+     * node config (approvers / behavior / status field) is snapshotted on the row
+     * so a decision can be made without any process to resolve against.
+     */
+    openNodeRequest(input: {
+        object: string;
+        recordId: string;
+        runId: string;
+        nodeId: string;
+        config: ApprovalNodeConfig;
+        flowName?: string;
+        /** Authored flow label, snapshotted for inbox display. */
+        flowLabel?: string;
+        /** Authored node label, snapshotted for inbox display. */
+        nodeLabel?: string;
+        submitterId?: string | null;
+        record?: any;
+        organizationId?: string | null;
+    }, context: SharingExecutionContext): Promise<ApprovalRequestRow>;
+    /**
+     * Record a decision on a node-driven request. Honours the node's `unanimous`
+     * behavior (holds until every approver has approved). When the request
+     * finalizes, returns the suspended run id + node id so the caller (or
+     * {@link ApprovalService.decide}) can resume the flow down the matching
+     * branch.
+     */
+    decideNode(requestId: string, input: {
+        decision: 'approve' | 'reject';
+        actorId: string;
+        comment?: string;
+    }, context: SharingExecutionContext): Promise<{
+        request: ApprovalRequestRow;
+        runId: string | null;
+        nodeId: string | null;
+        finalized: boolean;
+        decision: 'approve' | 'reject';
+    }>;
+    /**
+     * Public contract entrypoint (ADR-0019). Records a decision on a node-driven
+     * request via {@link ApprovalService.decideNode} and, when it finalizes,
+     * resumes the owning flow run down the matching `approve` / `reject` edge.
+     */
+    decide(requestId: string, input: ApprovalDecisionInput, context: SharingExecutionContext): Promise<ApprovalDecisionResult>;
+    /**
+     * Withdraw a pending request (submitter only). Finalises the row as
+     * `recalled`, releases the record lock (keyed on pending status), mirrors
+     * the status field when configured, and resumes the owning flow run down
+     * the `reject` branch with `output.decision = 'recall'` — leaving the run
+     * suspended forever would leak it.
+     *
+     * ADR-0044: also valid on the LATEST `returned` request of its run — the
+     * submitter abandons the revision window instead of resubmitting. The run
+     * is then paused at the revise wait node (no reject edge), so it is
+     * terminally cancelled via {@link ApprovalResumeSurface.cancelRun} rather
+     * than resumed.
+     */
+    recall(requestId: string, input: ApprovalRecallInput, context: SharingExecutionContext): Promise<ApprovalRecallResult>;
+    /**
+     * ADR-0044 send back for revision. Finalises the pending request as
+     * `returned` (a third terminal state — approver-initiated rework, distinct
+     * from submitter-initiated `recalled`) and resumes the owning flow run down
+     * its `revise` edge to a wait point: the record lock (keyed on `pending`)
+     * releases, the submitter reworks the data, then {@link resubmit}s.
+     *
+     * Requires the approval node to declare a `revise` out-edge — validated
+     * BEFORE any mutation, because resuming with an unmatched `branchLabel`
+     * falls back to *all* out-edges. Past the node's `maxRevisions` budget the
+     * request auto-rejects instead (resumes down `reject` with
+     * `output.autoRejected = true`) so instances cannot orbit forever.
+     */
+    sendBack(requestId: string, input: ApprovalSendBackInput, context: SharingExecutionContext): Promise<ApprovalSendBackResult>;
+    /**
+     * ADR-0044 resubmit after rework. Valid on the LATEST `returned` request of
+     * its run, submitter-only. Audits `resubmit` on the returned (round-N)
+     * request and resumes the run from the revise wait node; traversal walks
+     * the declared back-edge into the approval node, whose executor opens the
+     * round-N+1 request — fresh approver slate, record re-locks.
+     */
+    resubmit(requestId: string, input: ApprovalResubmitInput, context: SharingExecutionContext): Promise<ApprovalResubmitResult>;
+    /**
+     * ADR-0044 guard: the flow's approval node must declare a `revise`
+     * out-edge before send-back is allowed — the engine's branch-label fallback
+     * (no matching label ⇒ ALL out-edges) must never be reachable from a user
+     * action.
+     */
+    private assertReviseEdge;
+    /**
+     * ADR-0044 guard: a `returned` request is only actionable (resubmit /
+     * recall) while it is still the newest request on its run — a later round
+     * or a later node's request supersedes it.
+     */
+    private assertLatestForRun;
+    /**
+     * Hand a pending-approver slot to someone else. `from` defaults to the
+     * actor itself; the actor must hold the slot being handed over (or be a
+     * system caller). Audits `reassign` and notifies the new approver.
+     */
+    reassign(requestId: string, input: {
+        actorId: string;
+        to: string;
+        from?: string;
+        comment?: string;
+    }, context: SharingExecutionContext): Promise<{
+        request: ApprovalRequestRow;
+    }>;
+    /**
+     * Submitter nudge — notify every pending approver. Throttled to one
+     * reminder per {@link REMIND_COOLDOWN_MS} per request.
+     */
+    remind(requestId: string, input: {
+        actorId: string;
+        comment?: string;
+    }, context: SharingExecutionContext): Promise<{
+        request: ApprovalRequestRow;
+        notified: number;
+    }>;
+    /** Build the session-less confirm-page URL for a raw token. */
+    actionLinkUrl(rawToken: string): string;
+    /**
+     * Issue one-tap approve/reject tokens for one approver on one pending
+     * request. Raw tokens are returned ONCE; only SHA-256 hashes are stored
+     * (`sys_approval_token`), so a DB leak yields no usable links.
+     */
+    issueActionTokens(requestId: string, approverId: string, opts?: {
+        ttlMs?: number;
+    }): Promise<{
+        approve: string;
+        reject: string;
+    }>;
+    /** Shared validation chain for peek/redeem. Returns the token row when live. */
+    private resolveActionToken;
+    /** GET confirm page: validate WITHOUT consuming — never mutates. */
+    peekActionToken(rawToken: string): Promise<ActionTokenOutcome>;
+    /**
+     * POST redemption: consume the token FIRST (a failed decide still burns
+     * it — replay-safe), then decide as the bound approver.
+     */
+    redeemActionToken(rawToken: string): Promise<ActionTokenOutcome>;
+    /**
+     * Approver asks the submitter for more information. The request stays
+     * pending — a thread interaction, not a flow decision.
+     */
+    requestInfo(requestId: string, input: {
+        actorId: string;
+        comment: string;
+    }, context: SharingExecutionContext): Promise<{
+        request: ApprovalRequestRow;
+    }>;
+    /** Free-form reply on the thread (submitter or any pending approver). */
+    comment(requestId: string, input: {
+        actorId: string;
+        comment: string;
+    }, context: SharingExecutionContext): Promise<{
+        request: ApprovalRequestRow;
+    }>;
+    /**
+     * One escalation sweep: every *pending* request whose node config declares
+     * `escalation.timeoutHours` and whose deadline has passed is escalated
+     * **at most once, ever** — the `escalate` audit row is the idempotency
+     * marker, written before any mutation (audit-first, like reassign). One
+     * bad row never stops the sweep.
+     */
+    runEscalations(): Promise<{
+        scanned: number;
+        escalated: number;
+    }>;
+    /** Execute the configured escalation action for one overdue request. */
+    private escalateRequest;
+    /**
+     * Resolve the schema-declared display field for an object, when the engine
+     * exposes schema metadata (`getSchema`). Falls back to common title-ish
+     * field names so plain `ApprovalEngine` fakes still enrich sensibly.
+     */
+    private resolveDisplayField;
+    private static pickTitle;
+    /**
+     * Batch-resolve `sys_user` display names for identifiers that may be user
+     * ids or emails. Best-effort — failures leave entries unresolved.
+     */
+    private resolveUserNames;
+    /** Lookup-typed fields (key + referenced object) of an object's schema. */
+    private resolveLookupFields;
+    /**
+     * Attach inbox display fields to rows so clients never render a raw
+     * identifier: `record_title`, `submitter_name`, `object_label`,
+     * `pending_approver_names` (user-id approvers), and `payload_display`
+     * (lookup foreign keys in the snapshot → referenced record titles).
+     * Batched: one query per distinct object (target + referenced) plus one
+     * `sys_user` lookup. Best-effort — a deleted record falls back to the
+     * payload snapshot, and any failure leaves the field unset rather than
+     * failing the list.
+     */
+    private enrichRows;
+    /**
+     * Mirror one request's `pending_approvers` CSV into the normalized
+     * `sys_approval_approver` index. Called by every write path that changes
+     * the approver set; an empty `approvers` clears the request's rows (the
+     * request left `pending`). Diff-based so reassign/unanimous churn doesn't
+     * rewrite untouched rows.
+     */
+    private syncApproverIndex;
+    /**
+     * Rebuild the whole `sys_approval_approver` index from the CSV source of
+     * truth. Idempotent; run at plugin start so rows written before the index
+     * existed (or drifted past a crashed sync) become queryable. Cost tracks
+     * the number of *pending* requests, not the request history.
+     */
+    rebuildApproverIndex(): Promise<{
+        requests: number;
+        inserted: number;
+        deleted: number;
+    }>;
+    /** Filter type accepted by {@link listRequests} / {@link countRequests}. */
+    private buildRequestWhere;
+    /** Window the approver-index probe — pending queues live far below this. */
+    private static readonly APPROVER_INDEX_CAP;
+    /**
+     * Resolve an approver filter to matching request ids via the normalized
+     * `sys_approval_approver` index — the indexed replacement for the old
+     * in-memory CSV scan, and what makes approver-filtered pagination correct
+     * past any scan window (issue #1745). A request matches when ANY of the
+     * caller's identities (user id / email / role:<r>) holds a pending slot.
+     * Returns null when the filter is absent (callers skip the id constraint).
+     */
+    private approverRequestIds;
+    listRequests(filter: {
+        object?: string;
+        recordId?: string;
+        status?: ApprovalStatus | ApprovalStatus[];
+        approverId?: string | string[];
+        submitterId?: string;
+        q?: string;
+        limit?: number;
+        offset?: number;
+    } | undefined, context: SharingExecutionContext): Promise<ApprovalRequestRow[]>;
+    countRequests(filter: Parameters<IApprovalService['listRequests']>[0], context: SharingExecutionContext): Promise<number>;
+    getRequest(requestId: string, context: SharingExecutionContext): Promise<ApprovalRequestRow | null>;
+    /**
+     * Derive approval-step progress from the owning flow's graph (single-read
+     * enrichment only — list reads skip it). Walks from the start node
+     * preferring `approve`/`true` edges, so the result is the flow's main
+     * approval trunk; conditional side-steps show as part of the potential
+     * path. Display-only and best-effort.
+     */
+    private attachFlowSteps;
+    listActions(requestId: string, context: SharingExecutionContext): Promise<ApprovalActionRow[]>;
+}
+
+interface ApprovalsPluginOptions {
+    /** Disable runtime registration (schemas still register). */
+    disableService?: boolean;
+    /**
+     * Interval between SLA escalation scans (ADR-0042). Defaults to
+     * {@link ESCALATION_SCAN_INTERVAL_MS} (5 min). Only takes effect when a
+     * `job` service is installed; without one, SLA stays display-only.
+     */
+    escalationScanIntervalMs?: number;
+    /**
+     * Absolute origin for actionable links in outbound notifications
+     * (ADR-0043), e.g. `https://app.example.com`. Relative by default.
+     */
+    publicBaseUrl?: string;
     /**
      * Disable the record-lock hook. Schema + service stay intact; only the
      * engine-level lock wiring is suppressed. Useful when a caller wants the
@@ -7605,10 +9770,11 @@ declare class ApprovalsServicePlugin implements Plugin {
     private readonly options;
     private service?;
     private engine?;
+    private escalationJobScheduled;
     constructor(options?: ApprovalsPluginOptions);
     init(ctx: PluginContext): Promise<void>;
     start(ctx: PluginContext): Promise<void>;
-    stop(_ctx: PluginContext): Promise<void>;
+    stop(ctx: PluginContext): Promise<void>;
 }
 
 /** Minimal surface of the automation engine this provider depends on. */
@@ -7640,4 +9806,4 @@ interface MinimalLogger {
  */
 declare function registerApprovalNode(automation: ApprovalAutomationSurface, service: ApprovalService, logger?: MinimalLogger): void;
 
-export { type ApprovalAutomationSurface, type ApprovalClock, type ApprovalEngine, type ApprovalResumeSurface, ApprovalService, type ApprovalServiceOptions, type ApprovalsPluginOptions, ApprovalsServicePlugin, SysApprovalAction, SysApprovalRequest, registerApprovalNode };
+export { type ApprovalAutomationSurface, type ApprovalClock, type ApprovalEngine, type ApprovalResumeSurface, ApprovalService, type ApprovalServiceOptions, type ApprovalsPluginOptions, ApprovalsServicePlugin, SysApprovalAction, SysApprovalApprover, SysApprovalRequest, registerApprovalNode };