@graph8/sdk 0.361.0 → 0.370.0

package/blocks/nurture/block.json

@@ -14,21 +14,41 @@
     "lists"
   ],
   "operations": [
-    "list_nurtures_nurtures_get",
-    "pause_nurture_nurtures__nurture_id__pause_post",
-    "resume_nurture_nurtures__nurture_id__resume_post",
-    "duplicate_nurture_nurtures__nurture_id__duplicate_post",
-    "delete_nurture_nurtures__nurture_id__delete",
-    "list_my_mailboxes_mailboxes_my_get",
-    "list_lists_lists_get",
+    "add_contacts_to_list_lists__list_id__contacts_post",
     "create_nurture_nurtures_post",
-    "update_nurture_nurtures__nurture_id__patch",
+    "delete_nurture_nurtures__nurture_id__delete",
+    "duplicate_nurture_nurtures__nurture_id__duplicate_post",
     "get_nurture_nurtures__nurture_id__get",
-    "add_contacts_to_list_lists__list_id__contacts_post",
+    "get_sequence_performance_by_id_analytics_outbound_sequence_performance__sequence_id__get",
     "launch_nurture_nurtures__nurture_id__launch_post",
-    "get_sequence_performance_by_id_analytics_outbound_sequence_performance__sequence_id__get"
+    "list_lists_lists_get",
+    "list_my_mailboxes_mailboxes_my_get",
+    "list_nurtures_nurtures_get",
+    "pause_nurture_nurtures__nurture_id__pause_post",
+    "resume_nurture_nurtures__nurture_id__resume_post",
+    "update_nurture_nurtures__nurture_id__patch"
   ],
   "components": [
+    {
+      "name": "NurtureScreen",
+      "file": "components/nurture-screen.tsx",
+      "purpose": "Finished nurture workspace: list with state and row actions, create sheet, detail with results, audience and launch, and settings.",
+      "operations": [
+        "delete_nurture_nurtures__nurture_id__delete",
+        "duplicate_nurture_nurtures__nurture_id__duplicate_post",
+        "get_nurture_nurtures__nurture_id__get",
+        "list_lists_lists_get",
+        "list_my_mailboxes_mailboxes_my_get",
+        "list_nurtures_nurtures_get",
+        "pause_nurture_nurtures__nurture_id__pause_post",
+        "resume_nurture_nurtures__nurture_id__resume_post"
+      ],
+      "tiers": [
+        "read",
+        "write",
+        "destructive"
+      ]
+    },
     {
       "name": "NurtureBuilder",
       "file": "components/nurture-builder.tsx",
@@ -51,9 +71,10 @@
       "file": "components/nurture-form.tsx",
       "purpose": "Create a nurture (name, sender mailbox, audience, email steps) or edit its settings.",
       "operations": [
-        "list_my_mailboxes_mailboxes_my_get",
-        "list_lists_lists_get",
         "create_nurture_nurtures_post",
+        "get_nurture_nurtures__nurture_id__get",
+        "list_lists_lists_get",
+        "list_my_mailboxes_mailboxes_my_get",
         "update_nurture_nurtures__nurture_id__patch"
       ],
       "tiers": [
@@ -186,6 +207,7 @@
     }
   ],
   "peerDependencies": {
-    "react": ">=18"
+    "react": ">=18",
+    "lucide-react": ">=0.400.0"
   }
 }

package/blocks/nurture/components/nurture-builder.tsx

@@ -25,6 +25,7 @@ import { useG8Query } from "@/g8/hooks/use-g8-query";
 import { isFinished, isLiveLike, isNurtureOff, isPaused, statusOf } from "../lib/nurture-types";
 import type { Nurture } from "../lib/nurture-types";
 import { NurtureForm } from "./nurture-form";
+import { useBrand } from "@/g8/hooks/use-brand";
 
 export interface NurtureBuilderProps {
   /** Called when a nurture is chosen for launch/enrollment (render NurtureEnroll with its id). */
@@ -35,6 +36,7 @@ export interface NurtureBuilderProps {
 type Action = { kind: "pause" | "duplicate"; nurture: Nurture };
 
 export function NurtureBuilder({ onSelectNurture, pageSize = 50 }: NurtureBuilderProps) {
+  const brand = useBrand();
   const [form, setForm] = useState<{ nurture?: Nurture } | null>(null);
   const [toArchive, setToArchive] = useState<Nurture | null>(null);
   const [toResume, setToResume] = useState<Nurture | null>(null);
@@ -49,7 +51,7 @@ export function NurtureBuilder({ onSelectNurture, pageSize = 50 }: NurtureBuilde
   const resume = useG8Mutation((n: Nurture) => g8Post(`/nurtures/${encodeURIComponent(n.id)}/resume`), { onSuccess: () => { setToResume(null); void list.refetch(); } });
   const archive = useG8Mutation((n: Nurture) => g8Delete(`/nurtures/${encodeURIComponent(n.id)}`), { onSuccess: () => { setToArchive(null); void list.refetch(); } });
 
-  if (isNurtureOff(list.error)) return <EmptyState title="Nurture is not enabled" description="Nurture is behind a feature flag for this workspace. Ask graph8 to turn it on, then reload." />;
+  if (isNurtureOff(list.error)) return <EmptyState title="Nurture is not enabled" description={`Nurture is behind a feature flag for this workspace. Ask ${brand.linkLabel} to turn it on, then reload.`} />;
   if (list.error) return <ApiError error={list.error} title="Could not load nurtures" onRetry={() => void list.refetch()} />;
   if (form) {
     return (

package/blocks/nurture/components/nurture-enroll.tsx

@@ -24,6 +24,8 @@ import { useG8Mutation } from "@/g8/hooks/use-g8-mutation";
 import { useG8Query } from "@/g8/hooks/use-g8-query";
 import { isDrafted, isNurtureMissing, isNurtureOff, statusOf } from "../lib/nurture-types";
 import type { ListOption, Nurture } from "../lib/nurture-types";
+import { pluralWord } from "@/g8/lib/plural";
+import { useBrand } from "@/g8/hooks/use-brand";
 
 export interface NurtureEnrollProps {
   nurtureId: string;
@@ -33,6 +35,7 @@ export interface NurtureEnrollProps {
 }
 
 export function NurtureEnroll({ nurtureId, contactIds = [], onLaunched }: NurtureEnrollProps) {
+  const brand = useBrand();
   const base = `/nurtures/${encodeURIComponent(nurtureId)}`;
   const nurture = useG8Query((signal) => g8Get<Nurture>(base, {}, { signal }).then((r) => r.data), [base]);
   const lists = useG8Query((signal) => g8Get<ListOption[]>("/lists", { limit: 200 }, { signal }).then((r) => r.data ?? []), []);
@@ -55,7 +58,7 @@ export function NurtureEnroll({ nurtureId, contactIds = [], onLaunched }: Nurtur
   const addContacts = useG8Mutation((id: number) => g8Post(`/lists/${id}/contacts`, { contact_ids: [...contactIds] }), { onSuccess: () => void lists.refetch() });
   const launch = useG8Mutation(() => g8Post(`${base}/launch`), { onSuccess: () => { setConfirming(false); void nurture.refetch(); onLaunched?.(); } });
 
-  if (isNurtureOff(nurture.error)) return <EmptyState title="Nurture is not enabled" description="Nurture is behind a feature flag for this workspace. Ask graph8 to turn it on." />;
+  if (isNurtureOff(nurture.error)) return <EmptyState title="Nurture is not enabled" description={`Nurture is behind a feature flag for this workspace. Ask ${brand.linkLabel} to turn it on.`} />;
   if (isNurtureMissing(nurture.error)) return <EmptyState title="This nurture no longer exists" description="It may have been deleted, or it is not yours to see. Pick another nurture." />;
   if (nurture.error) return <ApiError error={nurture.error} title="Could not load the nurture" onRetry={() => void nurture.refetch()} />;
   if (!nurture.data) return <Skeleton className="h-40 w-full" aria-busy="true" />;
@@ -76,9 +79,9 @@ export function NurtureEnroll({ nurtureId, contactIds = [], onLaunched }: Nurtur
           </select>
           <div className="flex gap-2">
             <Button size="sm" variant="outline" loading={setAudience.loading} disabled={!listId || attached || !isDrafted(nurture.data)} onClick={() => void setAudience.mutate(Number(listId))}>Use this list</Button>
-            {contactIds.length > 0 ? <Button size="sm" variant="outline" loading={addContacts.loading} disabled={!attached} onClick={() => void addContacts.mutate(Number(listId))}>Add {contactIds.length} selected {contactIds.length === 1 ? "contact" : "contacts"}</Button> : null}
+            {contactIds.length > 0 ? <Button size="sm" variant="outline" loading={addContacts.loading} disabled={!attached} onClick={() => void addContacts.mutate(Number(listId))}>Add {contactIds.length} selected {pluralWord(contactIds.length, "contact")}</Button> : null}
           </div>
-          {attached ? <p className="text-sm">This nurture will engage <strong>{audience.toLocaleString()}</strong> {audience === 1 ? "contact" : "contacts"}.</p> : null}
+          {attached ? <p className="text-sm">This nurture will engage <strong>{audience.toLocaleString()}</strong> {pluralWord(audience, "contact")}.</p> : null}
         </div>
         {[setAudience.error, addContacts.error].filter(Boolean).map((e, i) => <ApiError key={i} error={e} title="That did not work" />)}
         {isDrafted(nurture.data) ? (

package/blocks/nurture/components/nurture-form.tsx

@@ -13,13 +13,14 @@
  */
 
 import { useState } from "react";
-import { Button, Input, Label, Textarea } from "@graph8/sdk/ui";
+import { Button, Input, Label, Skeleton, Textarea } from "@graph8/sdk/ui";
 import { ApiError } from "@/g8/components/api-error";
 import { g8Get, g8Patch, g8Post } from "@/g8/lib/g8-client";
 import { useG8Mutation } from "@/g8/hooks/use-g8-mutation";
 import { useG8Query } from "@/g8/hooks/use-g8-query";
 import { channelPayload, stepsPayload } from "../lib/nurture-types";
 import type { ListOption, MailboxOption, Nurture, StepDraft } from "../lib/nurture-types";
+import { useBrand } from "@/g8/hooks/use-brand";
 
 export interface NurtureFormProps {
   /** Edit this nurture; omit to create a new one. */
@@ -30,7 +31,22 @@ export interface NurtureFormProps {
 
 const SELECT = "border-input bg-background h-9 w-full rounded-md border px-2 text-sm disabled:opacity-50";
 
+/**
+ * Edit mode reads the FULL nurture (GET /nurtures/{id}) before it shows anything: the row a list hands over may omit
+ * fields (description, audience, flags), and saving a form seeded from it would blank them. Create mode needs no record.
+ */
 export function NurtureForm({ nurture, onSaved, onCancel }: NurtureFormProps) {
+  const full = useG8Query((signal) => g8Get<Nurture>(`/nurtures/${encodeURIComponent(nurture!.id)}`, {}, { signal }).then((r) => r.data), [nurture?.id], { enabled: Boolean(nurture) });
+  if (nurture) {
+    if (full.error && (!full.data || full.data.id !== nurture.id)) return <ApiError error={full.error} title="Could not load this nurture" onRetry={() => void full.refetch()} />;
+    if (!full.data || full.data.id !== nurture.id) return <Skeleton className="h-40 w-full" aria-label="Loading nurture" />;
+    return <NurtureFormFields key={full.data.id} nurture={full.data} onSaved={onSaved} onCancel={onCancel} />;
+  }
+  return <NurtureFormFields onSaved={onSaved} onCancel={onCancel} />;
+}
+
+function NurtureFormFields({ nurture, onSaved, onCancel }: NurtureFormProps) {
+  const brand = useBrand();
   const editing = Boolean(nurture);
   const [name, setName] = useState(nurture?.name ?? "");
   const [description, setDescription] = useState(nurture?.description ?? "");
@@ -50,7 +66,11 @@ export function NurtureForm({ nurture, onSaved, onCancel }: NurtureFormProps) {
   const save = useG8Mutation(async () => {
     const flags = { finish_on_reply: finishOnReply, send_in_same_thread: sameThread, include_unsubscribe_cta: unsubscribe };
     if (nurture) {
-      return (await g8Patch<Nurture>(`/nurtures/${encodeURIComponent(nurture.id)}`, { name: name.trim(), description: description.trim() || null, associated_list_id: listId ? Number(listId) : null, ...flags })).data;
+      // Only what the person changed is sent.
+      const next = { name: name.trim(), description: description.trim() || null, associated_list_id: listId ? Number(listId) : null, ...flags };
+      const before = { name: nurture.name, description: nurture.description?.trim() || null, associated_list_id: nurture.associated_list_id ? Number(nurture.associated_list_id) : null, finish_on_reply: nurture.finish_on_reply ?? true, send_in_same_thread: nurture.send_in_same_thread ?? true, include_unsubscribe_cta: nurture.include_unsubscribe_cta ?? true };
+      const diff = Object.fromEntries(Object.entries(next).filter(([k, v]) => v !== before[k as keyof typeof before]));
+      return (await g8Patch<Nurture>(`/nurtures/${encodeURIComponent(nurture.id)}`, diff)).data;
     }
     return (await g8Post<Nurture>("/nurtures", {
       name: name.trim(),
@@ -75,7 +95,7 @@ export function NurtureForm({ nurture, onSaved, onCancel }: NurtureFormProps) {
             <option value="">{mailboxes.loading ? "Loading..." : "Choose a mailbox"}</option>
             {(mailboxes.data ?? []).map((m) => <option key={m.id} value={m.id}>{m.email}</option>)}
           </select>
-          {!editing && !mailboxes.loading && (mailboxes.data ?? []).length === 0 ? <p className="mt-1 text-xs text-amber-700">No mailbox is connected. Connect one in graph8 first (Google and Microsoft sign-in happens in the app).</p> : null}
+          {!editing && !mailboxes.loading && (mailboxes.data ?? []).length === 0 ? <p className="mt-1 text-xs text-amber-700">No mailbox is connected. Connect one in {brand.linkLabel} first (Google and Microsoft sign-in happens in the app).</p> : null}
         </div>
         <div>
           <Label htmlFor="g8-nurture-list" className="mb-1">Audience list (consented contacts)</Label>

package/blocks/nurture/components/nurture-screen.tsx

@@ -0,0 +1,283 @@
+"use client";
+
+/**
+ * NurtureScreen: the finished nurture workspace. No props needed.
+ *
+ * Composes: ScreenLayout (title, stats), Toolbar (search, status filter), SplitView + DetailPanel (selected
+ * nurture, deep link `?id=`), FormSheet (new nurture via NurtureForm), NurtureStats (overview and results),
+ * NurtureEnroll (audience list, consent, Go live), NurtureForm in edit mode (settings).
+ *
+ * The detail panel (`?id=`) has Overview, Details (every field and each email), Audience and launch, and Settings;
+ * `&view=full` shows it as a full page.
+ *
+ * User flows: see every nurture with its state, search and filter, create a nurture (sender mailbox, audience,
+ * email steps), open one to read its results, choose the audience and add selected contacts, tick consent and go
+ * live (confirmed with the audience size), pause, resume (confirmed), duplicate, edit settings and archive
+ * (confirmed). Connecting a mailbox needs Google or Microsoft sign-in, which only exists in the graph8 app, so
+ * the create sheet links out when no mailbox is connected.
+ *
+ * SDK operations: listNurtures, listMyMailboxes (only to detect "no mailbox"), pauseNurture, resumeNurture
+ * (external-style confirm), duplicateNurture, deleteNurture (destructive, confirmed); the rest live in the parts.
+ */
+
+import { useState } from "react";
+import type { ReactNode } from "react";
+import { Copy, ExternalLink, HeartHandshake, Pause, Play, Plus, Trash2 } from "lucide-react";
+import { Button, Skeleton } from "@graph8/sdk/ui";
+import { ApiError } from "@/g8/components/api-error";
+import { ConfirmSpendDialog } from "@/g8/components/confirm-spend-dialog";
+import { EmptyState } from "@/g8/components/empty-state";
+import { DetailPanel } from "@/g8/components/screen/detail-panel";
+import { FormSheet } from "@/g8/components/screen/form-sheet";
+import { KeyValueList } from "@/g8/components/screen/key-value-list";
+import { ScreenLayout } from "@/g8/components/screen/screen-layout";
+import { SectionCard } from "@/g8/components/screen/section-card";
+import { SplitView } from "@/g8/components/screen/split-view";
+import { StatusPill } from "@/g8/components/screen/status-pill";
+import type { Tone } from "@/g8/components/screen/status-pill";
+import { Toolbar } from "@/g8/components/screen/toolbar";
+import { useUrlState } from "@/g8/hooks/use-url-state";
+import { g8Delete, g8Get, g8Post } from "@/g8/lib/g8-client";
+import { useG8Mutation } from "@/g8/hooks/use-g8-mutation";
+import { useG8Query } from "@/g8/hooks/use-g8-query";
+import { isDrafted, isFinished, isLiveLike, isNurtureOff, isPaused, statusOf } from "../lib/nurture-types";
+import type { ListOption, MailboxOption, Nurture } from "../lib/nurture-types";
+import { NurtureEnroll } from "./nurture-enroll";
+import { NurtureForm } from "./nurture-form";
+import { NurtureStats } from "./nurture-stats";
+import { plural } from "@/g8/lib/plural";
+import { useBrand } from "@/g8/hooks/use-brand";
+
+export interface NurtureScreenProps {
+  /** Where a person connects a mailbox (Google and Microsoft sign-in only works in the graph8 app). */
+  connectMailboxUrl?: string;
+  /** Contact ids (for example selected elsewhere) offered as "add to the audience" in the launch tab. */
+  contactIds?: readonly number[];
+  renderRowActions?: (nurture: Nurture) => ReactNode;
+  renderDetailActions?: (nurture: Nurture) => ReactNode;
+  /** Shown in the launch tab for adding people to the audience (for example a contact picker from your CRM page). */
+  renderAudienceTools?: (nurture: Nurture) => ReactNode;
+  extraDetailTabs?: { id: string; label: string; render: (nurture: Nurture) => ReactNode }[];
+  toolbarActions?: ReactNode;
+  className?: string;
+}
+
+const SELECT = "border-input bg-background h-9 rounded-md border px-2 text-sm";
+
+function toneOf(n: Nurture): Tone {
+  if (isLiveLike(n)) return "positive";
+  if (isPaused(n)) return "warning";
+  if (isFinished(n)) return "neutral";
+  return "info";
+}
+
+function matchesFilter(n: Nurture, f: string): boolean {
+  if (!f) return true;
+  if (f === "drafted") return isDrafted(n);
+  if (f === "live") return isLiveLike(n);
+  if (f === "paused") return isPaused(n);
+  return isFinished(n);
+}
+
+interface StepRow { step_order?: number; time_interval?: number; step_data?: { subject?: string; body?: string } }
+
+const when = (v: string | null | undefined): string => (v ? new Date(v).toLocaleString() : "");
+const yesNo = (v: boolean | undefined, fallback: boolean): string => ((v ?? fallback) ? "Yes" : "No");
+
+/** Every field of one nurture, its audience and sender by name, and each email of the series. */
+function NurtureDetails({ nurtureId }: { nurtureId: string }) {
+  const one = useG8Query((signal) => g8Get<Nurture>(`/nurtures/${encodeURIComponent(nurtureId)}`, {}, { signal }).then((r) => r.data), [nurtureId]);
+  const lists = useG8Query((signal) => g8Get<ListOption[]>("/lists", { limit: 200 }, { signal }).then((r) => r.data ?? []), []);
+  const boxes = useG8Query((signal) => g8Get<{ mailboxes?: MailboxOption[] }>("/mailboxes/my", {}, { signal }).then((r) => r.data?.mailboxes ?? []), []);
+  if (one.error) return <ApiError error={one.error} title="Could not load the nurture" onRetry={() => void one.refetch()} />;
+  if (!one.data) return <Skeleton className="h-40 w-full" aria-busy="true" />;
+  const n = one.data;
+  const list = (lists.data ?? []).find((l) => l.id === n.associated_list_id);
+  const box = (boxes.data ?? []).find((m) => m.id === n.pinned_mailbox_id);
+  const steps = Array.isArray(n.steps) ? (n.steps as StepRow[]) : [];
+  return (
+    <div className="grid gap-4">
+      <KeyValueList
+        columns={2}
+        items={[
+          { label: "Name", value: n.name },
+          { label: "Status", value: statusOf(n) },
+          { label: "Description", value: n.description || "Not set" },
+          { label: "Audience list", value: list ? `${list.title} (${(list.contact_count ?? 0).toLocaleString()})` : n.associated_list_id ? `List ${n.associated_list_id}` : "None yet" },
+          { label: "Sends from", value: box?.email ?? (n.pinned_mailbox_id ? `Mailbox ${n.pinned_mailbox_id}` : "Not set") },
+          { label: "Stops on reply", value: yesNo(n.finish_on_reply, true) },
+          { label: "One thread", value: yesNo(n.send_in_same_thread, true) },
+          { label: "Opt-out line", value: yesNo(n.include_unsubscribe_cta, true) },
+          { label: "Shared", value: yesNo(n.is_shared, false) },
+          { label: "Created", value: when(n.created_at) || "Not set" },
+          { label: "Updated", value: when(n.updated_at) || "Not set" },
+          { label: "Nurture id", value: n.id },
+        ]}
+      />
+      <SectionCard title="Emails" description={steps.length ? "In the order they are sent." : "The series has no emails to show."}>
+        <ol className="grid gap-2">
+          {steps.map((st, i) => (
+            <li key={st.step_order ?? i} className="rounded-md border p-3 text-sm">
+              <p className="font-medium">{i + 1}. {st.step_data?.subject || "No subject"}</p>
+              <p className="text-muted-foreground text-xs">{i === 0 ? "Sent first, when you go live" : waitText(Math.round((st.time_interval ?? 0) / 86400))}</p>
+              {st.step_data?.body ? <p className="mt-1 whitespace-pre-wrap">{st.step_data.body}</p> : null}
+            </li>
+          ))}
+        </ol>
+      </SectionCard>
+    </div>
+  );
+}
+
+/** "Wait 1 day" / "Wait 3 days" after the previous email (`time_interval` is seconds). */
+function waitText(days: number): string {
+  return `Wait ${plural(days, "day")} after the previous email`;
+}
+
+export function NurtureScreen({ connectMailboxUrl: connectMailboxUrlProp, contactIds, renderRowActions, renderDetailActions, renderAudienceTools, extraDetailTabs, toolbarActions, className }: NurtureScreenProps) {
+  const brand = useBrand();
+  const connectMailboxUrl = connectMailboxUrlProp ?? brand.appUrl;
+  const [id, setId] = useUrlState("id", "");
+  const [view, setView] = useUrlState("view", "");
+  const expandProps = { onExpand: () => setView("full"), onCollapse: view === "full" ? () => setView(null) : undefined };
+  const [search, setSearch] = useState("");
+  const [filter, setFilter] = useState("");
+  const [creating, setCreating] = useState(false);
+  const [toResume, setToResume] = useState<Nurture | null>(null);
+  const [toArchive, setToArchive] = useState<Nurture | null>(null);
+  const [busy, setBusy] = useState<string | null>(null);
+
+  const list = useG8Query((signal) => g8Get<{ nurtures?: Nurture[] }>("/nurtures", { page: 1, limit: 100 }, { signal }).then((r) => r.data?.nurtures ?? []), []);
+  const mailboxes = useG8Query((signal) => g8Get<{ mailboxes?: MailboxOption[] }>("/mailboxes/my", {}, { signal }).then((r) => (r.data?.mailboxes ?? []).filter((m) => !m.is_archived)), [], { enabled: creating });
+
+  const act = useG8Mutation((a: { kind: "pause" | "duplicate"; nurture: Nurture }) => g8Post(`/nurtures/${encodeURIComponent(a.nurture.id)}/${a.kind}`, a.kind === "duplicate" ? {} : undefined), { onSuccess: () => void list.refetch() });
+  const run = async (kind: "pause" | "duplicate", nurture: Nurture): Promise<void> => {
+    setBusy(`${kind}:${nurture.id}`);
+    await act.mutate({ kind, nurture });
+    setBusy(null);
+  };
+  const resume = useG8Mutation((n: Nurture) => g8Post(`/nurtures/${encodeURIComponent(n.id)}/resume`), { onSuccess: () => { setToResume(null); void list.refetch(); } });
+  const archive = useG8Mutation((n: Nurture) => g8Delete(`/nurtures/${encodeURIComponent(n.id)}`), {
+    onSuccess: (_r, n) => { setToArchive(null); if (n.id === id) setId(null); void list.refetch(); },
+  });
+
+  if (isNurtureOff(list.error)) {
+    return <ScreenLayout title="Nurture" description="Lifecycle email series for people who agreed to hear from you." icon={<HeartHandshake className="size-5" />}><EmptyState title="Nurture is not enabled" description={`Nurture is switched off for this workspace. Ask ${brand.linkLabel} to turn it on, then reload.`} /></ScreenLayout>;
+  }
+
+  const all = list.data ?? [];
+  const q = search.trim().toLowerCase();
+  const shown = all.filter((n) => matchesFilter(n, filter) && (!q || n.name.toLowerCase().includes(q)));
+  const selected = all.find((n) => n.id === id);
+  const noMailbox = creating && !mailboxes.loading && (mailboxes.data ?? []).length === 0 && !mailboxes.error;
+
+  const rows = list.error ? <ApiError error={list.error} title="Could not load nurtures" onRetry={() => void list.refetch()} /> : list.loading && !list.data ? (
+    <div aria-busy="true" className="grid gap-2"><Skeleton className="h-16 w-full" /><Skeleton className="h-16 w-full" /><Skeleton className="h-16 w-full" /></div>
+  ) : shown.length === 0 ? (
+    <EmptyState icon={<HeartHandshake className="size-8" />} title={all.length === 0 ? "No nurtures yet" : "No nurtures match"} description={all.length === 0 ? "A nurture sends a short series of emails to people who agreed to hear from you, and stops for each person when they reply." : "Try another search or status."} action={all.length === 0 ? <Button onClick={() => setCreating(true)}>New nurture</Button> : undefined} />
+  ) : (
+    <ul className="grid gap-2">
+      {shown.map((n) => (
+        <li key={n.id} className={`flex flex-wrap items-center justify-between gap-2 rounded-md border p-3 ${n.id === id ? "bg-muted" : ""}`}>
+          <button type="button" className="min-w-0 flex-1 text-left" onClick={() => setId(n.id)}>
+            <span className="block truncate font-medium">{n.name}</span>
+            <span className="text-muted-foreground block text-xs">{Array.isArray(n.steps) && n.steps.length > 0 ? plural(n.steps.length, "email") : "Series"}{n.is_shared ? " · shared" : ""}</span>
+          </button>
+          <StatusPill tone={toneOf(n)}>{statusOf(n)}</StatusPill>
+          <div className="flex gap-1">
+            {isLiveLike(n) ? <Button size="sm" variant="ghost" aria-label={`Pause ${n.name}`} loading={busy === `pause:${n.id}`} disabled={busy !== null} onClick={() => void run("pause", n)}><Pause className="size-4" /></Button> : null}
+            {isPaused(n) ? <Button size="sm" variant="ghost" aria-label={`Resume ${n.name}`} onClick={() => setToResume(n)}><Play className="size-4" /></Button> : null}
+            <Button size="sm" variant="ghost" aria-label={`Duplicate ${n.name}`} loading={busy === `duplicate:${n.id}`} disabled={busy !== null} onClick={() => void run("duplicate", n)}><Copy className="size-4" /></Button>
+            {!isFinished(n) ? <Button size="sm" variant="ghost" aria-label={`Archive ${n.name}`} onClick={() => setToArchive(n)}><Trash2 className="size-4" /></Button> : null}
+            {renderRowActions?.(n)}
+          </div>
+        </li>
+      ))}
+    </ul>
+  );
+
+  const detail = selected ? (
+    <DetailPanel
+      title={selected.name}
+      subtitle={selected.description ?? undefined}
+      badges={<StatusPill tone={toneOf(selected)}>{statusOf(selected)}</StatusPill>}
+      actions={renderDetailActions?.(selected)}
+      onClose={() => { setId(null); setView(null); }}
+      {...expandProps}
+      tabs={[
+        { id: "overview", label: "Overview", content: <NurtureStats key={selected.id} nurtureId={selected.id} /> },
+        { id: "details", label: "Details", content: <NurtureDetails key={selected.id} nurtureId={selected.id} /> },
+        { id: "launch", label: "Audience and launch", content: (
+          <div className="grid gap-4">
+            <NurtureEnroll key={selected.id} nurtureId={selected.id} contactIds={contactIds} onLaunched={() => void list.refetch()} />
+            <SectionCard title="Add people to the audience" description="Enrolling means putting a contact in the audience list. Add people to that list from your contacts, or import a list, before you go live.">
+              {renderAudienceTools?.(selected)}
+            </SectionCard>
+          </div>
+        ) },
+        ...(!isFinished(selected) ? [{ id: "settings", label: "Settings", content: <NurtureForm key={selected.id} nurture={selected} onSaved={() => void list.refetch()} /> }] : []),
+        ...(extraDetailTabs ?? []).map((t) => ({ id: t.id, label: t.label, content: t.render(selected) })),
+      ]}
+    />
+  ) : null;
+
+  return (
+    <ScreenLayout
+      className={className}
+      title="Nurture"
+      description="Lifecycle email series for people who agreed to hear from you."
+      icon={<HeartHandshake className="size-5" />}
+      actions={<Button size="sm" onClick={() => setCreating(true)}><Plus className="size-4" />New nurture</Button>}
+      stats={[
+        { label: "Nurtures", value: all.length.toLocaleString() },
+        { label: "Live", value: all.filter(isLiveLike).length.toLocaleString(), tone: "positive" },
+        { label: "Drafted", value: all.filter(isDrafted).length.toLocaleString() },
+        { label: "Paused", value: all.filter(isPaused).length.toLocaleString(), tone: "warning" },
+      ]}
+      toolbar={(
+        <Toolbar
+          search={{ value: search, onChange: setSearch, placeholder: "Search nurtures" }}
+          filters={(
+            <select aria-label="Nurture status" className={SELECT} value={filter} onChange={(e) => setFilter(e.target.value)}>
+              <option value="">All statuses</option><option value="drafted">Drafted</option><option value="live">Live</option><option value="paused">Paused</option><option value="finished">Finished</option>
+            </select>
+          )}
+          actions={toolbarActions}
+        />
+      )}
+    >
+      {act.error ? <ApiError error={act.error} title="That did not work" /> : null}
+      <SplitView list={rows} detail={detail} detailOpen={Boolean(selected)} onCloseDetail={() => { setId(null); setView(null); }} expanded={view === "full"} onExpandedChange={(e) => setView(e ? "full" : null)} detailWidth="xl" />
+      <FormSheet open={creating} onOpenChange={setCreating} title="New nurture" description="Pick the sender and the audience, then write the emails. Nothing is sent until you go live.">
+        <div className="grid gap-4">
+          {noMailbox ? (
+            <SectionCard title="Connect a mailbox first" description={`A nurture sends from one connected mailbox. Google and Microsoft sign-in only works inside ${brand.linkLabel}.`}>
+              <a className="inline-flex items-center gap-1 text-sm underline" href={connectMailboxUrl} target="_blank" rel="noreferrer">Connect in {brand.linkLabel} <ExternalLink className="size-3.5" /></a>
+            </SectionCard>
+          ) : null}
+          {creating ? <NurtureForm onCancel={() => setCreating(false)} onSaved={(created) => { setCreating(false); void list.refetch(); setId(created.id); }} /> : null}
+        </div>
+      </FormSheet>
+      <ConfirmSpendDialog
+        open={toResume !== null}
+        tier="external"
+        title={`Resume ${toResume?.name ?? "this nurture"}?`}
+        description={<><p>Emails start going out again to the contacts who have not finished it.</p>{resume.error ? <ApiError error={resume.error} title="Could not resume" /> : null}</>}
+        confirmLabel="Resume"
+        confirming={resume.loading}
+        onCancel={() => setToResume(null)}
+        onConfirm={() => { if (toResume) void resume.mutate(toResume); }}
+      />
+      <ConfirmSpendDialog
+        open={toArchive !== null}
+        tier="destructive"
+        title={`Archive ${toArchive?.name ?? "this nurture"}?`}
+        description={<><p>{toArchive && isLiveLike(toArchive) ? "It is paused and wound down first, then archived. Contacts stop receiving its emails." : "It is archived and no longer runs."}</p>{archive.error ? <ApiError error={archive.error} title="Could not archive" /> : null}</>}
+        confirmLabel="Archive"
+        confirming={archive.loading}
+        onCancel={() => setToArchive(null)}
+        onConfirm={() => { if (toArchive) void archive.mutate(toArchive); }}
+      />
+    </ScreenLayout>
+  );
+}

package/blocks/nurture/lib/nurture-types.ts

@@ -8,7 +8,7 @@
  * endpoint; status, audience size and the sequence-performance report are what the API gives.
  */
 
-import { G8Error } from "@graph8/sdk";
+import { G8Error } from "@graph8/sdk/errors";
 
 export interface Nurture {
   id: string;

package/blocks/objects/README.md

@@ -5,6 +5,22 @@ edit and archive their records. `ObjectTable` and `ObjectRecordDetail` are gener
 slug, including the standard `contacts`, `companies` and `deals`. This is the HubSpot "custom objects" / Salesforce
 "custom object" screen set.
 
+## Screens
+
+`ObjectsScreen` (no props) is the finished workspace: a picker of all objects (your own next to the standard contacts, companies and
+deals), the records table with search, load more, create, edit and archive, the open record beside it (values, owners, relationships,
+history, restore) and "Define objects", which opens `ObjectSchemaEditor` in a side sheet so an admin can create objects, add and archive
+fields and rename. The URL carries `?object=` and `?id=`, so a refresh or a shared link lands on the same record. Props:
+`initialObjectSlug`, `allowSchemaEditing` (default true; hide it from non-admins), `toolbarActions`. Needs the same prerequisites as
+the parts (`objects` and `records` in the proxy allow-list, `objects:read`/`write`/`delete`, and `objects:manage` for the editor).
+If the objects API is unreachable the screen says so.
+
+```tsx
+"use client";
+import { ObjectsScreen } from "@/g8/objects/components/objects-screen";
+export default function Page() { return <ObjectsScreen />; }
+```
+
 ## Install
 
 ```
@@ -82,6 +98,7 @@ export default function Invoices() {
 
 | Component | File | What it is |
 |---|---|---|
+| `ObjectsScreen` | `components/objects-screen.tsx` | The finished workspace composing everything below. |
 | `ObjectSchemaEditor` | `components/object-schema-editor.tsx` | Create objects, edit their labels, add/edit/archive fields (text, number, select, reference...). |
 | `AttributeFormDialog` | `components/attribute-form-dialog.tsx` | Dialog to add or edit one field of an object. |
 | `ObjectTable` | `components/object-table.tsx` | Records of any object as a table with search over loaded rows, load-more, create, edit and archive. |

package/blocks/objects/block.json

@@ -8,32 +8,33 @@
     "generic records table for any object",
     "record detail with owners, relationships and change history",
     "optimistic concurrency on edits",
-    "archive and restore with history kept"
+    "archive and restore with history kept",
+    "finished ObjectsScreen composing the picker, table, record detail and schema editor"
   ],
   "dependsOn": [
     "foundation"
   ],
   "operations": [
-    "list_objects_objects_get",
-    "create_object_objects_post",
-    "get_object_objects__object_slug__get",
-    "list_object_attributes_objects__object_slug__attributes_get",
-    "update_object_objects__object_slug__patch",
-    "create_attribute_objects__object_slug__attributes_post",
-    "update_attribute_objects__object_slug__attributes__attr_slug__patch",
     "archive_attribute_objects__object_slug__attributes__attr_slug__delete",
     "archive_object_objects__object_slug__delete",
-    "list_object_records_objects__object_slug__records_get",
-    "create_object_record_objects__object_slug__records_post",
-    "update_object_record_objects__object_slug__records__record_id__patch",
     "archive_object_record_objects__object_slug__records__record_id__delete",
-    "get_object_record_objects__object_slug__records__record_id__get",
+    "assign_record_role_records__entity_type___entity_id__role_assignments_post",
+    "clear_record_role_records__entity_type___entity_id__role_assignments__role_slot__delete",
+    "create_attribute_objects__object_slug__attributes_post",
+    "create_object_objects_post",
+    "create_object_record_objects__object_slug__records_post",
+    "get_object_objects__object_slug__get",
     "get_object_record_changes_objects__object_slug__records__record_id__changes_get",
+    "get_object_record_objects__object_slug__records__record_id__get",
     "get_object_relationships_objects__object_slug__records__record_id__relationships_get",
-    "restore_object_record_objects__object_slug__records__record_id__restore_post",
     "get_record_role_slots_records__entity_type___entity_id__role_slots_get",
-    "assign_record_role_records__entity_type___entity_id__role_assignments_post",
-    "clear_record_role_records__entity_type___entity_id__role_assignments__role_slot__delete"
+    "list_object_attributes_objects__object_slug__attributes_get",
+    "list_object_records_objects__object_slug__records_get",
+    "list_objects_objects_get",
+    "restore_object_record_objects__object_slug__records__record_id__restore_post",
+    "update_attribute_objects__object_slug__attributes__attr_slug__patch",
+    "update_object_objects__object_slug__patch",
+    "update_object_record_objects__object_slug__records__record_id__patch"
   ],
   "components": [
     {
@@ -151,6 +152,17 @@
         "write",
         "destructive"
       ]
+    },
+    {
+      "name": "ObjectsScreen",
+      "file": "components/objects-screen.tsx",
+      "purpose": "Finished custom-objects workspace: object picker, records table, record detail panel and the schema editor in a sheet. No required props.",
+      "operations": [
+        "list_objects_objects_get"
+      ],
+      "tiers": [
+        "read"
+      ]
     }
   ],
   "hooks": [
@@ -238,6 +250,7 @@
     }
   ],
   "peerDependencies": {
-    "react": ">=18"
+    "react": ">=18",
+    "lucide-react": ">=0.400.0"
   }
 }

package/blocks/objects/components/object-not-found.tsx

@@ -15,6 +15,7 @@ import { EmptyState } from "@/g8/components/empty-state";
 import { g8Get } from "@/g8/lib/g8-client";
 import { useG8Query } from "@/g8/hooks/use-g8-query";
 import { isObjectsApiMissing } from "../lib/object-types";
+import { useBrand } from "@/g8/hooks/use-brand";
 
 export interface ObjectNotFoundProps {
   /** What was not found, for the message: "record" or "object". */
@@ -24,10 +25,11 @@ export interface ObjectNotFoundProps {
 }
 
 export function ObjectNotFound({ what, error }: ObjectNotFoundProps) {
+  const brand = useBrand();
   const probe = useG8Query((signal) => g8Get<unknown[]>("/objects", {}, { signal }).then(() => "enabled" as const), []);
   if (probe.loading && !probe.data && !probe.error) return <p className="text-muted-foreground text-sm" aria-busy="true">Checking...</p>;
   if (isObjectsApiMissing(probe.error)) {
-    return <EmptyState title="Custom objects are unavailable" description="The graph8 API at this base URL does not serve custom objects. Check G8_API_URL and that it points at a current graph8 backend, then reload." />;
+    return <EmptyState title="Custom objects are unavailable" description={`The ${brand.linkLabel} API at this base URL does not serve custom objects. Check G8_API_URL and that it points at a current ${brand.linkLabel} backend, then reload.`} />;
   }
   if (probe.error) return <ApiError error={probe.error} title="Could not check custom objects" onRetry={() => void probe.refetch()} />;
   return <EmptyState title={`This ${what} no longer exists`} description={`It may have been deleted, or the link is out of date. Go back and pick another ${what}.`} />;

package/blocks/objects/components/object-record-detail.tsx

@@ -59,7 +59,8 @@ export function ObjectRecordDetail({ objectSlug, recordId, onArchived, onBack }:
 
   if (isObjectsApiMissing(record.error)) return <ObjectNotFound what="record" error={record.error} />;
   if (record.error) return <ApiError error={record.error} title="Could not load the record" onRetry={() => void record.refetch()} />;
-  if (!record.data || schema.loading) return <div className="grid gap-2" aria-busy="true"><Skeleton className="h-8 w-64" /><Skeleton className="h-40 w-full" /></div>;
+  // The hook keeps the previous record while the next loads; edit and archive act on recordId, so show only that record.
+  if (!record.data || String(record.data.id) !== String(recordId) || schema.loading) return <div className="grid gap-2" aria-busy="true"><Skeleton className="h-8 w-64" /><Skeleton className="h-40 w-full" /></div>;
 
   const current = record.data;
   const roleEntity = ROLE_ENTITY_TYPES[objectSlug];