@graph8/sdk 0.370.0 → 0.373.0

package/blocks/inbox/block.json

@@ -21,8 +21,10 @@
     "get_reply_inbox__reply_id__get",
     "list_inbox_inbox_get",
     "list_inbox_linkedin_accounts_inbox_linkedin_accounts_get",
+    "list_inbox_mailboxes_inbox_mailboxes_get",
     "list_inbox_users_inbox_users_get",
     "list_sms_phone_numbers_sms_phone_numbers_get",
+    "search_inbox_emails_inbox_emails_search_post",
     "send_reply_inbox__reply_id__send_post",
     "tag_reply_inbox__reply_id__tag_post"
   ],
@@ -94,6 +96,19 @@
       "purpose": "Small status pill shared by the thread view and tag panel.",
       "operations": [],
       "tiers": []
+    },
+    {
+      "name": "RecordConversationsTab",
+      "file": "components/record-conversations-tab.tsx",
+      "purpose": "The email conversations with one contact (matched by address), with Load more and a calm answer for a thread that 404s; an extraDetailTabs entry for ContactsScreen.",
+      "operations": [
+        "list_inbox_mailboxes_inbox_mailboxes_get",
+        "search_inbox_emails_inbox_emails_search_post",
+        "get_reply_inbox__reply_id__get"
+      ],
+      "tiers": [
+        "read"
+      ]
     }
   ],
   "hooks": [

package/blocks/inbox/components/record-conversations-tab.tsx

@@ -0,0 +1,154 @@
+"use client";
+
+/**
+ * RecordConversationsTab: the email conversations with one contact, newest first, "Load more" for older ones. Opening a row
+ * shows its messages. Use it as an `extraDetailTabs` entry of ContactsScreen:
+ *   { id: "conversations", label: "Conversations", render: (c) => <RecordConversationsTab email={c.work_email} onOpenThread={(sel) => router.push(`/inbox?id=${sel}`)} /> }
+ *
+ * SDK operations, in order:
+ *   1. listInboxMailboxes  GET  /inbox/mailboxes                          (read; the mailboxes this key can read: search requires them)
+ *   2. searchInboxEmails   POST /inbox/emails/search?page=&page_size=     (read; body `{ mailboxes, search_emails: [email] }`, 10 per page)
+ *   3. getReply            GET  /inbox/{id}?channel=email                 (read; only when a row is opened)
+ * The inbox has no filter by contact id, so the contact is matched by email address (sender or recipient): `email` plus any
+ * `alsoEmails`. A contact with no usable address has no conversations to show. SMS and LinkedIn threads are not matched here.
+ *
+ * Hidden threads: the API answers a thread the key may not see exactly like one that does not exist (404, the same text).
+ * A row that 404s on open says "not available to you" instead of an error with a retry button.
+ */
+
+import { useState } from "react";
+import { Button, Skeleton } from "@graph8/sdk/ui";
+import { MessagesSquare } from "lucide-react";
+import { ApiError } from "@/g8/components/api-error";
+import { EmptyState } from "@/g8/components/empty-state";
+import { useG8Query } from "@/g8/hooks/use-g8-query";
+import { usePaginated } from "@/g8/hooks/use-paginated";
+import { g8Get, g8Post } from "@/g8/lib/g8-client";
+import { useInboxThread } from "../hooks/use-inbox-thread";
+import { formatWhen, stripHtml, type InboxMessage } from "../lib/inbox-types";
+
+const PAGE_SIZE = 10;
+
+/** One thread of POST /inbox/emails/search. Only the fields shown here are read; all are optional. */
+interface FoundThread { id?: string | number | null; email_id?: string | number | null; subject?: string | null; updated_at?: string | null; created_at?: string | null; status?: string | null; messages?: InboxMessage[] | null }
+
+const idOf = (t: FoundThread): string => String(t.id ?? t.email_id ?? "");
+const statusOf = (e: unknown): number | undefined => (e as { status?: number } | null)?.status;
+
+/** Mailbox addresses from GET /inbox/mailboxes (rows are mailbox records; the address is `email`). */
+function mailboxAddresses(env: unknown): string[] {
+  const data = (env as { data?: unknown } | null)?.data;
+  const rows = Array.isArray(data) ? data : ((data as { items?: unknown } | null)?.items ?? []);
+  const out = new Set<string>();
+  for (const r of Array.isArray(rows) ? rows : []) {
+    const row = r as { email?: string | null; mailbox?: string | null };
+    const address = (row.email ?? row.mailbox ?? "").trim();
+    if (address) out.add(address);
+  }
+  return [...out];
+}
+
+function Opened({ id }: { id: string }) {
+  const t = useInboxThread(id, "email");
+  if (t.error) {
+    return statusOf(t.error) === 404
+      ? <p role="status" className="p-3 text-sm text-muted-foreground">This conversation is not available to you. It may have been removed, or it belongs to a mailbox you cannot read.</p>
+      : <div className="p-3"><ApiError error={t.error} title="Could not load this conversation" onRetry={() => void t.refetch()} /></div>;
+  }
+  if (!t.data) return <Skeleton className="m-3 h-16 w-auto" aria-label="Loading conversation" />;
+  const messages = t.data.messages.filter((m) => !m.is_draft);
+  if (messages.length === 0) return <p className="p-3 text-sm text-muted-foreground">No messages in this conversation yet.</p>;
+  return (
+    <ol className="space-y-2 p-3" aria-label="Messages">
+      {messages.map((m, i) => (
+        <li key={m.message_id ?? i} className="rounded-md border p-3 text-sm">
+          <p className="mb-1 flex flex-wrap gap-2 text-xs text-muted-foreground"><span className="font-medium text-foreground">{m.from_address ?? "Unknown sender"}</span>{m.date ? <span>{formatWhen(m.date)}</span> : null}</p>
+          <p className="whitespace-pre-wrap">{stripHtml(m.content) || "(no content)"}</p>
+        </li>
+      ))}
+    </ol>
+  );
+}
+
+export interface RecordConversationsTabProps {
+  /** The contact's email address. Without one the tab explains there is nothing to match. */
+  email: string | null | undefined;
+  /** Other addresses of the contact (personal or additional emails; a comma-separated string is fine). Threads with any of them are shown. */
+  alsoEmails?: ReadonlyArray<string | null | undefined>;
+  /** Route to the conversation in your inbox screen; receives the inbox selection ("email:<id>"). Without it the rows link to `${inboxPath}?id=email:<id>`. */
+  onOpenThread?: (selection: string) => void;
+  /** Path of your inbox screen for the plain links. Default "/inbox". */
+  inboxPath?: string;
+}
+
+export function RecordConversationsTab({ email, alsoEmails = [], onOpenThread, inboxPath = "/inbox" }: RecordConversationsTabProps) {
+  const addresses = [...new Set([email, ...alsoEmails].flatMap((e) => (e ?? "").split(",")).map((e) => e.trim()).filter((e) => e !== "" && !e.includes("*") && e.includes("@")))];
+  const usable = addresses.length > 0;
+  const boxes = useG8Query(async (signal) => mailboxAddresses(await g8Get("/inbox/mailboxes", undefined, { signal })), [usable], { enabled: usable });
+  const mailboxes = boxes.data ?? [];
+
+  if (!usable) return <EmptyState compact icon={<MessagesSquare className="size-8" />} title="No email address" description="Conversations are matched by email address, and this contact has none to match." />;
+  if (boxes.error) return <ApiError error={boxes.error} title="Could not load mailboxes" onRetry={() => void boxes.refetch()} />;
+  if (!boxes.data) return <Skeleton className="h-24 w-full" aria-label="Loading conversations" />;
+  if (mailboxes.length === 0) return <EmptyState compact icon={<MessagesSquare className="size-8" />} title="No mailbox connected" description="Connect a mailbox to see the conversations you have with this contact." />;
+  // Mounted only once the mailboxes are known, so its first render is already "loading" (no empty-state flash before the first search).
+  return <ConversationList addresses={addresses} mailboxes={mailboxes} onOpenThread={onOpenThread} inboxPath={inboxPath} />;
+}
+
+interface ConversationListProps { addresses: string[]; mailboxes: string[]; onOpenThread?: (selection: string) => void; inboxPath: string }
+
+function ConversationList({ addresses, mailboxes, onOpenThread, inboxPath }: ConversationListProps) {
+  const [open, setOpen] = useState<string | null>(null);
+  const list = usePaginated<FoundThread>(async (cursor, signal) => {
+    const page = cursor ? Number(cursor) || 1 : 1;
+    const env = await g8Post<{ items?: FoundThread[] }>(`/inbox/emails/search?page=${page}&page_size=${PAGE_SIZE}`, { mailboxes, search_emails: addresses }, { signal });
+    const items = (env.data?.items ?? []).filter((t) => idOf(t) !== "");
+    const more = (env as { pagination?: { has_next?: boolean } }).pagination?.has_next ?? items.length >= PAGE_SIZE;
+    return { data: items, pagination: { next_cursor: more && items.length > 0 ? String(page + 1) : null } } as never;
+  }, [addresses.join(","), mailboxes.join("|")]);
+
+  if (list.error) return <ApiError error={list.error} title="Could not load conversations" onRetry={() => void list.reload()} />;
+  if (list.loading && list.items.length === 0) return <Skeleton className="h-24 w-full" aria-label="Loading conversations" />;
+  if (list.items.length === 0) return <EmptyState compact icon={<MessagesSquare className="size-8" />} title="No conversations yet" description="Emails sent to or received from this contact show up here." />;
+
+  return (
+    <div className="space-y-2">
+      <ul className="divide-y rounded-md border" aria-label="Conversations">
+        {list.items.map((t) => {
+          const id = idOf(t);
+          const last = (t.messages ?? []).filter((m) => !m.is_draft).slice(-1)[0];
+          const isOpen = open === id;
+          const selection = `email:${id}`;
+          return (
+            <li key={id}>
+              <div className="flex items-center justify-between gap-3 p-3 text-sm">
+                <button type="button" aria-expanded={isOpen} className="min-w-0 flex-1 text-left" onClick={() => setOpen(isOpen ? null : id)}>
+                  <span className="block truncate font-medium">{t.subject || "(no subject)"}</span>
+                  <span className="block truncate text-xs text-muted-foreground">{[formatWhen(t.updated_at ?? t.created_at), last ? stripHtml(last.content).slice(0, 80) : null].filter(Boolean).join(" · ")}</span>
+                </button>
+                <a
+                  href={`${inboxPath}?id=${encodeURIComponent(selection)}`}
+                  className="shrink-0 text-xs text-muted-foreground hover:underline"
+                  onClick={(e) => {
+                    if (!onOpenThread || e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
+                    e.preventDefault();
+                    onOpenThread(selection);
+                  }}
+                >
+                  Open in inbox
+                </a>
+              </div>
+              {isOpen ? <Opened id={id} /> : null}
+            </li>
+          );
+        })}
+      </ul>
+      {list.hasMore ? (
+        <div className="flex items-center justify-between text-sm text-muted-foreground">
+          <span role="status">Showing {list.items.length.toLocaleString()} conversations</span>
+          <Button size="sm" variant="outline" loading={list.loadingMore} onClick={() => void list.loadMore()}>Load more</Button>
+        </div>
+      ) : null}
+    </div>
+  );
+}

package/blocks/inbox/components/thread-badge.tsx

@@ -8,8 +8,8 @@ import type { ReactNode } from "react";
 
 const TONES = {
   neutral: "bg-muted text-foreground",
-  info: "bg-blue-100 text-blue-900 dark:bg-blue-950 dark:text-blue-100",
-  warn: "bg-amber-100 text-amber-900 dark:bg-amber-950 dark:text-amber-100",
+  info: "bg-info text-info-foreground",
+  warn: "bg-warning text-warning-foreground",
 } as const;
 
 export function ThreadBadge({ children, tone = "neutral" }: { children: ReactNode; tone?: keyof typeof TONES }) {

package/blocks/inbox/components/thread-view.tsx

@@ -50,7 +50,7 @@ function MessageBubble({ message, outbound }: { message: InboxMessage; outbound:
 function ThreadHeader({ thread }: { thread: InboxThread }) {
   return (
     <header className="space-y-1 border-b pb-3">
-      <h2 className="text-base font-semibold">{thread.subject || contactLabel(thread)}</h2>
+      <h2 className="text-base font-medium">{thread.subject || contactLabel(thread)}</h2>
       <p className="text-sm text-muted-foreground">
         {contactLabel(thread)}
         {thread.contact?.company ? ` at ${thread.contact.company}` : ""} · <span className="capitalize">{thread.channel}</span>

package/blocks/integrations/README.md

@@ -11,7 +11,11 @@ Depends on: `foundation`. Install: `npx @graph8/sdk add integrations`.
 
 - **Connections tab**: the five CRMs and the workspace tools. "Manage sync" opens a side panel with sync switches, job progress and a manual
   push (deep link `?id=hubspot`; a webhook is `?tab=webhooks&id=<webhook id>`). Connecting is a link out to the graph8 app, because OAuth consent only runs there.
+- A connected CRM's panel also has: **Health** (live status, connection record, CRM account, last historic import), **Sync now** (push or pull contacts, deals and leads as background jobs you can follow, with a lead push preview; each sync asks first), **CRM records** (browse contacts, companies, deals, leads and the activity log inside the CRM, read only), **Fields** (the CRM's fields beside graph8's) and **Historic import** (scan, review the counts, import, then sync later changes).
+- **SugarCRM** is the one CRM the API can sign in to (instance address, user, password), so its panel has a **Connection** tab instead of a link-out; the other four link out to graph8.
 - **Webhooks tab**: create, pause, rotate and delete webhooks, read deliveries. The secret is shown once.
+- **Tools tab**: Slack, Google Workspace and Roam with live status and a "Connect in graph8" link for any that is not connected; Google also has a connection test and a Drive folder browser.
+- **Ad accounts tab**: the ad platforms graph8 can sync audiences to, their accounts, a warning for any account the platform has paused, and a connect link-out.
 - Props (all optional): `connectUrl`, `defaultWebhookUrl`, `pushRecords`, `toolbarActions`, `renderDetailActions(record)`, `extraDetailTabs` (each `{ id, label, render(record) }`), where `record` is `{ kind: "crm", provider }` or `{ kind: "webhook", id }`.
 
 ## Components
@@ -21,6 +25,14 @@ Depends on: `foundation`. Install: `npx @graph8/sdk add integrations`.
 | `IntegrationList` | HubSpot, Salesforce, Pipedrive, Zoho and SugarCRM status, plus Slack, Google Workspace and Roam. Connect links to the app; Disconnect is confirmed. | read, destructive |
 | `SyncStatus` | One CRM: health, enable/disable continuous push and pull, job progress, manual contact push. | read, external |
 | `WebhookManager` | Create, pause, rotate and delete webhooks; secret shown once; delivery log; server-side verification note. | read, external, destructive |
+| `ConnectionHealth` | One CRM connection: live status, record, account metadata, last historic import. | read |
+| `SyncTriggers` | Run a sync now (contacts, deals, leads, push or pull), with a limit, a lead preview and job progress. | read, external |
+| `CrmRecords` | Browse the records and activity log inside a connected CRM, read only. | read |
+| `FieldMappings` | The CRM's fields next to the graph8 fields they can map to. | read |
+| `MigrationPanel` | Scan a CRM, review, import its history, sync later changes. | read, external, destructive |
+| `SugarCrmConnect` | Connect, check, update and remove a SugarCRM login. | read, external, destructive |
+| `WorkspaceTools` | Slack, Google Workspace and Roam status, connect link-outs, Google test and Drive browser. | read |
+| `AdAccounts` | Ad platforms, accounts and paused-account warnings. | read |
 
 `external` and `destructive` actions open `ConfirmSpendDialog` first (they write to the customer's CRM,
 change where data is sent, or remove a subscription).
@@ -50,7 +62,8 @@ reach the browser, which is why `WebhookManager` only displays it once at creati
 
 - CRM connected via the app's OAuth screen (`where: "app"`). Verify: `GET /crm-syncs/{provider}/status` -> `connected: true`.
 - A public https webhook route with `G8_WEBHOOK_SECRET` set (`where: "app"`).
-- The API key's user has integrations/webhooks admin rights (`where: "api"`).
+- The API key's user has integrations/webhooks admin rights (`where: "api"`). Migrations and the SugarCRM sign-in need an organisation admin.
+- The proxy `allowedPrefixes` include `integrations`, `crm-syncs`, `webhooks` and `audience-syncs` (the ad platform reads).
 
 ## Defaults (do not ask the human)
 
@@ -80,5 +93,45 @@ reach the browser, which is why `WebhookManager` only displays it once at creati
 | `rotate_webhook_secret_webhooks__webhook_id__rotate_secret_post` | POST /webhooks/{webhook_id}/rotate-secret | external | WebhookManager |
 | `list_webhook_deliveries_webhooks__webhook_id__deliveries_get` | GET /webhooks/{webhook_id}/deliveries | read | WebhookManager |
 | `delete_webhook_webhooks__webhook_id__delete` | DELETE /webhooks/{webhook_id} | destructive | WebhookManager |
+| `cancel_migration_integrations_migrations__migration_id__cancel_post` | POST /integrations/migrations/{migration_id}/cancel | destructive | MigrationPanel |
+| `confirm_migration_integrations_migrations__migration_id__confirm_post` | POST /integrations/migrations/{migration_id}/confirm | external | MigrationPanel |
+| `disconnect_sugarcrm_integrations_sugarcrm_delete` | DELETE /integrations/sugarcrm | destructive | SugarCrmConnect |
+| `discover_crm_fields_integrations_crm_fields_get` | GET /integrations/crm/fields | read | FieldMappings |
+| `get_crm_company_integrations_crm_connections__connection_id__companies__company_id__get` | GET /integrations/crm/connections/{connection_id}/companies/{company_id} | read | CrmRecords |
+| `get_crm_connection_integrations_crm_connections__connection_id__get` | GET /integrations/crm/connections/{connection_id} | read | ConnectionHealth |
+| `get_crm_connection_metadata_integrations_crm_connections__connection_id__metadata_get` | GET /integrations/crm/connections/{connection_id}/metadata | read | ConnectionHealth |
+| `get_crm_connection_status_integrations_crm_connections__connection_id__status_get` | GET /integrations/crm/connections/{connection_id}/status | read | ConnectionHealth |
+| `get_crm_contact_integrations_crm_connections__connection_id__contacts__contact_id__get` | GET /integrations/crm/connections/{connection_id}/contacts/{contact_id} | read | CrmRecords |
+| `get_crm_deal_integrations_crm_connections__connection_id__deals__deal_id__get` | GET /integrations/crm/connections/{connection_id}/deals/{deal_id} | read | CrmRecords |
+| `get_crm_lead_integrations_crm_connections__connection_id__leads__lead_id__get` | GET /integrations/crm/connections/{connection_id}/leads/{lead_id} | read | CrmRecords |
+| `get_last_completed_migration_integrations_connections__connection_id__last_migration_get` | GET /integrations/connections/{connection_id}/last-migration | read | ConnectionHealth, MigrationPanel |
+| `get_migration_status_integrations_migrations__migration_id__get` | GET /integrations/migrations/{migration_id} | read | MigrationPanel |
+| `get_webhook_webhooks__webhook_id__get` | GET /webhooks/{webhook_id} | read | WebhookDetail |
+| `list_ad_account_health_audience_syncs_account_health_get` | GET /audience-syncs/account-health | read | AdAccounts |
+| `list_ad_accounts_audience_syncs_accounts_get` | GET /audience-syncs/accounts | read | AdAccounts |
+| `list_ad_platforms_audience_syncs_platforms_get` | GET /audience-syncs/platforms | read | AdAccounts |
+| `list_crm_activities_integrations_crm_activities_get` | GET /integrations/crm/activities | read | CrmRecords |
+| `list_crm_companies_integrations_crm_connections__connection_id__companies_get` | GET /integrations/crm/connections/{connection_id}/companies | read | CrmRecords |
+| `list_crm_contact_activities_integrations_crm_connections__connection_id__contacts__contact_id__activities_get` | GET /integrations/crm/connections/{connection_id}/contacts/{contact_id}/activities | read | CrmRecords |
+| `list_crm_contacts_integrations_crm_connections__connection_id__contacts_get` | GET /integrations/crm/connections/{connection_id}/contacts | read | CrmRecords |
+| `list_crm_deals_integrations_crm_connections__connection_id__deals_get` | GET /integrations/crm/connections/{connection_id}/deals | read | CrmRecords |
+| `list_crm_leads_integrations_crm_connections__connection_id__leads_get` | GET /integrations/crm/connections/{connection_id}/leads | read | CrmRecords |
+| `list_google_drive_folder_files_integrations_google_workspace_folders__folder_id__files_get` | GET /integrations/google-workspace/folders/{folder_id}/files | read | WorkspaceTools |
+| `list_google_drive_folders_integrations_google_workspace_folders_get` | GET /integrations/google-workspace/folders | read | WorkspaceTools |
+| `list_lead_statuses_integrations_crm_sync_leads_statuses_get` | GET /integrations/crm-sync/leads/statuses | read | SyncTriggers |
+| `list_mappable_graph8_fields_integrations_crm_fields_mappable_get` | GET /integrations/crm/fields/mappable | read | FieldMappings |
+| `preview_lead_push_integrations_crm_sync_leads_push_preview_get` | GET /integrations/crm-sync/leads/push-preview | read | SyncTriggers |
+| `pull_all_contacts_integrations_crm_sync_contacts_pull_post` | POST /integrations/crm-sync/contacts/pull | external | SyncTriggers |
+| `pull_all_deals_integrations_crm_sync_deals_pull_post` | POST /integrations/crm-sync/deals/pull | external | SyncTriggers |
+| `pull_all_leads_integrations_crm_sync_leads_pull_post` | POST /integrations/crm-sync/leads/pull | external | SyncTriggers |
+| `push_all_contacts_integrations_crm_sync_contacts_push_post` | POST /integrations/crm-sync/contacts/push | external | SyncTriggers |
+| `push_all_deals_integrations_crm_sync_deals_push_post` | POST /integrations/crm-sync/deals/push | external | SyncTriggers |
+| `push_all_leads_integrations_crm_sync_leads_push_post` | POST /integrations/crm-sync/leads/push | external | SyncTriggers |
+| `start_delta_sync_integrations_migrations_delta_sync_post` | POST /integrations/migrations/delta-sync | external | MigrationPanel |
+| `start_migration_discovery_integrations_migrations_discovery_post` | POST /integrations/migrations/discovery | external | MigrationPanel |
+| `test_google_workspace_connection_integrations_google_workspace_test_post` | POST /integrations/google-workspace/test | read | WorkspaceTools |
+| `validate_sugarcrm_integrations_sugarcrm_validate_post` | POST /integrations/sugarcrm/validate | read | SugarCrmConnect |
+
+Not offered on purpose: CRM pass-through writes (create, update and delete a contact, company, deal, lead or meeting directly in the CRM, and the batch versions) because they bypass graph8's records and field mapping (they stay in recipes and `g8.api.integrations`); the embedded connection session token and `saveConnection` (the OAuth consent screen only runs in the graph8 app); syncing a graph8 list or audience (needs a list picker and starts from the Lists screen); Google Ads conversions and video assets (the Ads screen owns audience syncs).
 
 Recipes (`recipes/`): `verify-webhook-route.ts`, `register-webhook.ts`, `crm-sync-health.ts`, `push-contacts-to-crm.ts`.

package/blocks/integrations/block.json

@@ -12,25 +12,63 @@
     "foundation"
   ],
   "operations": [
-    "list_crm_syncs_crm_syncs_get",
-    "list_connections_integrations_connections_get",
-    "get_slack_status_integrations_slack_status_get",
-    "get_google_workspace_status_integrations_google_workspace_get",
-    "get_roam_status_integrations_roam_status_get",
+    "cancel_migration_integrations_migrations__migration_id__cancel_post",
+    "confirm_migration_integrations_migrations__migration_id__confirm_post",
+    "create_webhook_webhooks_post",
     "delete_connection_integrations_connections__connection_id__delete",
-    "get_crm_status_crm_syncs__provider__status_get",
+    "delete_webhook_webhooks__webhook_id__delete",
+    "disconnect_sugarcrm_integrations_sugarcrm_delete",
+    "discover_crm_fields_integrations_crm_fields_get",
+    "get_crm_company_integrations_crm_connections__connection_id__companies__company_id__get",
+    "get_crm_connection_integrations_crm_connections__connection_id__get",
+    "get_crm_connection_metadata_integrations_crm_connections__connection_id__metadata_get",
+    "get_crm_connection_status_integrations_crm_connections__connection_id__status_get",
+    "get_crm_contact_integrations_crm_connections__connection_id__contacts__contact_id__get",
+    "get_crm_deal_integrations_crm_connections__connection_id__deals__deal_id__get",
     "get_crm_fields_crm_syncs__provider__fields_get",
-    "set_push_sync_enabled_integrations_crm_sync_push_enabled_put",
-    "set_pull_sync_enabled_integrations_crm_sync_pull_enabled_put",
+    "get_crm_lead_integrations_crm_connections__connection_id__leads__lead_id__get",
+    "get_crm_status_crm_syncs__provider__status_get",
+    "get_google_workspace_status_integrations_google_workspace_get",
+    "get_last_completed_migration_integrations_connections__connection_id__last_migration_get",
+    "get_migration_status_integrations_migrations__migration_id__get",
+    "get_roam_status_integrations_roam_status_get",
+    "get_slack_status_integrations_slack_status_get",
     "get_sync_job_integrations_crm_sync_jobs__job_id__get",
-    "push_contacts_to_crm_crm_syncs__provider__contacts_push_post",
-    "list_webhooks_webhooks_get",
+    "get_webhook_webhooks__webhook_id__get",
+    "list_ad_account_health_audience_syncs_account_health_get",
+    "list_ad_accounts_audience_syncs_accounts_get",
+    "list_ad_platforms_audience_syncs_platforms_get",
+    "list_connections_integrations_connections_get",
+    "list_crm_activities_integrations_crm_activities_get",
+    "list_crm_companies_integrations_crm_connections__connection_id__companies_get",
+    "list_crm_contact_activities_integrations_crm_connections__connection_id__contacts__contact_id__activities_get",
+    "list_crm_contacts_integrations_crm_connections__connection_id__contacts_get",
+    "list_crm_deals_integrations_crm_connections__connection_id__deals_get",
+    "list_crm_leads_integrations_crm_connections__connection_id__leads_get",
+    "list_crm_syncs_crm_syncs_get",
+    "list_google_drive_folder_files_integrations_google_workspace_folders__folder_id__files_get",
+    "list_google_drive_folders_integrations_google_workspace_folders_get",
+    "list_lead_statuses_integrations_crm_sync_leads_statuses_get",
+    "list_mappable_graph8_fields_integrations_crm_fields_mappable_get",
+    "list_webhook_deliveries_webhooks__webhook_id__deliveries_get",
     "list_webhook_events_webhooks_events_get",
-    "create_webhook_webhooks_post",
-    "update_webhook_webhooks__webhook_id__patch",
+    "list_webhooks_webhooks_get",
+    "preview_lead_push_integrations_crm_sync_leads_push_preview_get",
+    "pull_all_contacts_integrations_crm_sync_contacts_pull_post",
+    "pull_all_deals_integrations_crm_sync_deals_pull_post",
+    "pull_all_leads_integrations_crm_sync_leads_pull_post",
+    "push_all_contacts_integrations_crm_sync_contacts_push_post",
+    "push_all_deals_integrations_crm_sync_deals_push_post",
+    "push_all_leads_integrations_crm_sync_leads_push_post",
+    "push_contacts_to_crm_crm_syncs__provider__contacts_push_post",
     "rotate_webhook_secret_webhooks__webhook_id__rotate_secret_post",
-    "list_webhook_deliveries_webhooks__webhook_id__deliveries_get",
-    "delete_webhook_webhooks__webhook_id__delete"
+    "set_pull_sync_enabled_integrations_crm_sync_pull_enabled_put",
+    "set_push_sync_enabled_integrations_crm_sync_push_enabled_put",
+    "start_delta_sync_integrations_migrations_delta_sync_post",
+    "start_migration_discovery_integrations_migrations_discovery_post",
+    "test_google_workspace_connection_integrations_google_workspace_test_post",
+    "update_webhook_webhooks__webhook_id__patch",
+    "validate_sugarcrm_integrations_sugarcrm_validate_post"
   ],
   "components": [
     {
@@ -122,13 +160,137 @@
         "list_webhook_deliveries_webhooks__webhook_id__deliveries_get",
         "update_webhook_webhooks__webhook_id__patch",
         "rotate_webhook_secret_webhooks__webhook_id__rotate_secret_post",
-        "delete_webhook_webhooks__webhook_id__delete"
+        "delete_webhook_webhooks__webhook_id__delete",
+        "get_webhook_webhooks__webhook_id__get"
+      ],
+      "tiers": [
+        "read",
+        "external",
+        "destructive"
+      ]
+    },
+    {
+      "name": "ConnectionHealth",
+      "file": "components/connection-health.tsx",
+      "purpose": "Live status, connection record, CRM account details and the last historic import for one CRM connection.",
+      "operations": [
+        "get_crm_connection_integrations_crm_connections__connection_id__get",
+        "get_crm_connection_status_integrations_crm_connections__connection_id__status_get",
+        "get_crm_connection_metadata_integrations_crm_connections__connection_id__metadata_get",
+        "get_last_completed_migration_integrations_connections__connection_id__last_migration_get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "SyncTriggers",
+      "file": "components/sync-triggers.tsx",
+      "purpose": "Run a sync now: push or pull contacts, deals and leads as background jobs with a lead push preview; every sync confirmed.",
+      "operations": [
+        "get_sync_job_integrations_crm_sync_jobs__job_id__get",
+        "list_lead_statuses_integrations_crm_sync_leads_statuses_get",
+        "preview_lead_push_integrations_crm_sync_leads_push_preview_get",
+        "push_all_contacts_integrations_crm_sync_contacts_push_post",
+        "pull_all_contacts_integrations_crm_sync_contacts_pull_post",
+        "push_all_deals_integrations_crm_sync_deals_push_post",
+        "pull_all_deals_integrations_crm_sync_deals_pull_post",
+        "push_all_leads_integrations_crm_sync_leads_push_post",
+        "pull_all_leads_integrations_crm_sync_leads_pull_post"
+      ],
+      "tiers": [
+        "read",
+        "external"
+      ]
+    },
+    {
+      "name": "CrmRecords",
+      "file": "components/crm-records.tsx",
+      "purpose": "Browse the contacts, companies, deals, leads and activity log inside a connected CRM, read only.",
+      "operations": [
+        "list_crm_contact_activities_integrations_crm_connections__connection_id__contacts__contact_id__activities_get",
+        "list_crm_activities_integrations_crm_activities_get",
+        "list_crm_contacts_integrations_crm_connections__connection_id__contacts_get",
+        "list_crm_companies_integrations_crm_connections__connection_id__companies_get",
+        "list_crm_deals_integrations_crm_connections__connection_id__deals_get",
+        "list_crm_leads_integrations_crm_connections__connection_id__leads_get",
+        "get_crm_contact_integrations_crm_connections__connection_id__contacts__contact_id__get",
+        "get_crm_company_integrations_crm_connections__connection_id__companies__company_id__get",
+        "get_crm_deal_integrations_crm_connections__connection_id__deals__deal_id__get",
+        "get_crm_lead_integrations_crm_connections__connection_id__leads__lead_id__get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "FieldMappings",
+      "file": "components/field-mappings.tsx",
+      "purpose": "The CRM's fields next to the graph8 fields they can map to, searchable, read only.",
+      "operations": [
+        "discover_crm_fields_integrations_crm_fields_get",
+        "list_mappable_graph8_fields_integrations_crm_fields_mappable_get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "MigrationPanel",
+      "file": "components/migration-panel.tsx",
+      "purpose": "Scan a CRM, review the counts, import its history, sync later changes; every step confirmed.",
+      "operations": [
+        "get_last_completed_migration_integrations_connections__connection_id__last_migration_get",
+        "get_migration_status_integrations_migrations__migration_id__get",
+        "start_migration_discovery_integrations_migrations_discovery_post",
+        "start_delta_sync_integrations_migrations_delta_sync_post",
+        "confirm_migration_integrations_migrations__migration_id__confirm_post",
+        "cancel_migration_integrations_migrations__migration_id__cancel_post"
       ],
       "tiers": [
         "read",
         "external",
         "destructive"
       ]
+    },
+    {
+      "name": "SugarCrmConnect",
+      "file": "components/sugarcrm-connect.tsx",
+      "purpose": "Connect SugarCRM with an instance address and login (the one CRM the API can sign in to), check, update credentials, remove.",
+      "operations": [
+        "validate_sugarcrm_integrations_sugarcrm_validate_post",
+        "disconnect_sugarcrm_integrations_sugarcrm_delete"
+      ],
+      "tiers": [
+        "read",
+        "destructive"
+      ]
+    },
+    {
+      "name": "WorkspaceTools",
+      "file": "components/workspace-tools.tsx",
+      "purpose": "Slack, Google Workspace and Roam with live status and a connect link-out; Google connection test and Drive browser.",
+      "operations": [
+        "list_google_drive_folders_integrations_google_workspace_folders_get",
+        "list_google_drive_folder_files_integrations_google_workspace_folders__folder_id__files_get",
+        "test_google_workspace_connection_integrations_google_workspace_test_post"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "AdAccounts",
+      "file": "components/ad-accounts.tsx",
+      "purpose": "Ad platforms, their accounts and any account the platform has paused, with a connect link-out.",
+      "operations": [
+        "list_ad_platforms_audience_syncs_platforms_get",
+        "list_ad_accounts_audience_syncs_accounts_get",
+        "list_ad_account_health_audience_syncs_account_health_get"
+      ],
+      "tiers": [
+        "read"
+      ]
     }
   ],
   "hooks": [],
@@ -136,6 +298,18 @@
     {
       "file": "lib/integrations-utils.ts",
       "purpose": "CRM provider list and labels, status types and envelope helpers shared by the integrations components."
+    },
+    {
+      "file": "lib/load-more.tsx",
+      "purpose": "Paging helpers (useLoadMoreList, useGrowingList, LoadMore) so no list stops silently at a cap."
+    },
+    {
+      "file": "lib/crm-utils.ts",
+      "purpose": "Readers for records in a CRM's own shape: title, subtitle, flattened fields."
+    },
+    {
+      "file": "lib/facts.tsx",
+      "purpose": "FactList: renders an open-shaped API object as labelled facts."
     }
   ],
   "recipes": [

package/blocks/integrations/components/ad-accounts.tsx

@@ -0,0 +1,82 @@
+"use client";
+
+/**
+ * AdAccounts: the ad platforms graph8 can sync audiences to (Google Ads, Meta, LinkedIn and others), whether each is connected, how many syncs
+ * it carries, which accounts are available, and a warning for any account the platform has paused or de-authorised (the usual reason a
+ * sync stopped). A platform that is not connected shows a "Connect in graph8" link: the sign-in screen only runs in the graph8 app.
+ * All reads; the health list is the last hourly check, not a live call. Creating and running the syncs themselves is on the Ads screen.
+ *
+ * SDK operations, in order:
+ *   1. listAdPlatforms       GET /audience-syncs/platforms        (read)  platform, connected, active_syncs
+ *   2. listAdAccounts        GET /audience-syncs/accounts         (read)  the accounts you can sync to
+ *   3. listAdAccountHealth   GET /audience-syncs/account-health   (read)  only the accounts that are NOT healthy
+ */
+import { Skeleton } from "@graph8/sdk/ui";
+import { ApiError } from "@/g8/components/api-error";
+import { EmptyState } from "@/g8/components/empty-state";
+import { SectionCard } from "@/g8/components/screen/section-card";
+import { StatusPill } from "@/g8/components/screen/status-pill";
+import { useG8Query } from "@/g8/hooks/use-g8-query";
+import { brandUrl, useBrand } from "@/g8/hooks/use-brand";
+import { g8Get } from "@/g8/lib/g8-client";
+import { arrayOf, GRAPH8_APP_INTEGRATIONS_PATH } from "../lib/integrations-utils";
+
+export interface AdAccountsProps {
+  /** Where "Connect" sends people. Default: graph8 Settings > Integrations. */
+  connectUrl?: string;
+  className?: string;
+}
+
+interface Platform { platform: string; connected?: boolean; account_name?: string | null; account_id?: string | null; active_syncs?: number }
+// /audience-syncs/accounts answers ad_account_id / ad_account_name.
+interface Account { platform?: string; ad_account_id?: string | number; ad_account_name?: string }
+interface Health { platform?: string; account_id?: string | number; health?: string; reason?: string; message?: string; detail?: string }
+const label = (s: string): string => s.replace(/[_-]/g, " ").replace(/^./, (c) => c.toUpperCase());
+
+export function AdAccounts({ connectUrl: connectUrlProp, className }: AdAccountsProps) {
+  const brand = useBrand();
+  const connectUrl = connectUrlProp ?? brandUrl(brand, GRAPH8_APP_INTEGRATIONS_PATH);
+  const platforms = useG8Query((signal) => g8Get("/audience-syncs/platforms", undefined, { signal }), []);
+  const accounts = useG8Query((signal) => g8Get("/audience-syncs/accounts", undefined, { signal }), []);
+  const health = useG8Query((signal) => g8Get("/audience-syncs/account-health", undefined, { signal }), []);
+  const unhealthy = arrayOf<Health>(health.data);
+  const accountRows = arrayOf<Account>(accounts.data);
+  const platformRows = arrayOf<Platform>(platforms.data);
+
+  return (
+    <div className={`flex flex-col gap-4 ${className ?? ""}`}>
+      {unhealthy.length > 0 ? (
+        <div role="alert" className="rounded-md border border-error-foreground/25 bg-error p-3 text-sm text-error-foreground" data-testid="ad-health-warning">
+          <p className="font-medium">{unhealthy.length === 1 ? "An ad account needs attention" : `${unhealthy.length} ad accounts need attention`}</p>
+          <ul className="mt-1 list-disc pl-5">{unhealthy.map((h, i) => <li key={`${h.platform}-${h.account_id}-${i}`}>{label(h.platform ?? "Platform")} account {String(h.account_id ?? "")}: {label(h.health ?? "unhealthy")}{h.reason || h.message || h.detail ? ` (${h.reason ?? h.message ?? h.detail})` : ""}</li>)}</ul>
+        </div>
+      ) : null}
+      {health.error ? <ApiError compact error={health.error} title="Could not check account health" onRetry={() => void health.refetch()} /> : null}
+      <SectionCard title="Ad platforms" description={`Where ${brand.name} can sync audiences`} flush>
+        {platforms.error ? <div className="p-3"><ApiError error={platforms.error} title="Could not load the platforms" onRetry={() => void platforms.refetch()} /></div> : null}
+        {platforms.loading && !platforms.data ? <Skeleton className="m-3 h-12" /> : null}
+        <ul className="divide-y" aria-label="Ad platforms">
+          {platformRows.map((p) => (
+            <li key={p.platform} data-platform={p.platform} className="flex flex-wrap items-center justify-between gap-2 px-4 py-3 text-sm">
+              <span><span className="font-medium">{label(p.platform)}</span><span className="block text-xs text-muted-foreground">{p.connected ? `${p.active_syncs ?? 0} active ${p.active_syncs === 1 ? "sync" : "syncs"}${p.account_name ? `, ${p.account_name}` : ""}` : "Not connected"}</span></span>
+              {p.connected ? <StatusPill tone="positive" dot>Connected</StatusPill> : <a className="text-sm underline" href={connectUrl} target="_blank" rel="noreferrer">Connect in {brand.linkLabel}</a>}
+            </li>
+          ))}
+        </ul>
+        {platforms.data && platformRows.length === 0 ? <EmptyState compact title="No ad platforms" description="Ad platforms appear here once they are available to your workspace." /> : null}
+      </SectionCard>
+      <SectionCard title="Accounts" description="The ad accounts you can sync to" flush>
+        {accounts.error ? <div className="p-3"><ApiError error={accounts.error} title="Could not load the accounts" onRetry={() => void accounts.refetch()} /></div> : null}
+        {accounts.loading && !accounts.data ? <Skeleton className="m-3 h-12" /> : null}
+        <ul className="divide-y" aria-label="Ad accounts">
+          {accountRows.map((a, i) => {
+            const id = String(a.ad_account_id ?? "");
+            const bad = unhealthy.find((h) => String(h.account_id) === id && (!h.platform || !a.platform || h.platform === a.platform));
+            return <li key={`${a.platform}-${id}-${i}`} className="flex items-center justify-between gap-2 px-4 py-2 text-sm"><span>{a.ad_account_name || id}<span className="ml-2 text-xs text-muted-foreground">{a.platform ? label(a.platform) : ""} {id}</span></span><StatusPill tone={bad ? "negative" : "positive"} dot>{bad ? label(bad.health ?? "unhealthy") : "Healthy"}</StatusPill></li>;
+          })}
+        </ul>
+        {accounts.data && accountRows.length === 0 ? <EmptyState compact title="No ad accounts" description={`Connect an ad platform in ${brand.linkLabel} to see its accounts here.`} /> : null}
+      </SectionCard>
+    </div>
+  );
+}