@graph8/sdk 0.362.0 → 0.373.0

package/blocks/appointments/components/record-meetings-tab.tsx

@@ -0,0 +1,92 @@
+"use client";
+
+/**
+ * RecordMeetingsTab: the meetings booked with one contact, past and upcoming, newest first, each opening in the meetings
+ * screen. Use it as an `extraDetailTabs` entry of ContactsScreen:
+ *   { id: "meetings", label: "Meetings", render: (c) => <RecordMeetingsTab contactId={c.id} onOpenMeeting={(sel) => router.push(`/meetings?sel=${sel}`)} /> }
+ *
+ * SDK operations, in order:
+ *   1. getContactMeetings  GET /contacts/{id}/meetings   (read; booking events, the API answers the 50 most recent)
+ * Nothing here is billable, external or destructive. Book a new meeting from the scheduling screen.
+ */
+
+import { Skeleton } from "@graph8/sdk/ui";
+import { CalendarDays } from "lucide-react";
+import { ApiError } from "@/g8/components/api-error";
+import { EmptyState } from "@/g8/components/empty-state";
+import { StatusPill } from "@/g8/components/screen/status-pill";
+import type { Tone } from "@/g8/components/screen/status-pill";
+import { useG8Query } from "@/g8/hooks/use-g8-query";
+import { g8Get } from "@/g8/lib/g8-client";
+import { listOf } from "../lib/appointments-types";
+
+/** One row of GET /contacts/{id}/meetings: a booking event. */
+interface BookingEvent { event?: string | null; timestamp?: string | null; booking_id?: string | null; title?: string | null; start_time?: string | null; end_time?: string | null; attendees?: unknown }
+
+/** The server returns at most this many events, newest first. */
+export const MEETINGS_TAB_API_LIMIT = 50;
+
+const EVENT: Record<string, { label: string; tone: Tone }> = {
+  "appointments.booking_created": { label: "Booked", tone: "info" },
+  "appointments.booking_rescheduled": { label: "Rescheduled", tone: "warning" },
+  "appointments.booking_cancelled": { label: "Cancelled", tone: "negative" },
+};
+
+function when(iso: string | null | undefined): string {
+  const d = iso ? new Date(iso) : null;
+  return d && !Number.isNaN(d.getTime()) ? d.toLocaleString(undefined, { month: "short", day: "numeric", year: "numeric", hour: "numeric", minute: "2-digit" }) : "";
+}
+
+function attendeeNames(a: unknown): string {
+  if (!Array.isArray(a)) return "";
+  return a.map((x) => (typeof x === "string" ? x : ((x as { name?: string; email?: string } | null)?.name || (x as { email?: string } | null)?.email || ""))).filter(Boolean).join(", ");
+}
+
+export interface RecordMeetingsTabProps {
+  contactId: number;
+  /** Route to the booking in your meetings screen; receives the `sel` value ("booking:<id>"). Without it the rows link to `${meetingsPath}?sel=booking:<id>`. */
+  onOpenMeeting?: (selection: string) => void;
+  /** Path of your meetings screen for the plain links. Default "/meetings". */
+  meetingsPath?: string;
+}
+
+export function RecordMeetingsTab({ contactId, onOpenMeeting, meetingsPath = "/meetings" }: RecordMeetingsTabProps) {
+  const q = useG8Query(async (signal) => listOf<BookingEvent>(await g8Get(`/contacts/${contactId}/meetings`, undefined, { signal }), "items"), [contactId]);
+  if (q.error) return <ApiError error={q.error} title="Could not load meetings" onRetry={() => void q.refetch()} />;
+  if (!q.data) return <Skeleton className="h-24 w-full" aria-label="Loading meetings" />;
+  if (q.data.length === 0) return <EmptyState compact icon={<CalendarDays className="size-8" />} title="No meetings yet" description="Meetings booked with this contact show up here." />;
+  return (
+    <div className="space-y-2">
+      <ul className="divide-y rounded-md border" aria-label="Meetings">
+        {q.data.map((m, i) => {
+          const kind = EVENT[m.event ?? ""] ?? { label: "Booking", tone: "neutral" as Tone };
+          const selection = m.booking_id ? `booking:${m.booking_id}` : null;
+          const title = m.title || "Meeting";
+          const detail = [when(m.start_time ?? m.timestamp), attendeeNames(m.attendees)].filter(Boolean).join(" · ");
+          return (
+            <li key={`${m.booking_id ?? "event"}-${m.event}-${i}`} className="flex items-center justify-between gap-3 p-3 text-sm">
+              <div className="min-w-0">
+                {selection ? (
+                  <a
+                    href={`${meetingsPath}?sel=${encodeURIComponent(selection)}`}
+                    className="block truncate font-medium hover:underline"
+                    onClick={(e) => {
+                      if (!onOpenMeeting || e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
+                      e.preventDefault();
+                      onOpenMeeting(selection);
+                    }}
+                  >
+                    {title}
+                  </a>
+                ) : <span className="font-medium">{title}</span>}
+                {detail ? <p className="truncate text-xs text-muted-foreground">{detail}</p> : null}
+              </div>
+              <StatusPill tone={kind.tone} dot>{kind.label}</StatusPill>
+            </li>
+          );
+        })}
+      </ul>
+      {q.data.length >= MEETINGS_TAB_API_LIMIT ? <p role="note" className="text-xs text-muted-foreground">Showing the {MEETINGS_TAB_API_LIMIT} most recent booking events. Older ones are in the meetings screen.</p> : null}
+    </div>
+  );
+}

package/blocks/appointments/components/scheduling-screen.tsx

@@ -37,6 +37,7 @@ import { AvailabilityEditor } from "./availability-editor";
 import { BookingPage } from "./booking-page";
 import { EventTypeEditor } from "./event-type-editor";
 import { EventTypeBookings, EventTypeOverview } from "./event-type-related";
+import { rowActivationProps } from "@/g8/hooks/use-row-activation";
 
 export interface SchedulingScreenProps {
   /** Where a person connects a calendar (graph8 app). */
@@ -88,7 +89,7 @@ export function SchedulingScreen({ connectCalendarUrl, renderRowActions, renderD
       <TableHeader><TableRow><TableHead>Event type</TableHead><TableHead className="text-right">Length</TableHead><TableHead>Rules</TableHead>{renderRowActions ? <TableHead /> : null}</TableRow></TableHeader>
       <TableBody>
         {types.eventTypes.map((t) => (
-          <TableRow key={t.id} className="cursor-pointer" data-state={String(t.id) === idParam ? "selected" : undefined} onClick={() => setId(String(t.id))}>
+          <TableRow key={t.id} className="cursor-pointer" data-state={String(t.id) === idParam ? "selected" : undefined} {...rowActivationProps(() => setId(String(t.id)))}>
             <TableCell><button type="button" className="font-medium hover:underline" onClick={(e) => { e.stopPropagation(); setId(String(t.id)); }}>{t.title}</button><div className="text-xs text-muted-foreground">/{t.slug}</div></TableCell>
             <TableCell className="text-right tabular-nums">{t.length} min</TableCell>
             <TableCell className="space-x-1">

package/blocks/block.schema.json

@@ -36,6 +36,24 @@
         }
       }
     },
+    "screens": {
+      "type": "array",
+      "description": "Optional. How the block's finished screens become routes and sidebar entries in an app made with `create --blocks`. Absent: derived from the components named `*Screen` (ContactsScreen -> /contacts, label Contacts, group = the block title, icon from a built-in per-block map).",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["component", "path", "label"],
+        "properties": {
+          "component": { "type": "string", "pattern": "^[A-Z][A-Za-z0-9]*$", "description": "A component of this block." },
+          "path": { "type": "string", "pattern": "^/[a-z0-9]+(-[a-z0-9]+)*(/[a-z0-9]+(-[a-z0-9]+)*)*$", "description": "Static route path. On a collision in a generated app it is prefixed with the block id." },
+          "label": { "type": "string", "minLength": 1 },
+          "icon": { "type": "string", "pattern": "^[A-Z][A-Za-z0-9]*$", "description": "A lucide-react export name." },
+          "group": { "type": "string", "minLength": 1, "description": "Sidebar section (default: the block title)." },
+          "description": { "type": "string", "minLength": 1 },
+          "order": { "type": "number", "description": "Sort position inside the block; lower first." }
+        }
+      }
+    },
     "hooks": {
       "type": "array",
       "items": {

package/blocks/block.types.ts

@@ -59,6 +59,21 @@ export interface BlockDefault {
   askHuman: boolean;
 }
 
+/** Optional route metadata for a finished screen (`create --blocks`, `add` inside a created app). */
+export interface BlockScreen {
+  /** A component of this block. */
+  component: string;
+  /** Static route path; prefixed with the block id when it collides in a generated app. */
+  path: string;
+  label: string;
+  /** lucide-react export name. */
+  icon?: string;
+  /** Sidebar section (default: the block title). */
+  group?: string;
+  description?: string;
+  order?: number;
+}
+
 export interface BlockManifest {
   $schema?: string;
   id: string;
@@ -71,6 +86,8 @@ export interface BlockManifest {
   /** Contract operationIds (keys of API_OPERATIONS). */
   operations: string[];
   components: BlockComponent[];
+  /** Optional. Absent: derived from the components named `*Screen`. */
+  screens?: BlockScreen[];
   hooks: BlockHook[];
   lib?: BlockFile[];
   server?: BlockServerFile[];

package/blocks/campaigns/README.md

@@ -7,6 +7,26 @@ Apollo / HubSpot "campaigns" screen, with generation behind credit confirmations
 Depends on: `lists` (the audience picker), `mailboxes` (senders and the connect-a-mailbox link). Install:
 `npx @graph8/sdk add campaigns`.
 
+## Screens
+
+`CampaignsScreen` is the finished page: mount it as the route. Every record type has a complete detail view,
+deep-linkable (`?tab=campaigns|profile|personas`, `?id=` the record, `?dtab=` the tab, `?doc=` a document).
+
+- **Campaigns tab**: list (delete confirmed) beside a detail panel with Details (every field, audience, edit name,
+  goal and brief, confirmed), Metrics, Documents (each document opens with its fields and editor), Audience,
+  Sequence and Launch. "New campaign" runs the five-step wizard in a sheet.
+- **Company profile tab**: the profile plus ICPs; `IcpDetail` shows every field and edits, pins or archives.
+- **Personas tab**: `PersonaDetail` shows every field, the campaigns that target it, and edits, pins or archives.
+
+Slot props: `toolbarActions`, `renderDetailActions(campaign)`, `extraDetailTabs`, `websiteUrl`. Prerequisites: a
+company profile with the real website, an active mailbox, a contact list, and credits for AI generation.
+`IcpEditor` and `PersonaEditor` gained optional `onOpen` and `refreshKey`; `CampaignAssets` optional
+`documentId` and `onDocumentChange`.
+
+Known limits: there is no single-ICP read, so `IcpDetail` finds the ICP in the first 200 (the API maximum).
+`PersonaDetail` lists the campaigns whose `target_persona` matches the persona title among the first 100
+campaigns; the API does not link campaigns to ICPs, so ICPs show none.
+
 ## Components
 
 | Component | What it does | Tiers |
@@ -16,7 +36,7 @@ Depends on: `lists` (the audience picker), `mailboxes` (senders and the connect-
 | `CampaignWizard` | A page. Idea (AI, polled) -> create -> audience -> steps -> launch. Also exports the three step components below. | all |
 | `CampaignAudienceStep` | Attach or detach a contact list (uses the lists block `ListPicker`; reads `getCampaignFull`, since `getCampaign` omits the audience). | read, write, external |
 | `CampaignSequenceStep` | Add, edit, remove and AI-write sequence steps. | read, billable, external, destructive |
-| `CampaignLaunchStep` | Readiness checklist, sender choice, deliverability warning, confirmed launch. | read, external |
+| `CampaignLaunchStep` | Readiness checklist (audience, steps, written copy, sender), deliverability and warm-up hold warnings, writes missing email copy with AI, confirmed launch. | read, billable, external |
 | `CampaignList` | A page. All campaigns; open one for metrics and documents; delete. | read, billable, external, destructive |
 | `CampaignAssets` | Campaign documents: read, edit, rewrite with AI, add, delete. Standalone: shows a campaign picker. | read, billable, external, destructive |
 | `CampaignMetrics` | A page. Metrics for 7, 30, 90 or 365 days. Standalone: shows a campaign picker. | read |
@@ -40,15 +60,24 @@ read, so credit numbers are estimates: edit `CREDIT_ESTIMATES` in `lib/campaigns
 3. **Ideas.** `generateCampaignIdeasAsync` (billable) -> `task_id` -> poll `getCampaignIdeasTaskStatus` every
    2-3 seconds until `completed`; `ideas[]` carry `campaign_name`, `core_concept`, `primary_hook`.
 4. **Create.** `createCampaign` -> `id`. Store it at once; later steps reuse it and "Create" becomes
-   "Save changes" (`updateCampaign`). With `auto_generate_documents` the documents generate in the
-   background: poll `getCampaignGenerationStatus`.
+   "Save changes" (`updateCampaign`). With `auto_generate_documents` (on by default in the wizard and the
+   recipe) the documents generate in the background: poll `getCampaignGenerationStatus`; a `generation_error`
+   there, or `generation_status: "failed_to_dispatch"` on create, means the writing never started.
 5. **Audience.** `getCampaignFull` shows what is attached (`audience_list_id`, `audience`). `ListPicker` (lists block) -> a list `id` -> `attachAudienceToCampaign` with `list_id` as a
    string. Build the list in the search/lists blocks first.
 6. **Steps and copy.** `getCampaignSequence` -> `createCampaignStep` (channel -> mode matrix: email -> email,
    phone -> call|voicemail, sms -> sms, social -> connect_note|dm|comment|reply) -> `generateCampaignStepContent`
-   (billable) per step. `CampaignAssets` edits the documents behind them.
-7. **Launch.** `CampaignLaunchStep` -> `getCampaignFull` (audience attached with its size, >= 1 step, `is_launched`),
-   `listMailboxes` (active ones), `getSafeToSend` (a warning) -> `launchCampaign` with `sender_mailbox_ids`.
+   (billable) per step. `CampaignAssets` edits the documents behind them. Writing an EMAIL step needs the
+   campaign's `emails` document to exist already (created by `auto_generate_documents`); without it the step
+   write answers 404.
+7. **Launch.** `CampaignLaunchStep` -> `getCampaignFull` (audience attached with its size, >= 1 step, written copy,
+   `is_launched`), `listMailboxes` (active ones), `getSafeToSend` (`safe`, a warning) -> `launchCampaign` with
+   `sender_mailbox_ids`. The launch is refused (400 "no completed copy documents") unless a document other than
+   `sequence` and `step_catalog` has `status: "completed"`, so Launch stays disabled until one does; "Write the
+   email copy with AI" creates the `emails` document if missing (`createCampaignDocument`, once) and has AI write it
+   (`regenerateCampaignDocument`, billable). `is_launched` is true only for a live launch, so a failed launch can be
+   retried. A mailbox added less than 14 days ago is in its warm-up hold: the campaign goes live but sends nothing
+   from it until the hold ends (the step warns).
    The one-step launch executes email only; configure other channels in the sequencer block.
 8. **Measure.** `CampaignMetrics` -> `getCampaignMetrics` with `days`.
 
@@ -62,8 +91,9 @@ read, so credit numbers are estimates: edit `CREDIT_ESTIMATES` in `lib/campaigns
 
 ## Defaults (do not ask the human)
 
-- 5 ideas, goal `awareness`, channel `email`, no auto-generated documents (generate per step so each spend is
-  confirmed), sender = the first active mailbox.
+- 5 ideas, goal `awareness`, channel `email`, AI-written documents ON (a campaign without written copy cannot
+  launch; the create confirmation shows the spend), personas picked by AI when none are chosen
+  (`persona_mode: "ai_pick"`), sender = the first active mailbox.
 - **Ask the human**: whether to launch and to which list (state the recipient count), and whether to approve
   (lock) the company profile.
 
@@ -95,7 +125,7 @@ read, so credit numbers are estimates: edit `CREDIT_ESTIMATES` in `lib/campaigns
 | `get_campaign_ideas_task_status_campaigns_ideas_status__task_id__get` | GET /campaigns/ideas/status/{task_id} | read | CampaignWizard |
 | `create_campaign_campaigns_post` | POST /campaigns | external | CampaignWizard |
 | `update_campaign_campaigns__campaign_id__patch` | PATCH /campaigns/{campaign_id} | external | CampaignWizard |
-| `get_campaign_generation_status_campaigns__campaign_id__status_get` | GET /campaigns/{campaign_id}/status | read | CampaignWizard |
+| `get_campaign_generation_status_campaigns__campaign_id__status_get` | GET /campaigns/{campaign_id}/status | read | CampaignWizard, CampaignLaunchStep |
 | `get_campaign_full_campaigns__campaign_id__full_get` | GET /campaigns/{campaign_id}/full | read | CampaignWizard, CampaignAudienceStep, CampaignLaunchStep |
 | `attach_audience_to_campaign_campaigns__campaign_id__audience_put` | PUT /campaigns/{campaign_id}/audience | external | CampaignWizard, CampaignAudienceStep |
 | `get_campaign_sequence_campaigns__campaign_id__sequence_get` | GET /campaigns/{campaign_id}/sequence | read | CampaignWizard, CampaignSequenceStep |
@@ -112,7 +142,7 @@ read, so credit numbers are estimates: edit `CREDIT_ESTIMATES` in `lib/campaigns
 | `get_campaign_metrics_campaigns__campaign_id__metrics_get` | GET /campaigns/{campaign_id}/metrics | read | CampaignList, CampaignMetrics |
 | `list_campaign_documents_campaigns__campaign_id__documents_get` | GET /campaigns/{campaign_id}/documents | read | CampaignList, CampaignAssets |
 | `get_campaign_document_campaigns__campaign_id__documents__document_id__get` | GET /campaigns/{campaign_id}/documents/{document_id} | read | CampaignList, CampaignAssets |
-| `create_campaign_document_campaigns__campaign_id__documents_post` | POST /campaigns/{campaign_id}/documents | external | CampaignList, CampaignAssets |
+| `create_campaign_document_campaigns__campaign_id__documents_post` | POST /campaigns/{campaign_id}/documents | external | CampaignWizard, CampaignLaunchStep, CampaignList, CampaignAssets |
 | `update_campaign_document_campaigns__campaign_id__documents__document_id__put` | PUT /campaigns/{campaign_id}/documents/{document_id} | external | CampaignList, CampaignAssets |
 | `delete_campaign_document_campaigns__campaign_id__documents__document_id__delete` | DELETE /campaigns/{campaign_id}/documents/{document_id} | destructive | CampaignList, CampaignAssets |
-| `regenerate_campaign_document_campaigns__campaign_id__documents__document_id__regenerate_post` | POST /campaigns/{campaign_id}/documents/{document_id}/regenerate | billable | CampaignList, CampaignAssets |
+| `regenerate_campaign_document_campaigns__campaign_id__documents__document_id__regenerate_post` | POST /campaigns/{campaign_id}/documents/{document_id}/regenerate | billable | CampaignWizard, CampaignLaunchStep, CampaignList, CampaignAssets |

package/blocks/campaigns/block.json

@@ -15,45 +15,51 @@
     "mailboxes"
   ],
   "operations": [
-    "get_company_profile_company_profile_get",
-    "update_company_profile_company_profile_put",
-    "generate_company_profile_company_profile_generate_post",
-    "get_company_profile_workflow_status_company_profile_workflow_status_get",
     "approve_company_profile_company_profile_approve_post",
-    "list_icps_icps_get",
-    "create_icp_icps_post",
-    "update_icp_icps__icp_id__patch",
     "archive_icp_icps__icp_id__archive_post",
-    "list_personas_personas_get",
-    "create_persona_personas_post",
-    "update_persona_personas__persona_id__patch",
     "archive_persona_personas__persona_id__archive_post",
-    "recommend_campaign_personas_campaigns_recommend_personas_post",
-    "generate_campaign_ideas_async_campaigns_generate_ideas_async_post",
-    "get_campaign_ideas_task_status_campaigns_ideas_status__task_id__get",
-    "create_campaign_campaigns_post",
-    "update_campaign_campaigns__campaign_id__patch",
-    "get_campaign_generation_status_campaigns__campaign_id__status_get",
-    "get_campaign_full_campaigns__campaign_id__full_get",
     "attach_audience_to_campaign_campaigns__campaign_id__audience_put",
-    "get_campaign_sequence_campaigns__campaign_id__sequence_get",
+    "create_campaign_campaigns_post",
+    "create_campaign_document_campaigns__campaign_id__documents_post",
     "create_campaign_step_campaigns__campaign_id__sequence_steps_post",
-    "update_campaign_step_campaigns__campaign_id__sequence_steps__step_id__put",
+    "create_icp_icps_post",
+    "create_persona_personas_post",
+    "delete_campaign_campaigns__campaign_id__delete",
+    "delete_campaign_document_campaigns__campaign_id__documents__document_id__delete",
     "delete_campaign_step_campaigns__campaign_id__sequence_steps__step_id__delete",
+    "generate_campaign_ideas_async_campaigns_generate_ideas_async_post",
     "generate_campaign_step_content_campaigns__campaign_id__sequence_steps__step_id__generate_post",
-    "list_mailboxes_mailboxes_get",
+    "generate_company_profile_company_profile_generate_post",
+    "get_campaign_campaigns__campaign_id__get",
+    "get_campaign_document_campaigns__campaign_id__documents__document_id__get",
+    "get_campaign_full_campaigns__campaign_id__full_get",
+    "get_campaign_generation_status_campaigns__campaign_id__status_get",
+    "get_campaign_ideas_task_status_campaigns_ideas_status__task_id__get",
+    "get_campaign_metrics_campaigns__campaign_id__metrics_get",
+    "get_campaign_sequence_campaigns__campaign_id__sequence_get",
+    "get_company_profile_company_profile_get",
+    "get_company_profile_workflow_status_company_profile_workflow_status_get",
+    "get_persona_personas__persona_id__get",
     "get_safe_to_send_deliverability_safe_to_send_get",
     "launch_campaign_campaigns__campaign_id__launch_post",
+    "list_campaign_documents_campaigns__campaign_id__documents_get",
     "list_campaigns_campaigns_get",
-    "delete_campaign_campaigns__campaign_id__delete",
     "list_campaigns_for_picker_campaigns_picker_get",
-    "get_campaign_metrics_campaigns__campaign_id__metrics_get",
-    "list_campaign_documents_campaigns__campaign_id__documents_get",
-    "get_campaign_document_campaigns__campaign_id__documents__document_id__get",
-    "create_campaign_document_campaigns__campaign_id__documents_post",
+    "list_icps_icps_get",
+    "list_mailboxes_mailboxes_get",
+    "list_personas_personas_get",
+    "pin_icp_icps__icp_id__pin_post",
+    "pin_persona_personas__persona_id__pin_post",
+    "recommend_campaign_personas_campaigns_recommend_personas_post",
+    "regenerate_campaign_document_campaigns__campaign_id__documents__document_id__regenerate_post",
+    "unpin_icp_icps__icp_id__unpin_post",
+    "unpin_persona_personas__persona_id__unpin_post",
+    "update_campaign_campaigns__campaign_id__patch",
     "update_campaign_document_campaigns__campaign_id__documents__document_id__put",
-    "delete_campaign_document_campaigns__campaign_id__documents__document_id__delete",
-    "regenerate_campaign_document_campaigns__campaign_id__documents__document_id__regenerate_post"
+    "update_campaign_step_campaigns__campaign_id__sequence_steps__step_id__put",
+    "update_company_profile_company_profile_put",
+    "update_icp_icps__icp_id__patch",
+    "update_persona_personas__persona_id__patch"
   ],
   "components": [
     {
@@ -102,23 +108,26 @@
       "file": "components/campaign-wizard.tsx",
       "purpose": "Idea -> create campaign -> attach audience -> steps and copy -> launch. Every billable or external step is confirmed; ideas are polled.",
       "operations": [
-        "get_company_profile_company_profile_get",
-        "list_personas_personas_get",
-        "generate_campaign_ideas_async_campaigns_generate_ideas_async_post",
-        "get_campaign_ideas_task_status_campaigns_ideas_status__task_id__get",
-        "create_campaign_campaigns_post",
-        "update_campaign_campaigns__campaign_id__patch",
-        "get_campaign_generation_status_campaigns__campaign_id__status_get",
-        "get_campaign_full_campaigns__campaign_id__full_get",
         "attach_audience_to_campaign_campaigns__campaign_id__audience_put",
-        "get_campaign_sequence_campaigns__campaign_id__sequence_get",
+        "create_campaign_campaigns_post",
+        "create_campaign_document_campaigns__campaign_id__documents_post",
         "create_campaign_step_campaigns__campaign_id__sequence_steps_post",
-        "update_campaign_step_campaigns__campaign_id__sequence_steps__step_id__put",
         "delete_campaign_step_campaigns__campaign_id__sequence_steps__step_id__delete",
+        "generate_campaign_ideas_async_campaigns_generate_ideas_async_post",
         "generate_campaign_step_content_campaigns__campaign_id__sequence_steps__step_id__generate_post",
-        "list_mailboxes_mailboxes_get",
+        "get_campaign_campaigns__campaign_id__get",
+        "get_campaign_full_campaigns__campaign_id__full_get",
+        "get_campaign_generation_status_campaigns__campaign_id__status_get",
+        "get_campaign_ideas_task_status_campaigns_ideas_status__task_id__get",
+        "get_campaign_sequence_campaigns__campaign_id__sequence_get",
+        "get_company_profile_company_profile_get",
         "get_safe_to_send_deliverability_safe_to_send_get",
-        "launch_campaign_campaigns__campaign_id__launch_post"
+        "launch_campaign_campaigns__campaign_id__launch_post",
+        "list_mailboxes_mailboxes_get",
+        "list_personas_personas_get",
+        "regenerate_campaign_document_campaigns__campaign_id__documents__document_id__regenerate_post",
+        "update_campaign_campaigns__campaign_id__patch",
+        "update_campaign_step_campaigns__campaign_id__sequence_steps__step_id__put"
       ],
       "tiers": [
         "read",
@@ -161,15 +170,19 @@
     {
       "name": "CampaignLaunchStep",
       "file": "components/campaign-launch-step.tsx",
-      "purpose": "Readiness checklist, sender choice and deliverability warning, then a confirmed launch.",
+      "purpose": "Readiness checklist (audience, steps, written copy, sender), deliverability and warm-up hold warnings, writes missing email copy with AI, then a confirmed launch.",
       "operations": [
         "get_campaign_full_campaigns__campaign_id__full_get",
         "list_mailboxes_mailboxes_get",
         "get_safe_to_send_deliverability_safe_to_send_get",
-        "launch_campaign_campaigns__campaign_id__launch_post"
+        "launch_campaign_campaigns__campaign_id__launch_post",
+        "get_campaign_generation_status_campaigns__campaign_id__status_get",
+        "create_campaign_document_campaigns__campaign_id__documents_post",
+        "regenerate_campaign_document_campaigns__campaign_id__documents__document_id__regenerate_post"
       ],
       "tiers": [
         "read",
+        "billable",
         "external"
       ]
     },
@@ -245,6 +258,55 @@
       "purpose": "A label around a control; the layout piece the editors share.",
       "operations": [],
       "tiers": []
+    },
+    {
+      "name": "CampaignsScreen",
+      "file": "components/campaigns-screen.tsx",
+      "purpose": "Finished campaigns page: list, wizard sheet, detail tabs (details, metrics, documents, audience, sequence, launch), company profile and personas.",
+      "operations": [
+        "get_campaign_campaigns__campaign_id__get",
+        "get_campaign_full_campaigns__campaign_id__full_get",
+        "update_campaign_campaigns__campaign_id__patch"
+      ],
+      "tiers": [
+        "read",
+        "external"
+      ]
+    },
+    {
+      "name": "IcpDetail",
+      "file": "components/icp-detail.tsx",
+      "purpose": "One ideal customer profile, complete: every field; edit, pin or unpin, archive (confirmed).",
+      "operations": [
+        "list_icps_icps_get",
+        "update_icp_icps__icp_id__patch",
+        "pin_icp_icps__icp_id__pin_post",
+        "unpin_icp_icps__icp_id__unpin_post",
+        "archive_icp_icps__icp_id__archive_post"
+      ],
+      "tiers": [
+        "read",
+        "write",
+        "destructive"
+      ]
+    },
+    {
+      "name": "PersonaDetail",
+      "file": "components/persona-detail.tsx",
+      "purpose": "One buyer persona, complete: every field and the campaigns targeting it; edit, pin or unpin, archive (confirmed).",
+      "operations": [
+        "get_persona_personas__persona_id__get",
+        "list_campaigns_campaigns_get",
+        "update_persona_personas__persona_id__patch",
+        "pin_persona_personas__persona_id__pin_post",
+        "unpin_persona_personas__persona_id__unpin_post",
+        "archive_persona_personas__persona_id__archive_post"
+      ],
+      "tiers": [
+        "read",
+        "write",
+        "destructive"
+      ]
     }
   ],
   "hooks": [
@@ -356,6 +418,7 @@
     }
   ],
   "peerDependencies": {
-    "react": ">=18"
+    "react": ">=18",
+    "lucide-react": ">=0.400.0"
   }
 }

package/blocks/campaigns/components/campaign-assets.tsx

@@ -27,13 +27,17 @@ import { useG8Mutation } from "@/g8/hooks/use-g8-mutation";
 import { useG8Query } from "@/g8/hooks/use-g8-query";
 import { useJobPoll } from "@/g8/hooks/use-job-poll";
 import { g8Delete, g8Get, g8Post, g8Put } from "@/g8/lib/g8-client";
-import { CREDIT_ESTIMATES, MAX_BODY_BYTES, byteLength, listOf, objectOf, statusClass, text } from "../lib/campaigns-utils";
+import { KeyValueList } from "@/g8/components/screen/key-value-list";
+import { CREDIT_ESTIMATES, MAX_BODY_BYTES, byteLength, fieldItems, listOf, objectOf, statusClass, text } from "../lib/campaigns-utils";
 import type { CampaignDocRow } from "../lib/campaigns-utils";
 import { CampaignSelect } from "./campaign-select";
 import { FormField } from "./form-field";
 
 export interface CampaignAssetsProps {
   campaignId?: string;
+  /** Controlled open document (a screen deep-links it). Omit to let the component keep it. */
+  documentId?: string | null;
+  onDocumentChange?: (documentId: string | null) => void;
   className?: string;
 }
 
@@ -74,6 +78,7 @@ function Editor({ campaignId, doc, onChanged, onClosed }: { campaignId: string;
         <h4 className="font-medium">{doc.display_name}</h4>
         <Button size="sm" variant="outline" onClick={onClosed}>Close</Button>
       </div>
+      <KeyValueList columns={2} items={fieldItems({ type: doc.file_type, status: text(objectOf(full.data).status) || doc.status, folder: doc.folder_path, updated_at: doc.updated_at, size: `${byteLength(text(objectOf(full.data).content)).toLocaleString()} bytes` })} />
       {full.error ? <ApiError error={full.error} title="Could not load the document" onRetry={() => void full.refetch()} /> : null}
       {full.loading && !full.data ? <Skeleton className="h-32 w-full" /> : null}
       {run.error ? <ApiError error={run.error} /> : null}
@@ -81,7 +86,7 @@ function Editor({ campaignId, doc, onChanged, onClosed }: { campaignId: string;
       {full.data ? (
         <>
           <Textarea aria-label="Document content" className="min-h-48 font-mono text-sm" value={body} onChange={(e) => setContent(e.target.value)} />
-          {tooBig ? <p role="alert" className="text-sm text-red-700">This document is over 5 MiB and cannot be saved through the proxy.</p> : null}
+          {tooBig ? <p role="alert" className="text-sm text-error-foreground">This document is over 5 MiB and cannot be saved through the proxy.</p> : null}
           <div className="flex gap-2">
             <Button disabled={content === null || tooBig || poll.polling} onClick={() => setPending({ kind: "save" })}>Save changes</Button>
             <Button variant="outline" disabled={poll.polling} onClick={() => setPending({ kind: "regenerate" })}>Rewrite with AI</Button>
@@ -105,9 +110,15 @@ function Editor({ campaignId, doc, onChanged, onClosed }: { campaignId: string;
   );
 }
 
-function Documents({ campaignId, className }: { campaignId: string; className?: string }) {
+function Documents({ campaignId, documentId, onDocumentChange, className }: { campaignId: string; documentId?: string | null; onDocumentChange?: (id: string | null) => void; className?: string }) {
   const docs = useG8Query((signal) => g8Get(`/campaigns/${campaignId}/documents`, undefined, { signal }), [campaignId]);
-  const [openId, setOpenId] = useState<string | null>(null);
+  const [localId, setLocalId] = useState<string | null>(null);
+  const openId = documentId !== undefined ? documentId : localId;
+  const setOpenId = (next: string | null | ((cur: string | null) => string | null)) => {
+    const value = typeof next === "function" ? next(openId) : next;
+    setLocalId(value);
+    onDocumentChange?.(value);
+  };
   const [creating, setCreating] = useState(false);
   const [form, setForm] = useState({ display_name: "", file_type: FILE_TYPES[0], content: "" });
   const [confirmCreate, setConfirmCreate] = useState(false);
@@ -168,13 +179,13 @@ function Documents({ campaignId, className }: { campaignId: string; className?:
   );
 }
 
-export function CampaignAssets({ campaignId, className }: CampaignAssetsProps) {
+export function CampaignAssets({ campaignId, documentId, onDocumentChange, className }: CampaignAssetsProps) {
   const [picked, setPicked] = useState<string | null>(null);
   const id = campaignId ?? picked;
   return (
     <div className={`space-y-3 ${className ?? ""}`}>
       {campaignId ? null : <CampaignSelect value={picked} onChange={setPicked} />}
-      {id ? <Documents key={id} campaignId={id} /> : null}
+      {id ? <Documents key={id} campaignId={id} documentId={documentId} onDocumentChange={onDocumentChange} /> : null}
     </div>
   );
 }