@elevasis/ui 2.72.0 → 2.74.0

package/dist/components/index.d.ts

@@ -1895,6 +1895,64 @@ type Database = {
                     }
                 ];
             };
+            content_distribution_metrics: {
+                Row: {
+                    captured_at: string;
+                    created_at: string;
+                    distribution_id: string;
+                    id: string;
+                    metrics: Json;
+                    organization_id: string;
+                    raw: Json;
+                    source: string;
+                    source_execution_id: string | null;
+                };
+                Insert: {
+                    captured_at?: string;
+                    created_at?: string;
+                    distribution_id: string;
+                    id?: string;
+                    metrics?: Json;
+                    organization_id: string;
+                    raw?: Json;
+                    source: string;
+                    source_execution_id?: string | null;
+                };
+                Update: {
+                    captured_at?: string;
+                    created_at?: string;
+                    distribution_id?: string;
+                    id?: string;
+                    metrics?: Json;
+                    organization_id?: string;
+                    raw?: Json;
+                    source?: string;
+                    source_execution_id?: string | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "content_distribution_metrics_distribution_fkey";
+                        columns: ["distribution_id", "organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "content_distributions";
+                        referencedColumns: ["id", "organization_id"];
+                    },
+                    {
+                        foreignKeyName: "content_distribution_metrics_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "content_distribution_metrics_source_execution_id_fkey";
+                        columns: ["source_execution_id"];
+                        isOneToOne: false;
+                        referencedRelation: "execution_logs";
+                        referencedColumns: ["execution_id"];
+                    }
+                ];
+            };
             content_distributions: {
                 Row: {
                     adapted_body: string | null;
@@ -2044,6 +2102,63 @@ type Database = {
                     }
                 ];
             };
+            content_item_source_assets: {
+                Row: {
+                    alt_text: string | null;
+                    content_item_id: string;
+                    created_at: string;
+                    crop: Json | null;
+                    derivative_crop: Json | null;
+                    derivative_path: string | null;
+                    derivative_rendered_at: string | null;
+                    id: string;
+                    organization_id: string;
+                    position: number;
+                    source_asset_id: string;
+                };
+                Insert: {
+                    alt_text?: string | null;
+                    content_item_id: string;
+                    created_at?: string;
+                    crop?: Json | null;
+                    derivative_crop?: Json | null;
+                    derivative_path?: string | null;
+                    derivative_rendered_at?: string | null;
+                    id?: string;
+                    organization_id: string;
+                    position: number;
+                    source_asset_id: string;
+                };
+                Update: {
+                    alt_text?: string | null;
+                    content_item_id?: string;
+                    created_at?: string;
+                    crop?: Json | null;
+                    derivative_crop?: Json | null;
+                    derivative_path?: string | null;
+                    derivative_rendered_at?: string | null;
+                    id?: string;
+                    organization_id?: string;
+                    position?: number;
+                    source_asset_id?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "content_item_source_assets_asset_fkey";
+                        columns: ["source_asset_id", "organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "content_source_assets";
+                        referencedColumns: ["id", "organization_id"];
+                    },
+                    {
+                        foreignKeyName: "content_item_source_assets_item_fkey";
+                        columns: ["content_item_id", "organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "content_items";
+                        referencedColumns: ["id", "organization_id"];
+                    }
+                ];
+            };
             content_items: {
                 Row: {
                     body: string | null;
@@ -3799,6 +3914,25 @@ type Database = {
                 };
                 Returns: Json;
             };
+            activate_deployment_atomic: {
+                Args: {
+                    p_deployment_id: string;
+                    p_organization_id: string;
+                };
+                Returns: {
+                    created_at: string;
+                    deployment_version: string | null;
+                    error_message: string | null;
+                    id: string;
+                    organization_id: string;
+                    pid: number | null;
+                    port: number | null;
+                    sdk_version: string;
+                    status: string;
+                    tarball_path: string | null;
+                    updated_at: string;
+                };
+            };
             append_deal_activity: {
                 Args: {
                     p_activity: Json;
@@ -4427,7 +4561,9 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         storage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>>>>;
+        rowSchema: z.ZodOptional<z.ZodString>;
+        stateCatalogId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>>;
     linkTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -4438,7 +4574,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         to: z.ZodString;
         cardinality: z.ZodOptional<z.ZodString>;
         via: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
     actionTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -4448,7 +4584,11 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         actsOn: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
         input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         effects: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    }, z.core.$loose>>>>;
+        resourceId: z.ZodOptional<z.ZodString>;
+        invocations: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        lifecycle: z.ZodOptional<z.ZodString>;
+        legacyActionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>>;
     catalogTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -4458,7 +4598,10 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         kind: z.ZodOptional<z.ZodString>;
         appliesTo: z.ZodOptional<z.ZodString>;
         entries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>>>>;
+        legacyCatalogKey: z.ZodOptional<z.ZodString>;
+        legacyPipelineKey: z.ZodOptional<z.ZodString>;
+        legacyEntityKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>>;
     eventTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -4466,7 +4609,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         ownerSystemId: z.ZodOptional<z.ZodString>;
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
     interfaceTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -4474,7 +4617,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         ownerSystemId: z.ZodOptional<z.ZodString>;
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
     valueTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -4482,7 +4625,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         ownerSystemId: z.ZodOptional<z.ZodString>;
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         primitive: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
     sharedProperties: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -4492,7 +4635,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         valueType: z.ZodOptional<z.ZodString>;
         searchable: z.ZodOptional<z.ZodBoolean>;
         pii: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
     groups: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -4500,7 +4643,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         ownerSystemId: z.ZodOptional<z.ZodString>;
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         members: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
     endpoints: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -4508,7 +4651,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         ownerSystemId: z.ZodOptional<z.ZodString>;
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         route: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
 }, z.core.$strict>>;
 type OntologyScope = z.infer<typeof OntologyScopeSchema>;
 
@@ -4624,6 +4767,45 @@ declare const LinkSchema: z.ZodObject<{
 }, z.core.$strip>;
 type Link = z.infer<typeof LinkSchema>;
 
+/**
+ * Registration surface for the generic readiness engine (`./engine`).
+ *
+ * This module owns two independent extension points so `./engine` never has
+ * to import anything from `business/**`:
+ *
+ *  - `registerBuiltInReadinessProfile` — a profile id (e.g. `sales.lead-gen.api`)
+ *    maps to structural validation logic plus an optional model-preparation
+ *    hook run before ontology compilation (e.g. injecting a derived catalog).
+ *    This is the ONE readiness-profile registry (`_builtInProfileValidators`
+ *    below) — `../domains/systems`'s `isBuiltInReadinessProfile` /
+ *    `lookupReadinessProfile` read it directly via `getBuiltInReadinessProfile`
+ *    rather than mirroring registrations into a second map, so a profile id
+ *    can never read as built-in without an actual registered validator.
+ *  - `registerReadinessInterfaceMarker` — a `(systemPath, interfaceKey)` pair
+ *    maps to a synthesized interface marker for interfaces that are not
+ *    authored on `system.apiInterface` (e.g. the lead-gen/CRM handoff bridge,
+ *    which is derived from scoped resources rather than declared directly).
+ *
+ * `business/acquisition/ontology-validation.ts` calls both at module load to
+ * register its three built-in profiles. Both registries are module-level
+ * mutable maps with no reset function. Reachable by a tenant via the
+ * `./organization-model/readiness` subpath (see `./index`).
+ */
+
+type SystemInterfaceReadinessIssueFamily = 'SYSTEM_INTERFACE_MISSING' | 'SYSTEM_INTERFACE_DISABLED' | 'SYSTEM_INTERFACE_INVALID' | 'SYSTEM_INTERFACE_NOT_READY' | 'SYSTEM_BRIDGE_NOT_READY'
+/**
+ * The deployed OM snapshot hash does not match the canonical source hash.
+ * Redeploy with `pnpm operations:deploy` to refresh the snapshot.
+ */
+ | 'STALE_OM_SNAPSHOT';
+interface SystemInterfaceReadinessIssue {
+    family: SystemInterfaceReadinessIssueFamily;
+    code: string;
+    path?: string;
+    ref?: string;
+    message: string;
+}
+
 declare const OrganizationModelSchema: z.ZodObject<{
     version: z.ZodDefault<z.ZodLiteral<1>>;
     snapshotHash: z.ZodOptional<z.ZodString>;
@@ -5074,7 +5256,9 @@ declare const OrganizationModelSchema: z.ZodObject<{
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             storage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$loose>>>>;
+            rowSchema: z.ZodOptional<z.ZodString>;
+            stateCatalogId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>>;
         linkTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -5085,7 +5269,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             to: z.ZodString;
             cardinality: z.ZodOptional<z.ZodString>;
             via: z.ZodOptional<z.ZodString>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
         actionTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -5095,7 +5279,11 @@ declare const OrganizationModelSchema: z.ZodObject<{
             actsOn: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
             input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             effects: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-        }, z.core.$loose>>>>;
+            resourceId: z.ZodOptional<z.ZodString>;
+            invocations: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+            lifecycle: z.ZodOptional<z.ZodString>;
+            legacyActionId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>>;
         catalogTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -5105,7 +5293,10 @@ declare const OrganizationModelSchema: z.ZodObject<{
             kind: z.ZodOptional<z.ZodString>;
             appliesTo: z.ZodOptional<z.ZodString>;
             entries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$loose>>>>;
+            legacyCatalogKey: z.ZodOptional<z.ZodString>;
+            legacyPipelineKey: z.ZodOptional<z.ZodString>;
+            legacyEntityKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>>;
         eventTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -5113,7 +5304,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             ownerSystemId: z.ZodOptional<z.ZodString>;
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
         interfaceTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -5121,7 +5312,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             ownerSystemId: z.ZodOptional<z.ZodString>;
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
         valueTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -5129,7 +5320,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             ownerSystemId: z.ZodOptional<z.ZodString>;
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             primitive: z.ZodOptional<z.ZodString>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
         sharedProperties: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -5139,7 +5330,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             valueType: z.ZodOptional<z.ZodString>;
             searchable: z.ZodOptional<z.ZodBoolean>;
             pii: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
         groups: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -5147,7 +5338,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             ownerSystemId: z.ZodOptional<z.ZodString>;
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             members: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
         endpoints: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -5155,7 +5346,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             ownerSystemId: z.ZodOptional<z.ZodString>;
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             route: z.ZodOptional<z.ZodString>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
     }, z.core.$strict>>>;
     resources: z.ZodDefault<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodString;
@@ -6241,6 +6432,17 @@ interface PermissionDescriptor {
     isOrgGrantable: boolean;
 }
 
+declare const AccessKeyInputSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    systemPath: z.ZodString;
+    action: z.ZodDefault<z.ZodEnum<{
+        view: "view";
+        manage: "manage";
+    }>>;
+}, z.core.$strict>]>;
+type AccessKeyInput = z.input<typeof AccessKeyInputSchema>;
+
+type AccessReason = 'allowed' | 'platform-admin-bypass' | 'invalid-access-key' | 'unknown-access-key' | 'organization-mismatch' | 'missing-membership' | 'system-not-active' | 'role-permission-denied' | 'diagnostic-key-not-allowed';
+
 /**
  * Deployment types — browser-safe
  *
@@ -6277,6 +6479,39 @@ declare const ListCredentialsResponseSchema: z.ZodObject<{
 /** API response type for a single credential list item */
 type CredentialListItem = z.infer<typeof ListCredentialsResponseSchema>['credentials'][number];
 
+/**
+ * Storage-neutral file descriptor.
+ *
+ * Dropbox and Google Drive (the foreseeable second provider) both ship
+ * their own file/metadata shapes. Consumers on both sides of the wire —
+ * a UI file browser and the API route that talks to the provider — need
+ * to agree on one normalized shape, which is why it lives here instead
+ * of being duplicated in each consumer.
+ *
+ * Adapters (`createDropboxAdapter`, a future Drive adapter) stay concrete
+ * and keep their own provider-shaped responses. Normalization into this
+ * type happens at the route/hook boundary — a few lines per provider,
+ * not behind a shared `CloudStorageAdapter` interface.
+ */
+interface CloudStorageFile {
+    id: string;
+    name: string;
+    kind: 'file' | 'folder';
+    path?: string;
+    mimeType?: string;
+    sizeBytes?: number;
+    width?: number;
+    height?: number;
+    /** ISO 8601 timestamp the asset was captured (e.g. photo EXIF date), when the provider exposes one. */
+    capturedAt?: string;
+    /**
+     * Optional on purpose. Dropbox does not produce a thumbnail for HEIC or
+     * for anything over 20 MB — "no thumbnail" is a normal state a consumer
+     * renders a fallback for, not an error.
+     */
+    thumbnailUrl?: string;
+}
+
 type PermissionRow = PermissionDescriptor;
 type Props = {
     catalog: PermissionRow[];
@@ -6734,6 +6969,26 @@ interface FeatureUnavailableStateProps {
 }
 declare function FeatureUnavailableState({ path }: FeatureUnavailableStateProps): react_jsx_runtime.JSX.Element;
 
+interface SystemUnavailableStateProps {
+    /** The access key the guard evaluated -- used to resolve the System's id, label, and lifecycle. */
+    accessKey: AccessKeyInput;
+    /** The denial reason returned by `checkAccess` / `useAccess`. */
+    reason: AccessReason;
+}
+/**
+ * Route-level denial state for a System `AccessGuard`. Unlike the guard's own
+ * `fallback = null` default (never changed -- see access-model.ts), this
+ * component turns the specific {@link AccessReason} `checkAccess` already
+ * computed into a message that names the System instead of rendering a blank
+ * pane. `unknown-access-key` and `system-not-active` get a dedicated message
+ * because they are configuration problems (the System isn't declared, or
+ * isn't in an accessible lifecycle state) rather than a per-user permission
+ * gap; every other denial reason falls through to the shared
+ * {@link NoAccessState}, which already covers "you personally can't see
+ * this."
+ */
+declare function SystemUnavailableState({ accessKey, reason }: SystemUnavailableStateProps): react_jsx_runtime.JSX.Element;
+
 interface ResourceCardProps {
     resource: ResourceDefinition;
     onClick: (resource: ResourceDefinition) => void;
@@ -6803,6 +7058,63 @@ interface ActivityTimelineProps {
 }
 declare function ActivityTimeline({ activities }: ActivityTimelineProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * The structured 503 payload a System Interface readiness failure carries
+ * (`APIErrorResponse.details` shape produced by `createInterfaceReadinessApiError`
+ * in `apps/api/src/platform/organization-model/interface-readiness.ts`). Pass
+ * this when a caller catches a server-side readiness failure rather than
+ * computing readiness from the local Organization Model.
+ *
+ * `readinessCode: 'STALE_OM_SNAPSHOT'` is the one family the server already
+ * turns into an actionable redeploy message; this alert renders that same
+ * hint from the structured field rather than depending on parsed message text.
+ */
+interface SystemReadinessServerErrorDetails {
+    systemPath: string;
+    interfaceKey: string;
+    readinessProfile?: string;
+    readinessCode: SystemInterfaceReadinessIssueFamily;
+    issues: SystemInterfaceReadinessIssue[];
+}
+interface SystemReadinessAlertProps {
+    /**
+     * Whether the System's API interface readiness check has passed. Renders
+     * nothing when `true` and no `serverError` is supplied.
+     */
+    ready: boolean;
+    /**
+     * Label for what is disabled while readiness has not passed, e.g.
+     * "Lead-gen API actions". Used to build the default message.
+     */
+    actionLabel: string;
+    /**
+     * Optional note appended after the disabled-actions message describing
+     * what still works, e.g. "Read-only list detail can still render when
+     * data is available."
+     */
+    fallbackNote?: string;
+    /**
+     * Reason string from a local (client-side) readiness computation, e.g.
+     * `useLeadGenConfig().leadGenApiInterface.reason`.
+     */
+    reason?: string;
+    /**
+     * Structured 503 payload from a server-side readiness failure. When
+     * provided, its `issues[]` render as a list and its redeploy hint (for
+     * `STALE_OM_SNAPSHOT`) renders below them.
+     */
+    serverError?: SystemReadinessServerErrorDetails;
+}
+/**
+ * Displays a warning alert when a System's API interface readiness check has
+ * not passed. Generalized from the lead-gen-only `LeadGenReadinessAlert` so
+ * any System can reuse the same rendering for both a local-model readiness
+ * failure (`reason`) and a structured server 503 (`serverError`).
+ *
+ * Renders nothing when `ready` is `true` and no `serverError` is supplied.
+ */
+declare function SystemReadinessAlert({ ready, actionLabel, fallbackNote, reason, serverError }: SystemReadinessAlertProps): react_jsx_runtime.JSX.Element | null;
+
 interface ICustomModalProps {
     opened: boolean;
     onClose: () => void;
@@ -8433,6 +8745,162 @@ declare const DEAL_STAGES: DealStage[];
 /** Default Mantine color mapping for each deal stage. */
 declare const DEFAULT_KANBAN_CONFIG: KanbanBoardConfig;
 
+/** Per-file display flags the consumer computes. Both optional; both purely visual. */
+interface CloudStorageItemDecoration {
+    /** Renders the card's "used" badge -- e.g. this file already backs a content item. */
+    used?: boolean;
+    /** Renders a warning affordance on the card, e.g. "below the minimum postable size". */
+    dimensionWarning?: string;
+}
+interface CloudStorageBrowserProps {
+    /** Which connected cloud-storage credential to browse. */
+    credentialName: string;
+    /**
+     * The current selection, in the consumer's own order. The browser preserves
+     * that order and appends newly-picked files to the end -- ordering is the
+     * consumer's concern (a carousel cares; a single-file picker does not).
+     */
+    selected: CloudStorageFile[];
+    /** Fired with the full next selection whenever a tile is toggled. */
+    onSelectionChange: (files: CloudStorageFile[]) => void;
+    /** When false (default), picking a file replaces the selection. */
+    multiple?: boolean;
+    /**
+     * Supplies per-file display flags. Called for every visible file. Keep it
+     * cheap and pure -- it runs on each render of the grid.
+     *
+     * This is the seam that keeps the browser storage-only: "already used" and
+     * "too small to post" are both facts about the CONSUMER's domain, not about
+     * storage, so the browser renders them without knowing what they mean.
+     */
+    decorateItem?: (file: CloudStorageFile) => CloudStorageItemDecoration;
+    /** Replaces the default "not connected" panel. */
+    notConnected?: ReactNode;
+}
+/**
+ * A browsable, selectable view of one cloud-storage account.
+ *
+ * Composes the three presentational pieces (`CloudStorageFolderTree`,
+ * `CloudStorageFileGrid`, `CloudStorageFileCard`) with the fetching and
+ * bookkeeping that every storage-backed screen otherwise reimplements: lazy
+ * folder-tree accumulation, cursor paging, thumbnail batching, and a selection
+ * that survives navigating between folders.
+ *
+ * It is deliberately storage-only. It knows nothing about content items, source
+ * assets, or what a selection is *for* -- the consumer receives the selected
+ * files and decides. That boundary is why the same component serves a carousel
+ * builder, a knowledge-document importer, and a single-file picker.
+ *
+ * **The folder tree is built from what browsing has revealed, not fetched whole.**
+ * `list_folder` returns one level at a time and there is no "list every folder"
+ * call, so a folder enters the tree the first time it appears in a listing,
+ * parented to whatever folder was open when it did. The tree therefore grows as
+ * you explore. This is also why `CloudStorageFolderTree` takes a flat,
+ * parent-referencing node list rather than a nested one -- a nested shape cannot
+ * express a subtree discovered before its parent.
+ */
+declare function CloudStorageBrowser({ credentialName, selected, onSelectionChange, multiple, decorateItem, notConnected }: CloudStorageBrowserProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element;
+
+interface CloudStorageFileCardProps {
+    /** Storage-neutral file descriptor to render. */
+    file: CloudStorageFile;
+    /** Whether this card is currently selected. Omit to render without a checkbox affordance. */
+    selected?: boolean;
+    /** Marks the file as already used by the consuming feature (e.g. attached to a campaign asset). */
+    used?: boolean;
+    /**
+     * Warning message to surface when this file's dimensions are unsuitable for the
+     * consumer's use case. The card only renders the affordance the caller supplies —
+     * the aspect-ratio / minimum-resolution rule itself is the consuming tenant's, not
+     * this package's, so pass a message only when `file.width`/`file.height` are present
+     * and the caller has already judged them problematic.
+     */
+    dimensionWarning?: string;
+    /** Fired when the card (or its checkbox) is activated. Omit to render a read-only tile. */
+    onSelect?: (file: CloudStorageFile) => void;
+}
+/**
+ * A single cloud-storage file/folder tile: thumbnail, used/unused badge, dimension
+ * warning, and a no-thumbnail fallback.
+ *
+ * Purely presentational -- no fetching, no data-layer coupling. `file.thumbnailUrl`
+ * missing is a normal state (Dropbox skips thumbnail conversion for HEIC and for
+ * anything over 20 MB), not an error, so the fallback tile below is not a broken-image
+ * placeholder -- it is a first-class rendering path.
+ */
+declare function CloudStorageFileCard({ file, selected, used, dimensionWarning, onSelect }: CloudStorageFileCardProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * A `CloudStorageFile` plus optional per-item display flags a consumer computes
+ * upstream (already-used state, a dimension-warning message). Kept on the item
+ * itself rather than as a second lookup-map prop -- the grid stays a pure
+ * pass-through and every `CloudStorageFile[]` is already a valid
+ * `CloudStorageGridItem[]` since both extra fields are optional.
+ */
+interface CloudStorageGridItem extends CloudStorageFile {
+    used?: boolean;
+    dimensionWarning?: string;
+}
+interface CloudStorageFileGridProps {
+    /** Files (and/or folders) to render as tiles. */
+    items: CloudStorageGridItem[];
+    /** Ids of the currently selected items. */
+    selectedIds: string[];
+    /** When false (default), selecting an item replaces the selection with just that item. When true, selection accumulates. */
+    multiple?: boolean;
+    /** Fired with the full next selection whenever an item is toggled. */
+    onSelectionChange: (selectedIds: string[]) => void;
+    /** Rendered instead of the grid when `items` is empty. */
+    emptyState?: ReactNode;
+}
+/**
+ * A selectable grid of cloud-storage file tiles.
+ *
+ * Purely presentational -- data comes in via `items`, selection goes out via
+ * `onSelectionChange`. No fetching, no hook imports.
+ */
+declare function CloudStorageFileGrid({ items, selectedIds, multiple, onSelectionChange, emptyState }: CloudStorageFileGridProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element;
+
+/**
+ * A folder in a cloud-storage tree, addressed by parent references rather than
+ * a single nested `children` structure.
+ *
+ * Deliberately flat + multi-parent: Google Drive folders can have more than one
+ * parent and shared drives sit outside the user's own root, so the tree needs
+ * more than one root and more than one parent for a single node from day one.
+ * A nested single-parent shape would have to be rewritten, not extended, once
+ * Drive is wired up.
+ */
+interface CloudStorageFolderNode {
+    id: string;
+    name: string;
+    /** Ids of the folders this node is nested under. Omitted or empty marks a root. */
+    parentIds?: string[];
+    /**
+     * Storage-neutral location string matched against `selectedPath`. Dropbox
+     * supplies a real folder path; providers without one (Drive) can synthesize
+     * any stable string here.
+     */
+    path?: string;
+}
+interface CloudStorageFolderTreeProps {
+    /** Flat list of all folders. Roots and multi-parent nodes are derived from `parentIds`. */
+    nodes: CloudStorageFolderNode[];
+    /** `path` of the currently active folder, if any. */
+    selectedPath?: string;
+    /** Fired with the activated node. */
+    onNavigate: (node: CloudStorageFolderNode) => void;
+}
+/**
+ * Renders a cloud-storage folder tree from a flat, parent-referencing node list.
+ *
+ * Purely presentational -- no fetching. A node with more than one parent is
+ * rendered once per parent branch (the same folder legitimately appears in more
+ * than one place), and a defensive visited-chain guard keeps a malformed cyclic
+ * `parentIds` graph from infinite-looping the render.
+ */
+declare function CloudStorageFolderTree({ nodes, selectedPath, onNavigate }: CloudStorageFolderTreeProps): react_jsx_runtime.JSX.Element;
+
 interface CrmSidebarProps {
     /** Replace the default `CrmSidebarMiddle` with custom middle content. Leave unset for the default layout. */
     children?: ReactNode;
@@ -8851,5 +9319,5 @@ declare const OperationsSidebarMiddle: () => react_jsx_runtime.JSX.Element;
 
 declare const operationsManifest: SystemModule;
 
-export { APIErrorAlert, AbsoluteScheduleForm, ActionModal, ActivityCard, ActivityFeedWidget, ActivityFilters as ActivityFiltersBar, ActivityTable, ActivityTimeline, AgentDefinitionDisplay, AgentExecutionLogs, AgentExecutionTimeline, AgentExecutionVisualizer, AgentIterationDetailPanel, AgentIterationEdge, AgentIterationNode, AllTasksPage, ApiKeyDisplayModal, ApiKeyList, ApiKeySettings, AppErrorBoundary, BaseEdge, BaseExecutionLogs, BaseExecutionLogsHeader, BaseExecutionLogsStates, BaseNode, Breadcrumbs, BusinessImpactCard, CONTAINER_CONSTANTS, CardHeader, CenteredErrorState, CheckpointGroup, CollapsibleJsonSection, CollapsibleSection, CommandQueueSidebar, CommandQueueSidebarMiddle, CommandQueueSidebarTop, CommandQueueTaskRow, CompanyDetailPage, ConfigCard, ConfirmationInputModal, ConfirmationModal, ContactDetailPage, ContentSections, ContextUsageBadge, ContextViewer, ContractDisplay, CostBreakdownCard, CostByModelTable, CostMetricsCard, CrashErrorFallback, CreateApiKeyModal, CreateCredentialModal, CreateRoleModal, CreateScheduleModal, CredentialList, CredentialSettings, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, CustomModal, CustomSelector, DEAL_STAGES, DEFAULT_KANBAN_CONFIG, DealDetailPage, DealKanbanCard, DealsListPage, DeleteScheduleModal, DeploymentDetailModal, DeploymentList, DeploymentSettings, DeploymentStatusBadge, DetailCardSkeleton, EditApiKeyModal, ElevasisLoader, EmptyState, EmptyVisualizer, ErrorAnalysisCard, ErrorBreakdownTable, ErrorReportCard, ExecutionBreakdownTable, ExecutionErrorSection, ExecutionHealthCard, ExecutionLogsFilters as ExecutionLogsFilterBar, ExecutionLogsTable, ExecutionStats, ExecutionStatusBadge, FeatureUnavailableState, FilterBar, GlowDot, GraphBackground, GraphContainer, GraphFitViewButton, GraphFitViewHandler, GraphLegend, HealthStatusCard, JsonViewer, KanbanBoard, LEAD_GEN_ROUTE_LINKS, LeadGenCompaniesPage, LeadGenContactsPage, LeadGenListDetailPage, LeadGenListsPage, LeadGenOverviewPage, LeadGenRouteShell, LeadGenSidebar, LeadGenSidebarMiddle, LeadGenSidebarTop, ListSkeleton, LogEntry, LogGroup, MdxRenderer, MembershipStatusBadge, MetricsStrip, MilestoneTimeline, MyTasksPanel, NavigationButton, NoAccessState, NotificationBell, NotificationItem, NotificationList, NotificationPanel, OAuthConnectModal, OperationsSidebar, OperationsSidebarMiddle, OperationsSidebarTop, OrganizationMembershipsList, OrganizationModelDriftActionIcon, PIPELINE_FUNNEL_ORDER, PageNotFound, PageTitleCaption, PermissionMatrix, PipelineFunnelWidget, ProjectDetailPage, ProjectsListPage, ProjectsSidebar, ProjectsSidebarMiddle, ProjectsSidebarTop, ProvisioningStateBadge, QuickCreateActions, RecurringScheduleForm, RelativeScheduleForm, ResourceCard, ResourceDefinitionSection, ResourceErrorState, ResourceFilter, ResourceHeader, ResourceHealthChart, ResourceHealthPanel, ResourceNotFoundState, RichTextEditor, RoleBadge, RunResourceButton, SAVED_VIEW_PRESETS, SEOSidebar, SEOSidebarMiddle, SEOSidebarTop, SHARED_VIZ_CONSTANTS, SavedViewsPanel, ScheduleCard, ScheduleDetailModal, ScheduleTypeSelector, SessionMemory, SortableHeader, StatCard, StatCardSkeleton, StatsCardSkeleton, StatusBadge, StepConfigForm, StyledMarkdown, TabCountBadge, TabSection, TableSelectionToolbar, TaskCard, TaskScheduler, TimeRangeSelector, TimelineAxis, TimelineBar, TimelineContainer, TimelineRow, ToolsListDisplay, TrendIndicator, UnifiedWorkflowEdge, UnifiedWorkflowGraph, UnifiedWorkflowNode, UpcomingMilestonesPage, VisualizerContainer, WebhookUrlDisplayModal, WorkflowDefinitionDisplay, WorkflowExecutionLogs, WorkflowExecutionTimeline, ZodFormRenderer, buildErrorReport, calculateProgress, crmManifest, deliveryManifest, formatStatusLabel, getEnrichmentColor, getExecutionStatusConfig, getGraphBackgroundStyles, getHealthColor, getIcon, getLogLevelConfig, getStatusColor, iconMap, leadGenManifest, mdxComponents, milestoneStatusColors, monitoringManifest, noteTypeColors, operationsManifest, projectStatusColors, seoManifest, settingsManifest, showApiErrorNotification, showAuthError, showErrorNotification, showInfoNotification, showSuccessNotification, showWarningNotification, taskStatusColors, taskTypeColors, useCrmPipelineSummary, useCrmQuickMetrics, useDeleteLists, useGraphBackgroundStyles, useGraphTheme, useRecentCrmActivity };
-export type { ActivityEntry, ActivityFiltersProps, ActivityTableProps, AgentIterationTotals, AppErrorBoundaryProps, BaseEdgeProps, BaseExecutionLogsProps, BreadcrumbsProps, CompanyDetailPageProps, ContactDetailPageProps, ContextViewerProps, CostByModelTableProps, CrashErrorFallbackProps, CreateRoleModalProps, CrmOverviewProps, DealKanbanCardProps, ErrorAnalysisCardProps, ErrorReportCardProps, ExecutionBreakdownTableProps, ExecutionHealthCardProps, ExecutionLogEntry, ExecutionLogsFiltersProps, ExecutionLogsTableProps, FeatureUnavailableStateProps, FieldPath, FitViewButtonVariant, GraphFitViewHandlerProps, JsonViewerProps, KanbanBoardProps, LogLevel, MdxRendererProps, NavigationButtonProps, PermissionRow, ProjectsSidebarMiddleProps, ResourceHealthPanelProps, RichTextEditorProps, RunResourceButtonProps, RunResourceInputResolver, SavedViewPreset, ScheduleType, StatCardProps, StepConfigComponent, StepConfigFieldHint, StepConfigFormProps, StepConfigLayout, StepConfigSection, StyledMarkdownProps, TabSectionProps, TaskFilterStatus, TrendIndicatorProps, ZodFormRendererProps };
+export { APIErrorAlert, AbsoluteScheduleForm, ActionModal, ActivityCard, ActivityFeedWidget, ActivityFilters as ActivityFiltersBar, ActivityTable, ActivityTimeline, AgentDefinitionDisplay, AgentExecutionLogs, AgentExecutionTimeline, AgentExecutionVisualizer, AgentIterationDetailPanel, AgentIterationEdge, AgentIterationNode, AllTasksPage, ApiKeyDisplayModal, ApiKeyList, ApiKeySettings, AppErrorBoundary, BaseEdge, BaseExecutionLogs, BaseExecutionLogsHeader, BaseExecutionLogsStates, BaseNode, Breadcrumbs, BusinessImpactCard, CONTAINER_CONSTANTS, CardHeader, CenteredErrorState, CheckpointGroup, CloudStorageBrowser, CloudStorageFileCard, CloudStorageFileGrid, CloudStorageFolderTree, CollapsibleJsonSection, CollapsibleSection, CommandQueueSidebar, CommandQueueSidebarMiddle, CommandQueueSidebarTop, CommandQueueTaskRow, CompanyDetailPage, ConfigCard, ConfirmationInputModal, ConfirmationModal, ContactDetailPage, ContentSections, ContextUsageBadge, ContextViewer, ContractDisplay, CostBreakdownCard, CostByModelTable, CostMetricsCard, CrashErrorFallback, CreateApiKeyModal, CreateCredentialModal, CreateRoleModal, CreateScheduleModal, CredentialList, CredentialSettings, CrmOverview, CrmSidebar, CrmSidebarMiddle, CrmSidebarTop, CustomModal, CustomSelector, DEAL_STAGES, DEFAULT_KANBAN_CONFIG, DealDetailPage, DealKanbanCard, DealsListPage, DeleteScheduleModal, DeploymentDetailModal, DeploymentList, DeploymentSettings, DeploymentStatusBadge, DetailCardSkeleton, EditApiKeyModal, ElevasisLoader, EmptyState, EmptyVisualizer, ErrorAnalysisCard, ErrorBreakdownTable, ErrorReportCard, ExecutionBreakdownTable, ExecutionErrorSection, ExecutionHealthCard, ExecutionLogsFilters as ExecutionLogsFilterBar, ExecutionLogsTable, ExecutionStats, ExecutionStatusBadge, FeatureUnavailableState, FilterBar, GlowDot, GraphBackground, GraphContainer, GraphFitViewButton, GraphFitViewHandler, GraphLegend, HealthStatusCard, JsonViewer, KanbanBoard, LEAD_GEN_ROUTE_LINKS, LeadGenCompaniesPage, LeadGenContactsPage, LeadGenListDetailPage, LeadGenListsPage, LeadGenOverviewPage, LeadGenRouteShell, LeadGenSidebar, LeadGenSidebarMiddle, LeadGenSidebarTop, ListSkeleton, LogEntry, LogGroup, MdxRenderer, MembershipStatusBadge, MetricsStrip, MilestoneTimeline, MyTasksPanel, NavigationButton, NoAccessState, NotificationBell, NotificationItem, NotificationList, NotificationPanel, OAuthConnectModal, OperationsSidebar, OperationsSidebarMiddle, OperationsSidebarTop, OrganizationMembershipsList, OrganizationModelDriftActionIcon, PIPELINE_FUNNEL_ORDER, PageNotFound, PageTitleCaption, PermissionMatrix, PipelineFunnelWidget, ProjectDetailPage, ProjectsListPage, ProjectsSidebar, ProjectsSidebarMiddle, ProjectsSidebarTop, ProvisioningStateBadge, QuickCreateActions, RecurringScheduleForm, RelativeScheduleForm, ResourceCard, ResourceDefinitionSection, ResourceErrorState, ResourceFilter, ResourceHeader, ResourceHealthChart, ResourceHealthPanel, ResourceNotFoundState, RichTextEditor, RoleBadge, RunResourceButton, SAVED_VIEW_PRESETS, SEOSidebar, SEOSidebarMiddle, SEOSidebarTop, SHARED_VIZ_CONSTANTS, SavedViewsPanel, ScheduleCard, ScheduleDetailModal, ScheduleTypeSelector, SessionMemory, SortableHeader, StatCard, StatCardSkeleton, StatsCardSkeleton, StatusBadge, StepConfigForm, StyledMarkdown, SystemReadinessAlert, SystemUnavailableState, TabCountBadge, TabSection, TableSelectionToolbar, TaskCard, TaskScheduler, TimeRangeSelector, TimelineAxis, TimelineBar, TimelineContainer, TimelineRow, ToolsListDisplay, TrendIndicator, UnifiedWorkflowEdge, UnifiedWorkflowGraph, UnifiedWorkflowNode, UpcomingMilestonesPage, VisualizerContainer, WebhookUrlDisplayModal, WorkflowDefinitionDisplay, WorkflowExecutionLogs, WorkflowExecutionTimeline, ZodFormRenderer, buildErrorReport, calculateProgress, crmManifest, deliveryManifest, formatStatusLabel, getEnrichmentColor, getExecutionStatusConfig, getGraphBackgroundStyles, getHealthColor, getIcon, getLogLevelConfig, getStatusColor, iconMap, leadGenManifest, mdxComponents, milestoneStatusColors, monitoringManifest, noteTypeColors, operationsManifest, projectStatusColors, seoManifest, settingsManifest, showApiErrorNotification, showAuthError, showErrorNotification, showInfoNotification, showSuccessNotification, showWarningNotification, taskStatusColors, taskTypeColors, useCrmPipelineSummary, useCrmQuickMetrics, useDeleteLists, useGraphBackgroundStyles, useGraphTheme, useRecentCrmActivity };
+export type { ActivityEntry, ActivityFiltersProps, ActivityTableProps, AgentIterationTotals, AppErrorBoundaryProps, BaseEdgeProps, BaseExecutionLogsProps, BreadcrumbsProps, CloudStorageBrowserProps, CloudStorageFileCardProps, CloudStorageFileGridProps, CloudStorageFolderNode, CloudStorageFolderTreeProps, CloudStorageGridItem, CloudStorageItemDecoration, CompanyDetailPageProps, ContactDetailPageProps, ContextViewerProps, CostByModelTableProps, CrashErrorFallbackProps, CreateRoleModalProps, CrmOverviewProps, DealKanbanCardProps, ErrorAnalysisCardProps, ErrorReportCardProps, ExecutionBreakdownTableProps, ExecutionHealthCardProps, ExecutionLogEntry, ExecutionLogsFiltersProps, ExecutionLogsTableProps, FeatureUnavailableStateProps, FieldPath, FitViewButtonVariant, GraphFitViewHandlerProps, JsonViewerProps, KanbanBoardProps, LogLevel, MdxRendererProps, NavigationButtonProps, PermissionRow, ProjectsSidebarMiddleProps, ResourceHealthPanelProps, RichTextEditorProps, RunResourceButtonProps, RunResourceInputResolver, SavedViewPreset, ScheduleType, StatCardProps, StepConfigComponent, StepConfigFieldHint, StepConfigFormProps, StepConfigLayout, StepConfigSection, StyledMarkdownProps, SystemReadinessAlertProps, SystemReadinessServerErrorDetails, SystemUnavailableStateProps, TabSectionProps, TaskFilterStatus, TrendIndicatorProps, ZodFormRendererProps };