@elevasis/ui 2.73.0 → 2.75.0

package/dist/{chunk-4CW2C5BD.js → chunk-SEYOVNS5.js}

@@ -1,4 +1,4 @@
-import { useCyberColors, useResourcesHealth, EmptyState, CyberLegendItem, CyberAreaChart } from './chunk-OCVSPAKM.js';
+import { useCyberColors, useResourcesHealth, EmptyState, CyberLegendItem, CyberAreaChart } from './chunk-SB3IHM5Y.js';
 import { CardHeader } from './chunk-62GVNH5U.js';
 import { getTimeRangeDates, formatBucketTime } from './chunk-Y6I3IC45.js';
 import { Paper, Center, Loader, Group } from '@mantine/core';

package/dist/chunk-SN7X5N2A.js

@@ -0,0 +1,116 @@
+import { showApiErrorNotification } from './chunk-ICHDIVQO.js';
+import { useElevasisServices } from './chunk-BI5VDO2K.js';
+import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
+
+// src/hooks/clients/queryKeys.ts
+var clientsKeys = {
+  all: ["clients"],
+  lists: () => [...clientsKeys.all, "list"],
+  list: (organizationId, filters) => [...clientsKeys.lists(), organizationId, filters],
+  statuses: () => [...clientsKeys.all, "status"],
+  status: (organizationId) => [...clientsKeys.statuses(), organizationId],
+  details: () => [...clientsKeys.all, "detail"],
+  detail: (organizationId, id) => [...clientsKeys.details(), organizationId, id]
+};
+function useClients(filters = {}) {
+  const { apiRequest, isReady, workOSOrganizationId } = useElevasisServices();
+  return useQuery({
+    queryKey: clientsKeys.list(workOSOrganizationId ?? void 0, filters),
+    queryFn: async () => {
+      const { status, source, search, limit, offset } = filters;
+      const params = new URLSearchParams();
+      if (status) params.set("status", status);
+      if (source) params.set("source", source);
+      if (search) params.set("search", search);
+      if (limit !== void 0) params.set("limit", String(limit));
+      if (offset !== void 0) params.set("offset", String(offset));
+      const query = params.toString();
+      return apiRequest(`/clients${query ? "?" + query : ""}`);
+    },
+    enabled: isReady
+  });
+}
+function useClientStatus() {
+  const { apiRequest, isReady, workOSOrganizationId } = useElevasisServices();
+  return useQuery({
+    queryKey: clientsKeys.status(workOSOrganizationId ?? void 0),
+    queryFn: async () => {
+      return apiRequest("/clients/status");
+    },
+    enabled: isReady
+  });
+}
+function useClient(clientId) {
+  const { apiRequest, isReady, workOSOrganizationId } = useElevasisServices();
+  return useQuery({
+    queryKey: clientsKeys.detail(workOSOrganizationId ?? void 0, clientId),
+    queryFn: async () => {
+      return apiRequest(`/clients/${clientId}`);
+    },
+    enabled: isReady && !!clientId
+  });
+}
+function useCreateClient() {
+  const { apiRequest } = useElevasisServices();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: async (data) => {
+      return apiRequest("/clients", {
+        method: "POST",
+        body: JSON.stringify(data)
+      });
+    },
+    onSuccess: () => {
+      void queryClient.invalidateQueries({ queryKey: clientsKeys.lists() });
+      void queryClient.invalidateQueries({ queryKey: clientsKeys.statuses() });
+    },
+    onError: (error) => {
+      console.error("Failed to create client:", error);
+      showApiErrorNotification(error);
+    }
+  });
+}
+function useUpdateClient() {
+  const { apiRequest, workOSOrganizationId } = useElevasisServices();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: async ({ clientId, updates }) => {
+      return apiRequest(`/clients/${clientId}`, {
+        method: "PATCH",
+        body: JSON.stringify(updates)
+      });
+    },
+    onSuccess: (_data, { clientId }) => {
+      void queryClient.invalidateQueries({ queryKey: clientsKeys.lists() });
+      void queryClient.invalidateQueries({
+        queryKey: clientsKeys.detail(workOSOrganizationId ?? void 0, clientId)
+      });
+      void queryClient.invalidateQueries({ queryKey: clientsKeys.statuses() });
+    },
+    onError: (error) => {
+      console.error("Failed to update client:", error);
+      showApiErrorNotification(error);
+    }
+  });
+}
+function useDeleteClient() {
+  const { apiRequest } = useElevasisServices();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: async (clientId) => {
+      await apiRequest(`/clients/${clientId}`, {
+        method: "DELETE"
+      });
+    },
+    onSuccess: () => {
+      void queryClient.invalidateQueries({ queryKey: clientsKeys.lists() });
+      void queryClient.invalidateQueries({ queryKey: clientsKeys.statuses() });
+    },
+    onError: (error) => {
+      console.error("Failed to delete client:", error);
+      showApiErrorNotification(error);
+    }
+  });
+}
+
+export { clientsKeys, useClient, useClientStatus, useClients, useCreateClient, useDeleteClient, useUpdateClient };

package/dist/{chunk-PQ4B62HH.js → chunk-TX3UHDL5.js}

@@ -1,5 +1,5 @@
-import { getLeadGenStageCatalog } from './chunk-OCVSPAKM.js';
-import { SYSTEM_INTERFACE_PROFILES, formatOntologyId, registerBuiltInReadinessProfile, registerReadinessInterfaceMarker, requireContractReadiness, computeInterfaceReadiness, addReadinessIssue, formatInterfaceIdentity, resourceBindingIds, requireCatalogReadiness, requireScopedBinding } from './chunk-IBCEAVB2.js';
+import { getLeadGenStageCatalog } from './chunk-SB3IHM5Y.js';
+import { SYSTEM_INTERFACE_PROFILES, formatOntologyId, registerBuiltInReadinessProfile, registerReadinessInterfaceMarker, requireContractReadiness, computeInterfaceReadiness, addReadinessIssue, formatInterfaceIdentity, resourceBindingIds, requireCatalogReadiness, requireScopedBinding } from './chunk-A2SB32YV.js';
 
 // ../core/src/business/acquisition/ontology-validation.ts
 var LEAD_GEN_API_INTERFACE = SYSTEM_INTERFACE_PROFILES[0];

package/dist/chunk-VM2OWOXL.js

@@ -0,0 +1,24 @@
+import { UuidSchema } from './chunk-TVTSASST.js';
+import { z } from 'zod';
+
+var NotificationCategorySchema = z.enum(["info", "queue", "alert", "error", "system"]);
+var GetNotificationsQuerySchema = z.object({
+  limit: z.coerce.number().int().min(1).max(100).default(50),
+  offset: z.coerce.number().int().min(0).default(0)
+});
+var MarkAsReadParamsSchema = z.object({
+  id: UuidSchema
+});
+z.object({
+  userId: UuidSchema,
+  organizationId: UuidSchema,
+  category: NotificationCategorySchema,
+  title: z.string().trim().min(1).max(200),
+  message: z.string().trim().min(1).max(1e3),
+  actionUrl: z.string().url().optional()
+}).strict();
+z.object({
+  ids: z.array(UuidSchema).min(1).max(500)
+}).strict();
+
+export { GetNotificationsQuerySchema, MarkAsReadParamsSchema };

package/dist/{chunk-ZDKPHFTH.js → chunk-VWGCURZF.js}

@@ -1,13 +1,15 @@
+import { useScheduledTasks } from './chunk-N6K2Q5BM.js';
 import { ZodFormRenderer } from './chunk-3MEXPLWT.js';
 import { ResourceHealthChart } from './chunk-LGKLC5MG.js';
+import { useTimeRangeDates } from './chunk-YQQ5GRUR.js';
 import { Graph_module_css_default, useDirectedChainHighlighting, useNodeSelection, useFitViewTrigger } from './chunk-HENXLGVD.js';
-import { AppShellCenteredContainer, AppShellLoader } from './chunk-3TS5U5BL.js';
-import { useCyberColors, GlowDot, JsonViewer, useExecuteResource, EmptyState, useDashboardMetrics, useResources, useTimeRangeDates, useUnresolvedErrors, useRecentExecutionsByResource, PageTitleCaption, HeroStatsRow, useCommandQueue, useScheduledTasks, TabCountBadge, useResourcesHealth } from './chunk-OCVSPAKM.js';
+import { AppShellCenteredContainer, AppShellLoader } from './chunk-5RH6NYZH.js';
+import { useCyberColors, GlowDot, JsonViewer, useExecuteResource, EmptyState, useDashboardMetrics, useResources, useUnresolvedErrors, useRecentExecutionsByResource, PageTitleCaption, HeroStatsRow, useCommandQueue, TabCountBadge, useResourcesHealth } from './chunk-SB3IHM5Y.js';
 import { glassBase } from './chunk-R6NMRXNO.js';
 import { CardHeader } from './chunk-62GVNH5U.js';
 import { useInitialization } from './chunk-P45GQ3ZW.js';
 import { STATUS_COLORS, getStatusIcon, formatDuration, getStatusColors, AGENT_CONSTANTS, shouldAnimateEdge, TIMELINE_CONSTANTS, calculateBarPosition, CONTAINER_CONSTANTS, useExecutionPath, useUnifiedWorkflowLayout, WORKFLOW_CONSTANTS, useReactFlowAgent } from './chunk-BLXJEIQS.js';
-import { formatTimeAgo, formatRelativeTime } from './chunk-IBCEAVB2.js';
+import { formatTimeAgo, formatRelativeTime } from './chunk-A2SB32YV.js';
 import { getTimeRangeDates } from './chunk-Y6I3IC45.js';
 import { ResourceStatusColors } from './chunk-6SSQGWK7.js';
 import { memo, useMemo, useEffect, useState, useCallback, Fragment } from 'react';

package/dist/chunk-WDBNW44Z.js

@@ -0,0 +1,49 @@
+import { useState, useMemo, useEffect, useCallback } from 'react';
+
+// src/hooks/table/useTableSelection.ts
+function useTableSelection(items, allItems) {
+  const [selectedIds, setSelectedIds] = useState(/* @__PURE__ */ new Set());
+  const pageIds = useMemo(() => new Set(items.map((i) => i.id)), [items]);
+  useEffect(() => {
+    setSelectedIds((prev) => {
+      const validIds = allItems ? new Set(allItems.map((i) => i.id)) : pageIds;
+      const next = new Set([...prev].filter((id) => validIds.has(id)));
+      return next.size === prev.size ? prev : next;
+    });
+  }, [allItems, pageIds]);
+  const toggle = useCallback((id) => {
+    setSelectedIds((prev) => {
+      const next = new Set(prev);
+      if (next.has(id)) next.delete(id);
+      else next.add(id);
+      return next;
+    });
+  }, []);
+  const togglePage = useCallback(() => {
+    setSelectedIds((prev) => {
+      const allPageSelected = items.every((i) => prev.has(i.id));
+      const next = new Set(prev);
+      if (allPageSelected) {
+        for (const item of items) next.delete(item.id);
+      } else {
+        for (const item of items) next.add(item.id);
+      }
+      return next;
+    });
+  }, [items]);
+  const clear = useCallback(() => setSelectedIds(/* @__PURE__ */ new Set()), []);
+  const isPageAllSelected = items.length > 0 && items.every((i) => selectedIds.has(i.id));
+  const isPagePartiallySelected = !isPageAllSelected && items.some((i) => selectedIds.has(i.id));
+  return {
+    selectedIds,
+    toggle,
+    togglePage,
+    clear,
+    isPageAllSelected,
+    isPagePartiallySelected,
+    selectedCount: selectedIds.size,
+    isSelected: (id) => selectedIds.has(id)
+  };
+}
+
+export { useTableSelection };

package/dist/chunk-YQQ5GRUR.js

@@ -0,0 +1,21 @@
+import { useMemo } from 'react';
+
+// src/hooks/useTimeRangeDates.ts
+var RANGE_MS = {
+  "1h": 60 * 60 * 1e3,
+  "24h": 24 * 60 * 60 * 1e3,
+  "7d": 7 * 24 * 60 * 60 * 1e3,
+  "30d": 30 * 24 * 60 * 60 * 1e3
+};
+function useTimeRangeDates(timeRange) {
+  return useMemo(() => {
+    const now = /* @__PURE__ */ new Date();
+    const start = new Date(now.getTime() - RANGE_MS[timeRange]);
+    return {
+      startDate: start.toISOString(),
+      endDate: now.toISOString()
+    };
+  }, [timeRange]);
+}
+
+export { useTimeRangeDates };

package/dist/{chunk-NHNTX6ZL.js → chunk-ZG6YJUT4.js}

@@ -1,5 +1,5 @@
 import { OrganizationContext } from './chunk-DD3CCMCZ.js';
-import { APIClientError } from './chunk-IBCEAVB2.js';
+import { APIClientError } from './chunk-A2SB32YV.js';
 import { createContext, useContext, useMemo, useCallback } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
@@ -124,7 +124,8 @@ function useApiClient(apiUrl) {
         response.status,
         errorData.requestId,
         errorData.fields,
-        errorData.retryAfter
+        errorData.retryAfter,
+        errorData.details
       );
     },
     [onError]

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;
@@ -4709,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>;
@@ -5855,6 +5952,20 @@ interface OAuthState {
     timestamp: number;
     credentialName: string;
     provider: string;
+    /**
+     * Origin of the app that started this flow (e.g. 'https://app.contemplativerecords.com').
+     *
+     * Validated against the platform allowed-origins list in `authorizeHandler`
+     * BEFORE it is sealed into the signed state, so the callback can hand it to
+     * the callback page without re-checking. Every app that renders the OAuth
+     * card runs on its own origin, and the callback page is served from a single
+     * deploy-global one — it cannot read `window.opener.location.origin` across
+     * that boundary, so the origin has to travel with the flow.
+     *
+     * Optional so a state issued before this field existed still decodes; the
+     * callback falls back to `FRONTEND_URL` when it is absent.
+     */
+    appOrigin?: string;
 }
 
 /**
@@ -6290,12 +6401,16 @@ interface Activity {
  *   - UI access checks (via useAccess() permission-backed AccessKeys)
  *
  * The DB table `org_rol_permissions` mirrors this constant. There is no
- * runtime reconciler; parity is enforced two ways:
+ * runtime reconciler and no automated CI gate enforcing parity — it is
+ * maintained by discipline:
  *   1. Each migration that adds/removes/modifies a permission must INSERT
  *      (or UPDATE / DELETE) the corresponding `org_rol_permissions` row in
  *      the same transaction.
  *   2. `apps/api/src/auth/multi-tenancy/__tests__/permissions-catalog-sync.integration.test.ts`
- *      asserts the TS catalog and the DB rows agree; CI fails on drift.
+ *      checks TS/DB agreement, but it never runs in CI (filtered out by
+ *      vitest.config.ts, and it self-skips via skipIf even if it did run).
+ *      Run it locally against a real dev Supabase instead:
+ *      `pnpm -C apps/api test:integration` with SUPABASE_SERVICE_KEY set.
  *
  * Adding a permission:
  *   1. Add an entry below.
@@ -6335,6 +6450,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
  *
@@ -6861,6 +6987,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;
@@ -6930,6 +7076,65 @@ 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.
+ *
+ * The alert renders a remedy for whichever family came back, read from the
+ * structured field rather than parsed out of message text. Until 2026-08-23 it
+ * rendered one only for `STALE_OM_SNAPSHOT`, so every other failure — including
+ * `MODEL_PARSE_FAILED`, whose fix is the same redeploy — showed bare issue text
+ * with no next step.
+ */
+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 the remedy for its first
+     * issue 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;
@@ -8420,10 +8625,16 @@ interface EditApiKeyModalProps {
 declare function EditApiKeyModal({ apiKey, onClose }: EditApiKeyModalProps): react_jsx_runtime.JSX.Element | null;
 
 interface CredentialSettingsProps {
-    /** Optional slot for rendering an OAuth integrations section above the credentials list */
+    /**
+     * Override for the OAuth integrations section above the credentials list.
+     *
+     * Omit it to get `OAuthIntegrationsCard`, which is what every app wants — it
+     * reads the API URL from the service context, so there is nothing to wire.
+     * Pass `null` to hide the section, or a node to render something else.
+     */
     oauthSection?: React.ReactNode;
 }
-declare function CredentialSettings({ oauthSection }: CredentialSettingsProps): react_jsx_runtime.JSX.Element;
+declare function CredentialSettings({ oauthSection }?: CredentialSettingsProps): react_jsx_runtime.JSX.Element;
 
 interface CredentialListProps {
     credentials: CredentialListItem[];
@@ -8450,6 +8661,17 @@ interface OAuthConnectModalProps {
 }
 declare function OAuthConnectModal({ opened, onClose, provider, onConnect, error, isLoading }: OAuthConnectModalProps): react_jsx_runtime.JSX.Element;
 
+interface OAuthIntegrationsCardProps {
+    /**
+     * Base API URL used to construct the OAuth authorize endpoint.
+     *
+     * Optional: defaults to the `apiUrl` on the service context, which every app
+     * already supplies at startup. Pass it explicitly only to override.
+     */
+    apiUrl?: string;
+}
+declare function OAuthIntegrationsCard({ apiUrl }?: OAuthIntegrationsCardProps): react_jsx_runtime.JSX.Element;
+
 declare function DeploymentSettings(): react_jsx_runtime.JSX.Element;
 
 interface DeploymentListProps {
@@ -9134,5 +9356,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, 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, 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, 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, OAuthIntegrationsCard, 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, OAuthIntegrationsCardProps, PermissionRow, ProjectsSidebarMiddleProps, ResourceHealthPanelProps, RichTextEditorProps, RunResourceButtonProps, RunResourceInputResolver, SavedViewPreset, ScheduleType, StatCardProps, StepConfigComponent, StepConfigFieldHint, StepConfigFormProps, StepConfigLayout, StepConfigSection, StyledMarkdownProps, SystemReadinessAlertProps, SystemReadinessServerErrorDetails, SystemUnavailableStateProps, TabSectionProps, TaskFilterStatus, TrendIndicatorProps, ZodFormRendererProps };