@graph8/sdk 0.362.0 → 0.373.0

package/blocks/integrations/components/webhook-manager.tsx

@@ -23,14 +23,21 @@ import { g8Delete, g8Get, g8Patch, g8Post } from "@/g8/lib/g8-client";
 import { useG8Query } from "@/g8/hooks/use-g8-query";
 import { useG8Mutation } from "@/g8/hooks/use-g8-mutation";
 import { ApiError } from "@/g8/components/api-error";
+import { useLoadMoreList } from "@/g8/hooks/use-load-more-list";
+import { byPage, hasNextOf } from "@/g8/lib/paging";
+import { LoadMore } from "@/g8/components/paging-notices";
 import { ConfirmSpendDialog } from "@/g8/components/confirm-spend-dialog";
 import type { ConfirmTier } from "@/g8/components/confirm-spend-dialog";
 import { EmptyState } from "@/g8/components/empty-state";
 import { arrayOf, formatWhen } from "../lib/integrations-utils";
+import { plural } from "@/g8/lib/plural";
+import { DEFAULT_BRAND, useBrand } from "@/g8/hooks/use-brand";
 
 export interface WebhookManagerProps {
   /** Pre-fill the endpoint URL of the create form (your /api/webhooks/graph8 route). */
   defaultUrl?: string;
+  /** Called when a person opens a webhook (show a WebhookDetail). */
+  onSelectWebhook?: (webhook: { id: string; url: string; name?: string | null }) => void;
   className?: string;
 }
 
@@ -65,13 +72,13 @@ type Pending =
   | { kind: "rotate"; hook: Webhook }
   | { kind: "delete"; hook: Webhook };
 
-function copyFor(p: Pending): { tier: ConfirmTier; title: string; description: string; label: string } {
+function copyFor(p: Pending, platform: string = DEFAULT_BRAND.linkLabel): { tier: ConfirmTier; title: string; description: string; label: string } {
   switch (p.kind) {
     case "create":
       return {
         tier: "external",
-        title: `Send ${p.events.length} event type${p.events.length === 1 ? "" : "s"} to ${p.url}`,
-        description: "graph8 will POST signed events to this URL as they happen.",
+        title: `Send ${plural(p.events.length, "event type")} to ${p.url}`,
+        description: `${platform} will POST signed events to this URL as they happen.`,
         label: "Create webhook",
       };
     case "toggle":
@@ -80,7 +87,7 @@ function copyFor(p: Pending): { tier: ConfirmTier; title: string; description: s
         title: `${p.hook.is_active === false ? "Resume" : "Pause"} deliveries to ${p.hook.url}`,
         description:
           p.hook.is_active === false
-            ? "graph8 starts sending events to this URL again."
+            ? `${platform} starts sending events to this URL again.`
             : "Events stop being sent to this URL until you resume.",
         label: p.hook.is_active === false ? "Resume" : "Pause",
       };
@@ -101,16 +108,24 @@ function copyFor(p: Pending): { tier: ConfirmTier; title: string; description: s
   }
 }
 
+/** Deliveries per read; "Load more" appends the next page. */
+const DELIVERY_PAGE = 20;
+
 function Deliveries({ hook }: { hook: Webhook }) {
-  const list = useG8Query((signal) => g8Get(`/webhooks/${hook.id}/deliveries`, { page: 1, limit: 20 }, { signal }), [hook.id]);
-  if (list.loading) return <Skeleton className="h-16 w-full" />;
+  const list = useLoadMoreList(byPage<Delivery>(DELIVERY_PAGE, async (page, signal) => {
+    const env = await g8Get(`/webhooks/${hook.id}/deliveries`, { page, limit: DELIVERY_PAGE }, { signal });
+    const rows = arrayOf<Delivery>(env);
+    return { rows, hasNext: hasNextOf(env, DELIVERY_PAGE, rows.length) };
+  }), [hook.id]);
+  if (list.loading && !list.data) return <Skeleton className="h-16 w-full" />;
   if (list.error) return <ApiError error={list.error} onRetry={() => void list.refetch()} />;
-  const rows = arrayOf<Delivery>(list.data);
-  if (rows.length === 0) return <p className="text-sm text-gray-500">No deliveries yet.</p>;
+  const rows = list.data ?? [];
+  if (rows.length === 0) return <p className="text-sm text-muted-foreground">No deliveries yet.</p>;
   return (
+    <>
     <table className="w-full text-sm" aria-label="Deliveries">
       <thead>
-        <tr className="text-left text-gray-500">
+        <tr className="text-left text-muted-foreground">
           <th>Event</th>
           <th>Status</th>
           <th>Code</th>
@@ -130,10 +145,13 @@ function Deliveries({ hook }: { hook: Webhook }) {
         ))}
       </tbody>
     </table>
+    <LoadMore shown={rows.length} noun="deliveries" hasMore={list.hasMore} loading={list.loadingMore} onLoadMore={list.loadMore} />
+    </>
   );
 }
 
-export function WebhookManager({ defaultUrl = "", className }: WebhookManagerProps) {
+export function WebhookManager({ defaultUrl = "", onSelectWebhook, className }: WebhookManagerProps) {
+  const brand = useBrand();
   const hooks = useG8Query((signal) => g8Get("/webhooks", undefined, { signal }), []);
   const events = useG8Query((signal) => g8Get("/webhooks/events", undefined, { signal }), []);
   const [url, setUrl] = useState(defaultUrl);
@@ -169,29 +187,29 @@ export function WebhookManager({ defaultUrl = "", className }: WebhookManagerPro
   );
   const urlOk = /^https:\/\/\S+$/.test(url.trim());
   const toggle = (event: string) => setChosen((c) => (c.includes(event) ? c.filter((x) => x !== event) : [...c, event]));
-  const confirm = pending ? copyFor(pending) : null;
+  const confirm = pending ? copyFor(pending, brand.linkLabel) : null;
 
   return (
     <div className={`space-y-4 ${className ?? ""}`}>
-      <section className="space-y-3 rounded border border-gray-200 p-3" aria-label="New webhook">
-        <h3 className="text-sm font-semibold">New webhook</h3>
+      <section className="space-y-3 rounded border border-border p-3" aria-label="New webhook">
+        <h3 className="text-sm font-medium">New webhook</h3>
         <div className="grid gap-2 md:grid-cols-2">
           <Input
             aria-label="Endpoint URL"
-            placeholder="https://yourapp.com/api/webhooks/graph8"
+            placeholder={`https://yourapp.com/api/webhooks/${brand.linkLabel.toLowerCase().replace(/[^a-z0-9-]+/g, "-")}`}
             value={url}
             onChange={(e) => setUrl(e.target.value)}
           />
           <Input aria-label="Name" placeholder="Name (optional)" value={name} onChange={(e) => setName(e.target.value)} />
         </div>
-        {url && !urlOk ? <p className="text-xs text-red-700">The endpoint must be an https:// URL.</p> : null}
+        {url && !urlOk ? <p className="text-xs text-error-foreground">The endpoint must be an https:// URL.</p> : null}
         {events.loading ? (
           <Skeleton className="h-12 w-full" />
         ) : (
           <div className="space-y-2">
             {Object.entries(byCategory).map(([category, items]) => (
               <fieldset key={category}>
-                <legend className="text-xs font-medium uppercase text-gray-500">{category}</legend>
+                <legend className="text-xs font-medium uppercase text-muted-foreground">{category}</legend>
                 <div className="flex flex-wrap gap-x-4 gap-y-1">
                   {items.map((e) => (
                     <label key={e.event} className="flex items-center gap-1 text-sm" title={e.description ?? undefined}>
@@ -213,10 +231,10 @@ export function WebhookManager({ defaultUrl = "", className }: WebhookManagerPro
       </section>
 
       {secret ? (
-        <div role="alert" className="rounded border border-amber-300 bg-amber-50 p-3 text-sm">
+        <div role="alert" className="rounded border border-warning-foreground/30 bg-warning p-3 text-sm">
           <p className="font-medium">Signing secret for {secret.url}. It is shown once.</p>
-          <code className="mt-1 block break-all rounded bg-white p-2">{secret.value}</code>
-          <p className="mt-1 text-xs text-gray-600">
+          <code className="mt-1 block break-all rounded bg-background p-2">{secret.value}</code>
+          <p className="mt-1 text-xs text-muted-foreground">
             Store it in your server environment as G8_WEBHOOK_SECRET. Never put it in browser code.
           </p>
           <Button size="sm" variant="outline" className="mt-2" onClick={() => setSecret(null)}>
@@ -233,13 +251,13 @@ export function WebhookManager({ defaultUrl = "", className }: WebhookManagerPro
       ) : list.length === 0 ? (
         <EmptyState title="No webhooks yet" description="Create one above to receive events like replies and meetings on your server." />
       ) : (
-        <ul className="divide-y rounded border border-gray-200">
+        <ul className="divide-y rounded border border-border">
           {list.map((h) => (
             <li key={h.id} className="space-y-2 px-3 py-3">
               <div className="flex flex-wrap items-center justify-between gap-2">
                 <div>
-                  <div className="font-medium">{h.name || h.url}</div>
-                  <div className="text-xs text-gray-500">
+                  {onSelectWebhook ? <button type="button" className="font-medium hover:underline" onClick={() => onSelectWebhook(h)}>{h.name || h.url}</button> : <div className="font-medium">{h.name || h.url}</div>}
+                  <div className="text-xs text-muted-foreground">
                     {h.name ? `${h.url} - ` : ""}
                     {(h.events ?? []).length} events - {h.is_active === false ? "paused" : "active"}
                   </div>
@@ -270,12 +288,12 @@ export function WebhookManager({ defaultUrl = "", className }: WebhookManagerPro
         </ul>
       )}
 
-      <details className="rounded border border-gray-200 p-3 text-sm">
+      <details className="rounded border border-border p-3 text-sm">
         <summary className="cursor-pointer font-medium">Verify deliveries (server side)</summary>
-        <p className="mt-2 text-gray-600">
+        <p className="mt-2 text-muted-foreground">
           Check the signature on the raw body before trusting an event. Deliveries repeat, so deduplicate on the event id.
         </p>
-        <pre className="mt-2 overflow-x-auto rounded bg-gray-950 p-3 text-xs text-gray-100">
+        <pre className="mt-2 overflow-x-auto rounded bg-muted p-3 text-xs text-foreground">
           <code>{`const event = g8.webhooks.constructEvent(rawBody,
   req.headers.get("x-studio-signature") ?? "",
   req.headers.get("x-studio-timestamp") ?? "",

package/blocks/integrations/components/workspace-tools.tsx

@@ -0,0 +1,127 @@
+"use client";
+
+/**
+ * WorkspaceTools: Slack, Google Workspace and Roam, each as a card with its live status. They connect through a sign-in screen that only runs
+ * in the graph8 app, so a tool that is not connected shows a "Connect in graph8" link, never a dead button. Connected tools show what the
+ * status reports. Google Workspace also has "Test connection" (a live check) and a Drive browser (folders one level at a time with their
+ * files; "Load more" follows Google's page token) for confirming which folders graph8 can read.
+ * All reads. Nothing here changes a connection.
+ *
+ * SDK operations, in order:
+ *   1. getSlackStatus / getGoogleWorkspaceStatus / getRoamStatus   GET  /integrations/slack/status, /integrations/google-workspace, /integrations/roam/status   (read)
+ *   2. testGoogleWorkspaceConnection   POST /integrations/google-workspace/test               (read)
+ *   3. listGoogleDriveFolders          GET  /integrations/google-workspace/folders?parent_id&view&page_size&page_token   (read)
+ *   4. listGoogleDriveFolderFiles      GET  /integrations/google-workspace/folders/{folder_id}/files?page_size&page_token   (read)
+ */
+import { useEffect, useState } from "react";
+import { Folder } from "lucide-react";
+import { Button, Skeleton } from "@graph8/sdk/ui";
+import { ApiError } from "@/g8/components/api-error";
+import { SectionCard } from "@/g8/components/screen/section-card";
+import { StatusPill } from "@/g8/components/screen/status-pill";
+import { useG8Mutation } from "@/g8/hooks/use-g8-mutation";
+import { useG8Query } from "@/g8/hooks/use-g8-query";
+import { g8Get, g8Post } from "@/g8/lib/g8-client";
+import { brandUrl, useBrand } from "@/g8/hooks/use-brand";
+import { FactList } from "../lib/facts";
+import { GRAPH8_APP_INTEGRATIONS_PATH, looksConnected } from "../lib/integrations-utils";
+
+export interface WorkspaceToolsProps {
+  /** Where "Connect" sends people. Default: graph8 Settings > Integrations. */
+  connectUrl?: string;
+  className?: string;
+}
+
+interface DriveFolder { id: string; name: string }
+interface DriveFile { id: string; name: string; mimeType?: string; size?: string | number | null }
+const TOOLS = [
+  { key: "slack", label: "Slack", path: "/integrations/slack/status", note: "Send alerts and notifications to Slack channels." },
+  { key: "google", label: "Google Workspace", path: "/integrations/google-workspace", note: "Read Drive folders and use your Workspace account." },
+  { key: "roam", label: "Roam", path: "/integrations/roam/status", note: "Post to Roam groups and users." },
+] as const;
+const enc = encodeURIComponent;
+type Query = { data: unknown; error: unknown; loading: boolean; refetch: () => Promise<unknown> };
+
+/** One paged Drive list. Folders and files are separate queries, so each keeps its own page token (a token only works for the query that issued it). */
+function usePagedDrive<T>(path: string, key: string, field: "folders" | "files", extraQuery: Record<string, string | number>, enabled: boolean) {
+  const [acc, setAcc] = useState<T[]>([]);
+  const [token, setToken] = useState<string | undefined>();
+  const [next, setNext] = useState<string | undefined>();
+  useEffect(() => { setAcc([]); setToken(undefined); setNext(undefined); }, [key]);
+  const q = useG8Query((signal) => g8Get(path, { ...extraQuery, page_size: 50, page_token: token }, { signal }), [key, token], { enabled });
+  useEffect(() => {
+    const d = (q.data as { data?: Record<string, unknown> } | undefined)?.data;
+    if (!d || !Array.isArray(d[field])) return;
+    setAcc((prev) => (token ? [...prev, ...(d[field] as T[])] : (d[field] as T[])));
+    setNext((d.next_page_token as string | null | undefined) ?? undefined);
+  }, [q.data]); // eslint-disable-line react-hooks/exhaustive-deps
+  return { items: acc, next, loading: q.loading, error: q.error, refetch: q.refetch, more: () => next && setToken(next) };
+}
+
+function DriveBrowser() {
+  const [trail, setTrail] = useState<DriveFolder[]>([]);
+  const parent = trail[trail.length - 1]?.id ?? "root";
+  const folders = usePagedDrive<DriveFolder>("/integrations/google-workspace/folders", parent, "folders", { parent_id: parent, view: "my_drive" }, true);
+  const files = usePagedDrive<DriveFile>(`/integrations/google-workspace/folders/${enc(parent)}/files`, parent, "files", {}, parent !== "root");
+  const go = (t: DriveFolder[]) => setTrail(t);
+  return (
+    <div className="flex flex-col gap-2">
+      <nav aria-label="Folder path" className="flex flex-wrap items-center gap-1 text-sm">
+        <button type="button" className="underline" onClick={() => go([])}>My Drive</button>
+        {trail.map((f, i) => <span key={f.id}> / <button type="button" className="underline" onClick={() => go(trail.slice(0, i + 1))}>{f.name}</button></span>)}
+      </nav>
+      {folders.error ? <ApiError error={folders.error} title="Could not list the folders" onRetry={() => void folders.refetch()} /> : null}
+      {(folders.loading && folders.items.length === 0) ? <Skeleton className="h-10 w-full" /> : null}
+      <ul className="divide-y rounded-md border text-sm" aria-label="Folders">
+        {folders.items.map((f) => <li key={f.id}><button type="button" className="flex w-full items-center gap-2 px-3 py-1.5 text-left hover:bg-accent" onClick={() => go([...trail, f])}><Folder className="size-4" aria-hidden />{f.name}</button></li>)}
+      </ul>
+      {folders.next ? <Button size="sm" variant="outline" className="self-start" loading={folders.loading} onClick={folders.more}>Load more folders</Button> : null}
+      {parent !== "root" ? (
+        <>
+          {files.error ? <ApiError compact error={files.error} title="Could not list the files" onRetry={() => void files.refetch()} /> : null}
+          <ul className="divide-y rounded-md border text-sm" aria-label="Files">
+            {files.items.map((f) => <li key={f.id} className="flex justify-between px-3 py-1.5"><span>{f.name}</span><span className="text-xs text-muted-foreground">{f.mimeType?.split(".").pop()}</span></li>)}
+          </ul>
+          {files.next ? <Button size="sm" variant="outline" className="self-start" loading={files.loading} onClick={files.more}>Load more files</Button> : null}
+        </>
+      ) : null}
+      {!folders.loading && !folders.error && folders.items.length === 0 && (parent === "root" || (!files.loading && files.items.length === 0)) ? <p className="text-sm text-muted-foreground">This folder is empty.</p> : null}
+    </div>
+  );
+}
+
+function ToolCard({ tool, connectUrl }: { tool: (typeof TOOLS)[number]; connectUrl: string }) {
+  const brand = useBrand();
+  const [drive, setDrive] = useState(false);
+  const status = useG8Query((signal) => g8Get(tool.path, undefined, { signal }), [tool.path]);
+  const test = useG8Mutation(() => g8Post("/integrations/google-workspace/test", {}));
+  const connected = looksConnected(status.data);
+  const verdict = (test.data as { data?: { success?: boolean; ok?: boolean; message?: string; error?: string } } | undefined)?.data;
+  const body = ((status.data as { data?: Record<string, unknown> } | undefined)?.data ?? {}) as Record<string, unknown>;
+  const facts = Object.fromEntries(Object.entries(body).filter(([k]) => !["connected", "is_connected"].includes(k)));
+  return (
+    <SectionCard title={tool.label} description={tool.note} actions={status.data ? <StatusPill tone={connected ? "positive" : "neutral"} dot>{connected ? "Connected" : "Not connected"}</StatusPill> : undefined}>
+      {status.error ? <ApiError error={status.error} title={`Could not check ${tool.label}`} onRetry={() => void status.refetch()} /> : null}
+      {status.loading && !status.data ? <Skeleton className="h-10 w-full" /> : null}
+      {status.data && !connected ? <a className="text-sm underline" href={connectUrl} target="_blank" rel="noreferrer">Connect {tool.label} in {brand.linkLabel}</a> : null}
+      {connected ? <FactList data={facts} empty="Connected." /> : null}
+      {connected && tool.key === "google" ? (
+        <div className="mt-3 flex flex-col gap-2">
+          <div className="flex flex-wrap items-center gap-2">
+            <Button size="sm" variant="outline" loading={test.loading} onClick={() => void test.mutate(undefined)}>Test connection</Button>
+            <Button size="sm" variant="outline" aria-expanded={drive} onClick={() => setDrive((v) => !v)}>{drive ? "Hide Drive" : "Browse Drive"}</Button>
+            {test.data !== undefined ? <span role="status" className="text-sm" data-testid="google-test">{verdict?.success === false || verdict?.ok === false ? `The test failed${verdict.message || verdict.error ? `: ${verdict.message ?? verdict.error}` : ""}` : "Google answered: the connection works."}</span> : null}
+          </div>
+          {test.error ? <ApiError error={test.error} title="The test could not run" /> : null}
+          {drive ? <DriveBrowser /> : null}
+        </div>
+      ) : null}
+    </SectionCard>
+  );
+}
+
+export function WorkspaceTools({ connectUrl: connectUrlProp, className }: WorkspaceToolsProps) {
+  const brand = useBrand();
+  const connectUrl = connectUrlProp ?? brandUrl(brand, GRAPH8_APP_INTEGRATIONS_PATH);
+  return <div className={`grid gap-4 md:grid-cols-2 ${className ?? ""}`}>{TOOLS.map((t) => <ToolCard key={t.key} tool={t} connectUrl={connectUrl} />)}</div>;
+}

package/blocks/integrations/lib/crm-utils.ts

@@ -0,0 +1,39 @@
+"use client";
+
+/** Helpers for reading records that come back in a CRM's own shape (HubSpot properties, Salesforce fields, Pipedrive values). */
+
+export type CrmRecord = Record<string, unknown> & { id?: string | number; properties?: Record<string, unknown> };
+
+const pick = (r: CrmRecord, keys: string[]): string => {
+  const sources: Array<Record<string, unknown>> = [r, (r.properties ?? {}) as Record<string, unknown>, ((r as { attributes?: Record<string, unknown> }).attributes ?? {}) as Record<string, unknown>];
+  for (const src of sources) for (const k of keys) { const v = src[k]; if (typeof v === "string" && v.trim()) return v; if (typeof v === "number") return String(v); }
+  return "";
+};
+
+/** A readable name for a CRM record of any kind. */
+export function crmRecordTitle(r: CrmRecord): string {
+  const first = pick(r, ["firstname", "first_name", "FirstName"]);
+  const last = pick(r, ["lastname", "last_name", "LastName"]);
+  return pick(r, ["name", "full_name", "Name", "dealname", "title", "subject"]) || [first, last].filter(Boolean).join(" ") || pick(r, ["email", "Email", "domain", "company"]) || String(r.id ?? "Record");
+}
+
+export function crmRecordSubtitle(r: CrmRecord): string {
+  return [pick(r, ["email", "Email"]), pick(r, ["company", "Company", "domain"]), pick(r, ["stage", "dealstage", "StageName", "status", "Status"])].filter(Boolean).join(" - ");
+}
+
+/** The record's own scalar fields (properties flattened in), for a detail view. Objects and empty values are left out. */
+export function flattenRecord(r: CrmRecord): Record<string, string> {
+  const out: Record<string, string> = {};
+  const add = (src: Record<string, unknown>) => { for (const [k, v] of Object.entries(src)) if ((typeof v === "string" && v) || typeof v === "number" || typeof v === "boolean") out[k] = String(v); };
+  add(r);
+  add((r.properties ?? {}) as Record<string, unknown>);
+  return out;
+}
+
+export const CRM_ENTITIES = [
+  { id: "contacts", label: "Contacts" },
+  { id: "companies", label: "Companies" },
+  { id: "deals", label: "Deals" },
+  { id: "leads", label: "Leads" },
+] as const;
+export type CrmEntity = (typeof CRM_ENTITIES)[number]["id"];

package/blocks/integrations/lib/facts.tsx

@@ -0,0 +1,13 @@
+"use client";
+
+/** Renders an open-shaped API object (health, scorecard, status) as labelled facts without guessing its fields. */
+import { KeyValueList } from "@/g8/components/screen/key-value-list";
+
+const label = (k: string): string => { const t = k.replace(/_/g, " "); return t.charAt(0).toUpperCase() + t.slice(1); };
+const show = (v: unknown): string => (v == null ? "" : typeof v === "string" ? v : typeof v === "number" || typeof v === "boolean" ? String(v) : JSON.stringify(v));
+
+export function FactList({ data, empty = "Nothing reported yet." }: { data: unknown; empty?: string }) {
+  const entries = Object.entries((data && typeof data === "object" && !Array.isArray(data) ? data : {}) as Record<string, unknown>).filter(([, v]) => v != null && v !== "");
+  if (entries.length === 0) return <p className="text-sm text-muted-foreground">{empty}</p>;
+  return <KeyValueList columns={2} items={entries.map(([k, v]) => ({ label: label(k), value: show(v), wide: typeof v === "object", mono: typeof v === "object" }))} />;
+}

package/blocks/integrations/lib/integrations-utils.ts

@@ -2,9 +2,16 @@
 
 /** Types and helpers shared by the integrations components. */
 
+import { DEFAULT_BRAND } from "@/g8/hooks/use-brand";
+
 export const CRM_PROVIDERS = ["hubspot", "salesforce", "pipedrive", "zoho", "sugarcrm"] as const;
 export type CrmProvider = (typeof CRM_PROVIDERS)[number];
 
+/** The connection type the API expects (`CrmConnectionType`): Zoho is `zoho-crm`, the others are their own id. */
+export function crmType(provider: string): string {
+  return provider === "zoho" ? "zoho-crm" : provider;
+}
+
 export const PROVIDER_LABELS: Record<CrmProvider, string> = {
   hubspot: "HubSpot",
   salesforce: "Salesforce",
@@ -14,7 +21,10 @@ export const PROVIDER_LABELS: Record<CrmProvider, string> = {
 };
 
 /** Where the person completes an OAuth connection. The API has no way to run the consent screen for you. */
-export const GRAPH8_APP_INTEGRATIONS_URL = "https://app.graph8.com/studio/settings?tab=integrations";
+/** The path on the platform's web app; components resolve it against the brand (`brandUrl(useBrand(), ...)`). */
+export const GRAPH8_APP_INTEGRATIONS_PATH = "/studio/settings?tab=integrations";
+/** The default (graph8) URL. Kept for existing imports; prefer GRAPH8_APP_INTEGRATIONS_PATH with useBrand. */
+export const GRAPH8_APP_INTEGRATIONS_URL = `${DEFAULT_BRAND.appUrl}${GRAPH8_APP_INTEGRATIONS_PATH}`;
 
 export interface CrmSyncRow {
   provider: string;

package/blocks/integrations/lib/load-more.tsx

@@ -0,0 +1,141 @@
+"use client";
+
+/**
+ * Paging helpers for the agents block, in the same shape as the foundation's paging primitives (a list never stops silently at a
+ * cap: it shows "Load more" while the last page was full).
+ *
+ *   useLoadMoreList   offset + limit APIs (the next page starts at items.length).
+ *   useGrowingList    limit-only APIs (a bigger limit refetches the list from the start).
+ *   LoadMore          the footer button plus the error of a failed "more" request.
+ */
+import { useCallback, useEffect, useRef, useState } from "react";
+import { Button } from "@graph8/sdk/ui";
+import { ApiError } from "@/g8/components/api-error";
+
+export interface LoadMoreList<T> {
+  items: T[];
+  /** The first page is loading (or reloading after the deps changed). */
+  loading: boolean;
+  loadingMore: boolean;
+  error: unknown;
+  moreError: unknown;
+  hasMore: boolean;
+  /** A limit-only API stopped at its own maximum: there are more rows the API will not return. */
+  capped?: boolean;
+  loadMore: () => void;
+  reload: () => void;
+}
+
+interface Options {
+  pageSize?: number;
+  enabled?: boolean;
+  /** useGrowingList: the largest `limit` the API accepts. */
+  max?: number;
+}
+
+/** Offset paging. `fetchPage(offset, limit)` returns that page's rows; a full page means there may be more. */
+export function useLoadMoreList<T>(
+  fetchPage: (offset: number, limit: number, signal: AbortSignal) => Promise<T[]>,
+  deps: readonly unknown[],
+  { pageSize = 50, enabled = true }: Options = {},
+): LoadMoreList<T> {
+  const [items, setItems] = useState<T[]>([]);
+  const [loading, setLoading] = useState(enabled);
+  const [loadingMore, setLoadingMore] = useState(false);
+  const [error, setError] = useState<unknown>(null);
+  const [moreError, setMoreError] = useState<unknown>(null);
+  const [hasMore, setHasMore] = useState(false);
+  const [tick, setTick] = useState(0);
+  const fetchRef = useRef(fetchPage);
+  fetchRef.current = fetchPage;
+  const gen = useRef(0);
+  const count = useRef(0);
+  const sig = JSON.stringify([...deps, enabled, pageSize]);
+  const lastSig = useRef(sig);
+
+  useEffect(() => {
+    if (!enabled) { setLoading(false); return; }
+    const mine = ++gen.current;
+    const ctl = new AbortController();
+    // A reload() keeps showing the rows it has until the fresh first page lands; a changed filter starts from nothing.
+    const fresh = lastSig.current !== sig;
+    lastSig.current = sig;
+    setLoading(true); setError(null); setMoreError(null);
+    if (fresh) { setItems([]); setHasMore(false); count.current = 0; }
+    // A reload() refetches as many pages as were showing, so a row opened from page 2 does not vanish; a changed filter starts at page 1.
+    const want = fresh ? pageSize : Math.max(count.current, pageSize);
+    const load = async (): Promise<T[]> => {
+      const all: T[] = [];
+      let last = pageSize;
+      while (all.length < want && last >= pageSize) {
+        const page = await fetchRef.current(all.length, pageSize, ctl.signal);
+        all.push(...page);
+        last = page.length;
+      }
+      return all;
+    };
+    load().then((rows) => {
+      if (gen.current !== mine) return;
+      setItems(rows); count.current = rows.length; setHasMore(rows.length > 0 && rows.length % pageSize === 0); setLoading(false);
+    }, (e) => { if (gen.current === mine) { setError(e); setLoading(false); } });
+    return () => ctl.abort();
+  }, [...deps, enabled, pageSize, tick]); // eslint-disable-line react-hooks/exhaustive-deps
+
+  const loadMore = useCallback(() => {
+    const mine = gen.current;
+    setLoadingMore(true); setMoreError(null);
+    fetchRef.current(count.current, pageSize, new AbortController().signal).then((rows) => {
+      if (gen.current !== mine) return;
+      count.current += rows.length;
+      setItems((prev) => [...prev, ...rows]); setHasMore(rows.length >= pageSize); setLoadingMore(false);
+    }, (e) => { if (gen.current === mine) { setMoreError(e); setLoadingMore(false); } });
+  }, [pageSize]);
+
+  return { items, loading, loadingMore, error, moreError, hasMore, loadMore, reload: () => setTick((t) => t + 1) };
+}
+
+/** Limit-only APIs: asks for `step` rows, and "Load more" asks again for `step` more from the start. */
+export function useGrowingList<T>(
+  fetchRows: (limit: number, signal: AbortSignal) => Promise<T[]>,
+  deps: readonly unknown[],
+  { pageSize = 50, enabled = true, max = Infinity }: Options = {},
+): LoadMoreList<T> {
+  const [limit, setLimit] = useState(pageSize);
+  const [rows, setRows] = useState<T[]>([]);
+  const [loading, setLoading] = useState(enabled);
+  const [error, setError] = useState<unknown>(null);
+  const [tick, setTick] = useState(0);
+  const [growing, setGrowing] = useState(false);
+  const fetchRef = useRef(fetchRows);
+  fetchRef.current = fetchRows;
+  const depKey = JSON.stringify(deps);
+  const lastDeps = useRef(depKey);
+
+  useEffect(() => { if (lastDeps.current !== depKey) { lastDeps.current = depKey; setLimit(pageSize); } }, [depKey, pageSize]);
+  useEffect(() => {
+    if (!enabled) { setLoading(false); return; }
+    let live = true;
+    const ctl = new AbortController();
+    setLoading(true); setError(null);
+    fetchRef.current(limit, ctl.signal).then((r) => { if (live) { setRows(r); setLoading(false); setGrowing(false); } }, (e) => { if (live) { setError(e); setLoading(false); setGrowing(false); } });
+    return () => { live = false; ctl.abort(); };
+  }, [limit, depKey, enabled, tick]); // eslint-disable-line react-hooks/exhaustive-deps
+
+  return {
+    items: rows, loading: loading && !growing, loadingMore: loading && growing, error: growing ? null : error, moreError: growing ? error : null,
+    hasMore: !loading && rows.length >= limit && limit < max, capped: !loading && rows.length >= limit && limit >= max,
+    loadMore: () => { setGrowing(true); setLimit((l) => Math.min(max, l + pageSize)); }, reload: () => setTick((t) => t + 1),
+  };
+}
+
+/** The footer of a paged list. Renders nothing when everything is shown. */
+export function LoadMore<T>({ list, noun = "rows" }: { list: LoadMoreList<T>; noun?: string }) {
+  if (!list.hasMore && !list.moreError && !list.capped) return null;
+  return (
+    <div className="flex flex-col items-center gap-2 py-2">
+      {list.moreError ? <ApiError compact error={list.moreError} title={`Could not load more ${noun}`} onRetry={list.loadMore} /> : null}
+      {list.capped ? <p className="text-xs text-muted-foreground">Showing the latest {list.items.length} {noun}. The API returns no more than this.</p> : null}
+      {list.hasMore && !list.moreError ? <Button size="sm" variant="outline" loading={list.loadingMore} onClick={list.loadMore}>Load more {noun}</Button> : null}
+    </div>
+  );
+}

package/blocks/intent/README.md

@@ -5,6 +5,20 @@ and score any account by strength and buying-committee coverage. The Apollo / 6s
 
 Depends on: `crm` (account rows link to your company records). Install: `npx @graph8/sdk add intent`.
 
+## Screens
+
+`IntentScreen` (`components/intent-screen.tsx`) is the finished page: copy it as your route. No props are required.
+
+- **Accounts tab**: the intent feed with a 7/30/90 day window, a high-intent filter, a keyword scope chip (`?kw=<keyword id>`),
+  a stat strip, and a detail panel for the clicked account (signals, trend, top keywords, buying-committee coverage). Deep link:
+  `?id=<company id>`; an account with no signal in the window shows "No intent for this account".
+  "Who visited this URL" lives under the table.
+- **Keywords tab**: track keywords, preview then track a competitor domain, load the companies behind a keyword, stop tracking.
+  Clicking a keyword opens its detail; "Show accounts" there scopes the Accounts tab to it. Every billable or destructive
+  call is confirmed.
+- Slots: `toolbarActions`, `renderDetailActions(account)`, `extraDetailTabs`.
+- Prerequisites: ABM intent enabled for the workspace (403 is explained inline) and something to measure.
+
 ## Components
 
 | Component | What it does | Tiers |

package/blocks/intent/block.json

@@ -61,6 +61,31 @@
       "tiers": [
         "read"
       ]
+    },
+    {
+      "name": "IntentScreen",
+      "file": "components/intent-screen.tsx",
+      "purpose": "Finished buyer-intent page: accounts feed with window and keyword filters, account detail panel (signals, top keywords, buying committee) and keyword/competitor tracking.",
+      "operations": [
+        "list_abm_companies_intent_abm_companies_get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "KeywordDetail",
+      "file": "components/keyword-detail.tsx",
+      "purpose": "Complete screen for one tracked keyword: fields, accounts showing intent, companies behind it, stop tracking.",
+      "operations": [
+        "keywords_list_intent_keywords_list_post",
+        "keyword_companies_intent_keywords__keyword_id__companies_post",
+        "keywords_delete_intent_keywords__keyword_id__delete"
+      ],
+      "tiers": [
+        "billable",
+        "destructive"
+      ]
     }
   ],
   "hooks": [
@@ -133,6 +158,7 @@
     }
   ],
   "peerDependencies": {
-    "react": ">=18"
+    "react": ">=18",
+    "lucide-react": ">=0.400"
   }
 }

package/blocks/intent/components/account-intent-score.tsx

@@ -36,7 +36,7 @@ function Coverage({ account }: { account: AbmAccount }) {
         <li
           key={category}
           title={`${cov.contact_count ?? 0} contacts, ${cov.signal_count ?? 0} signals`}
-          className="rounded border border-gray-200 px-1.5 py-0.5 text-xs text-gray-700"
+          className="rounded border border-border px-1.5 py-0.5 text-xs text-foreground"
         >
           {category}: {cov.barometer ?? "none"}
         </li>
@@ -52,9 +52,9 @@ function Badge({ account, compact }: { account: AbmAccount; compact?: boolean })
       <div className="flex items-center gap-2">
         <span className={`rounded px-2 py-0.5 text-xs font-medium ${strengthClass(account.account_strength)}`}>{label}</span>
         {account.is_high_intent ? (
-          <span className="rounded bg-red-100 px-2 py-0.5 text-xs font-medium text-red-800">High intent</span>
+          <span className="rounded bg-error px-2 py-0.5 text-xs font-medium text-error-foreground">High intent</span>
         ) : null}
-        <span className="text-xs text-gray-500">{account.total_signal_count ?? 0} signals</span>
+        <span className="text-xs text-muted-foreground">{account.total_signal_count ?? 0} signals</span>
       </div>
       {compact ? null : <Coverage account={account} />}
     </div>
@@ -69,7 +69,7 @@ export function AccountIntentScore({ companyIds, days = 30, compact, className }
     const status = (error as { status?: number }).status;
     const text = status === 403 ? "Intent scoring is not enabled for this workspace." : "Could not load intent.";
     return (
-      <span role="alert" className={`text-xs text-red-700 ${className ?? ""}`}>
+      <span role="alert" className={`text-xs text-error-foreground ${className ?? ""}`}>
         {text}
       </span>
     );
@@ -81,7 +81,7 @@ export function AccountIntentScore({ companyIds, days = 30, compact, className }
         return account ? (
           <Badge key={id} account={{ ...account, company_id: id }} compact={compact} />
         ) : (
-          <span key={id} className="block text-xs text-gray-500">
+          <span key={id} className="block text-xs text-muted-foreground">
             No signal
           </span>
         );