@graph8/sdk 0.362.0 → 0.370.0

package/blocks/newsletter/block.json

@@ -15,40 +15,55 @@
     "lists"
   ],
   "operations": [
-    "list_newsletters_newsletters_get",
-    "create_newsletter_newsletters_post",
-    "list_issues_newsletters__newsletter_id__issues_get",
     "activate_newsletter_newsletters__newsletter_id__activate_post",
-    "pause_newsletter_newsletters__newsletter_id__pause_post",
-    "get_issue_newsletters__newsletter_id__issues__issue_id__get",
+    "add_subscriber_newsletters__newsletter_id__subscribers_post",
+    "cancel_send_newsletters__newsletter_id__issues__issue_id__send_cancel_post",
     "create_issue_newsletters__newsletter_id__issues_post",
-    "update_issue_newsletters__newsletter_id__issues__issue_id__put",
+    "create_newsletter_newsletters_post",
+    "delete_issue_newsletters__newsletter_id__issues__issue_id__delete",
+    "delete_subscriber_newsletters__newsletter_id__subscribers__subscriber_id__delete",
     "generate_newsletter_issue_newsletters__newsletter_id__issues__issue_id__generate_post",
+    "get_issue_analytics_kpis_newsletters__newsletter_id__issues__issue_id__analytics_kpis_get",
     "get_issue_generation_status_newsletters__newsletter_id__issues__issue_id__generation_status_get",
-    "send_test_email_newsletters__newsletter_id__issues__issue_id__send_test_post",
-    "delete_issue_newsletters__newsletter_id__issues__issue_id__delete",
-    "list_subscribers_newsletters__newsletter_id__subscribers_get",
-    "send_issue_newsletters__newsletter_id__issues__issue_id__send_post",
+    "get_issue_newsletters__newsletter_id__issues__issue_id__get",
     "get_send_status_newsletters__newsletter_id__issues__issue_id__send_get",
-    "pause_send_newsletters__newsletter_id__issues__issue_id__send_pause_post",
-    "resume_send_newsletters__newsletter_id__issues__issue_id__send_resume_post",
-    "cancel_send_newsletters__newsletter_id__issues__issue_id__send_cancel_post",
-    "add_subscriber_newsletters__newsletter_id__subscribers_post",
-    "list_lists_lists_get",
     "import_subscribers_from_audience_newsletters__newsletter_id__subscribers_import_audience_post",
+    "list_issues_newsletters__newsletter_id__issues_get",
+    "list_lists_lists_get",
+    "list_newsletters_newsletters_get",
+    "list_subscribers_newsletters__newsletter_id__subscribers_get",
+    "pause_newsletter_newsletters__newsletter_id__pause_post",
+    "pause_send_newsletters__newsletter_id__issues__issue_id__send_pause_post",
     "preview_newsletter_subscriber_verification_newsletters__newsletter_id__subscribers_verify_preview_post",
-    "verify_newsletter_subscribers_newsletters__newsletter_id__subscribers_verify_post",
+    "resume_send_newsletters__newsletter_id__issues__issue_id__send_resume_post",
+    "send_issue_newsletters__newsletter_id__issues__issue_id__send_post",
+    "send_test_email_newsletters__newsletter_id__issues__issue_id__send_test_post",
     "unsubscribe_subscriber_newsletters__newsletter_id__subscribers__subscriber_id__unsubscribe_patch",
-    "delete_subscriber_newsletters__newsletter_id__subscribers__subscriber_id__delete",
-    "get_issue_analytics_kpis_newsletters__newsletter_id__issues__issue_id__analytics_kpis_get"
+    "update_issue_newsletters__newsletter_id__issues__issue_id__put",
+    "verify_newsletter_subscribers_newsletters__newsletter_id__subscribers_verify_post"
   ],
   "components": [
     {
       "name": "NewsletterScreen",
       "file": "components/newsletter-screen.tsx",
       "purpose": "Finished newsletter workspace: pick or create a newsletter, issues list with detail (write, send, results), subscribers and performance tabs.",
-      "operations": [],
-      "tiers": []
+      "operations": [
+        "activate_newsletter_newsletters__newsletter_id__activate_post",
+        "create_newsletter_newsletters_post",
+        "delete_subscriber_newsletters__newsletter_id__subscribers__subscriber_id__delete",
+        "get_issue_analytics_kpis_newsletters__newsletter_id__issues__issue_id__analytics_kpis_get",
+        "list_issues_newsletters__newsletter_id__issues_get",
+        "list_newsletters_newsletters_get",
+        "list_subscribers_newsletters__newsletter_id__subscribers_get",
+        "pause_newsletter_newsletters__newsletter_id__pause_post",
+        "unsubscribe_subscriber_newsletters__newsletter_id__subscribers__subscriber_id__unsubscribe_patch"
+      ],
+      "tiers": [
+        "read",
+        "write",
+        "external",
+        "destructive"
+      ]
     },
     {
       "name": "NewsletterEditor",
@@ -112,14 +127,15 @@
       "file": "components/subscriber-table.tsx",
       "purpose": "Subscribers with search, status filter, add, import a list, verify addresses, unsubscribe and erase.",
       "operations": [
-        "list_subscribers_newsletters__newsletter_id__subscribers_get",
         "add_subscriber_newsletters__newsletter_id__subscribers_post",
-        "list_lists_lists_get",
+        "delete_subscriber_newsletters__newsletter_id__subscribers__subscriber_id__delete",
         "import_subscribers_from_audience_newsletters__newsletter_id__subscribers_import_audience_post",
+        "list_lists_lists_get",
+        "list_newsletters_newsletters_get",
+        "list_subscribers_newsletters__newsletter_id__subscribers_get",
         "preview_newsletter_subscriber_verification_newsletters__newsletter_id__subscribers_verify_preview_post",
-        "verify_newsletter_subscribers_newsletters__newsletter_id__subscribers_verify_post",
         "unsubscribe_subscriber_newsletters__newsletter_id__subscribers__subscriber_id__unsubscribe_patch",
-        "delete_subscriber_newsletters__newsletter_id__subscribers__subscriber_id__delete"
+        "verify_newsletter_subscribers_newsletters__newsletter_id__subscribers_verify_post"
       ],
       "tiers": [
         "read",

package/blocks/newsletter/components/issue-scheduler.tsx

@@ -25,6 +25,7 @@ import { useG8Query } from "@/g8/hooks/use-g8-query";
 import { useJobPoll } from "@/g8/hooks/use-job-poll";
 import { generationInProgress, isDraft, issueTitle, sendIsMoving, sendIsPaused, toIsoInstant } from "../lib/newsletter-types";
 import type { Issue, SendState } from "../lib/newsletter-types";
+import { pluralWord } from "@/g8/lib/plural";
 
 export interface IssueSchedulerProps {
   newsletterId: string;
@@ -111,7 +112,7 @@ export function IssueScheduler({ newsletterId, issueId, onSent }: IssueScheduler
         {partial ? <p role="alert" className="text-sm text-amber-700">This issue is still being written by AI. Wait for it to finish: sending now would mail the partial version.</p> : null}
         {draft ? (
           <div className="grid gap-3">
-            <p className="text-sm">Audience: <strong>{audience.loading ? "..." : subscribers.toLocaleString()}</strong> subscribed {subscribers === 1 ? "person" : "people"}.</p>
+            <p className="text-sm">Audience: <strong>{audience.loading ? "..." : subscribers.toLocaleString()}</strong> subscribed {pluralWord(subscribers, "person", "people")}.</p>
             <div className="flex gap-2" role="group" aria-label="When to send">
               <Button size="sm" variant={when === "now" ? "secondary" : "ghost"} onClick={() => setWhen("now")}>Send now</Button>
               <Button size="sm" variant={when === "later" ? "secondary" : "ghost"} onClick={() => setWhen("later")}>Schedule</Button>

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

@@ -46,6 +46,7 @@ import { IssueForm } from "./issue-form";
 import { IssueScheduler } from "./issue-scheduler";
 import { NewsletterStats } from "./newsletter-stats";
 import { SubscriberTable } from "./subscriber-table";
+import { useBrand } from "@/g8/hooks/use-brand";
 
 export interface NewsletterScreenProps {
   /** Open this newsletter first when the URL does not name one. */
@@ -170,6 +171,7 @@ function SubscriberDetail({ newsletterId, subscriber, onChanged, onClose, expand
 }
 
 export function NewsletterScreen({ initialNewsletterId, renderRowActions, renderDetailActions, extraDetailTabs, toolbarActions, className }: NewsletterScreenProps) {
+  const brand = useBrand();
   const [urlNewsletter, setUrlNewsletter] = useUrlState("newsletter", initialNewsletterId ?? "");
   const [issueParam, setIssueParam] = useUrlState("id", "");
   const [view, setView] = useUrlState("view", "");
@@ -391,7 +393,7 @@ export function NewsletterScreen({ initialNewsletterId, renderRowActions, render
         open={pending !== null}
         tier="external"
         title={pending === "activate" ? `Activate ${current?.name ?? "this newsletter"}?` : `Create the newsletter "${name.trim()}"?`}
-        description={<><p>{pending === "activate" ? "Once active, the scheduler sends any issue whose scheduled time has passed to real subscribers. A verified sending domain is required (set it up in graph8)." : "This creates the newsletter container. Nothing is sent until you activate it and send an issue."}</p>{(create.error ?? activate.error) ? <ApiError error={create.error ?? activate.error} title="That did not work" /> : null}</>}
+        description={<><p>{pending === "activate" ? `Once active, the scheduler sends any issue whose scheduled time has passed to real subscribers. A verified sending domain is required (set it up in ${brand.linkLabel}).` : "This creates the newsletter container. Nothing is sent until you activate it and send an issue."}</p>{(create.error ?? activate.error) ? <ApiError error={create.error ?? activate.error} title="That did not work" /> : null}</>}
         confirmLabel={pending === "activate" ? "Activate" : "Create"}
         confirming={create.loading || activate.loading}
         onCancel={() => setPending(null)}

package/blocks/nurture/block.json

@@ -14,27 +14,40 @@
     "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": [],
-      "tiers": []
+      "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",
@@ -58,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": [

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

@@ -45,6 +45,8 @@ 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). */
@@ -129,10 +131,12 @@ function NurtureDetails({ nurtureId }: { nurtureId: string }) {
 
 /** "Wait 1 day" / "Wait 3 days" after the previous email (`time_interval` is seconds). */
 function waitText(days: number): string {
-  return `Wait ${days} ${days === 1 ? "day" : "days"} after the previous email`;
+  return `Wait ${plural(days, "day")} after the previous email`;
 }
 
-export function NurtureScreen({ connectMailboxUrl = "https://app.graph8.com", contactIds, renderRowActions, renderDetailActions, renderAudienceTools, extraDetailTabs, toolbarActions, className }: NurtureScreenProps) {
+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 };
@@ -158,7 +162,7 @@ export function NurtureScreen({ connectMailboxUrl = "https://app.graph8.com", co
   });
 
   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 graph8 to turn it on, then reload." /></ScreenLayout>;
+    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 ?? [];
@@ -177,7 +181,7 @@ export function NurtureScreen({ connectMailboxUrl = "https://app.graph8.com", co
         <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 ? `${n.steps.length} ${n.steps.length === 1 ? "email" : "emails"}` : "Series"}{n.is_shared ? " · shared" : ""}</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">
@@ -247,8 +251,8 @@ export function NurtureScreen({ connectMailboxUrl = "https://app.graph8.com", co
       <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 graph8.">
-              <a className="inline-flex items-center gap-1 text-sm underline" href={connectMailboxUrl} target="_blank" rel="noreferrer">Connect in graph8 <ExternalLink className="size-3.5" /></a>
+            <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}

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];

package/blocks/objects/components/object-schema-editor.tsx

@@ -27,6 +27,7 @@ import { useObjectSchema } from "../hooks/use-object-schema";
 import { OBJECT_ICONS, isObjectsApiMissing, isValidSlug, slugify } from "../lib/object-types";
 import type { ObjectAttribute, ObjectDefinition } from "../lib/object-types";
 import { AttributeFormDialog } from "./attribute-form-dialog";
+import { useBrand } from "@/g8/hooks/use-brand";
 
 export interface ObjectSchemaEditorProps {
   /** Object to open first. */
@@ -93,6 +94,7 @@ function ObjectDetailsForm({ object, attributes, onSaved }: { object: ObjectDefi
 }
 
 export function ObjectSchemaEditor({ initialObjectSlug, onSelectObject }: ObjectSchemaEditorProps) {
+  const brand = useBrand();
   const [selected, setSelected] = useState<string | undefined>(initialObjectSlug);
   const [editing, setEditing] = useState<ObjectAttribute | "new" | null>(null);
   const [pending, setPending] = useState<Pending | null>(null);
@@ -113,7 +115,7 @@ export function ObjectSchemaEditor({ initialObjectSlug, onSelectObject }: Object
 
   if (objects.loading && !objects.data) return <div className="grid gap-2" aria-busy="true"><Skeleton className="h-8 w-48" /><Skeleton className="h-40 w-full" /></div>;
   if (isObjectsApiMissing(objects.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 (objects.error) return <ApiError error={objects.error} title="Could not load objects" onRetry={() => void objects.refetch()} />;
 

package/blocks/objects/components/object-table.tsx

@@ -13,6 +13,7 @@
  */
 
 import { useEffect, useState } from "react";
+import type { ReactNode } from "react";
 import { Button, Input, Skeleton, Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@graph8/sdk/ui";
 import { ApiError } from "@/g8/components/api-error";
 import { ConfirmSpendDialog } from "@/g8/components/confirm-spend-dialog";
@@ -20,6 +21,8 @@ import { EmptyState } from "@/g8/components/empty-state";
 import { g8Delete, g8Get } from "@/g8/lib/g8-client";
 import { useG8Mutation } from "@/g8/hooks/use-g8-mutation";
 import { usePaginated } from "@/g8/hooks/use-paginated";
+import { rowActivationProps } from "@/g8/hooks/use-row-activation";
+import { RecordLink } from "@/g8/components/screen/record-link";
 import { useObjectSchema } from "../hooks/use-object-schema";
 import { formatValue, isObjectsApiMissing, recordTitle } from "../lib/object-types";
 import { ObjectNotFound } from "./object-not-found";
@@ -27,6 +30,8 @@ import type { ObjectRecord } from "../lib/object-types";
 import { RecordFormDialog } from "./record-form-dialog";
 
 export interface ObjectTableProps {
+  /** URL param the host screen reads for this record type. With it the name is a real link (Cmd-click opens it in a new tab); without it a plain button. */
+  linkParam?: string;
   objectSlug: string;
   /** Rows per request, 1-200. Default 50. */
   pageSize?: number;
@@ -36,7 +41,7 @@ export interface ObjectTableProps {
   maxColumns?: number;
 }
 
-export function ObjectTable({ objectSlug, pageSize = 50, onSelectRecord, maxColumns = 6 }: ObjectTableProps) {
+export function ObjectTable({ linkParam, objectSlug, pageSize = 50, onSelectRecord, maxColumns = 6 }: ObjectTableProps) {
   const schema = useObjectSchema(objectSlug);
   const slug = encodeURIComponent(objectSlug);
   const records = usePaginated<ObjectRecord>(
@@ -68,6 +73,11 @@ export function ObjectTable({ objectSlug, pageSize = 50, onSelectRecord, maxColu
     return <ApiError error={schema.error ?? records.error} title="Could not load records" onRetry={() => { void schema.refetch(); void records.reload(); }} />;
   }
 
+  const cellText = (c: (typeof columns)[number], i: number, record: ObjectRecord): ReactNode => {
+    const text = formatValue(c, record.values?.[c.slug]) || (i === 0 ? recordTitle(schema.definition, schema.attributes, record) : "");
+    return i === 0 && onSelectRecord && text ? <RecordLink param={linkParam} id={record.id} onOpen={() => onSelectRecord(record)}>{text}</RecordLink> : text;
+  };
+
   return (
     <div className="grid gap-3">
       <div className="flex items-center justify-between gap-2">
@@ -92,9 +102,9 @@ export function ObjectTable({ objectSlug, pageSize = 50, onSelectRecord, maxColu
           </TableHeader>
           <TableBody>
             {rows.map((record) => (
-              <TableRow key={record.id} className={onSelectRecord ? "cursor-pointer" : undefined} onClick={() => onSelectRecord?.(record)}>
+              <TableRow key={record.id} className={onSelectRecord ? "cursor-pointer" : undefined} {...(onSelectRecord ? rowActivationProps(() => onSelectRecord(record)) : {})}>
                 {columns.map((c, i) => (
-                  <TableCell key={c.slug}>{formatValue(c, record.values?.[c.slug]) || (i === 0 ? recordTitle(schema.definition, schema.attributes, record) : "")}</TableCell>
+                  <TableCell key={c.slug}>{cellText(c, i, record)}</TableCell>
                 ))}
                 <TableCell className="text-right" onClick={(e) => e.stopPropagation()}>
                   <Button variant="ghost" size="sm" onClick={() => setForm({ record })}>Edit</Button>